agent-devkit 0.5.6 → 0.6.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-devkit",
-  "version": "0.5.6",
+  "version": "0.6.0",
   "description": "Agent DevKit CLI and TUI runtime for specialist AI agents, capabilities and provider-aware workflows.",
   "license": "MIT",
   "type": "module",

package/src/assets/i18n/en-US.json

@@ -242,6 +242,20 @@
     "tui.foundation": "v0.3.5 technical foundation",
     "tui.prompt": "Prompt: {{prompt}}",
     "tui.helpHint": "Run agent --help for CLI options.",
+    "tui.error": "Error: {{error}}",
+    "tui.newSession": "new session",
+    "tui.session": "session {{sessionId}}",
+    "tui.sessionResumed": "Session resumed: {{sessionId}}",
+    "tui.sessionsListFailed": "Could not list sessions.",
+    "tui.sessionsEmpty": "No active sessions. Send a message to create one.",
+    "tui.approvalRequired": "Tool {{tool}} requires approval. Approve? (y/n)",
+    "tui.approvalPlaceholder": "approve? (y/n)",
+    "tui.approvalAccepted": "Approved: {{tool}}. Continuing...",
+    "tui.approvalDenied": "Approval denied. Task stopped.",
+    "tui.thinking": "thinking...",
+    "tui.kbd.send": "Enter send",
+    "tui.kbd.task": "/task <task>",
+    "tui.kbd.exit": "ctrl+c exit",
     "cli.alias.description": "manage a local command alias for the Agent DevKit CLI",
     "cli.alias.set.description": "create or update the local CLI alias",
     "cli.alias.remove.description": "remove the local CLI alias",
@@ -268,6 +282,8 @@
     "cli.models.use.option.chat": "set the default model for the chat role",
     "cli.models.argument.id": "catalog model id",
     "cli.models.option.json": "print the result as JSON",
+    "cli.models.providers.description": "List brain providers and their availability.",
+    "cli.models.providers.option.json": "print providers as JSON",
     "cli.firstRun.hint": "No local model installed. Run: agent models install {{id}}",
     "cli.firstRun.prompt": "No local model installed. Install the recommended model {{id}} now? (y/N)",
     "cli.firstRun.installed": "Model {{id}} installed and set as default.",

package/src/assets/i18n/fr-FR.json

@@ -242,6 +242,20 @@
     "tui.foundation": "v0.3.5 base technique",
     "tui.prompt": "Prompt: {{prompt}}",
     "tui.helpHint": "Executez agent --help pour les options CLI.",
+    "tui.error": "Erreur: {{error}}",
+    "tui.newSession": "nouvelle session",
+    "tui.session": "session {{sessionId}}",
+    "tui.sessionResumed": "Session reprise: {{sessionId}}",
+    "tui.sessionsListFailed": "Impossible de lister les sessions.",
+    "tui.sessionsEmpty": "Aucune session active. Envoyez un message pour en creer une.",
+    "tui.approvalRequired": "L'outil {{tool}} exige une approbation. Approuver ? (o/n)",
+    "tui.approvalPlaceholder": "approuver ? (o/n)",
+    "tui.approvalAccepted": "Approuve: {{tool}}. Suite...",
+    "tui.approvalDenied": "Approbation refusee. Tache arretee.",
+    "tui.thinking": "reflexion...",
+    "tui.kbd.send": "Entree envoyer",
+    "tui.kbd.task": "/task <tache>",
+    "tui.kbd.exit": "ctrl+c quitter",
     "cli.alias.description": "gere un alias local pour le CLI Agent DevKit",
     "cli.alias.set.description": "cree ou met a jour l'alias CLI local",
     "cli.alias.remove.description": "supprime l'alias CLI local",
@@ -268,6 +282,8 @@
     "cli.models.use.option.chat": "definit le modele par defaut pour le role de chat",
     "cli.models.argument.id": "id du modele du catalogue",
     "cli.models.option.json": "imprime le resultat en JSON",
