agent-devkit 0.7.0 → 0.8.3

package/src/assets/tooling/sqlite3.json

@@ -0,0 +1,39 @@
+{
+  "schema": "agent-devkit.tooling/v1",
+  "id": "sqlite3",
+  "name": "SQLite",
+  "category": "database",
+  "kind": "cli",
+  "homepage": "https://www.sqlite.org",
+  "commands": ["sqlite3"],
+  "detect": {
+    "which": ["sqlite3"],
+    "version": {
+      "command": "sqlite3",
+      "args": ["--version"],
+      "parser": "(?<version>\\d+\\.\\d+\\.\\d+)"
+    }
+  },
+  "install": [
+    { "manager": "brew", "platforms": ["darwin"], "command": "brew", "args": ["install", "sqlite"] }
+  ],
+  "upgrade": [
+    { "manager": "brew", "platforms": ["darwin"], "command": "brew", "args": ["upgrade", "sqlite"] }
+  ],
+  "downgrade": [
+    {
+      "manager": "brew",
+      "platforms": ["darwin"],
+      "command": "brew",
+      "args": ["install", "sqlite@{{version}}"]
+    }
+  ],
+  "uninstall": [
+    {
+      "manager": "brew",
+      "platforms": ["darwin"],
+      "command": "brew",
+      "args": ["uninstall", "sqlite"]
+    }
+  ]
+}

package/src/assets/tooling/stripe.json

@@ -0,0 +1,51 @@
+{
+  "schema": "agent-devkit.tooling/v1",
+  "id": "stripe",
+  "name": "Stripe CLI",
+  "category": "cloud",
+  "kind": "cli",
+  "homepage": "https://stripe.com/docs/stripe-cli",
+  "commands": ["stripe"],
+  "detect": {
+    "which": ["stripe"],
+    "version": {
+      "command": "stripe",
+      "args": ["version"],
+      "parser": "stripe version (?<version>\\d+\\.\\d+\\.\\d+)"
+    }
+  },
+  "doctor": { "command": "stripe", "args": ["config", "--list"] },
+  "install": [
+    {
+      "manager": "brew",
+      "platforms": ["darwin", "linux"],
+      "command": "brew",
+      "args": ["install", "stripe/stripe-cli/stripe"]
+    }
+  ],
+  "upgrade": [
+    {
+      "manager": "brew",
+      "platforms": ["darwin", "linux"],
+      "command": "brew",
+      "args": ["upgrade", "stripe"]
+    }
+  ],
+  "downgrade": [
+    {
+      "manager": "brew",
+      "platforms": ["darwin", "linux"],
+      "command": "brew",
+      "args": ["install", "stripe@{{version}}"]
+    }
+  ],
+  "uninstall": [
+    {
+      "manager": "brew",
+      "platforms": ["darwin", "linux"],
+      "command": "brew",
+      "args": ["uninstall", "stripe"]
+    }
+  ],
+  "workspace": { "files": ["stripe.toml"] }
+}

package/src/assets/tooling/supabase.json

@@ -0,0 +1,47 @@
+{
+  "schema": "agent-devkit.tooling/v1",
+  "id": "supabase",
+  "name": "Supabase CLI",
+  "category": "cloud",
+  "kind": "cli",
+  "homepage": "https://supabase.com/docs/guides/cli",
+  "commands": ["supabase"],
+  "detect": {
+    "which": ["supabase"],
+    "version": {
+      "command": "supabase",
+      "args": ["--version"],
+      "parser": "(?<version>\\d+\\.\\d+\\.\\d+)"
+    }
+  },
+  "doctor": { "command": "supabase", "args": ["status"] },
+  "install": [
+    {
+      "manager": "brew",
+      "platforms": ["darwin"],
+      "command": "brew",
+      "args": ["install", "supabase/tap/supabase"]
+    },
+    { "command": "npm", "args": ["install", "-g", "supabase"] }
+  ],
+  "upgrade": [
+    {
+      "manager": "brew",
+      "platforms": ["darwin"],
+      "command": "brew",
+      "args": ["upgrade", "supabase"]
+    },
+    { "command": "npm", "args": ["install", "-g", "supabase@latest"] }
+  ],
+  "downgrade": [{ "command": "npm", "args": ["install", "-g", "supabase@{{version}}"] }],
+  "uninstall": [
+    {
+      "manager": "brew",
+      "platforms": ["darwin"],
+      "command": "brew",
+      "args": ["uninstall", "supabase"]
+    },
+    { "command": "npm", "args": ["uninstall", "-g", "supabase"] }
+  ],
+  "workspace": { "files": ["supabase/config.toml"] }
+}

