@skj1724/oh-my-opencode 3.11.8 → 3.17.4

package/dist/openclaw/config.d.ts

@@ -1,8 +1,8 @@
 import type { OpenClawConfig, OpenClawGateway } from "./types";
+export { validateGatewayUrl } from "./gateway-url-validation";
 export declare function normalizeReplyListenerConfig(config: OpenClawConfig): OpenClawConfig;
 export declare function resolveGateway(config: OpenClawConfig, event: string): {
     gatewayName: string;
     gateway: OpenClawGateway;
     instruction: string;
 } | null;
-export declare function validateGatewayUrl(url: string): boolean;

package/dist/openclaw/dispatcher.d.ts

@@ -1,16 +1,12 @@
-import type { OpenClawGateway } from "./types";
-export declare function validateGatewayUrl(url: string): boolean;
+import type { OpenClawGateway, WakeResult } from "./types";
 export declare function interpolateInstruction(template: string, variables: Record<string, string | undefined>): string;
 export declare function shellEscapeArg(value: string): string;
 export declare function resolveCommandTimeoutMs(gatewayTimeout?: number, envTimeoutRaw?: string | undefined): number;
-export declare function wakeGateway(gatewayName: string, gatewayConfig: OpenClawGateway, payload: unknown): Promise<{
-    gateway: string;
-    success: boolean;
-    error?: string;
-    statusCode?: number;
-}>;
-export declare function wakeCommandGateway(gatewayName: string, gatewayConfig: OpenClawGateway, variables: Record<string, string | undefined>): Promise<{
-    gateway: string;
-    success: boolean;
-    error?: string;
-}>;
+export declare function wakeGateway(gatewayName: string, gatewayConfig: OpenClawGateway, payload: unknown): Promise<WakeResult>;
+export declare function wakeCommandGateway(gatewayName: string, gatewayConfig: OpenClawGateway, variables: Record<string, string | undefined>): Promise<WakeResult>;
+type KillableProcess = {
+    pid?: number;
+    kill: (signal?: NodeJS.Signals) => void;
+};
+export declare function terminateCommandProcess(proc: KillableProcess, signal: NodeJS.Signals): void;
+export {};

package/dist/openclaw/gateway-url-validation.d.ts

@@ -0,0 +1 @@
+export declare function validateGatewayUrl(url: string): boolean;

package/dist/openclaw/reply-listener-discord.d.ts

@@ -0,0 +1,4 @@
+import { ReplyListenerRateLimiter } from "./reply-listener-injection";
+import { type ReplyListenerDaemonState } from "./reply-listener-state";
+import type { OpenClawConfig } from "./types";
+export declare function pollDiscordReplies(config: OpenClawConfig, state: ReplyListenerDaemonState, rateLimiter: ReplyListenerRateLimiter): Promise<void>;

package/dist/openclaw/reply-listener-injection.d.ts

@@ -0,0 +1,10 @@
+import type { OpenClawConfig } from "./types";
+export declare function sanitizeReplyInput(text: string): string;
+export declare class ReplyListenerRateLimiter {
+    private readonly maxPerMinute;
+    private readonly timestamps;
+    private readonly windowMs;
+    constructor(maxPerMinute: number);
+    canProceed(): boolean;
+}
+export declare function injectReplyIntoPane(paneId: string, text: string, platform: string, config: OpenClawConfig): Promise<boolean>;

package/dist/openclaw/reply-listener-log.d.ts

@@ -0,0 +1,2 @@
+export declare function writeSecureReplyListenerFile(filePath: string, content: string): void;
+export declare function logReplyListenerMessage(message: string): void;

package/dist/openclaw/reply-listener-paths.d.ts

@@ -0,0 +1,7 @@
+export declare const REPLY_LISTENER_SECURE_FILE_MODE = 384;
+export declare function getReplyListenerStateDir(): string;
+export declare function getReplyListenerPidFilePath(): string;
+export declare function getReplyListenerStateFilePath(): string;
+export declare function getReplyListenerConfigFilePath(): string;
+export declare function getReplyListenerLogFilePath(): string;
+export declare function ensureReplyListenerStateDir(): void;

package/dist/openclaw/reply-listener-process.d.ts

@@ -0,0 +1,4 @@
+export declare const REPLY_LISTENER_DAEMON_IDENTITY_MARKER = "--openclaw-reply-listener-daemon";
+export declare function createReplyListenerDaemonEnv(extraEnv: Record<string, string>): Record<string, string>;
+export declare function isReplyListenerProcessRunning(pid: number): boolean;
+export declare function isReplyListenerDaemonProcess(pid: number): Promise<boolean>;

