thoth-agents 0.1.19 → 0.2.0

package/README.md

@@ -15,14 +15,16 @@
 
 thoth-agents is a delegate-first agent system for coding harnesses. It started
 as an OpenCode plugin and now provides a shared seven-agent workflow for
-OpenCode and Codex, with each harness getting the integration surface that fits
-it best.
+OpenCode, Codex, and Claude Code, with each harness getting the integration
+surface that fits it best.
 
 OpenCode remains the stable default path: native plugin install, native `task`
 delegation, optional tmux monitoring, and generated config. Codex is supported
 through an explicit agent-pack and Personal plugin setup path, with documented
 trust review and instruction-level governance caveats where Codex does not
-provide the same hard runtime controls.
+provide the same hard runtime controls. Claude Code is a first-class path: a
+single auto-discovered plugin package with native subagents, harness-enforced
+hooks, MCP, skills, and per-agent tool permissions.
 
 ## What It Is
 
@@ -52,6 +54,7 @@ provide the same hard runtime controls.
 | --- | --- | --- | --- |
 | OpenCode | Stable default | `npx thoth-agents@latest install` or `npx thoth-agents@latest install --agent=opencode` | Native plugin config, native `task` delegation, optional tmux panes, OpenCode provider auth. |
 | Codex | Supported explicit path | `npx thoth-agents@latest install --agent=codex` | Installs ambient/root guidance, six role subagents, and a Personal plugin source. Requires `/plugins` and `/hooks` trust review. Some governance remains instruction-level. |
+| Claude Code | Supported first-class path | `npx thoth-agents@latest install --agent=claude` | Installs one Claude Code plugin: six specialist subagents (`Task(subagent_type: ...)`), an `orchestrator` agent activated as the main thread via `settings.json`, `.mcp.json`, and bundled skills. Role permissions are enforced by subagent `tools`. |
 
 OpenCode can load the plugin with:
 
@@ -123,6 +126,35 @@ Codex install does not create a selectable orchestrator TOML, does not bypass
 trust review, and does not make role permissions or memory governance hard
 runtime guarantees unless Codex exposes those controls.
 