package/src/assets/tooling/svelte.json

@@ -0,0 +1,26 @@
+{
+  "schema": "agent-devkit.tooling/v1",
+  "id": "svelte",
+  "name": "Svelte",
+  "category": "framework",
+  "kind": "project-dependency",
+  "homepage": "https://svelte.dev",
+  "commands": ["npm"],
+  "detect": {
+    "which": ["npm"],
+    "version": {
+      "command": "npm",
+      "args": ["view", "svelte", "version"],
+      "parser": "(?<version>\\d+\\.\\d+\\.\\d+)"
+    }
+  },
+  "versions": { "command": "npm", "args": ["view", "svelte", "versions", "--json"] },
+  "install": [{ "workspace": true, "command": "npm", "args": ["install", "svelte"] }],
+  "upgrade": [{ "workspace": true, "command": "npm", "args": ["install", "svelte@latest"] }],
+  "downgrade": [{ "workspace": true, "command": "npm", "args": ["install", "svelte@{{version}}"] }],
+  "uninstall": [{ "workspace": true, "command": "npm", "args": ["uninstall", "svelte"] }],
+  "workspace": {
+    "files": ["svelte.config.js", "svelte.config.ts", "package.json"],
+    "dependencies": ["svelte"]
+  }
+}

package/src/assets/tooling/terraform.json

@@ -0,0 +1,47 @@
+{
+  "schema": "agent-devkit.tooling/v1",
+  "id": "terraform",
+  "name": "Terraform",
+  "category": "devops",
+  "kind": "cli",
+  "homepage": "https://www.terraform.io",
+  "commands": ["terraform"],
+  "detect": {
+    "which": ["terraform"],
+    "version": {
+      "command": "terraform",
+      "args": ["version"],
+      "parser": "Terraform v(?<version>\\d+\\.\\d+\\.\\d+)"
+    }
+  },
+  "doctor": { "command": "terraform", "args": ["version"] },
+  "install": [
+    {
+      "manager": "brew",
+      "platforms": ["darwin"],
+      "command": "brew",
+      "args": ["install", "terraform"]
+    }
+  ],
+  "upgrade": [
+    {
+      "manager": "brew",
+      "platforms": ["darwin"],
+      "command": "brew",
+      "args": ["upgrade", "terraform"]
+    }
+  ],
+  "downgrade": [
+    { "manager": "tfenv", "command": "tfenv", "args": ["install", "{{version}}"] },
+    { "manager": "tfenv", "command": "tfenv", "args": ["use", "{{version}}"] }
+  ],
+  "uninstall": [
+    {
+      "manager": "brew",
+      "platforms": ["darwin"],
+      "command": "brew",
+      "args": ["uninstall", "terraform"]
+    }
+  ],
+  "workspace": { "files": ["main.tf", "terraform.tfvars"] }
+}

package/src/assets/tooling/turbo.json

@@ -0,0 +1,25 @@
+{
+  "schema": "agent-devkit.tooling/v1",
+  "id": "turbo",
+  "name": "Turborepo",
+  "category": "tool",
+  "kind": "cli",
+  "homepage": "https://turbo.build",
+  "commands": ["turbo"],
+  "detect": {
+    "which": ["turbo"],
+    "version": {
+      "command": "turbo",
+      "args": ["--version"],
+      "parser": "(?<version>\\d+\\.\\d+\\.\\d+)"
+    }
+  },
+  "versions": { "command": "npm", "args": ["view", "turbo", "versions", "--json"] },
+  "install": [{ "manager": "npm", "command": "npm", "args": ["install", "-g", "turbo"] }],
+  "upgrade": [{ "manager": "npm", "command": "npm", "args": ["install", "-g", "turbo@latest"] }],
+  "downgrade": [
+    { "manager": "npm", "command": "npm", "args": ["install", "-g", "turbo@{{version}}"] }
+  ],
+  "uninstall": [{ "manager": "npm", "command": "npm", "args": ["uninstall", "-g", "turbo"] }],
+  "workspace": { "files": ["turbo.json"], "dependencies": ["turbo"] }
+}

package/src/assets/tooling/uv.json

