oh-my-opencode 3.13.1 → 3.15.0

package/dist/openclaw/dispatcher.d.ts

@@ -14,3 +14,9 @@ export declare function wakeCommandGateway(gatewayName: string, gatewayConfig: O
     success: boolean;
     error?: string;
 }>;
+type KillableProcess = {
+    pid?: number;
+    kill: (signal?: NodeJS.Signals) => void;
+};
+export declare function terminateCommandProcess(proc: KillableProcess, signal: NodeJS.Signals): void;
+export {};

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

@@ -27,5 +27,6 @@ export declare function createChatParamsHandler(args: {
     anthropicEffort: {
         "chat.params"?: (input: ChatParamsHookInput, output: ChatParamsOutput) => Promise<void>;
     } | null;
+    client?: unknown;
 }): (input: unknown, output: unknown) => Promise<void>;
 export {};

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

@@ -0,0 +1,17 @@
+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;
+    }>;
+};
+export declare function createCommandExecuteBeforeHandler(args: {
+    hooks: CreatedHooks;
+}): (input: CommandExecuteBeforeInput, output: CommandExecuteBeforeOutput) => Promise<void>;
+export {};

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

@@ -12,6 +12,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 +21,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 +50,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,7 @@
 import type { OhMyOpenCodeConfig, HookName } from "../../config";
 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,6 +27,7 @@ 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;

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,12 +1,13 @@
 import type { OhMyOpenCodeConfig } from "../../config";
 import type { PluginContext } from "../types";
-import { createClaudeCodeHooksHook, createKeywordDetectorHook, createThinkingBlockValidatorHook } from "../../hooks";
+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;

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

@@ -7,6 +7,7 @@ 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;

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-dispose.d.ts

@@ -6,5 +6,8 @@ export declare function createPluginDispose(args: {
     skillMcpManager: {
         disconnectAll: () => Promise<void>;
     };
+    lspManager: {
+        stopAll: () => Promise<void>;
+    };
     disposeHooks: () => void;
 }): PluginDispose;

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

@@ -10,8 +10,16 @@ export declare const AGENT_DISPLAY_NAMES: Record<string, string>;
  * Returns original key if not found.
  */
 export declare function getAgentDisplayName(configKey: string): string;
+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"
  */
 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;

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/connected-providers-cache.d.ts

