thoth-agents 0.1.19 → 0.2.0

package/dist/config/utils.d.ts

@@ -8,3 +8,8 @@ import type { AgentOverrideConfig, PluginConfig } from './schema';
  * @returns The agent-specific override configuration if found
  */
 export declare function getAgentOverride(config: PluginConfig | undefined, name: string): AgentOverrideConfig | undefined;
+/**
+ * Resolve the primary model id from an agent override `model` value, which may
+ * be a single id, an object with an `id`, or a failover array of either.
+ */
+export declare function getPrimaryModelId(model: AgentOverrideConfig['model']): string | undefined;

package/dist/harness/adapters/claude-code.d.ts

@@ -0,0 +1,24 @@
+import { type PluginConfig } from '../../config';
+import type { HarnessAdapter, HarnessCapabilities, HarnessRenderContext } from '../types';
+export interface ClaudeCodeRenderContext extends HarnessRenderContext {
+    config?: PluginConfig;
+    packageRoot?: string;
+}
+export declare const CLAUDE_CODE_CAPABILITIES: HarnessCapabilities;
+export declare const CLAUDE_CODE_SUBAGENT_DEFAULT_MODELS: {
+    readonly explorer: "haiku";
+    readonly librarian: "sonnet";
+    readonly oracle: "opus";
+    readonly designer: "sonnet";
+    readonly quick: "haiku";
+    readonly deep: "sonnet";
+};
+/**
+ * The orchestrator system prompt body. This is the system prompt of the
+ * `orchestrator` plugin agent, which the plugin `settings.json` activates as the
+ * Claude Code main thread (`{"agent":"orchestrator"}`) — replacing the default
+ * system prompt entirely, which is far stronger than a SessionStart
+ * additionalContext injection.
+ */
+export declare function renderClaudeCodeRootInstructions(config?: PluginConfig): string;
+export declare const claudeCodeAdapter: HarnessAdapter;

package/dist/harness/core/package-version.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Locate the thoth-agents root package.json by walking up from each candidate
+ * directory. Shared by harness adapters that stamp the package version into
+ * generated plugin manifests.
+ */
+export declare function findRootPackageJsonPath(startDirs: readonly string[]): string;
+export declare function readPackageJsonVersion(packageJsonPath: string): string;

package/dist/harness/types.d.ts

@@ -1,4 +1,4 @@
-export type HarnessId = 'opencode' | 'codex';
+export type HarnessId = 'opencode' | 'codex' | 'claude';
 export type HarnessArtifactKind = 'agent-config' | 'harness-config' | 'mcp-config' | 'skill' | 'hook-config' | 'manifest' | 'documentation';
 export type HarnessDiagnosticSeverity = 'info' | 'warning' | 'error';
 export type HarnessDiagnosticCode = 'harness.unsupported' | 'harness.capability_gap' | 'harness.surface_unvalidated' | 'harness.artifact_skipped' | (string & {});

package/dist/harness/writers/claude-code-plugin-package.d.ts

@@ -0,0 +1,32 @@
+import type { HarnessArtifact, HarnessDiagnostic } from '../types';
+export declare const CLAUDE_PLUGIN_MANIFEST_FIELDS: readonly ["name", "version", "description", "author"];
+export interface ClaudeCodePluginAuthor {
+    name?: string;
+    email?: string;
+    url?: string;
+}
+export interface ClaudeCodePluginManifest {
+    name: string;
+    version: string;
+    description: string;
+    author?: ClaudeCodePluginAuthor | string;
+}
+export interface ClaudeCodePluginPackageInput {
+    manifest: ClaudeCodePluginManifest;
+    /**
+     * Already-rendered plugin component artifacts (subagents, `.mcp.json`,
+     * `hooks/`, skills). Auto-discovered by Claude Code, so the manifest does not
+     * reference them; the writer records their provenance.
+     */
+    componentArtifacts: HarnessArtifact[];
+}
+export interface ClaudeCodePluginPackageResult {
+    artifacts: HarnessArtifact[];
+    diagnostics: HarnessDiagnostic[];
+}
+/**
+ * Assemble the Claude Code plugin package: the deterministic `plugin.json`
+ * manifest, an asset-provenance manifest, and the passed-through component
+ * artifacts (sorted by path). First-class — no surface-validation gate.
+ */
+export declare function renderClaudeCodePluginPackage(input: ClaudeCodePluginPackageInput): ClaudeCodePluginPackageResult;