@@ -0,0 +1,25 @@
+{
+  "schema": "agent-devkit.tooling/v1",
+  "id": "uv",
+  "name": "uv",
+  "category": "package-manager",
+  "kind": "package-manager",
+  "homepage": "https://docs.astral.sh/uv/",
+  "commands": ["uv"],
+  "detect": {
+    "which": ["uv"],
+    "version": {
+      "command": "uv",
+      "args": ["--version"],
+      "parser": "uv (?<version>\\d+\\.\\d+\\.\\d+)"
+    }
+  },
+  "versions": { "command": "pipx", "args": ["runpip", "uv", "index", "versions", "uv"] },
+  "install": [
+    { "manager": "brew", "platforms": ["darwin"], "command": "brew", "args": ["install", "uv"] },
+    { "command": "python3", "args": ["-m", "pip", "install", "uv"] }
+  ],
+  "upgrade": [{ "command": "python3", "args": ["-m", "pip", "install", "--upgrade", "uv"] }],
+  "downgrade": [{ "command": "python3", "args": ["-m", "pip", "install", "uv=={{version}}"] }],
+  "uninstall": [{ "command": "python3", "args": ["-m", "pip", "uninstall", "-y", "uv"] }]
+}

package/src/assets/tooling/vault.json

@@ -0,0 +1,50 @@
+{
+  "schema": "agent-devkit.tooling/v1",
+  "id": "vault",
+  "name": "HashiCorp Vault CLI",
+  "category": "devops",
+  "kind": "cli",
+  "homepage": "https://developer.hashicorp.com/vault",
+  "commands": ["vault"],
+  "detect": {
+    "which": ["vault"],
+    "version": {
+      "command": "vault",
+      "args": ["version"],
+      "parser": "Vault v(?<version>\\d+\\.\\d+\\.\\d+)"
+    }
+  },
+  "doctor": { "command": "vault", "args": ["status"] },
+  "install": [
+    {
+      "manager": "brew",
+      "platforms": ["darwin", "linux"],
+      "command": "brew",
+      "args": ["install", "hashicorp/tap/vault"]
+    }
+  ],
+  "upgrade": [
+    {
+      "manager": "brew",
+      "platforms": ["darwin", "linux"],
+      "command": "brew",
+      "args": ["upgrade", "vault"]
+    }
+  ],
+  "downgrade": [
+    {
+      "manager": "brew",
+      "platforms": ["darwin", "linux"],
+      "command": "brew",
+      "args": ["install", "vault@{{version}}"]
+    }
+  ],
+  "uninstall": [
+    {
+      "manager": "brew",
+      "platforms": ["darwin", "linux"],
+      "command": "brew",
+      "args": ["uninstall", "vault"]
+    }
+  ]
+}

package/src/assets/tooling/vercel.json

@@ -0,0 +1,24 @@
+{
+  "schema": "agent-devkit.tooling/v1",
+  "id": "vercel",
+  "name": "Vercel CLI",
+  "category": "cloud",
+  "kind": "cli",
+  "homepage": "https://vercel.com/docs/cli",
+  "commands": ["vercel"],
+  "detect": {
+    "which": ["vercel"],
+    "version": {
+      "command": "vercel",
+      "args": ["--version"],
+      "parser": "Vercel CLI (?<version>\\d+\\.\\d+\\.\\d+)"
+    }
+  },
+  "doctor": { "command": "vercel", "args": ["whoami"] },
+  "versions": { "command": "npm", "args": ["view", "vercel", "versions", "--json"] },
+  "install": [{ "command": "npm", "args": ["install", "-g", "vercel"] }],
+  "upgrade": [{ "command": "npm", "args": ["install", "-g", "vercel@latest"] }],
+  "downgrade": [{ "command": "npm", "args": ["install", "-g", "vercel@{{version}}"] }],
+  "uninstall": [{ "command": "npm", "args": ["uninstall", "-g", "vercel"] }],
+  "workspace": { "files": ["vercel.json"] }
+}

package/src/assets/tooling/vite.json

