Repository navigation
Open
Labels
Description
⚠️ OpenSpec-managed issue — this content is automatically synced
from theopenspec/directory. Manual edits will be overwritten on next sync.
Artifacts
Specs
Tasks
- T01: Add "Agents" to the actions menu in
src/components/ApplicationDetailActions.vuebeside "Automations", pushing theAgentsroute with?app=, and preselect that app insrc/views/AgentsPage.vuefrom the query (REQ-BQAG-003). Verify: vitesttests/components/AgentsPage.spec.jscase for a preselected app, and a case intests/components/ApplicationDetailActionsAutomations.spec.jsfor the new action; extendtests/e2e/agents.spec.tsto reach the page from an app. - T02: Add
knowledge[]toAgentinlib/Settings/register.d/70-agent-workspace.jsonand bump it to1.1.0(REQ-BQAG-001). Verify: PHPUnit on the register import accepting an agent with knowledge. - T03: Add the "Knowledge" section to
src/dialogs/AgentEditDialog.vue, uploading to the agent object's files, with the type list and the 40,000 character budget (REQ-BQAG-001). Verify: vitesttests/dialogs/AgentEditDialog.spec.jscases for add, remove and a refusal over budget. - T04: Read the agent's knowledge into the plan prompt through
CopilotPromptBuilderand record the file names used (REQ-BQAG-002). Verify: PHPUnit cases intests/Unit/Service/CopilotServiceTest.phpfor prompt order and a caller without app access. - T05: Return a step record from every call through
CopilotTextTask, collect them per turn and cache them under atraceIdreturned with the plan, keyed by agent and user (REQ-BQAG-004). Verify: PHPUnittests/Unit/Service/Copilot/CopilotTextTaskTest.phpfor the step shape and the 20,000 character cap. - T06: Add
modelSteps[],knowledgeUsed[],durationMsandtraceMissingtoAgentRun(1.1.0), and haveAgentRunLogger::log()attach the cached steps, or store them directly for a rejected plan (REQ-BQAG-004). Verify:tests/Unit/Service/AgentRunLoggerTest.phpcases for attached steps, an expired trace and a trace of another user. - T07: Show the model steps and knowledge used in
src/components/agents/AgentRunHistory.vueabove the tool calls (REQ-BQAG-005). Verify: vitesttests/components/AgentRunHistory.spec.jsfor a run with a repair and a run withtraceMissing. - T08: When OpenRegister publishes its vector facade, switch D2 from whole files to ranked passages and drop the budget refusal (REQ-BQAG-002). Verify: PHPUnit case with a knowledge set larger than the budget.
- T09: Strings and docs: English and Dutch for "Agents", "Knowledge", the budget message and the step labels (
l10n/en.json,l10n/nl.json), and a page indocs/on giving an agent knowledge and reading its runs. - T10: Run
openspec validate ai-agents-knowledge-and-run-trace --strict. Valid, 2026-11-17.
Design
See design.md for technical design details.
Synced from openspec/changes/ai-agents-knowledge-and-run-trace by OpenSpec workflow
App: buildiq
Activity