omctest 0.0.1

package/dist/tools/ast-grep/tool-descriptions.d.ts

@@ -0,0 +1,3 @@
+export declare const AST_GREP_SEARCH_DESCRIPTION: string;
+export declare const AST_GREP_SEARCH_PATTERN_PARAM = "AST pattern - valid, parseable code using $VAR (one node) and $$$ (many nodes). NOT regex: no `|`, no `.*`, no `\\w`, no `[a-z]`. For text or alternation, use grep instead.";
+export declare const AST_GREP_REPLACE_DESCRIPTION: string;

package/dist/tools/ast-grep/tools.d.ts

@@ -0,0 +1,3 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+import { type ToolDefinition } from "@opencode-ai/plugin/tool";
+export declare function createAstGrepTools(ctx: PluginInput): Record<string, ToolDefinition>;

package/dist/tools/ast-grep/types.d.ts

@@ -0,0 +1,58 @@
+import type { CLI_LANGUAGES, NAPI_LANGUAGES } from "./constants";
+export type CliLanguage = (typeof CLI_LANGUAGES)[number];
+export type NapiLanguage = (typeof NAPI_LANGUAGES)[number];
+export interface Position {
+    line: number;
+    column: number;
+}
+export interface Range {
+    start: Position;
+    end: Position;
+}
+export interface CliMatch {
+    text: string;
+    range: {
+        byteOffset: {
+            start: number;
+            end: number;
+        };
+        start: Position;
+        end: Position;
+    };
+    file: string;
+    lines: string;
+    charCount: {
+        leading: number;
+        trailing: number;
+    };
+    language: string;
+}
+export interface SearchMatch {
+    file: string;
+    text: string;
+    range: Range;
+    lines: string;
+}
+export interface MetaVariable {
+    name: string;
+    text: string;
+    kind: string;
+}
+export interface AnalyzeResult {
+    text: string;
+    range: Range;
+    kind: string;
+    metaVariables: MetaVariable[];
+}
+export interface TransformResult {
+    original: string;
+    transformed: string;
+    editCount: number;
+}
+export interface SgResult {
+    matches: CliMatch[];
+    totalMatches: number;
+    truncated: boolean;
+    truncatedReason?: "max_matches" | "max_output_bytes" | "timeout";
+    error?: string;
+}

package/dist/tools/background-task/clients.d.ts

@@ -0,0 +1,46 @@
+import type { BackgroundManager } from "../../features/background-agent";
+export type BackgroundOutputMessage = {
+    id?: string;
+    info?: {
+        role?: string;
+        time?: string | {
+            created?: number;
+        };
+        agent?: string;
+        error?: unknown;
+    };
+    parts?: Array<{
+        type?: string;
+        text?: string;
+        thinking?: string;
+        content?: string | Array<{
+            type: string;
+            text?: string;
+        }>;
+        output?: string;
+        name?: string;
+    }>;
+};
+export type BackgroundOutputMessagesResult = {
+    data?: BackgroundOutputMessage[];
+    error?: unknown;
+} | BackgroundOutputMessage[];
+export type BackgroundOutputClient = {
+    session: {
+        messages: (args: {
+            path: {
+                id: string;
+            };
+        }) => Promise<BackgroundOutputMessagesResult>;
+    };
+};
+export type BackgroundCancelClient = {
+    session: {
+        abort: (args: {
+            path: {
+                id: string;
+            };
+        }) => Promise<unknown>;
+    };
+};
+export type BackgroundOutputManager = Pick<BackgroundManager, "getTask">;

package/dist/tools/background-task/constants.d.ts

@@ -0,0 +1,3 @@
+export declare const BACKGROUND_TASK_DESCRIPTION = "Run agent task in background. Returns task_id immediately; notifies on completion.\n\nUse `background_output` to get results. Prompts MUST be in English.";
+export declare const BACKGROUND_OUTPUT_DESCRIPTION = "Get output from background task. Use full_session=true to fetch session messages with filters. System notifies on completion, so block=true rarely needed. - Timeout values are in milliseconds (ms), NOT seconds.\n\nIMPORTANT: ONLY call this tool AFTER receiving a <system-reminder> notification for the task. Do NOT call immediately after launching a background task - wait for the notification first.";
+export declare const BACKGROUND_CANCEL_DESCRIPTION = "Cancel running background task(s). Use all=true to cancel ALL before final answer.";

package/dist/tools/background-task/create-background-cancel.d.ts

@@ -0,0 +1,4 @@
+import { type ToolDefinition } from "@opencode-ai/plugin";
+import type { BackgroundManager } from "../../features/background-agent";
+import type { BackgroundCancelClient } from "./clients";
+export declare function createBackgroundCancel(manager: BackgroundManager, _client: BackgroundCancelClient): ToolDefinition;