+    "cli.models.providers.description": "Liste les providers de cerveau et leur disponibilité.",
+    "cli.models.providers.option.json": "affiche les providers en JSON",
     "cli.firstRun.hint": "Aucun modele local installe. Executez: agent models install {{id}}",
     "cli.firstRun.prompt": "Aucun modele local installe. Installer le modele recommande {{id}} maintenant ? (y/N)",
     "cli.firstRun.installed": "Modele {{id}} installe et defini par defaut.",

package/src/assets/i18n/ja-JP.json

@@ -242,6 +242,20 @@
     "tui.foundation": "v0.3.5 技術基盤",
     "tui.prompt": "プロンプト: {{prompt}}",
     "tui.helpHint": "CLI オプションは agent --help を実行してください。",
+    "tui.error": "エラー: {{error}}",
+    "tui.newSession": "新しいセッション",
+    "tui.session": "セッション {{sessionId}}",
+    "tui.sessionResumed": "セッションを再開しました: {{sessionId}}",
+    "tui.sessionsListFailed": "セッションを一覧できませんでした。",
+    "tui.sessionsEmpty": "アクティブなセッションはありません。メッセージを送ると作成されます。",
+    "tui.approvalRequired": "ツール {{tool}} には承認が必要です。承認しますか? (y/n)",
+    "tui.approvalPlaceholder": "承認しますか? (y/n)",
+    "tui.approvalAccepted": "承認しました: {{tool}}。続行します...",
+    "tui.approvalDenied": "承認が拒否されました。タスクを停止しました。",
+    "tui.thinking": "思考中...",
+    "tui.kbd.send": "Enter 送信",
+    "tui.kbd.task": "/task <タスク>",
+    "tui.kbd.exit": "ctrl+c 終了",
     "cli.alias.description": "Agent DevKit CLI のローカルコマンド別名を管理します",
     "cli.alias.set.description": "ローカル CLI 別名を作成または更新します",
     "cli.alias.remove.description": "ローカル CLI 別名を削除します",
@@ -268,6 +282,8 @@
     "cli.models.use.option.chat": "チャット役割のデフォルトモデルを設定します",
     "cli.models.argument.id": "カタログモデル id",
     "cli.models.option.json": "結果を JSON で出力します",
+    "cli.models.providers.description": "ブレインプロバイダーと利用可否を一覧表示します。",
+    "cli.models.providers.option.json": "プロバイダーをJSONで出力",
     "cli.firstRun.hint": "ローカルモデルが未インストールです。実行: agent models install {{id}}",
     "cli.firstRun.prompt": "ローカルモデルが未インストールです。推奨モデル {{id}} を今インストールしますか？(y/N)",
     "cli.firstRun.installed": "モデル {{id}} をインストールし、デフォルトに設定しました。",

package/src/assets/i18n/pt-BR.json

@@ -242,6 +242,20 @@
     "tui.foundation": "v0.3.5 base tecnica",
     "tui.prompt": "Prompt: {{prompt}}",
     "tui.helpHint": "Execute agent --help para opcoes de CLI.",
+    "tui.error": "Erro: {{error}}",
+    "tui.newSession": "nova sessao",
+    "tui.session": "sessao {{sessionId}}",
+    "tui.sessionResumed": "Sessao retomada: {{sessionId}}",
+    "tui.sessionsListFailed": "Nao foi possivel listar as sessoes.",
+    "tui.sessionsEmpty": "Nenhuma sessao ativa. Envie uma mensagem para criar uma.",
+    "tui.approvalRequired": "A ferramenta {{tool}} precisa de aprovacao. Aprovar? (s/n)",
+    "tui.approvalPlaceholder": "aprovar? (s/n)",
+    "tui.approvalAccepted": "Aprovado: {{tool}}. Continuando...",
+    "tui.approvalDenied": "Aprovacao negada. Tarefa interrompida.",
+    "tui.thinking": "pensando...",
+    "tui.kbd.send": "Enter enviar",
+    "tui.kbd.task": "/task <tarefa>",
+    "tui.kbd.exit": "ctrl+c sair",
     "cli.alias.description": "gerencia um alias local para o CLI do Agent DevKit",
     "cli.alias.set.description": "cria ou atualiza o alias local do CLI",
     "cli.alias.remove.description": "remove o alias local do CLI",
