@heidi-dang/oh-my-opencode 3.10.0

package/dist/plugin-interface.d.ts

@@ -0,0 +1,21 @@
+import type { PluginContext, PluginInterface, ToolsRecord } from "./plugin/types";
+import type { OhMyOpenCodeConfig } from "./config";
+import type { CreatedHooks } from "./create-hooks";
+import type { Managers } from "./create-managers";
+export declare function createPluginInterface(args: {
+    ctx: PluginContext;
+    pluginConfig: OhMyOpenCodeConfig;
+    firstMessageVariantGate: {
+        shouldOverride: (sessionID: string) => boolean;
+        markApplied: (sessionID: string) => void;
+        markSessionCreated: (sessionInfo: {
+            id?: string;
+            title?: string;
+            parentID?: string;
+        } | undefined) => void;
+        clear: (sessionID: string) => void;
+    };
+    managers: Managers;
+    hooks: CreatedHooks;
+    tools: ToolsRecord;
+}): PluginInterface;

package/dist/plugin-state.d.ts

@@ -0,0 +1,5 @@
+export interface ModelCacheState {
+    modelContextLimitsCache: Map<string, number>;
+    anthropicContext1MEnabled: boolean;
+}
+export declare function createModelCacheState(): ModelCacheState;

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

@@ -0,0 +1,17 @@
+/**
+ * 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)").
+ */
+export declare const AGENT_DISPLAY_NAMES: Record<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;
+/**
+ * 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;

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

@@ -0,0 +1,7 @@
+/**
+ * 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/agent-variant.d.ts

@@ -0,0 +1,9 @@
+import type { OhMyOpenCodeConfig } from "../config";
+export declare function resolveAgentVariant(config: OhMyOpenCodeConfig, agentName?: string): string | undefined;
+export declare function resolveVariantForModel(config: OhMyOpenCodeConfig, agentName: string, currentModel: {
+    providerID: string;
+    modelID: string;
+}): string | undefined;
+export declare function applyAgentVariant(config: OhMyOpenCodeConfig, agentName: string | undefined, message: {
+    variant?: string;
+}): void;

package/dist/shared/binary-downloader.d.ts

@@ -0,0 +1,10 @@
+export declare function getCachedBinaryPath(cacheDir: string, binaryName: string): string | null;
+export declare function ensureCacheDir(cacheDir: string): void;
+export declare function downloadArchive(downloadUrl: string, archivePath: string): Promise<void>;
+export declare function extractTarGz(archivePath: string, destDir: string, options?: {
+    args?: string[];
+    cwd?: string;
+}): Promise<void>;
+export declare function extractZipArchive(archivePath: string, destDir: string): Promise<void>;
+export declare function cleanupArchive(archivePath: string): void;
+export declare function ensureExecutable(binaryPath: string): void;

package/dist/shared/claude-config-dir.d.ts

@@ -0,0 +1 @@
+export declare function getClaudeConfigDir(): string;

package/dist/shared/command-executor/embedded-commands.d.ts

@@ -0,0 +1,7 @@
+export interface CommandMatch {
+    fullMatch: string;
+    command: string;
+    start: number;
+    end: number;
+}
+export declare function findEmbeddedCommands(text: string): CommandMatch[];

package/dist/shared/command-executor/execute-command.d.ts

@@ -0,0 +1 @@
+export declare function executeCommand(command: string): Promise<string>;

package/dist/shared/command-executor/execute-hook-command.d.ts

@@ -0,0 +1,12 @@
+export interface CommandResult {
+    exitCode: number;
+    stdout?: string;
+    stderr?: string;
+}
+export interface ExecuteHookOptions {
+    forceZsh?: boolean;
+    zshPath?: string;
+    /** Timeout in milliseconds. Process is killed after this. Default: 30000 */
+    timeoutMs?: number;
+}
+export declare function executeHookCommand(command: string, stdin: string, cwd: string, options?: ExecuteHookOptions): Promise<CommandResult>;

package/dist/shared/command-executor/home-directory.d.ts

@@ -0,0 +1 @@
+export declare function getHomeDirectory(): string;

package/dist/shared/command-executor/resolve-commands-in-text.d.ts

@@ -0,0 +1 @@
+export declare function resolveCommandsInText(text: string, depth?: number, maxDepth?: number): Promise<string>;