package/dist/tools/background-task/create-background-output.d.ts

@@ -0,0 +1,3 @@
+import { type ToolDefinition } from "@opencode-ai/plugin";
+import type { BackgroundOutputClient, BackgroundOutputManager } from "./clients";
+export declare function createBackgroundOutput(manager: BackgroundOutputManager, client: BackgroundOutputClient): ToolDefinition;

package/dist/tools/background-task/create-background-task.d.ts

@@ -0,0 +1,3 @@
+import { type PluginInput, type ToolDefinition } from "@opencode-ai/plugin";
+import type { BackgroundManager } from "../../features/background-agent";
+export declare function createBackgroundTask(manager: BackgroundManager, client: PluginInput["client"]): ToolDefinition;

package/dist/tools/background-task/delay.d.ts

@@ -0,0 +1 @@
+export declare function delay(ms: number): Promise<void>;

package/dist/tools/background-task/full-session-format.d.ts

@@ -0,0 +1,9 @@
+import type { BackgroundTask } from "../../features/background-agent";
+import type { BackgroundOutputClient } from "./clients";
+export declare function formatFullSession(task: BackgroundTask, client: BackgroundOutputClient, options: {
+    includeThinking: boolean;
+    messageLimit?: number;
+    sinceMessageId?: string;
+    includeToolResults: boolean;
+    thinkingMaxChars?: number;
+}): Promise<string>;

package/dist/tools/background-task/index.d.ts

@@ -0,0 +1,3 @@
+export { createBackgroundTask, createBackgroundOutput, createBackgroundCancel, } from "./tools";
+export type * from "./types";
+export * from "./constants";

package/dist/tools/background-task/message-dir.d.ts

@@ -0,0 +1 @@
+export { getMessageDir } from "../../shared/opencode-message-dir";

package/dist/tools/background-task/session-messages.d.ts

@@ -0,0 +1,3 @@
+import type { BackgroundOutputMessage, BackgroundOutputMessagesResult } from "./clients";
+export declare function getErrorMessage(value: BackgroundOutputMessagesResult): string | null;
+export declare function extractMessages(value: BackgroundOutputMessagesResult): BackgroundOutputMessage[];

package/dist/tools/background-task/task-result-format.d.ts

@@ -0,0 +1,3 @@
+import type { BackgroundTask } from "../../features/background-agent";
+import type { BackgroundOutputClient } from "./clients";
+export declare function formatTaskResult(task: BackgroundTask, client: BackgroundOutputClient): Promise<string>;

package/dist/tools/background-task/task-status-format.d.ts

@@ -0,0 +1,2 @@
+import type { BackgroundTask } from "../../features/background-agent";
+export declare function formatTaskStatus(task: BackgroundTask): string;

package/dist/tools/background-task/time-format.d.ts

@@ -0,0 +1,2 @@
+export declare function formatDuration(start: Date, end?: Date): string;
+export declare function formatMessageTime(value: unknown): string;

package/dist/tools/background-task/tools.d.ts

@@ -0,0 +1,4 @@
+export type { BackgroundCancelClient, BackgroundOutputClient, BackgroundOutputManager, BackgroundOutputMessage, BackgroundOutputMessagesResult, } from "./clients";
+export { createBackgroundTask } from "./create-background-task";
+export { createBackgroundOutput } from "./create-background-output";
+export { createBackgroundCancel } from "./create-background-cancel";

package/dist/tools/background-task/truncate-text.d.ts

@@ -0,0 +1 @@
+export declare function truncateText(text: string, maxLength: number): string;

package/dist/tools/background-task/types.d.ts

