@framers/agentos 0.9.25 → 0.9.27

package/dist/api/generateText.d.ts

@@ -1,5 +1,6 @@
 import { type HostLLMPolicy } from './runtime/hostPolicy.js';
 import { type AdaptableToolInput } from './runtime/toolAdapter.js';
+import { type ToolMode } from './runtime/tool-emulation/index.js';
 import type { AgentOSUsageLedgerOptions } from './runtime/usageLedger.js';
 import type { ITool } from '../core/tools/ITool.js';
 import type { AgentCallRecord, AgencyTraceEvent } from './types.js';
@@ -180,6 +181,16 @@ export interface GenerateTextOptions {
      * Each tool-call round trip counts as one step. Defaults to `1`.
      */
     maxSteps?: number;
+    /**
+     * Tool-calling strategy. `'auto'` (default) uses native provider tool-calling,
+     * and on a tool-unsupported provider error falls back to a prompt-based shim
+     * (tool schemas rendered into the prompt, `<tool_call>` blocks parsed from the
+     * model's text). `'native'` forces native only. `'prompt'` forces the shim.
+     * The shim makes AgentOS tools work on models without native tool-use (e.g.
+     * the uncensored OpenRouter catalog). Shim roundtrips are capped by `maxSteps`
+     * (default 5 when unset on the shim path).
+     */
+    toolMode?: ToolMode;
     /** Sampling temperature forwarded to the provider (0-2 for most providers). */
     temperature?: number;
     /** Hard cap on output tokens. Provider-dependent default applies when omitted. */

package/dist/api/generateText.d.ts.map

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

package/dist/api/generateText.js

@@ -17,6 +17,7 @@ import { attachUsageAttributes, toTurnMetricUsage } from './observability.js';
 import { fireLlmUsageObserver } from './observers.js';
 import { hostPolicyToRouteParams, mergeRequiredCapabilities, } from './runtime/hostPolicy.js';
 import { adaptTools } from './runtime/toolAdapter.js';
+import { runEmulatedToolLoop } from './runtime/tool-emulation/index.js';
 import { resolveDynamicToolCalls } from './runtime/dynamicToolCalling.js';
 import { recordAgentOSTurnMetrics, withAgentOSSpan } from '../safety/evaluation/observability/otel.js';
 import { createLogger } from '../core/logging/loggerFactory.js';
@@ -633,119 +634,290 @@ export async function generateText(opts) {
                     span?.setAttribute('agentos.api.plan_steps', resolvedPlan.steps.length);
                 }
             }
