@animus-labs/cortex 0.2.0

package/dist/provider-registry.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Static provider registry for known LLM providers.
+ *
+ * This module contains:
+ * 1. PROVIDER_REGISTRY: metadata for all known providers (auth methods, env vars, key prefixes)
+ * 2. OAUTH_PROVIDER_IDS: the subset of providers that support OAuth
+ * 3. UTILITY_MODEL_DEFAULTS: per-provider cheapest-capable model for utility operations
+ *
+ * OAuth flows are resolved through pi-ai's OAuth provider registry at runtime.
+ *
+ * Reference: provider-manager.md
+ */
+/** Authentication method supported by a provider. */
+export type AuthMethod = 'oauth' | 'api_key';
+/** Static metadata for a known LLM provider. */
+export interface ProviderInfo {
+    /** Provider identifier (e.g., 'anthropic', 'openai', 'google'). */
+    id: string;
+    /** Human-readable name (e.g., 'Anthropic', 'OpenAI'). */
+    name: string;
+    /** Supported authentication methods. */
+    authMethods: AuthMethod[];
+    /** Environment variable name for API key (e.g., 'ANTHROPIC_API_KEY'). */
+    envVar?: string | undefined;
+    /** API key prefix for client-side type inference (e.g., 'sk-ant-'). */
+    keyPrefix?: string | undefined;
+    /** URL where users obtain API keys. */
+    keyUrl?: string | undefined;
+}
+/** Metadata about a model available from a provider. */
+export interface ModelInfo {
+    /** Model identifier (e.g., 'claude-sonnet-4-20250514'). */
+    id: string;
+    /** Human-readable name (e.g., 'Claude Sonnet 4'). */
+    name: string;
+    /** Context window size in tokens. */
+    contextWindow: number;
+    /** Whether the model supports extended thinking. */
+    supportsThinking: boolean;
+    /** Thinking levels supported by this model, in Cortex's public naming. */
+    supportedThinkingLevels: Array<'off' | 'minimal' | 'low' | 'medium' | 'high' | 'max'>;
+    /** Whether the model supports image input. */
+    supportsImages: boolean;
+    /** Pricing per million tokens (if available). */
+    pricing?: {
+        input: number;
+        output: number;
+    } | undefined;
+}
+/**
+ * All known providers with their authentication methods and UX metadata.
+ *
+ * This registry is maintained manually. When pi-ai adds a new provider,
+ * a corresponding entry is added here. Providers not in the registry can
+ * still be used via resolveModel() and createCustomModel() with direct
+ * API keys; they just won't appear in the discovery UI.
+ */
+export declare const PROVIDER_REGISTRY: ProviderInfo[];
+/**
+ * Provider IDs that support OAuth login flows.
+ */
+export declare const OAUTH_PROVIDER_IDS: string[];
+/**
+ * Default utility model IDs per provider.
+ * Used when utilityModel is 'default' or undefined.
+ *
+ * These are the cheapest capable models for each provider,
+ * suitable for internal operations like WebFetch summarization
+ * and safety classification.
+ */
+/**
+ * Default primary model IDs per provider.
+ * Used when a user first connects a provider and no model is explicitly selected.
+ * These are the best general-purpose models for each provider.
+ */
+export declare const PRIMARY_MODEL_DEFAULTS: Record<string, string>;
+export declare const UTILITY_MODEL_DEFAULTS: Record<string, string>;
+export type CacheRetention = 'none' | 'short' | 'long';
+/** Per-provider prompt caching characteristics as implemented in pi-ai. */
+export interface ProviderCacheConfig {
+    /** Whether pi-ai implements cacheRetention for this provider. */
+    supported: boolean;
+    /** Short-term cache TTL in ms (0 if unsupported). */
+    shortTtlMs: number;
+    /** Long-term cache TTL in ms (0 if unsupported). */
+    longTtlMs: number;
+    /** Write cost multiplier vs base input price for short cache (1.0 = free). */
+    shortWritePremium: number;
+    /** Write cost multiplier vs base input price for long cache. */
+    longWritePremium: number;
+    /** Read cost multiplier vs base input price (0.1 = 90% discount). */
+    readDiscount: number;
+    /** Whether the TTL resets on each cache hit. */
+    ttlResetsOnHit: boolean;
+    /** True if "long" has no cost penalty over "short" (e.g. OpenAI). */
+    preferLong: boolean;
+}
+/**
+ * Cache configuration for all known providers.
+ *
+ * Only Anthropic, Bedrock (Claude), and OpenAI Responses actually implement
+ * cacheRetention in pi-ai. All other providers ignore it (no-op).
+ */
+export declare const PROVIDER_CACHE_CONFIG: Record<string, ProviderCacheConfig>;
+/**
+ * Resolve the optimal cache retention setting for a provider and tick interval.
+ *
+ * Decision logic:
+ * - Providers with preferLong (e.g. OpenAI, free writes): always "long"
+ * - Anthropic/Bedrock with interval ≤ 4.5 min: "short" (cheaper writes, TTL resets on hit)
+ * - Anthropic/Bedrock with interval > 4.5 min: "long" (need 1-hour window for sleep ticks)
+ * - Unsupported providers: "none"
+ */
+export declare function resolveCacheRetention(provider: string, tickIntervalMs: number): CacheRetention;
+//# sourceMappingURL=provider-registry.d.ts.map

