agent-devkit 0.2.0 → 0.3.1

package/runtime/cli/aikit/mcp_manifest.py

@@ -70,6 +70,273 @@ TOOL_DEFINITIONS: list[dict[str, Any]] = [
             "additionalProperties": False,
         },
     },
+    {
+        "name": "agent_devkit_onboarding_status",
+        "description": "Return the no-argument Agent DevKit onboarding status used by `agent` startup.",
+        "inputSchema": {"type": "object", "properties": {}, "additionalProperties": False},
+    },
+    {
+        "name": "agent_devkit_memory_show",
+        "description": "Show local Agent DevKit memory usage and memory file paths without exposing secrets.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "agent_id": {"type": "string"},
+                "source_id": {"type": "string"},
+            },
+            "additionalProperties": False,
+        },
+    },
+    {
+        "name": "agent_devkit_memory_path",
+        "description": "Ensure local memory files exist and return their paths.",
+        "inputSchema": {"type": "object", "properties": {}, "additionalProperties": False},
+    },
+    {
+        "name": "agent_devkit_memory_reset",
+        "description": "Reset local Agent DevKit memory, sessions, tasks or cache. This is a local-only write.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "all": {"type": "boolean"},
+                "agent_id": {"type": "string"},
+                "source_id": {"type": "string"},
+                "sessions": {"type": "boolean"},
+                "tasks": {"type": "boolean"},
+                "cache": {"type": "boolean"},
+            },
+            "additionalProperties": False,
+        },
+    },
+    {
+        "name": "agent_devkit_memory_backup_create",
+        "description": "Create a local backup of Agent DevKit memory and personality. This does not upload remotely.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "title": {"type": "string"},
+                "encrypted": {"type": "boolean"},
+                "passphrase_env": {"type": "string"},
+            },
+            "additionalProperties": False,
+        },
+    },
+    {
+        "name": "agent_devkit_memory_backup_list",
+        "description": "List local Agent DevKit memory backups.",
+        "inputSchema": {"type": "object", "properties": {}, "additionalProperties": False},
+    },
+    {
+        "name": "agent_devkit_memory_backup_restore",
+        "description": "Restore a local Agent DevKit memory backup. Requires yes=true to execute.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "backup_id": {"type": "string"},
+                "file": {"type": "string"},
+                "passphrase_env": {"type": "string"},
+                "yes": {"type": "boolean"},
+            },
+            "additionalProperties": False,
+        },
+    },
+    {
+        "name": "agent_devkit_memory_backup_delete",
+        "description": "Delete a local Agent DevKit memory backup. Requires yes=true to execute.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "backup_id": {"type": "string"},
+                "yes": {"type": "boolean"},
+            },
+            "required": ["backup_id"],
+            "additionalProperties": False,
+        },
+    },
+    {
+        "name": "agent_devkit_shared_memory_list",
+        "description": "List owner-reviewed shared memories stored in the local Agent DevKit home.",
+        "inputSchema": {"type": "object", "properties": {}, "additionalProperties": False},
+    },
+    {
+        "name": "agent_devkit_shared_memory_status",
+        "description": "Inspect one owner-reviewed shared memory workspace.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {"memory_id": {"type": "string"}},
+            "required": ["memory_id"],
+            "additionalProperties": False,
+        },
+    },
+    {
+        "name": "agent_devkit_shared_memory_create",
+        "description": "Create a local shared memory workspace and contributor key. This is a local-only write.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {"title": {"type": "string"}},
+            "additionalProperties": False,
+        },
+    },
+    {
+        "name": "agent_devkit_shared_memory_read",
+        "description": "Read accepted shared memory entries without exposing owner keys.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "memory_id": {"type": "string"},
+                "entry_id": {"type": "string"},
+                "key": {"type": "string"},
+            },
+            "required": ["memory_id"],
+            "additionalProperties": False,
+        },
+    },
+    {
+        "name": "agent_devkit_shared_memory_submit",
+        "description": "Submit a contribution to shared memory pending owner review. This is a local-only write.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "memory_id": {"type": "string"},
+                "title": {"type": "string"},
+                "content": {"type": "string"},
+                "key": {"type": "string"},
+            },
+            "required": ["memory_id", "content", "key"],
+            "additionalProperties": False,
+        },
+    },
+    {
+        "name": "agent_devkit_shared_memory_review",
+        "description": "Review a pending shared memory contribution without publishing it.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "memory_id": {"type": "string"},
+                "submission_id": {"type": "string"},
+            },
+            "required": ["memory_id", "submission_id"],
+            "additionalProperties": False,
+        },
+    },
+    {
+        "name": "agent_devkit_shared_memory_publish",
+        "description": "Publish an approved shared memory contribution. This is a local-only write.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "memory_id": {"type": "string"},
+                "submission_id": {"type": "string"},
+                "yes": {"type": "boolean"},
+                "owner_key": {"type": "string"},
+            },
+            "required": ["memory_id", "submission_id"],
+            "additionalProperties": False,
+        },
+    },
+    {
+        "name": "agent_devkit_personality_show",
+        "description": "Show the local Agent DevKit personality and public identity.",
+        "inputSchema": {"type": "object", "properties": {}, "additionalProperties": False},
+    },
+    {
+        "name": "agent_devkit_personality_update",
+        "description": "Update local Agent DevKit personality fields. This is a local-only write.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "agent_name": {"type": "string"},
+                "user_name": {"type": "string"},
+                "language": {"type": "string"},
+                "tone": {"type": "string"},
+                "detail_level": {"type": "string"},
+            },
+            "additionalProperties": False,
+        },
+    },
+    {
+        "name": "agent_devkit_personality_reset",
+        "description": "Reset local Agent DevKit personality to defaults. This is a local-only write.",
+        "inputSchema": {"type": "object", "properties": {}, "additionalProperties": False},
+    },
+    {
+        "name": "agent_devkit_task_list",
+        "description": "List local scheduled tasks without running them.",
+        "inputSchema": {"type": "object", "properties": {}, "additionalProperties": False},
+    },
+    {
+        "name": "agent_devkit_task_show",
+        "description": "Show one local scheduled task.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {"task_id": {"type": "string"}},
+            "required": ["task_id"],
+            "additionalProperties": False,
+        },
+    },
+    {
+        "name": "agent_devkit_task_run_dry_run",
+        "description": "Preview one local scheduled task run without executing it.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {"task_id": {"type": "string"}},
+            "required": ["task_id"],
+            "additionalProperties": False,
+        },
+    },
+    {
+        "name": "agent_devkit_scheduler_run_once_dry_run",
+        "description": "Preview due local scheduled tasks without executing them.",
+        "inputSchema": {"type": "object", "properties": {}, "additionalProperties": False},
+    },
+    {
+        "name": "agent_devkit_notifications_doctor",
+        "description": "Diagnose local notification support without sending notifications.",
+        "inputSchema": {"type": "object", "properties": {}, "additionalProperties": False},
+    },
+    {
+        "name": "agent_devkit_notifications_list_events",
+        "description": "List supported local notification events.",
+        "inputSchema": {"type": "object", "properties": {}, "additionalProperties": False},
+    },
+    {
+        "name": "agent_devkit_notifications_list_channels",
+        "description": "List supported and future notification channels.",
+        "inputSchema": {"type": "object", "properties": {}, "additionalProperties": False},
+    },
+    {
+        "name": "agent_devkit_notifications_format",
+        "description": "Format a notification payload without sending it.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "title": {"type": "string"},
+                "message": {"type": "string"},
+                "summary": {"type": "string"},
+                "event": {"type": "string"},
+                "status": {"type": "string"},
+                "severity": {"type": "string"},
+                "task_id": {"type": "string"},
+                "origin": {"type": "string"},
+            },
+            "additionalProperties": False,
+        },
+    },
+    {
+        "name": "agent_devkit_catalog_list",
+        "description": "List deterministic Agent DevKit catalog items with optional filters.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "type": {"type": "string"},
+                "provider": {"type": "string"},
+                "status": {"type": "string"},
+                "write_policy": {"type": "string"},
+                "readiness": {"type": "string"},
+            },
+            "additionalProperties": False,
+        },
+    },
     {
         "name": "agent_devkit_catalog_search",
         "description": "Search agents, capabilities and providers in the deterministic Agent DevKit catalog.",
@@ -83,6 +350,19 @@ TOOL_DEFINITIONS: list[dict[str, Any]] = [
             "additionalProperties": False,
         },
     },