@@ -0,0 +1,28 @@
+{
+  "schema": "agent-devkit.tooling/v1",
+  "id": "vite",
+  "name": "Vite",
+  "category": "framework",
+  "kind": "project-dependency",
+  "homepage": "https://vite.dev",
+  "commands": ["npm"],
+  "detect": {
+    "which": ["npm"],
+    "version": {
+      "command": "npm",
+      "args": ["view", "vite", "version"],
+      "parser": "(?<version>\\d+\\.\\d+\\.\\d+)"
+    }
+  },
+  "versions": { "command": "npm", "args": ["view", "vite", "versions", "--json"] },
+  "install": [{ "workspace": true, "command": "npm", "args": ["install", "-D", "vite"] }],
+  "upgrade": [{ "workspace": true, "command": "npm", "args": ["install", "-D", "vite@latest"] }],
+  "downgrade": [
+    { "workspace": true, "command": "npm", "args": ["install", "-D", "vite@{{version}}"] }
+  ],
+  "uninstall": [{ "workspace": true, "command": "npm", "args": ["uninstall", "vite"] }],
+  "workspace": {
+    "files": ["vite.config.js", "vite.config.mjs", "vite.config.ts", "package.json"],
+    "dependencies": ["vite"]
+  }
+}

package/src/assets/tooling/vue.json

@@ -0,0 +1,23 @@
+{
+  "schema": "agent-devkit.tooling/v1",
+  "id": "vue",
+  "name": "Vue",
+  "category": "framework",
+  "kind": "project-dependency",
+  "homepage": "https://vuejs.org",
+  "commands": ["npm"],
+  "detect": {
+    "which": ["npm"],
+    "version": {
+      "command": "npm",
+      "args": ["view", "vue", "version"],
+      "parser": "(?<version>\\d+\\.\\d+\\.\\d+)"
+    }
+  },
+  "versions": { "command": "npm", "args": ["view", "vue", "versions", "--json"] },
+  "install": [{ "workspace": true, "command": "npm", "args": ["install", "vue"] }],
+  "upgrade": [{ "workspace": true, "command": "npm", "args": ["install", "vue@latest"] }],
+  "downgrade": [{ "workspace": true, "command": "npm", "args": ["install", "vue@{{version}}"] }],
+  "uninstall": [{ "workspace": true, "command": "npm", "args": ["uninstall", "vue"] }],
+  "workspace": { "files": ["vue.config.js", "package.json"], "dependencies": ["vue"] }
+}

package/src/assets/tooling/wrangler.json

@@ -0,0 +1,26 @@
+{
+  "schema": "agent-devkit.tooling/v1",
+  "id": "wrangler",
+  "name": "Cloudflare Wrangler",
+  "category": "cloud",
+  "kind": "cli",
+  "homepage": "https://developers.cloudflare.com/workers/wrangler/",
+  "commands": ["wrangler"],
+  "detect": {
+    "which": ["wrangler"],
+    "version": {
+      "command": "wrangler",
+      "args": ["--version"],
+      "parser": "wrangler (?<version>\\d+\\.\\d+\\.\\d+)"
+    }
+  },
+  "versions": { "command": "npm", "args": ["view", "wrangler", "versions", "--json"] },
+  "doctor": { "command": "wrangler", "args": ["whoami"] },
+  "install": [{ "manager": "npm", "command": "npm", "args": ["install", "-g", "wrangler"] }],
+  "upgrade": [{ "manager": "npm", "command": "npm", "args": ["install", "-g", "wrangler@latest"] }],
+  "downgrade": [
+    { "manager": "npm", "command": "npm", "args": ["install", "-g", "wrangler@{{version}}"] }
+  ],
+  "uninstall": [{ "manager": "npm", "command": "npm", "args": ["uninstall", "-g", "wrangler"] }],
+  "workspace": { "files": ["wrangler.toml", "wrangler.json", "wrangler.jsonc"] }
+}

package/src/assets/tooling/yarn.json

@@ -0,0 +1,25 @@
+{
+  "schema": "agent-devkit.tooling/v1",
+  "id": "yarn",
+  "name": "Yarn",
+  "category": "package-manager",
+  "kind": "package-manager",
+  "homepage": "https://yarnpkg.com",
+  "commands": ["yarn"],
+  "detect": {
+    "which": ["yarn"],
+    "version": {
+      "command": "yarn",
+      "args": ["--version"],
+      "parser": "(?<version>\\d+\\.\\d+\\.\\d+)"
+    }
+  },
+  "versions": { "command": "npm", "args": ["view", "yarn", "versions", "--json"] },
+  "install": [
+    { "command": "corepack", "args": ["enable", "yarn"] },
+    { "command": "npm", "args": ["install", "-g", "yarn"] }
+  ],
+  "upgrade": [{ "command": "npm", "args": ["install", "-g", "yarn@latest"] }],
+  "downgrade": [{ "command": "npm", "args": ["install", "-g", "yarn@{{version}}"] }],
+  "uninstall": [{ "command": "npm", "args": ["uninstall", "-g", "yarn"] }]
+}

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

