@uluops/core 0.5.0

package/dist/ai/ModelCatalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModelCatalog.d.ts","sourceRoot":"","sources":["../../src/ai/ModelCatalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,IAAI,WAAW,EAC7B,KAAK,EACL,UAAU,IAAI,kBAAkB,EAEhC,iBAAiB,EACjB,SAAS,EACV,MAAM,sBAAsB,CAAC;AAG9B;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,kDAAkD;IAClD,QAAQ,EAAE,MAAM,CAAC;IAEjB,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAC;IAEhB,4CAA4C;IAC5C,eAAe,EAAE,MAAM,CAAC;IAExB,qCAAqC;IACrC,IAAI,EAAE,SAAS,CAAC;IAEhB,yBAAyB;IACzB,YAAY,EAAE,iBAAiB,CAAC;IAEhC,iDAAiD;IACjD,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,0CAA0C;IAC1C,oBAAoB,CAAC,EAAE,KAAK,CAAC,MAAM,iBAAiB,CAAC,CAAC;IAEtD,uDAAuD;IACvD,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAYD;;;;;;;;;;GAUG;AACH,qBAAa,YAAY;IAIX,OAAO,CAAC,GAAG;IAHvB,OAAO,CAAC,UAAU,CAAsC;IACxD,OAAO,CAAC,UAAU,CAA4B;gBAE1B,GAAG,EAAE,WAAW;IAEpC;;;;;;;OAOG;IACG,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAwB3E;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAKlD;;OAEG;IACG,UAAU,CAAC,MAAM,CAAC,EAAE;QACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,IAAI,CAAC,EAAE,SAAS,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,iBAAiB,CAAC;KACtC,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAKpB;;OAEG;IACH,OAAO,IAAI,IAAI;YASD,eAAe;YAqCf,YAAY;YAcZ,aAAa;YA+Bb,QAAQ;IActB,iEAAiE;IACjE,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,eAAe;IAavB,OAAO,CAAC,oBAAoB;CAe7B"}

package/dist/ai/ModelCatalog.js