@@ -0,0 +1,90 @@
+export interface BackgroundTaskArgs {
+    description: string;
+    prompt: string;
+    agent: string;
+}
+export interface BackgroundOutputArgs {
+    task_id: string;
+    block?: boolean;
+    timeout?: number;
+    full_session?: boolean;
+    include_thinking?: boolean;
+    message_limit?: number;
+    since_message_id?: string;
+    include_tool_results?: boolean;
+    thinking_max_chars?: number;
+}
+export interface BackgroundCancelArgs {
+    taskId?: string;
+    all?: boolean;
+}
+export type BackgroundOutputMessage = {
+    info?: {
+        role?: string;
+        time?: string | {
+            created?: number;
+        };
+        agent?: string;
+    };
+    parts?: Array<{
+        type?: string;
+        text?: string;
+        content?: string | Array<{
+            type: string;
+            text?: string;
+        }>;
+        name?: string;
+    }>;
+};
+export type BackgroundOutputMessagesResult = {
+    data?: BackgroundOutputMessage[];
+    error?: unknown;
+} | BackgroundOutputMessage[];
+export type BackgroundOutputClient = {
+    session: {
+        messages: (args: {
+            path: {
+                id: string;
+            };
+        }) => Promise<BackgroundOutputMessagesResult>;
+    };
+};
+export type BackgroundCancelClient = {
+    session: {
+        abort: (args: {
+            path: {
+                id: string;
+            };
+        }) => Promise<unknown>;
+    };
+};
+export type BackgroundOutputManager = Pick<import("../../features/background-agent").BackgroundManager, "getTask">;
+export type FullSessionMessagePart = {
+    type?: string;
+    text?: string;
+    thinking?: string;
+    content?: string | Array<{
+        type?: string;
+        text?: string;
+    }>;
+    output?: string;
+};
+export type FullSessionMessage = {
+    id?: string;
+    info?: {
+        role?: string;
+        time?: string;
+        agent?: string;
+    };
+    parts?: FullSessionMessagePart[];
+};
+export type ToolContextWithMetadata = {
+    sessionID: string;
+    messageID: string;
+    agent: string;
+    abort: AbortSignal;
+    metadata?: (input: {
+        title?: string;
+        metadata?: Record<string, unknown>;
+    }) => void;
+};

package/dist/tools/call-omo-agent/agent-resolver.d.ts

@@ -0,0 +1,17 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+export declare function clearCallableAgentsCache(): void;
+/**
+ * Resolves the set of callable agent names at execute-time by merging the
+ * hardcoded `ALLOWED_AGENTS` with any additional agents discovered dynamically
+ * via `client.app.agents()`. Custom agents loaded from registered agent
+ * directories appear here alongside built-ins.
+ *
+ * Results are cached per session for 30s to avoid redundant SDK IPC calls.
+ *
+ * Falls back to `ALLOWED_AGENTS` alone if the dynamic lookup fails.
+ *
+ * @param client - The plugin client with access to the agent registry
+ * @param sessionId - Optional session ID for cache scoping
+ * @returns Array of lowercase callable agent names (excludes primary-mode agents)
+ */
+export declare function resolveCallableAgents(client: PluginInput["client"], sessionId?: string): Promise<string[]>;

package/dist/tools/call-omo-agent/background-agent-executor.d.ts

@@ -0,0 +1,5 @@
+import type { BackgroundManager } from "../../features/background-agent";
+import type { PluginInput } from "@opencode-ai/plugin";
+import type { CallOmoAgentArgs } from "./types";
+import type { ToolContextWithMetadata } from "./tool-context-with-metadata";
+export declare function executeBackgroundAgent(args: CallOmoAgentArgs, toolContext: ToolContextWithMetadata, manager: BackgroundManager, client: PluginInput["client"]): Promise<string>;

package/dist/tools/call-omo-agent/background-executor.d.ts

@@ -0,0 +1,15 @@
+import type { CallOmoAgentArgs } from "./types";
+import type { BackgroundManager } from "../../features/background-agent";
+import type { PluginInput } from "@opencode-ai/plugin";
+import type { DelegatedModelConfig } from "../../shared/model-resolution-types";
+import type { FallbackEntry } from "../../shared/model-requirements";
+export declare function executeBackground(args: CallOmoAgentArgs, toolContext: {
+    sessionID: string;
+    messageID: string;
+    agent: string;
+    abort: AbortSignal;
+    metadata?: (input: {
+        title?: string;
+        metadata?: Record<string, unknown>;
+    }) => void;
+}, manager: BackgroundManager, client: PluginInput["client"], fallbackChain?: FallbackEntry[], model?: DelegatedModelConfig): Promise<string>;

package/dist/tools/call-omo-agent/completion-poller.d.ts

@@ -0,0 +1,11 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+export declare function waitForCompletion(sessionID: string, toolContext: {
+    sessionID: string;
+    messageID: string;
+    agent: string;
+    abort: AbortSignal;
+    metadata?: (input: {
+        title?: string;
+        metadata?: Record<string, unknown>;
+    }) => void;
+}, ctx: PluginInput): Promise<void>;

package/dist/tools/call-omo-agent/constants.d.ts

@@ -0,0 +1,2 @@
+export declare const ALLOWED_AGENTS: readonly ["explore", "librarian", "oracle", "hephaestus", "metis", "momus", "multimodal-looker"];
+export declare const CALL_OMO_AGENT_DESCRIPTION = "Spawn explore/librarian agent or custom agents. run_in_background REQUIRED (true=async with task_id, false=sync).\n\nBuilt-in agents:\n{agents}\n\nCustom agents registered via user or project agent directories are also supported.\n\nPass `session_id=<id>` to continue previous agent with full context. Nested subagent depth is tracked automatically and blocked past the configured limit. Prompts MUST be in English. Use `background_output` for async results.";