-            for (let step = 0; step < maxSteps; step++) {
-                // --- onBeforeGeneration hook ---
-                let effectiveMessages = messages;
-                if (opts.onBeforeGeneration) {
-                    try {
-                        const hookCtx = {
-                            messages: [...messages],
-                            system: opts.system,
-                            tools: Array.from(toolMap.values()),
-                            model: resolved.modelId,
-                            provider: resolved.providerId,
-                            step,
-                            prompt: opts.prompt,
+            // --- Prompt-based tool-calling shim (toolMode) ---
+            // For models without native tool-use, render tool schemas into the
+            // prompt and parse <tool_call> blocks out of the model's text. 'prompt'
+            // forces it up front; 'auto' tries native first and falls back on the
+            // provider's tool-unsupported error (see the catch after the loop).
+            const toolMode = opts.toolMode ?? 'auto';
+            const shimMaxRoundtrips = opts.maxSteps ?? 5;
+            const runShim = async () => {
+                const loopResult = await runEmulatedToolLoop({
+                    tools: Array.from(toolMap.values()),
+                    messages: messages.map((m) => ({
+                        role: String(m.role),
+                        content: typeof m.content === 'string' ? m.content : JSON.stringify(m.content ?? ''),
+                    })),
+                    maxRoundtrips: shimMaxRoundtrips,
+                    callModel: async (msgs) => {
+                        const r = await provider.generateCompletion(resolved.modelId, msgs, {
+                            temperature: opts.temperature,
+                            maxTokens: opts.maxTokens,
+                        });
+                        const cc = r.choices?.[0]?.message?.content;
+                        return {
+                            text: typeof cc === 'string' ? cc : (cc?.text ?? ''),
+                            usage: { totalTokens: r.usage?.totalTokens ?? 0 },
                         };
-                        const modified = await opts.onBeforeGeneration(hookCtx);
-                        if (modified) {
-                            effectiveMessages = modified.messages;
+                    },
+                });
+                const shimUsage = {
+                    ...totalUsage,
+                    totalTokens: (totalUsage.totalTokens ?? 0) + loopResult.totalTokens,
+                };
+                metricUsage = shimUsage;
+                fireLlmUsageObserver({
+                    provider: resolved.providerId,
+                    model: resolved.modelId,
+                    usage: shimUsage,
+                    source: opts.source,
+                    finishReason: loopResult.finishReason,
+                    surface: 'generateText',
+                });
+                return {
+                    provider: resolved.providerId,
+                    model: resolved.modelId,
+                    text: loopResult.text,
+                    usage: shimUsage,
+                    toolCalls: loopResult.toolCalls.map((c) => ({
+                        name: c.name,
+                        args: c.args,
+                        ...(c.error ? { error: c.error } : {}),
+                    })),
+                    finishReason: loopResult.finishReason,
+                    plan: resolvedPlan,
+                };
+            };
+            const toolUnsupportedErr = (e) => e instanceof Error &&
+                /support tool use|does not support (tools|function)|no endpoints found that support/i.test(e.message);
+            if (tools.length > 0 && toolMode === 'prompt') {
+                return await runShim();
+            }
+            try {
+                for (let step = 0; step < maxSteps; step++) {
+                    // --- onBeforeGeneration hook ---
+                    let effectiveMessages = messages;
+                    if (opts.onBeforeGeneration) {
+                        try {
+                            const hookCtx = {
+                                messages: [...messages],
+                                system: opts.system,
+                                tools: Array.from(toolMap.values()),
+                                model: resolved.modelId,
+                                provider: resolved.providerId,
+                                step,
+                                prompt: opts.prompt,
+                            };
+                            const modified = await opts.onBeforeGeneration(hookCtx);
+                            if (modified) {
+                                effectiveMessages = modified.messages;
+                            }
+                        }
+                        catch (hookErr) {
+                            console.warn('[agentos] onBeforeGeneration hook error:', hookErr);
                         }
                     }
-                    catch (hookErr) {
-                        console.warn('[agentos] onBeforeGeneration hook error:', hookErr);
-                    }
-                }
-                const response = await withAgentOSSpan('agentos.api.generate_text.step', async (stepSpan) => {
-                    stepSpan?.setAttribute('llm.provider', resolved.providerId);
-                    stepSpan?.setAttribute('llm.model', resolved.modelId);
-                    stepSpan?.setAttribute('agentos.api.step', step + 1);
-                    stepSpan?.setAttribute('agentos.api.tool_count', tools.length);
-                    const stepResponse = await provider.generateCompletion(resolved.modelId, effectiveMessages, {
-                        tools: toolSchemas,
-                        temperature: opts.temperature,
-                        maxTokens: opts.maxTokens,
-                        ...(opts._responseFormat ? { responseFormat: opts._responseFormat } : {}),
+                    const response = await withAgentOSSpan('agentos.api.generate_text.step', async (stepSpan) => {
+                        stepSpan?.setAttribute('llm.provider', resolved.providerId);
+                        stepSpan?.setAttribute('llm.model', resolved.modelId);
+                        stepSpan?.setAttribute('agentos.api.step', step + 1);
+                        stepSpan?.setAttribute('agentos.api.tool_count', tools.length);
+                        const stepResponse = await provider.generateCompletion(resolved.modelId, effectiveMessages, {
+                            tools: toolSchemas,
+                            temperature: opts.temperature,
+                            maxTokens: opts.maxTokens,
+                            ...(opts._responseFormat ? { responseFormat: opts._responseFormat } : {}),
+                        });
+                        attachUsageAttributes(stepSpan, {
+                            promptTokens: stepResponse.usage?.promptTokens,
+                            completionTokens: stepResponse.usage?.completionTokens,
+                            totalTokens: stepResponse.usage?.totalTokens,
+                            costUSD: stepResponse.usage?.costUSD,
+                        });
+                        return stepResponse;
                     });
-                    attachUsageAttributes(stepSpan, {
-                        promptTokens: stepResponse.usage?.promptTokens,
-                        completionTokens: stepResponse.usage?.completionTokens,
-                        totalTokens: stepResponse.usage?.totalTokens,
-                        costUSD: stepResponse.usage?.costUSD,
-                    });
-                    return stepResponse;
-                });
-                if (response.usage) {
-                    totalUsage.promptTokens += response.usage.promptTokens ?? 0;
-                    totalUsage.completionTokens += response.usage.completionTokens ?? 0;
-                    totalUsage.totalTokens += response.usage.totalTokens ?? 0;
-                    if (typeof response.usage.costUSD === 'number') {
-                        totalUsage.costUSD = (totalUsage.costUSD ?? 0) + response.usage.costUSD;
-                    }
-                    // Plumb prompt-cache metrics through so generateText() callers
-                    // can measure cache hit rate. Provider-layer ModelUsage carries
-                    // these fields; TokenUsage was dropping them.
-                    const cacheRead = response.usage.cacheReadInputTokens;
-                    const cacheCreate = response.usage.cacheCreationInputTokens;
-                    if (typeof cacheRead === 'number' && cacheRead > 0) {
-                        totalUsage.cacheReadTokens = (totalUsage.cacheReadTokens ?? 0) + cacheRead;
+                    if (response.usage) {
+                        totalUsage.promptTokens += response.usage.promptTokens ?? 0;
+                        totalUsage.completionTokens += response.usage.completionTokens ?? 0;
+                        totalUsage.totalTokens += response.usage.totalTokens ?? 0;
+                        if (typeof response.usage.costUSD === 'number') {
+                            totalUsage.costUSD = (totalUsage.costUSD ?? 0) + response.usage.costUSD;
+                        }
+                        // Plumb prompt-cache metrics through so generateText() callers
+                        // can measure cache hit rate. Provider-layer ModelUsage carries
+                        // these fields; TokenUsage was dropping them.
+                        const cacheRead = response.usage.cacheReadInputTokens;
+                        const cacheCreate = response.usage.cacheCreationInputTokens;
+                        if (typeof cacheRead === 'number' && cacheRead > 0) {
+                            totalUsage.cacheReadTokens = (totalUsage.cacheReadTokens ?? 0) + cacheRead;
+                        }
+                        if (typeof cacheCreate === 'number' && cacheCreate > 0) {
+                            totalUsage.cacheCreationTokens = (totalUsage.cacheCreationTokens ?? 0) + cacheCreate;
+                        }
                     }
-                    if (typeof cacheCreate === 'number' && cacheCreate > 0) {
-                        totalUsage.cacheCreationTokens = (totalUsage.cacheCreationTokens ?? 0) + cacheCreate;
+                    const choice = response.choices?.[0];
+                    if (!choice)
+                        break;
+                    const content = choice.message?.content;
+                    let textContent = typeof content === 'string' ? content : (content?.text ?? '');
+                    let toolCallsInChoice = resolveDynamicToolCalls(choice.message?.tool_calls, {
+                        text: textContent,
+                        step,
+                        toolsAvailable: tools.length > 0,
+                    });
+                    // --- onAfterGeneration hook ---
+                    if (opts.onAfterGeneration) {
+                        try {
+                            const stepUsage = {
+                                promptTokens: response.usage?.promptTokens ?? 0,
+                                completionTokens: response.usage?.completionTokens ?? 0,
+                                totalTokens: response.usage?.totalTokens ?? 0,
+                                costUSD: response.usage?.costUSD,
+                                cacheReadTokens: response.usage?.cacheReadInputTokens,
+                                cacheCreationTokens: response.usage?.cacheCreationInputTokens,
+                            };
+                            const toolCallRecords = toolCallsInChoice.map((tc) => ({
+                                name: tc.function?.name ?? tc.name ?? '',
+                                args: tc.function?.arguments ?? '{}',
+                            }));
+                            const hookResult = {
+                                text: textContent,
+                                toolCalls: toolCallRecords,
+                                usage: stepUsage,
+                                step,
+                            };
+                            const modified = await opts.onAfterGeneration(hookResult);
+                            if (modified) {
+                                textContent = modified.text;
+                                if (modified.toolCalls.length === 0 && toolCallsInChoice.length > 0) {
+                                    toolCallsInChoice = [];
+                                }
+                            }
+                        }
+                        catch (hookErr) {
+                            console.warn('[agentos] onAfterGeneration hook error:', hookErr);
+                        }
                     }
-                }
-                const choice = response.choices?.[0];
-                if (!choice)
-                    break;
-                const content = choice.message?.content;
-                let textContent = typeof content === 'string' ? content : (content?.text ?? '');
-                let toolCallsInChoice = resolveDynamicToolCalls(choice.message?.tool_calls, {
-                    text: textContent,
-                    step,
-                    toolsAvailable: tools.length > 0,
-                });
-                // --- onAfterGeneration hook ---
-                if (opts.onAfterGeneration) {
-                    try {
-                        const stepUsage = {
-                            promptTokens: response.usage?.promptTokens ?? 0,
-                            completionTokens: response.usage?.completionTokens ?? 0,
-                            totalTokens: response.usage?.totalTokens ?? 0,
-                            costUSD: response.usage?.costUSD,
-                            cacheReadTokens: response.usage?.cacheReadInputTokens,
-                            cacheCreationTokens: response.usage?.cacheCreationInputTokens,
-                        };
-                        const toolCallRecords = toolCallsInChoice.map((tc) => ({
-                            name: tc.function?.name ?? tc.name ?? '',
-                            args: tc.function?.arguments ?? '{}',
-                        }));
-                        const hookResult = {
+                    if (textContent && toolCallsInChoice.length === 0) {
+                        metricUsage = totalUsage;
+                        span?.setAttribute('agentos.api.finish_reason', choice.finishReason ?? 'stop');
+                        span?.setAttribute('agentos.api.tool_calls', allToolCalls.length);
+                        attachUsageAttributes(span, totalUsage);
+                        // 2026-05-29 — fire the global LLM usage observer so hosts
+                        // (wilds-ai foundation_usage_events, billing dashboards) get
+                        // the resolved provider + model + cost without wrapping every
+                        // callsite. No-op when no observer is registered.
+                        fireLlmUsageObserver({
+                            provider: resolved.providerId,
+                            model: resolved.modelId,
+                            usage: totalUsage,
+                            source: opts.source,
+                            finishReason: choice.finishReason ?? 'stop',
+                            surface: 'generateText',
+                        });
+                        return {
+                            provider: resolved.providerId,
+                            model: resolved.modelId,
                             text: textContent,
-                            toolCalls: toolCallRecords,
-                            usage: stepUsage,
-                            step,
+                            usage: totalUsage,
+                            toolCalls: allToolCalls,
+                            finishReason: (choice.finishReason ?? 'stop'),
+                            plan: resolvedPlan,
                         };
-                        const modified = await opts.onAfterGeneration(hookResult);
-                        if (modified) {
-                            textContent = modified.text;
-                            if (modified.toolCalls.length === 0 && toolCallsInChoice.length > 0) {
-                                toolCallsInChoice = [];
+                    }
+                    if (toolCallsInChoice.length > 0) {
+                        messages.push({
+                            role: 'assistant',
+                            content: textContent || null,
+                            tool_calls: toolCallsInChoice,
+                        });
+                        for (const tc of toolCallsInChoice) {
+                            const fnName = tc.function?.name ?? tc.name ?? '';
+                            const fnArgs = tc.function?.arguments ?? '{}';
+                            const tcId = tc.id ?? '';
+                            const tool = toolMap.get(fnName);
+                            const record = {
+                                name: fnName,
+                                args: fnArgs,
+                            };
+                            let parsedArgs;
+                            try {
+                                parsedArgs =
+                                    typeof fnArgs === 'string' ? JSON.parse(fnArgs) : fnArgs;
+                                record.args = parsedArgs;
+                            }
+                            catch {
+                                record.error = `Tool "${fnName}" arguments were not valid JSON.`;
+                                messages.push({
+                                    role: 'tool',
+                                    tool_call_id: tcId,
+                                    content: JSON.stringify({ error: record.error }),
+                                });
+                                allToolCalls.push(record);
+                                continue;
+                            }
+                            // --- onBeforeToolExecution hook ---
+                            if (opts.onBeforeToolExecution) {
+                                try {
+                                    const hookInfo = {
+                                        name: fnName,
+                                        args: parsedArgs,
+                                        id: tcId || '',
+                                        step,
+                                    };
+                                    const hookResult = await opts.onBeforeToolExecution(hookInfo);
+                                    if (hookResult === null) {
+                                        record.error = 'Skipped by onBeforeToolExecution hook';
+                                        messages.push({
+                                            role: 'tool',
+                                            tool_call_id: tcId,
+                                            content: JSON.stringify({ skipped: true }),
+                                        });
+                                        allToolCalls.push(record);
+                                        continue;
+                                    }
+                                    parsedArgs = hookResult.args;
+                                }
+                                catch (hookErr) {
+                                    console.warn('[agentos] onBeforeToolExecution hook error:', hookErr);
+                                }
                             }
+                            if (tool) {
+                                try {
+                                    const result = await tool.execute(parsedArgs, buildHelperToolExecutionContext('generateText', helperToolRunId, step, tcId || undefined));
+                                    record.result = result.output;
+                                    record.error = result.success ? undefined : result.error;
+                                    messages.push({
+                                        role: 'tool',
+                                        tool_call_id: tcId,
+                                        content: JSON.stringify(result.output ?? result.error ?? ''),
+                                    });
+                                }
+                                catch (err) {
+                                    record.error = err?.message;
+                                    messages.push({
+                                        role: 'tool',
+                                        tool_call_id: tcId,
+                                        content: JSON.stringify({ error: err?.message }),
+                                    });
+                                }
+                            }
+                            else {
+                                record.error = `Tool "${fnName}" not found.`;
+                                messages.push({
+                                    role: 'tool',
+                                    tool_call_id: tcId,
+                                    content: JSON.stringify({ error: record.error }),
+                                });
+                            }
+                            allToolCalls.push(record);
                         }
+                        continue;
                     }
-                    catch (hookErr) {
-                        console.warn('[agentos] onAfterGeneration hook error:', hookErr);
-                    }
-                }
-                if (textContent && toolCallsInChoice.length === 0) {
                     metricUsage = totalUsage;
                     span?.setAttribute('agentos.api.finish_reason', choice.finishReason ?? 'stop');
                     span?.setAttribute('agentos.api.tool_calls', allToolCalls.length);
                     attachUsageAttributes(span, totalUsage);
-                    // 2026-05-29 — fire the global LLM usage observer so hosts
-                    // (wilds-ai foundation_usage_events, billing dashboards) get
-                    // the resolved provider + model + cost without wrapping every
-                    // callsite. No-op when no observer is registered.
                     fireLlmUsageObserver({
                         provider: resolved.providerId,
                         model: resolved.modelId,
@@ -764,116 +936,14 @@ export async function generateText(opts) {
                         plan: resolvedPlan,
                     };
                 }
-                if (toolCallsInChoice.length > 0) {
-                    messages.push({
-                        role: 'assistant',
-                        content: textContent || null,
-                        tool_calls: toolCallsInChoice,
-                    });
-                    for (const tc of toolCallsInChoice) {
-                        const fnName = tc.function?.name ?? tc.name ?? '';
-                        const fnArgs = tc.function?.arguments ?? '{}';
-                        const tcId = tc.id ?? '';
-                        const tool = toolMap.get(fnName);
-                        const record = {
-                            name: fnName,
-                            args: fnArgs,
-                        };
-                        let parsedArgs;
-                        try {
-                            parsedArgs =
-                                typeof fnArgs === 'string' ? JSON.parse(fnArgs) : fnArgs;
-                            record.args = parsedArgs;
-                        }
-                        catch {
-                            record.error = `Tool "${fnName}" arguments were not valid JSON.`;
-                            messages.push({
-                                role: 'tool',
-                                tool_call_id: tcId,
-                                content: JSON.stringify({ error: record.error }),
-                            });
-                            allToolCalls.push(record);
-                            continue;
-                        }
-                        // --- onBeforeToolExecution hook ---
-                        if (opts.onBeforeToolExecution) {
-                            try {
-                                const hookInfo = {
-                                    name: fnName,
-                                    args: parsedArgs,
-                                    id: tcId || '',
-                                    step,
-                                };
-                                const hookResult = await opts.onBeforeToolExecution(hookInfo);
-                                if (hookResult === null) {
-                                    record.error = 'Skipped by onBeforeToolExecution hook';
-                                    messages.push({
-                                        role: 'tool',
-                                        tool_call_id: tcId,
-                                        content: JSON.stringify({ skipped: true }),
-                                    });
-                                    allToolCalls.push(record);
-                                    continue;
-                                }
-                                parsedArgs = hookResult.args;
-                            }
-                            catch (hookErr) {
-                                console.warn('[agentos] onBeforeToolExecution hook error:', hookErr);
-                            }
-                        }
-                        if (tool) {
-                            try {
-                                const result = await tool.execute(parsedArgs, buildHelperToolExecutionContext('generateText', helperToolRunId, step, tcId || undefined));
-                                record.result = result.output;
-                                record.error = result.success ? undefined : result.error;
-                                messages.push({
-                                    role: 'tool',
-                                    tool_call_id: tcId,
-                                    content: JSON.stringify(result.output ?? result.error ?? ''),
-                                });
-                            }
-                            catch (err) {
-                                record.error = err?.message;
-                                messages.push({
-                                    role: 'tool',
-                                    tool_call_id: tcId,
-                                    content: JSON.stringify({ error: err?.message }),
-                                });
-                            }
-                        }
-                        else {
-                            record.error = `Tool "${fnName}" not found.`;
-                            messages.push({
-                                role: 'tool',
-                                tool_call_id: tcId,
-                                content: JSON.stringify({ error: record.error }),
-                            });
-                        }
-                        allToolCalls.push(record);
-                    }
-                    continue;
+            }
+            catch (loopErr) {
+                // 'auto' reactive fallback: when the provider rejects native tool-use,
+                // re-run the turn through the prompt-based shim.
+                if (tools.length > 0 && toolMode === 'auto' && toolUnsupportedErr(loopErr)) {
+                    return await runShim();
                 }
-                metricUsage = totalUsage;
-                span?.setAttribute('agentos.api.finish_reason', choice.finishReason ?? 'stop');
-                span?.setAttribute('agentos.api.tool_calls', allToolCalls.length);
-                attachUsageAttributes(span, totalUsage);
-                fireLlmUsageObserver({
-                    provider: resolved.providerId,
-                    model: resolved.modelId,
-                    usage: totalUsage,
-                    source: opts.source,
-                    finishReason: choice.finishReason ?? 'stop',
-                    surface: 'generateText',
-                });
-                return {
-                    provider: resolved.providerId,
-                    model: resolved.modelId,
-                    text: textContent,
-                    usage: totalUsage,
-                    toolCalls: allToolCalls,
-                    finishReason: (choice.finishReason ?? 'stop'),
-                    plan: resolvedPlan,
-                };
+                throw loopErr;
             }
             const lastAssistant = messages.filter((m) => m.role === 'assistant').pop();
             metricUsage = totalUsage;