@@ -0,0 +1,193 @@
+import { ModelNotFoundError, CapabilityError } from '../errors/index.js';
+const VALID_TIERS = ['budget', 'standard', 'premium', 'reasoning'];
+const DEFAULT_CAPABILITIES = {
+    vision: false,
+    tools: true,
+    streaming: true,
+    extendedThinking: false,
+    structuredOutput: false,
+};
+/**
+ * Registry-backed model catalog with in-memory caching.
+ *
+ * Resolution priority:
+ * 1. Explicit provider:modelId (e.g., "anthropic:claude-sonnet-4-5-20250929")
+ * 2. Registry alias (e.g., "sonnet") via models.resolveAlias()
+ * 3. Tier name (e.g., "premium") — resolves to first available model for tier
+ *
+ * Cache is in-memory only. Call refresh() to clear after admin syncs models.
+ * No auto-sync or TTL — model sync is an admin operation.
+ */
+export class ModelCatalog {
+    sdk;
+    aliasCache = new Map();
+    modelCache = new Map();
+    constructor(sdk) {
+        this.sdk = sdk;
+    }
+    /**
+     * Resolve a model input to a fully-qualified ResolvedModel.
+     *
+     * @param input - Alias ('sonnet'), tier ('premium'), or 'provider:modelId'
+     * @param opts - Resolution options (capability checks, provider preference)
+     * @throws {ModelNotFoundError} If alias/model cannot be resolved
+     * @throws {CapabilityError} If model lacks required capabilities
+     */
+    async resolve(input, opts) {
+        // 1. Explicit provider:modelId
+        if (input.includes(':')) {
+            return this.resolveExplicit(input, opts);
+        }
+        // 2. Try alias resolution
+        const aliasResult = await this.resolveAlias(input);
+        if (aliasResult) {
+            const resolved = this.toResolvedModel(aliasResult, input);
+            this.validateCapabilities(resolved, opts?.requiredCapabilities);
+            return resolved;
+        }
+        // 3. Try tier resolution
+        const tierResult = await this.resolveByTier(input, opts);
+        if (tierResult)
+            return tierResult;
+        throw new ModelNotFoundError(`Cannot resolve model "${input}". Not found as alias, tier, or provider:modelId. ` +
+            `Use catalog.listAliases() to see available aliases.`);
+    }
+    /**
+     * List all available aliases
+     */
+    async listAliases() {
+        const result = await this.sdk.models.listAliases();
+        return result.aliases;
+    }
+    /**
+     * List available models, optionally filtered
+     */
+    async listModels(filter) {
+        const result = await this.sdk.models.list(filter);
+        return result.models;
+    }
+    /**
+     * Clear in-memory cache. Call after admin syncs models in the registry.
+     */
+    refresh() {
+        this.aliasCache.clear();
+        this.modelCache.clear();
+    }
+    // ─────────────────────────────────────────────────────────────────────────
+    // Private: Resolution Strategies
+    // ─────────────────────────────────────────────────────────────────────────
+    async resolveExplicit(providerModelId, opts) {
+        const colonIdx = providerModelId.indexOf(':');
+        const provider = providerModelId.substring(0, colonIdx);
+        const modelId = providerModelId.substring(colonIdx + 1);
+        // Look up in registry for capabilities/tier
+        const model = await this.getModel(provider, modelId);
+        if (!model) {
+            // Allow unregistered models (user may have access to models not in registry)
+            const resolved = {
+                provider,
+                modelId,
+                providerModelId: modelId,
+                tier: 'standard',
+                capabilities: DEFAULT_CAPABILITIES,
+                resolvedFrom: providerModelId,
+            };
+            this.validateCapabilities(resolved, opts?.requiredCapabilities);
+            return resolved;
+        }
+        const resolved = {
+            provider: model.provider,
+            modelId: model.modelId,
+            providerModelId: model.providerModelId,
+            tier: model.tier,
+            capabilities: model.capabilities,
+            resolvedFrom: providerModelId,
+        };
+        this.validateCapabilities(resolved, opts?.requiredCapabilities);
+        return resolved;
+    }
+    async resolveAlias(alias) {
+        const cached = this.aliasCache.get(alias);
+        if (cached !== undefined)
+            return cached;
+        try {
+            const result = await this.sdk.models.resolveAlias(alias);
+            this.aliasCache.set(alias, result);
+            return result;
+        }
+        catch (error) {
+            if (this.isNotFoundError(error))
+                return null;
+            throw error;
+        }
+    }
+    async resolveByTier(tier, opts) {
+        if (!VALID_TIERS.includes(tier))
+            return null;
+        const models = await this.sdk.models.list({
+            tier: tier,
+            ...(opts?.preferredProvider ? { provider: opts.preferredProvider } : {}),
+        });
+        const model = models.models[0];
+        if (!model)
+            return null;
+        const resolved = {
+            provider: model.provider,
+            modelId: model.modelId,
+            providerModelId: model.providerModelId,
+            tier: model.tier,
+            capabilities: model.capabilities,
+            resolvedFrom: tier,
+        };
+        this.validateCapabilities(resolved, opts?.requiredCapabilities);
+        return resolved;
+    }
+    // ─────────────────────────────────────────────────────────────────────────
+    // Private: Cache + Helpers
+    // ─────────────────────────────────────────────────────────────────────────
+    async getModel(provider, modelId) {
+        const key = `${provider}:${modelId}`;
+        if (this.modelCache.has(key))
+            return this.modelCache.get(key);
+        try {
+            const model = await this.sdk.models.get(provider, modelId);
+            this.modelCache.set(key, model);
+            return model;
+        }
+        catch (error) {
+            if (this.isNotFoundError(error))
+                return null;
+            throw error;
+        }
+    }
+    /** Check if an error is a 404/not-found from the registry API */
+    isNotFoundError(error) {
+        if (typeof error === 'object' && error !== null && 'status' in error) {
+            return error.status === 404;
+        }
+        return false;
+    }
+    toResolvedModel(alias, input) {
+        const model = alias.model;
+        const targetParts = alias.target.split(':');
+        return {
+            provider: model?.provider ?? targetParts[0] ?? 'unknown',
+            modelId: model?.modelId ?? targetParts[1] ?? alias.target,
+            providerModelId: model?.providerModelId ?? targetParts[1] ?? alias.target,
+            tier: model?.tier ?? 'standard',
+            capabilities: model?.capabilities ?? DEFAULT_CAPABILITIES,
+            resolvedFrom: input,
+        };
+    }
+    validateCapabilities(model, required) {
+        if (!required || required.length === 0)
+            return;
+        const missing = required.filter(cap => !model.capabilities[cap]);
+        if (missing.length > 0) {
+            throw new CapabilityError(`Model "${model.resolvedFrom}" (${model.provider}:${model.modelId}) ` +
+                `lacks required capabilities: ${missing.join(', ')}. ` +
+                `Model capabilities: ${JSON.stringify(model.capabilities)}`);
+        }
+    }
+}
+//# sourceMappingURL=ModelCatalog.js.map

