thoth-agents 0.1.18 → 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/memory-governance.d.ts

@@ -1,11 +1,41 @@
 import type { HarnessPromptDialect } from '../../agents/prompt-dialects';
 import type { HarnessCapabilityStatus, HarnessDiagnostic } from '../types';
 import type { AgentRoleContract, AgentRoleName } from './agent-pack';
-export type MemoryToolName = 'mem_session_start' | 'mem_session_summary' | 'mem_save_prompt' | 'mem_search' | 'mem_timeline' | 'mem_get_observation' | 'mem_context' | 'mem_project_summary' | 'mem_project_graph' | 'mem_topic_keys' | 'mem_suggest_topic_key' | 'mem_save';
+export type MemoryToolName = 'mem_save' | 'mem_recall' | 'mem_context' | 'mem_get' | 'mem_project' | 'mem_session';
+export type MemSaveKind = 'observation' | 'prompt' | 'session_summary' | 'passive_learnings';
+export type MemSessionAction = 'start' | 'checkpoint' | 'summary';
+export type MemRecallMode = 'compact' | 'context';
+export type MemProjectAction = 'list' | 'summary' | 'graph' | 'topics' | 'topic';
+export type MemoryOperation = {
+    tool: 'mem_session';
+    action: MemSessionAction;
+} | {
+    tool: 'mem_save';
+    kind: MemSaveKind;
+} | {
+    tool: 'mem_recall';
+    mode: MemRecallMode;
+} | {
+    tool: 'mem_get';
+    includeTimeline?: boolean;
+} | {
+    tool: 'mem_context';
+    recallQuery?: boolean;
+} | {
+    tool: 'mem_project';
+    action: MemProjectAction;
+};
+export type RootOwnedMemoryOperation = {
+    tool: 'mem_session';
+    action: MemSessionAction;
+} | {
+    tool: 'mem_save';
+    kind: 'prompt' | 'session_summary';
+};
 export type MemoryRuntimeEnforcement = 'runtime' | 'instruction-only';
 export interface RoleMemoryGovernance {
     role: AgentRoleName;
-    rootOwnedTools: MemoryToolName[];
+    rootOwnedOperations: RootOwnedMemoryOperation[];
     allowedTools: MemoryToolName[];
     forbiddenTools: MemoryToolName[];
     requiresParentContext: boolean;
@@ -15,8 +45,8 @@ export interface RoleMemoryGovernance {
     rules: string[];
 }
 export interface MemoryGovernanceContract {
-    rootOwnedTools: MemoryToolName[];
-    readRecallChain: MemoryToolName[];
+    rootOwnedOperations: RootOwnedMemoryOperation[];
+    readRecallChain: MemoryOperation[];
     writeCapableDelegatedTools: MemoryToolName[];
     protectedTopicNamespaces: string[];
     roles: RoleMemoryGovernance[];
@@ -27,6 +57,11 @@ export interface MemoryGovernanceDiagnosticInput {
     parentContextInjection: HarnessCapabilityStatus;
     memoryWriteControls: HarnessCapabilityStatus;
 }
+export declare const ROOT_OWNED_OPERATIONS: RootOwnedMemoryOperation[];
+export declare const READ_RECALL_CHAIN: MemoryOperation[];
+export declare const PARENT_SCOPED_READ_TOOLS: MemoryToolName[];
+export declare const WRITE_CAPABLE_DELEGATED_TOOLS: MemoryToolName[];
+export declare const ALL_MEMORY_TOOLS: MemoryToolName[];
 export declare function getRoleMemoryGovernance(role: AgentRoleContract): RoleMemoryGovernance;
 export declare function getMemoryGovernanceContract(roles: readonly AgentRoleContract[]): MemoryGovernanceContract;
 export declare function renderMemoryGovernanceInstructions(role: AgentRoleContract, dialect?: HarnessPromptDialect): string;

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/hooks/phase-reminder/index.d.ts

@@ -1,4 +1,6 @@
 export declare const PHASE_REMINDER = "<reminder>Recall Workflow Rules:\nUnderstand \u2192 split discovery into surgical probes with explorer/librarian \u2192 synthesize the decision and internal handoff \u2192 execute \u2192 verify.\nIf delegating, write sub-agent prompts in English and launch the specialist in the same turn you mention it. If multiple delegations are independent, emit all tool calls in a single response.\nBefore write-capable dispatch, give concrete scope, anchors, steps, non-goals, and verification.\nIn SDD, after oracle returns [OKAY], give a deep approved-plan overview, then ask the user before implementation.</reminder>";
+export declare const PHASE_REMINDER_SEPARATOR = "\n\n---\n\n";
+export declare function stripPhaseReminder(text: string): string;
 interface MessageInfo {
     role: string;
     agent?: string;

package/dist/hooks/thoth-mem/protocol.d.ts

@@ -1,6 +1,6 @@
 export declare const SDD_TOPIC_KEY_FORMAT = "sdd/{change}/{artifact}";
-export declare const FIRST_ACTION_INSTRUCTION = "FIRST ACTION REQUIRED: Call mem_session_summary with the content of the compacted summary. This preserves what was accomplished before compaction. Do this BEFORE any other work. Then call mem_context for a recent-session overview, and use the 3-layer recall protocol (mem_search with mode \"compact\" -> mem_timeline -> mem_get_observation) for precise retrieval.";
-export declare const SESSION_SUMMARY_TEMPLATE = "Use this exact structure for `mem_session_summary` content:\n\n## Goal\n[What we were working on this session]\n\n## Instructions\n[User preferences or constraints discovered during this session]\n\n## Discoveries\n- [Technical findings, gotchas, non-obvious learnings]\n\n## Accomplished\n- [Completed items with key details]\n\n## Next Steps\n- [What remains to be done]\n\n## Relevant Files\n- path/to/file.ts - [what it does or what changed]";
+export declare const FIRST_ACTION_INSTRUCTION = "FIRST ACTION REQUIRED: Call mem_session(action=\"summary\") with the content of the compacted summary. This preserves what was accomplished before compaction. Do this BEFORE any other work. Then call mem_context(recall_query=...) for fused recent context, and use the recall funnel (mem_recall(mode=\"compact\") -> mem_recall(mode=\"context\") -> mem_get(...)) for precise retrieval.";
+export declare const SESSION_SUMMARY_TEMPLATE = "Use this exact structure for `mem_session(action=\"summary\")` content:\n\n## Goal\n[What we were working on this session]\n\n## Instructions\n[User preferences or constraints discovered during this session]\n\n## Discoveries\n- [Technical findings, gotchas, non-obvious learnings]\n\n## Accomplished\n- [Completed items with key details]\n\n## Next Steps\n- [What remains to be done]\n\n## Relevant Files\n- path/to/file.ts - [what it does or what changed]";
 export declare function buildCompactionReminder(sessionID: string): string;
 export declare function buildCompactorInstruction(project: string): string;
 export declare function buildMemoryInstructions(sessionID: string, project: string): string;