package/dist/openclaw/reply-listener-spawn.d.ts

@@ -0,0 +1,5 @@
+export interface ReplyListenerSpawnProcess {
+    pid: number | undefined;
+    unref(): void;
+}
+export declare function spawnReplyListenerDaemon(daemonScript: string, startupToken: string): ReplyListenerSpawnProcess;

package/dist/openclaw/reply-listener-startup.d.ts

@@ -0,0 +1,12 @@
+import type { ReplyListenerDaemonState } from "./reply-listener-state";
+interface WaitForReplyListenerReadyOptions {
+    pid: number;
+    startupToken: string;
+    timeoutMs: number;
+    readState: () => ReplyListenerDaemonState | null;
+    sleep: (ms: number) => Promise<void>;
+}
+export declare function createReplyListenerStartupToken(): string;
+export declare function getReplyListenerStartupTimeoutMs(): number;
+export declare function waitForReplyListenerReady(options: WaitForReplyListenerReadyOptions): Promise<ReplyListenerDaemonState | null>;
+export {};

package/dist/openclaw/reply-listener-state.d.ts

@@ -0,0 +1,29 @@
+import type { OpenClawConfig } from "./types";
+export declare const REPLY_LISTENER_STARTUP_TOKEN_ENV = "OMO_OPENCLAW_REPLY_LISTENER_STARTUP_TOKEN";
+export interface ReplyListenerDaemonState {
+    isRunning: boolean;
+    pid: number | null;
+    startedAt: string;
+    startupToken: string | null;
+    configSignature: string | null;
+    lastPollAt: string | null;
+    telegramLastUpdateId: number | null;
+    discordLastMessageId: string | null;
+    lastDiscordMessageId: string | null;
+    messagesSeen: number;
+    messagesInjected: number;
+    errors: number;
+    lastError?: string;
+}
+export declare function createPendingReplyListenerState(startupToken: string): ReplyListenerDaemonState;
+export declare function readReplyListenerDaemonState(): ReplyListenerDaemonState | null;
+export declare function writeReplyListenerDaemonState(state: ReplyListenerDaemonState): void;
+export declare function readReplyListenerDaemonConfig(): OpenClawConfig | null;
+export declare function writeReplyListenerDaemonConfig(config: OpenClawConfig): void;
+export declare function readReplyListenerPid(): number | null;
+export declare function writeReplyListenerPid(pid: number): void;
+export declare function removeReplyListenerPid(): void;
+export declare function getReplyListenerStartupTokenFromEnv(): string | null;
+export declare function recordReplyListenerPoll(state: ReplyListenerDaemonState, pid: number): void;
+export declare function recordSeenDiscordMessage(state: ReplyListenerDaemonState, messageId: string): void;
+export declare function markReplyListenerStopped(state: ReplyListenerDaemonState | null, error?: string): ReplyListenerDaemonState;

package/dist/openclaw/reply-listener-telegram.d.ts

@@ -0,0 +1,4 @@
+import { ReplyListenerRateLimiter } from "./reply-listener-injection";
+import { type ReplyListenerDaemonState } from "./reply-listener-state";
+import type { OpenClawConfig } from "./types";
+export declare function pollTelegramReplies(config: OpenClawConfig, state: ReplyListenerDaemonState, rateLimiter: ReplyListenerRateLimiter): Promise<void>;

package/dist/openclaw/reply-listener.d.ts

@@ -1,31 +1,18 @@
+import { logReplyListenerMessage } from "./reply-listener-log";
+import { type ReplyListenerDaemonState } from "./reply-listener-state";
 import type { OpenClawConfig } from "./types";
-export declare const DAEMON_IDENTITY_MARKER = "--openclaw-reply-listener-daemon";
-export declare function logReplyListenerMessage(message: string): void;
-interface DaemonState {
-    isRunning: boolean;
-    pid: number | null;
-    startedAt: string;
-    lastPollAt: string | null;
-    telegramLastUpdateId: number | null;
-    discordLastMessageId: string | null;
-    messagesInjected: number;
-    errors: number;
-    lastError?: string;
-}
-export declare function isReplyListenerProcess(pid: number): Promise<boolean>;
 export declare function isDaemonRunning(): Promise<boolean>;
-export declare function sanitizeReplyInput(text: string): string;
 export declare function pollLoop(): Promise<void>;
 export declare function startReplyListener(config: OpenClawConfig): Promise<{
     success: boolean;
     message: string;
-    state?: DaemonState;
+    state?: ReplyListenerDaemonState;
     error?: string;
 }>;
 export declare function stopReplyListener(): Promise<{
     success: boolean;
     message: string;
-    state?: DaemonState;
+    state?: ReplyListenerDaemonState;
     error?: string;
 }>;
