agent-devkit 0.5.7 → 0.7.0

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

@@ -1,12 +1,12 @@
 {
   "schema": "agent-devkit.prompt-pack/v1",
   "id": "core/chat",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Stateful chat prompt for the configured Agent DevKit personality.",
   "locale": "pt-BR",
   "output": {
     "format": "text",
-    "language": "pt-BR"
+    "language": "auto"
   },
   "policies": {
     "allowToolCalls": false,
@@ -14,6 +14,21 @@
     "maxToolCalls": 0
   },
   "knowledge": [
+    {
+      "id": "agent-devkit.direct-answer-style",
+      "source": "core/chat",
+      "content": "Answer the way a person would: direct, natural and concise. Lead with the answer itself. Never restate or paraphrase the user's request back to them. Never narrate your reasoning or thought process (no 'the user wants...', 'let me be honest', 'I need to remember that...'). Never describe your own mode, configuration or internal rules unless the user explicitly asks."
+    },
+    {
+      "id": "agent-devkit.no-filler-rule",
+      "source": "core/chat",
+      "content": "Skip filler openings and closings. Do not start with praise of the question or the request. Do not end with generic offers of more help unless a concrete follow-up genuinely exists."
+    },
+    {
+      "id": "agent-devkit.language-match-rule",
+      "source": "core/chat",
+      "content": "Always reply in the language of the user's current message, even if it differs from the configured locale. If the user writes in English, reply in English; Portuguese, reply in Portuguese. Do not comment on the language switch."
+    },
     {
       "id": "agent-devkit.identity",
       "source": "core/chat",
@@ -30,9 +45,9 @@
       "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",
+      "id": "agent-devkit.honesty-rule",
       "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."
+      "content": "Never claim to have executed an action you did not execute in this turn. If something could not be done, say so in one short sentence and offer the next step."
     },
     {
       "id": "agent-devkit.capability-map",

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

@@ -0,0 +1,28 @@
+{
+  "schema": "agent-devkit.prompt-pack/v1",
+  "id": "core/compact",
+  "version": "1.0.0",
+  "description": "Compacts a long conversation into a dense summary that can replace the history in a fresh context window.",
+  "locale": "pt-BR",
+  "output": {
+    "format": "text",
+    "language": "auto"
+  },
+  "policies": {
+    "allowToolCalls": false,
+    "approvalRequired": false,
+    "maxToolCalls": 0
+  },
+  "knowledge": [
+    {
+      "id": "agent.compact.rule",
+      "source": "core/compact",
+      "content": "You are compacting a conversation to free context. Produce a dense, factual summary that preserves: user goals and decisions, facts and preferences the user stated, unfinished tasks and their exact state, names, paths, ids and numbers mentioned, and commitments the assistant made. Do not include pleasantries or meta commentary. Write in the conversation's language."
+    }
+  ],
+  "task": {
+    "intent": "context-compaction",
+    "userMessage": "Compacte a conversa abaixo em um resumo denso (no maximo ~20 linhas), preservando fatos, decisoes, pendencias e identificadores exatos.\n\n{{transcript}}",
+    "variables": ["transcript"]
+  }
+}

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/intent.json

@@ -0,0 +1,33 @@
+{
+  "schema": "agent-devkit.prompt-pack/v1",
+  "id": "core/intent",
+  "version": "1.0.0",
+  "description": "Classifies a user message as conversation (chat) or an action request (task) so the runtime can route it.",
+  "locale": "pt-BR",
+  "output": {
+    "format": "json",
+    "language": "pt-BR"
+  },
+  "policies": {
+    "allowToolCalls": false,
+    "approvalRequired": false,
+    "maxToolCalls": 0
+  },
+  "knowledge": [
+    {
+      "id": "agent.intent.rule",
+      "source": "core/intent",
+      "content": "task = the user asks the agent to DO or CHANGE something: rename or configure the agent, create/update/delete local state, run diagnostics, install models, manage sessions/projects/preferences/secrets, analyze files or logs, execute any capability. chat = questions, explanations, opinions, small talk, or requests for information that need no tool."
+    },
+    {
+      "id": "agent.intent.bias",
+      "source": "core/intent",
+      "content": "When genuinely ambiguous, prefer chat. Greetings and questions about the agent itself are chat."
+    }
+  ],
+  "task": {
+    "intent": "intent-routing",
+    "userMessage": "Mensagem do usuario: {{message}}\n\nClassifique a mensagem. Responda SOMENTE com JSON: {\"intent\":\"chat\"} ou {\"intent\":\"task\"}.",
+    "variables": ["message"]
+  }
+}

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

@@ -0,0 +1,33 @@
+{
+  "schema": "agent-devkit.prompt-pack/v1",
+  "id": "core/review",
+  "version": "1.0.0",
+  "description": "Coordinator review of delegated subagent results before the final answer.",
+  "locale": "pt-BR",
+  "output": {
+    "format": "json",
+    "language": "pt-BR"
+  },
+  "policies": {
+    "allowToolCalls": false,
+    "approvalRequired": false,
+    "maxToolCalls": 0
+  },
+  "knowledge": [
+    {
+      "id": "agent.runtime.review-rule",
+      "source": "core/review",
+      "content": "Judge whether the delegated results, taken together, satisfy the user's original task. Approve when the evidence is sufficient even if imperfect; reject only when a concrete gap or error blocks a trustworthy final answer."
+    },
+    {
+      "id": "agent.runtime.review-fix-rule",
+      "source": "core/review",
+      "content": "When rejecting, provide a short actionable fixInstruction that a subagent can append to its objective. There is only one redelegation cycle: make the instruction specific."
+    }
+  ],
+  "task": {
+    "intent": "delegation-review",
+    "userMessage": "Tarefa original: {{task}}\n\nResultados delegados:\n{{delegatedResults}}\n\nAvalie se os resultados atendem ao objetivo. Responda SOMENTE com JSON: {\"verdict\":\"approved|rejected\",\"reason\":\"...\",\"fixInstruction\":\"instrucao opcional para o ciclo de correcao\"}.",
+    "variables": ["task", "delegatedResults"]
+  }
+}

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

@@ -1,8 +1,8 @@
 {
   "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.",
+  "version": "1.1.0",
+  "description": "Create a compact structured execution plan for an agentic task, with optional delegation to subagent profiles.",
   "locale": "pt-BR",
   "output": {
     "format": "json",
@@ -23,11 +23,21 @@
       "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."
+    },
+    {
+      "id": "agent.runtime.delegation-rule",
+      "source": "core/task-plan",
+      "content": "For each step set assignTo to a subagent profile id to delegate it, or to \"self\" when the coordinator should execute it directly. Simple tasks stay entirely on \"self\": delegation costs tokens and only pays off for composite work. Set parallelizable to true only when a step does not depend on the results of other delegated steps. Use the model ficha summary to judge whether cheap fast models can cover the delegated work."
+    },
+    {
+      "id": "agent.runtime.sharding-rule",
+      "source": "core/task-plan",
+      "content": "Large uniform workloads MAY be sharded: create multiple parallelizable steps assigned to the same profile, each with a partitioned objective (for example, four file-scout steps investigating ten files each). The coordinator merges the results."
     }
   ],
   "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"]
+    "userMessage": "Tarefa do usuario: {{task}}\n\nFerramentas disponiveis: {{tools}}\nLimite de passos: {{maxSteps}}\n\nPerfis de subagentes disponiveis (use o id em assignTo, ou \"self\" para o coordenador):\n{{profiles}}\n\nFicha de modelos (tier, custo e disponibilidade, para calibrar a delegacao):\n{{modelCards}}\n\nRegras de delegacao: delegue apenas quando a tarefa for composta; steps sem dependencia entre si podem ter parallelizable=true; tarefas grandes e uniformes podem virar varios steps paralelizaveis do mesmo perfil com objetivos particionados.\n\nResponda SOMENTE com JSON no formato {\"summary\":\"...\",\"steps\":[{\"id\":\"step_001\",\"objective\":\"...\",\"reason\":\"...\",\"tool\":\"optional.tool.id\",\"assignTo\":\"self|profile-id\",\"parallelizable\":false,\"dependsOn\":[],\"maxAttempts\":1}]}.",
+    "variables": ["task", "tools", "maxSteps", "profiles", "modelCards"]
   }
 }

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