@@ -0,0 +1,10 @@
+{
+  "moduleId": "agents",
+  "summary": "Subagent profiles describe the delegable team members: tool domains, execution budget and model binding. The catalog merges curated asset defaults with user-defined profiles stored in data/agents/profiles/.",
+  "facts": [
+    "Curated default profiles live in the read-only asset src/assets/agents/profiles.json and are never modified on disk.",
+    "User-defined profiles are stored as one JSON file per id under ~/.agent-devkit/data/agents/profiles/.",
+    "A custom profile with the same id as a default overrides it in the merged catalog; removing the override reverts to the default.",
+    "The multi-agent coordinator reads the merged catalog, so user-defined profiles are delegable immediately."
+  ]
+}

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

@@ -0,0 +1,16 @@
+{
+  "moduleId": "agents",
+  "mode": "team-profile-management",
+  "allowedActions": [
+    "List the merged subagent profile catalog with defaults and user overrides.",
+    "Create a user-defined subagent profile on explicit request.",
+    "Update a profile's budget, tool domains, model binding or character on explicit request.",
+    "Remove a user-defined profile or override on explicit request."
+  ],
+  "forbiddenActions": [
+    "Modify the curated default profiles asset on disk.",
+    "Create or change a profile without an explicit user request.",
+    "Grant a profile tool domains the user did not ask for."
+  ],
+  "approvalRequired": true
+}

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

@@ -0,0 +1,10 @@
+{
+  "moduleId": "agents",
+  "templates": [
+    {
+      "id": "agents.profiles",
+      "template": "Summarize this Agent DevKit subagent profile operation for the user, highlighting tool domains and budget changes: {{operation}}",
+      "variables": ["operation"]
+    }
+  ]
+}

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

@@ -0,0 +1,14 @@
+{
+  "moduleId": "agents",
+  "purpose": "Manage the subagent team profiles: list the merged catalog and create, update or remove user-defined profiles.",
+  "whenToUse": [
+    "The user wants to see which subagent profiles the coordinator can delegate to.",
+    "The user wants a new specialist profile with specific tool domains or budget.",
+    "The user wants to change or remove a profile they created, or override a default."
+  ],
+  "whenNotToUse": [
+    "The user wants to run a task or delegate work right now.",
+    "The user wants to change the companion character or personalization.",
+    "The user wants to manage brain providers or model preferences."
+  ]
+}

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

@@ -1,9 +1,14 @@
 {
   "moduleId": "environment",
-  "summary": "Environment dependencies are managed through registered providers. The capability exposes lifecycle actions but must not execute arbitrary commands.",
+  "summary": "Environment capabilities inspect the local development machine, scan supported tooling, manage tooling lifecycle plans, process variables, files and approved shell execution.",
   "facts": [
-    "The initial dependency provider is node and it is read-only.",
-    "Dependency lifecycle actions are check, plan, configure, install, upgrade, downgrade, uninstall, and verify.",
-    "Future providers such as aws-cli, docker, gh-cli, and ollama should implement the same provider contract."
+    "Tools inspection can locate installed binaries and common version strings.",
+    "Environment scan runs a structured read-only inventory of languages, SDKs, CLIs, frameworks, services and workspace tooling from the canonical tooling catalog.",
+    "Environment tooling uses JSON definitions from assets/tooling plus local data/tooling entries to detect, doctor, install, upgrade, downgrade and uninstall supported tools.",
+    "Tooling lifecycle actions must plan before mutating the local environment.",
+    "Learned tooling starts as a draft and must be promoted before it should be used for trusted lifecycle execution.",
+    "Environment variable reads redact sensitive values unless explicitly requested.",
+    "Filesystem reads and navigation are read-only; mkdir, write, append, patch and delete require approval through the capability runtime.",
+    "Shell execution is arbitrary local terminal control and always requires explicit approval."
   ]
 }

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