@@ -268,6 +282,8 @@
     "cli.models.use.option.chat": "define o modelo padrao do papel de chat",
     "cli.models.argument.id": "id do modelo do catalogo",
     "cli.models.option.json": "imprime o resultado como JSON",
+    "cli.models.providers.description": "Lista os providers de cérebro e a disponibilidade de cada um.",
+    "cli.models.providers.option.json": "imprime providers em JSON",
     "cli.firstRun.hint": "Nenhum modelo local instalado. Rode: agent models install {{id}}",
     "cli.firstRun.prompt": "Nenhum modelo local instalado. Deseja instalar o modelo recomendado {{id}} agora? (s/N)",
     "cli.firstRun.installed": "Modelo {{id}} instalado e definido como padrao.",

package/src/assets/i18n/zh-CN.json

@@ -242,6 +242,20 @@
     "tui.foundation": "v0.3.5 技术基础",
     "tui.prompt": "提示: {{prompt}}",
     "tui.helpHint": "运行 agent --help 查看 CLI 选项。",
+    "tui.error": "错误: {{error}}",
+    "tui.newSession": "新会话",
+    "tui.session": "会话 {{sessionId}}",
+    "tui.sessionResumed": "已恢复会话: {{sessionId}}",
+    "tui.sessionsListFailed": "无法列出会话。",
+    "tui.sessionsEmpty": "没有活动会话。发送消息以创建一个。",
+    "tui.approvalRequired": "工具 {{tool}} 需要批准。批准? (y/n)",
+    "tui.approvalPlaceholder": "批准? (y/n)",
+    "tui.approvalAccepted": "已批准: {{tool}}。继续...",
+    "tui.approvalDenied": "批准被拒绝。任务已停止。",
+    "tui.thinking": "思考中...",
+    "tui.kbd.send": "Enter 发送",
+    "tui.kbd.task": "/task <任务>",
+    "tui.kbd.exit": "ctrl+c 退出",
     "cli.alias.description": "管理 Agent DevKit CLI 的本地命令别名",
     "cli.alias.set.description": "创建或更新本地 CLI 别名",
     "cli.alias.remove.description": "移除本地 CLI 别名",
@@ -268,6 +282,8 @@
     "cli.models.use.option.chat": "设置聊天角色的默认模型",
     "cli.models.argument.id": "目录模型 id",
     "cli.models.option.json": "以 JSON 输出结果",
+    "cli.models.providers.description": "列出大脑提供方及其可用状态。",
+    "cli.models.providers.option.json": "以JSON输出提供方",
     "cli.firstRun.hint": "未安装本地模型。运行: agent models install {{id}}",
     "cli.firstRun.prompt": "未安装本地模型。现在安装推荐模型 {{id}} 吗？(y/N)",
     "cli.firstRun.installed": "模型 {{id}} 已安装并设为默认。",

package/src/assets/prompts/core/chat.json

