thoth-agents 0.10.0 → 0.12.0

package/dist/config/schema.d.ts

@@ -59,26 +59,6 @@ export declare const AgentOverrideConfigSchema: z.ZodObject<{
     steps: z.ZodOptional<z.ZodNumber>;
     variant: z.ZodCatch<z.ZodOptional<z.ZodString>>;
 }, z.core.$strip>;
-export declare const TmuxLayoutSchema: z.ZodEnum<{
-    "main-vertical": "main-vertical";
-    "main-horizontal": "main-horizontal";
-    tiled: "tiled";
-    "even-horizontal": "even-horizontal";
-    "even-vertical": "even-vertical";
-}>;
-export type TmuxLayout = z.infer<typeof TmuxLayoutSchema>;
-export declare const TmuxConfigSchema: z.ZodObject<{
-    enabled: z.ZodDefault<z.ZodBoolean>;
-    layout: z.ZodDefault<z.ZodEnum<{
-        "main-vertical": "main-vertical";
-        "main-horizontal": "main-horizontal";
-        tiled: "tiled";
-        "even-horizontal": "even-horizontal";
-        "even-vertical": "even-vertical";
-    }>>;
-    main_pane_size: z.ZodDefault<z.ZodNumber>;
-}, z.core.$strip>;
-export type TmuxConfig = z.infer<typeof TmuxConfigSchema>;
 export type AgentOverrideConfig = z.infer<typeof AgentOverrideConfigSchema>;
 /** Normalized model entry with optional per-model variant. */
 export type ModelEntry = {
@@ -198,17 +178,6 @@ export declare const PluginConfigSchema: z.ZodObject<{
         variant: z.ZodCatch<z.ZodOptional<z.ZodString>>;
     }, z.core.$strip>>>;
     disabled_mcps: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    tmux: z.ZodOptional<z.ZodObject<{
-        enabled: z.ZodDefault<z.ZodBoolean>;
-        layout: z.ZodDefault<z.ZodEnum<{
-            "main-vertical": "main-vertical";
-            "main-horizontal": "main-horizontal";
-            tiled: "tiled";
-            "even-horizontal": "even-horizontal";
-            "even-vertical": "even-vertical";
-        }>>;
-        main_pane_size: z.ZodDefault<z.ZodNumber>;
-    }, z.core.$strip>>;
     fallback: z.ZodOptional<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         timeoutMs: z.ZodDefault<z.ZodNumber>;

package/dist/harness/adapters/opencode.d.ts

@@ -1,4 +1,4 @@
-import type { AgentConfig } from '@opencode-ai/sdk/v2';
+import type { AgentConfig } from '../../agents/agent-config';
 import type { PluginConfig } from '../../config';
 import type { HarnessAdapter, HarnessCapabilities, HarnessRenderContext } from '../types';
 export type OpenCodeAgentConfigs = Record<string, AgentConfig>;

package/dist/harness/core/agent-pack.d.ts

@@ -57,6 +57,7 @@ export interface ImplementationOwnershipPolicy {
     rootIdentity: string;
     defaultRule: string;
     rootResponsibilities: string[];
+    recordAuthorship: string;
     discovery: string[];
     directConsultation: string[];
     directException: string[];

package/dist/harness/core/sdd.d.ts

@@ -179,7 +179,7 @@ export declare const SDD_PHASE_PROTOCOLS: readonly [{
     readonly id: "explore";
     readonly objective: "Understand current behavior and constraints in proportion to the request.";
     readonly requiredInputs: ["User intent and known repository context"];
-    readonly instructions: ["Inspect repository evidence in proportion to the request to identify behavior, constraints, risks, and safe assumptions.", "Root owns completing understanding and acceptance; specific discovery ownership determines who gathers evidence, even when generic guidance permits direct exploration.", "Give each evidence assignment one precise question and result. Independent questions may run in parallel within native capacity; dependent questions wait until the upstream output is accepted by root. Do not duplicate discovery.", "Complete this phase before specifying. No document, agent, or interview is forced in this phase."];
+    readonly instructions: ["Inspect repository evidence in proportion to the request to identify behavior, constraints, risks, and safe assumptions.", "Root owns completing understanding and acceptance; specific discovery ownership determines who gathers evidence, even when generic guidance permits direct exploration.", "During planning, specialists supply only context within their full role scope; never assign them to create, modify or correct SDD files.", "Give each evidence assignment one precise question and result. Independent questions may run in parallel within native capacity; dependent questions wait until the upstream output is accepted by root. Do not duplicate discovery.", "Complete this phase before specifying. No document, agent, or interview is forced in this phase."];
     readonly outputSchema: ["confirmed facts", "constraints", "safe assumptions", "material uncertainty"];
     readonly doneWhen: ["The next step can state intended outcomes without repeating discovery."];
     readonly blockingConditions: ["A material human-owned decision cannot safely be inferred."];
@@ -203,7 +203,7 @@ export declare const SDD_PHASE_PROTOCOLS: readonly [{
     readonly id: "plan";
     readonly objective: "Plan substantial work in its one persistent record.";
     readonly requiredInputs: ["Settled understanding", "Substantial classification", "Accepted outcomes"];
-    readonly instructions: ["Substantial classification only creates the `.thoth/changes/<id>/<id>.md` record.", "Capture interfaces, mutable surfaces, durable deltas, dependencies, risks, and verification seams.", "Plan each useful work unit with concrete inputs, outputs, and dependencies.", "Record each unit's owner, owned writes, interface boundaries, focused checks with PASS evidence, and return milestone and stop condition.", "Validate the plan before tasks exist; tasks are checked later for acceptance coverage."];
+    readonly instructions: ["Root alone creates, edits, validates and corrects the substantial change record: coordination outside specialist-default execution, direct-work allowances and consultation budget; no source discovery or substantive implementation permission.", "Substantial classification only creates the `.thoth/changes/<id>/<id>.md` record.", "Capture interfaces, mutable surfaces, durable deltas, dependencies, risks, and verification seams.", "Plan each useful work unit with concrete inputs, outputs, and dependencies.", "Record each unit's owner, owned writes, interface boundaries, focused checks with PASS evidence, and return milestone and stop condition.", "Validate the plan before tasks exist; tasks are checked later for acceptance coverage."];
     readonly outputSchema: ["technical approach", "affected interfaces", "risks", "verification seams"];
     readonly doneWhen: ["A competent implementer can proceed without guessing at critical constraints."];
     readonly blockingConditions: ["The approach contradicts accepted intent or unresolved material choices remain."];
@@ -227,7 +227,7 @@ export declare const SDD_PHASE_PROTOCOLS: readonly [{
     readonly id: "plan-review";
     readonly objective: "Offer optional independent blocker review after the ready plan.";
     readonly requiredInputs: ["Ready substantial record", "Selected review disposition"];
-    readonly instructions: ["At ready, first show the user a concise plan summary (goal, acceptance, units, risks), then always offer “Review plan with Oracle (Recommended)” or “Proceed without review”; record the plan-review choice as EXPLICIT_REVIEW for an explicit review answer, EXPLICIT_SKIP for an explicit direct answer, or DEFAULT_REVIEW_AFTER_3 only when the third confirmed empty return selects review. Keep selection provenance separate from implementation authorization; silence never means EXPLICIT_SKIP.", "For every orchestrator choice with a meaningful safe recommendation, after its first and second confirmed empty native returns repeat the same question and do no dependent work; after the third confirmed empty native return choose the recommendation. Explicit answers and Stop win. Pending, unavailable, failed, interrupted or host-prohibited questions do not count. If higher-priority host or tool rules prevent asking or repeating, obey them and report the limitation rather than claiming three returns or an explicit selection.", "Never fabricate facts or secrets; recommend safe deferral when needed information or material intent is unresolved, and keep dependent work blocked.", "Review scope, approach, risks, and acceptance coverage without redesigning settled intent.", "Return actionable blockers and cautions; a pass is not implementation authorization or final verification.", "After [OKAY], preserve the separate Implement (Recommended) / Stop authorization decision; honor applicable prior explicit authorization, and let explicit Stop supersede it.", "A plan review does not substitute for fresh final verification."];
+    readonly instructions: ["At ready, first show the user a concise plan summary (goal, acceptance, units, risks), then always offer “Review plan with Oracle (Recommended)” or “Proceed without review”; record the plan-review choice as EXPLICIT_REVIEW for an explicit review answer, EXPLICIT_SKIP for an explicit direct answer, or DEFAULT_REVIEW_AFTER_3 only when the third confirmed empty return selects review. Keep selection provenance separate from implementation authorization; silence never means EXPLICIT_SKIP.", "For every orchestrator choice with a meaningful safe recommendation, after its first and second confirmed empty native returns repeat the same question and do no dependent work; after the third confirmed empty native return choose the recommendation. Explicit answers and Stop win. Pending, unavailable, failed, interrupted or host-prohibited questions do not count. If higher-priority host or tool rules prevent asking or repeating, obey them and report the limitation rather than claiming three returns or an explicit selection.", "Never fabricate facts or secrets; recommend safe deferral when needed information or material intent is unresolved, and keep dependent work blocked.", "Review scope, approach, risks, and acceptance coverage without redesigning settled intent.", "Return actionable blockers and cautions; a pass is not implementation authorization or final verification.", "After [OKAY], preserve the separate Implement (Recommended) / Stop authorization decision; honor applicable prior explicit authorization, and let explicit Stop supersede it.", "REJECT: root repairs the same record, reruns affected gates and sends it to a fresh Oracle; repeat until OKAY or a human-owned material blocker stops the round.", "A plan review does not substitute for fresh final verification."];
     readonly outputSchema: ["status", "blockers", "cautions"];
     readonly doneWhen: ["The selected review has a current, evidence-backed disposition."];
     readonly blockingConditions: ["A blocking finding remains unresolved."];
@@ -235,7 +235,7 @@ export declare const SDD_PHASE_PROTOCOLS: readonly [{
     readonly id: "implement";
     readonly objective: "Implement the accepted small request or authorized substantial slice.";
     readonly requiredInputs: ["Settled user intent or authorized record", "Exact mutable boundaries", "Focused checks"];
-    readonly instructions: ["Use one writer per mutable surface and choose an owner from task shape.", "Work only from accepted inputs and named dependencies within the assigned outcome and interface boundaries.", "Return bounded progress for root acceptance before dependent work starts.", "Use test-first (TDD); observe red before green for behavior changes, then verify call sites, shared contracts, and edge cases.", "Stop on a missing interface, ownership conflict, or new independent outcome.", "Return completed bounded progress and the smallest blocker for root reassessment before expansion.", "Do not create process tooling, reports, evidence generators, or temporary artifacts."];
+    readonly instructions: ["For small work, root states a brief in-session plan (scope, owner, focused verification) before delegation or implementation; no record or planning phases.", "Implementation writers start only after authorization; never write .thoth/changes/ records.", "Use one writer per mutable surface and choose an owner from task shape.", "Work only from accepted inputs and named dependencies within the assigned outcome and interface boundaries.", "Return bounded progress for root acceptance before dependent work starts.", "Use test-first (TDD); observe red before green for behavior changes, then verify call sites, shared contracts, and edge cases.", "Stop on a missing interface, ownership conflict, or new independent outcome.", "Return completed bounded progress and the smallest blocker for root reassessment before expansion.", "Do not create process tooling, reports, evidence generators, or temporary artifacts."];
     readonly outputSchema: ["outcome", "changed files", "checks", "residual risks"];
     readonly doneWhen: ["The assigned outcome is implemented and focused checks have run."];
     readonly blockingConditions: ["Scope, risk, or material intent changes before safe completion."];
@@ -243,7 +243,7 @@ export declare const SDD_PHASE_PROTOCOLS: readonly [{
     readonly id: "verify";
     readonly objective: "Verify actual outcomes with independence proportional to risk.";
     readonly requiredInputs: ["Accepted outcomes", "Actual change and executed checks"];
-    readonly instructions: ["Judge the actual diff, executed checks, and residual risks; verify completeness, correctness, coherence, and behavior.", "Substantial or materially risky work requires a fresh independent Oracle; no writer self-approves.", "For substantial work, record acceptance evidence, checks, source digests, and reviewed-record digest in the same record."];
+    readonly instructions: ["Judge the actual diff, executed checks, and residual risks; verify completeness, correctness, coherence, and behavior.", "Substantial or materially risky work requires a fresh independent Oracle; no writer self-approves.", "For substantial work, record acceptance evidence, checks, source digests, and reviewed-record digest in the same record.", "Plan review OKAY/REJECT judges the record; root repairs REJECT. Final verification PASS/FAIL judges the implementation.", "Root records remaining acceptance-linked work in the substantial record when one exists, otherwise in the brief in-session small plan; the owning Worker or Designer repairs each affected surface; root coordinates and does not repair implementation unless the user explicitly instructs direct work; even then, never self-approve and report unavailable independent review.", "Repeat independent verification as the change's verification level requires; substantial or materially risky work uses a fresh Oracle. Material changes in intent, scope or risk reopen understanding and planning before further implementation."];
     readonly outputSchema: ["verdict", "acceptance evidence", "checks", "residual risks"];
     readonly doneWhen: ["Every accepted outcome has evidence or an explicit residual risk."];
     readonly blockingConditions: ["A failed check, missing evidence, or critical issue remains."];
@@ -251,7 +251,7 @@ export declare const SDD_PHASE_PROTOCOLS: readonly [{
     readonly id: "converge";
     readonly objective: "Turn actionable verification gaps into bounded corrective work.";
     readonly requiredInputs: ["Failed verification", "Settled intent"];
-    readonly instructions: ["Record acceptance-linked follow-up in the same record when one exists.", "If scope or risk changes materially, reopen understanding and classification.", "Do not create a separate convergence report."];
+    readonly instructions: ["Plan review OKAY/REJECT judges the record; root repairs REJECT. Final verification PASS/FAIL judges the implementation.", "Root records remaining acceptance-linked work in the substantial record when one exists, otherwise in the brief in-session small plan; the owning Worker or Designer repairs each affected surface; root coordinates and does not repair implementation unless the user explicitly instructs direct work; even then, never self-approve and report unavailable independent review.", "Repeat independent verification as the change's verification level requires; substantial or materially risky work uses a fresh Oracle. Material changes in intent, scope or risk reopen understanding and planning before further implementation.", "Do not create a separate convergence report."];
     readonly outputSchema: ["bounded follow-up", "verification seam"];
     readonly doneWhen: ["Each actionable gap has a safe next action or the work is confirmed converged."];
     readonly blockingConditions: ["Findings lack evidence or require material new intent."];

package/dist/hooks/delegate-task-retry/hook.d.ts

@@ -1,8 +1,8 @@
-import type { PluginInput } from '@opencode-ai/plugin';
-export declare function createDelegateTaskRetryHook(_ctx: PluginInput): {
-    'tool.execute.after': (input: {
-        tool: string;
-    }, output: {
-        output: unknown;
-    }) => Promise<void>;
-};
+import type { Plugin } from '@opencode/plugin';
+export type DelegationToolEvent = Extract<Parameters<Parameters<Plugin.Context['tool']['hook']>[1]>[0], {
+    status: 'completed' | 'error';
+}>;
+export declare function appendErrorGuidance(event: DelegationToolEvent & {
+    status: 'error';
+}, guidance: string): void;
+export declare function createDelegateTaskRetryHook(): (event: DelegationToolEvent) => Promise<void>;

package/dist/hooks/foreground-fallback/index.d.ts

@@ -1,73 +1,18 @@
-/**
- * Runtime model fallback for foreground (interactive) agent sessions.
- *
- * When OpenCode fires a session.error, message.updated, or session.status
- * event containing a rate-limit signal, this manager:
- *   1. Looks up the next untried model in the agent's configured chain
- *   2. Aborts the rate-limited prompt via client.session.abort()
- *   3. Re-queues the last user message via client.session.promptAsync()
- *      with the new model — promptAsync returns immediately so we never
- *      block the event handler waiting for a full LLM response.
- *
- * This mirrors the task fallback loop but operates
- * reactively through the event system instead of wrapping prompt() in a
- * try/catch, which is not possible for interactive (foreground) sessions.
- */
-import type { PluginInput } from '@opencode-ai/plugin';
-type OpencodeClient = PluginInput['client'];
+import type { Plugin } from '@opencode/plugin';
+import type { SessionRetry } from '@opencode/plugin/promise/session';
+/** Retained public detection helper; v2 uses structured provider errors. */
 export declare function isRateLimitError(error: unknown): boolean;
-/**
- * Manages runtime model fallback for foreground agent sessions.
- *
- * Constructed at plugin init with the ordered fallback chains for each agent
- * (built from _modelArray entries merged with fallback.chains config).
- */
+/** Retry state is isolated by session AND agent; no event replay or timers. */
 export declare class ForegroundFallbackManager {
-    private readonly client;
-    /**
-     * Ordered fallback chains per agent.
-     * e.g. { orchestrator: ['anthropic/claude-opus-4-5', 'openai/gpt-4o'] }
-     * The first model that hasn't been tried yet is selected on each fallback.
-     */
+    private readonly session;
     private readonly chains;
-    private readonly enabled;
-    /** sessionID → last observed model string ("providerID/modelID") */
-    private readonly sessionModel;
-    /** sessionID → agent name (populated from message.updated info.agent field) */
-    private readonly sessionAgent;
-    /** sessionID → set of models already attempted this session */
-    private readonly sessionTried;
-    /** Sessions with an active fallback switch in flight */
-    private readonly inProgress;
-    /** sessionID → timestamp of last trigger (for deduplication) */
-    private readonly lastTrigger;
-    constructor(client: OpencodeClient, 
-    /**
-     * Ordered fallback chains per agent.
-     * e.g. { orchestrator: ['anthropic/claude-opus-4-5', 'openai/gpt-4o'] }
-     * The first model that hasn't been tried yet is selected on each fallback.
-     */
-    chains: Record<string, string[]>, enabled: boolean);
-    /**
-     * Process an OpenCode plugin event.
-     * Call this from the plugin's `event` hook for every event received.
-     */
-    handleEvent(rawEvent: unknown): Promise<void>;
-    getSessionModel(sessionId: string): string | undefined;
-    private tryFallback;
-    /**
-     * Determine the fallback chain to use for a session.
-     *
-     * Priority:
-     * 1. Agent name known AND has a configured chain → return it directly
-     * 2. Agent name known but NO chain configured → return [] (no fallback;
-     *    do NOT bleed into other agents' chains which would re-prompt the
-     *    session with a model belonging to a completely different agent)
-     * 3. Agent name unknown, current model known → search all chains for
-     *    the model to infer which chain to use
-     * 4. Nothing matches → flatten all chains as a last resort (only
-     *    reached when both agent name and current model are unavailable)
-     */
-    private resolveChain;
+    private readonly models;
+    private readonly tried;
+    private readonly switching;
+    constructor(session: Pick<Plugin.Context['session'], 'switchModel'>, chains: Record<string, string[]>, models?: Record<string, {
+        id: string;
+        variant?: string;
+    }[]>);
+    forget(sessionID: string): void;
+    retry(input: SessionRetry): Promise<void>;
 }
-export {};

package/dist/hooks/index.d.ts

@@ -1,5 +1,3 @@
-export type { AutoUpdateCheckerOptions } from './auto-update-checker';
-export { createAutoUpdateCheckerHook } from './auto-update-checker';
 export { createDelegateTaskRetryHook } from './delegate-task-retry';
 export { ForegroundFallbackManager, isRateLimitError, } from './foreground-fallback';
 export { createJsonErrorRecoveryHook } from './json-error-recovery';

package/dist/hooks/json-error-recovery/hook.d.ts

@@ -1,18 +1,5 @@
-import type { PluginInput } from '@opencode-ai/plugin';
+import { type DelegationToolEvent } from '../delegate-task-retry/hook';
 export declare const JSON_ERROR_TOOL_EXCLUDE_LIST: readonly ["bash", "read", "glob", "webfetch", "grep_app_searchgithub", "exa_web_search_exa"];
 export declare const JSON_ERROR_PATTERNS: readonly [RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp];
 export declare const JSON_ERROR_REMINDER = "\n[JSON PARSE ERROR - IMMEDIATE ACTION REQUIRED]\n\nYou sent invalid JSON arguments. The system could not parse your tool call.\nSTOP and do this NOW:\n\n1. LOOK at the error message above to see what was expected vs what you sent.\n2. CORRECT your JSON syntax (missing braces, unescaped quotes, trailing commas, etc).\n3. RETRY the tool call with valid JSON.\n\nDO NOT repeat the exact same invalid call.\n";
-interface ToolExecuteAfterInput {
-    tool: string;
-    sessionID: string;
-    callID: string;
-}
-interface ToolExecuteAfterOutput {
-    title: string;
-    output: unknown;
-    metadata: unknown;
-}
-export declare function createJsonErrorRecoveryHook(_ctx: PluginInput): {
-    'tool.execute.after': (input: ToolExecuteAfterInput, output: ToolExecuteAfterOutput) => Promise<void>;
-};
-export {};
+export declare function createJsonErrorRecoveryHook(): (event: DelegationToolEvent) => Promise<void>;

package/dist/hooks/oracle-gate-verdict/hook.d.ts

@@ -1,11 +1,4 @@
-import type { PluginInput } from '@opencode-ai/plugin';
-export declare function createOracleGateVerdictHook(ctx: PluginInput): {
-    'tool.execute.after': (input: {
-        tool: string;
-        args?: {
-            subagent_type?: unknown;
-        };
-    }, output: {
-        output: unknown;
-    }) => Promise<void>;
-};
+import type { DelegationToolEvent } from '../delegate-task-retry/hook';
+export declare function createOracleGateVerdictHook(ctx: {
+    directory: string;
+}): (event: DelegationToolEvent) => Promise<void>;

package/dist/index.d.ts

@@ -1,5 +1,8 @@
-import type { Plugin } from '@opencode-ai/plugin';
-declare const ThothAgents: Plugin;
-export default ThothAgents;
-export type { AgentName, AgentOverrideConfig, McpName, PluginConfig, TmuxConfig, TmuxLayout, } from './config';
+import type { Plugin } from '@opencode/plugin';
+declare const plugin: {
+    id: string;
+    setup(ctx: Plugin.Context): Promise<void>;
+};
+export default plugin;
+export type { AgentName, AgentOverrideConfig, McpName, PluginConfig, } from './config';
 export type { RemoteMcpConfig } from './mcp';