-export {};
+export { logReplyListenerMessage };

package/dist/openclaw/runtime-dispatch.d.ts

@@ -0,0 +1,17 @@
+import type { OpenClawConfig, WakeResult } from "./types";
+interface DispatchOpenClawContext {
+    sessionId?: string;
+    projectPath?: string;
+    tmuxPaneId?: string;
+    tmuxSession?: string;
+    replyChannel?: string;
+    replyTarget?: string;
+    replyThread?: string;
+}
+interface DispatchOpenClawEventParams {
+    config: OpenClawConfig;
+    rawEvent: string;
+    context: DispatchOpenClawContext;
+}
+export declare function dispatchOpenClawEvent(params: DispatchOpenClawEventParams): Promise<WakeResult | null>;
+export {};

package/dist/openclaw/types.d.ts

@@ -35,4 +35,8 @@ export interface WakeResult {
     success: boolean;
     error?: string;
     statusCode?: number;
+    messageId?: string;
+    platform?: string;
+    channelId?: string;
+    threadId?: string;
 }

package/dist/plugin/chat-params.d.ts

@@ -21,6 +21,7 @@ export type ChatParamsOutput = {
     temperature?: number;
     topP?: number;
     topK?: number;
+    maxOutputTokens?: number;
     options: Record<string, unknown>;
 };
 export declare function createChatParamsHandler(args: {

package/dist/plugin/command-execute-before.d.ts

@@ -0,0 +1,19 @@
+import type { CreatedHooks } from "../create-hooks";
+type CommandExecuteBeforeInput = {
+    command: string;
+    sessionID: string;
+    arguments: string;
+};
+type CommandExecuteBeforeOutput = {
+    parts: Array<{
+        type: string;
+        text?: string;
+        [key: string]: unknown;
+    }>;
+    message?: Record<string, unknown>;
+};
+declare const NATIVE_LOOP_TRIGGERED_FLAG = "__omoNativeLoopTriggered";
+export declare function createCommandExecuteBeforeHandler(args: {
+    hooks: CreatedHooks;
+}): (input: CommandExecuteBeforeInput, output: CommandExecuteBeforeOutput) => Promise<void>;
+export { NATIVE_LOOP_TRIGGERED_FLAG };

package/dist/plugin/hooks/create-core-hooks.d.ts

@@ -1,10 +1,12 @@
 import type { HookName, OhMyOpenCodeConfig } from "../../config";
+import type { ModelFallbackControllerAccessor } from "../../hooks/model-fallback";
 import type { PluginContext } from "../types";
 import type { ModelCacheState } from "../../plugin-state";
 export declare function createCoreHooks(args: {
     ctx: PluginContext;
     pluginConfig: OhMyOpenCodeConfig;
     modelCacheState: ModelCacheState;
+    modelFallbackControllerAccessor?: ModelFallbackControllerAccessor;
     isHookEnabled: (hookName: HookName) => boolean;
     safeHookEnabled: boolean;
 }): {
@@ -12,6 +14,7 @@ export declare function createCoreHooks(args: {
     keywordDetector: ReturnType<typeof import("../../hooks").createKeywordDetectorHook> | null;
     contextInjectorMessagesTransform: ReturnType<typeof import("../../features/context-injector").createContextInjectorMessagesTransformHook>;
     thinkingBlockValidator: ReturnType<typeof import("../../hooks").createThinkingBlockValidatorHook> | null;
+    toolPairValidator: ReturnType<typeof import("../../hooks").createToolPairValidatorHook> | null;
     commentChecker: ReturnType<typeof import("../../hooks").createCommentCheckerHooks> | null;
     toolOutputTruncator: ReturnType<typeof import("../../hooks").createToolOutputTruncatorHook> | null;
     directoryAgentsInjector: ReturnType<typeof import("../../hooks").createDirectoryAgentsInjectorHook> | null;
@@ -20,6 +23,7 @@ export declare function createCoreHooks(args: {
     rulesInjector: ReturnType<typeof import("../../hooks").createRulesInjectorHook> | null;
     tasksTodowriteDisabler: ReturnType<typeof import("../../hooks").createTasksTodowriteDisablerHook> | null;
     writeExistingFileGuard: ReturnType<typeof import("../../hooks").createWriteExistingFileGuardHook> | null;
+    bashFileReadGuard: ReturnType<typeof import("../../hooks").createBashFileReadGuardHook> | null;
     hashlineReadEnhancer: ReturnType<typeof import("../../hooks").createHashlineReadEnhancerHook> | null;
     jsonErrorRecovery: ReturnType<typeof import("../../hooks").createJsonErrorRecoveryHook> | null;
     readImageResizer: ReturnType<typeof import("../../hooks").createReadImageResizerHook> | null;
@@ -48,4 +52,5 @@ export declare function createCoreHooks(args: {
     taskResumeInfo: ReturnType<typeof import("../../hooks").createTaskResumeInfoHook> | null;
     anthropicEffort: ReturnType<typeof import("../../hooks/anthropic-effort").createAnthropicEffortHook> | null;
     runtimeFallback: ReturnType<typeof import("../../hooks").createRuntimeFallbackHook> | null;
+    legacyPluginToast: ReturnType<typeof import("../../hooks").createLegacyPluginToastHook> | null;
 };

package/dist/plugin/hooks/create-session-hooks.d.ts

@@ -1,7 +1,8 @@
 import type { OhMyOpenCodeConfig, HookName } from "../../config";
+import type { ModelFallbackControllerAccessor } from "../../hooks/model-fallback";
 import type { ModelCacheState } from "../../plugin-state";
 import type { PluginContext } from "../types";
-import { createContextWindowMonitorHook, createSessionRecoveryHook, createSessionNotification, createThinkModeHook, createModelFallbackHook, createAnthropicContextWindowLimitRecoveryHook, createAutoUpdateCheckerHook, createAgentUsageReminderHook, createNonInteractiveEnvHook, createInteractiveBashSessionHook, createRalphLoopHook, createEditErrorRecoveryHook, createDelegateTaskRetryHook, createTaskResumeInfoHook, createStartWorkHook, createPrometheusMdOnlyHook, createSisyphusJuniorNotepadHook, createNoSisyphusGptHook, createNoHephaestusNonGptHook, createQuestionLabelTruncatorHook, createPreemptiveCompactionHook, createRuntimeFallbackHook } from "../../hooks";
+import { createContextWindowMonitorHook, createSessionRecoveryHook, createSessionNotification, createThinkModeHook, createModelFallbackHook, createAnthropicContextWindowLimitRecoveryHook, createAutoUpdateCheckerHook, createAgentUsageReminderHook, createNonInteractiveEnvHook, createInteractiveBashSessionHook, createRalphLoopHook, createEditErrorRecoveryHook, createDelegateTaskRetryHook, createTaskResumeInfoHook, createStartWorkHook, createPrometheusMdOnlyHook, createSisyphusJuniorNotepadHook, createNoSisyphusGptHook, createNoHephaestusNonGptHook, createQuestionLabelTruncatorHook, createPreemptiveCompactionHook, createRuntimeFallbackHook, createLegacyPluginToastHook } from "../../hooks";
 import { createAnthropicEffortHook } from "../../hooks/anthropic-effort";
 export type SessionHooks = {
     contextWindowMonitor: ReturnType<typeof createContextWindowMonitorHook> | null;
@@ -27,11 +28,13 @@ export type SessionHooks = {
     taskResumeInfo: ReturnType<typeof createTaskResumeInfoHook> | null;
     anthropicEffort: ReturnType<typeof createAnthropicEffortHook> | null;
     runtimeFallback: ReturnType<typeof createRuntimeFallbackHook> | null;
+    legacyPluginToast: ReturnType<typeof createLegacyPluginToastHook> | null;
 };
 export declare function createSessionHooks(args: {
     ctx: PluginContext;
     pluginConfig: OhMyOpenCodeConfig;
     modelCacheState: ModelCacheState;
+    modelFallbackControllerAccessor?: ModelFallbackControllerAccessor;
     isHookEnabled: (hookName: HookName) => boolean;
     safeHookEnabled: boolean;
 }): SessionHooks;

package/dist/plugin/hooks/create-tool-guard-hooks.d.ts

@@ -1,7 +1,7 @@
 import type { HookName, OhMyOpenCodeConfig } from "../../config";
 import type { ModelCacheState } from "../../plugin-state";
 import type { PluginContext } from "../types";
-import { createCommentCheckerHooks, createToolOutputTruncatorHook, createDirectoryAgentsInjectorHook, createDirectoryReadmeInjectorHook, createEmptyTaskResponseDetectorHook, createRulesInjectorHook, createTasksTodowriteDisablerHook, createWriteExistingFileGuardHook, createHashlineReadEnhancerHook, createReadImageResizerHook, createJsonErrorRecoveryHook, createTodoDescriptionOverrideHook, createWebFetchRedirectGuardHook } from "../../hooks";
+import { createCommentCheckerHooks, createToolOutputTruncatorHook, createDirectoryAgentsInjectorHook, createDirectoryReadmeInjectorHook, createEmptyTaskResponseDetectorHook, createRulesInjectorHook, createTasksTodowriteDisablerHook, createWriteExistingFileGuardHook, createBashFileReadGuardHook, createHashlineReadEnhancerHook, createReadImageResizerHook, createJsonErrorRecoveryHook, createTodoDescriptionOverrideHook, createWebFetchRedirectGuardHook } from "../../hooks";
 export type ToolGuardHooks = {
     commentChecker: ReturnType<typeof createCommentCheckerHooks> | null;
     toolOutputTruncator: ReturnType<typeof createToolOutputTruncatorHook> | null;
@@ -11,6 +11,7 @@ export type ToolGuardHooks = {
     rulesInjector: ReturnType<typeof createRulesInjectorHook> | null;
     tasksTodowriteDisabler: ReturnType<typeof createTasksTodowriteDisablerHook> | null;
     writeExistingFileGuard: ReturnType<typeof createWriteExistingFileGuardHook> | null;
+    bashFileReadGuard: ReturnType<typeof createBashFileReadGuardHook> | null;
     hashlineReadEnhancer: ReturnType<typeof createHashlineReadEnhancerHook> | null;
     jsonErrorRecovery: ReturnType<typeof createJsonErrorRecoveryHook> | null;
     readImageResizer: ReturnType<typeof createReadImageResizerHook> | null;

package/dist/plugin/hooks/create-transform-hooks.d.ts

@@ -1,16 +1,19 @@
 import type { OhMyOpenCodeConfig } from "../../config";
 import type { PluginContext } from "../types";
-import { createClaudeCodeHooksHook, createKeywordDetectorHook, createThinkingBlockValidatorHook } from "../../hooks";
+import type { RalphLoopHook } from "../../hooks/ralph-loop";
+import { createClaudeCodeHooksHook, createKeywordDetectorHook, createThinkingBlockValidatorHook, createToolPairValidatorHook } from "../../hooks";
 import { createContextInjectorMessagesTransformHook } from "../../features/context-injector";
 export type TransformHooks = {
     claudeCodeHooks: ReturnType<typeof createClaudeCodeHooksHook> | null;
     keywordDetector: ReturnType<typeof createKeywordDetectorHook> | null;
     contextInjectorMessagesTransform: ReturnType<typeof createContextInjectorMessagesTransformHook>;
     thinkingBlockValidator: ReturnType<typeof createThinkingBlockValidatorHook> | null;
+    toolPairValidator: ReturnType<typeof createToolPairValidatorHook> | null;
 };
 export declare function createTransformHooks(args: {
     ctx: PluginContext;
     pluginConfig: OhMyOpenCodeConfig;
     isHookEnabled: (hookName: string) => boolean;
     safeHookEnabled?: boolean;
+    ralphLoop?: RalphLoopHook | null;
 }): TransformHooks;

package/dist/plugin/tool-registry.d.ts

@@ -1,16 +1,41 @@
 import type { AvailableCategory } from "../agents/dynamic-agent-prompt-builder";
 import type { OhMyOpenCodeConfig } from "../config";
 import type { PluginContext, ToolsRecord } from "./types";
+import { builtinTools, createBackgroundTools, createCallOmoAgent, createLookAt, createSkillMcpTool, createSkillTool, createGrepTools, createGlobTools, createAstGrepTools, createSessionManagerTools, createDelegateTask, discoverCommandsSync, interactive_bash, createTaskCreateTool, createTaskGetTool, createTaskList, createTaskUpdateTool, createHashlineEditTool } from "../tools";
 import type { Managers } from "../create-managers";
 import type { SkillContext } from "./skill-context";
+type ToolRegistryFactories = {
+    builtinTools: typeof builtinTools;
+    createBackgroundTools: typeof createBackgroundTools;
+    createCallOmoAgent: typeof createCallOmoAgent;
+    createLookAt: typeof createLookAt;
+    createSkillMcpTool: typeof createSkillMcpTool;
+    createSkillTool: typeof createSkillTool;
+    createGrepTools: typeof createGrepTools;
+    createGlobTools: typeof createGlobTools;
+    createAstGrepTools: typeof createAstGrepTools;
+    createSessionManagerTools: typeof createSessionManagerTools;
+    createDelegateTask: typeof createDelegateTask;
+    discoverCommandsSync: typeof discoverCommandsSync;
+    interactive_bash: typeof interactive_bash;
+    createTaskCreateTool: typeof createTaskCreateTool;
+    createTaskGetTool: typeof createTaskGetTool;
+    createTaskList: typeof createTaskList;
+    createTaskUpdateTool: typeof createTaskUpdateTool;
+    createHashlineEditTool: typeof createHashlineEditTool;
+};
 export type ToolRegistryResult = {
     filteredTools: ToolsRecord;
     taskSystemEnabled: boolean;
 };
+export declare function trimToolsToCap(filteredTools: ToolsRecord, maxTools: number): void;
 export declare function createToolRegistry(args: {
     ctx: PluginContext;
     pluginConfig: OhMyOpenCodeConfig;
-    managers: Pick<Managers, "backgroundManager" | "tmuxSessionManager" | "skillMcpManager">;
+    managers: Pick<Managers, "backgroundManager" | "tmuxSessionManager" | "skillMcpManager" | "modelFallbackControllerAccessor">;
     skillContext: SkillContext;
     availableCategories: AvailableCategory[];
+    interactiveBashEnabled?: boolean;
+    toolFactories?: Partial<ToolRegistryFactories>;
 }): ToolRegistryResult;
+export {};

package/dist/plugin/types.d.ts

@@ -14,5 +14,6 @@ export type TmuxConfig = {
     main_pane_size: number;
     main_pane_min_width: number;
     agent_pane_min_width: number;
+    isolation: "inline" | "window" | "session";
 };
 export {};

package/dist/plugin-handlers/agent-priority-order.d.ts

@@ -1 +1,12 @@
+/**
+ * CRITICAL: This is the ONLY source of truth for core agent ordering.
+ * The order is: sisyphus → hephaestus → prometheus → atlas
+ *
+ * DO NOT CHANGE THIS ORDER. Any PR attempting to modify this order
+ * or introduce alternative ordering mechanisms (ZWSP prefixes, sort
+ * shims, etc.) will be rejected.
+ *
+ * See: src/plugin-handlers/AGENTS.md for architectural context.
+ */
+export declare const CANONICAL_CORE_AGENT_ORDER: readonly ["sisyphus", "hephaestus", "prometheus", "atlas"];
 export declare function reorderAgentsByPriority(agents: Record<string, unknown>): Record<string, unknown>;

package/dist/shared/agent-display-names.d.ts

@@ -1,17 +1,38 @@
 /**
  * Agent config keys to display names mapping.
  * Config keys are lowercase (e.g., "sisyphus", "atlas").
- * Display names include suffixes for UI/logs (e.g., "Sisyphus (Ultraworker)").
+ * Display names include suffixes for UI/logs (e.g., "Sisyphus - Ultraworker").
+ *
+ * IMPORTANT: Display names MUST NOT contain parentheses or other characters
+ * that are invalid in HTTP header values per RFC 7230. OpenCode passes the
+ * agent name in the `x-opencode-agent-name` header, and parentheses cause
+ * header validation failures that prevent agents from appearing in the UI
+ * type selector dropdown. Use ` - ` (space-dash-space) instead of `(...)`.
  */
 export declare const AGENT_DISPLAY_NAMES: Record<string, string>;
+export declare function stripInvisibleAgentCharacters(agentName: string): string;
+export declare function stripAgentListSortPrefix(agentName: string): string;
+export declare function getAgentRuntimeName(configKey: string): string;
 /**
  * Get display name for an agent config key.
  * Uses case-insensitive lookup for backward compatibility.
  * Returns original key if not found.
  */
 export declare function getAgentDisplayName(configKey: string): string;
+/**
+ * Runtime-facing agent name used for OpenCode list ordering.
+ */
+export declare function getAgentListDisplayName(configKey: string): string;
 /**
  * Resolve an agent name (display name or config key) to its lowercase config key.
- * "Atlas (Plan Executor)" → "atlas", "atlas" → "atlas", "unknown" → "unknown"
+ * "Atlas - Plan Executor" -> "atlas", "Atlas (Plan Executor)" -> "atlas", "atlas" -> "atlas"
  */
 export declare function getAgentConfigKey(agentName: string): string;
+/**
+ * Normalize an agent name for prompt APIs.
+ * - Known display names -> canonical display names
+ * - Known config keys (any case) -> canonical display names
+ * - Unknown/custom names -> preserved as-is (trimmed)
+ */
+export declare function normalizeAgentForPrompt(agentName: string | undefined): string | undefined;
+export declare function normalizeAgentForPromptKey(agentName: string | undefined): string | undefined;

package/dist/shared/agent-tool-restrictions.d.ts

@@ -1,7 +1,2 @@
-/**
- * Agent tool restrictions for session.prompt calls.
- * OpenCode SDK's session.prompt `tools` parameter expects boolean values.
- * true = tool allowed, false = tool denied.
- */
 export declare function getAgentToolRestrictions(agentName: string): Record<string, boolean>;
 export declare function hasAgentToolRestrictions(agentName: string): boolean;

package/dist/shared/archive-entry-validator.d.ts

@@ -0,0 +1,6 @@
+export type ArchiveEntry = {
+    path: string;
+    type: "file" | "directory" | "symlink" | "hardlink";
+    linkPath?: string;
+};
+export declare function validateArchiveEntries(entries: ArchiveEntry[], destDir: string): void;

package/dist/shared/background-output-consumption.d.ts

@@ -0,0 +1,5 @@
+export declare function recordBackgroundOutputConsumption(parentSessionID: string | undefined, parentMessageID: string | undefined, taskSessionID: string | undefined): void;
+export declare function restoreBackgroundOutputConsumption(parentSessionID: string | undefined, parentMessageID: string | undefined): void;
+export declare function clearBackgroundOutputConsumptionsForParentSession(sessionID: string | undefined): void;
+export declare function clearBackgroundOutputConsumptionsForTaskSession(taskSessionID: string | undefined): void;
+export declare function clearBackgroundOutputConsumptionState(): void;

package/dist/shared/compaction-marker.d.ts

@@ -0,0 +1,13 @@
+type CompactionMessageLike = {
+    agent?: unknown;
+    info?: {
+        agent?: unknown;
+    };
+    parts?: unknown;
+};
+export declare function isCompactionAgent(agent: unknown): boolean;
+export declare function hasCompactionPart(parts: unknown): boolean;
+export declare function isCompactionMessage(message: CompactionMessageLike): boolean;
+export declare function getCompactionPartStorageDir(messageID: string): string;
+export declare function hasCompactionPartInStorage(messageID: string | undefined): boolean;
+export {};

package/dist/shared/connected-providers-cache.d.ts

@@ -47,6 +47,7 @@ export declare function createConnectedProvidersCacheStore(getCacheDir?: () => s
             }>;
         };
     }) => Promise<void>;
+    _resetMemCacheForTesting: () => void;
 };
 export declare function findProviderModelMetadata(providerID: string, modelID: string, cache?: ProviderModelsCache | null): ModelMetadata | undefined;
 export declare const readConnectedProvidersCache: () => string[] | null, hasConnectedProvidersCache: () => boolean, readProviderModelsCache: () => ProviderModelsCache | null, hasProviderModelsCache: () => boolean, writeProviderModelsCache: (data: {
@@ -64,4 +65,4 @@ export declare const readConnectedProvidersCache: () => string[] | null, hasConn
             };
         }>;
     };
-}) => Promise<void>;
+}) => Promise<void>, _resetMemCacheForTesting: () => void;

package/dist/shared/contains-path.d.ts

@@ -0,0 +1,2 @@
+export declare function containsPath(rootPath: string, candidatePath: string): boolean;
+export declare function isWithinProject(candidatePath: string, projectRoot: string): boolean;

package/dist/shared/external-plugin-detector.d.ts

@@ -7,12 +7,26 @@ export interface ExternalNotifierResult {
     pluginName: string | null;
     allPlugins: string[];
 }
+export interface ExternalSkillPluginResult {
+    detected: boolean;
+    pluginName: string | null;
+    allPlugins: string[];
+}
 /**
  * Detect if any external notification plugin is configured.
  * Returns information about detected plugins for logging/warning.
  */
 export declare function detectExternalNotificationPlugin(directory: string): ExternalNotifierResult;
+/**
+ * Detect if any external skill plugin is configured.
+ * Returns information about detected plugins for logging/warning.
+ */
+export declare function detectExternalSkillPlugin(directory: string): ExternalSkillPluginResult;
 /**
  * Generate a warning message for users with conflicting notification plugins.
  */
 export declare function getNotificationConflictWarning(pluginName: string): string;
+/**
+ * Generate a warning message for users with conflicting skill plugins.
+ */
+export declare function getSkillPluginConflictWarning(pluginName: string): string;

package/dist/shared/index.d.ts

@@ -1,5 +1,6 @@
 export * from "./frontmatter";
 export * from "./command-executor";
+export * from "./contains-path";
 export * from "./file-reference-resolver";
 export * from "./model-sanitizer";
 export * from "./logger";
@@ -16,6 +17,7 @@ export * from "./claude-config-dir";
 export * from "./jsonc-parser";
 export * from "./migration";
 export * from "./opencode-config-dir";
+export * from "./resolve-agent-definition-paths";
 export type { OpenCodeBinaryType, OpenCodeConfigDirOptions, OpenCodeConfigPaths, } from "./opencode-config-dir-types";
 export * from "./opencode-version";
 export * from "./opencode-storage-detection";
@@ -23,6 +25,7 @@ export * from "./permission-compat";
 export * from "./external-plugin-detector";
 export * from "./zip-extractor";
 export * from "./binary-downloader";
+export * from "./write-file-atomically";
 export * from "./agent-variant";
 export * from "./session-cursor";
 export * from "./shell-env";
@@ -46,6 +49,7 @@ export * from "./session-utils";
 export * from "./tmux";
 export * from "./model-suggestion-retry";
 export * from "./opencode-server-auth";
+export * from "./opencode-provider-auth";
 export * from "./opencode-http-api";
 export * from "./port-utils";
 export * from "./git-worktree";
@@ -58,7 +62,12 @@ export * from "./project-discovery-dirs";
 export * from "./normalize-sdk-response";
 export * from "./session-directory-resolver";
 export * from "./prompt-tools";
+export * from "./compaction-marker";
 export * from "./internal-initiator-marker";
 export * from "./plugin-command-discovery";
 export { SessionCategoryRegistry } from "./session-category-registry";
 export * from "./plugin-identity";
+export * from "./log-legacy-plugin-startup-warning";
+export * from "./task-system-enabled";
+export * from "./parse-tools-config";
+export { parseModelString } from "./model-string-parser";

package/dist/shared/internal-initiator-marker.d.ts

@@ -1,4 +1,5 @@
 export declare const OMO_INTERNAL_INITIATOR_MARKER = "<!-- OMO_INTERNAL_INITIATOR -->";
+export declare function stripInternalInitiatorMarkers(text: string): string;
 export declare function createInternalAgentTextPart(text: string): {
     type: "text";
     text: string;

package/dist/shared/is-abort-error.d.ts

@@ -0,0 +1 @@
+export declare function isAbortError(error: unknown): boolean;

package/dist/shared/json-file-cache-store.d.ts

@@ -0,0 +1,16 @@
+type JsonFileCacheStoreOptions<TValue> = {
+    getCacheDir: () => string;
+    filename: string;
+    logPrefix: string;
+    cacheLabel: string;
+    describe: (value: TValue) => Record<string, unknown>;
+    serialize?: (value: TValue) => string;
+};
+type JsonFileCacheStore<TValue> = {
+    read: () => TValue | null;
+    has: () => boolean;
+    write: (value: TValue) => void;
+    resetMemory: () => void;
+};
+export declare function createJsonFileCacheStore<TValue>(options: JsonFileCacheStoreOptions<TValue>): JsonFileCacheStore<TValue>;
+export {};

package/dist/shared/jsonc-parser.d.ts

@@ -16,4 +16,5 @@ export declare function detectConfigFile(basePath: string): {
 export declare function detectPluginConfigFile(dir: string): {
     format: "json" | "jsonc" | "none";
     path: string;
+    legacyPath?: string;
 };

package/dist/shared/legacy-plugin-warning.d.ts

@@ -0,0 +1,7 @@
+export interface LegacyPluginCheckResult {
+    hasLegacyEntry: boolean;
+    hasCanonicalEntry: boolean;
+    legacyEntries: string[];
+    configPath: string | null;
+}
+export declare function checkForLegacyPluginEntry(overrideConfigDir?: string): LegacyPluginCheckResult;

package/dist/shared/load-opencode-plugins.d.ts

@@ -0,0 +1 @@
+export declare function loadOpencodePlugins(directory: string): string[];

package/dist/shared/log-legacy-plugin-startup-warning.d.ts

@@ -0,0 +1,10 @@
+import { checkForLegacyPluginEntry } from "./legacy-plugin-warning";
+import { log } from "./logger";
+import { migrateLegacyPluginEntry } from "./migrate-legacy-plugin-entry";
+type LogLegacyPluginStartupWarningDeps = {
+    checkForLegacyPluginEntry?: typeof checkForLegacyPluginEntry;
+    log?: typeof log;
+    migrateLegacyPluginEntry?: typeof migrateLegacyPluginEntry;
+};
+export declare function logLegacyPluginStartupWarning(deps?: LogLegacyPluginStartupWarningDeps): void;
+export {};