@@ -0,0 +1,63 @@
+{
+  "schema": "agent-devkit.prompt-pack/v1",
+  "id": "core/chat",
+  "version": "1.0.0",
+  "description": "Stateful chat prompt for the configured Agent DevKit personality.",
+  "locale": "pt-BR",
+  "output": {
+    "format": "text",
+    "language": "pt-BR"
+  },
+  "policies": {
+    "allowToolCalls": false,
+    "approvalRequired": false,
+    "maxToolCalls": 0
+  },
+  "knowledge": [
+    {
+      "id": "agent-devkit.identity",
+      "source": "core/chat",
+      "content": "Agent DevKit is a local AI agent toolkit exposed through the `agent` CLI, a TUI and MCP. It helps users operate this project through capabilities, local state, sessions, projects, preferences, personalization, logs, secrets, dependencies and local models."
+    },
+    {
+      "id": "agent-devkit.self-description-rule",
+      "source": "core/chat",
+      "content": "When the user asks personal questions about you, your personality or what you can do, answer as the configured character using your behavior, tone, detail level and traits. Do not answer as a generic human and do not list unrelated human activities."
+    },
+    {
+      "id": "agent-devkit.project-scope-rule",
+      "source": "core/chat",
+      "content": "Only describe Agent DevKit internals, modules, tools, MCP, CLI commands or project capabilities when the user explicitly asks about Agent DevKit, the project, tools, commands, MCP or capabilities."
+    },
+    {
+      "id": "agent-devkit.chat-mode-limits",
+      "source": "core/chat",
+      "content": "This conversation mode can answer, keep session memory and use project context. Direct tool execution is disabled in this chat prompt."
+    },
+    {
+      "id": "agent-devkit.capability-map",
+      "source": "core/chat",
+      "content": "Current capability areas include project doctor/init/reset, package update, preferences, themes, aliases, personalization characters, logs, encrypted secrets, dependency inspection/planning, models, projects, sessions, conversation, runtime runs, goals and memory."
+    },
+    {
+      "id": "agent-devkit.memory-rule",
+      "source": "core/chat",
+      "content": "Retrieved memory is context for this answer, not absolute truth. If memory conflicts with the current user request, prioritize the current request and be explicit when uncertain."
+    },
+    {
+      "id": "agent-devkit.context-rule",
+      "source": "core/chat",
+      "content": "Use retrieved session, project and memory context as evidence for continuity. Do not invent memories, project facts or past actions that are not present in the prompt."
+    },
+    {
+      "id": "agent-devkit.secret-rule",
+      "source": "core/chat",
+      "content": "Never ask the user to paste secrets into memory. Do not store credentials as memory or session knowledge."
+    }
+  ],
+  "task": {
+    "intent": "stateful-chat",
+    "userMessage": "{{userMessage}}",
+    "variables": ["userMessage"]
+  }
+}

package/src/assets/prompts/core/domain-decision.json

@@ -0,0 +1,33 @@
+{
+  "schema": "agent-devkit.prompt-pack/v1",
+  "id": "core/domain-decision",
+  "version": "1.0.0",
+  "description": "Hierarchical routing stage 1: pick the capability domains relevant to the task before choosing a concrete tool.",
+  "locale": "pt-BR",
+  "output": {
+    "format": "json",
+    "language": "pt-BR"
+  },
+  "policies": {
+    "allowToolCalls": false,
+    "approvalRequired": false,
+    "maxToolCalls": 0
+  },
+  "knowledge": [
+    {
+      "id": "agent.runtime.identity",
+      "source": "core/domain-decision",
+      "content": "You are the Agent DevKit orchestration runtime. First narrow the task to the capability domains that matter; concrete tools are chosen in the next step."
+    },
+    {
+      "id": "agent.runtime.domain-rule",
+      "source": "core/domain-decision",
+      "content": "Pick at most two domains. Only pick domains whose description matches the task. If no domain helps, answer final directly."
+    }
+  ],
+  "task": {
+    "intent": "domain-routing",
+    "userMessage": "Tarefa do usuario: {{task}}\n\nDominios de capabilities disponiveis:\n{{domains}}\n\nEscolha ate DOIS dominios relevantes para a tarefa, ou responda ao usuario se nenhuma ferramenta for necessaria.\nResponda SOMENTE com JSON. Para escolher dominios: {\"action\":\"domains\",\"domains\":[\"<id>\"]}. Para responder direto: {\"action\":\"final\",\"reply\":\"<texto>\"}.",
+    "variables": ["task", "domains"]
+  }
+}