@@ -0,0 +1,10 @@
+{
+  "moduleId": "providers",
+  "summary": "Brain providers authenticate in three ways: CLI providers (claude, codex, gemini) log in through their own binaries; API providers (openai, openrouter, anthropic) store keys in the encrypted secrets vault; Ollama is a local endpoint connection.",
+  "facts": [
+    "API keys are stored in the encrypted vault under provider/<id>/api-key and are never written to logs or plain files.",
+    "The Ollama endpoint URL is persisted in ~/.agent-devkit/data/preferences/providers.json.",
+    "CLI provider logins are managed by the provider's own binary; Agent DevKit only spawns the interactive flow.",
+    "A provider without credentials appears as needs-login in the model cards and never breaks the routing chain."
+  ]
+}

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

@@ -0,0 +1,15 @@
+{
+  "moduleId": "providers",
+  "mode": "credential-safety",
+  "allowedActions": [
+    "Report authentication status for every brain provider.",
+    "Store or remove provider API keys in the encrypted vault on explicit request.",
+    "Probe and persist the Ollama endpoint URL on explicit request."
+  ],
+  "forbiddenActions": [
+    "Print, log or persist an API key value anywhere outside the encrypted vault.",
+    "Store a credential without an explicit user request.",
+    "Run an interactive CLI login without the user asking for it."
+  ],
+  "approvalRequired": true
+}

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

@@ -0,0 +1,10 @@
+{
+  "moduleId": "providers",
+  "templates": [
+    {
+      "id": "providers.auth",
+      "template": "Summarize this Agent DevKit provider authentication operation for the user without revealing any secret values: {{operation}}",
+      "variables": ["operation"]
+    }
+  ]
+}

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

@@ -0,0 +1,14 @@
+{
+  "moduleId": "providers",
+  "purpose": "Manage brain provider logins and connections: CLI logins, API keys in the vault and the Ollama endpoint.",
+  "whenToUse": [
+    "The user wants to see which brain providers are authenticated or connected.",
+    "The user wants to store or remove an API key for openai, openrouter or anthropic.",
+    "The user wants to connect Agent DevKit to a running Ollama server."
+  ],
+  "whenNotToUse": [
+    "The user wants to send a chat message or run model inference.",
+    "The user wants to manage generic secrets unrelated to brain providers.",
+    "The user wants to install or remove local GGUF models."
+  ]
+}