package/dist/harness/writers/claude-code-skill-layout.d.ts

@@ -0,0 +1,16 @@
+import type { SkillRegistryEntry } from '../core/skills';
+import type { HarnessArtifact, HarnessDiagnostic } from '../types';
+export interface ClaudeCodeSkillLayoutInput {
+    projectRoot: string;
+    packageRoot?: string;
+    skills: SkillRegistryEntry[];
+}
+export interface ClaudeCodeSkillLayoutResult {
+    artifacts: HarnessArtifact[];
+    diagnostics: HarnessDiagnostic[];
+}
+/**
+ * Copy the bundled skill registry into the Claude Code plugin `skills/` layout.
+ * First-class: no surface gate. Records source provenance with content hashes.
+ */
+export declare function renderClaudeCodeSkillLayout(input: ClaudeCodeSkillLayoutInput): ClaudeCodeSkillLayoutResult;

package/dist/harness/writers/claude-code-subagent.d.ts

@@ -0,0 +1,26 @@
+export type ClaudeCodeModel = 'sonnet' | 'opus' | 'haiku' | 'inherit';
+/** The model aliases Claude Code accepts in subagent frontmatter. */
+export declare const CLAUDE_CODE_MODELS: readonly ["sonnet", "opus", "haiku", "inherit"];
+export declare function isClaudeCodeModel(value: string): value is ClaudeCodeModel;
+export interface ClaudeCodeSubagentInput {
+    /** Subagent name; also the `subagent_type` used by the Task tool. */
+    name: string;
+    /** When the orchestrator should delegate to this subagent. */
+    description: string;
+    /**
+     * Comma-separated tool allowlist. This is the Claude Code mechanism that
+     * enforces role permissions (read-only vs write-capable). Omit to inherit all
+     * tools — used by the orchestrator main-thread agent, which must keep Task,
+     * AskUserQuestion, TodoWrite, MCP, and edit tools.
+     */
+    tools?: string;
+    /** Per-role model alias for the subagent frontmatter. */
+    model: ClaudeCodeModel;
+    /** Rendered system prompt body (role prompt + governance). */
+    instructions: string;
+}
+/**
+ * Render a Claude Code subagent file: deterministic YAML frontmatter plus the
+ * markdown system-prompt body. Auto-discovered from a plugin `agents/` directory.
+ */
+export declare function renderClaudeCodeSubagent(input: ClaudeCodeSubagentInput): string;

package/dist/harness/writers/fs-skill-collect.d.ts

@@ -0,0 +1,7 @@
+export declare function normalizeSkillPath(value: string): string;
+/**
+ * Recursively collect every file under a directory, sorted for deterministic
+ * output. Shared by harness skill-layout writers.
+ */
+export declare function collectSkillFiles(directory: string): string[];
+export declare function sha256Hash(content: string | Uint8Array): string;

package/dist/index.js

@@ -1,496 +1,24 @@
 import {
+  createAgents,
+  renderOpenCodeAgentConfigs,
   spawn,
   spawnSync
-} from "./chunk-DYGVRAMS.js";
+} from "./chunk-4WYCZ5Z7.js";
 import {
-  DEFAULT_MODELS,
   DEFAULT_THOTH_COMMAND,
-  OPENCODE_PROMPT_DIALECT,
   POLL_INTERVAL_BACKGROUND_MS,
-  SUBAGENT_NAMES,
-  appendPromptSections,
-  composeAgentPrompt,
   context7,
-  createOrchestratorPromptSections,
-  createReadOnlySpecialistPromptSections,
-  createWriteCapableSpecialistPromptSections,
-  detectModelFamily,
   exa,
-  getAgentOverride,
-  getModelFamilyPromptSection,
   getOpenCodeConfigPaths,
-  getStepBudgetPromptSection,
   grep_app,
   installCustomSkills,
-  loadAgentPrompt,
   loadPluginConfig,
-  renderRolePrompt,
   stripJsonComments
-} from "./chunk-2SGSRR6L.js";
+} from "./chunk-3NOVCFN7.js";
 
 // src/index.ts
 import path4 from "path";
 