package/dist/provider-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-registry.d.ts","sourceRoot":"","sources":["../src/provider-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,qDAAqD;AACrD,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,SAAS,CAAC;AAE7C,gDAAgD;AAChD,MAAM,WAAW,YAAY;IAC3B,mEAAmE;IACnE,EAAE,EAAE,MAAM,CAAC;IACX,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,yEAAyE;IACzE,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAED,wDAAwD;AACxD,MAAM,WAAW,SAAS;IACxB,2DAA2D;IAC3D,EAAE,EAAE,MAAM,CAAC;IACX,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,aAAa,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,gBAAgB,EAAE,OAAO,CAAC;IAC1B,0EAA0E;IAC1E,uBAAuB,EAAE,KAAK,CAAC,KAAK,GAAG,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,KAAK,CAAC,CAAC;IACtF,8CAA8C;IAC9C,cAAc,EAAE,OAAO,CAAC;IACxB,iDAAiD;IACjD,OAAO,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;CACzD;AAMD;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,EAAE,YAAY,EA8L3C,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,EAItC,CAAC;AAMF;;;;;;;GAOG;AACH;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAOzD,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAQzD,CAAC;AAMF,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAEvD,2EAA2E;AAC3E,MAAM,WAAW,mBAAmB;IAClC,iEAAiE;IACjE,SAAS,EAAE,OAAO,CAAC;IACnB,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gEAAgE;IAChE,gBAAgB,EAAE,MAAM,CAAC;IACzB,qEAAqE;IACrE,YAAY,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,cAAc,EAAE,OAAO,CAAC;IACxB,qEAAqE;IACrE,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAOrE,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,cAAc,CA4B9F"}

package/dist/provider-registry.js