package/dist/ai/ModelCatalog.js.map

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

package/dist/ai/ShellExecutor.d.ts

@@ -0,0 +1,42 @@
+export interface ShellResult {
+    stdout: string;
+    stderr: string;
+    timedOut: boolean;
+    exitCode: number;
+}
+export interface OpenAIShellAction {
+    commands: string[];
+    timeoutMs?: number;
+    maxOutputLength?: number;
+}
+export interface OpenAIShellOutput {
+    output: Array<{
+        stdout: string;
+        stderr: string;
+        outcome: {
+            type: 'timeout';
+        } | {
+            type: 'exit';
+            exitCode: number;
+        };
+    }>;
+}
+/**
+ * Execute a shell command string via `exec()`.
+ *
+ * SECURITY NOTE: The bash tool is an opt-in feature gated by `agentTools: ['bash']` in the
+ * agent YAML definition. When enabled, the LLM-generated command string is passed directly
+ * to `exec()` (i.e., `sh -c <command>`), which grants the LLM full host OS access scoped
+ * to `cwd`. There is no allowlist or OS-level sandbox. Only enable the bash tool in
+ * isolated environments (containers, CI sandboxes). Never enable it for untrusted targets.
+ */
+export declare function runShellCommand(command: string, cwd: string, timeoutMs: number): Promise<ShellResult>;
+/** Anthropic bash tool adapter — returns plain string */
+export declare function executeShellAsString(command: string, cwd: string, timeoutMs: number): Promise<string>;
+/**
+ * OpenAI shell tool adapter — returns structured output.
+ * Shell tool action shape (verified from @ai-sdk/openai index.d.ts:718-722):
+ *   { commands: string[], timeoutMs?: number, maxOutputLength?: number }
+ */
+export declare function executeShellAsOpenAIResult(action: OpenAIShellAction, cwd: string, defaultTimeoutMs: number): Promise<OpenAIShellOutput>;
+//# sourceMappingURL=ShellExecutor.d.ts.map

package/dist/ai/ShellExecutor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShellExecutor.d.ts","sourceRoot":"","sources":["../../src/ai/ShellExecutor.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,KAAK,CAAC;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE;YAAE,IAAI,EAAE,SAAS,CAAA;SAAE,GAAG;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAA;SAAE,CAAC;KACnE,CAAC,CAAC;CACJ;AAED;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,WAAW,CAAC,CAoBtB;AAED,yDAAyD;AACzD,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,CAAC,CAIjB;AAED;;;;GAIG;AACH,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,iBAAiB,EACzB,GAAG,EAAE,MAAM,EACX,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,iBAAiB,CAAC,CAgB5B"}

package/dist/ai/ShellExecutor.js

@@ -0,0 +1,62 @@
+import { exec } from 'child_process';
+import { promisify } from 'util';
+const execAsync = promisify(exec);
+/**
+ * Execute a shell command string via `exec()`.
+ *
+ * SECURITY NOTE: The bash tool is an opt-in feature gated by `agentTools: ['bash']` in the
+ * agent YAML definition. When enabled, the LLM-generated command string is passed directly
+ * to `exec()` (i.e., `sh -c <command>`), which grants the LLM full host OS access scoped
+ * to `cwd`. There is no allowlist or OS-level sandbox. Only enable the bash tool in
+ * isolated environments (containers, CI sandboxes). Never enable it for untrusted targets.
+ */
+export async function runShellCommand(command, cwd, timeoutMs) {
+    try {
+        const { stdout, stderr } = await execAsync(command, {
+            cwd,
+            timeout: timeoutMs,
+            maxBuffer: 1024 * 1024, // 1MB
+        });
+        return { stdout: stdout || '', stderr: stderr || '', timedOut: false, exitCode: 0 };
+    }
+    catch (error) {
+        const err = error;
+        if (err.killed || err.signal) {
+            return { stdout: err.stdout || '', stderr: err.stderr || '', timedOut: true, exitCode: 1 };
+        }
+        return {
+            stdout: err.stdout || '',
+            stderr: err.stderr || String(error),
+            timedOut: false,
+            exitCode: typeof err.code === 'number' ? err.code : 1,
+        };
+    }
+}
+/** Anthropic bash tool adapter — returns plain string */
+export async function executeShellAsString(command, cwd, timeoutMs) {
+    const result = await runShellCommand(command, cwd, timeoutMs);
+    if (result.timedOut)
+        return `Command timed out after ${timeoutMs}ms`;
+    return result.stdout || result.stderr || '(no output)';
+}
+/**
+ * OpenAI shell tool adapter — returns structured output.
+ * Shell tool action shape (verified from @ai-sdk/openai index.d.ts:718-722):
+ *   { commands: string[], timeoutMs?: number, maxOutputLength?: number }
+ */
+export async function executeShellAsOpenAIResult(action, cwd, defaultTimeoutMs) {
+    const timeoutMs = action.timeoutMs ?? defaultTimeoutMs;
+    const results = [];
+    for (const command of action.commands) {
+        const result = await runShellCommand(command, cwd, timeoutMs);
+        results.push({
+            stdout: result.stdout,
+            stderr: result.stderr,
+            outcome: result.timedOut
+                ? { type: 'timeout' }
+                : { type: 'exit', exitCode: result.exitCode },
+        });
+    }
+    return { output: results };
+}
+//# sourceMappingURL=ShellExecutor.js.map