package/dist/shared/command-executor/shell-path.d.ts

@@ -0,0 +1,2 @@
+export declare function findZshPath(customZshPath?: string): string | null;
+export declare function findBashPath(): string | null;

package/dist/shared/command-executor.d.ts

@@ -0,0 +1,4 @@
+export { executeHookCommand } from "./command-executor/execute-hook-command";
+export type { CommandResult, ExecuteHookOptions } from "./command-executor/execute-hook-command";
+export { executeCommand } from "./command-executor/execute-command";
+export { resolveCommandsInText } from "./command-executor/resolve-commands-in-text";

package/dist/shared/config-errors.d.ts

@@ -0,0 +1,7 @@
+export type ConfigLoadError = {
+    path: string;
+    error: string;
+};
+export declare function getConfigLoadErrors(): ConfigLoadError[];
+export declare function clearConfigLoadErrors(): void;
+export declare function addConfigLoadError(error: ConfigLoadError): void;

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

@@ -0,0 +1,55 @@
+interface ModelMetadata {
+    id: string;
+    provider?: string;
+    context?: number;
+    output?: number;
+    name?: string;
+}
+interface ProviderModelsCache {
+    models: Record<string, string[] | ModelMetadata[]>;
+    connected: string[];
+    updatedAt: string;
+}
+/**
+ * Read the connected providers cache.
+ * Returns the list of connected provider IDs, or null if cache doesn't exist.
+ */
+export declare function readConnectedProvidersCache(): string[] | null;
+/**
+ * Check if connected providers cache exists.
+ */
+export declare function hasConnectedProvidersCache(): boolean;
+/**
+ * Read the provider-models cache.
+ * Returns the cache data, or null if cache doesn't exist.
+ */
+export declare function readProviderModelsCache(): ProviderModelsCache | null;
+/**
+ * Check if provider-models cache exists.
+ */
+export declare function hasProviderModelsCache(): boolean;
+/**
+ * Write the provider-models cache.
+ */
+export declare function writeProviderModelsCache(data: {
+    models: Record<string, string[]>;
+    connected: string[];
+}): void;
+/**
+ * Update the connected providers cache by fetching from the client.
+ * Also updates the provider-models cache with model lists per provider.
+ */
+export declare function updateConnectedProvidersCache(client: {
+    provider?: {
+        list?: () => Promise<{
+            data?: {
+                connected?: string[];
+                all?: Array<{
+                    id: string;
+                    models?: Record<string, unknown>;
+                }>;
+            };
+        }>;
+    };
+}): Promise<void>;
+export {};

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

@@ -0,0 +1,30 @@
+/**
+ * Returns the user-level data directory.
+ * Matches OpenCode's behavior via xdg-basedir:
+ * - All platforms: XDG_DATA_HOME or ~/.local/share
+ *
+ * Note: OpenCode uses xdg-basedir which returns ~/.local/share on ALL platforms
+ * including Windows, so we match that behavior exactly.
+ */
+export declare function getDataDir(): string;
+/**
+ * Returns the OpenCode storage directory path.
+ * All platforms: ~/.local/share/opencode/storage
+ */
+export declare function getOpenCodeStorageDir(): string;
+/**
+ * Returns the user-level cache directory.
+ * Matches OpenCode's behavior via xdg-basedir:
+ * - All platforms: XDG_CACHE_HOME or ~/.cache
+ */
+export declare function getCacheDir(): string;
+/**
+ * Returns the oh-my-opencode cache directory.
+ * All platforms: ~/.cache/oh-my-opencode
+ */
+export declare function getOmoOpenCodeCacheDir(): string;
+/**
+ * Returns the OpenCode cache directory (for reading OpenCode's cache).
+ * All platforms: ~/.cache/opencode
+ */
+export declare function getOpenCodeCacheDir(): string;

package/dist/shared/deep-merge.d.ts

@@ -0,0 +1,13 @@
+export declare function isPlainObject(value: unknown): value is Record<string, unknown>;
+/**
+ * Deep merges two objects, with override values taking precedence.
+ * - Objects are recursively merged
+ * - Arrays are replaced (not concatenated)
+ * - undefined values in override do not overwrite base values
+ *
+ * @example
+ * deepMerge({ a: 1, b: { c: 2, d: 3 } }, { b: { c: 10 }, e: 5 })
+ * // => { a: 1, b: { c: 10, d: 3 }, e: 5 }
+ */
+export declare function deepMerge<T extends Record<string, unknown>>(base: T, override: Partial<T>, depth?: number): T;
+export declare function deepMerge<T extends Record<string, unknown>>(base: T | undefined, override: T | undefined, depth?: number): T | undefined;