package/src/assets/prompts/core/final-summary.json

@@ -0,0 +1,33 @@
+{
+  "schema": "agent-devkit.prompt-pack/v1",
+  "id": "core/final-summary",
+  "version": "1.0.0",
+  "description": "Summarize completed agent steps into a final user response.",
+  "locale": "pt-BR",
+  "output": {
+    "format": "json",
+    "language": "pt-BR"
+  },
+  "policies": {
+    "allowToolCalls": false,
+    "approvalRequired": false,
+    "maxToolCalls": 0
+  },
+  "knowledge": [
+    {
+      "id": "agent.runtime.final-summary-rule",
+      "source": "core/final-summary",
+      "content": "Summarize what was done, mention important failures or approvals, and keep the response concise."
+    },
+    {
+      "id": "agent.runtime.context-rule",
+      "source": "core/final-summary",
+      "content": "When referencing memory, sessions or project knowledge, only mention facts present in retrieved context or in the executed steps."
+    }
+  ],
+  "task": {
+    "intent": "final-summary",
+    "userMessage": "Tarefa original: {{task}}\nPassos executados:\n{{steps}}\n\nResponda SOMENTE com JSON: {\"reply\":\"resposta final ao usuario\"}.",
+    "variables": ["task", "steps"]
+  }
+}

package/src/assets/prompts/core/guardrails.json

@@ -0,0 +1,27 @@
+{
+  "schema": "agent-devkit.guardrail-set/v1",
+  "id": "core/guardrails",
+  "version": "1.0.0",
+  "rules": [
+    {
+      "id": "persona",
+      "severity": "guide",
+      "rule": "Answer as the configured character and keep the user's selected persona visible in behavior, tone and detail level."
+    },
+    {
+      "id": "scope",
+      "severity": "guide",
+      "rule": "Describe Agent DevKit internals only when the user explicitly asks about Agent DevKit, tools, commands, MCP, modules or capabilities."
+    },
+    {
+      "id": "secrets",
+      "severity": "block",
+      "rule": "Never store credentials or secret values as memory, prompt context or logs."
+    },
+    {
+      "id": "memory",
+      "severity": "warn",
+      "rule": "Treat retrieved memory as contextual evidence. Do not promote inferred knowledge without explicit review or approval."
+    }
+  ]
+}

package/src/assets/prompts/core/reflection.json

@@ -0,0 +1,33 @@
+{
+  "schema": "agent-devkit.prompt-pack/v1",
+  "id": "core/reflection",
+  "version": "1.0.0",
+  "description": "Reflect after a tool observation and decide the next loop action.",
+  "locale": "pt-BR",
+  "output": {
+    "format": "json",
+    "language": "pt-BR"
+  },
+  "policies": {
+    "allowToolCalls": true,
+    "approvalRequired": false,
+    "maxToolCalls": 1
+  },
+  "knowledge": [
+    {
+      "id": "agent.runtime.reflection-rule",
+      "source": "core/reflection",
+      "content": "After each observation, decide whether to continue, retry, repair, final, or stop. Never retry approval_required; ask for approval instead."
+    },
+    {
+      "id": "agent.runtime.context-rule",
+      "source": "core/reflection",
+      "content": "Use retrieved context to judge whether the observation satisfies the user's real goal. Do not treat old memory as more important than the current task."
+    }
+  ],
+  "task": {
+    "intent": "tool-reflection",
+    "userMessage": "Tarefa original: {{task}}\nPasso: {{stepObjective}}\nFerramenta executada: {{tool}}\nObservacao: {{observation}}\nRetries restantes: {{remainingRetries}}\n\nResponda SOMENTE com JSON: {\"action\":\"continue|retry|repair|final|stop\",\"reason\":\"...\",\"reply\":\"texto final opcional\",\"nextTool\":\"tool opcional\",\"revisedTask\":\"tarefa revisada opcional\"}.",
+    "variables": ["task", "stepObjective", "tool", "observation", "remainingRetries"]
+  }
+}