+### Claude Code
+
+Preview, then install the plugin package:
+
+```bash
+npx thoth-agents@latest install --agent=claude --dry-run
+npx thoth-agents@latest install --agent=claude
+```
+
+This writes a single Claude Code **skills-directory plugin** under
+`~/.claude/skills/thoth-agents`: `.claude-plugin/plugin.json`, seven
+auto-discovered agents in `agents/` (six specialists + an `orchestrator`), an
+`.mcp.json` server map, bundled `skills/`, and a plugin-root `settings.json`
+with `{ "agent": "orchestrator" }`. That `agent` key activates the orchestrator
+as the **main thread** — replacing the default system prompt — so the session
+starts in delegate-first mode and bootstraps thoth-mem on its first turn. It
+auto-loads as `thoth-agents@skills-dir` on the next session (no marketplace or
+install step); restart Claude Code or run `/reload-plugins` to activate it
+(confirm in `/plugin` → Installed). The orchestrator delegates to specialists
+with `Task(subagent_type: explorer|librarian|oracle|designer|quick|deep)`. Role
+permissions are enforced through each specialist's frontmatter `tools` allowlist.
+You can also emit the package without installing it:
+
+```bash
+npx thoth-agents@latest generate --harness=claude --dry-run
+```
+
+See [docs/claude-code-plugin-packaging.md](docs/claude-code-plugin-packaging.md).
+
 ### Reset Generated Config
 
 ```bash
@@ -323,12 +355,12 @@ planning/execution, verification, and archiving. It also registers MCP servers
 for docs research, public code search, and local memory where the harness
 supports that delivery surface.
 
-| Surface | Shared concept | OpenCode binding | Codex binding |
-| --- | --- | --- | --- |
-| Skills | Requirements, SDD, review, execution workflows | Copied into the OpenCode skills directory when `--skills=yes` | Packaged as plugin-bundled skills for the Personal plugin source |
-| MCPs | `exa`, `context7`, `grep_app`, `thoth_mem` | Registered by generated OpenCode plugin config | Packaged/configured only on validated Codex surfaces |
-| Delegation | Seven-role specialist workflow | Native `task` tool | Custom agents plus prompt/plugin guidance |
-| Blocking choices | Use a structured question surface | OpenCode `question` tool | `request_user_input` when enabled and available |
+| Surface | Shared concept | OpenCode binding | Codex binding | Claude Code binding |
+| --- | --- | --- | --- | --- |
+| Skills | Requirements, SDD, review, execution workflows | Copied into the OpenCode skills directory when `--skills=yes` | Packaged as plugin-bundled skills for the Personal plugin source | Bundled in the plugin `skills/` directory |
+| MCPs | `exa`, `context7`, `grep_app`, `thoth_mem` | Registered by generated OpenCode plugin config | Packaged/configured only on validated Codex surfaces | Bundled in the plugin `.mcp.json` (`type: "http"` for URL servers) |
+| Delegation | Seven-role specialist workflow | Native `task` tool | Custom agents plus prompt/plugin guidance | Native `Task(subagent_type: ...)` over auto-discovered subagents |
+| Blocking choices | Use a structured question surface | OpenCode `question` tool | `request_user_input` when enabled and available | `AskUserQuestion` tool |
 
 See [docs/skills-and-mcps.md](docs/skills-and-mcps.md) for the detailed matrix.
 

package/dist/agents/prompt-dialects.d.ts

@@ -22,7 +22,16 @@ export interface HarnessPromptDialect {
     renderRoleInvocation(role: AgentPromptRole): string;
 }
 export declare const CODEX_PROMPT_CAPABILITIES: HarnessCapabilities;
+export declare const CLAUDE_CODE_PROMPT_CAPABILITIES: HarnessCapabilities;
 export declare const OPENCODE_PROMPT_DIALECT: HarnessPromptDialect;
 export declare const CODEX_PROMPT_DIALECT: HarnessPromptDialect;
+/**
+ * Claude Code registers plugin subagents under the plugin name as a namespace,
+ * so the `subagent_type` for delegation is `thoth-agents:<role>`, not the bare
+ * role name. This must match the plugin manifest `name`.
+ */
+export declare const CLAUDE_CODE_SUBAGENT_NAMESPACE = "thoth-agents";
+export declare function claudeCodeSubagentType(role: AgentPromptRole): string;
+export declare const CLAUDE_CODE_PROMPT_DIALECT: HarnessPromptDialect;
 export declare function getPromptDialect(harness: HarnessId): HarnessPromptDialect;
 export declare function getPromptDialect(harness: string): HarnessPromptDialect;

package/dist/{chunk-2SGSRR6L.js → chunk-3NOVCFN7.js}

@@ -459,6 +459,11 @@ var CodexGenerationConfigSchema = z.object({
   outputRoot: z.string().optional(),
   dryRun: z.boolean().default(true)
 });
+var ClaudeCodeGenerationConfigSchema = z.object({
+  enabled: z.boolean().default(false),
+  outputRoot: z.string().optional(),
+  dryRun: z.boolean().default(true)
+});
 var FailoverConfigSchema = z.object({
   enabled: z.boolean().default(true),
   timeoutMs: z.number().min(0).default(15e3),
@@ -479,7 +484,8 @@ var PluginConfigSchema = z.object({
   fallback: FailoverConfigSchema.optional(),
   thoth: ThothConfigSchema.optional(),
   artifactStore: ArtifactStoreConfigSchema.optional(),
-  codex: CodexGenerationConfigSchema.optional()
+  codex: CodexGenerationConfigSchema.optional(),
+  claudeCode: ClaudeCodeGenerationConfigSchema.optional()
 });
 
 // src/config/loader.ts
@@ -653,6 +659,13 @@ function getAgentOverride(config, name) {
   const overrides = config?.agents ?? {};
   return overrides[name] ?? overrides[Object.keys(AGENT_ALIASES).find((k) => AGENT_ALIASES[k] === name) ?? ""];
 }
+function getPrimaryModelId(model) {
+  if (Array.isArray(model)) {
+    const first = model[0];
+    return typeof first === "string" ? first : first?.id;
+  }
+  return model;
+}
 
 // src/agents/prompt-dialects.ts
 var OPENCODE_CAPABILITIES = {
@@ -677,6 +690,17 @@ var CODEX_PROMPT_CAPABILITIES = {
   parentContextInjection: "instruction-only",
   memoryGovernanceEnforcement: "instruction-only"
 };
+var CLAUDE_CODE_PROMPT_CAPABILITIES = {
+  agentDefinitions: "supported",
+  delegatedExecution: "supported",
+  parallelDelegation: "supported",
+  runtimeHooks: "supported",
+  mcpConfiguration: "supported",
+  skillPackaging: "supported",
+  rolePermissions: "supported",
+  parentContextInjection: "supported",
+  memoryGovernanceEnforcement: "supported"
+};
 function supportedCapabilityProfile(capabilities) {
   return {
     capabilities,
@@ -748,6 +772,36 @@ var CODEX_PROMPT_DIALECT = {
     return role === "orchestrator" ? "orchestrator role agent" : `${role} subagent`;
   }
 };
+var CLAUDE_CODE_SUBAGENT_NAMESPACE = "thoth-agents";
+function claudeCodeSubagentType(role) {
+  return `${CLAUDE_CODE_SUBAGENT_NAMESPACE}:${role}`;
+}
+var CLAUDE_CODE_PROMPT_DIALECT = {
+  harness: "claude",
+  tools: {
+    delegationTool: "Task",
+    backgroundDelegationTool: "Task(run_in_background=true)",
+    backgroundStatusTool: "TaskOutput",
+    userQuestionTool: "AskUserQuestion",
+    progressTool: "TodoWrite",
+    hostStatusSurface: "TodoWrite",
+    roleReference: (role) => role === "orchestrator" ? "the main-thread orchestrator" : `Task(subagent_type: ${claudeCodeSubagentType(role)})`
+  },
+  capabilities: supportedCapabilityProfile(CLAUDE_CODE_PROMPT_CAPABILITIES),
+  dispatchLabel(method) {
+    switch (method) {
+      case "root-coordinator":
+        return "main-session coordinator";
+      case "task":
+        return "Task tool";
+      case "synchronous-task-only":
+        return "synchronous Task only";
+    }
+  },
+  renderRoleInvocation(role) {
+    return role === "orchestrator" ? "main-thread orchestrator" : claudeCodeSubagentType(role);
+  }
+};
 
 // src/harness/core/sdd.ts
 var SDD_PHASES = [
@@ -954,7 +1008,7 @@ function createStepBudgetSection(steps) {
   return { kind: "step-budget", steps };
 }
 function detectModelFamilyFromModel(model) {
-  const id = getPrimaryModelId(model)?.toLowerCase();
+  const id = getPrimaryModelId2(model)?.toLowerCase();
   if (!id) {
     return void 0;
   }
@@ -1358,7 +1412,7 @@ For non-SDD work: summary + files changed + verification results + edge cases co
 - Target: under 40 lines total.`
   });
 }
-function getPrimaryModelId(model) {
+function getPrimaryModelId2(model) {
   if (Array.isArray(model)) {
     const first = model[0];
     return typeof first === "string" ? first : first?.id;
@@ -2126,8 +2180,12 @@ export {
   loadPluginConfig,
   loadAgentPrompt,
   getAgentOverride,
+  getPrimaryModelId,
   OPENCODE_PROMPT_DIALECT,
   CODEX_PROMPT_DIALECT,
+  CLAUDE_CODE_SUBAGENT_NAMESPACE,
+  claudeCodeSubagentType,
+  CLAUDE_CODE_PROMPT_DIALECT,
   createStepBudgetSection,
   createModelFamilySection,
   createOrchestratorPromptSections,