-// src/agents/deep.ts
-var DEEP_PROMPT = renderRolePrompt(
-  createWriteCapableSpecialistPromptSections("deep"),
-  OPENCODE_PROMPT_DIALECT
-);
-function createDeepAgent(model, customPrompt, customAppendPrompt) {
-  const prompt = composeAgentPrompt({
-    basePrompt: DEEP_PROMPT,
-    customPrompt,
-    customAppendPrompt: appendPromptSections(
-      getModelFamilyPromptSection("deep", model),
-      customAppendPrompt
-    )
-  });
-  return {
-    name: "deep",
-    description: "Synchronous write-capable implementation agent optimized for thorough context analysis, edge cases, and correctness \u2014 not for bulk mechanical changes.",
-    config: {
-      model,
-      temperature: 0.1,
-      prompt,
-      color: "secondary"
-      // steps: 80,
-    }
-  };
-}
-
-// src/agents/designer.ts
-var DESIGNER_PROMPT = renderRolePrompt(
-  createWriteCapableSpecialistPromptSections("designer"),
-  OPENCODE_PROMPT_DIALECT
-);
-function createDesignerAgent(model, customPrompt, customAppendPrompt) {
-  const prompt = composeAgentPrompt({
-    basePrompt: DESIGNER_PROMPT,
-    customPrompt,
-    customAppendPrompt: appendPromptSections(
-      getModelFamilyPromptSection("designer", model),
-      customAppendPrompt
-    )
-  });
-  return {
-    name: "designer",
-    description: "Synchronous write-capable UI/UX implementation agent with ownership of approach, execution, and visual verification.",
-    config: {
-      model,
-      temperature: 0.4,
-      prompt,
-      color: "accent"
-      // steps: 50,
-    }
-  };
-}
-
-// src/agents/explorer.ts
-var EXPLORER_PROMPT = renderRolePrompt(
-  createReadOnlySpecialistPromptSections("explorer"),
-  OPENCODE_PROMPT_DIALECT
-);
-function createExplorerAgent(model, customPrompt, customAppendPrompt) {
-  const prompt = composeAgentPrompt({
-    basePrompt: EXPLORER_PROMPT,
-    customPrompt,
-    customAppendPrompt: appendPromptSections(
-      getModelFamilyPromptSection("explorer", model),
-      customAppendPrompt
-    )
-  });
-  return {
-    name: "explorer",
-    description: "Read-only local discovery agent for fast codebase search, references, and repository mapping.",
-    config: {
-      model,
-      temperature: 0.1,
-      prompt,
-      color: "info"
-    }
-  };
-}
-
-// src/agents/librarian.ts
-var LIBRARIAN_PROMPT = renderRolePrompt(
-  createReadOnlySpecialistPromptSections("librarian"),
-  OPENCODE_PROMPT_DIALECT
-);
-function createLibrarianAgent(model, customPrompt, customAppendPrompt) {
-  const prompt = composeAgentPrompt({
-    basePrompt: LIBRARIAN_PROMPT,
-    customPrompt,
-    customAppendPrompt: appendPromptSections(
-      getModelFamilyPromptSection("librarian", model),
-      customAppendPrompt
-    )
-  });
-  return {
-    name: "librarian",
-    description: "Read-only research agent for official docs, public examples, and externally sourced implementation guidance.",
-    config: {
-      model,
-      temperature: 0.1,
-      prompt,
-      color: "info"
-    }
-  };
-}
-
-// src/agents/oracle.ts
-var ORACLE_PROMPT = renderRolePrompt(
-  createReadOnlySpecialistPromptSections("oracle"),
-  OPENCODE_PROMPT_DIALECT
-);
-function createOracleAgent(model, customPrompt, customAppendPrompt) {
-  const prompt = composeAgentPrompt({
-    basePrompt: ORACLE_PROMPT,
-    customPrompt,
-    customAppendPrompt: appendPromptSections(
-      getModelFamilyPromptSection("oracle", model),
-      customAppendPrompt
-    )
-  });
-  return {
-    name: "oracle",
-    description: "Synchronous read-only strategic advisor for debugging, architecture, code review, and SDD plan review.",
-    config: {
-      model,
-      temperature: 0.1,
-      prompt,
-      color: "warning"
-    }
-  };
-}
-
-// src/agents/orchestrator.ts
-var OPENCODE_RUNTIME_SECTION = `<opencode-runtime>
-In the OpenCode harness, an automatic \`<reminder>...</reminder>\` workflow block followed by a \`\\n\\n---\\n\\n\` separator is prepended to your user messages as harness scaffolding, not user input.
-When saving the user prompt via mem_save(kind="prompt"), you MUST exclude that injected \`<reminder>\` block and the \`---\` separator, and persist only the real user request text that follows.
-</opencode-runtime>`;
-var ORCHESTRATOR_PROMPT = appendPromptSections(
-  renderRolePrompt(createOrchestratorPromptSections(), OPENCODE_PROMPT_DIALECT),
-  OPENCODE_RUNTIME_SECTION
-);
-function createOrchestratorAgent(model, customPrompt, customAppendPrompt) {
-  const prompt = composeAgentPrompt({
-    basePrompt: ORCHESTRATOR_PROMPT,
-    customPrompt,
-    customAppendPrompt: appendPromptSections(
-      getModelFamilyPromptSection("orchestrator", model),
-      customAppendPrompt
-    )
-  });
-  const definition = {
-    name: "orchestrator",
-    description: "Delegate-first coordinator for SDD workflow, specialist dispatch, and root-session memory ownership.",
-    config: {
-      temperature: 0.1,
-      prompt,
-      color: "primary"
-      // steps: 100,
-    }
-  };
-  if (Array.isArray(model)) {
-    definition._modelArray = model.map(
-      (entry) => typeof entry === "string" ? { id: entry } : entry
-    );
-  } else if (typeof model === "string" && model) {
-    definition.config.model = model;
-  }
-  return definition;
-}
-
-// src/agents/quick.ts
-var QUICK_PROMPT = renderRolePrompt(
-  createWriteCapableSpecialistPromptSections("quick"),
-  OPENCODE_PROMPT_DIALECT
-);
-function createQuickAgent(model, customPrompt, customAppendPrompt) {
-  const prompt = composeAgentPrompt({
-    basePrompt: QUICK_PROMPT,
-    customPrompt,
-    customAppendPrompt: appendPromptSections(
-      getModelFamilyPromptSection("quick", model),
-      customAppendPrompt
-    )
-  });
-  return {
-    name: "quick",
-    description: "Synchronous write-capable implementation agent optimized for fast, mechanical, well-bounded changes \u2014 including uniform patterns across multiple files.",
-    config: {
-      model,
-      temperature: 0.2,
-      prompt,
-      color: "success"
-      // steps: 30,
-    }
-  };
-}
-
-// src/agents/index.ts
-var GEMINI_DEFAULT_STEPS = {
-  explorer: 120,
-  librarian: 80,
-  oracle: 80,
-  designer: 80,
-  quick: 40,
-  deep: 120
-};
-var BUILTIN_PERMISSION_PRESETS = {
-  orchestrator: {
-    read: "allow",
-    edit: "allow",
-    write: "allow",
-    glob: "allow",
-    grep: "allow",
-    list: "allow",
-    bash: "allow",
-    codesearch: "allow",
-    lsp: "allow",
-    skill: "allow",
-    question: "allow",
-    webfetch: "allow",
-    exa: "allow",
-    todowrite: "allow",
-    task: "allow",
-    external_directory: "allow"
-  },
-  explorer: {
-    read: "allow",
-    glob: "allow",
-    grep: "allow",
-    list: "allow",
-    codesearch: "allow",
-    lsp: "allow",
-    external_directory: "allow",
-    bash: "allow",
-    question: "allow",
-    skill: "allow",
-    edit: "deny",
-    todowrite: "deny",
-    task: "deny"
-  },
-  librarian: {
-    read: "allow",
-    glob: "allow",
-    grep: "allow",
-    external_directory: "allow",
-    bash: "allow",
-    webfetch: "allow",
-    exa: "allow",
-    codesearch: "allow",
-    question: "allow",
-    skill: "allow",
-    edit: "deny",
-    todowrite: "deny",
-    task: "deny"
-  },
-  oracle: {
-    read: "allow",
-    glob: "allow",
-    grep: "allow",
-    list: "allow",
-    lsp: "allow",
-    codesearch: "allow",
-    webfetch: "allow",
-    exa: "allow",
-    external_directory: "allow",
-    bash: "allow",
-    question: "allow",
-    skill: "allow",
-    edit: "deny",
-    todowrite: "deny",
-    task: "deny"
-  },
-  designer: {
-    read: "allow",
-    edit: "allow",
-    glob: "allow",
-    grep: "allow",
-    list: "allow",
-    bash: "allow",
-    codesearch: "allow",
-    lsp: "allow",
-    skill: "allow",
-    question: "allow",
-    todowrite: "deny",
-    task: "deny",
-    external_directory: {
-      "~/.config/opencode/skills/**": "allow"
-    }
-  },
-  quick: {
-    read: "allow",
-    edit: "allow",
-    glob: "allow",
-    grep: "allow",
-    list: "allow",
-    bash: "allow",
-    question: "allow",
-    codesearch: "allow",
-    lsp: "allow",
-    skill: "allow",
-    todowrite: "deny",
-    task: "deny",
-    external_directory: {
-      "~/.config/opencode/skills/**": "allow"
-    }
-  },
-  deep: {
-    read: "allow",
-    edit: "allow",
-    glob: "allow",
-    grep: "allow",
-    list: "allow",
-    bash: "allow",
-    codesearch: "allow",
-    lsp: "allow",
-    skill: "allow",
-    question: "allow",
-    webfetch: "allow",
-    exa: "allow",
-    todowrite: "deny",
-    task: "deny",
-    external_directory: {
-      "~/.config/opencode/skills/**": "allow"
-    }
-  }
-};
-function normalizeModelArray(model) {
-  return model.map(
-    (entry) => typeof entry === "string" ? { id: entry } : entry
-  );
-}
-function applyOverrides(agent, override) {
-  if (override.model) {
-    if (Array.isArray(override.model)) {
-      agent._modelArray = normalizeModelArray(override.model);
-      agent.config.model = void 0;
-    } else {
-      agent.config.model = override.model;
-    }
-  }
-  if (override.variant) {
-    agent.config.variant = override.variant;
-  }
-  if (override.temperature !== void 0) {
-    agent.config.temperature = override.temperature;
-  }
-  if (override.steps !== void 0) {
-    agent.config.steps = override.steps;
-  }
-}
-function applyStepBudgetPrompt(agent) {
-  const stepBudgetPrompt = getStepBudgetPromptSection(agent.config.steps);
-  if (!stepBudgetPrompt) {
-    return;
-  }
-  agent.config.prompt = appendPromptSections(
-    agent.config.prompt,
-    stepBudgetPrompt
-  );
-}
-function applyGeminiDefaultSteps(agent) {
-  if (!isSubagent(agent.name) || agent.config.steps !== void 0) {
-    return;
-  }
-  if (detectModelFamily(agent._modelArray ?? agent.config.model) !== "gemini") {
-    return;
-  }
-  agent.config.steps = GEMINI_DEFAULT_STEPS[agent.name];
-}
-function clonePermissionConfig(permission) {
-  if (typeof permission === "string") {
-    return permission;
-  }
-  return Object.fromEntries(
-    Object.entries(permission).map(([key, value]) => [
-      key,
-      value && typeof value === "object" && !Array.isArray(value) ? { ...value } : value
-    ])
-  );
-}
-function getBuiltinPermissionPreset(name) {
-  return clonePermissionConfig(BUILTIN_PERMISSION_PRESETS[name]);
-}
-function getExplicitPermissionOverride(override) {
-  return override?.permission;
-}
-function getPrimaryModelForPrompt(model) {
-  if (Array.isArray(model)) {
-    const first = model[0];
-    return typeof first === "string" ? first : first?.id;
-  }
-  return model;
-}
-function isSubagent(name) {
-  return SUBAGENT_NAMES.includes(name);
-}
-var SUBAGENT_FACTORIES = {
-  explorer: createExplorerAgent,
-  librarian: createLibrarianAgent,
-  oracle: createOracleAgent,
-  designer: createDesignerAgent,
-  quick: createQuickAgent,
-  deep: createDeepAgent
-};
-function createAgents(config) {
-  const protoSubAgents = Object.entries(SUBAGENT_FACTORIES).map(([name, factory]) => {
-    const override = getAgentOverride(config, name);
-    const prompts = loadAgentPrompt(name, config?.preset);
-    const model = getPrimaryModelForPrompt(override?.model) ?? DEFAULT_MODELS[name];
-    return factory(model, prompts.prompt, prompts.appendPrompt);
-  });
-  const allSubAgents = protoSubAgents.map((agent) => {
-    const override = getAgentOverride(config, agent.name);
-    if (override) {
-      applyOverrides(agent, override);
-    }
-    applyGeminiDefaultSteps(agent);
-    applyStepBudgetPrompt(agent);
-    return agent;
-  });
-  const orchestratorOverride = getAgentOverride(config, "orchestrator");
-  const orchestratorPrompts = loadAgentPrompt("orchestrator", config?.preset);
-  const orchestrator = createOrchestratorAgent(
-    orchestratorOverride?.model ?? DEFAULT_MODELS.orchestrator,
-    orchestratorPrompts.prompt,
-    orchestratorPrompts.appendPrompt
-  );
-  if (orchestratorOverride) {
-    applyOverrides(orchestrator, orchestratorOverride);
-  }
-  applyStepBudgetPrompt(orchestrator);
-  return [orchestrator, ...allSubAgents];
-}
-function getAgentConfigs(config) {
-  const agents = createAgents(config);
-  return Object.fromEntries(
-    agents.map((agent) => {
-      const override = getAgentOverride(config, agent.name);
-      const sdkConfig = {
-        ...agent.config,
-        description: agent.description
-      };
-      const builtinPermission = isSubagent(agent.name) ? getBuiltinPermissionPreset(agent.name) : agent.name === "orchestrator" ? getBuiltinPermissionPreset("orchestrator") : void 0;
-      const explicitPermissionOverride = getExplicitPermissionOverride(override);
-      sdkConfig.permission = explicitPermissionOverride ?? agent.config.permission ?? builtinPermission;
-      if (isSubagent(agent.name)) {
-        sdkConfig.mode = "subagent";
-      } else if (agent.name === "orchestrator") {
-        sdkConfig.mode = "primary";
-      }
-      return [agent.name, sdkConfig];
-    })
-  );
-}
-
-// src/harness/adapters/opencode.ts
-function renderOpenCodeAgentConfigs(config) {
-  return getAgentConfigs(config);
-}
-
 // src/utils/logger.ts
 import { createRequire } from "module";
 var require2 = createRequire(import.meta.url);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "thoth-agents",
-  "version": "0.1.19",
+  "version": "0.2.0",
   "description": "Delegate-first OpenCode plugin with seven agents, thoth-mem persistence, and bundled SDD skills.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/thoth-agents.schema.json

@@ -466,6 +466,22 @@
           "type": "boolean"
         }
       }
+    },
+    "claudeCode": {
+      "type": "object",
+      "properties": {
+        "enabled": {
+          "default": false,
+          "type": "boolean"
+        },
+        "outputRoot": {
+          "type": "string"
+        },
+        "dryRun": {
+          "default": true,
+          "type": "boolean"
+        }
+      }
     }
   },
   "title": "thoth-agents",