+    {
+        "name": "agent_devkit_catalog_show",
+        "description": "Show one deterministic Agent DevKit catalog item.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "id": {"type": "string"},
+                "type": {"type": "string"},
+            },
+            "required": ["id"],
+            "additionalProperties": False,
+        },
+    },
     {
         "name": "agent_devkit_route_explain",
         "description": "Explain how Agent DevKit would route a prompt without executing it.",
@@ -103,6 +383,16 @@ TOOL_DEFINITIONS: list[dict[str, Any]] = [
             "additionalProperties": False,
         },
     },
+    {
+        "name": "agent_devkit_agentic_plan",
+        "description": "Build the explicit v0.2.1 agentic plan contract for a natural-language prompt.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {"prompt": {"type": "string"}},
+            "required": ["prompt"],
+            "additionalProperties": False,
+        },
+    },
     {
         "name": "agent_devkit_eval_list",
         "description": "List deterministic Agent DevKit eval suites.",
@@ -123,6 +413,514 @@ TOOL_DEFINITIONS: list[dict[str, Any]] = [
         "description": "Diagnose secret reference backends without exposing values.",
         "inputSchema": {"type": "object", "properties": {}, "additionalProperties": False},
     },
+    {
+        "name": "agent_devkit_workflow_list",
+        "description": "List installable Agent DevKit workflows.",
+        "inputSchema": {"type": "object", "properties": {}, "additionalProperties": False},
+    },
+    {
+        "name": "agent_devkit_workflow_show",
+        "description": "Show one installable Agent DevKit workflow.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {"workflow_id": {"type": "string"}},
+            "required": ["workflow_id"],
+            "additionalProperties": False,
+        },
+    },
+    {
+        "name": "agent_devkit_workflow_run_dry_run",
+        "description": "Build a dry-run payload for an installable workflow.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {"workflow_id": {"type": "string"}},
+            "required": ["workflow_id"],
+            "additionalProperties": False,
+        },
+    },
+    {
+        "name": "agent_devkit_local_llm_list",
+        "description": "List local LLM operational workers.",
+        "inputSchema": {"type": "object", "properties": {}, "additionalProperties": False},
+    },
+    {
+        "name": "agent_devkit_local_llm_doctor",
+        "description": "Diagnose local LLM/Ollama readiness without installing models.",
+        "inputSchema": {"type": "object", "properties": {}, "additionalProperties": False},
+    },
+    {
+        "name": "agent_devkit_local_llm_models",
+        "description": "List local LLM models known to Ollama when available.",
+        "inputSchema": {"type": "object", "properties": {}, "additionalProperties": False},
+    },
+    {
+        "name": "agent_devkit_local_artifacts_list",
+        "description": "List local skills, scripts, automations and local agents stored in Agent DevKit home.",
+        "inputSchema": {"type": "object", "properties": {}, "additionalProperties": False},
+    },
+    {
+        "name": "agent_devkit_local_skill_create",
+        "description": "Create a local Agent DevKit skill artifact.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "id": {"type": "string"},
+                "description": {"type": "string"},
+                "force": {"type": "boolean"},
+            },
+            "additionalProperties": False,
+        },
+    },
+    {
+        "name": "agent_devkit_local_skill_list",
+        "description": "List local Agent DevKit skill artifacts.",
+        "inputSchema": {"type": "object", "properties": {}, "additionalProperties": False},
+    },
+    {
+        "name": "agent_devkit_local_skill_show",
+        "description": "Show one local Agent DevKit skill artifact.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {"id": {"type": "string"}},
+            "required": ["id"],
+            "additionalProperties": False,
+        },
+    },
+    {
+        "name": "agent_devkit_local_script_create",
+        "description": "Create a local Agent DevKit shell script artifact.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "id": {"type": "string"},
+                "command": {"type": "string"},
+                "force": {"type": "boolean"},
+            },
+            "additionalProperties": False,
+        },
+    },
+    {
+        "name": "agent_devkit_local_script_list",
+        "description": "List local Agent DevKit shell script artifacts.",
+        "inputSchema": {"type": "object", "properties": {}, "additionalProperties": False},
+    },
+    {
+        "name": "agent_devkit_local_script_run_dry_run",
+        "description": "Plan execution of one local Agent DevKit script without running it.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {"id": {"type": "string"}},
+            "required": ["id"],
+            "additionalProperties": False,
+        },
+    },
+    {
+        "name": "agent_devkit_local_agent_create",
+        "description": "Create a local Agent DevKit specialist agent scaffold.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "id": {"type": "string"},
+                "description": {"type": "string"},
+                "force": {"type": "boolean"},
+            },
+            "additionalProperties": False,
+        },
+    },
+    {
+        "name": "agent_devkit_local_agent_list",
+        "description": "List local Agent DevKit specialist agent scaffolds.",
+        "inputSchema": {"type": "object", "properties": {}, "additionalProperties": False},
+    },
+    {
+        "name": "agent_devkit_local_agent_show",
+        "description": "Show one local Agent DevKit specialist agent scaffold.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {"id": {"type": "string"}},
+            "required": ["id"],
+            "additionalProperties": False,
+        },
+    },
+    {
+        "name": "agent_devkit_local_agent_validate",
+        "description": "Validate one local Agent DevKit specialist agent scaffold.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {"id": {"type": "string"}},
+            "required": ["id"],
+            "additionalProperties": False,
+        },
+    },
+    {
+        "name": "agent_devkit_local_automation_create",
+        "description": "Create a local Agent DevKit automation artifact in the user home.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "id": {"type": "string"},
+                "title": {"type": "string"},
+                "prompt": {"type": "string"},
+                "command": {"type": "string"},
+                "every": {"type": "string"},
+                "cron": {"type": "string"},
+                "force": {"type": "boolean"},
+            },
+            "additionalProperties": False,
+        },
+    },
+    {
+        "name": "agent_devkit_local_automation_list",
+        "description": "List local Agent DevKit automation artifacts.",
+        "inputSchema": {"type": "object", "properties": {}, "additionalProperties": False},
+    },
+    {
+        "name": "agent_devkit_local_automation_show",
+        "description": "Show one local Agent DevKit automation artifact.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {"id": {"type": "string"}},
+            "required": ["id"],
+            "additionalProperties": False,
+        },
+    },
+    {
+        "name": "agent_devkit_local_automation_enable",
+        "description": "Enable one local Agent DevKit automation artifact.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {"id": {"type": "string"}},
+            "required": ["id"],
+            "additionalProperties": False,
+        },
+    },
+    {
+        "name": "agent_devkit_local_automation_disable",
+        "description": "Disable one local Agent DevKit automation artifact.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {"id": {"type": "string"}},
+            "required": ["id"],
+            "additionalProperties": False,
+        },
+    },
+    {
+        "name": "agent_devkit_local_automation_validate",
+        "description": "Validate one local Agent DevKit automation artifact.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {"id": {"type": "string"}},
+            "required": ["id"],
+            "additionalProperties": False,
+        },
+    },
+    {
+        "name": "agent_devkit_team_status",
+        "description": "Inspect project-local team profile status without exposing secrets.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {"project": {"type": "string"}},
+            "additionalProperties": False,
+        },
+    },
+    {
+        "name": "agent_devkit_team_doctor",
+        "description": "Run project-local team profile diagnostics without exposing secrets.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {"project": {"type": "string"}},
+            "additionalProperties": False,
+        },
+    },
+    {
+        "name": "agent_devkit_team_init",
+        "description": "Create a project-local team profile file without storing secrets.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "project": {"type": "string"},
+                "force": {"type": "boolean"},
+            },
+            "additionalProperties": False,
+        },
+    },
+    {
+        "name": "agent_devkit_team_onboard",
+        "description": "Return the project-local team onboarding checklist.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {"project": {"type": "string"}},
+            "additionalProperties": False,
+        },
+    },
+    {
+        "name": "agent_devkit_team_profile_list",
+        "description": "List profiles in the project-local team profile file.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {"project": {"type": "string"}},
+            "additionalProperties": False,
+        },
+    },
+    {
+        "name": "agent_devkit_team_profile_show",
+        "description": "Show one project-local team profile without exposing secrets.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "project": {"type": "string"},
+                "profile_id": {"type": "string"},
+            },
+            "additionalProperties": False,
+        },
+    },
+    {
+        "name": "agent_devkit_team_profile_export",
+        "description": "Export one project-local team profile, or return a write plan when path is omitted.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "project": {"type": "string"},
+                "profile_id": {"type": "string"},
+                "path": {"type": "string"},
+            },
+            "additionalProperties": False,
+        },
+    },
+    {
+        "name": "agent_devkit_team_profile_import",
+        "description": "Import a secret-free team profile into a project-local team profile file.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "project": {"type": "string"},
+                "path": {"type": "string"},
+            },
+            "required": ["path"],
+            "additionalProperties": False,
+        },
+    },
+    {
+        "name": "agent_devkit_knowledge_doctor",
+        "description": "Run file-first knowledge base diagnostics for the current project.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {"project": {"type": "string"}},
+            "additionalProperties": False,
+        },
+    },
+    {
+        "name": "agent_devkit_knowledge_init",
+        "description": "Initialize a file-first shared knowledge base in a project.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "project": {"type": "string"},
+                "force": {"type": "boolean"},
+            },
+            "additionalProperties": False,
+        },
+    },
+    {
+        "name": "agent_devkit_knowledge_index",
+        "description": "Rebuild the local lexical index for a file-first knowledge base.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {"project": {"type": "string"}},
+            "additionalProperties": False,
+        },
+    },
+    {
+        "name": "agent_devkit_knowledge_search",
+        "description": "Search the local file-first knowledge base lexical index.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "project": {"type": "string"},
+                "query": {"type": "string"},
+            },
+            "required": ["query"],
+            "additionalProperties": False,
+        },
+    },
+    {
+        "name": "agent_devkit_knowledge_curate",
+        "description": "Run local curation checks over a file-first knowledge base.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {"project": {"type": "string"}},
+            "additionalProperties": False,
+        },
+    },
+    {
+        "name": "agent_devkit_knowledge_sync",
+        "description": "Return the current local-only knowledge sync status.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {"project": {"type": "string"}},
+            "additionalProperties": False,
+        },
+    },
+    {
+        "name": "agent_devkit_knowledge_snapshot_create",
+        "description": "Create a sanitized pending knowledge snapshot in a file-first knowledge base.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "project": {"type": "string"},
+                "title": {"type": "string"},
+                "content": {"type": "string"},
+                "from_file": {"type": "string"},
+                "type": {"type": "string"},
+            },
+            "required": ["title"],
+            "additionalProperties": False,
+        },
+    },
+    {
+        "name": "agent_devkit_knowledge_snapshot_list",
+        "description": "List pending, accepted and rejected knowledge snapshots.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {"project": {"type": "string"}},
+            "additionalProperties": False,
+        },
+    },
+    {
+        "name": "agent_devkit_knowledge_snapshot_show",
+        "description": "Show one knowledge snapshot content and metadata.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "project": {"type": "string"},
+                "snapshot_id": {"type": "string"},
+            },
+            "required": ["snapshot_id"],
+            "additionalProperties": False,
+        },
+    },
+    {
+        "name": "agent_devkit_knowledge_snapshot_score",
+        "description": "Score a pending knowledge snapshot for usefulness, safety and duplication.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "project": {"type": "string"},
+                "snapshot_id": {"type": "string"},
+            },
+            "required": ["snapshot_id"],
+            "additionalProperties": False,
+        },
+    },
+    {
+        "name": "agent_devkit_knowledge_snapshot_submit",
+        "description": "Submit a knowledge snapshot for owner review when it passes local score gates.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "project": {"type": "string"},
+                "snapshot_id": {"type": "string"},
+            },
+            "required": ["snapshot_id"],
+            "additionalProperties": False,
+        },
+    },
+    {
+        "name": "agent_devkit_knowledge_review_list",
+        "description": "List knowledge snapshot reviews.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {"project": {"type": "string"}},
+            "additionalProperties": False,
+        },
+    },
+    {
+        "name": "agent_devkit_knowledge_review",
+        "description": "Review one pending knowledge snapshot without publishing it.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "project": {"type": "string"},
+                "snapshot_id": {"type": "string"},
+            },
+            "required": ["snapshot_id"],
+            "additionalProperties": False,
+        },
+    },
+    {
+        "name": "agent_devkit_knowledge_publish",
+        "description": "Publish an approved knowledge snapshot. Requires yes=true and the configured owner agent.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "project": {"type": "string"},
+                "snapshot_id": {"type": "string"},
+                "yes": {"type": "boolean"},
+                "owner_agent": {"type": "string"},
+            },
+            "required": ["snapshot_id"],
+            "additionalProperties": False,
+        },
+    },
+    {
+        "name": "agent_devkit_knowledge_base_create",
+        "description": "Create a file-first knowledge base in a project directory with a canonical knowledge provider.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "project": {"type": "string"},
+                "provider": {"type": "string"},
+                "force": {"type": "boolean"},
+            },
+            "additionalProperties": False,
+        },
+    },
+    {
+        "name": "agent_devkit_knowledge_base_join",
+        "description": "Create local config for joining an existing knowledge base id without remote sync.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "project": {"type": "string"},
+                "kb_id": {"type": "string"},
+                "provider": {"type": "string"},
+                "force": {"type": "boolean"},
+            },
+            "required": ["kb_id"],
+            "additionalProperties": False,
+        },
+    },
+    {
+        "name": "agent_devkit_knowledge_base_status",
+        "description": "Inspect file-first knowledge base status for a project directory.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {"project": {"type": "string"}},
+            "additionalProperties": False,
+        },
+    },
+    {
+        "name": "agent_devkit_knowledge_base_tokens",
+        "description": "List knowledge base token references without returning token values.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {"project": {"type": "string"}},
+            "additionalProperties": False,
+        },
+    },
+    {
+        "name": "agent_devkit_knowledge_base_rotate_token",
+        "description": "Rotate a knowledge base token reference fingerprint without exposing token values.",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "project": {"type": "string"},
+                "scope": {"type": "string"},
+            },
+            "required": ["scope"],
+            "additionalProperties": False,
+        },
+    },
     {
         "name": "agent_devkit_roadmap",
         "description": "Return the deterministic Agent DevKit roadmap payload.",