@@ -0,0 +1,305 @@
+/**
+ * Static provider registry for known LLM providers.
+ *
+ * This module contains:
+ * 1. PROVIDER_REGISTRY: metadata for all known providers (auth methods, env vars, key prefixes)
+ * 2. OAUTH_PROVIDER_IDS: the subset of providers that support OAuth
+ * 3. UTILITY_MODEL_DEFAULTS: per-provider cheapest-capable model for utility operations
+ *
+ * OAuth flows are resolved through pi-ai's OAuth provider registry at runtime.
+ *
+ * Reference: provider-manager.md
+ */
+// ---------------------------------------------------------------------------
+// Provider Registry
+// ---------------------------------------------------------------------------
+/**
+ * All known providers with their authentication methods and UX metadata.
+ *
+ * This registry is maintained manually. When pi-ai adds a new provider,
+ * a corresponding entry is added here. Providers not in the registry can
+ * still be used via resolveModel() and createCustomModel() with direct
+ * API keys; they just won't appear in the discovery UI.
+ */
+export const PROVIDER_REGISTRY = [
+    {
+        id: 'anthropic',
+        name: 'Anthropic',
+        authMethods: ['oauth', 'api_key'],
+        envVar: 'ANTHROPIC_API_KEY',
+        keyPrefix: 'sk-ant-',
+        keyUrl: 'console.anthropic.com/settings/keys',
+    },
+    {
+        id: 'openai',
+        name: 'OpenAI',
+        authMethods: ['api_key'],
+        envVar: 'OPENAI_API_KEY',
+        keyPrefix: 'sk-proj-',
+        keyUrl: 'platform.openai.com/api-keys',
+    },
+    {
+        id: 'azure-openai-responses',
+        name: 'Azure OpenAI',
+        authMethods: ['api_key'],
+        envVar: 'AZURE_OPENAI_API_KEY',
+    },
+    {
+        id: 'openai-codex',
+        name: 'OpenAI Codex',
+        authMethods: ['oauth'],
+    },
+    {
+        id: 'google',
+        name: 'Google',
+        authMethods: ['api_key'],
+        envVar: 'GEMINI_API_KEY',
+        keyUrl: 'aistudio.google.com/apikey',
+    },
+    {
+        id: 'google-vertex',
+        name: 'Google Vertex AI',
+        authMethods: ['api_key'],
+        envVar: 'GOOGLE_CLOUD_API_KEY',
+    },
+    {
+        id: 'github-copilot',
+        name: 'GitHub Copilot',
+        authMethods: ['oauth'],
+    },
+    {
+        id: 'deepseek',
+        name: 'DeepSeek',
+        authMethods: ['api_key'],
+        envVar: 'DEEPSEEK_API_KEY',
+        keyUrl: 'platform.deepseek.com/api_keys',
+    },
+    {
+        id: 'mistral',
+        name: 'Mistral',
+        authMethods: ['api_key'],
+        envVar: 'MISTRAL_API_KEY',
+        keyUrl: 'console.mistral.ai/api-keys',
+    },
+    {
+        id: 'groq',
+        name: 'Groq',
+        authMethods: ['api_key'],
+        envVar: 'GROQ_API_KEY',
+        keyUrl: 'console.groq.com/keys',
+    },
+    {
+        id: 'cerebras',
+        name: 'Cerebras',
+        authMethods: ['api_key'],
+        envVar: 'CEREBRAS_API_KEY',
+        keyUrl: 'cloud.cerebras.ai',
+    },
+    {
+        id: 'xai',
+        name: 'xAI',
+        authMethods: ['api_key'],
+        envVar: 'XAI_API_KEY',
+        keyUrl: 'console.x.ai',
+    },
+    {
+        id: 'openrouter',
+        name: 'OpenRouter',
+        authMethods: ['api_key'],
+        envVar: 'OPENROUTER_API_KEY',
+        keyUrl: 'openrouter.ai/keys',
+    },
+    {
+        id: 'vercel-ai-gateway',
+        name: 'Vercel AI Gateway',
+        authMethods: ['api_key'],
+        envVar: 'AI_GATEWAY_API_KEY',
+    },
+    {
+        id: 'zai',
+        name: 'z.ai',
+        authMethods: ['api_key'],
+        envVar: 'ZAI_API_KEY',
+    },
+    {
+        id: 'minimax',
+        name: 'MiniMax',
+        authMethods: ['api_key'],
+        envVar: 'MINIMAX_API_KEY',
+    },
+    {
+        id: 'minimax-cn',
+        name: 'MiniMax China',
+        authMethods: ['api_key'],
+        envVar: 'MINIMAX_CN_API_KEY',
+    },
+    {
+        id: 'moonshotai',
+        name: 'Moonshot AI',
+        authMethods: ['api_key'],
+        envVar: 'MOONSHOT_API_KEY',
+    },
+    {
+        id: 'moonshotai-cn',
+        name: 'Moonshot AI China',
+        authMethods: ['api_key'],
+        envVar: 'MOONSHOT_API_KEY',
+    },
+    {
+        id: 'huggingface',
+        name: 'Hugging Face',
+        authMethods: ['api_key'],
+        envVar: 'HF_TOKEN',
+    },
+    {
+        id: 'fireworks',
+        name: 'Fireworks AI',
+        authMethods: ['api_key'],
+        envVar: 'FIREWORKS_API_KEY',
+    },
+    {
+        id: 'opencode',
+        name: 'OpenCode',
+        authMethods: ['api_key'],
+        envVar: 'OPENCODE_API_KEY',
+    },
+    {
+        id: 'opencode-go',
+        name: 'OpenCode Go',
+        authMethods: ['api_key'],
+        envVar: 'OPENCODE_API_KEY',
+    },
+    {
+        id: 'kimi-coding',
+        name: 'Kimi Coding',
+        authMethods: ['api_key'],
+        envVar: 'KIMI_API_KEY',
+    },
+    {
+        id: 'cloudflare-workers-ai',
+        name: 'Cloudflare Workers AI',
+        authMethods: ['api_key'],
+        envVar: 'CLOUDFLARE_API_KEY',
+    },
+    {
+        id: 'cloudflare-ai-gateway',
+        name: 'Cloudflare AI Gateway',
+        authMethods: ['api_key'],
+        envVar: 'CLOUDFLARE_API_KEY',
+    },
+    {
+        id: 'xiaomi',
+        name: 'Xiaomi',
+        authMethods: ['api_key'],
+        envVar: 'XIAOMI_API_KEY',
+    },
+    {
+        id: 'xiaomi-token-plan-cn',
+        name: 'Xiaomi Token Plan China',
+        authMethods: ['api_key'],
+        envVar: 'XIAOMI_TOKEN_PLAN_CN_API_KEY',
+    },
+    {
+        id: 'xiaomi-token-plan-ams',
+        name: 'Xiaomi Token Plan Amsterdam',
+        authMethods: ['api_key'],
+        envVar: 'XIAOMI_TOKEN_PLAN_AMS_API_KEY',
+    },
+    {
+        id: 'xiaomi-token-plan-sgp',
+        name: 'Xiaomi Token Plan Singapore',
+        authMethods: ['api_key'],
+        envVar: 'XIAOMI_TOKEN_PLAN_SGP_API_KEY',
+    },
+];
+// ---------------------------------------------------------------------------
+// OAuth Providers
+// ---------------------------------------------------------------------------
+/**
+ * Provider IDs that support OAuth login flows.
+ */
+export const OAUTH_PROVIDER_IDS = [
+    'anthropic',
+    'openai-codex',
+    'github-copilot',
+];
+// ---------------------------------------------------------------------------
+// Utility Model Defaults
+// ---------------------------------------------------------------------------
+/**
+ * Default utility model IDs per provider.
+ * Used when utilityModel is 'default' or undefined.
+ *
+ * These are the cheapest capable models for each provider,
+ * suitable for internal operations like WebFetch summarization
+ * and safety classification.
+ */
+/**
+ * Default primary model IDs per provider.
+ * Used when a user first connects a provider and no model is explicitly selected.
+ * These are the best general-purpose models for each provider.
+ */
+export const PRIMARY_MODEL_DEFAULTS = {
+    anthropic: 'claude-sonnet-4-6',
+    openai: 'gpt-5.4',
+    google: 'gemini-3.1-pro-preview',
+    groq: 'openai/gpt-oss-120b',
+    cerebras: 'gpt-oss-120b',
+    mistral: 'mistral-large-2512',
+};
+export const UTILITY_MODEL_DEFAULTS = {
+    anthropic: 'claude-haiku-4-5-20251001', // $1.00/$5.00 per 1M tokens
+    openai: 'gpt-4.1-nano', // $0.10/$0.40 per 1M tokens
+    'openai-codex': 'gpt-5.1-codex-mini', // Smallest Codex model
+    google: 'gemini-2.5-flash-lite', // $0.10/$0.40 per 1M tokens
+    groq: 'llama-3.1-8b-instant', // ~$0.05/$0.08 per 1M tokens
+    cerebras: 'llama3.1-8b', // ~$0.10/$0.10 per 1M tokens
+    mistral: 'mistral-small-2506', // $0.06/$0.18 per 1M tokens
+};
+/**
+ * Cache configuration for all known providers.
+ *
+ * Only Anthropic, Bedrock (Claude), and OpenAI Responses actually implement
+ * cacheRetention in pi-ai. All other providers ignore it (no-op).
+ */
+export const PROVIDER_CACHE_CONFIG = {
+    anthropic: { supported: true, shortTtlMs: 300_000, longTtlMs: 3_600_000, shortWritePremium: 1.25, longWritePremium: 2.0, readDiscount: 0.1, ttlResetsOnHit: true, preferLong: false },
+    bedrock: { supported: true, shortTtlMs: 300_000, longTtlMs: 3_600_000, shortWritePremium: 1.25, longWritePremium: 2.0, readDiscount: 0.1, ttlResetsOnHit: true, preferLong: false },
+    openai: { supported: true, shortTtlMs: 600_000, longTtlMs: 86_400_000, shortWritePremium: 1.0, longWritePremium: 1.0, readDiscount: 0.5, ttlResetsOnHit: true, preferLong: true },
+    google: { supported: false, shortTtlMs: 0, longTtlMs: 0, shortWritePremium: 1.0, longWritePremium: 1.0, readDiscount: 1.0, ttlResetsOnHit: false, preferLong: false },
+    mistral: { supported: false, shortTtlMs: 0, longTtlMs: 0, shortWritePremium: 1.0, longWritePremium: 1.0, readDiscount: 1.0, ttlResetsOnHit: false, preferLong: false },
+    azure: { supported: false, shortTtlMs: 0, longTtlMs: 0, shortWritePremium: 1.0, longWritePremium: 1.0, readDiscount: 1.0, ttlResetsOnHit: false, preferLong: false },
+};
+/**
+ * Resolve the optimal cache retention setting for a provider and tick interval.
+ *
+ * Decision logic:
+ * - Providers with preferLong (e.g. OpenAI, free writes): always "long"
+ * - Anthropic/Bedrock with interval ≤ 4.5 min: "short" (cheaper writes, TTL resets on hit)
+ * - Anthropic/Bedrock with interval > 4.5 min: "long" (need 1-hour window for sleep ticks)
+ * - Unsupported providers: "none"
+ */
+export function resolveCacheRetention(provider, tickIntervalMs) {
+    const config = PROVIDER_CACHE_CONFIG[provider];
+    // Unknown or unsupported provider
+    if (!config || !config.supported) {
+        return 'none';
+    }
+    // Providers where long cache is free (e.g. OpenAI): always use long
+    if (config.preferLong) {
+        return 'long';
+    }
+    // Providers with a write cost premium (e.g. Anthropic):
+    // use short when the interval fits within the short TTL (with safety margin)
+    const SHORT_TTL_SAFETY_MARGIN = 0.9; // 90% of TTL as threshold
+    const shortThreshold = config.shortTtlMs * SHORT_TTL_SAFETY_MARGIN;
+    if (tickIntervalMs <= shortThreshold) {
+        return 'short';
+    }
+    // Interval exceeds short TTL: use long if available
+    if (config.longTtlMs > 0) {
+        return 'long';
+    }
+    return 'none';
+}
+//# sourceMappingURL=provider-registry.js.map

