oh-my-opencode 3.7.3 → 3.8.0

package/dist/config/schema/ralph-loop.d.ts

@@ -3,5 +3,9 @@ export declare const RalphLoopConfigSchema: z.ZodObject<{
     enabled: z.ZodDefault<z.ZodBoolean>;
     default_max_iterations: z.ZodDefault<z.ZodNumber>;
     state_dir: z.ZodOptional<z.ZodString>;
+    default_strategy: z.ZodDefault<z.ZodEnum<{
+        reset: "reset";
+        continue: "continue";
+    }>>;
 }, z.core.$strip>;
 export type RalphLoopConfig = z.infer<typeof RalphLoopConfigSchema>;

package/dist/config/schema/runtime-fallback.d.ts

@@ -0,0 +1,10 @@
+import { z } from "zod";
+export declare const RuntimeFallbackConfigSchema: z.ZodObject<{
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    retry_on_errors: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+    max_fallback_attempts: z.ZodOptional<z.ZodNumber>;
+    cooldown_seconds: z.ZodOptional<z.ZodNumber>;
+    timeout_seconds: z.ZodOptional<z.ZodNumber>;
+    notify_on_fallback: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type RuntimeFallbackConfig = z.infer<typeof RuntimeFallbackConfigSchema>;

package/dist/config/schema.d.ts

@@ -9,11 +9,13 @@ export * from "./schema/comment-checker";
 export * from "./schema/commands";
 export * from "./schema/dynamic-context-pruning";
 export * from "./schema/experimental";
+export * from "./schema/fallback-models";
 export * from "./schema/git-master";
 export * from "./schema/hooks";
 export * from "./schema/notification";
 export * from "./schema/oh-my-opencode-config";
 export * from "./schema/ralph-loop";
+export * from "./schema/runtime-fallback";
 export * from "./schema/skills";
 export * from "./schema/sisyphus";
 export * from "./schema/sisyphus-agent";

package/dist/create-hooks.d.ts

@@ -24,7 +24,7 @@ export declare function createHooks(args: {
     unstableAgentBabysitter: ReturnType<typeof import("./plugin/unstable-agent-babysitter").createUnstableAgentBabysitter> | null;
     backgroundNotificationHook: ReturnType<typeof import("./hooks").createBackgroundNotificationHook> | null;
     atlasHook: ReturnType<typeof import("./hooks").createAtlasHook> | null;
-    claudeCodeHooks: ReturnType<typeof import("./hooks").createClaudeCodeHooksHook>;
+    claudeCodeHooks: ReturnType<typeof import("./hooks").createClaudeCodeHooksHook> | null;
     keywordDetector: ReturnType<typeof import("./hooks").createKeywordDetectorHook> | null;
     contextInjectorMessagesTransform: ReturnType<typeof import("./features/context-injector").createContextInjectorMessagesTransformHook>;
     thinkingBlockValidator: ReturnType<typeof import("./hooks").createThinkingBlockValidatorHook> | null;
@@ -37,11 +37,13 @@ export declare function createHooks(args: {
     tasksTodowriteDisabler: ReturnType<typeof import("./hooks").createTasksTodowriteDisablerHook> | null;
     writeExistingFileGuard: ReturnType<typeof import("./hooks").createWriteExistingFileGuardHook> | null;
     hashlineReadEnhancer: ReturnType<typeof import("./hooks").createHashlineReadEnhancerHook> | null;
+    jsonErrorRecovery: ReturnType<typeof import("./hooks").createJsonErrorRecoveryHook> | null;
     contextWindowMonitor: ReturnType<typeof import("./hooks").createContextWindowMonitorHook> | null;
     preemptiveCompaction: ReturnType<typeof import("./hooks").createPreemptiveCompactionHook> | null;
     sessionRecovery: ReturnType<typeof import("./hooks").createSessionRecoveryHook> | null;
     sessionNotification: ReturnType<typeof import("./hooks").createSessionNotification> | null;
     thinkMode: ReturnType<typeof import("./hooks").createThinkModeHook> | null;
+    modelFallback: ReturnType<typeof import("./hooks").createModelFallbackHook> | null;
     anthropicContextWindowLimitRecovery: ReturnType<typeof import("./hooks").createAnthropicContextWindowLimitRecoveryHook> | null;
     autoUpdateChecker: ReturnType<typeof import("./hooks").createAutoUpdateCheckerHook> | null;
     agentUsageReminder: ReturnType<typeof import("./hooks").createAgentUsageReminderHook> | null;
@@ -49,13 +51,14 @@ export declare function createHooks(args: {
     interactiveBashSession: ReturnType<typeof import("./hooks").createInteractiveBashSessionHook> | null;
     ralphLoop: ReturnType<typeof import("./hooks").createRalphLoopHook> | null;
     editErrorRecovery: ReturnType<typeof import("./hooks").createEditErrorRecoveryHook> | null;
-    jsonErrorRecovery: ReturnType<typeof import("./hooks").createJsonErrorRecoveryHook> | null;
     delegateTaskRetry: ReturnType<typeof import("./hooks").createDelegateTaskRetryHook> | null;
     startWork: ReturnType<typeof import("./hooks").createStartWorkHook> | null;
     prometheusMdOnly: ReturnType<typeof import("./hooks").createPrometheusMdOnlyHook> | null;
     sisyphusJuniorNotepad: ReturnType<typeof import("./hooks").createSisyphusJuniorNotepadHook> | null;
-    sisyphusGptHephaestusReminder: ReturnType<typeof import("./hooks").createSisyphusGptHephaestusReminderHook> | null;
-    questionLabelTruncator: ReturnType<typeof import("./hooks").createQuestionLabelTruncatorHook>;
-    taskResumeInfo: ReturnType<typeof import("./hooks").createTaskResumeInfoHook>;
+    noSisyphusGpt: ReturnType<typeof import("./hooks").createNoSisyphusGptHook> | null;
+    noHephaestusNonGpt: ReturnType<typeof import("./hooks").createNoHephaestusNonGptHook> | null;
+    questionLabelTruncator: ReturnType<typeof import("./hooks").createQuestionLabelTruncatorHook> | null;
+    taskResumeInfo: ReturnType<typeof import("./hooks").createTaskResumeInfoHook> | null;
     anthropicEffort: ReturnType<typeof import("./hooks/anthropic-effort").createAnthropicEffortHook> | null;
+    runtimeFallback: ReturnType<typeof import("./hooks").createRuntimeFallbackHook> | null;
 };

package/dist/features/background-agent/manager.d.ts

@@ -73,6 +73,7 @@ export declare class BackgroundManager {
     resume(input: ResumeInput): Promise<BackgroundTask>;
     private checkSessionTodos;
     handleEvent(event: Event): void;
+    private tryFallbackRetry;
     markForNotification(task: BackgroundTask): void;
     getPendingNotifications(sessionID: string): BackgroundTask[];
     clearNotifications(sessionID: string): void;
@@ -119,6 +120,8 @@ export declare class BackgroundManager {
     private formatDuration;
     private isAbortedSessionError;
     private getErrorText;
+    private extractErrorName;
+    private extractErrorMessage;
     private isRecord;
     private getSessionErrorMessage;
     private hasRunningTasks;

package/dist/features/background-agent/parent-session-context-resolver.d.ts

@@ -10,5 +10,6 @@ export declare function resolveParentSessionAgentAndModel(input: {
 }): Promise<{
     agent?: string;
     model?: AgentModel;
+    tools?: Record<string, boolean>;
 }>;
 export {};

package/dist/features/background-agent/types.d.ts

@@ -1,3 +1,4 @@
+import type { FallbackEntry } from "../../shared/model-requirements";
 export type BackgroundTaskStatus = "pending" | "running" | "completed" | "error" | "cancelled" | "interrupt";
 export interface TaskProgress {
     toolCalls: number;
@@ -30,6 +31,10 @@ export interface BackgroundTask {
         modelID: string;
         variant?: string;
     };
+    /** Fallback chain for runtime retry on model errors */
+    fallbackChain?: FallbackEntry[];
+    /** Number of fallback retry attempts made */
+    attemptCount?: number;
     /** Active concurrency slot key */
     concurrencyKey?: string;
     /** Persistent key for re-acquiring concurrency on resume */
@@ -64,6 +69,8 @@ export interface LaunchInput {
         modelID: string;
         variant?: string;
     };
+    /** Fallback chain for runtime retry on model errors */
+    fallbackChain?: FallbackEntry[];
     isUnstableAgent?: boolean;
     skills?: string[];
     skillContent?: string;

package/dist/features/builtin-commands/templates/ralph-loop.d.ts

@@ -1,2 +1,2 @@
-export declare const RALPH_LOOP_TEMPLATE = "You are starting a Ralph Loop - a self-referential development loop that runs until task completion.\n\n## How Ralph Loop Works\n\n1. You will work on the task continuously\n2. When you believe the task is FULLY complete, output: `<promise>{{COMPLETION_PROMISE}}</promise>`\n3. If you don't output the promise, the loop will automatically inject another prompt to continue\n4. Maximum iterations: Configurable (default 100)\n\n## Rules\n\n- Focus on completing the task fully, not partially\n- Don't output the completion promise until the task is truly done\n- Each iteration should make meaningful progress toward the goal\n- If stuck, try different approaches\n- Use todos to track your progress\n\n## Exit Conditions\n\n1. **Completion**: Output your completion promise tag when fully complete\n2. **Max Iterations**: Loop stops automatically at limit\n3. **Cancel**: User runs `/cancel-ralph` command\n\n## Your Task\n\nParse the arguments below and begin working on the task. The format is:\n`\"task description\" [--completion-promise=TEXT] [--max-iterations=N]`\n\nDefault completion promise is \"DONE\" and default max iterations is 100.";
+export declare const RALPH_LOOP_TEMPLATE = "You are starting a Ralph Loop - a self-referential development loop that runs until task completion.\n\n## How Ralph Loop Works\n\n1. You will work on the task continuously\n2. When you believe the task is FULLY complete, output: `<promise>{{COMPLETION_PROMISE}}</promise>`\n3. If you don't output the promise, the loop will automatically inject another prompt to continue\n4. Maximum iterations: Configurable (default 100)\n\n## Rules\n\n- Focus on completing the task fully, not partially\n- Don't output the completion promise until the task is truly done\n- Each iteration should make meaningful progress toward the goal\n- If stuck, try different approaches\n- Use todos to track your progress\n\n## Exit Conditions\n\n1. **Completion**: Output your completion promise tag when fully complete\n2. **Max Iterations**: Loop stops automatically at limit\n3. **Cancel**: User runs `/cancel-ralph` command\n\n## Your Task\n\nParse the arguments below and begin working on the task. The format is:\n`\"task description\" [--completion-promise=TEXT] [--max-iterations=N] [--strategy=reset|continue]`\n\nDefault completion promise is \"DONE\" and default max iterations is 100.";
 export declare const CANCEL_RALPH_TEMPLATE = "Cancel the currently active Ralph Loop.\n\nThis will:\n1. Stop the loop from continuing\n2. Clear the loop state file\n3. Allow the session to end normally\n\nCheck if a loop is active and cancel it. Inform the user of the result.";

package/dist/features/claude-code-session-state/state.d.ts

@@ -1,4 +1,5 @@
 export declare const subagentSessions: Set<string>;
+export declare const syncSubagentSessions: Set<string>;
 export declare function setMainSession(id: string | undefined): void;
 export declare function getMainSessionID(): string | undefined;
 /** @internal For testing only */

package/dist/features/task-toast-manager/manager.d.ts

@@ -10,6 +10,7 @@ export declare class TaskToastManager {
     setConcurrencyManager(manager: ConcurrencyManager): void;
     addTask(task: {
         id: string;
+        sessionID?: string;
         description: string;
         agent: string;
         isBackground: boolean;
@@ -22,6 +23,10 @@ export declare class TaskToastManager {
      * Update task status
      */
     updateTask(id: string, status: TaskStatus): void;
+    /**
+     * Update model info for a task by session ID
+     */
+    updateTaskModelBySession(sessionID: string, modelInfo: ModelFallbackInfo): void;
     /**
      * Remove completed/error task
      */

package/dist/features/task-toast-manager/types.d.ts

@@ -2,11 +2,12 @@ import type { ModelSource } from "../../shared/model-resolver";
 export type TaskStatus = "running" | "queued" | "completed" | "error";
 export interface ModelFallbackInfo {
     model: string;
-    type: "user-defined" | "inherited" | "category-default" | "system-default";
+    type: "user-defined" | "inherited" | "category-default" | "system-default" | "runtime-fallback";
     source?: ModelSource;
 }
 export interface TrackedTask {
     id: string;
+    sessionID?: string;
     description: string;
     agent: string;
     status: TaskStatus;

package/dist/features/tmux-subagent/action-executor.d.ts

@@ -1,6 +1,7 @@
-import type { PaneAction } from "./types";
-import type { ActionResult, ExecuteContext } from "./action-executor-core";
-export type { ActionExecutorDeps, ActionResult, ExecuteContext } from "./action-executor-core";
+import type { TmuxConfig } from "../../config/schema";
+import type { PaneAction, WindowState } from "./types";
+import type { ActionResult } from "./action-executor-core";
+export type { ActionExecutorDeps, ActionResult } from "./action-executor-core";
 export interface ExecuteActionsResult {
     success: boolean;
     spawnedPaneId?: string;
@@ -9,5 +10,11 @@ export interface ExecuteActionsResult {
         result: ActionResult;
     }>;
 }
+export interface ExecuteContext {
+    config: TmuxConfig;
+    serverUrl: string;
+    windowState: WindowState;
+    sourcePaneId?: string;
+}
 export declare function executeAction(action: PaneAction, ctx: ExecuteContext): Promise<ActionResult>;
 export declare function executeActions(actions: PaneAction[], ctx: ExecuteContext): Promise<ExecuteActionsResult>;

package/dist/features/tmux-subagent/grid-planning.d.ts

@@ -1,4 +1,4 @@
-import type { TmuxPaneInfo } from "./types";
+import type { CapacityConfig, TmuxPaneInfo } from "./types";
 export interface GridCapacity {
     cols: number;
     rows: number;
@@ -14,6 +14,8 @@ export interface GridPlan {
     slotWidth: number;
     slotHeight: number;
 }
-export declare function calculateCapacity(windowWidth: number, windowHeight: number, minPaneWidth?: number, mainPaneWidth?: number): GridCapacity;
-export declare function computeGridPlan(windowWidth: number, windowHeight: number, paneCount: number, mainPaneWidth?: number, minPaneWidth?: number): GridPlan;
+type CapacityOptions = CapacityConfig | number | undefined;
+export declare function calculateCapacity(windowWidth: number, windowHeight: number, options?: CapacityOptions, mainPaneWidth?: number): GridCapacity;
+export declare function computeGridPlan(windowWidth: number, windowHeight: number, paneCount: number, options?: CapacityOptions, mainPaneWidth?: number): GridPlan;
 export declare function mapPaneToSlot(pane: TmuxPaneInfo, plan: GridPlan, mainPaneWidth: number): GridSlot;
+export {};

package/dist/features/tmux-subagent/manager.d.ts

@@ -33,14 +33,26 @@ export declare class TmuxSessionManager {
     private sourcePaneId;
     private sessions;
     private pendingSessions;
+    private spawnQueue;
+    private deferredSessions;
+    private deferredQueue;
+    private deferredAttachInterval?;
+    private deferredAttachTickScheduled;
+    private nullStateCount;
     private deps;
     private pollingManager;
     constructor(ctx: PluginInput, tmuxConfig: TmuxConfig, deps?: TmuxUtilDeps);
     private isEnabled;
     private getCapacityConfig;
     private getSessionMappings;
+    private enqueueDeferredSession;
+    private removeDeferredSession;
+    private startDeferredAttachLoop;
+    private stopDeferredAttachLoop;
+    private tryAttachDeferredSession;
     private waitForSessionReady;
     onSessionCreated(event: SessionCreatedEvent): Promise<void>;
+    private enqueueSpawn;
     onSessionDeleted(event: {
         sessionID: string;
     }): Promise<void>;

package/dist/features/tmux-subagent/pane-split-availability.d.ts

@@ -5,5 +5,4 @@ export declare function isSplittableAtCount(agentAreaWidth: number, paneCount: n
 export declare function findMinimalEvictions(agentAreaWidth: number, currentCount: number, minPaneWidth?: number): number | null;
 export declare function canSplitPane(pane: TmuxPaneInfo, direction: SplitDirection, minPaneWidth?: number): boolean;
 export declare function canSplitPaneAnyDirection(pane: TmuxPaneInfo, minPaneWidth?: number): boolean;
-export declare function canSplitPaneAnyDirectionWithMinWidth(pane: TmuxPaneInfo, minPaneWidth?: number): boolean;
 export declare function getBestSplitDirection(pane: TmuxPaneInfo, minPaneWidth?: number): SplitDirection | null;

package/dist/features/tmux-subagent/spawn-target-finder.d.ts

@@ -1,6 +1,6 @@
-import type { SplitDirection, WindowState } from "./types";
+import type { CapacityConfig, SplitDirection, WindowState } from "./types";
 export interface SpawnTarget {
     targetPaneId: string;
     splitDirection: SplitDirection;
 }
-export declare function findSpawnTarget(state: WindowState, minPaneWidth?: number): SpawnTarget | null;
+export declare function findSpawnTarget(state: WindowState, config: CapacityConfig): SpawnTarget | null;

package/dist/features/tmux-subagent/tmux-grid-constants.d.ts

@@ -1,3 +1,4 @@
+import type { CapacityConfig } from "./types";
 export declare const MAIN_PANE_RATIO = 0.5;
 export declare const MAX_COLS = 2;
 export declare const MAX_ROWS = 3;
@@ -5,3 +6,6 @@ export declare const MAX_GRID_SIZE = 4;
 export declare const DIVIDER_SIZE = 1;
 export declare const MIN_SPLIT_WIDTH: number;
 export declare const MIN_SPLIT_HEIGHT: number;
+export declare function getMainPaneSizePercent(config?: CapacityConfig): number;
+export declare function computeMainPaneWidth(windowWidth: number, config?: CapacityConfig): number;
+export declare function computeAgentAreaWidth(windowWidth: number, config?: CapacityConfig): number;

package/dist/features/tmux-subagent/types.d.ts

@@ -48,6 +48,8 @@ export interface SpawnDecision {
     reason?: string;
 }
 export interface CapacityConfig {
+    layout?: string;
+    mainPaneSize?: number;
     mainPaneMinWidth: number;
     agentPaneWidth: number;
 }

package/dist/hooks/atlas/recent-model-resolver.d.ts

@@ -1,3 +1,9 @@
 import type { PluginInput } from "@opencode-ai/plugin";
 import type { ModelInfo } from "./types";
+type PromptContext = {
+    model?: ModelInfo;
+    tools?: Record<string, boolean>;
+};
+export declare function resolveRecentPromptContextForSession(ctx: PluginInput, sessionID: string): Promise<PromptContext>;
 export declare function resolveRecentModelForSession(ctx: PluginInput, sessionID: string): Promise<ModelInfo | undefined>;
+export {};

package/dist/hooks/atlas/system-reminder-templates.d.ts

@@ -1,5 +1,5 @@
 export declare const DIRECT_WORK_REMINDER: string;
 export declare const BOULDER_CONTINUATION_PROMPT: string;
-export declare const VERIFICATION_REMINDER = "**MANDATORY: WHAT YOU MUST DO RIGHT NOW**\n\n\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\n\nCRITICAL: Subagents FREQUENTLY LIE about completion.\nTests FAILING, code has ERRORS, implementation INCOMPLETE - but they say \"done\".\n\n\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\n\n**STEP 1: AUTOMATED VERIFICATION (DO THIS FIRST)**\n\nRun these commands YOURSELF - do NOT trust agent's claims:\n1. `lsp_diagnostics` on changed files \u2192 Must be CLEAN\n2. `bash` to run tests \u2192 Must PASS\n3. `bash` to run build/typecheck \u2192 Must succeed\n\n**STEP 2: MANUAL CODE REVIEW (NON-NEGOTIABLE \u2014 DO NOT SKIP)**\n\nAutomated checks are NECESSARY but INSUFFICIENT. You MUST read the actual code.\n\n**RIGHT NOW \u2014 `Read` EVERY file the subagent touched. No exceptions.**\n\nFor EACH changed file, verify:\n1. Does the implementation logic ACTUALLY match the task requirements?\n2. Are there incomplete stubs (TODO comments, placeholder code, hardcoded values)?\n3. Are there logic errors, off-by-one bugs, or missing edge cases?\n4. Does it follow existing codebase patterns and conventions?\n5. Are imports correct? No unused or missing imports?\n6. Is error handling present where needed?\n\n**Cross-check the subagent's claims against reality:**\n- Subagent said \"Updated X\" \u2192 READ X. Is it actually updated?\n- Subagent said \"Added tests\" \u2192 READ tests. Do they test the RIGHT behavior?\n- Subagent said \"Follows patterns\" \u2192 COMPARE with reference. Does it actually?\n\n**If you cannot explain what the changed code does, you have not reviewed it.**\n**If you skip this step, you are rubber-stamping broken work.**\n\n**STEP 3: DETERMINE IF HANDS-ON QA IS NEEDED**\n\n| Deliverable Type | QA Method | Tool |\n|------------------|-----------|------|\n| **Frontend/UI** | Browser interaction | `/playwright` skill |\n| **TUI/CLI** | Run interactively | `interactive_bash` (tmux) |\n| **API/Backend** | Send real requests | `bash` with curl |\n\nStatic analysis CANNOT catch: visual bugs, animation issues, user flow breakages.\n\n**STEP 4: IF QA IS NEEDED - ADD TO TODO IMMEDIATELY**\n\n```\ntodowrite([\n  { id: \"qa-X\", content: \"HANDS-ON QA: [specific verification action]\", status: \"pending\", priority: \"high\" }\n])\n```\n\n\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\n\n**BLOCKING: DO NOT proceed until Steps 1-4 are ALL completed.**\n**Skipping Step 2 (manual code review) = unverified work = FAILURE.**";
+export declare const VERIFICATION_REMINDER = "**THE SUBAGENT JUST CLAIMED THIS TASK IS DONE. THEY ARE PROBABLY LYING.**\n\nSubagents say \"done\" when code has errors, tests pass trivially, logic is wrong,\nor they quietly added features nobody asked for. This happens EVERY TIME.\nAssume the work is broken until YOU prove otherwise.\n\n---\n\n**PHASE 1: READ THE CODE FIRST (before running anything)**\n\nDo NOT run tests yet. Read the code FIRST so you know what you're testing.\n\n1. `Bash(\"git diff --stat\")` \u2014 see exactly which files changed. Any file outside expected scope = scope creep.\n2. `Read` EVERY changed file \u2014 no exceptions, no skimming.\n3. For EACH file, critically ask:\n   - Does this code ACTUALLY do what the task required? (Re-read the task, compare line by line)\n   - Any stubs, TODOs, placeholders, hardcoded values? (`Grep` for TODO, FIXME, HACK, xxx)\n   - Logic errors? Trace the happy path AND the error path in your head.\n   - Anti-patterns? (`Grep` for `as any`, `@ts-ignore`, empty catch, console.log in changed files)\n   - Scope creep? Did the subagent touch things or add features NOT in the task spec?\n4. Cross-check every claim:\n   - Said \"Updated X\" \u2014 READ X. Actually updated, or just superficially touched?\n   - Said \"Added tests\" \u2014 READ the tests. Do they test REAL behavior or just `expect(true).toBe(true)`?\n   - Said \"Follows patterns\" \u2014 OPEN a reference file. Does it ACTUALLY match?\n\n**If you cannot explain what every changed line does, you have NOT reviewed it.**\n\n**PHASE 2: RUN AUTOMATED CHECKS (targeted, then broad)**\n\nNow that you understand the code, verify mechanically:\n1. `lsp_diagnostics` on EACH changed file \u2014 ZERO new errors\n2. Run tests for changed modules FIRST, then full suite\n3. Build/typecheck \u2014 exit 0\n\nIf Phase 1 found issues but Phase 2 passes: Phase 2 is WRONG. The code has bugs that tests don't cover. Fix the code.\n\n**PHASE 3: HANDS-ON QA \u2014 ACTUALLY RUN IT (MANDATORY for user-facing changes)**\n\nTests and linters CANNOT catch: visual bugs, wrong CLI output, broken user flows, API response shape issues.\n\n**If this task produced anything a user would SEE or INTERACT with, you MUST launch it and verify yourself.**\n\n- **Frontend/UI**: `/playwright` skill \u2014 load the page, click through the flow, check console. Verify: page loads, interactions work, console clean, responsive.\n- **TUI/CLI**: `interactive_bash` \u2014 run the command, try good input, try bad input, try --help. Verify: command runs, output correct, error messages helpful, edge inputs handled.\n- **API/Backend**: `Bash` with curl \u2014 hit the endpoint, check response body, send malformed input. Verify: returns 200, body correct, error cases return proper errors.\n- **Config/Build**: Actually start the service or import the config. Verify: loads without error, backward compatible.\n\nThis is NOT optional \"if applicable\". If the deliverable is user-facing and you did not run it, you are shipping untested work.\n\n**PHASE 4: GATE DECISION \u2014 Should you proceed to the next task?**\n\nAnswer honestly:\n1. Can I explain what EVERY changed line does? (If no \u2014 back to Phase 1)\n2. Did I SEE it work with my own eyes? (If user-facing and no \u2014 back to Phase 3)\n3. Am I confident nothing existing is broken? (If no \u2014 run broader tests)\n\nALL three must be YES. \"Probably\" = NO. \"I think so\" = NO. Investigate until CERTAIN.\n\n- **All 3 YES** \u2014 Proceed: mark task complete, move to next.\n- **Any NO** \u2014 Reject: resume session with `session_id`, fix the specific issue.\n- **Unsure** \u2014 Reject: \"unsure\" = \"no\". Investigate until you have a definitive answer.\n\n**DO NOT proceed to the next task until all 4 phases are complete and the gate passes.**";
 export declare const ORCHESTRATOR_DELEGATION_REQUIRED: string;
 export declare const SINGLE_TASK_DIRECTIVE: string;

package/dist/hooks/hashline-edit-diff-enhancer/hook.d.ts

@@ -0,0 +1,28 @@
+interface HashlineEditDiffEnhancerConfig {
+    hashline_edit?: {
+        enabled: boolean;
+    };
+}
+type BeforeInput = {
+    tool: string;
+    sessionID: string;
+    callID: string;
+};
+type BeforeOutput = {
+    args: Record<string, unknown>;
+};
+type AfterInput = {
+    tool: string;
+    sessionID: string;
+    callID: string;
+};
+type AfterOutput = {
+    title: string;
+    output: string;
+    metadata: Record<string, unknown>;
+};
+export declare function createHashlineEditDiffEnhancerHook(config: HashlineEditDiffEnhancerConfig): {
+    "tool.execute.before": (input: BeforeInput, output: BeforeOutput) => Promise<void>;
+    "tool.execute.after": (input: AfterInput, output: AfterOutput) => Promise<void>;
+};
+export {};

package/dist/hooks/hashline-edit-diff-enhancer/index.d.ts

@@ -0,0 +1 @@
+export { createHashlineEditDiffEnhancerHook } from "./hook";

package/dist/hooks/index.d.ts

@@ -13,6 +13,7 @@ export { createDirectoryReadmeInjectorHook } from "./directory-readme-injector";
 export { createEmptyTaskResponseDetectorHook } from "./empty-task-response-detector";
 export { createAnthropicContextWindowLimitRecoveryHook, type AnthropicContextWindowLimitRecoveryOptions } from "./anthropic-context-window-limit-recovery";
 export { createThinkModeHook } from "./think-mode";
+export { createModelFallbackHook, setPendingModelFallback, clearPendingModelFallback, type ModelFallbackState } from "./model-fallback/hook";
 export { createClaudeCodeHooksHook } from "./claude-code-hooks";
 export { createRulesInjectorHook } from "./rules-injector";
 export { createBackgroundNotificationHook } from "./background-notification";
@@ -24,10 +25,10 @@ export { createInteractiveBashSessionHook } from "./interactive-bash-session";
 export { createThinkingBlockValidatorHook } from "./thinking-block-validator";
 export { createCategorySkillReminderHook } from "./category-skill-reminder";
 export { createRalphLoopHook, type RalphLoopHook } from "./ralph-loop";
-export { createSisyphusGptHephaestusReminderHook } from "./sisyphus-gpt-hephaestus-reminder";
+export { createNoSisyphusGptHook } from "./no-sisyphus-gpt";
+export { createNoHephaestusNonGptHook } from "./no-hephaestus-non-gpt";
 export { createAutoSlashCommandHook } from "./auto-slash-command";
 export { createEditErrorRecoveryHook } from "./edit-error-recovery";
-export { createJsonErrorRecoveryHook } from "./json-error-recovery";
 export { createPrometheusMdOnlyHook } from "./prometheus-md-only";
 export { createSisyphusJuniorNotepadHook } from "./sisyphus-junior-notepad";
 export { createTaskResumeInfoHook } from "./task-resume-info";
@@ -41,5 +42,7 @@ export { createCompactionTodoPreserverHook } from "./compaction-todo-preserver";
 export { createUnstableAgentBabysitterHook } from "./unstable-agent-babysitter";
 export { createPreemptiveCompactionHook } from "./preemptive-compaction";
 export { createTasksTodowriteDisablerHook } from "./tasks-todowrite-disabler";
+export { createRuntimeFallbackHook, type RuntimeFallbackHook, type RuntimeFallbackOptions } from "./runtime-fallback";
 export { createWriteExistingFileGuardHook } from "./write-existing-file-guard";
 export { createHashlineReadEnhancerHook } from "./hashline-read-enhancer";
+export { createJsonErrorRecoveryHook, JSON_ERROR_TOOL_EXCLUDE_LIST, JSON_ERROR_PATTERNS, JSON_ERROR_REMINDER } from "./json-error-recovery";

package/dist/hooks/model-fallback/hook.d.ts

@@ -0,0 +1,60 @@
+import type { FallbackEntry } from "../../shared/model-requirements";
+import type { ChatMessageInput, ChatMessageHandlerOutput } from "../../plugin/chat-message";
+type FallbackToast = (input: {
+    title: string;
+    message: string;
+    variant?: "info" | "success" | "warning" | "error";
+    duration?: number;
+}) => void | Promise<void>;
+type FallbackCallback = (input: {
+    sessionID: string;
+    providerID: string;
+    modelID: string;
+    variant?: string;
+}) => void | Promise<void>;
+export type ModelFallbackState = {
+    providerID: string;
+    modelID: string;
+    fallbackChain: FallbackEntry[];
+    attemptCount: number;
+    pending: boolean;
+};
+export declare function setSessionFallbackChain(sessionID: string, fallbackChain: FallbackEntry[] | undefined): void;
+export declare function clearSessionFallbackChain(sessionID: string): void;
+/**
+ * Sets a pending model fallback for a session.
+ * Called when a model error is detected in session.error handler.
+ */
+export declare function setPendingModelFallback(sessionID: string, agentName: string, currentProviderID: string, currentModelID: string): boolean;
+/**
+ * Gets the next fallback model for a session.
+ * Increments attemptCount each time called.
+ */
+export declare function getNextFallback(sessionID: string): {
+    providerID: string;
+    modelID: string;
+    variant?: string;
+} | null;
+/**
+ * Clears the pending fallback for a session.
+ * Called after fallback is successfully applied.
+ */
+export declare function clearPendingModelFallback(sessionID: string): void;
+/**
+ * Checks if there's a pending fallback for a session.
+ */
+export declare function hasPendingModelFallback(sessionID: string): boolean;
+/**
+ * Gets the current fallback state for a session (for debugging).
+ */
+export declare function getFallbackState(sessionID: string): ModelFallbackState | undefined;
+/**
+ * Creates a chat.message hook that applies model fallbacks when pending.
+ */
+export declare function createModelFallbackHook(args?: {
+    toast?: FallbackToast;
+    onApplied?: FallbackCallback;
+}): {
+    "chat.message": (input: ChatMessageInput, output: ChatMessageHandlerOutput) => Promise<void>;
+};
+export {};

package/dist/hooks/no-hephaestus-non-gpt/hook.d.ts

@@ -0,0 +1,16 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+export declare function createNoHephaestusNonGptHook(ctx: PluginInput): {
+    "chat.message": (input: {
+        sessionID: string;
+        agent?: string;
+        model?: {
+            providerID: string;
+            modelID: string;
+        };
+    }, output?: {
+        message?: {
+            agent?: string;
+            [key: string]: unknown;
+        };
+    }) => Promise<void>;
+};

package/dist/hooks/no-hephaestus-non-gpt/index.d.ts

@@ -0,0 +1 @@
+export { createNoHephaestusNonGptHook } from "./hook";

package/dist/hooks/{sisyphus-gpt-hephaestus-reminder → no-sisyphus-gpt}/hook.d.ts

@@ -1,5 +1,5 @@
 import type { PluginInput } from "@opencode-ai/plugin";
-export declare function createSisyphusGptHephaestusReminderHook(ctx: PluginInput): {
+export declare function createNoSisyphusGptHook(ctx: PluginInput): {
     "chat.message": (input: {
         sessionID: string;
         agent?: string;
@@ -7,5 +7,10 @@ export declare function createSisyphusGptHephaestusReminderHook(ctx: PluginInput
             providerID: string;
             modelID: string;
         };
+    }, output?: {
+        message?: {
+            agent?: string;
+            [key: string]: unknown;
+        };
     }) => Promise<void>;
 };

package/dist/hooks/no-sisyphus-gpt/index.d.ts

@@ -0,0 +1 @@
+export { createNoSisyphusGptHook } from "./hook";

package/dist/hooks/ralph-loop/command-arguments.d.ts

@@ -0,0 +1,8 @@
+export type RalphLoopStrategy = "reset" | "continue";
+export type ParsedRalphLoopArguments = {
+    prompt: string;
+    maxIterations?: number;
+    completionPromise?: string;
+    strategy?: RalphLoopStrategy;
+};
+export declare function parseRalphLoopArguments(rawArguments: string): ParsedRalphLoopArguments;

package/dist/hooks/ralph-loop/continuation-prompt-injector.d.ts

@@ -4,4 +4,5 @@ export declare function injectContinuationPrompt(ctx: PluginInput, options: {
     prompt: string;
     directory: string;
     apiTimeoutMs: number;
+    inheritFromSessionID?: string;
 }): Promise<void>;

package/dist/hooks/ralph-loop/iteration-continuation.d.ts

@@ -0,0 +1,12 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+import type { RalphLoopState } from "./types";
+type ContinuationOptions = {
+    directory: string;
+    apiTimeoutMs: number;
+    previousSessionID: string;
+    loopState: {
+        setSessionID: (sessionID: string) => RalphLoopState | null;
+    };
+};
+export declare function continueIteration(ctx: PluginInput, state: RalphLoopState, options: ContinuationOptions): Promise<void>;
+export {};

package/dist/hooks/ralph-loop/loop-state-controller.d.ts

@@ -8,9 +8,11 @@ export declare function createLoopStateController(options: {
         maxIterations?: number;
         completionPromise?: string;
         ultrawork?: boolean;
+        strategy?: "reset" | "continue";
     }): boolean;
     cancelLoop(sessionID: string): boolean;
     getState(): RalphLoopState | null;
     clear(): boolean;
     incrementIteration(): RalphLoopState | null;
+    setSessionID(sessionID: string): RalphLoopState | null;
 };

package/dist/hooks/ralph-loop/ralph-loop-event-handler.d.ts

@@ -9,6 +9,7 @@ type LoopStateController = {
     getState: () => RalphLoopState | null;
     clear: () => boolean;
     incrementIteration: () => RalphLoopState | null;
+    setSessionID: (sessionID: string) => RalphLoopState | null;
 };
 type RalphLoopEventHandlerOptions = {
     directory: string;

package/dist/hooks/ralph-loop/ralph-loop-hook.d.ts

@@ -11,6 +11,7 @@ export interface RalphLoopHook {
         maxIterations?: number;
         completionPromise?: string;
         ultrawork?: boolean;
+        strategy?: "reset" | "continue";
     }) => boolean;
     cancelLoop: (sessionID: string) => boolean;
     getState: () => RalphLoopState | null;

package/dist/hooks/ralph-loop/session-reset-strategy.d.ts

@@ -0,0 +1,3 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+export declare function createIterationSession(ctx: PluginInput, parentSessionID: string, directory: string): Promise<string | null>;
+export declare function selectSessionInTui(client: PluginInput["client"], sessionID: string): Promise<boolean>;

package/dist/hooks/ralph-loop/types.d.ts

@@ -8,6 +8,7 @@ export interface RalphLoopState {
     prompt: string;
     session_id?: string;
     ultrawork?: boolean;
+    strategy?: "reset" | "continue";
 }
 export interface RalphLoopOptions {
     config?: RalphLoopConfig;

package/dist/hooks/runtime-fallback/agent-resolver.d.ts

@@ -0,0 +1,5 @@
+export declare const AGENT_NAMES: string[];
+export declare const agentPattern: RegExp;
+export declare function detectAgentFromSession(sessionID: string): string | undefined;
+export declare function normalizeAgentName(agent: string | undefined): string | undefined;
+export declare function resolveAgentForSession(sessionID: string, eventAgent?: string): string | undefined;

package/dist/hooks/runtime-fallback/auto-retry.d.ts

@@ -0,0 +1,10 @@
+import type { HookDeps } from "./types";
+export declare function createAutoRetryHelpers(deps: HookDeps): {
+    abortSessionRequest: (sessionID: string, source: string) => Promise<void>;
+    clearSessionFallbackTimeout: (sessionID: string) => void;
+    scheduleSessionFallbackTimeout: (sessionID: string, resolvedAgent?: string) => void;
+    autoRetryWithFallback: (sessionID: string, newModel: string, resolvedAgent: string | undefined, source: string) => Promise<void>;
+    resolveAgentForSessionFromContext: (sessionID: string, eventAgent?: string) => Promise<string | undefined>;
+    cleanupStaleSessions: () => void;
+};
+export type AutoRetryHelpers = ReturnType<typeof createAutoRetryHelpers>;

package/dist/hooks/runtime-fallback/chat-message-handler.d.ts

@@ -0,0 +1,20 @@
+import type { HookDeps } from "./types";
+export declare function createChatMessageHandler(deps: HookDeps): (input: {
+    sessionID: string;
+    agent?: string;
+    model?: {
+        providerID: string;
+        modelID: string;
+    };
+}, output: {
+    message: {
+        model?: {
+            providerID: string;
+            modelID: string;
+        };
+    };
+    parts?: Array<{
+        type: string;
+        text?: string;
+    }>;
+}) => Promise<void>;