package/dist/shared/disabled-tools.d.ts

@@ -0,0 +1,2 @@
+import type { ToolDefinition } from "@opencode-ai/plugin";
+export declare function filterDisabledTools(tools: Record<string, ToolDefinition>, disabledTools: readonly string[] | undefined): Record<string, ToolDefinition>;

package/dist/shared/dynamic-truncator.d.ts

@@ -0,0 +1,31 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+type ModelCacheStateLike = {
+    anthropicContext1MEnabled: boolean;
+};
+export interface TruncationResult {
+    result: string;
+    truncated: boolean;
+    removedCount?: number;
+}
+export interface TruncationOptions {
+    targetMaxTokens?: number;
+    preserveHeaderLines?: number;
+    contextWindowLimit?: number;
+}
+export declare function truncateToTokenLimit(output: string, maxTokens: number, preserveHeaderLines?: number): TruncationResult;
+export declare function getContextWindowUsage(ctx: PluginInput, sessionID: string, modelCacheState?: ModelCacheStateLike): Promise<{
+    usedTokens: number;
+    remainingTokens: number;
+    usagePercentage: number;
+} | null>;
+export declare function dynamicTruncate(ctx: PluginInput, sessionID: string, output: string, options?: TruncationOptions, modelCacheState?: ModelCacheStateLike): Promise<TruncationResult>;
+export declare function createDynamicTruncator(ctx: PluginInput, modelCacheState?: ModelCacheStateLike): {
+    truncate: (sessionID: string, output: string, options?: TruncationOptions) => Promise<TruncationResult>;
+    getUsage: (sessionID: string) => Promise<{
+        usedTokens: number;
+        remainingTokens: number;
+        usagePercentage: number;
+    } | null>;
+    truncateSync: (output: string, maxTokens: number, preserveHeaderLines?: number) => TruncationResult;
+};
+export {};

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

