oh-my-opencode 3.2.4 → 3.3.0

package/dist/cli/run/agent-resolver.d.ts

@@ -0,0 +1,5 @@
+import type { RunOptions } from "./types";
+import type { OhMyOpenCodeConfig } from "../../config";
+type EnvVars = Record<string, string | undefined>;
+export declare const resolveRunAgent: (options: RunOptions, pluginConfig: OhMyOpenCodeConfig, env?: EnvVars) => string;
+export {};

package/dist/cli/run/events.d.ts

@@ -9,6 +9,8 @@ export interface EventState {
     currentTool: string | null;
     /** Set to true when the main session has produced meaningful work (text, tool call, or tool result) */
     hasReceivedMeaningfulWork: boolean;
+    /** Count of assistant messages for the main session */
+    messageCount: number;
 }
 export declare function createEventState(): EventState;
 export declare function processEvents(ctx: RunContext, stream: AsyncIterable<unknown>, state: EventState): Promise<void>;

package/dist/cli/run/index.d.ts

@@ -1,2 +1,7 @@
 export { run } from "./runner";
-export type { RunOptions, RunContext } from "./types";
+export { resolveRunAgent } from "./agent-resolver";
+export { createServerConnection } from "./server-connection";
+export { resolveSession } from "./session-resolver";
+export { createJsonOutputManager } from "./json-output";
+export { executeOnCompleteHook } from "./on-complete-hook";
+export type { RunOptions, RunContext, RunResult, ServerConnection } from "./types";

package/dist/cli/run/json-output.d.ts

@@ -0,0 +1,12 @@
+import type { RunResult } from "./types";
+export interface JsonOutputManager {
+    redirectToStderr: () => void;
+    restore: () => void;
+    emitResult: (result: RunResult) => void;
+}
+interface JsonOutputManagerOptions {
+    stdout?: NodeJS.WriteStream;
+    stderr?: NodeJS.WriteStream;
+}
+export declare function createJsonOutputManager(options?: JsonOutputManagerOptions): JsonOutputManager;
+export {};

package/dist/cli/run/on-complete-hook.d.ts

@@ -0,0 +1,7 @@
+export declare function executeOnCompleteHook(options: {
+    command: string;
+    sessionId: string;
+    exitCode: number;
+    durationMs: number;
+    messageCount: number;
+}): Promise<void>;

package/dist/cli/run/runner.d.ts

@@ -1,6 +1,4 @@
 import type { RunOptions } from "./types";
-import type { OhMyOpenCodeConfig } from "../../config";
-type EnvVars = Record<string, string | undefined>;
-export declare const resolveRunAgent: (options: RunOptions, pluginConfig: OhMyOpenCodeConfig, env?: EnvVars) => string;
+import { resolveRunAgent } from "./agent-resolver";
+export { resolveRunAgent };
 export declare function run(options: RunOptions): Promise<number>;
-export {};

package/dist/cli/run/server-connection.d.ts

@@ -0,0 +1,6 @@
+import type { ServerConnection } from "./types";
+export declare function createServerConnection(options: {
+    port?: number;
+    attach?: string;
+    signal: AbortSignal;
+}): Promise<ServerConnection>;

package/dist/cli/run/session-resolver.d.ts

@@ -0,0 +1,5 @@
+import type { OpencodeClient } from "./types";
+export declare function resolveSession(options: {
+    client: OpencodeClient;
+    sessionId?: string;
+}): Promise<string>;

package/dist/cli/run/types.d.ts

@@ -1,9 +1,26 @@
 import type { OpencodeClient } from "@opencode-ai/sdk";
