thoth-agents 0.11.0 → 0.13.0

package/dist/config/loader.d.ts

@@ -9,7 +9,7 @@ import { type PluginConfig } from './schema';
  *
  * JSONC format is preferred over JSON (allows comments and trailing commas).
  * Project config takes precedence over user config. Nested objects (agents,
- * tmux, fallback, and harness generation options) are
+ * fallback, and harness generation options) are
  * deep-merged, while top-level arrays are replaced entirely
  * by project config.
  *
@@ -20,14 +20,11 @@ export declare function loadPluginConfig(directory: string): PluginConfig;
 /**
  * Load custom prompt for an agent from the prompts directory.
  * Checks for {agent}.md (replaces default) and {agent}_append.md (appends to default).
- * If preset is provided and safe for paths, it first checks {preset}/ subdirectory,
- * then falls back to the root prompts directory.
  *
  * @param agentName - Name of the agent (e.g., "orchestrator", "explorer")
- * @param preset - Optional preset name for preset-scoped prompt lookup
  * @returns Object with prompt and/or appendPrompt if files exist
  */
-export declare function loadAgentPrompt(agentName: string, preset?: string): {
+export declare function loadAgentPrompt(agentName: string): {
     prompt?: string;
     appendPrompt?: string;
 };

package/dist/config/schema.d.ts

@@ -59,43 +59,12 @@ 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 = {
     id: string;
     variant?: string;
 };
-export declare const PresetSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
-    model: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
-        id: z.ZodString;
-        variant: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>]>>]>>;
-    skills: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    temperature: z.ZodOptional<z.ZodNumber>;
-    steps: z.ZodOptional<z.ZodNumber>;
-    variant: z.ZodCatch<z.ZodOptional<z.ZodString>>;
-}, z.core.$strip>>;
-export type Preset = z.infer<typeof PresetSchema>;
 export declare const AgentNameSchema: z.ZodEnum<{
     orchestrator: "orchestrator";
     explorer: "explorer";
@@ -131,7 +100,6 @@ export declare const FailoverConfigSchema: z.ZodObject<{
 export type FailoverConfig = z.infer<typeof FailoverConfigSchema>;
 export declare const PluginConfigSchema: z.ZodObject<{
     $schema: z.ZodOptional<z.ZodString>;
-    preset: z.ZodOptional<z.ZodString>;
     setDefaultAgent: z.ZodOptional<z.ZodBoolean>;
     scoringEngineVersion: z.ZodOptional<z.ZodEnum<{
         v1: "v1";
@@ -177,16 +145,6 @@ export declare const PluginConfigSchema: z.ZodObject<{
             fallback3: z.ZodString;
         }, z.core.$strip>;
     }, z.core.$strict>>;
-    presets: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodObject<{
-        model: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
-            id: z.ZodString;
-            variant: z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>]>>]>>;
-        skills: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        temperature: z.ZodOptional<z.ZodNumber>;
-        steps: z.ZodOptional<z.ZodNumber>;
-        variant: z.ZodCatch<z.ZodOptional<z.ZodString>>;
-    }, z.core.$strip>>>>;
     agents: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
         model: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
             id: z.ZodString;
@@ -198,17 +156,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/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';