package/dist/tools/call-omo-agent/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./types";
+export * from "./constants";
+export { createCallOmoAgent } from "./tools";

package/dist/tools/call-omo-agent/message-dir.d.ts

@@ -0,0 +1 @@
+export { getMessageDir } from "../../shared/opencode-message-dir";

package/dist/tools/call-omo-agent/message-processor.d.ts

@@ -0,0 +1,2 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+export declare function processMessages(sessionID: string, ctx: PluginInput): Promise<string>;

package/dist/tools/call-omo-agent/message-storage-directory.d.ts

@@ -0,0 +1 @@
+export { getMessageDir } from "../../shared";

package/dist/tools/call-omo-agent/session-creator.d.ts

@@ -0,0 +1,15 @@
+import type { CallOmoAgentArgs } from "./types";
+import type { PluginInput } from "@opencode-ai/plugin";
+export declare function createOrGetSession(args: CallOmoAgentArgs, toolContext: {
+    sessionID: string;
+    messageID: string;
+    agent: string;
+    abort: AbortSignal;
+    metadata?: (input: {
+        title?: string;
+        metadata?: Record<string, unknown>;
+    }) => void;
+}, ctx: PluginInput): Promise<{
+    sessionID: string;
+    isNew: boolean;
+}>;

package/dist/tools/call-omo-agent/subagent-session-creator.d.ts

@@ -0,0 +1,10 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+import type { CallOmoAgentArgs } from "./types";
+import type { ToolContextWithMetadata } from "./tool-context-with-metadata";
+export declare function resolveOrCreateSessionId(ctx: PluginInput, args: CallOmoAgentArgs, toolContext: ToolContextWithMetadata): Promise<{
+    ok: true;
+    sessionID: string;
+} | {
+    ok: false;
+    error: string;
+}>;

package/dist/tools/call-omo-agent/sync-executor.d.ts

@@ -0,0 +1,29 @@
+import type { CallOmoAgentArgs } from "./types";
+import type { PluginInput } from "@opencode-ai/plugin";
+import type { DelegatedModelConfig } from "../../shared/model-resolution-types";
+import type { FallbackEntry } from "../../shared/model-requirements";
+import { waitForCompletion } from "./completion-poller";
+import { processMessages } from "./message-processor";
+import { createOrGetSession } from "./session-creator";
+type ExecuteSyncDeps = {
+    createOrGetSession: typeof createOrGetSession;
+    waitForCompletion: typeof waitForCompletion;
+    processMessages: typeof processMessages;
+    setSessionFallbackChain: (sessionID: string, fallbackChain: FallbackEntry[] | undefined) => void;
+    clearSessionFallbackChain: (sessionID: string) => void;
+};
+type SpawnReservation = {
+    commit: () => number;
+    rollback: () => void;
+};
+export declare function executeSync(args: CallOmoAgentArgs, toolContext: {
+    sessionID: string;
+    messageID: string;
+    agent: string;
+    abort: AbortSignal;
+    metadata?: (input: {
+        title?: string;
+        metadata?: Record<string, unknown>;
+    }) => void | Promise<void>;
+}, ctx: PluginInput, deps?: ExecuteSyncDeps, fallbackChain?: FallbackEntry[], spawnReservation?: SpawnReservation, model?: DelegatedModelConfig): Promise<string>;
+export {};

package/dist/tools/call-omo-agent/tool-context-with-metadata.d.ts

@@ -0,0 +1,10 @@
+export type ToolContextWithMetadata = {
+    sessionID: string;
+    messageID: string;
+    agent: string;
+    abort: AbortSignal;
+    metadata?: (input: {
+        title?: string;
+        metadata?: Record<string, unknown>;
+    }) => void;
+};

package/dist/tools/call-omo-agent/tools.d.ts

@@ -0,0 +1,5 @@
+import { type PluginInput, type ToolDefinition } from "@opencode-ai/plugin";
+import type { BackgroundManager } from "../../features/background-agent";
+import type { ModelFallbackControllerAccessor } from "../../hooks/model-fallback";
+import type { CategoriesConfig, AgentOverrides } from "../../config/schema";
+export declare function createCallOmoAgent(ctx: PluginInput, backgroundManager: BackgroundManager, disabledAgents?: string[], agentOverrides?: AgentOverrides, userCategories?: CategoriesConfig, modelFallbackControllerAccessor?: ModelFallbackControllerAccessor): ToolDefinition;