@@ -1,11 +1,26 @@
-interface ModelMetadata {
+export interface ModelMetadata {
     id: string;
     provider?: string;
     context?: number;
     output?: number;
     name?: string;
+    variants?: Record<string, unknown>;
+    limit?: {
+        context?: number;
+        input?: number;
+        output?: number;
+    };
+    modalities?: {
+        input?: string[];
+        output?: string[];
+    };
+    capabilities?: Record<string, unknown>;
+    reasoning?: boolean;
+    temperature?: boolean;
+    tool_call?: boolean;
+    [key: string]: unknown;
 }
-interface ProviderModelsCache {
+export interface ProviderModelsCache {
     models: Record<string, string[] | ModelMetadata[]>;
     connected: string[];
     updatedAt: string;
@@ -16,7 +31,7 @@ export declare function createConnectedProvidersCacheStore(getCacheDir?: () => s
     readProviderModelsCache: () => ProviderModelsCache | null;
     hasProviderModelsCache: () => boolean;
     writeProviderModelsCache: (data: {
-        models: Record<string, string[]>;
+        models: Record<string, string[] | ModelMetadata[]>;
         connected: string[];
     }) => void;
     updateConnectedProvidersCache: (client: {
@@ -32,9 +47,11 @@ 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: {
-    models: Record<string, string[]>;
+    models: Record<string, string[] | ModelMetadata[]>;
     connected: string[];
 }) => void, updateConnectedProvidersCache: (client: {
     provider?: {
@@ -48,5 +65,4 @@ export declare const readConnectedProvidersCache: () => string[] | null, hasConn
             };
         }>;
     };
-}) => Promise<void>;
-export {};
+}) => 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/fallback-chain-from-models.d.ts

@@ -1,3 +1,12 @@
 import type { FallbackEntry } from "./model-requirements";
+import type { FallbackModelObject } from "../config/schema/fallback-models";
 export declare function parseFallbackModelEntry(model: string, contextProviderID: string | undefined, defaultProviderID?: string): FallbackEntry | undefined;
-export declare function buildFallbackChainFromModels(fallbackModels: string | string[] | undefined, contextProviderID: string | undefined, defaultProviderID?: string): FallbackEntry[] | undefined;
+export declare function parseFallbackModelObjectEntry(obj: FallbackModelObject, contextProviderID: string | undefined, defaultProviderID?: string): FallbackEntry | undefined;
+/**
+ * Find the most specific FallbackEntry whose `provider/model` is a prefix of
+ * the resolved `provider/modelID`.  Longest match wins so that e.g.
+ * `openai/gpt-5.4-preview` picks the entry for `openai/gpt-5.4-preview` over
+ * the shorter `openai/gpt-5.4`.
+ */
+export declare function findMostSpecificFallbackEntry(providerID: string, modelID: string, chain: FallbackEntry[]): FallbackEntry | undefined;
+export declare function buildFallbackChainFromModels(fallbackModels: string | (string | FallbackModelObject)[] | undefined, contextProviderID: string | undefined, defaultProviderID?: string): FallbackEntry[] | undefined;

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";
@@ -23,6 +24,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";
@@ -31,10 +33,14 @@ export * from "./agent-tool-restrictions";
 export * from "./model-requirements";
 export * from "./model-resolver";
 export { normalizeModel, normalizeModelID } from "./model-normalization";
-export { normalizeFallbackModels } from "./model-resolver";
+export { normalizeFallbackModels, flattenToFallbackModelStrings } from "./model-resolver";
 export { resolveModelPipeline } from "./model-resolution-pipeline";
 export type { ModelResolutionRequest, ModelResolutionProvenance, ModelResolutionResult, } from "./model-resolution-types";
 export * from "./model-availability";
+export * from "./model-capabilities";
+export * from "./model-capabilities-cache";
+export * from "./model-capability-heuristics";
+export * from "./model-settings-compatibility";
 export * from "./fallback-model-availability";
 export * from "./connected-providers-cache";
 export * from "./context-limit-resolver";
@@ -50,6 +56,7 @@ export * from "./truncate-description";
 export * from "./opencode-storage-paths";
 export * from "./opencode-message-dir";
 export * from "./opencode-command-dirs";
+export * from "./project-discovery-dirs";
 export * from "./normalize-sdk-response";
 export * from "./session-directory-resolver";
 export * from "./prompt-tools";
@@ -57,3 +64,5 @@ 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";

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/known-variants.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Canonical set of recognised variant / effort tokens.
+ * Used by parseFallbackModelEntry (space-suffix detection) and
+ * flattenToFallbackModelStrings (inline-variant stripping).
+ */
+export declare const KNOWN_VARIANTS: Set<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 {};

package/dist/shared/migrate-legacy-config-file.d.ts

@@ -0,0 +1 @@
+export declare function migrateLegacyConfigFile(legacyPath: string): boolean;

package/dist/shared/migrate-legacy-plugin-entry.d.ts

@@ -0,0 +1 @@
+export declare function migrateLegacyPluginEntry(configPath: string): boolean;

package/dist/shared/model-capabilities/bundled-snapshot.d.ts

@@ -0,0 +1,2 @@
+import type { ModelCapabilitiesSnapshot } from "./types";
+export declare function getBundledModelCapabilitiesSnapshot(): ModelCapabilitiesSnapshot;

package/dist/shared/model-capabilities/get-model-capabilities.d.ts

@@ -0,0 +1,2 @@
+import type { GetModelCapabilitiesInput, ModelCapabilities } from "./types";
+export declare function getModelCapabilities(input: GetModelCapabilitiesInput): ModelCapabilities;

package/dist/shared/model-capabilities/index.d.ts

@@ -0,0 +1,3 @@
+export { getBundledModelCapabilitiesSnapshot } from "./bundled-snapshot";
+export { getModelCapabilities } from "./get-model-capabilities";
+export type { GetModelCapabilitiesInput, ModelCapabilities, ModelCapabilitiesDiagnostics, ModelCapabilitiesSnapshot, ModelCapabilitiesSnapshotEntry, } from "./types";

package/dist/shared/model-capabilities/runtime-model-readers.d.ts

@@ -0,0 +1,11 @@
+import type { ModelMetadata } from "../connected-providers-cache";
+import type { ModelCapabilities } from "./types";
+export declare function readRuntimeModel(runtimeModel: ModelMetadata | Record<string, unknown> | undefined): Record<string, unknown> | undefined;
+export declare function readRuntimeModelVariants(runtimeModel: Record<string, unknown> | undefined): string[] | undefined;
+export declare function readRuntimeModelModalities(runtimeModel: Record<string, unknown> | undefined): ModelCapabilities["modalities"] | undefined;
+export declare function readRuntimeModelReasoningSupport(runtimeModel: Record<string, unknown> | undefined): boolean | undefined;
+export declare function readRuntimeModelThinkingSupport(runtimeModel: Record<string, unknown> | undefined): boolean | undefined;
+export declare function readRuntimeModelTemperatureSupport(runtimeModel: Record<string, unknown> | undefined): boolean | undefined;
+export declare function readRuntimeModelTopPSupport(runtimeModel: Record<string, unknown> | undefined): boolean | undefined;
+export declare function readRuntimeModelToolCallSupport(runtimeModel: Record<string, unknown> | undefined): boolean | undefined;
+export declare function readRuntimeModelLimitOutput(runtimeModel: Record<string, unknown> | undefined): number | undefined;

package/dist/shared/model-capabilities/types.d.ts

@@ -0,0 +1,94 @@
+import type { ModelMetadata } from "../connected-providers-cache";
+export type ModelCapabilitiesSnapshotEntry = {
+    id: string;
+    family?: string;
+    reasoning?: boolean;
+    temperature?: boolean;
+    toolCall?: boolean;
+    modalities?: {
+        input?: string[];
+        output?: string[];
+    };
+    limit?: {
+        context?: number;
+        input?: number;
+        output?: number;
+    };
+};
+export type ModelCapabilitiesSnapshot = {
+    generatedAt: string;
+    sourceUrl: string;
+    models: Record<string, ModelCapabilitiesSnapshotEntry>;
+};
+export type ModelCapabilitiesDiagnostics = {
+    resolutionMode: "snapshot-backed" | "alias-backed" | "heuristic-backed" | "unknown";
+    canonicalization: {
+        source: "canonical" | "exact-alias" | "pattern-alias";
+        ruleID?: string;
+    };
+    snapshot: {
+        source: "runtime-snapshot" | "bundled-snapshot" | "none";
+    };
+    family: {
+        source: "snapshot" | "heuristic" | "none";
+    };
+    variants: {
+        source: "none" | "runtime" | "override" | "heuristic" | "canonical";
+    };
+    reasoningEfforts: {
+        source: "none" | "override" | "heuristic";
+    };
+    reasoning: {
+        source: "runtime" | "runtime-snapshot" | "bundled-snapshot" | "none";
+    };
+    supportsThinking: {
+        source: "runtime" | "override" | "heuristic" | "runtime-snapshot" | "bundled-snapshot" | "none";
+    };
+    supportsTemperature: {
+        source: "runtime" | "override" | "runtime-snapshot" | "bundled-snapshot" | "none";
+    };
+    supportsTopP: {
+        source: "runtime" | "override" | "none";
+    };
+    maxOutputTokens: {
+        source: "runtime" | "runtime-snapshot" | "bundled-snapshot" | "none";
+    };
+    toolCall: {
+        source: "runtime" | "runtime-snapshot" | "bundled-snapshot" | "none";
+    };
+    modalities: {
+        source: "runtime" | "runtime-snapshot" | "bundled-snapshot" | "none";
+    };
+};
+export type ModelCapabilities = {
+    requestedModelID: string;
+    canonicalModelID: string;
+    family?: string;
+    variants?: string[];
+    reasoningEfforts?: string[];
+    reasoning?: boolean;
+    supportsThinking?: boolean;
+    supportsTemperature?: boolean;
+    supportsTopP?: boolean;
+    maxOutputTokens?: number;
+    toolCall?: boolean;
+    modalities?: {
+        input?: string[];
+        output?: string[];
+    };
+    diagnostics: ModelCapabilitiesDiagnostics;
+};
+export type GetModelCapabilitiesInput = {
+    providerID: string;
+    modelID: string;
+    runtimeModel?: ModelMetadata | Record<string, unknown>;
+    runtimeSnapshot?: ModelCapabilitiesSnapshot;
+    bundledSnapshot?: ModelCapabilitiesSnapshot;
+};
+export type ModelCapabilityOverride = {
+    variants?: string[];
+    reasoningEfforts?: string[];
+    supportsThinking?: boolean;
+    supportsTemperature?: boolean;
+    supportsTopP?: boolean;
+};

package/dist/shared/model-capabilities-cache.d.ts

@@ -0,0 +1,20 @@
+import type { ModelCapabilitiesSnapshot } from "./model-capabilities";
+export declare const MODELS_DEV_SOURCE_URL = "https://models.dev/api.json";
+export declare function buildModelCapabilitiesSnapshotFromModelsDev(raw: unknown): ModelCapabilitiesSnapshot;
+export declare function fetchModelCapabilitiesSnapshot(args?: {
+    sourceUrl?: string;
+    fetchImpl?: typeof fetch;
+}): Promise<ModelCapabilitiesSnapshot>;
+export declare function createModelCapabilitiesCacheStore(getCacheDir?: () => string): {
+    readModelCapabilitiesCache: () => ModelCapabilitiesSnapshot | null;
+    hasModelCapabilitiesCache: () => boolean;
+    writeModelCapabilitiesCache: (snapshot: ModelCapabilitiesSnapshot) => void;
+    refreshModelCapabilitiesCache: (args?: {
+        sourceUrl?: string;
+        fetchImpl?: typeof fetch;
+    }) => Promise<ModelCapabilitiesSnapshot>;
+};
+export declare const readModelCapabilitiesCache: () => ModelCapabilitiesSnapshot | null, hasModelCapabilitiesCache: () => boolean, writeModelCapabilitiesCache: (snapshot: ModelCapabilitiesSnapshot) => void, refreshModelCapabilitiesCache: (args?: {
+    sourceUrl?: string;
+    fetchImpl?: typeof fetch;
+}) => Promise<ModelCapabilitiesSnapshot>;

package/dist/shared/model-capability-aliases.d.ts

@@ -0,0 +1,21 @@
+export type ExactAliasRule = {
+    aliasModelID: string;
+    ruleID: string;
+    canonicalModelID: string;
+    rationale: string;
+};
+export type PatternAliasRule = {
+    ruleID: string;
+    description: string;
+    match: (normalizedModelID: string) => boolean;
+    canonicalize: (normalizedModelID: string) => string;
+};
+export type ModelIDAliasResolution = {
+    requestedModelID: string;
+    canonicalModelID: string;
+    source: "canonical" | "exact-alias" | "pattern-alias";
+    ruleID?: string;
+};
+export declare function resolveModelIDAlias(modelID: string): ModelIDAliasResolution;
+export declare function getExactModelIDAliasRules(): ReadonlyArray<ExactAliasRule>;
+export declare function getPatternModelIDAliasRules(): ReadonlyArray<PatternAliasRule>;

package/dist/shared/model-capability-guardrails.d.ts

@@ -0,0 +1,38 @@
+import type { ModelCapabilitiesSnapshot } from "./model-capabilities";
+export type ModelCapabilityGuardrailIssue = {
+    kind: "alias-target-missing-from-snapshot";
+    ruleID: string;
+    aliasModelID: string;
+    canonicalModelID: string;
+    message: string;
+} | {
+    kind: "exact-alias-collides-with-snapshot";
+    ruleID: string;
+    aliasModelID: string;
+    canonicalModelID: string;
+    message: string;
+} | {
+    kind: "pattern-alias-collides-with-snapshot";
+    ruleID: string;
+    modelID: string;
+    canonicalModelID: string;
+    message: string;
+} | {
+    kind: "built-in-model-relies-on-alias";
+    modelID: string;
+    canonicalModelID: string;
+    ruleID: string;
+    message: string;
+} | {
+    kind: "built-in-model-missing-from-snapshot";
+    modelID: string;
+    canonicalModelID: string;
+    message: string;
+};
+type CollectModelCapabilityGuardrailIssuesInput = {
+    snapshot?: ModelCapabilitiesSnapshot;
+    requirementModelIDs?: Iterable<string>;
+};
+export declare function getBuiltInRequirementModelIDs(): string[];
+export declare function collectModelCapabilityGuardrailIssues(input?: CollectModelCapabilityGuardrailIssuesInput): ModelCapabilityGuardrailIssue[];
+export {};

package/dist/shared/model-capability-heuristics.d.ts

@@ -0,0 +1,10 @@
+export type HeuristicModelFamilyDefinition = {
+    family: string;
+    includes?: string[];
+    pattern?: RegExp;
+    variants?: string[];
+    reasoningEfforts?: string[];
+    supportsThinking?: boolean;
+};
+export declare const HEURISTIC_MODEL_FAMILY_REGISTRY: ReadonlyArray<HeuristicModelFamilyDefinition>;
+export declare function detectHeuristicModelFamily(modelID: string): HeuristicModelFamilyDefinition | undefined;

package/dist/shared/model-requirements.d.ts

@@ -2,6 +2,14 @@ export type FallbackEntry = {
     providers: string[];
     model: string;
     variant?: string;
+    reasoningEffort?: string;
+    temperature?: number;
+    top_p?: number;
+    maxTokens?: number;
+    thinking?: {
+        type: "enabled" | "disabled";
+        budgetTokens?: number;
+    };
 };
 export type ModelRequirement = {
     fallbackChain: FallbackEntry[];

package/dist/shared/model-resolution-types.d.ts

@@ -1,4 +1,17 @@
 import type { FallbackEntry } from "./model-requirements";
+export interface DelegatedModelConfig {
+    providerID: string;
+    modelID: string;
+    variant?: string;
+    reasoningEffort?: string;
+    temperature?: number;
+    top_p?: number;
+    maxTokens?: number;
+    thinking?: {
+        type: "enabled" | "disabled";
+        budgetTokens?: number;
+    };
+}
 export type ModelResolutionRequest = {
     intent?: {
         uiSelectedModel?: string;