package/dist/ai/ShellExecutor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShellExecutor.js","sourceRoot":"","sources":["../../src/ai/ShellExecutor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AAEjC,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;AAuBlC;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,OAAe,EACf,GAAW,EACX,SAAiB;IAEjB,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,OAAO,EAAE;YAClD,GAAG;YACH,OAAO,EAAE,SAAS;YAClB,SAAS,EAAE,IAAI,GAAG,IAAI,EAAE,MAAM;SAC/B,CAAC,CAAC;QACH,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,IAAI,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IACtF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,GAAG,GAAG,KAA+F,CAAC;QAC5G,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;YAC7B,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;QAC7F,CAAC;QACD,OAAO;YACL,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,EAAE;YACxB,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,MAAM,CAAC,KAAK,CAAC;YACnC,QAAQ,EAAE,KAAK;YACf,QAAQ,EAAE,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;SACtD,CAAC;IACJ,CAAC;AACH,CAAC;AAED,yDAAyD;AACzD,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,OAAe,EACf,GAAW,EACX,SAAiB;IAEjB,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,OAAO,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC;IAC9D,IAAI,MAAM,CAAC,QAAQ;QAAE,OAAO,2BAA2B,SAAS,IAAI,CAAC;IACrE,OAAO,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,IAAI,aAAa,CAAC;AACzD,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,MAAyB,EACzB,GAAW,EACX,gBAAwB;IAExB,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,gBAAgB,CAAC;IACvD,MAAM,OAAO,GAAG,EAAE,CAAC;IAEnB,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACtC,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,OAAO,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC;QAC9D,OAAO,CAAC,IAAI,CAAC;YACX,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,OAAO,EAAE,MAAM,CAAC,QAAQ;gBACtB,CAAC,CAAC,EAAE,IAAI,EAAE,SAAkB,EAAE;gBAC9B,CAAC,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE;SACzD,CAAC,CAAC;IACL,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC7B,CAAC"}

package/dist/ai/TokenBudgetTracker.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Tracks context window usage across steps and provides budget status.
+ *
+ * Each step's `inputTokens` from the AI SDK represents the TOTAL input tokens
+ * for that API call (including all previous conversation + cached tokens).
+ * This means the last step's `inputTokens` IS the current context window size.
+ * We replace (not accumulate) the input value on each update.
+ *
+ * Output tokens are incremental per step and accumulated normally.
+ *
+ * Used by:
+ * - ToolAdapter: exposes `get_token_budget` synthetic tool
+ * - AIProvider: updated via `onStepFinish` callback
+ * - AgentExecutor: passed `contextBudget` to configure the tracker
+ */
+export declare class TokenBudgetTracker {
+    private budget;
+    /** Current context window size (last step's total input tokens) */
+    private currentContextTokens;
+    /** Cumulative output tokens across all steps */
+    private cumulativeOutput;
+    constructor(budget: number);
+    /**
+     * Record token usage from a completed step.
+     *
+     * `inputTokens` is the full context window size for the latest API call
+     * (replaces previous value). `outputTokens` is incremental (accumulated).
+     */
+    update(inputTokens: number, outputTokens: number): void;
+    /**
+     * Get current budget status for the LLM.
+     *
+     * `usedTotal` represents the current context window size, which is
+     * what determines whether we'll hit the model's context limit.
+     */
+    getStatus(): {
+        budget: number;
+        usedInput: number;
+        usedOutput: number;
+        usedTotal: number;
+        remaining: number;
+        percentUsed: number;
+    };
+    /**
+     * Check if context window usage has exceeded a threshold percentage.
+     */
+    isOverThreshold(threshold: number): boolean;
+}
+//# sourceMappingURL=TokenBudgetTracker.d.ts.map