package/dist/tools/call-omo-agent/types.d.ts

@@ -0,0 +1,34 @@
+import type { ALLOWED_AGENTS } from "./constants";
+export type AllowedAgentType = (typeof ALLOWED_AGENTS)[number];
+export interface CallOmoAgentArgs {
+    description: string;
+    prompt: string;
+    subagent_type: string;
+    run_in_background: boolean;
+    session_id?: string;
+}
+export interface CallOmoAgentSyncResult {
+    title: string;
+    metadata: {
+        summary?: Array<{
+            id: string;
+            tool: string;
+            state: {
+                status: string;
+                title?: string;
+            };
+        }>;
+        sessionId: string;
+    };
+    output: string;
+}
+export type ToolContextWithMetadata = {
+    sessionID: string;
+    messageID: string;
+    agent: string;
+    abort: AbortSignal;
+    metadata?: (input: {
+        title?: string;
+        metadata?: Record<string, unknown>;
+    }) => void;
+};

package/dist/tools/delegate-task/anthropic-categories.d.ts

@@ -0,0 +1,2 @@
+import type { BuiltinCategoryDefinition } from "./builtin-category-definition";
+export declare const ANTHROPIC_CATEGORIES: BuiltinCategoryDefinition[];

package/dist/tools/delegate-task/available-models.d.ts

@@ -0,0 +1,2 @@
+import type { OpencodeClient } from "./types";
+export declare function getAvailableModelsForDelegateTask(client: OpencodeClient): Promise<Set<string>>;

package/dist/tools/delegate-task/background-continuation.d.ts

@@ -0,0 +1,3 @@
+import type { DelegateTaskArgs, ToolContextWithMetadata } from "./types";
+import type { ExecutorContext, ParentContext } from "./executor-types";
+export declare function executeBackgroundContinuation(args: DelegateTaskArgs, ctx: ToolContextWithMetadata, executorCtx: ExecutorContext, parentContext: ParentContext, systemContent?: string): Promise<string>;

package/dist/tools/delegate-task/background-task.d.ts

@@ -0,0 +1,4 @@
+import type { DelegateTaskArgs, ToolContextWithMetadata, DelegatedModelConfig } from "./types";
+import type { ExecutorContext, ParentContext } from "./executor-types";
+import type { FallbackEntry } from "../../shared/model-requirements";
+export declare function executeBackgroundTask(args: DelegateTaskArgs, ctx: ToolContextWithMetadata, executorCtx: ExecutorContext, parentContext: ParentContext, agentToUse: string, categoryModel: DelegatedModelConfig | undefined, systemContent: string | undefined, fallbackChain?: FallbackEntry[]): Promise<string>;

package/dist/tools/delegate-task/builtin-categories.d.ts

@@ -0,0 +1,5 @@
+import type { CategoryConfig } from "../../config/schema";
+export declare const DEFAULT_CATEGORIES: Record<string, CategoryConfig>;
+export declare const CATEGORY_PROMPT_APPENDS: Record<string, string>;
+export declare const CATEGORY_DESCRIPTIONS: Record<string, string>;
+export declare const CATEGORY_PROMPT_APPEND_RESOLVERS: Record<string, (model: string | undefined) => string>;

package/dist/tools/delegate-task/builtin-category-definition.d.ts

@@ -0,0 +1,8 @@
+import type { CategoryConfig } from "../../config/schema";
+export type BuiltinCategoryDefinition = {
+    name: string;
+    config: CategoryConfig;
+    description: string;
+    promptAppend: string;
+    resolvePromptAppend?: (model: string | undefined) => string;
+};

package/dist/tools/delegate-task/cancel-unstable-agent-task.d.ts

@@ -0,0 +1,2 @@
+import type { ExecutorContext } from "./executor-types";
+export declare function cancelUnstableAgentTask(manager: ExecutorContext["manager"], taskID: string | undefined, reason: string): Promise<void>;

package/dist/tools/delegate-task/categories.d.ts

@@ -0,0 +1,18 @@
+import type { CategoryConfig, CategoriesConfig } from "../../config/schema";
+export interface ResolveCategoryConfigOptions {
+    userCategories?: CategoriesConfig;
+    inheritedModel?: string;
+    systemDefaultModel?: string;
+    availableModels?: Set<string>;
+}
+export interface ResolveCategoryConfigResult {
+    config: CategoryConfig;
+    promptAppend: string;
+    model: string | undefined;
+    isUserConfiguredModel: boolean;
+}
+/**
+ * Resolve the configuration for a given category name.
+ * Merges default and user configurations, handles model resolution.
+ */
+export declare function resolveCategoryConfig(categoryName: string, options: ResolveCategoryConfigOptions): ResolveCategoryConfigResult | null;