package/dist/provider-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-registry.js","sourceRoot":"","sources":["../src/provider-registry.ts"],"names":[],"mappings":"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"}

package/dist/schema-converter.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Schema conversion utility: Zod -> JSON Schema -> TypeBox.
+ *
+ * Pi-agent-core uses TypeBox tool parameter schemas.
+ * Consumer code continues using Zod. This module bridges the gap
+ * at the tool registration boundary.
+ *
+ * Handles BOTH Zod v3 schemas (used by @animus-labs/shared tools)
+ * and Zod v4 schemas. Zod v3 schemas use `zod-to-json-schema`,
+ * Zod v4 schemas use the native `toJSONSchema()`.
+ */
+import { type TSchema } from 'typebox';
+/**
+ * Convert a Zod schema (v3 or v4) to a TypeBox TSchema via JSON Schema.
+ *
+ * @param zodSchema - Any Zod schema (z.object, z.string, etc.)
+ * @returns A TypeBox TSchema suitable for pi-agent-core AgentTool definitions
+ */
+export declare function zodToTypebox(zodSchema: unknown): Promise<TSchema>;
+//# sourceMappingURL=schema-converter.d.ts.map

package/dist/schema-converter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-converter.d.ts","sourceRoot":"","sources":["../src/schema-converter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAQ,KAAK,OAAO,EAAE,MAAM,SAAS,CAAC;AAY7C;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,SAAS,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAoBvE"}