@@ -0,0 +1,18 @@
+/**
+ * Detects external plugins that may conflict with oh-my-opencode features.
+ * Used to prevent crashes from concurrent notification plugins.
+ */
+export interface ExternalNotifierResult {
+    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;
+/**
+ * Generate a warning message for users with conflicting notification plugins.
+ */
+export declare function getNotificationConflictWarning(pluginName: string): string;

package/dist/shared/fallback-model-availability.d.ts

@@ -0,0 +1,12 @@
+type FallbackEntry = {
+    providers: string[];
+    model: string;
+};
+type ResolvedFallbackModel = {
+    provider: string;
+    model: string;
+};
+export declare function resolveFirstAvailableFallback(fallbackChain: FallbackEntry[], availableModels: Set<string>): ResolvedFallbackModel | null;
+export declare function isAnyFallbackModelAvailable(fallbackChain: FallbackEntry[], availableModels: Set<string>): boolean;
+export declare function isAnyProviderConnected(providers: string[], availableModels: Set<string>): boolean;
+export {};

package/dist/shared/file-reference-resolver.d.ts

@@ -0,0 +1 @@
+export declare function resolveFileReferencesInText(text: string, cwd?: string, depth?: number, maxDepth?: number): Promise<string>;

package/dist/shared/file-utils.d.ts

@@ -0,0 +1,7 @@
+export declare function isMarkdownFile(entry: {
+    name: string;
+    isFile: () => boolean;
+}): boolean;
+export declare function isSymbolicLink(filePath: string): boolean;
+export declare function resolveSymlink(filePath: string): string;
+export declare function resolveSymlinkAsync(filePath: string): Promise<string>;

package/dist/shared/first-message-variant.d.ts

@@ -0,0 +1,11 @@
+type SessionInfo = {
+    id?: string;
+    parentID?: string;
+};
+export declare function createFirstMessageVariantGate(): {
+    markSessionCreated(info?: SessionInfo): void;
+    shouldOverride(sessionID?: string): boolean;
+    markApplied(sessionID?: string): void;
+    clear(sessionID?: string): void;
+};
+export {};

package/dist/shared/frontmatter.d.ts

@@ -0,0 +1,7 @@
+export interface FrontmatterResult<T = Record<string, unknown>> {
+    data: T;
+    body: string;
+    hadFrontmatter: boolean;
+    parseError: boolean;
+}
+export declare function parseFrontmatter<T = Record<string, unknown>>(content: string): FrontmatterResult<T>;

package/dist/shared/git-worktree/collect-git-diff-stats.d.ts

@@ -0,0 +1,2 @@
+import type { GitFileStat } from "./types";
+export declare function collectGitDiffStats(directory: string): GitFileStat[];

package/dist/shared/git-worktree/format-file-changes.d.ts

@@ -0,0 +1,2 @@
+import type { GitFileStat } from "./types";
+export declare function formatFileChanges(stats: GitFileStat[], notepadPath?: string): string;

package/dist/shared/git-worktree/index.d.ts

@@ -0,0 +1,7 @@
+export type { GitFileStatus, GitFileStat } from "./types";
+export type { ParsedGitStatusPorcelainLine } from "./parse-status-porcelain-line";
+export { parseGitStatusPorcelainLine } from "./parse-status-porcelain-line";
+export { parseGitStatusPorcelain } from "./parse-status-porcelain";
+export { parseGitDiffNumstat } from "./parse-diff-numstat";
+export { collectGitDiffStats } from "./collect-git-diff-stats";
+export { formatFileChanges } from "./format-file-changes";

package/dist/shared/git-worktree/parse-diff-numstat.d.ts

@@ -0,0 +1,2 @@
+import type { GitFileStat, GitFileStatus } from "./types";
+export declare function parseGitDiffNumstat(output: string, statusMap: Map<string, GitFileStatus>): GitFileStat[];

package/dist/shared/git-worktree/parse-status-porcelain-line.d.ts

@@ -0,0 +1,6 @@
+import type { GitFileStatus } from "./types";
+export interface ParsedGitStatusPorcelainLine {
+    filePath: string;
+    status: GitFileStatus;
+}
+export declare function parseGitStatusPorcelainLine(line: string): ParsedGitStatusPorcelainLine | null;

package/dist/shared/git-worktree/parse-status-porcelain.d.ts

@@ -0,0 +1,2 @@
+import type { GitFileStatus } from "./types";
+export declare function parseGitStatusPorcelain(output: string): Map<string, GitFileStatus>;

package/dist/shared/git-worktree/types.d.ts

@@ -0,0 +1,7 @@
+export type GitFileStatus = "modified" | "added" | "deleted";
+export interface GitFileStat {
+    path: string;
+    added: number;
+    removed: number;
+    status: GitFileStatus;
+}

package/dist/shared/hook-disabled.d.ts

@@ -0,0 +1,2 @@
+import type { ClaudeHookEvent, PluginConfig } from "../hooks/claude-code-hooks/types";
+export declare function isHookDisabled(config: PluginConfig, hookType: ClaudeHookEvent): boolean;

package/dist/shared/index.d.ts

@@ -0,0 +1,56 @@
+export * from "./frontmatter";
+export * from "./command-executor";
+export * from "./file-reference-resolver";
+export * from "./model-sanitizer";
+export * from "./logger";
+export * from "./snake-case";
+export * from "./tool-name";
+export * from "./pattern-matcher";
+export * from "./hook-disabled";
+export * from "./deep-merge";
+export * from "./file-utils";
+export * from "./dynamic-truncator";
+export * from "./data-path";
+export * from "./config-errors";
+export * from "./claude-config-dir";
+export * from "./jsonc-parser";
+export * from "./migration";
+export * from "./opencode-config-dir";
+export type { OpenCodeBinaryType, OpenCodeConfigDirOptions, OpenCodeConfigPaths, } from "./opencode-config-dir-types";
+export * from "./opencode-version";
+export * from "./opencode-storage-detection";
+export * from "./permission-compat";
+export * from "./external-plugin-detector";
+export * from "./zip-extractor";
+export * from "./binary-downloader";
+export * from "./agent-variant";
+export * from "./session-cursor";
+export * from "./shell-env";
+export * from "./system-directive";
+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 { resolveModelPipeline } from "./model-resolution-pipeline";
+export type { ModelResolutionRequest, ModelResolutionProvenance, ModelResolutionResult, } from "./model-resolution-types";
+export * from "./model-availability";
+export * from "./fallback-model-availability";
+export * from "./connected-providers-cache";
+export * from "./session-utils";
+export * from "./tmux";
+export * from "./model-suggestion-retry";
+export * from "./opencode-server-auth";
+export * from "./opencode-http-api";
+export * from "./port-utils";
+export * from "./git-worktree";
+export * from "./safe-create-hook";
+export * from "./truncate-description";
+export * from "./opencode-storage-paths";
+export * from "./opencode-message-dir";
+export * from "./normalize-sdk-response";
+export * from "./session-directory-resolver";
+export * from "./prompt-tools";
+export * from "./internal-initiator-marker";
+export * from "./plugin-command-discovery";
+export { SessionCategoryRegistry } from "./session-category-registry";

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

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

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

@@ -0,0 +1,15 @@
+export interface JsoncParseResult<T> {
+    data: T | null;
+    errors: Array<{
+        message: string;
+        offset: number;
+        length: number;
+    }>;
+}
+export declare function parseJsonc<T = unknown>(content: string): T;
+export declare function parseJsoncSafe<T = unknown>(content: string): JsoncParseResult<T>;
+export declare function readJsoncFile<T = unknown>(filePath: string): T | null;
+export declare function detectConfigFile(basePath: string): {
+    format: "json" | "jsonc" | "none";
+    path: string;
+};

package/dist/shared/logger.d.ts

@@ -0,0 +1,2 @@
+export declare function log(message: string, data?: unknown): void;
+export declare function getLogFilePath(): string;

package/dist/shared/merge-categories.d.ts

@@ -0,0 +1,6 @@
+import type { CategoriesConfig, CategoryConfig } from "../config/schema";
+/**
+ * Merge default and user categories, filtering out disabled ones.
+ * Single source of truth for category merging across the codebase.
+ */
+export declare function mergeCategories(userCategories?: CategoriesConfig): Record<string, CategoryConfig>;

package/dist/shared/migration/agent-category.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @deprecated LEGACY MIGRATION ONLY
+ *
+ * This map exists solely for migrating old configs that used hardcoded model strings.
+ * It maps legacy model strings to semantic category names, allowing users to migrate
+ * from explicit model configs to category-based configs.
+ *
+ * DO NOT add new entries here. New agents should use:
+ * - Category-based config (preferred): { category: "unspecified-high" }
+ * - Or inherit from OpenCode's config.model
+ *
+ * This map will be removed in a future major version once migration period ends.
+ */
+export declare const MODEL_TO_CATEGORY_MAP: Record<string, string>;
+export declare function migrateAgentConfigToCategory(config: Record<string, unknown>): {
+    migrated: Record<string, unknown>;
+    changed: boolean;
+};
+export declare function shouldDeleteAgentConfig(config: Record<string, unknown>, category: string): boolean;

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

@@ -0,0 +1,6 @@
+export declare const AGENT_NAME_MAP: Record<string, string>;
+export declare const BUILTIN_AGENT_NAMES: Set<string>;
+export declare function migrateAgentNames(agents: Record<string, unknown>): {
+    migrated: Record<string, unknown>;
+    changed: boolean;
+};

package/dist/shared/migration/config-migration.d.ts

@@ -0,0 +1 @@
+export declare function migrateConfigFile(configPath: string, rawConfig: Record<string, unknown>): boolean;

package/dist/shared/migration/hook-names.d.ts

@@ -0,0 +1,6 @@
+export declare const HOOK_NAME_MAP: Record<string, string | null>;
+export declare function migrateHookNames(hooks: string[]): {
+    migrated: string[];
+    changed: boolean;
+    removed: string[];
+};

package/dist/shared/migration/model-versions.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Model version migration map: old full model strings → new full model strings.
+ * Used to auto-upgrade hardcoded model versions in user configs when the plugin
+ * bumps to newer model versions.
+ *
+ * Keys are full "provider/model" strings. Only openai and anthropic entries needed.
+ */
+export declare const MODEL_VERSION_MAP: Record<string, string>;
+export declare function migrateModelVersions(configs: Record<string, unknown>, appliedMigrations?: Set<string>): {
+    migrated: Record<string, unknown>;
+    changed: boolean;
+    newMigrations: string[];
+};

package/dist/shared/migration.d.ts

@@ -0,0 +1,5 @@
+export { AGENT_NAME_MAP, BUILTIN_AGENT_NAMES, migrateAgentNames } from "./migration/agent-names";
+export { HOOK_NAME_MAP, migrateHookNames } from "./migration/hook-names";
+export { MODEL_VERSION_MAP, migrateModelVersions } from "./migration/model-versions";
+export { MODEL_TO_CATEGORY_MAP, migrateAgentConfigToCategory, shouldDeleteAgentConfig } from "./migration/agent-category";
+export { migrateConfigFile } from "./migration/config-migration";

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

@@ -0,0 +1,15 @@
+export declare function fuzzyMatchModel(target: string, available: Set<string>, providers?: string[]): string | null;
+/**
+ * Check if a target model is available (fuzzy match by model name, no provider filtering)
+ *
+ * @param targetModel - Model name to check (e.g., "gpt-5.3-codex")
+ * @param availableModels - Set of available models in "provider/model" format
+ * @returns true if model is available, false otherwise
+ */
+export declare function isModelAvailable(targetModel: string, availableModels: Set<string>): boolean;
+export declare function getConnectedProviders(client: any): Promise<string[]>;
+export declare function fetchAvailableModels(client?: any, options?: {
+    connectedProviders?: string[] | null;
+}): Promise<Set<string>>;
+export declare function __resetModelCache(): void;
+export declare function isModelCacheAvailable(): boolean;

package/dist/shared/model-error-classifier.d.ts

@@ -0,0 +1,31 @@
+import type { FallbackEntry } from "./model-requirements";
+export interface ErrorInfo {
+    name?: string;
+    message?: string;
+}
+/**
+ * Determines if an error is a retryable model error.
+ * Returns true if the error is a known retryable type OR matches retryable message patterns.
+ */
+export declare function isRetryableModelError(error: ErrorInfo): boolean;
+/**
+ * Determines if an error should trigger a fallback retry.
+ * Returns true for deadstop errors that completely halt the action loop.
+ */
+export declare function shouldRetryError(error: ErrorInfo): boolean;
+/**
+ * Gets the next fallback model from the chain based on attempt count.
+ * Returns undefined if all fallbacks have been exhausted.
+ */
+export declare function getNextFallback(fallbackChain: FallbackEntry[], attemptCount: number): FallbackEntry | undefined;
+/**
+ * Checks if there are more fallbacks available after the current attempt.
+ */
+export declare function hasMoreFallbacks(fallbackChain: FallbackEntry[], attemptCount: number): boolean;
+/**
+ * Selects the best provider for a fallback entry.
+ * Priority:
+ * 1) First connected provider in the entry's provider preference order
+ * 2) First provider listed in the fallback entry (when cache is missing)
+ */
+export declare function selectFallbackProvider(providers: string[], preferredProviderID?: string): string;

package/dist/shared/model-format-normalizer.d.ts

@@ -0,0 +1,7 @@
+export declare function normalizeModelFormat(model: string | {
+    providerID: string;
+    modelID: string;
+}): {
+    providerID: string;
+    modelID: string;
+} | undefined;

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

@@ -0,0 +1,2 @@
+export declare function normalizeModel(model?: string): string | undefined;
+export declare function normalizeModelID(modelID: string): string;

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

@@ -0,0 +1,25 @@
+/**
+ * Model Policy — Fail-Closed Exact String Matching
+ *
+ * Validates that user-configured model IDs exactly match known available models.
+ * When a configured model is invalid, throws with a clear error showing valid alternatives.
+ *
+ * Design:
+ * - Exact match only (no fuzzy, no prefix search) — "grok-4" != "xai/grok-4"
+ * - Falls through gracefully when availableModels cache is empty (first-run)
+ * - Applies only to explicit user overrides, not fallback-chain models
+ */
+/**
+ * Validates a user-configured model ID against the available models set.
+ *
+ * @throws {Error} When configuredModel is not in availableModels (and the cache is non-empty)
+ */
+export declare function validateModelPolicy(agentName: string, configuredModel: string, availableModels: Set<string>): void;
+/**
+ * Safe wrapper — logs a warning instead of throwing when strict=false.
+ * Strict mode (default) fails closed.
+ */
+export declare function validateModelPolicySafe(agentName: string, configuredModel: string, availableModels: Set<string>, strict?: boolean): {
+    valid: boolean;
+    error?: string;
+};