package/dist/tools/delegate-task/category-resolver.d.ts

@@ -0,0 +1,17 @@
+import type { ModelFallbackInfo } from "../../features/task-toast-manager/types";
+import type { DelegateTaskArgs } from "./types";
+import type { ExecutorContext } from "./executor-types";
+import type { FallbackEntry } from "../../shared/model-requirements";
+import type { DelegatedModelConfig } from "./types";
+export interface CategoryResolutionResult {
+    agentToUse: string;
+    categoryModel: DelegatedModelConfig | undefined;
+    categoryPromptAppend: string | undefined;
+    maxPromptTokens?: number;
+    modelInfo: ModelFallbackInfo | undefined;
+    actualModel: string | undefined;
+    isUnstableAgent: boolean;
+    fallbackChain?: FallbackEntry[];
+    error?: string;
+}
+export declare function resolveCategoryExecution(args: DelegateTaskArgs, executorCtx: ExecutorContext, inheritedModel: string | undefined, systemDefaultModel: string | undefined): Promise<CategoryResolutionResult>;

package/dist/tools/delegate-task/constants.d.ts

@@ -0,0 +1,31 @@
+import type { AvailableCategory, AvailableSkill } from "../../agents/dynamic-agent-prompt-builder";
+export { CATEGORY_DESCRIPTIONS, CATEGORY_PROMPT_APPENDS, CATEGORY_PROMPT_APPEND_RESOLVERS, DEFAULT_CATEGORIES, } from "./builtin-categories";
+/**
+ * System prompt prepended to plan agent invocations.
+ * Instructs the plan agent to first gather context via explore/librarian agents,
+ * then summarize user requirements and clarify uncertainties before proceeding.
+ * Also MANDATES dependency graphs, parallel execution analysis, and category+skill recommendations.
+ */
+export declare const PLAN_AGENT_SYSTEM_PREPEND_STATIC_BEFORE_SKILLS = "<system>\nBEFORE you begin planning, you MUST first understand the user's request deeply.\n\nMANDATORY CONTEXT GATHERING PROTOCOL:\n1. Launch background agents to gather context:\n   - call_omo_agent(description=\"Explore codebase patterns\", subagent_type=\"explore\", run_in_background=true, prompt=\"<search for relevant patterns, files, and implementations in the codebase related to user's request>\")\n   - call_omo_agent(description=\"Research documentation\", subagent_type=\"librarian\", run_in_background=true, prompt=\"<search for external documentation, examples, and best practices related to user's request>\")\n\n2. After gathering context, ALWAYS present:\n   - **User Request Summary**: Concise restatement of what the user is asking for\n   - **Uncertainties**: List of unclear points, ambiguities, or assumptions you're making\n   - **Clarifying Questions**: Specific questions to resolve the uncertainties\n\n3. ITERATE until ALL requirements are crystal clear:\n   - Do NOT proceed to planning until you have 100% clarity\n   - Ask the user to confirm your understanding\n   - Resolve every ambiguity before generating the work plan\n\nREMEMBER: Vague requirements lead to failed implementations. Take the time to understand thoroughly.\n</system>\n\n<CRITICAL_REQUIREMENT_DEPENDENCY_PARALLEL_EXECUTION_CATEGORY_SKILLS>\n#####################################################################\n#                                                                   #\n#   \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2557   \u2588\u2588\u2557\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2557    #\n#   \u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u2588\u2588\u2554\u2550\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557   #\n#   \u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2551  \u2588\u2588\u2551   #\n#   \u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u255D  \u2588\u2588\u2551\u2584\u2584 \u2588\u2588\u2551\u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u255D  \u2588\u2588\u2551  \u2588\u2588\u2551   #\n#   \u2588\u2588\uFFFD\uFFFD  \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2551\u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D   #\n#   \u255A\u2550\u255D  \u255A\u2550\u255D\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D \u255A\u2550\u2550\u2580\u2580\u2550\u255D  \u255A\u2550\u2550\u2550\u2550\u2550\u255D \u255A\u2550\u255D\u255A\u2550\u255D  \u255A\u2550\u255D\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u2550\u2550\u2550\u2550\u255D    #\n#                                                                   #\n#####################################################################\n\nYOU MUST INCLUDE THE FOLLOWING SECTIONS IN YOUR PLAN OUTPUT.\nTHIS IS NON-NEGOTIABLE. FAILURE TO INCLUDE THESE SECTIONS = INCOMPLETE PLAN.\n\n\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n\u2588 SECTION 1: TASK DEPENDENCY GRAPH (MANDATORY)                    \u2588\n\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n\nYOU MUST ANALYZE AND DOCUMENT TASK DEPENDENCIES.\n\nFor EVERY task in your plan, you MUST specify:\n- Which tasks it DEPENDS ON (blockers)\n- Which tasks DEPEND ON IT (dependents)\n- The REASON for each dependency\n\nExample format:\n```\n## Task Dependency Graph\n\n| Task | Depends On | Reason |\n|------|------------|--------|\n| Task 1 | None | Starting point, no prerequisites |\n| Task 2 | Task 1 | Requires output/artifact from Task 1 |\n| Task 3 | Task 1 | Uses same foundation established in Task 1 |\n| Task 4 | Task 2, Task 3 | Integrates results from both tasks |\n```\n\nWHY THIS MATTERS:\n- Executors need to know execution ORDER\n- Prevents blocked work from starting prematurely\n- Identifies critical path for project timeline\n\n\n\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n\u2588 SECTION 2: PARALLEL EXECUTION GRAPH (MANDATORY)                 \u2588\n\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n\nYOU MUST IDENTIFY WHICH TASKS CAN RUN IN PARALLEL.\n\nAnalyze your dependency graph and group tasks into PARALLEL EXECUTION WAVES:\n\nExample format:\n```\n## Parallel Execution Graph\n\nWave 1 (Start immediately):\n\u251C\u2500\u2500 Task 1: [description] (no dependencies)\n\u2514\u2500\u2500 Task 5: [description] (no dependencies)\n\nWave 2 (After Wave 1 completes):\n\u251C\u2500\u2500 Task 2: [description] (depends: Task 1)\n\u251C\u2500\u2500 Task 3: [description] (depends: Task 1)\n\u2514\u2500\u2500 Task 6: [description] (depends: Task 5)\n\nWave 3 (After Wave 2 completes):\n\u2514\u2500\u2500 Task 4: [description] (depends: Task 2, Task 3)\n\nCritical Path: Task 1 \u2192 Task 2 \u2192 Task 4\nEstimated Parallel Speedup: 40% faster than sequential\n```\n\nWHY THIS MATTERS:\n- MASSIVE time savings through parallelization\n- Executors can dispatch multiple agents simultaneously\n- Identifies bottlenecks in the execution plan\n\n\n\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n\u2588 SECTION 3: CATEGORY + SKILLS RECOMMENDATIONS (MANDATORY)        \u2588\n\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n\nFOR EVERY TASK, YOU MUST RECOMMEND:\n1. Which CATEGORY to use for delegation\n2. Which SKILLS to load for the delegated agent\n";
+export declare const PLAN_AGENT_SYSTEM_PREPEND_STATIC_AFTER_SKILLS = "### REQUIRED OUTPUT FORMAT\n\nFor EACH task, include a recommendation block:\n\n```\n### Task N: [Task Title]\n\n**Delegation Recommendation:**\n- Category: `[category-name]` - [reason for choice]\n- Skills: [`skill-1`, `skill-2`] - [reason each skill is needed]\n\n**Skills Evaluation:**\n- INCLUDED `skill-name`: [reason]\n- OMITTED `other-skill`: [reason domain doesn't overlap]\n```\n\nWHY THIS MATTERS:\n- Category determines the MODEL used for execution\n- Skills inject SPECIALIZED KNOWLEDGE into the executor\n- Missing a relevant skill = suboptimal execution\n- Wrong category = wrong model = poor results\n\n\n\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n\u2588 RESPONSE FORMAT SPECIFICATION (MANDATORY)                       \u2588\n\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n\nYOUR PLAN OUTPUT MUST FOLLOW THIS EXACT STRUCTURE:\n\n```markdown\n# [Plan Title]\n\n## Context\n[User request summary, interview findings, research results]\n\n## Task Dependency Graph\n[Dependency table - see Section 1]\n\n## Parallel Execution Graph  \n[Wave structure - see Section 2]\n\n## Tasks\n\n### Task 1: [Title]\n**Description**: [What to do]\n**Delegation Recommendation**:\n- Category: `[category]` - [reason]\n- Skills: [`skill-1`] - [reason]\n**Skills Evaluation**: [\u2705 included / \u274C omitted with reasons]\n**Depends On**: [Task IDs or \"None\"]\n**Acceptance Criteria**: [Verifiable conditions]\n\n### Task 2: [Title]\n[Same structure...]\n\n## Commit Strategy\n[How to commit changes atomically]\n\n## Success Criteria\n[Final verification steps]\n```\n\n#####################################################################\n#                                                                   #\n#   FAILURE TO INCLUDE THESE SECTIONS = PLAN WILL BE REJECTED      #\n#   BY MOMUS REVIEW. DO NOT SKIP. DO NOT ABBREVIATE.               #\n#                                                                   #\n#####################################################################\n</CRITICAL_REQUIREMENT_DEPENDENCY_PARALLEL_EXECUTION_CATEGORY_SKILLS>\n\n<FINAL_OUTPUT_FOR_CALLER>\n\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n\u2588 SECTION 4: ACTIONABLE TODO LIST FOR CALLER (MANDATORY)          \u2588\n\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n\nYOU MUST END YOUR RESPONSE WITH THIS SECTION.\n\n```markdown\n## TODO List (ADD THESE)\n\n> CALLER: Add these TODOs using TodoWrite/TaskCreate and execute by wave.\n\n### Wave 1 (Start Immediately - No Dependencies)\n\n- [ ] **1. [Task Title]**\n  - What: [Clear implementation steps]\n  - Depends: None\n  - Blocks: [Tasks that depend on this]\n  - Category: `category-name`\n  - Skills: [`skill-1`, `skill-2`]\n  - QA: [How to verify completion - specific command or check]\n\n- [ ] **N. [Task Title]**\n  - What: [Steps]\n  - Depends: None\n  - Blocks: [...]\n  - Category: `category-name`\n  - Skills: [`skill-1`]\n  - QA: [Verification]\n\n### Wave 2 (After Wave 1 Completes)\n\n- [ ] **2. [Task Title]**\n  - What: [Steps]\n  - Depends: 1\n  - Blocks: [4]\n  - Category: `category-name`\n  - Skills: [`skill-1`]\n  - QA: [Verification]\n\n[Continue for all waves...]\n\n## Execution Instructions\n\n1. **Wave 1**: Fire these tasks IN PARALLEL (no dependencies)\n   ```\n   task(category=\"...\", load_skills=[...], run_in_background=false, prompt=\"Task 1: ...\")\n   task(category=\"...\", load_skills=[...], run_in_background=false, prompt=\"Task N: ...\")\n   ```\n\n2. **Wave 2**: After Wave 1 completes, fire next wave IN PARALLEL\n   ```\n   task(category=\"...\", load_skills=[...], run_in_background=false, prompt=\"Task 2: ...\")\n   ```\n\n3. Continue until all waves complete\n\n4. Final QA: Verify all tasks pass their QA criteria\n```\n\nWHY THIS FORMAT IS MANDATORY:\n- Caller can directly copy TODO items\n- Wave grouping enables parallel execution\n- Each task has clear task parameters\n- QA criteria ensure verifiable completion\n</FINAL_OUTPUT_FOR_CALLER>\n\n";
+export declare function buildPlanAgentSkillsSection(categories?: AvailableCategory[], skills?: AvailableSkill[]): string;
+export declare function buildPlanAgentSystemPrepend(categories?: AvailableCategory[], skills?: AvailableSkill[]): string;
+/**
+ * List of agent names that should be treated as plan agents (receive plan system prompt).
+ * Case-insensitive matching is used.
+ */
+export declare const PLAN_AGENT_NAMES: string[];
+/**
+ * Check if the given agent name is a plan agent (receives plan system prompt).
+ */
+export declare function isPlanAgent(agentName: string | undefined): boolean;
+/**
+ * Plan family: plan + prometheus. Shares mutual delegation blocking and task tool permission.
+ * Does NOT share system prompt (only isPlanAgent controls that).
+ */
+export declare const PLAN_FAMILY_NAMES: string[];
+/**
+ * Check if the given agent belongs to the plan family (blocking + task permission).
+ */
+export declare function isPlanFamily(category: string): boolean;
+export declare function isPlanFamily(category: string | undefined): boolean;

package/dist/tools/delegate-task/delegated-model-config.d.ts

@@ -0,0 +1,3 @@
+import type { CategoryConfig } from "../../config/schema";
+import type { DelegatedModelConfig } from "./types";
+export declare function applyCategoryParams(base: DelegatedModelConfig, config: CategoryConfig | undefined): DelegatedModelConfig;

package/dist/tools/delegate-task/error-formatting.d.ts

@@ -0,0 +1,15 @@
+import type { DelegateTaskArgs } from "./types";
+/**
+ * Context for error formatting.
+ */
+export interface ErrorContext {
+    operation: string;
+    args?: DelegateTaskArgs;
+    sessionID?: string;
+    agent?: string;
+    category?: string;
+}
+/**
+ * Format an error with detailed context for debugging.
+ */
+export declare function formatDetailedError(error: unknown, ctx: ErrorContext): string;