package/src/assets/prompts/core/task-plan.json

@@ -0,0 +1,33 @@
+{
+  "schema": "agent-devkit.prompt-pack/v1",
+  "id": "core/task-plan",
+  "version": "1.0.0",
+  "description": "Create a compact structured execution plan for an agentic task.",
+  "locale": "pt-BR",
+  "output": {
+    "format": "json",
+    "language": "pt-BR"
+  },
+  "policies": {
+    "allowToolCalls": true,
+    "approvalRequired": false,
+    "maxToolCalls": 1
+  },
+  "knowledge": [
+    {
+      "id": "agent.runtime.plan-rule",
+      "source": "core/task-plan",
+      "content": "Create a small plan before executing tools. Prefer one to three steps. Use only available tool ids when a tool is clearly needed."
+    },
+    {
+      "id": "agent.runtime.context-rule",
+      "source": "core/task-plan",
+      "content": "Use retrieved project, session and memory context to choose relevant steps. Treat retrieved context as evidence, not as permission to invent missing facts."
+    }
+  ],
+  "task": {
+    "intent": "task-planning",
+    "userMessage": "Tarefa do usuario: {{task}}\n\nFerramentas disponiveis: {{tools}}\nLimite de passos: {{maxSteps}}\n\nResponda SOMENTE com JSON no formato {\"summary\":\"...\",\"steps\":[{\"id\":\"step_001\",\"objective\":\"...\",\"reason\":\"...\",\"tool\":\"optional.tool.id\",\"dependsOn\":[],\"maxAttempts\":1}]}.",
+    "variables": ["task", "tools", "maxSteps"]
+  }
+}

package/src/assets/prompts/core/tool-decision.json

@@ -0,0 +1,38 @@
+{
+  "schema": "agent-devkit.prompt-pack/v1",
+  "id": "core/tool-decision",
+  "version": "1.0.0",
+  "description": "Agent loop routing prompt that chooses one tool or a final answer.",
+  "locale": "pt-BR",
+  "output": {
+    "format": "json",
+    "language": "pt-BR"
+  },
+  "policies": {
+    "allowToolCalls": true,
+    "approvalRequired": false,
+    "maxToolCalls": 1
+  },
+  "knowledge": [
+    {
+      "id": "agent.runtime.identity",
+      "source": "core/tool-decision",
+      "content": "You are the Agent DevKit orchestration runtime. Choose tools only when they directly help complete the user's task."
+    },
+    {
+      "id": "agent.runtime.single-action",
+      "source": "core/tool-decision",
+      "content": "Choose exactly one next action. Do not invent tools. If no listed tool helps, answer final."
+    },
+    {
+      "id": "agent.runtime.context-rule",
+      "source": "core/tool-decision",
+      "content": "Use retrieved context to decide whether a tool is necessary. If current user intent conflicts with retrieved memory, prioritize the current request."
+    }
+  ],
+  "task": {
+    "intent": "tool-routing",
+    "userMessage": "Tarefa do usuario: {{task}}\n\nEscolha UMA ferramenta da lista disponivel para avancar na tarefa, ou responda ao usuario se ja puder concluir.\nResponda SOMENTE com JSON. Para usar uma ferramenta: {\"action\":\"tool\",\"tool\":\"<id>\"}. Para responder: {\"action\":\"final\",\"reply\":\"<texto>\"}. Uma acao por vez. Os argumentos da ferramenta sao definidos no passo seguinte.",
+    "variables": ["task"]
+  }
+}

package/src/assets/prompts/core/tool-input.json