package/dist/ai/TokenBudgetTracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TokenBudgetTracker.d.ts","sourceRoot":"","sources":["../../src/ai/TokenBudgetTracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,qBAAa,kBAAkB;IAMjB,OAAO,CAAC,MAAM;IAL1B,mEAAmE;IACnE,OAAO,CAAC,oBAAoB,CAAK;IACjC,gDAAgD;IAChD,OAAO,CAAC,gBAAgB,CAAK;gBAET,MAAM,EAAE,MAAM;IAElC;;;;;OAKG;IACH,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI;IAKvD;;;;;OAKG;IACH,SAAS,IAAI;QACX,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;KACrB;IAeD;;OAEG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;CAG5C"}

package/dist/ai/TokenBudgetTracker.js

@@ -0,0 +1,61 @@
+/**
+ * Tracks context window usage across steps and provides budget status.
+ *
+ * Each step's `inputTokens` from the AI SDK represents the TOTAL input tokens
+ * for that API call (including all previous conversation + cached tokens).
+ * This means the last step's `inputTokens` IS the current context window size.
+ * We replace (not accumulate) the input value on each update.
+ *
+ * Output tokens are incremental per step and accumulated normally.
+ *
+ * Used by:
+ * - ToolAdapter: exposes `get_token_budget` synthetic tool
+ * - AIProvider: updated via `onStepFinish` callback
+ * - AgentExecutor: passed `contextBudget` to configure the tracker
+ */
+export class TokenBudgetTracker {
+    budget;
+    /** Current context window size (last step's total input tokens) */
+    currentContextTokens = 0;
+    /** Cumulative output tokens across all steps */
+    cumulativeOutput = 0;
+    constructor(budget) {
+        this.budget = budget;
+    }
+    /**
+     * Record token usage from a completed step.
+     *
+     * `inputTokens` is the full context window size for the latest API call
+     * (replaces previous value). `outputTokens` is incremental (accumulated).
+     */
+    update(inputTokens, outputTokens) {
+        this.currentContextTokens = inputTokens;
+        this.cumulativeOutput += outputTokens;
+    }
+    /**
+     * Get current budget status for the LLM.
+     *
+     * `usedTotal` represents the current context window size, which is
+     * what determines whether we'll hit the model's context limit.
+     */
+    getStatus() {
+        const usedTotal = this.currentContextTokens;
+        const remaining = Math.max(0, this.budget - usedTotal);
+        const percentUsed = this.budget > 0 ? Math.round((usedTotal / this.budget) * 100) : 0;
+        return {
+            budget: this.budget,
+            usedInput: this.currentContextTokens,
+            usedOutput: this.cumulativeOutput,
+            usedTotal,
+            remaining,
+            percentUsed,
+        };
+    }
+    /**
+     * Check if context window usage has exceeded a threshold percentage.
+     */
+    isOverThreshold(threshold) {
+        return this.budget > 0 && this.currentContextTokens >= this.budget * threshold;
+    }
+}
+//# sourceMappingURL=TokenBudgetTracker.js.map

package/dist/ai/TokenBudgetTracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TokenBudgetTracker.js","sourceRoot":"","sources":["../../src/ai/TokenBudgetTracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,kBAAkB;IAMT;IALpB,mEAAmE;IAC3D,oBAAoB,GAAG,CAAC,CAAC;IACjC,gDAAgD;IACxC,gBAAgB,GAAG,CAAC,CAAC;IAE7B,YAAoB,MAAc;QAAd,WAAM,GAAN,MAAM,CAAQ;IAAG,CAAC;IAEtC;;;;;OAKG;IACH,MAAM,CAAC,WAAmB,EAAE,YAAoB;QAC9C,IAAI,CAAC,oBAAoB,GAAG,WAAW,CAAC;QACxC,IAAI,CAAC,gBAAgB,IAAI,YAAY,CAAC;IACxC,CAAC;IAED;;;;;OAKG;IACH,SAAS;QAQP,MAAM,SAAS,GAAG,IAAI,CAAC,oBAAoB,CAAC;QAC5C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;QACvD,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAEtF,OAAO;YACL,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,SAAS,EAAE,IAAI,CAAC,oBAAoB;YACpC,UAAU,EAAE,IAAI,CAAC,gBAAgB;YACjC,SAAS;YACT,SAAS;YACT,WAAW;SACZ,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,SAAiB;QAC/B,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,oBAAoB,IAAI,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;IACjF,CAAC;CACF"}