@@ -2,14 +2,22 @@
   "moduleId": "environment",
   "mode": "plan-before-mutating",
   "allowedActions": [
-    "List registered dependency providers.",
-    "Check dependency environment, installation, compatibility, and verification status.",
-    "Generate plans before install, configure, upgrade, downgrade, or uninstall operations."
+    "Run read-only environment scans for installed languages, SDKs, CLIs, frameworks, services and workspace tooling.",
+    "List, show, detect, doctor and inspect versions for canonical tooling definitions.",
+    "Plan tooling install, upgrade, downgrade and uninstall operations before executing them.",
+    "Execute tooling lifecycle operations only after approval.",
+    "Inspect installed terminal tools and versions.",
+    "Read process environment variables with sensitive redaction by default.",
+    "Navigate, list and read local files.",
+    "Create, edit, patch or delete local files only after approval.",
+    "Execute local shell commands only after approval."
   ],
   "forbiddenActions": [
-    "Execute arbitrary shell commands.",
-    "Install unregistered dependencies.",
-    "Persist raw credentials or dependency configuration secrets in logs."
+    "Execute arbitrary shell commands without approval.",
+    "Create, edit, patch or delete files without approval.",
+    "Install unregistered tooling outside the canonical tooling lifecycle.",
+    "Execute learned tooling lifecycle commands before they are validated and explicitly approved.",
+    "Persist raw credentials or tooling configuration secrets in logs."
   ],
   "approvalRequired": true
 }

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

@@ -2,8 +2,23 @@
   "moduleId": "environment",
   "templates": [
     {
-      "id": "environment.dependencies",
-      "template": "Explain this dependency lifecycle result and highlight required approval or unsupported operations: {{result}}",
+      "id": "environment.files",
+      "template": "Use filesystem results to answer with exact paths and mention whether a write, patch or delete changed state: {{result}}",
+      "variables": ["result"]
+    },
+    {
+      "id": "environment.scan",
+      "template": "Summarize the environment scan by host, installed tools, missing tools, workspace matches, health findings and recommended next actions. Do not claim credentials are configured unless the scan explicitly says so: {{result}}",
+      "variables": ["result"]
+    },
+    {
+      "id": "environment.shell",
+      "template": "Summarize shell execution result with exit code, stdout, stderr and timeout status. Never hide failures: {{result}}",
+      "variables": ["result"]
+    },
+    {
+      "id": "environment.tooling",
+      "template": "Explain this tooling result. For plans, show exact commands and approval requirements. For executions, show succeeded/failed/skipped steps and the next safe action: {{result}}",
       "variables": ["result"]
     }
   ]

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

@@ -1,13 +1,19 @@
 {
   "moduleId": "environment",
-  "purpose": "Inspect and plan lifecycle operations for external dependencies known by Agent DevKit.",
+  "purpose": "Inspect the local development environment and manage supported tooling through a safe catalog-driven lifecycle.",
   "whenToUse": [
-    "The user asks whether a required external dependency is installed or compatible.",
-    "The user wants to plan installation, configuration, upgrade, downgrade, or uninstall steps for a known dependency.",
-    "The agent needs to verify runtime prerequisites before using a module."
+    "The user asks for a system scan, environment diagnosis, machine raio X, installed languages, CLIs, frameworks, Docker, Flutter, Dart, cloud tools or development tools.",
+    "The user asks whether a required external tool, CLI, SDK, runtime or framework is installed or compatible.",
+    "The user asks to install, update, upgrade, downgrade, uninstall or doctor a supported CLI, SDK, runtime, service or framework.",
+    "The user wants to plan installation, configuration, upgrade, downgrade, or uninstall steps for known tooling.",
+    "The agent needs to verify runtime prerequisites before using a module.",
+    "The user asks what tools, versions or environment variables are available.",
+    "The user asks the agent to inspect, create, edit or patch files.",
+    "The user asks the agent to run a terminal command."
   ],
   "whenNotToUse": [
-    "The user wants to run arbitrary shell commands.",
-    "The dependency is not registered as an Agent DevKit dependency provider."
+    "The task requires credentials that are not already configured or explicitly provided.",
+    "A destructive file or shell action has not been approved.",
+    "The lifecycle request targets untrusted discovered tooling that has not been promoted or approved."
   ]
 }

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

@@ -0,0 +1,10 @@
+{
+  "moduleId": "schedules",
+  "summary": "Schedules describe proactive work: a title, the task prompt to run and a cadence (interval in minutes, daily HH:MM or a one-shot timestamp). The agent daemon polls the agenda and dispatches due schedules as task runs.",
+  "facts": [
+    "Schedules are stored as one JSON file per id under ~/.agent-devkit/data/schedules/.",
+    "The cadence kinds are interval (everyMinutes), daily (local HH:MM) and once (ISO timestamp, fires a single time).",
+    "The due action is a pure computation over lastRunAt and the cadence; disabled schedules are never due.",
+    "The daemon records lastRunAt and lastRunId after dispatching a schedule, which drives the next-run math."
+  ]
+}