package/dist/schema-converter.js

@@ -0,0 +1,48 @@
+/**
+ * Schema conversion utility: Zod -> JSON Schema -> TypeBox.
+ *
+ * Pi-agent-core uses TypeBox tool parameter schemas.
+ * Consumer code continues using Zod. This module bridges the gap
+ * at the tool registration boundary.
+ *
+ * Handles BOTH Zod v3 schemas (used by @animus-labs/shared tools)
+ * and Zod v4 schemas. Zod v3 schemas use `zod-to-json-schema`,
+ * Zod v4 schemas use the native `toJSONSchema()`.
+ */
+import { Type } from 'typebox';
+/**
+ * Check if a schema is a Zod v3 schema (has _def property).
+ */
+function isZodV3(schema) {
+    if (schema == null || typeof schema !== 'object')
+        return false;
+    // Zod v3 schemas have _def but NOT _zod (which is a v4 marker)
+    const obj = schema;
+    return '_def' in obj && typeof obj['_def'] === 'object' && !('_zod' in obj);
+}
+/**
+ * Convert a Zod schema (v3 or v4) to a TypeBox TSchema via JSON Schema.
+ *
+ * @param zodSchema - Any Zod schema (z.object, z.string, etc.)
+ * @returns A TypeBox TSchema suitable for pi-agent-core AgentTool definitions
+ */
+export async function zodToTypebox(zodSchema) {
+    if (!zodSchema || typeof zodSchema !== 'object') {
+        throw new Error(`zodToTypebox: received invalid schema: ${typeof zodSchema}`);
+    }
+    let jsonSchema;
+    if (isZodV3(zodSchema)) {
+        // Zod v3: use zod-to-json-schema (works with v3's _def structure)
+        const { zodToJsonSchema } = await import('zod-to-json-schema');
+        jsonSchema = zodToJsonSchema(zodSchema);
+    }
+    else {
+        // Zod v4: use native toJSONSchema
+        const { toJSONSchema } = await import('zod');
+        jsonSchema = toJSONSchema(zodSchema);
+    }
+    // Type.Unsafe wraps a raw JSON Schema object as a TSchema
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    return Type.Unsafe(jsonSchema);
+}
+//# sourceMappingURL=schema-converter.js.map