package/dist/ai/ToolAdapter.d.ts

@@ -0,0 +1,25 @@
+import { type ToolSet } from 'ai';
+import type { ToolHandler } from '../executor/ToolHandler.js';
+import type { TokenBudgetTracker } from './TokenBudgetTracker.js';
+/**
+ * Converts UluOps ToolHandler to AI SDK v6 tool format.
+ *
+ * AI SDK v6 uses Zod schemas via `inputSchema` for input validation.
+ * This adapter bridges ToolHandler's JSON Schema tools to AI SDK's Zod-based tool definitions.
+ */
+export declare class ToolAdapter {
+    private toolHandler;
+    private additionalTools?;
+    private budgetTracker?;
+    constructor(toolHandler: ToolHandler, additionalTools?: ToolSet | undefined, budgetTracker?: TokenBudgetTracker | undefined);
+    /**
+     * Execute a tool call via ToolHandler and return content or throw on error.
+     */
+    private executeTool;
+    /**
+     * Get AI SDK v6 compatible tools from ToolHandler.
+     * Converts JSON Schema tool definitions to Zod-based AI SDK tools.
+     */
+    getTools(): ToolSet;
+}
+//# sourceMappingURL=ToolAdapter.d.ts.map

package/dist/ai/ToolAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolAdapter.d.ts","sourceRoot":"","sources":["../../src/ai/ToolAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,OAAO,EAAE,MAAM,IAAI,CAAC;AAExC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE;;;;;GAKG;AACH,qBAAa,WAAW;IAEpB,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,eAAe,CAAC;IACxB,OAAO,CAAC,aAAa,CAAC;gBAFd,WAAW,EAAE,WAAW,EACxB,eAAe,CAAC,EAAE,OAAO,YAAA,EACzB,aAAa,CAAC,EAAE,kBAAkB,YAAA;IAG5C;;OAEG;YACW,WAAW;IAUzB;;;OAGG;IACH,QAAQ,IAAI,OAAO;CAuHpB"}

package/dist/ai/ToolAdapter.js