@@ -0,0 +1,33 @@
+{
+  "schema": "agent-devkit.prompt-pack/v1",
+  "id": "core/tool-input",
+  "version": "1.0.0",
+  "description": "Agent loop prompt that produces structured input for a selected tool.",
+  "locale": "pt-BR",
+  "output": {
+    "format": "json",
+    "language": "pt-BR"
+  },
+  "policies": {
+    "allowToolCalls": true,
+    "approvalRequired": false,
+    "maxToolCalls": 1
+  },
+  "knowledge": [
+    {
+      "id": "agent.runtime.identity",
+      "source": "core/tool-input",
+      "content": "You are the Agent DevKit orchestration runtime. Generate only valid input for the selected capability."
+    },
+    {
+      "id": "agent.runtime.context-rule",
+      "source": "core/tool-input",
+      "content": "Use retrieved context only to fill fields that are directly supported by the selected tool schema. Do not leak secrets or add unsupported fields."
+    }
+  ],
+  "task": {
+    "intent": "tool-input",
+    "userMessage": "Tarefa do usuario: {{task}}\n\nGere APENAS o objeto JSON de entrada para a ferramenta {{toolId}}.\nFormato esperado: {{schemaSummary}}\nResponda somente com o JSON do input, sem texto extra.",
+    "variables": ["task", "toolId", "schemaSummary"]
+  }
+}

package/src/modules/context/surface/knowledge.json

@@ -1,11 +1,12 @@
 {
   "moduleId": "context",
-  "summary": "Context stores projects and sessions under ~/.agent-devkit/data/context. Sessions record what happened; knowledge stores durable reusable project facts.",
+  "summary": "Context stores projects, sessions, session summaries and reviewed knowledge candidates under ~/.agent-devkit/data/context.",
   "facts": [
     "Projects live under data/context/projects/<project-id>.",
     "Standalone sessions live under data/context/sessions/<session-id>.",
     "Project sessions live under data/context/projects/<project-id>/sessions/<session-id>.",
     "messages.jsonl is append-only.",
-    "Knowledge promotion is documented but not automated in this phase."
+    "Session summaries are deterministic extraction artifacts and do not automatically become memory.",
+    "Knowledge candidates can be manually promoted to project knowledge, global memory, or both."
   ]
 }

package/src/modules/context/surface/loop.json

@@ -4,10 +4,13 @@
   "allowedActions": [
     "Create and list projects.",
     "Create, append, search and resume sessions.",
+    "Summarize sessions into reviewable knowledge candidates.",
+    "Promote reviewed candidates to project knowledge, global memory, or both.",
     "Archive or soft delete context records when requested."
   ],
   "forbiddenActions": [
     "Invent durable knowledge without explicit source.",
+    "Promote candidates without user approval.",
     "Hard delete context without approval.",
     "Treat session search as semantic vector retrieval."
   ],

package/src/modules/context/surface/skill.json