package/dist/schema-converter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-converter.js","sourceRoot":"","sources":["../src/schema-converter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,IAAI,EAAgB,MAAM,SAAS,CAAC;AAE7C;;GAEG;AACH,SAAS,OAAO,CAAC,MAAe;IAC9B,IAAI,MAAM,IAAI,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC/D,+DAA+D;IAC/D,MAAM,GAAG,GAAG,MAAiC,CAAC;IAC9C,OAAO,MAAM,IAAI,GAAG,IAAI,OAAO,GAAG,CAAC,MAAM,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC;AAC9E,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,SAAkB;IACnD,IAAI,CAAC,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,0CAA0C,OAAO,SAAS,EAAE,CAAC,CAAC;IAChF,CAAC;IAED,IAAI,UAAmB,CAAC;IAExB,IAAI,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QACvB,kEAAkE;QAClE,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;QAC/D,UAAU,GAAG,eAAe,CAAC,SAAkD,CAAC,CAAC;IACnF,CAAC;SAAM,CAAC;QACN,kCAAkC;QAClC,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,CAAC;QAC7C,UAAU,GAAG,YAAY,CAAC,SAA+C,CAAC,CAAC;IAC7E,CAAC;IAED,0DAA0D;IAC1D,8DAA8D;IAC9D,OAAO,IAAI,CAAC,MAAM,CAAC,UAAiB,CAAC,CAAC;AACxC,CAAC"}

