agent-devkit 0.6.0 → 0.7.0

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."
+  ]
+}