@@ -0,0 +1,135 @@
+import { tool } from 'ai';
+import { z } from 'zod';
+/**
+ * Converts UluOps ToolHandler to AI SDK v6 tool format.
+ *
+ * AI SDK v6 uses Zod schemas via `inputSchema` for input validation.
+ * This adapter bridges ToolHandler's JSON Schema tools to AI SDK's Zod-based tool definitions.
+ */
+export class ToolAdapter {
+    toolHandler;
+    additionalTools;
+    budgetTracker;
+    constructor(toolHandler, additionalTools, budgetTracker) {
+        this.toolHandler = toolHandler;
+        this.additionalTools = additionalTools;
+        this.budgetTracker = budgetTracker;
+    }
+    /**
+     * Execute a tool call via ToolHandler and return content or throw on error.
+     */
+    async executeTool(name, input) {
+        const result = await this.toolHandler.fulfill({
+            id: crypto.randomUUID(),
+            name,
+            input,
+        });
+        if (result.is_error)
+            throw new Error(result.content);
+        return result.content;
+    }
+    /**
+     * Get AI SDK v6 compatible tools from ToolHandler.
+     * Converts JSON Schema tool definitions to Zod-based AI SDK tools.
+     */
+    getTools() {
+        const tools = {
+            ...this.additionalTools,
+            read_file: tool({
+                description: 'Read the contents of a file. Use start_line/end_line for large files to avoid reading the entire file.',
+                inputSchema: z.object({
+                    path: z.string().describe('File path relative to target directory'),
+                    start_line: z.number().int().optional().describe('First line to read (1-based). Default: 1'),
+                    end_line: z.number().int().optional().describe('Last line to read (1-based). Default: end of file'),
+                }),
+                execute: async ({ path, start_line, end_line }) => this.executeTool('read_file', {
+                    path,
+                    ...(start_line !== undefined ? { start_line } : {}),
+                    ...(end_line !== undefined ? { end_line } : {}),
+                }),
+            }),
+            list_files: tool({
+                description: 'List files in a directory with size/line metadata. Supports glob patterns. Results are capped at max_results.',
+                inputSchema: z.object({
+                    path: z.string().describe('Directory path relative to target'),
+                    pattern: z.string().optional().describe('Glob pattern (e.g., "**/*.ts")'),
+                    max_results: z.number().int().optional().describe('Maximum files to return. Default: 200'),
+                }),
+                execute: async ({ path, pattern, max_results }) => this.executeTool('list_files', {
+                    path,
+                    ...(pattern !== undefined ? { pattern } : {}),
+                    ...(max_results !== undefined ? { max_results } : {}),
+                }),
+            }),
+            search_content: tool({
+                description: 'Search for a pattern across files. Supports regex. Use mode to control output verbosity.',
+                inputSchema: z.object({
+                    pattern: z.string().describe('Search pattern (supports regex)'),
+                    file_pattern: z.string().optional().describe('Glob pattern for files'),
+                    max_results: z.number().optional().describe('Max matches (default: 50)'),
+                    mode: z
+                        .enum(['matches', 'files', 'count'])
+                        .optional()
+                        .describe('"matches" (default), "files" (paths only), "count" (per-file counts)'),
+                    context_lines: z
+                        .number()
+                        .int()
+                        .optional()
+                        .describe('Lines of context before/after each match (0-5). Default: 0'),
+                }),
+                execute: async ({ pattern, file_pattern, max_results, mode, context_lines }) => this.executeTool('search_content', {
+                    pattern,
+                    ...(file_pattern !== undefined ? { file_pattern } : {}),
+                    ...(max_results !== undefined ? { max_results } : {}),
+                    ...(mode !== undefined ? { mode } : {}),
+                    ...(context_lines !== undefined ? { context_lines } : {}),
+                }),
+            }),
+            get_file_info: tool({
+                description: 'Get file metadata (size, line count, language) without reading content. Use before read_file to decide what to read.',
+                inputSchema: z.object({
+                    path: z.string().describe('File path relative to target directory'),
+                }),
+                execute: async ({ path }) => this.executeTool('get_file_info', { path }),
+            }),
+            get_directory_tree: tool({
+                description: 'Get a hierarchical view of a directory with file counts and sizes. More structured than list_files.',
+                inputSchema: z.object({
+                    path: z.string().describe('Directory path relative to target'),
+                    max_depth: z.number().int().optional().describe('Maximum depth to traverse. Default: 3'),
+                    include_sizes: z.boolean().optional().describe('Include file sizes. Default: true'),
+                }),
+                execute: async ({ path, max_depth, include_sizes }) => this.executeTool('get_directory_tree', {
+                    path,
+                    ...(max_depth !== undefined ? { max_depth } : {}),
+                    ...(include_sizes !== undefined ? { include_sizes } : {}),
+                }),
+            }),
+            get_symbols: tool({
+                description: 'Extract exported symbols (functions, classes, interfaces, types, constants) from a source file with line numbers.',
+                inputSchema: z.object({
+                    path: z.string().describe('File path relative to target directory'),
+                    include_private: z.boolean().optional().describe('Include non-exported symbols. Default: false'),
+                }),
+                execute: async ({ path, include_private }) => this.executeTool('get_symbols', {
+                    path,
+                    ...(include_private !== undefined ? { include_private } : {}),
+                }),
+            }),
+        };
+        // Synthetic tool: get_token_budget (needs runtime state, not ToolHandler)
+        if (this.budgetTracker) {
+            const tracker = this.budgetTracker;
+            tools['get_token_budget'] = tool({
+                description: 'Get current token budget status showing how much context window has been used. Use to decide whether to read more files or wrap up.',
+                inputSchema: z.object({}),
+                execute: async () => {
+                    const status = tracker.getStatus();
+                    return JSON.stringify(status, null, 2);
+                },
+            });
+        }
+        return tools;
+    }
+}
+//# sourceMappingURL=ToolAdapter.js.map