+export type { OpencodeClient };
 export interface RunOptions {
     message: string;
     agent?: string;
     directory?: string;
     timeout?: number;
+    port?: number;
+    attach?: string;
+    onComplete?: string;
+    json?: boolean;
+    sessionId?: string;
+}
+export interface ServerConnection {
+    client: OpencodeClient;
+    cleanup: () => void;
+}
+export interface RunResult {
+    sessionId: string;
+    success: boolean;
+    durationMs: number;
+    messageCount: number;
+    summary: string;
 }
 export interface RunContext {
     client: OpencodeClient;

package/dist/config/schema.d.ts

@@ -75,6 +75,7 @@ export declare const HookNameSchema: z.ZodEnum<{
     "ralph-loop": "ralph-loop";
     "category-skill-reminder": "category-skill-reminder";
     "compaction-context-injector": "compaction-context-injector";
+    "compaction-todo-preserver": "compaction-todo-preserver";
     "claude-code-hooks": "claude-code-hooks";
     "auto-slash-command": "auto-slash-command";
     "edit-error-recovery": "edit-error-recovery";
@@ -88,6 +89,7 @@ export declare const HookNameSchema: z.ZodEnum<{
     "stop-continuation-guard": "stop-continuation-guard";
     "tasks-todowrite-disabler": "tasks-todowrite-disabler";
     "write-existing-file-guard": "write-existing-file-guard";
+    "anthropic-effort": "anthropic-effort";
 }>;
 export declare const BuiltinCommandNameSchema: z.ZodEnum<{
     "ralph-loop": "ralph-loop";
@@ -136,6 +138,11 @@ export declare const AgentOverrideConfigSchema: z.ZodObject<{
             deny: "deny";
             ask: "ask";
         }>>;
+        task: z.ZodOptional<z.ZodEnum<{
+            allow: "allow";
+            deny: "deny";
+            ask: "ask";
+        }>>;
         doom_loop: z.ZodOptional<z.ZodEnum<{
             allow: "allow";
             deny: "deny";
@@ -207,6 +214,11 @@ export declare const AgentOverridesSchema: z.ZodObject<{
                 deny: "deny";
                 ask: "ask";
             }>>;
+            task: z.ZodOptional<z.ZodEnum<{
+                allow: "allow";
+                deny: "deny";
+                ask: "ask";
+            }>>;
             doom_loop: z.ZodOptional<z.ZodEnum<{
                 allow: "allow";
                 deny: "deny";
@@ -277,6 +289,11 @@ export declare const AgentOverridesSchema: z.ZodObject<{
                 deny: "deny";
                 ask: "ask";
             }>>;
+            task: z.ZodOptional<z.ZodEnum<{
+                allow: "allow";
+                deny: "deny";
+                ask: "ask";
+            }>>;
             doom_loop: z.ZodOptional<z.ZodEnum<{
                 allow: "allow";
                 deny: "deny";
@@ -347,6 +364,11 @@ export declare const AgentOverridesSchema: z.ZodObject<{
                 deny: "deny";
                 ask: "ask";
             }>>;
+            task: z.ZodOptional<z.ZodEnum<{
+                allow: "allow";
+                deny: "deny";
+                ask: "ask";
+            }>>;
             doom_loop: z.ZodOptional<z.ZodEnum<{
                 allow: "allow";
                 deny: "deny";
@@ -417,6 +439,11 @@ export declare const AgentOverridesSchema: z.ZodObject<{
                 deny: "deny";
                 ask: "ask";
             }>>;
+            task: z.ZodOptional<z.ZodEnum<{
+                allow: "allow";
+                deny: "deny";
+                ask: "ask";
+            }>>;
             doom_loop: z.ZodOptional<z.ZodEnum<{
                 allow: "allow";
                 deny: "deny";
@@ -487,6 +514,11 @@ export declare const AgentOverridesSchema: z.ZodObject<{
                 deny: "deny";
                 ask: "ask";
             }>>;
+            task: z.ZodOptional<z.ZodEnum<{
+                allow: "allow";
+                deny: "deny";
+                ask: "ask";
+            }>>;
             doom_loop: z.ZodOptional<z.ZodEnum<{
                 allow: "allow";
                 deny: "deny";
@@ -557,6 +589,11 @@ export declare const AgentOverridesSchema: z.ZodObject<{
                 deny: "deny";
                 ask: "ask";
             }>>;
+            task: z.ZodOptional<z.ZodEnum<{
+                allow: "allow";
+                deny: "deny";
+                ask: "ask";
+            }>>;
             doom_loop: z.ZodOptional<z.ZodEnum<{
                 allow: "allow";
                 deny: "deny";
@@ -627,6 +664,11 @@ export declare const AgentOverridesSchema: z.ZodObject<{
                 deny: "deny";
                 ask: "ask";
             }>>;
+            task: z.ZodOptional<z.ZodEnum<{
+                allow: "allow";
+                deny: "deny";
+                ask: "ask";
+            }>>;
             doom_loop: z.ZodOptional<z.ZodEnum<{
                 allow: "allow";
                 deny: "deny";
@@ -697,6 +739,11 @@ export declare const AgentOverridesSchema: z.ZodObject<{
                 deny: "deny";
                 ask: "ask";
             }>>;
+            task: z.ZodOptional<z.ZodEnum<{
+                allow: "allow";
+                deny: "deny";
+                ask: "ask";
+            }>>;
             doom_loop: z.ZodOptional<z.ZodEnum<{
                 allow: "allow";
                 deny: "deny";
@@ -767,6 +814,11 @@ export declare const AgentOverridesSchema: z.ZodObject<{
                 deny: "deny";
                 ask: "ask";
             }>>;
+            task: z.ZodOptional<z.ZodEnum<{
+                allow: "allow";
+                deny: "deny";
+                ask: "ask";
+            }>>;
             doom_loop: z.ZodOptional<z.ZodEnum<{
                 allow: "allow";
                 deny: "deny";
@@ -837,6 +889,11 @@ export declare const AgentOverridesSchema: z.ZodObject<{
                 deny: "deny";
                 ask: "ask";
             }>>;
+            task: z.ZodOptional<z.ZodEnum<{
+                allow: "allow";
+                deny: "deny";
+                ask: "ask";
+            }>>;
             doom_loop: z.ZodOptional<z.ZodEnum<{
                 allow: "allow";
                 deny: "deny";
@@ -907,6 +964,11 @@ export declare const AgentOverridesSchema: z.ZodObject<{
                 deny: "deny";
                 ask: "ask";
             }>>;
+            task: z.ZodOptional<z.ZodEnum<{
+                allow: "allow";
+                deny: "deny";
+                ask: "ask";
+            }>>;
             doom_loop: z.ZodOptional<z.ZodEnum<{
                 allow: "allow";
                 deny: "deny";
@@ -977,6 +1039,11 @@ export declare const AgentOverridesSchema: z.ZodObject<{
                 deny: "deny";
                 ask: "ask";
             }>>;
+            task: z.ZodOptional<z.ZodEnum<{
+                allow: "allow";
+                deny: "deny";
+                ask: "ask";
+            }>>;
             doom_loop: z.ZodOptional<z.ZodEnum<{
                 allow: "allow";
                 deny: "deny";
@@ -1047,6 +1114,11 @@ export declare const AgentOverridesSchema: z.ZodObject<{
                 deny: "deny";
                 ask: "ask";
             }>>;
+            task: z.ZodOptional<z.ZodEnum<{
+                allow: "allow";
+                deny: "deny";
+                ask: "ask";
+            }>>;
             doom_loop: z.ZodOptional<z.ZodEnum<{
                 allow: "allow";
                 deny: "deny";
@@ -1117,6 +1189,11 @@ export declare const AgentOverridesSchema: z.ZodObject<{
                 deny: "deny";
                 ask: "ask";
             }>>;
+            task: z.ZodOptional<z.ZodEnum<{
+                allow: "allow";
+                deny: "deny";
+                ask: "ask";
+            }>>;
             doom_loop: z.ZodOptional<z.ZodEnum<{
                 allow: "allow";
                 deny: "deny";
@@ -1294,6 +1371,8 @@ export declare const ExperimentalConfigSchema: z.ZodObject<{
         }, z.core.$strip>>;
     }, z.core.$strip>>;
     task_system: z.ZodOptional<z.ZodBoolean>;
+    plugin_load_timeout_ms: z.ZodOptional<z.ZodNumber>;
+    safe_hook_creation: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 export declare const SkillSourceSchema: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
     path: z.ZodString;
@@ -1368,7 +1447,7 @@ export declare const BabysittingConfigSchema: z.ZodObject<{
     timeout_ms: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strip>;
 export declare const GitMasterConfigSchema: z.ZodObject<{
-    commit_footer: z.ZodDefault<z.ZodBoolean>;
+    commit_footer: z.ZodDefault<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
     include_co_authored_by: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strip>;
 export declare const BrowserAutomationProviderSchema: z.ZodEnum<{
@@ -1478,6 +1557,7 @@ export declare const OhMyOpenCodeConfigSchema: z.ZodObject<{
         "ralph-loop": "ralph-loop";
         "category-skill-reminder": "category-skill-reminder";
         "compaction-context-injector": "compaction-context-injector";
+        "compaction-todo-preserver": "compaction-todo-preserver";
         "claude-code-hooks": "claude-code-hooks";
         "auto-slash-command": "auto-slash-command";
         "edit-error-recovery": "edit-error-recovery";
@@ -1491,6 +1571,7 @@ export declare const OhMyOpenCodeConfigSchema: z.ZodObject<{
         "stop-continuation-guard": "stop-continuation-guard";
         "tasks-todowrite-disabler": "tasks-todowrite-disabler";
         "write-existing-file-guard": "write-existing-file-guard";
+        "anthropic-effort": "anthropic-effort";
     }>>>;
     disabled_commands: z.ZodOptional<z.ZodArray<z.ZodEnum<{
         "ralph-loop": "ralph-loop";
@@ -1541,6 +1622,11 @@ export declare const OhMyOpenCodeConfigSchema: z.ZodObject<{
                     deny: "deny";
                     ask: "ask";
                 }>>;
+                task: z.ZodOptional<z.ZodEnum<{
+                    allow: "allow";
+                    deny: "deny";
+                    ask: "ask";
+                }>>;
                 doom_loop: z.ZodOptional<z.ZodEnum<{
                     allow: "allow";
                     deny: "deny";
@@ -1611,6 +1697,11 @@ export declare const OhMyOpenCodeConfigSchema: z.ZodObject<{
                     deny: "deny";
                     ask: "ask";
                 }>>;
+                task: z.ZodOptional<z.ZodEnum<{
+                    allow: "allow";
+                    deny: "deny";
+                    ask: "ask";
+                }>>;
                 doom_loop: z.ZodOptional<z.ZodEnum<{
                     allow: "allow";
                     deny: "deny";
@@ -1681,6 +1772,11 @@ export declare const OhMyOpenCodeConfigSchema: z.ZodObject<{
                     deny: "deny";
                     ask: "ask";
                 }>>;
+                task: z.ZodOptional<z.ZodEnum<{
+                    allow: "allow";
+                    deny: "deny";
+                    ask: "ask";
+                }>>;
                 doom_loop: z.ZodOptional<z.ZodEnum<{
                     allow: "allow";
                     deny: "deny";
@@ -1751,6 +1847,11 @@ export declare const OhMyOpenCodeConfigSchema: z.ZodObject<{
                     deny: "deny";
                     ask: "ask";
                 }>>;
+                task: z.ZodOptional<z.ZodEnum<{
+                    allow: "allow";
+                    deny: "deny";
+                    ask: "ask";
+                }>>;
                 doom_loop: z.ZodOptional<z.ZodEnum<{
                     allow: "allow";
                     deny: "deny";
@@ -1821,6 +1922,11 @@ export declare const OhMyOpenCodeConfigSchema: z.ZodObject<{
                     deny: "deny";
                     ask: "ask";
                 }>>;
+                task: z.ZodOptional<z.ZodEnum<{
+                    allow: "allow";
+                    deny: "deny";
+                    ask: "ask";
+                }>>;
                 doom_loop: z.ZodOptional<z.ZodEnum<{
                     allow: "allow";
                     deny: "deny";
@@ -1891,6 +1997,11 @@ export declare const OhMyOpenCodeConfigSchema: z.ZodObject<{
                     deny: "deny";
                     ask: "ask";
                 }>>;
+                task: z.ZodOptional<z.ZodEnum<{
+                    allow: "allow";
+                    deny: "deny";
+                    ask: "ask";
+                }>>;
                 doom_loop: z.ZodOptional<z.ZodEnum<{
                     allow: "allow";
                     deny: "deny";
@@ -1961,6 +2072,11 @@ export declare const OhMyOpenCodeConfigSchema: z.ZodObject<{
                     deny: "deny";
                     ask: "ask";
                 }>>;
+                task: z.ZodOptional<z.ZodEnum<{
+                    allow: "allow";
+                    deny: "deny";
+                    ask: "ask";
+                }>>;
                 doom_loop: z.ZodOptional<z.ZodEnum<{
                     allow: "allow";
                     deny: "deny";
@@ -2031,6 +2147,11 @@ export declare const OhMyOpenCodeConfigSchema: z.ZodObject<{
                     deny: "deny";
                     ask: "ask";
                 }>>;
+                task: z.ZodOptional<z.ZodEnum<{
+                    allow: "allow";
+                    deny: "deny";
+                    ask: "ask";
+                }>>;
                 doom_loop: z.ZodOptional<z.ZodEnum<{
                     allow: "allow";
                     deny: "deny";
@@ -2101,6 +2222,11 @@ export declare const OhMyOpenCodeConfigSchema: z.ZodObject<{
                     deny: "deny";
                     ask: "ask";
                 }>>;
+                task: z.ZodOptional<z.ZodEnum<{
+                    allow: "allow";
+                    deny: "deny";
+                    ask: "ask";
+                }>>;
                 doom_loop: z.ZodOptional<z.ZodEnum<{
                     allow: "allow";
                     deny: "deny";
@@ -2171,6 +2297,11 @@ export declare const OhMyOpenCodeConfigSchema: z.ZodObject<{
                     deny: "deny";
                     ask: "ask";
                 }>>;
+                task: z.ZodOptional<z.ZodEnum<{
+                    allow: "allow";
+                    deny: "deny";
+                    ask: "ask";
+                }>>;
                 doom_loop: z.ZodOptional<z.ZodEnum<{
                     allow: "allow";
                     deny: "deny";
@@ -2241,6 +2372,11 @@ export declare const OhMyOpenCodeConfigSchema: z.ZodObject<{
                     deny: "deny";
                     ask: "ask";
                 }>>;
+                task: z.ZodOptional<z.ZodEnum<{
+                    allow: "allow";
+                    deny: "deny";
+                    ask: "ask";
+                }>>;
                 doom_loop: z.ZodOptional<z.ZodEnum<{
                     allow: "allow";
                     deny: "deny";
@@ -2311,6 +2447,11 @@ export declare const OhMyOpenCodeConfigSchema: z.ZodObject<{
                     deny: "deny";
                     ask: "ask";
                 }>>;
+                task: z.ZodOptional<z.ZodEnum<{
+                    allow: "allow";
+                    deny: "deny";
+                    ask: "ask";
+                }>>;
                 doom_loop: z.ZodOptional<z.ZodEnum<{
                     allow: "allow";
                     deny: "deny";
@@ -2381,6 +2522,11 @@ export declare const OhMyOpenCodeConfigSchema: z.ZodObject<{
                     deny: "deny";
                     ask: "ask";
                 }>>;
+                task: z.ZodOptional<z.ZodEnum<{
+                    allow: "allow";
+                    deny: "deny";
+                    ask: "ask";
+                }>>;
                 doom_loop: z.ZodOptional<z.ZodEnum<{
                     allow: "allow";
                     deny: "deny";
@@ -2451,6 +2597,11 @@ export declare const OhMyOpenCodeConfigSchema: z.ZodObject<{
                     deny: "deny";
                     ask: "ask";
                 }>>;
+                task: z.ZodOptional<z.ZodEnum<{
+                    allow: "allow";
+                    deny: "deny";
+                    ask: "ask";
+                }>>;
                 doom_loop: z.ZodOptional<z.ZodEnum<{
                     allow: "allow";
                     deny: "deny";
@@ -2563,6 +2714,8 @@ export declare const OhMyOpenCodeConfigSchema: z.ZodObject<{
             }, z.core.$strip>>;
         }, z.core.$strip>>;
         task_system: z.ZodOptional<z.ZodBoolean>;
+        plugin_load_timeout_ms: z.ZodOptional<z.ZodNumber>;
+        safe_hook_creation: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>>;
     auto_update: z.ZodOptional<z.ZodBoolean>;
     skills: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodIntersection<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
@@ -2605,7 +2758,7 @@ export declare const OhMyOpenCodeConfigSchema: z.ZodObject<{
         timeout_ms: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strip>>;
     git_master: z.ZodOptional<z.ZodObject<{
-        commit_footer: z.ZodDefault<z.ZodBoolean>;
+        commit_footer: z.ZodDefault<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
         include_co_authored_by: z.ZodDefault<z.ZodBoolean>;
     }, z.core.$strip>>;
     browser_automation_engine: z.ZodOptional<z.ZodObject<{
@@ -2641,6 +2794,7 @@ export declare const OhMyOpenCodeConfigSchema: z.ZodObject<{
             claude_code_compat: z.ZodDefault<z.ZodBoolean>;
         }, z.core.$strip>>;
     }, z.core.$strip>>;
+    _migrations: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>;
 export type OhMyOpenCodeConfig = z.infer<typeof OhMyOpenCodeConfigSchema>;
 export type AgentOverrideConfig = z.infer<typeof AgentOverrideConfigSchema>;

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

@@ -37,6 +37,7 @@ export declare class BackgroundManager {
     private queuesByKey;
     private processingKeys;
     private completionTimers;
+    private idleDeferralTimers;
     constructor(ctx: PluginInput, config?: BackgroundTaskConfig, options?: {
         tmuxConfig?: TmuxConfig;
         onSubagentSessionCreated?: OnSubagentSessionCreated;
@@ -51,7 +52,7 @@ export declare class BackgroundManager {
     findBySession(sessionID: string): BackgroundTask | undefined;
     private getConcurrencyKeyFromInput;
     /**
-     * Track a task created elsewhere (e.g., from delegate_task) for notification tracking.
+     * Track a task created elsewhere (e.g., from task) for notification tracking.
      * This allows tasks created by other tools to receive the same toast/prompt notifications.
      */
     trackTask(input: {

package/dist/features/builtin-commands/templates/init-deep.d.ts

@@ -1 +1 @@
-export declare const INIT_DEEP_TEMPLATE = "# /init-deep\n\nGenerate hierarchical AGENTS.md files. Root + complexity-scored subdirectories.\n\n## Usage\n\n```\n/init-deep                      # Update mode: modify existing + create new where warranted\n/init-deep --create-new         # Read existing \u2192 remove all \u2192 regenerate from scratch\n/init-deep --max-depth=2        # Limit directory depth (default: 3)\n```\n\n---\n\n## Workflow (High-Level)\n\n1. **Discovery + Analysis** (concurrent)\n   - Fire background explore agents immediately\n   - Main session: bash structure + LSP codemap + read existing AGENTS.md\n2. **Score & Decide** - Determine AGENTS.md locations from merged findings\n3. **Generate** - Root first, then subdirs in parallel\n4. **Review** - Deduplicate, trim, validate\n\n<critical>\n**TodoWrite ALL phases. Mark in_progress \u2192 completed in real-time.**\n```\nTodoWrite([\n  { id: \"discovery\", content: \"Fire explore agents + LSP codemap + read existing\", status: \"pending\", priority: \"high\" },\n  { id: \"scoring\", content: \"Score directories, determine locations\", status: \"pending\", priority: \"high\" },\n  { id: \"generate\", content: \"Generate AGENTS.md files (root + subdirs)\", status: \"pending\", priority: \"high\" },\n  { id: \"review\", content: \"Deduplicate, validate, trim\", status: \"pending\", priority: \"medium\" }\n])\n```\n</critical>\n\n---\n\n## Phase 1: Discovery + Analysis (Concurrent)\n\n**Mark \"discovery\" as in_progress.**\n\n### Fire Background Explore Agents IMMEDIATELY\n\nDon't wait\u2014these run async while main session works.\n\n```\n// Fire all at once, collect results later\ndelegate_task(agent=\"explore\", prompt=\"Project structure: PREDICT standard patterns for detected language \u2192 REPORT deviations only\")\ndelegate_task(agent=\"explore\", prompt=\"Entry points: FIND main files \u2192 REPORT non-standard organization\")\ndelegate_task(agent=\"explore\", prompt=\"Conventions: FIND config files (.eslintrc, pyproject.toml, .editorconfig) \u2192 REPORT project-specific rules\")\ndelegate_task(agent=\"explore\", prompt=\"Anti-patterns: FIND 'DO NOT', 'NEVER', 'ALWAYS', 'DEPRECATED' comments \u2192 LIST forbidden patterns\")\ndelegate_task(agent=\"explore\", prompt=\"Build/CI: FIND .github/workflows, Makefile \u2192 REPORT non-standard patterns\")\ndelegate_task(agent=\"explore\", prompt=\"Test patterns: FIND test configs, test structure \u2192 REPORT unique conventions\")\n```\n\n<dynamic-agents>\n**DYNAMIC AGENT SPAWNING**: After bash analysis, spawn ADDITIONAL explore agents based on project scale:\n\n| Factor | Threshold | Additional Agents |\n|--------|-----------|-------------------|\n| **Total files** | >100 | +1 per 100 files |\n| **Total lines** | >10k | +1 per 10k lines |\n| **Directory depth** | \u22654 | +2 for deep exploration |\n| **Large files (>500 lines)** | >10 files | +1 for complexity hotspots |\n| **Monorepo** | detected | +1 per package/workspace |\n| **Multiple languages** | >1 | +1 per language |\n\n```bash\n# Measure project scale first\ntotal_files=$(find . -type f -not -path '*/node_modules/*' -not -path '*/.git/*' | wc -l)\ntotal_lines=$(find . -type f \\( -name \"*.ts\" -o -name \"*.py\" -o -name \"*.go\" \\) -not -path '*/node_modules/*' -exec wc -l {} + 2>/dev/null | tail -1 | awk '{print $1}')\nlarge_files=$(find . -type f \\( -name \"*.ts\" -o -name \"*.py\" \\) -not -path '*/node_modules/*' -exec wc -l {} + 2>/dev/null | awk '$1 > 500 {count++} END {print count+0}')\nmax_depth=$(find . -type d -not -path '*/node_modules/*' -not -path '*/.git/*' | awk -F/ '{print NF}' | sort -rn | head -1)\n```\n\nExample spawning:\n```\n// 500 files, 50k lines, depth 6, 15 large files \u2192 spawn 5+5+2+1 = 13 additional agents\ndelegate_task(agent=\"explore\", prompt=\"Large file analysis: FIND files >500 lines, REPORT complexity hotspots\")\ndelegate_task(agent=\"explore\", prompt=\"Deep modules at depth 4+: FIND hidden patterns, internal conventions\")\ndelegate_task(agent=\"explore\", prompt=\"Cross-cutting concerns: FIND shared utilities across directories\")\n// ... more based on calculation\n```\n</dynamic-agents>\n\n### Main Session: Concurrent Analysis\n\n**While background agents run**, main session does:\n\n#### 1. Bash Structural Analysis\n```bash\n# Directory depth + file counts\nfind . -type d -not -path '*/\\.*' -not -path '*/node_modules/*' -not -path '*/venv/*' -not -path '*/dist/*' -not -path '*/build/*' | awk -F/ '{print NF-1}' | sort -n | uniq -c\n\n# Files per directory (top 30)\nfind . -type f -not -path '*/\\.*' -not -path '*/node_modules/*' | sed 's|/[^/]*$||' | sort | uniq -c | sort -rn | head -30\n\n# Code concentration by extension\nfind . -type f \\( -name \"*.py\" -o -name \"*.ts\" -o -name \"*.tsx\" -o -name \"*.js\" -o -name \"*.go\" -o -name \"*.rs\" \\) -not -path '*/node_modules/*' | sed 's|/[^/]*$||' | sort | uniq -c | sort -rn | head -20\n\n# Existing AGENTS.md / CLAUDE.md\nfind . -type f \\( -name \"AGENTS.md\" -o -name \"CLAUDE.md\" \\) -not -path '*/node_modules/*' 2>/dev/null\n```\n\n#### 2. Read Existing AGENTS.md\n```\nFor each existing file found:\n  Read(filePath=file)\n  Extract: key insights, conventions, anti-patterns\n  Store in EXISTING_AGENTS map\n```\n\nIf `--create-new`: Read all existing first (preserve context) \u2192 then delete all \u2192 regenerate.\n\n#### 3. LSP Codemap (if available)\n```\nLspServers()  # Check availability\n\n# Entry points (parallel)\nLspDocumentSymbols(filePath=\"src/index.ts\")\nLspDocumentSymbols(filePath=\"main.py\")\n\n# Key symbols (parallel)\nLspWorkspaceSymbols(filePath=\".\", query=\"class\")\nLspWorkspaceSymbols(filePath=\".\", query=\"interface\")\nLspWorkspaceSymbols(filePath=\".\", query=\"function\")\n\n# Centrality for top exports\nLspFindReferences(filePath=\"...\", line=X, character=Y)\n```\n\n**LSP Fallback**: If unavailable, rely on explore agents + AST-grep.\n\n### Collect Background Results\n\n```\n// After main session analysis done, collect all task results\nfor each task_id: background_output(task_id=\"...\")\n```\n\n**Merge: bash + LSP + existing + explore findings. Mark \"discovery\" as completed.**\n\n---\n\n## Phase 2: Scoring & Location Decision\n\n**Mark \"scoring\" as in_progress.**\n\n### Scoring Matrix\n\n| Factor | Weight | High Threshold | Source |\n|--------|--------|----------------|--------|\n| File count | 3x | >20 | bash |\n| Subdir count | 2x | >5 | bash |\n| Code ratio | 2x | >70% | bash |\n| Unique patterns | 1x | Has own config | explore |\n| Module boundary | 2x | Has index.ts/__init__.py | bash |\n| Symbol density | 2x | >30 symbols | LSP |\n| Export count | 2x | >10 exports | LSP |\n| Reference centrality | 3x | >20 refs | LSP |\n\n### Decision Rules\n\n| Score | Action |\n|-------|--------|\n| **Root (.)** | ALWAYS create |\n| **>15** | Create AGENTS.md |\n| **8-15** | Create if distinct domain |\n| **<8** | Skip (parent covers) |\n\n### Output\n```\nAGENTS_LOCATIONS = [\n  { path: \".\", type: \"root\" },\n  { path: \"src/hooks\", score: 18, reason: \"high complexity\" },\n  { path: \"src/api\", score: 12, reason: \"distinct domain\" }\n]\n```\n\n**Mark \"scoring\" as completed.**\n\n---\n\n## Phase 3: Generate AGENTS.md\n\n**Mark \"generate\" as in_progress.**\n\n### Root AGENTS.md (Full Treatment)\n\n```markdown\n# PROJECT KNOWLEDGE BASE\n\n**Generated:** {TIMESTAMP}\n**Commit:** {SHORT_SHA}\n**Branch:** {BRANCH}\n\n## OVERVIEW\n{1-2 sentences: what + core stack}\n\n## STRUCTURE\n\\`\\`\\`\n{root}/\n\u251C\u2500\u2500 {dir}/    # {non-obvious purpose only}\n\u2514\u2500\u2500 {entry}\n\\`\\`\\`\n\n## WHERE TO LOOK\n| Task | Location | Notes |\n|------|----------|-------|\n\n## CODE MAP\n{From LSP - skip if unavailable or project <10 files}\n\n| Symbol | Type | Location | Refs | Role |\n|--------|------|----------|------|------|\n\n## CONVENTIONS\n{ONLY deviations from standard}\n\n## ANTI-PATTERNS (THIS PROJECT)\n{Explicitly forbidden here}\n\n## UNIQUE STYLES\n{Project-specific}\n\n## COMMANDS\n\\`\\`\\`bash\n{dev/test/build}\n\\`\\`\\`\n\n## NOTES\n{Gotchas}\n```\n\n**Quality gates**: 50-150 lines, no generic advice, no obvious info.\n\n### Subdirectory AGENTS.md (Parallel)\n\nLaunch writing tasks for each location:\n\n```\nfor loc in AGENTS_LOCATIONS (except root):\n  delegate_task(category=\"writing\", load_skills=[], run_in_background=false, prompt=\\`\n    Generate AGENTS.md for: ${loc.path}\n    - Reason: ${loc.reason}\n    - 30-80 lines max\n    - NEVER repeat parent content\n    - Sections: OVERVIEW (1 line), STRUCTURE (if >5 subdirs), WHERE TO LOOK, CONVENTIONS (if different), ANTI-PATTERNS\n  \\`)\n```\n\n**Wait for all. Mark \"generate\" as completed.**\n\n---\n\n## Phase 4: Review & Deduplicate\n\n**Mark \"review\" as in_progress.**\n\nFor each generated file:\n- Remove generic advice\n- Remove parent duplicates\n- Trim to size limits\n- Verify telegraphic style\n\n**Mark \"review\" as completed.**\n\n---\n\n## Final Report\n\n```\n=== init-deep Complete ===\n\nMode: {update | create-new}\n\nFiles:\n  [OK] ./AGENTS.md (root, {N} lines)\n  [OK] ./src/hooks/AGENTS.md ({N} lines)\n\nDirs Analyzed: {N}\nAGENTS.md Created: {N}\nAGENTS.md Updated: {N}\n\nHierarchy:\n  ./AGENTS.md\n  \u2514\u2500\u2500 src/hooks/AGENTS.md\n```\n\n---\n\n## Anti-Patterns\n\n- **Static agent count**: MUST vary agents based on project size/depth\n- **Sequential execution**: MUST parallel (explore + LSP concurrent)\n- **Ignoring existing**: ALWAYS read existing first, even with --create-new\n- **Over-documenting**: Not every dir needs AGENTS.md\n- **Redundancy**: Child never repeats parent\n- **Generic content**: Remove anything that applies to ALL projects\n- **Verbose style**: Telegraphic or die";
+export declare const INIT_DEEP_TEMPLATE = "# /init-deep\n\nGenerate hierarchical AGENTS.md files. Root + complexity-scored subdirectories.\n\n## Usage\n\n```\n/init-deep                      # Update mode: modify existing + create new where warranted\n/init-deep --create-new         # Read existing \u2192 remove all \u2192 regenerate from scratch\n/init-deep --max-depth=2        # Limit directory depth (default: 3)\n```\n\n---\n\n## Workflow (High-Level)\n\n1. **Discovery + Analysis** (concurrent)\n   - Fire background explore agents immediately\n   - Main session: bash structure + LSP codemap + read existing AGENTS.md\n2. **Score & Decide** - Determine AGENTS.md locations from merged findings\n3. **Generate** - Root first, then subdirs in parallel\n4. **Review** - Deduplicate, trim, validate\n\n<critical>\n**TodoWrite ALL phases. Mark in_progress \u2192 completed in real-time.**\n```\nTodoWrite([\n  { id: \"discovery\", content: \"Fire explore agents + LSP codemap + read existing\", status: \"pending\", priority: \"high\" },\n  { id: \"scoring\", content: \"Score directories, determine locations\", status: \"pending\", priority: \"high\" },\n  { id: \"generate\", content: \"Generate AGENTS.md files (root + subdirs)\", status: \"pending\", priority: \"high\" },\n  { id: \"review\", content: \"Deduplicate, validate, trim\", status: \"pending\", priority: \"medium\" }\n])\n```\n</critical>\n\n---\n\n## Phase 1: Discovery + Analysis (Concurrent)\n\n**Mark \"discovery\" as in_progress.**\n\n### Fire Background Explore Agents IMMEDIATELY\n\nDon't wait\u2014these run async while main session works.\n\n```\n// Fire all at once, collect results later\ntask(subagent_type=\"explore\", load_skills=[], description=\"Explore project structure\", run_in_background=true, prompt=\"Project structure: PREDICT standard patterns for detected language \u2192 REPORT deviations only\")\ntask(subagent_type=\"explore\", load_skills=[], description=\"Find entry points\", run_in_background=true, prompt=\"Entry points: FIND main files \u2192 REPORT non-standard organization\")\ntask(subagent_type=\"explore\", load_skills=[], description=\"Find conventions\", run_in_background=true, prompt=\"Conventions: FIND config files (.eslintrc, pyproject.toml, .editorconfig) \u2192 REPORT project-specific rules\")\ntask(subagent_type=\"explore\", load_skills=[], description=\"Find anti-patterns\", run_in_background=true, prompt=\"Anti-patterns: FIND 'DO NOT', 'NEVER', 'ALWAYS', 'DEPRECATED' comments \u2192 LIST forbidden patterns\")\ntask(subagent_type=\"explore\", load_skills=[], description=\"Explore build/CI\", run_in_background=true, prompt=\"Build/CI: FIND .github/workflows, Makefile \u2192 REPORT non-standard patterns\")\ntask(subagent_type=\"explore\", load_skills=[], description=\"Find test patterns\", run_in_background=true, prompt=\"Test patterns: FIND test configs, test structure \u2192 REPORT unique conventions\")\n```\n\n<dynamic-agents>\n**DYNAMIC AGENT SPAWNING**: After bash analysis, spawn ADDITIONAL explore agents based on project scale:\n\n| Factor | Threshold | Additional Agents |\n|--------|-----------|-------------------|\n| **Total files** | >100 | +1 per 100 files |\n| **Total lines** | >10k | +1 per 10k lines |\n| **Directory depth** | \u22654 | +2 for deep exploration |\n| **Large files (>500 lines)** | >10 files | +1 for complexity hotspots |\n| **Monorepo** | detected | +1 per package/workspace |\n| **Multiple languages** | >1 | +1 per language |\n\n```bash\n# Measure project scale first\ntotal_files=$(find . -type f -not -path '*/node_modules/*' -not -path '*/.git/*' | wc -l)\ntotal_lines=$(find . -type f \\( -name \"*.ts\" -o -name \"*.py\" -o -name \"*.go\" \\) -not -path '*/node_modules/*' -exec wc -l {} + 2>/dev/null | tail -1 | awk '{print $1}')\nlarge_files=$(find . -type f \\( -name \"*.ts\" -o -name \"*.py\" \\) -not -path '*/node_modules/*' -exec wc -l {} + 2>/dev/null | awk '$1 > 500 {count++} END {print count+0}')\nmax_depth=$(find . -type d -not -path '*/node_modules/*' -not -path '*/.git/*' | awk -F/ '{print NF}' | sort -rn | head -1)\n```\n\nExample spawning:\n```\n// 500 files, 50k lines, depth 6, 15 large files \u2192 spawn 5+5+2+1 = 13 additional agents\ntask(subagent_type=\"explore\", load_skills=[], description=\"Analyze large files\", run_in_background=true, prompt=\"Large file analysis: FIND files >500 lines, REPORT complexity hotspots\")\ntask(subagent_type=\"explore\", load_skills=[], description=\"Explore deep modules\", run_in_background=true, prompt=\"Deep modules at depth 4+: FIND hidden patterns, internal conventions\")\ntask(subagent_type=\"explore\", load_skills=[], description=\"Find shared utilities\", run_in_background=true, prompt=\"Cross-cutting concerns: FIND shared utilities across directories\")\n// ... more based on calculation\n```\n</dynamic-agents>\n\n### Main Session: Concurrent Analysis\n\n**While background agents run**, main session does:\n\n#### 1. Bash Structural Analysis\n```bash\n# Directory depth + file counts\nfind . -type d -not -path '*/\\.*' -not -path '*/node_modules/*' -not -path '*/venv/*' -not -path '*/dist/*' -not -path '*/build/*' | awk -F/ '{print NF-1}' | sort -n | uniq -c\n\n# Files per directory (top 30)\nfind . -type f -not -path '*/\\.*' -not -path '*/node_modules/*' | sed 's|/[^/]*$||' | sort | uniq -c | sort -rn | head -30\n\n# Code concentration by extension\nfind . -type f \\( -name \"*.py\" -o -name \"*.ts\" -o -name \"*.tsx\" -o -name \"*.js\" -o -name \"*.go\" -o -name \"*.rs\" \\) -not -path '*/node_modules/*' | sed 's|/[^/]*$||' | sort | uniq -c | sort -rn | head -20\n\n# Existing AGENTS.md / CLAUDE.md\nfind . -type f \\( -name \"AGENTS.md\" -o -name \"CLAUDE.md\" \\) -not -path '*/node_modules/*' 2>/dev/null\n```\n\n#### 2. Read Existing AGENTS.md\n```\nFor each existing file found:\n  Read(filePath=file)\n  Extract: key insights, conventions, anti-patterns\n  Store in EXISTING_AGENTS map\n```\n\nIf `--create-new`: Read all existing first (preserve context) \u2192 then delete all \u2192 regenerate.\n\n#### 3. LSP Codemap (if available)\n```\nLspServers()  # Check availability\n\n# Entry points (parallel)\nLspDocumentSymbols(filePath=\"src/index.ts\")\nLspDocumentSymbols(filePath=\"main.py\")\n\n# Key symbols (parallel)\nLspWorkspaceSymbols(filePath=\".\", query=\"class\")\nLspWorkspaceSymbols(filePath=\".\", query=\"interface\")\nLspWorkspaceSymbols(filePath=\".\", query=\"function\")\n\n# Centrality for top exports\nLspFindReferences(filePath=\"...\", line=X, character=Y)\n```\n\n**LSP Fallback**: If unavailable, rely on explore agents + AST-grep.\n\n### Collect Background Results\n\n```\n// After main session analysis done, collect all task results\nfor each task_id: background_output(task_id=\"...\")\n```\n\n**Merge: bash + LSP + existing + explore findings. Mark \"discovery\" as completed.**\n\n---\n\n## Phase 2: Scoring & Location Decision\n\n**Mark \"scoring\" as in_progress.**\n\n### Scoring Matrix\n\n| Factor | Weight | High Threshold | Source |\n|--------|--------|----------------|--------|\n| File count | 3x | >20 | bash |\n| Subdir count | 2x | >5 | bash |\n| Code ratio | 2x | >70% | bash |\n| Unique patterns | 1x | Has own config | explore |\n| Module boundary | 2x | Has index.ts/__init__.py | bash |\n| Symbol density | 2x | >30 symbols | LSP |\n| Export count | 2x | >10 exports | LSP |\n| Reference centrality | 3x | >20 refs | LSP |\n\n### Decision Rules\n\n| Score | Action |\n|-------|--------|\n| **Root (.)** | ALWAYS create |\n| **>15** | Create AGENTS.md |\n| **8-15** | Create if distinct domain |\n| **<8** | Skip (parent covers) |\n\n### Output\n```\nAGENTS_LOCATIONS = [\n  { path: \".\", type: \"root\" },\n  { path: \"src/hooks\", score: 18, reason: \"high complexity\" },\n  { path: \"src/api\", score: 12, reason: \"distinct domain\" }\n]\n```\n\n**Mark \"scoring\" as completed.**\n\n---\n\n## Phase 3: Generate AGENTS.md\n\n**Mark \"generate\" as in_progress.**\n\n<critical>\n**File Writing Rule**: If AGENTS.md already exists at the target path \u2192 use `Edit` tool. If it does NOT exist \u2192 use `Write` tool.\nNEVER use Write to overwrite an existing file. ALWAYS check existence first via `Read` or discovery results.\n</critical>\n\n### Root AGENTS.md (Full Treatment)\n\n```markdown\n# PROJECT KNOWLEDGE BASE\n\n**Generated:** {TIMESTAMP}\n**Commit:** {SHORT_SHA}\n**Branch:** {BRANCH}\n\n## OVERVIEW\n{1-2 sentences: what + core stack}\n\n## STRUCTURE\n\\`\\`\\`\n{root}/\n\u251C\u2500\u2500 {dir}/    # {non-obvious purpose only}\n\u2514\u2500\u2500 {entry}\n\\`\\`\\`\n\n## WHERE TO LOOK\n| Task | Location | Notes |\n|------|----------|-------|\n\n## CODE MAP\n{From LSP - skip if unavailable or project <10 files}\n\n| Symbol | Type | Location | Refs | Role |\n|--------|------|----------|------|------|\n\n## CONVENTIONS\n{ONLY deviations from standard}\n\n## ANTI-PATTERNS (THIS PROJECT)\n{Explicitly forbidden here}\n\n## UNIQUE STYLES\n{Project-specific}\n\n## COMMANDS\n\\`\\`\\`bash\n{dev/test/build}\n\\`\\`\\`\n\n## NOTES\n{Gotchas}\n```\n\n**Quality gates**: 50-150 lines, no generic advice, no obvious info.\n\n### Subdirectory AGENTS.md (Parallel)\n\nLaunch writing tasks for each location:\n\n```\nfor loc in AGENTS_LOCATIONS (except root):\n  task(category=\"writing\", load_skills=[], run_in_background=false, description=\"Generate AGENTS.md\", prompt=\\`\n    Generate AGENTS.md for: ${loc.path}\n    - Reason: ${loc.reason}\n    - 30-80 lines max\n    - NEVER repeat parent content\n    - Sections: OVERVIEW (1 line), STRUCTURE (if >5 subdirs), WHERE TO LOOK, CONVENTIONS (if different), ANTI-PATTERNS\n  \\`)\n```\n\n**Wait for all. Mark \"generate\" as completed.**\n\n---\n\n## Phase 4: Review & Deduplicate\n\n**Mark \"review\" as in_progress.**\n\nFor each generated file:\n- Remove generic advice\n- Remove parent duplicates\n- Trim to size limits\n- Verify telegraphic style\n\n**Mark \"review\" as completed.**\n\n---\n\n## Final Report\n\n```\n=== init-deep Complete ===\n\nMode: {update | create-new}\n\nFiles:\n  [OK] ./AGENTS.md (root, {N} lines)\n  [OK] ./src/hooks/AGENTS.md ({N} lines)\n\nDirs Analyzed: {N}\nAGENTS.md Created: {N}\nAGENTS.md Updated: {N}\n\nHierarchy:\n  ./AGENTS.md\n  \u2514\u2500\u2500 src/hooks/AGENTS.md\n```\n\n---\n\n## Anti-Patterns\n\n- **Static agent count**: MUST vary agents based on project size/depth\n- **Sequential execution**: MUST parallel (explore + LSP concurrent)\n- **Ignoring existing**: ALWAYS read existing first, even with --create-new\n- **Over-documenting**: Not every dir needs AGENTS.md\n- **Redundancy**: Child never repeats parent\n- **Generic content**: Remove anything that applies to ALL projects\n- **Verbose style**: Telegraphic or die";

package/dist/features/tool-metadata-store/index.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Pending tool metadata store.
+ *
+ * OpenCode's `fromPlugin()` wrapper always replaces the metadata returned by
+ * plugin tools with `{ truncated, outputPath }`, discarding any sessionId,
+ * title, or custom metadata set during `execute()`.
+ *
+ * This store captures metadata written via `ctx.metadata()` inside execute(),
+ * then the `tool.execute.after` hook consumes it and merges it back into the
+ * result *before* the processor writes the final part to the session store.
+ *
+ * Flow:
+ *   execute() → storeToolMetadata(sessionID, callID, data)
+ *   fromPlugin() → overwrites metadata with { truncated }
+ *   tool.execute.after → consumeToolMetadata(sessionID, callID) → merges back
+ *   processor → Session.updatePart(status:"completed", metadata: result.metadata)
+ */
+export interface PendingToolMetadata {
+    title?: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Store metadata to be restored after fromPlugin() overwrites it.
+ * Called from tool execute() functions alongside ctx.metadata().
+ */
+export declare function storeToolMetadata(sessionID: string, callID: string, data: PendingToolMetadata): void;
+/**
+ * Consume stored metadata (one-time read, removes from store).
+ * Called from tool.execute.after hook.
+ */
+export declare function consumeToolMetadata(sessionID: string, callID: string): PendingToolMetadata | undefined;
+/**
+ * Get current store size (for testing/debugging).
+ */
+export declare function getPendingStoreSize(): number;
+/**
+ * Clear all pending metadata (for testing).
+ */
+export declare function clearPendingStore(): void;

package/dist/hooks/agent-usage-reminder/constants.d.ts

@@ -2,4 +2,4 @@ export declare const OPENCODE_STORAGE: string;
 export declare const AGENT_USAGE_REMINDER_STORAGE: string;
 export declare const TARGET_TOOLS: Set<string>;
 export declare const AGENT_TOOLS: Set<string>;
-export declare const REMINDER_MESSAGE = "\n[Agent Usage Reminder]\n\nYou called a search/fetch tool directly without leveraging specialized agents.\n\nRECOMMENDED: Use delegate_task with explore/librarian agents for better results:\n\n```\n// Parallel exploration - fire multiple agents simultaneously\ndelegate_task(agent=\"explore\", prompt=\"Find all files matching pattern X\")\ndelegate_task(agent=\"explore\", prompt=\"Search for implementation of Y\") \ndelegate_task(agent=\"librarian\", prompt=\"Lookup documentation for Z\")\n\n// Then continue your work while they run in background\n// System will notify you when each completes\n```\n\nWHY:\n- Agents can perform deeper, more thorough searches\n- Background tasks run in parallel, saving time\n- Specialized agents have domain expertise\n- Reduces context window usage in main session\n\nALWAYS prefer: Multiple parallel delegate_task calls > Direct tool calls\n";
+export declare const REMINDER_MESSAGE = "\n[Agent Usage Reminder]\n\nYou called a search/fetch tool directly without leveraging specialized agents.\n\nRECOMMENDED: Use task with explore/librarian agents for better results:\n\n```\n// Parallel exploration - fire multiple agents simultaneously\ntask(agent=\"explore\", prompt=\"Find all files matching pattern X\")\ntask(agent=\"explore\", prompt=\"Search for implementation of Y\") \ntask(agent=\"librarian\", prompt=\"Lookup documentation for Z\")\n\n// Then continue your work while they run in background\n// System will notify you when each completes\n```\n\nWHY:\n- Agents can perform deeper, more thorough searches\n- Background tasks run in parallel, saving time\n- Specialized agents have domain expertise\n- Reduces context window usage in main session\n\nALWAYS prefer: Multiple parallel task calls > Direct tool calls\n";

package/dist/hooks/anthropic-context-window-limit-recovery/deduplication-recovery.d.ts

@@ -0,0 +1,3 @@
+import type { ParsedTokenLimitError } from "./types";
+import type { ExperimentalConfig } from "../../config";
+export declare function attemptDeduplicationRecovery(sessionID: string, parsed: ParsedTokenLimitError, experimental: ExperimentalConfig | undefined): Promise<void>;

package/dist/hooks/anthropic-context-window-limit-recovery/index.d.ts

@@ -1,16 +1,5 @@
-import type { PluginInput } from "@opencode-ai/plugin";
-import type { ExperimentalConfig } from "../../config";
-export interface AnthropicContextWindowLimitRecoveryOptions {
-    experimental?: ExperimentalConfig;
-}
-export declare function createAnthropicContextWindowLimitRecoveryHook(ctx: PluginInput, options?: AnthropicContextWindowLimitRecoveryOptions): {
-    event: ({ event }: {
-        event: {
-            type: string;
-            properties?: unknown;
-        };
-    }) => Promise<void>;
-};
+export { createAnthropicContextWindowLimitRecoveryHook } from "./recovery-hook";
+export type { AnthropicContextWindowLimitRecoveryOptions } from "./recovery-hook";
 export type { AutoCompactState, ParsedTokenLimitError, TruncateState } from "./types";
 export { parseAnthropicTokenLimitError } from "./parser";
 export { executeCompact, getLastAssistant } from "./executor";