@@ -1,10 +1,11 @@
 {
   "moduleId": "context",
-  "purpose": "Manage Agent DevKit projects and sessions as structured local context.",
+  "purpose": "Manage Agent DevKit projects, sessions, summaries and project knowledge promotion as structured local context.",
   "whenToUse": [
     "The user wants to persist or resume a conversation.",
     "The user wants to organize sessions by project.",
-    "An external agent needs searchable context history."
+    "An external agent needs searchable context history.",
+    "The user wants to review or promote knowledge extracted from a session."
   ],
   "whenNotToUse": [
     "The user expects semantic vector memory.",

package/src/modules/conversation/surface/prompt.json

@@ -1,10 +1,9 @@
 {
   "moduleId": "conversation",
-  "templates": [
+  "packs": [
     {
       "id": "conversation.chat",
-      "template": "Use the active character, session memory and optional project context to answer the user. Tool calls are disabled for this phase. User message: {{message}}",
-      "variables": ["message"]
+      "packId": "core/chat"
     }
   ]
 }

package/src/modules/integrations/surface/knowledge.json

@@ -0,0 +1,9 @@
+{
+  "moduleId": "integrations",
+  "summary": "Integrations connect Agent DevKit to external tools and MCP servers. External tools are cached locally before the agent can use them.",
+  "facts": [
+    "External MCP tools are exposed to the agent with ids formatted as mcp.<serverId>.<toolName>.",
+    "The agent only sees external MCP tools after the server tools have been refreshed into the local cache.",
+    "External MCP write, destructive, or unknown-risk tools require explicit approval before execution."
+  ]
+}

package/src/modules/integrations/surface/loop.json

@@ -0,0 +1,15 @@
+{
+  "moduleId": "integrations",
+  "mode": "cache-before-use",
+  "allowedActions": [
+    "Register external MCP servers requested by the user.",
+    "Refresh and inspect external MCP tool catalogs.",
+    "Use cached external MCP tools when they match the user's task and approval policy allows execution."
+  ],
+  "forbiddenActions": [
+    "Persist raw credentials in MCP server configuration.",
+    "Execute external MCP tools without applying approval policy.",
+    "Assume an external MCP tool exists before refreshing the server tool cache."
+  ],
+  "approvalRequired": true
+}

package/src/modules/integrations/surface/prompt.json

@@ -0,0 +1,10 @@
+{
+  "moduleId": "integrations",
+  "templates": [
+    {
+      "id": "integrations.mcpServers",
+      "template": "Explain this external MCP integration result and identify whether tools were cached, disabled, or blocked by approval policy: {{result}}",
+      "variables": ["result"]
+    }
+  ]
+}

package/src/modules/integrations/surface/skill.json

@@ -0,0 +1,13 @@
+{
+  "moduleId": "integrations",
+  "purpose": "Manage external integrations that extend the local agent runtime, starting with MCP servers.",
+  "whenToUse": [
+    "The user wants to connect Agent DevKit to an external MCP server.",
+    "The agent needs to list or refresh external MCP tools available for orchestration.",
+    "The user asks whether a registered MCP integration is enabled or working."
+  ],
+  "whenNotToUse": [
+    "The user wants to expose Agent DevKit itself as an MCP server; use the app MCP server commands instead.",
+    "The integration requires OAuth or secret environment handling that is not configured yet."
+  ]
+}

package/src/modules/memory/surface/knowledge.json

@@ -0,0 +1,11 @@
+{
+  "moduleId": "memory",
+  "summary": "Memory stores global learned facts, preferences, patterns, decisions and episodes independently from chat sessions and projects.",
+  "facts": [
+    "Runtime runs are operational traces; memory records are consolidated knowledge for future retrieval.",
+    "Agent-inferred memory must start as a review candidate unless explicitly promoted.",
+    "Explicit user memory may be stored as active.",
+    "Knowledge candidates extracted from sessions can be listed, approved into memory, or rejected.",
+    "Forgetting memory marks the record as forgotten and preserves an audit trail."
+  ]
+}

package/src/modules/memory/surface/loop.json

@@ -0,0 +1,19 @@
+{
+  "moduleId": "memory",
+  "mode": "global-memory-management",
+  "allowedActions": [
+    "Learn explicit user facts, preferences, patterns, decisions and episodes.",
+    "Store inferred learning as candidate memory.",
+    "Review extracted knowledge candidates before approval.",
+    "Search active and candidate memory records.",
+    "Update, reject or forget memory records when explicitly instructed.",
+    "Inspect memory audit events."
+  ],
+  "forbiddenActions": [
+    "Treat raw runtime events as confirmed memory without review.",
+    "Store secrets or credentials as memory.",
+    "Physically delete memory records when forget is requested.",
+    "Promote inferred memory to active without explicit user confirmation."
+  ],
+  "approvalRequired": true
+}