package/dist/ai/ToolAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolAdapter.js","sourceRoot":"","sources":["../../src/ai/ToolAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAgB,MAAM,IAAI,CAAC;AACxC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB;;;;;GAKG;AACH,MAAM,OAAO,WAAW;IAEZ;IACA;IACA;IAHV,YACU,WAAwB,EACxB,eAAyB,EACzB,aAAkC;QAFlC,gBAAW,GAAX,WAAW,CAAa;QACxB,oBAAe,GAAf,eAAe,CAAU;QACzB,kBAAa,GAAb,aAAa,CAAqB;IACzC,CAAC;IAEJ;;OAEG;IACK,KAAK,CAAC,WAAW,CAAC,IAAY,EAAE,KAA8B;QACpE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC;YAC5C,EAAE,EAAE,MAAM,CAAC,UAAU,EAAE;YACvB,IAAI;YACJ,KAAK;SACN,CAAC,CAAC;QACH,IAAI,MAAM,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACrD,OAAO,MAAM,CAAC,OAAO,CAAC;IACxB,CAAC;IAED;;;OAGG;IACH,QAAQ;QACN,MAAM,KAAK,GAAY;YACrB,GAAG,IAAI,CAAC,eAAe;YAEvB,SAAS,EAAE,IAAI,CAAC;gBACd,WAAW,EACT,wGAAwG;gBAC1G,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;oBACpB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;oBACnE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;oBAC5F,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mDAAmD,CAAC;iBACpG,CAAC;gBACF,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,EAAE,CAChD,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE;oBAC5B,IAAI;oBACJ,GAAG,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACnD,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAChD,CAAC;aACL,CAAC;YAEF,UAAU,EAAE,IAAI,CAAC;gBACf,WAAW,EACT,+GAA+G;gBACjH,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;oBACpB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;oBAC9D,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;oBACzE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;iBAC3F,CAAC;gBACF,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,CAChD,IAAI,CAAC,WAAW,CAAC,YAAY,EAAE;oBAC7B,IAAI;oBACJ,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC7C,GAAG,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACtD,CAAC;aACL,CAAC;YAEF,cAAc,EAAE,IAAI,CAAC;gBACnB,WAAW,EACT,0FAA0F;gBAC5F,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;oBACpB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;oBAC/D,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;oBACtE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;oBACxE,IAAI,EAAE,CAAC;yBACJ,IAAI,CAAC,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;yBACnC,QAAQ,EAAE;yBACV,QAAQ,CAAC,sEAAsE,CAAC;oBACnF,aAAa,EAAE,CAAC;yBACb,MAAM,EAAE;yBACR,GAAG,EAAE;yBACL,QAAQ,EAAE;yBACV,QAAQ,CAAC,4DAA4D,CAAC;iBAC1E,CAAC;gBACF,OAAO,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE,CAC7E,IAAI,CAAC,WAAW,CAAC,gBAAgB,EAAE;oBACjC,OAAO;oBACP,GAAG,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACvD,GAAG,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACrD,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACvC,GAAG,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC1D,CAAC;aACL,CAAC;YAEF,aAAa,EAAE,IAAI,CAAC;gBAClB,WAAW,EACT,sHAAsH;gBACxH,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;oBACpB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;iBACpE,CAAC;gBACF,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,eAAe,EAAE,EAAE,IAAI,EAAE,CAAC;aACzE,CAAC;YAEF,kBAAkB,EAAE,IAAI,CAAC;gBACvB,WAAW,EACT,qGAAqG;gBACvG,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;oBACpB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;oBAC9D,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;oBACxF,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;iBACpF,CAAC;gBACF,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,aAAa,EAAE,EAAE,EAAE,CACpD,IAAI,CAAC,WAAW,CAAC,oBAAoB,EAAE;oBACrC,IAAI;oBACJ,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACjD,GAAG,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC1D,CAAC;aACL,CAAC;YAEF,WAAW,EAAE,IAAI,CAAC;gBAChB,WAAW,EACT,mHAAmH;gBACrH,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;oBACpB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;oBACnE,eAAe,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;iBACjG,CAAC;gBACF,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,EAAE,EAAE,CAC3C,IAAI,CAAC,WAAW,CAAC,aAAa,EAAE;oBAC9B,IAAI;oBACJ,GAAG,CAAC,eAAe,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC9D,CAAC;aACL,CAAC;SACH,CAAC;QAEF,0EAA0E;QAC1E,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC;YACnC,KAAK,CAAC,kBAAkB,CAAC,GAAG,IAAI,CAAC;gBAC/B,WAAW,EACT,qIAAqI;gBACvI,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;gBACzB,OAAO,EAAE,KAAK,IAAI,EAAE;oBAClB,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;oBACnC,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;gBACzC,CAAC;aACF,CAAC,CAAC;QACL,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/ai/index.d.ts

@@ -0,0 +1,6 @@
+export { AIProvider } from './AIProvider.js';
+export type { AIGenerateResult, AIGenerateOptions } from './AIProvider.js';
+export { ModelCatalog } from './ModelCatalog.js';
+export type { ResolvedModel, ResolveOptions } from './ModelCatalog.js';
+export { ToolAdapter } from './ToolAdapter.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/ai/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAC3E,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/ai/index.js

@@ -0,0 +1,4 @@
+export { AIProvider } from './AIProvider.js';
+export { ModelCatalog } from './ModelCatalog.js';
+export { ToolAdapter } from './ToolAdapter.js';
+//# sourceMappingURL=index.js.map

package/dist/ai/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}