package/dist/skill-preprocessor.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Skill Preprocessor: processes SKILL.md body at load time.
+ *
+ * Three preprocessor types run in order:
+ * 1. Variable substitution: ${VAR}, $ARGUMENTS, $N
+ * 2. Shell commands: !`command` (parallel execution)
+ * 3. Script execution: !{script: path} (parallel execution)
+ *
+ * Shell commands use the same shell selection logic as the Bash tool
+ * (PowerShell on Windows, bash/zsh on Unix).
+ *
+ * References:
+ *   - docs/cortex/skill-system.md
+ *   - docs/cortex/cross-platform-considerations.md
+ */
+export interface PreprocessorConfig {
+    /** Variables for ${VAR} and $N substitution. */
+    variables: Record<string, string>;
+    /** Context object passed to script executions. */
+    scriptContext: Record<string, unknown>;
+    /** Absolute path to the skill directory. */
+    skillDir: string;
+}
+/**
+ * Preprocess a SKILL.md body. Runs all three stages:
+ * 1. Variable substitution
+ * 2. Shell commands and scripts (in parallel)
+ * 3. Assemble final content
+ */
+export declare function preprocessSkillBody(body: string, config: PreprocessorConfig): Promise<string>;
+/**
+ * Substitute ${VAR}, $ARGUMENTS, and $N references with their values.
+ */
+export declare function substituteVariables(body: string, variables: Record<string, string>): string;
+/**
+ * Execute a shell command and return stdout.
+ * Uses the same shell selection as the Bash tool.
+ */
+export declare function executeShellCommand(command: string, cwd: string): Promise<string>;
+/**
+ * Execute a JavaScript script and return its output.
+ * Scripts are loaded via dynamic import() and must export a default
+ * async function.
+ */
+export declare function executeScript(scriptPath: string, extraArgsStr: string, config: PreprocessorConfig): Promise<string>;
+//# sourceMappingURL=skill-preprocessor.d.ts.map

package/dist/skill-preprocessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-preprocessor.d.ts","sourceRoot":"","sources":["../src/skill-preprocessor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAWH,MAAM,WAAW,kBAAkB;IACjC,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,kDAAkD;IAClD,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;CAClB;AA8ED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,MAAM,CAAC,CAoDjB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAChC,MAAM,CAiBR;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,CAAC,CAqCjB;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,MAAM,CAAC,CA4DjB"}