@framers/agentos 0.1.113 → 0.1.114

package/dist/api/embedText.js.map

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

package/dist/api/externalToolRegistry.d.ts

@@ -0,0 +1,44 @@
+import type { ToolDefinitionForLLM } from '../core/tools/IToolOrchestrator';
+import type { IToolOrchestrator } from '../core/tools/IToolOrchestrator';
+import type { ToolExecutionContext, ToolExecutionResult, ITool, JSONSchemaObject } from '../core/tools/ITool';
+import type { AgentOSExternalToolHandlerResult } from './processRequestWithExternalTools';
+export type ExternalToolExecutor<TArgs extends Record<string, any> = Record<string, any>, TOutput = unknown> = (args: TArgs, context: ToolExecutionContext) => Promise<ToolExecutionResult<TOutput>>;
+type ExternalToolPromptMetadata = Partial<Pick<ITool<Record<string, any>, unknown>, 'name' | 'displayName' | 'description' | 'inputSchema' | 'outputSchema' | 'requiredCapabilities' | 'category' | 'version' | 'hasSideEffects'>>;
+export type ExternalToolRegistryEntry = ExternalToolExecutor | (Pick<ITool<Record<string, any>, unknown>, 'execute'> & ExternalToolPromptMetadata);
+export type NamedExternalToolRegistryEntry = Pick<ITool<Record<string, any>, unknown>, 'name' | 'execute'> & ExternalToolPromptMetadata;
+export type ExternalToolRegistry = ReadonlyMap<string, ExternalToolRegistryEntry> | Record<string, ExternalToolRegistryEntry> | Iterable<NamedExternalToolRegistryEntry>;
+export type NormalizedExternalToolRegistry = ReadonlyMap<string, ExternalToolRegistryEntry>;
+export type PromptAwareExternalToolRegistryEntry = {
+    name: string;
+    execute: ITool<Record<string, any>, unknown>['execute'];
+    description: string;
+    inputSchema: JSONSchemaObject;
+    displayName?: string;
+    outputSchema?: JSONSchemaObject;
+    requiredCapabilities?: string[];
+    category?: string;
+    version?: string;
+    hasSideEffects?: boolean;
+};
+export interface OpenAIFunctionToolSchema {
+    type: 'function';
+    function: {
+        name: string;
+        description: string;
+        parameters: JSONSchemaObject;
+    };
+}
+export declare function normalizeExternalToolRegistry(registry: ExternalToolRegistry | undefined): NormalizedExternalToolRegistry | undefined;
+export declare function mergeExternalToolRegistries(...registries: Array<ExternalToolRegistry | undefined>): NormalizedExternalToolRegistry | undefined;
+export declare function listPromptAwareExternalTools(registry: ExternalToolRegistry | undefined): PromptAwareExternalToolRegistryEntry[];
+export declare function listExternalToolDefinitionsForLLM(registry: ExternalToolRegistry | undefined): ToolDefinitionForLLM[];
+export declare function formatToolDefinitionsForOpenAI(definitions: ReadonlyArray<ToolDefinitionForLLM>): OpenAIFunctionToolSchema[];
+export declare function formatExternalToolsForOpenAI(registry: ExternalToolRegistry | undefined): OpenAIFunctionToolSchema[];
+export declare function createExternalToolProxyTool(entry: PromptAwareExternalToolRegistryEntry): ITool<Record<string, any>, unknown>;
+export declare function registerTemporaryExternalTools(toolOrchestrator: Pick<IToolOrchestrator, 'getTool' | 'registerTool' | 'unregisterTool'>, registry: ExternalToolRegistry | undefined): Promise<() => Promise<void>>;
+export declare function executeExternalToolFromRegistry(registry: ExternalToolRegistry | undefined, toolName: string, args: Record<string, any>, context: ToolExecutionContext, options: {
+    errorOrigin: string;
+    failureMessage: string;
+}): Promise<AgentOSExternalToolHandlerResult | undefined>;
+export {};
+//# sourceMappingURL=externalToolRegistry.d.ts.map

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

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

package/dist/api/externalToolRegistry.js

@@ -0,0 +1,245 @@
+import { GMIErrorCode } from '../utils/errors.js';
+import { AgentOSServiceError } from './errors.js';
+const temporaryExternalToolRefs = new WeakMap();
+function isIterableRegistry(value) {
+    return (value !== null &&
+        value !== undefined &&
+        typeof value !== 'string' &&
+        typeof value[Symbol.iterator] === 'function');
+}
+function isFunctionEntry(value) {
+    return typeof value === 'function';
+}
+function isRecordRegistry(value) {
+    return (value !== null && value !== undefined && !isIterableRegistry(value) && !(value instanceof Map));
+}
+function createDisplayName(name) {
+    return name
+        .replace(/[_-]+/g, ' ')
+        .replace(/([a-z0-9])([A-Z])/g, '$1 $2')
+        .replace(/\s+/g, ' ')
+        .trim()
+        .replace(/\b\w/g, (char) => char.toUpperCase());
+}
+function normalizeToolName(name) {
+    if (typeof name !== 'string') {
+        return undefined;
+    }
+    const trimmed = name.trim();
+    return trimmed || undefined;
+}
+function resolveExternalToolRegistryEntries(registry) {
+    if (!registry) {
+        return [];
+    }
+    if (registry instanceof Map) {
+        return Array.from(registry.entries()).map(([name, entry]) => ({ name, entry }));
+    }
+    if (isIterableRegistry(registry)) {
+        const resolved = [];
+        for (const entry of registry) {
+            resolved.push({
+                name: entry.name,
+                entry,
+            });
+        }
+        return resolved;
+    }
+    if (!isRecordRegistry(registry)) {
+        return [];
+    }
+    return Object.entries(registry).map(([name, entry]) => ({ name, entry }));
+}
+function resolveRegistryEntry(registry, toolName) {
+    for (const resolved of resolveExternalToolRegistryEntries(registry)) {
+        if (resolved.name === toolName) {
+            return resolved.entry;
+        }
+    }
+    return undefined;
+}
+export function normalizeExternalToolRegistry(registry) {
+    const normalized = new Map();
+    for (const resolved of resolveExternalToolRegistryEntries(registry)) {
+        const toolName = normalizeToolName(resolved.name);
+        if (!toolName) {
+            continue;
+        }
+        normalized.set(toolName, resolved.entry);
+    }
+    return normalized.size > 0 ? normalized : undefined;
+}
+export function mergeExternalToolRegistries(...registries) {
+    const merged = new Map();
+    for (const registry of registries) {
+        const normalized = normalizeExternalToolRegistry(registry);
+        if (!normalized) {
+            continue;
+        }
+        for (const [toolName, entry] of normalized.entries()) {
+            merged.set(toolName, entry);
+        }
+    }
+    return merged.size > 0 ? merged : undefined;
+}
+function getEntryExecutor(entry) {
+    return isFunctionEntry(entry) ? entry : entry.execute.bind(entry);
+}
+function isPromptAwareEntry(name, entry) {
+    if (isFunctionEntry(entry)) {
+        return false;
+    }
+    return (typeof name === 'string' &&
+        name.trim().length > 0 &&
+        typeof entry.description === 'string' &&
+        entry.description.trim().length > 0 &&
+        typeof entry.inputSchema === 'object' &&
+        entry.inputSchema !== null);
+}
+export function listPromptAwareExternalTools(registry) {
+    return resolveExternalToolRegistryEntries(registry)
+        .filter((resolved) => isPromptAwareEntry(resolved.name, resolved.entry))
+        .map(({ name, entry }) => ({
+        name,
+        execute: getEntryExecutor(entry),
+        displayName: typeof entry.displayName === 'string' && entry.displayName.trim().length > 0
+            ? entry.displayName
+            : createDisplayName(name),
+        description: entry.description,
+        inputSchema: entry.inputSchema,
+        outputSchema: entry.outputSchema,
+        requiredCapabilities: entry.requiredCapabilities,
+        category: entry.category,
+        version: entry.version,
+        hasSideEffects: entry.hasSideEffects,
+    }));
+}
+export function listExternalToolDefinitionsForLLM(registry) {
+    return listPromptAwareExternalTools(registry).map((tool) => ({
+        name: tool.name,
+        description: tool.description,
+        inputSchema: tool.inputSchema,
+        outputSchema: tool.outputSchema,
+    }));
+}
+export function formatToolDefinitionsForOpenAI(definitions) {
+    return definitions.map((definition) => ({
+        type: 'function',
+        function: {
+            name: definition.name,
+            description: definition.description,
+            parameters: definition.inputSchema,
+        },
+    }));
+}
+export function formatExternalToolsForOpenAI(registry) {
+    return formatToolDefinitionsForOpenAI(listExternalToolDefinitionsForLLM(registry));
+}
+export function createExternalToolProxyTool(entry) {
+    return {
+        id: `external-tool-proxy-${entry.name}`,
+        name: entry.name,
+        displayName: entry.displayName ?? createDisplayName(entry.name),
+        description: entry.description,
+        inputSchema: entry.inputSchema,
+        outputSchema: entry.outputSchema,
+        requiredCapabilities: entry.requiredCapabilities,
+        category: entry.category,
+        version: entry.version ?? 'external-proxy',
+        hasSideEffects: entry.hasSideEffects,
+        execute: entry.execute,
+    };
+}
+export async function registerTemporaryExternalTools(toolOrchestrator, registry) {
+    const acquiredRegistrations = [];
+    const orchestratorKey = toolOrchestrator;
+    let orchestratorRefs = temporaryExternalToolRefs.get(orchestratorKey);
+    if (!orchestratorRefs) {
+        orchestratorRefs = new Map();
+        temporaryExternalToolRefs.set(orchestratorKey, orchestratorRefs);
+    }
+    try {
+        for (const promptAwareTool of listPromptAwareExternalTools(registry)) {
+            const existingTool = await toolOrchestrator.getTool(promptAwareTool.name);
+            const existingRef = orchestratorRefs.get(promptAwareTool.name);
+            if (existingRef) {
+                existingRef.count += 1;
+                acquiredRegistrations.push({
+                    name: promptAwareTool.name,
+                    managesLifecycle: true,
+                });
+                continue;
+            }
+            if (existingTool) {
+                acquiredRegistrations.push({
+                    name: promptAwareTool.name,
+                    managesLifecycle: false,
+                });
+                continue;
+            }
+            await toolOrchestrator.registerTool(createExternalToolProxyTool(promptAwareTool));
+            orchestratorRefs.set(promptAwareTool.name, { count: 1 });
+            acquiredRegistrations.push({
+                name: promptAwareTool.name,
+                managesLifecycle: true,
+            });
+        }
+    }
+    catch (error) {
+        for (const registration of acquiredRegistrations.reverse()) {
+            if (!registration.managesLifecycle) {
+                continue;
+            }
+            const refState = orchestratorRefs.get(registration.name);
+            if (!refState) {
+                continue;
+            }
+            if (refState.count > 1) {
+                refState.count -= 1;
+                continue;
+            }
+            orchestratorRefs.delete(registration.name);
+            await toolOrchestrator.unregisterTool(registration.name).catch(() => false);
+        }
+        throw error;
+    }
+    return async () => {
+        for (const registration of acquiredRegistrations.reverse()) {
+            if (!registration.managesLifecycle) {
+                continue;
+            }
+            const refState = orchestratorRefs.get(registration.name);
+            if (!refState) {
+                continue;
+            }
+            if (refState.count > 1) {
+                refState.count -= 1;
+                continue;
+            }
+            orchestratorRefs.delete(registration.name);
+            await toolOrchestrator.unregisterTool(registration.name).catch(() => false);
+        }
+        if (orchestratorRefs.size === 0) {
+            temporaryExternalToolRefs.delete(orchestratorKey);
+        }
+    };
+}
+export async function executeExternalToolFromRegistry(registry, toolName, args, context, options) {
+    const entry = resolveRegistryEntry(registry, toolName);
+    if (!entry) {
+        return undefined;
+    }
+    const executor = getEntryExecutor(entry);
+    try {
+        const execution = await executor(args, context);
+        return {
+            toolOutput: execution.output,
+            isSuccess: execution.success,
+            errorMessage: execution.error,
+        };
+    }
+    catch (error) {
+        throw AgentOSServiceError.wrap(error, GMIErrorCode.TOOL_ERROR, options.failureMessage, options.errorOrigin);
+    }
+}
+//# sourceMappingURL=externalToolRegistry.js.map

package/dist/api/externalToolRegistry.js.map

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

package/dist/api/generateImage.d.ts

@@ -73,7 +73,7 @@ export interface GenerateImageResult {
 /**
  * Generates one or more images using a provider-agnostic `provider:model` string.
  *
- * Resolves credentials via {@link resolveMediaProvider}, initialises the matching
+ * Resolves credentials via `resolveMediaProvider()`, initialises the matching
  * image provider, and returns a normalised {@link GenerateImageResult}.
  *
  * @param opts - Image generation options including model, prompt, and optional parameters.

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

@@ -1 +1 @@
-{"version":3,"file":"generateImage.d.ts","sourceRoot":"","sources":["../../src/api/generateImage.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,cAAc,EACd,qBAAqB,EACrB,sBAAsB,EACtB,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,iBAAiB,EAClB,MAAM,kCAAkC,CAAC;AAG1C,OAAO,EAAsB,KAAK,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAGtF;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,UAAU,CAAC,EAAE,aAAa,EAAE,CAAC;IAC7B,wEAAwE;IACxE,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oFAAoF;IACpF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,qEAAqE;IACrE,YAAY,CAAC,EAAE,iBAAiB,CAAC;IACjC,0DAA0D;IAC1D,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,uEAAuE;IACvE,cAAc,CAAC,EAAE,mBAAmB,CAAC;IACrC,mFAAmF;IACnF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kFAAkF;IAClF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gFAAgF;IAChF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,8EAA8E;IAC9E,eAAe,CAAC,EAAE,sBAAsB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnE,+EAA+E;IAC/E,WAAW,CAAC,EAAE,yBAAyB,CAAC;CACzC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,OAAO,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,qEAAqE;IACrE,KAAK,CAAC,EAAE,qBAAqB,CAAC,OAAO,CAAC,CAAC;CACxC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAmG5F"}
+{"version":3,"file":"generateImage.d.ts","sourceRoot":"","sources":["../../src/api/generateImage.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,cAAc,EACd,qBAAqB,EACrB,sBAAsB,EACtB,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,iBAAiB,EAClB,MAAM,kCAAkC,CAAC;AAG1C,OAAO,EAAsB,KAAK,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAGtF;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,UAAU,CAAC,EAAE,aAAa,EAAE,CAAC;IAC7B,wEAAwE;IACxE,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oFAAoF;IACpF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,qEAAqE;IACrE,YAAY,CAAC,EAAE,iBAAiB,CAAC;IACjC,0DAA0D;IAC1D,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,uEAAuE;IACvE,cAAc,CAAC,EAAE,mBAAmB,CAAC;IACrC,mFAAmF;IACnF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kFAAkF;IAClF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gFAAgF;IAChF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,8EAA8E;IAC9E,eAAe,CAAC,EAAE,sBAAsB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnE,+EAA+E;IAC/E,WAAW,CAAC,EAAE,yBAAyB,CAAC;CACzC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,OAAO,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,qEAAqE;IACrE,KAAK,CAAC,EAAE,qBAAqB,CAAC,OAAO,CAAC,CAAC;CACxC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAsG5F"}

package/dist/api/generateImage.js

@@ -14,7 +14,7 @@ import { recordAgentOSTurnMetrics, withAgentOSSpan } from '../core/observability
 /**
  * Generates one or more images using a provider-agnostic `provider:model` string.
  *
- * Resolves credentials via {@link resolveMediaProvider}, initialises the matching
+ * Resolves credentials via `resolveMediaProvider()`, initialises the matching
  * image provider, and returns a normalised {@link GenerateImageResult}.
  *
  * @param opts - Image generation options including model, prompt, and optional parameters.
@@ -97,12 +97,14 @@ export async function generateImage(opts) {
             await recordAgentOSUsage({
                 providerId: metricProviderId,
                 modelId: metricModelId,
-                usage: metricUsage ? {
-                    promptTokens: metricUsage.promptTokens,
-                    completionTokens: metricUsage.completionTokens,
-                    totalTokens: metricUsage.totalTokens,
-                    costUSD: metricUsage.totalCostUSD,
-                } : undefined,
+                usage: metricUsage
+                    ? {
+                        promptTokens: metricUsage.promptTokens,
+                        completionTokens: metricUsage.completionTokens,
+                        totalTokens: metricUsage.totalTokens,
+                        costUSD: metricUsage.totalCostUSD,
+                    }
+                    : undefined,
                 options: {
                     ...opts.usageLedger,
                     source: opts.usageLedger?.source ?? 'generateImage',
@@ -115,12 +117,14 @@ export async function generateImage(opts) {
         recordAgentOSTurnMetrics({
             durationMs: Date.now() - startedAt,
             status: metricStatus,
-            usage: toTurnMetricUsage(metricUsage ? {
-                promptTokens: metricUsage.promptTokens,
-                completionTokens: metricUsage.completionTokens,
-                totalTokens: metricUsage.totalTokens,
-                totalCostUSD: metricUsage.totalCostUSD,
-            } : undefined),
+            usage: toTurnMetricUsage(metricUsage
+                ? {
+                    promptTokens: metricUsage.promptTokens,
+                    completionTokens: metricUsage.completionTokens,
+                    totalTokens: metricUsage.totalTokens,
+                    totalCostUSD: metricUsage.totalCostUSD,
+                }
+                : undefined),
         });
     }
 }

package/dist/api/generateImage.js.map

@@ -1 +1 @@
-{"version":3,"file":"generateImage.js","sourceRoot":"","sources":["../../src/api/generateImage.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"generateImage.js","sourceRoot":"","sources":["../../src/api/generateImage.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAU9D,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAkC,MAAM,kBAAkB,CAAC;AACtF,OAAO,EAAE,wBAAwB,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AA0E1F;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAA0B;IAC5D,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,IAAI,YAAY,GAAmB,IAAI,CAAC;IACxC,IAAI,WAA2C,CAAC;IAChD,IAAI,gBAAoC,CAAC;IACzC,IAAI,aAAiC,CAAC;IAEtC,IAAI,CAAC;QACH,OAAO,MAAM,eAAe,CAAC,4BAA4B,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACxE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,kBAAkB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAClE,MAAM,QAAQ,GAAG,oBAAoB,CAAC,UAAU,EAAE,OAAO,EAAE;gBACzD,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,OAAO,EAAE,IAAI,CAAC,OAAO;aACtB,CAAC,CAAC;YACH,gBAAgB,GAAG,QAAQ,CAAC,UAAU,CAAC;YACvC,aAAa,GAAG,QAAQ,CAAC,OAAO,CAAC;YAEjC,IAAI,EAAE,YAAY,CAAC,cAAc,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;YACxD,IAAI,EAAE,YAAY,CAAC,WAAW,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;YAElD,MAAM,QAAQ,GAAG,mBAAmB,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;YAC1D,MAAM,QAAQ,CAAC,UAAU,CAAC;gBACxB,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,OAAO,EAAE,QAAQ,CAAC,OAAO;gBACzB,cAAc,EAAE,QAAQ,CAAC,OAAO;aACjC,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,aAAa,CAAC;gBAC1C,OAAO,EAAE,QAAQ,CAAC,OAAO;gBACzB,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,CAAC,EAAE,IAAI,CAAC,CAAC;gBACT,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,YAAY,EAAE,IAAI,CAAC,YAAY;gBAC/B,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;gBACzC,cAAc,EAAE,IAAI,CAAC,cAAc;gBACnC,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,cAAc,EAAE,IAAI,CAAC,cAAc;gBACnC,eAAe,EAAE,IAAI,CAAC,eAAe;aACtC,CAAC,CAAC;YAEH,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC;YAC3B,IAAI,EAAE,YAAY,CAAC,0BAA0B,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACrE,qBAAqB,CAAC,IAAI,EAAE;gBAC1B,YAAY,EAAE,MAAM,CAAC,KAAK,EAAE,YAAY;gBACxC,gBAAgB,EAAE,MAAM,CAAC,KAAK,EAAE,gBAAgB;gBAChD,WAAW,EAAE,MAAM,CAAC,KAAK,EAAE,WAAW;gBACtC,YAAY,EAAE,MAAM,CAAC,KAAK,EAAE,YAAY;aACzC,CAAC,CAAC;YAEH,OAAO;gBACL,KAAK,EAAE,MAAM,CAAC,OAAO;gBACrB,QAAQ,EAAE,MAAM,CAAC,UAAU;gBAC3B,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,KAAK,EAAE,MAAM,CAAC,KAAK;aACpB,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,YAAY,GAAG,OAAO,CAAC;QACvB,MAAM,KAAK,CAAC;IACd,CAAC;YAAS,CAAC;QACT,IAAI,CAAC;YACH,MAAM,kBAAkB,CAAC;gBACvB,UAAU,EAAE,gBAAgB;gBAC5B,OAAO,EAAE,aAAa;gBACtB,KAAK,EAAE,WAAW;oBAChB,CAAC,CAAC;wBACE,YAAY,EAAE,WAAW,CAAC,YAAY;wBACtC,gBAAgB,EAAE,WAAW,CAAC,gBAAgB;wBAC9C,WAAW,EAAE,WAAW,CAAC,WAAW;wBACpC,OAAO,EAAE,WAAW,CAAC,YAAY;qBAClC;oBACH,CAAC,CAAC,SAAS;gBACb,OAAO,EAAE;oBACP,GAAG,IAAI,CAAC,WAAW;oBACnB,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,IAAI,eAAe;iBACpD;aACF,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,iFAAiF;QACnF,CAAC;QACD,wBAAwB,CAAC;YACvB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;YAClC,MAAM,EAAE,YAAY;YACpB,KAAK,EAAE,iBAAiB,CACtB,WAAW;gBACT,CAAC,CAAC;oBACE,YAAY,EAAE,WAAW,CAAC,YAAY;oBACtC,gBAAgB,EAAE,WAAW,CAAC,gBAAgB;oBAC9C,WAAW,EAAE,WAAW,CAAC,WAAW;oBACpC,YAAY,EAAE,WAAW,CAAC,YAAY;iBACvC;gBACH,CAAC,CAAC,SAAS,CACd;SACF,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

package/dist/api/generateObject.d.ts

@@ -0,0 +1,185 @@
+/**
+ * @file generateObject.ts
+ * Zod-validated structured output extraction for the AgentOS high-level API.
+ *
+ * Forces the LLM to produce JSON matching a caller-supplied Zod schema.  When
+ * the provider supports native JSON mode (`response_format: { type: 'json_object' }`),
+ * it is enabled automatically.  On parse or validation failure, the call is
+ * retried with error feedback appended to the conversation so the model can
+ * self-correct.
+ *
+ * @see {@link generateText} for the underlying text generation primitive.
+ * @see {@link streamObject} for the streaming counterpart.
+ */
+import type { ZodType, ZodError } from 'zod';
+import type { Message, TokenUsage } from './generateText.js';
+/**
+ * Thrown when structured output generation fails after exhausting all retries.
+ *
+ * Captures both the raw LLM output and the Zod validation issues so callers
+ * can inspect what went wrong and surface useful diagnostics.
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await generateObject({ schema: mySchema, prompt: '...' });
+ * } catch (err) {
+ *   if (err instanceof ObjectGenerationError) {
+ *     console.error('Raw text:', err.rawText);
+ *     console.error('Validation:', err.validationErrors);
+ *   }
+ * }
+ * ```
+ */
+export declare class ObjectGenerationError extends Error {
+    /** The raw text returned by the LLM on the final attempt. */
+    readonly rawText: string;
+    /** Zod validation error details from the last parse attempt, if available. */
+    readonly validationErrors?: ZodError | undefined;
+    /** The name of this error class, useful for `instanceof` checks across realms. */
+    readonly name = "ObjectGenerationError";
+    /**
+     * @param message - Human-readable summary of the failure.
+     * @param rawText - The last raw text the LLM produced before we gave up.
+     * @param validationErrors - Zod validation issues from the final attempt.
+     */
+    constructor(message: string, 
+    /** The raw text returned by the LLM on the final attempt. */
+    rawText: string, 
+    /** Zod validation error details from the last parse attempt, if available. */
+    validationErrors?: ZodError | undefined);
+}
+/**
+ * Options for a {@link generateObject} call.
+ *
+ * At minimum, `schema` and either `prompt` or `messages` must be supplied.
+ * Provider/model resolution follows the same rules as {@link generateText}.
+ *
+ * @typeParam T - The Zod schema type that defines the expected output shape.
+ *
+ * @example
+ * ```ts
+ * const opts: GenerateObjectOptions<typeof mySchema> = {
+ *   schema: z.object({ name: z.string(), age: z.number() }),
+ *   prompt: 'Extract: "John is 30 years old"',
+ * };
+ * ```
+ */
+export interface GenerateObjectOptions<T extends ZodType> {
+    /**
+     * Provider name. When supplied without `model`, the default text model for
+     * the provider is resolved automatically.
+     *
+     * @example `"openai"`, `"anthropic"`, `"ollama"`
+     */
+    provider?: string;
+    /**
+     * Model identifier. Accepts `"provider:model"` or plain model name with `provider`.
+     *
+     * @example `"openai:gpt-4o"`, `"gpt-4o-mini"`
+     */
+    model?: string;
+    /** Zod schema defining the expected output shape. */
+    schema: T;
+    /**
+     * Human-readable name for the schema, injected into the system prompt to
+     * give the model context about what it is generating.
+     *
+     * @example `"PersonInfo"`
+     */
+    schemaName?: string;
+    /**
+     * Description of the schema, injected into the system prompt alongside
+     * the JSON Schema definition.
+     *
+     * @example `"Information about a person extracted from unstructured text."`
+     */
+    schemaDescription?: string;
+    /** User prompt. Convenience alternative to building a `messages` array. */
+    prompt?: string;
+    /**
+     * System prompt. The schema extraction instructions are appended to this,
+     * so any custom system context is preserved.
+     */
+    system?: string;
+    /** Full conversation history. */
+    messages?: Message[];
+    /** Sampling temperature forwarded to the provider (0-2 for most providers). */
+    temperature?: number;
+    /** Hard cap on output tokens. */
+    maxTokens?: number;
+    /**
+     * Number of times to retry when JSON parsing or Zod validation fails.
+     * Each retry appends the error details to the conversation so the model
+     * can self-correct.
+     *
+     * @default 2
+     */
+    maxRetries?: number;
+    /** Override the API key instead of reading from environment variables. */
+    apiKey?: string;
+    /** Override the provider base URL (useful for local proxies or Ollama). */
+    baseUrl?: string;
+}
+/**
+ * The completed result returned by {@link generateObject}.
+ *
+ * @typeParam T - The inferred type from the Zod schema, representing the validated object.
+ */
+export interface GenerateObjectResult<T> {
+    /** The parsed, Zod-validated object matching the provided schema. */
+    object: T;
+    /** The raw LLM output text before parsing. */
+    text: string;
+    /** Aggregated token usage across all attempts (including retries). */
+    usage: TokenUsage;
+    /**
+     * Reason the model stopped generating on the final successful attempt.
+     * Mirrors the finish reasons from {@link generateText}.
+     */
+    finishReason: string;
+    /** Provider identifier used for the run. */
+    provider: string;
+    /** Resolved model identifier used for the run. */
+    model: string;
+}
+/**
+ * Generates a structured object by forcing the LLM to produce JSON matching
+ * a Zod schema.
+ *
+ * Combines schema-aware prompt engineering with optional provider-native JSON
+ * mode and automatic retry-with-feedback to reliably extract typed data from
+ * unstructured text.
+ *
+ * @typeParam T - The Zod schema type. The returned `object` field is inferred
+ *   as `z.infer<T>`.
+ *
+ * @param opts - Generation options including the Zod schema, prompt/messages,
+ *   and optional provider/model overrides.
+ * @returns A promise resolving to the validated object, raw text, usage, and metadata.
+ *
+ * @throws {ObjectGenerationError} When all retries are exhausted without
+ *   producing valid JSON that passes Zod validation.
+ * @throws {Error} When provider resolution fails (missing API key, unknown provider, etc.).
+ *
+ * @example
+ * ```ts
+ * import { z } from 'zod';
+ * import { generateObject } from '@framers/agentos';
+ *
+ * const { object } = await generateObject({
+ *   model: 'openai:gpt-4o',
+ *   schema: z.object({ name: z.string(), age: z.number() }),
+ *   prompt: 'Extract: "John is 30 years old"',
+ * });
+ *
+ * console.log(object.name); // "John"
+ * console.log(object.age);  // 30
+ * ```
+ *
+ * @see {@link streamObject} for streaming partial objects as they build up.
+ * @see {@link generateText} for plain text generation without schema constraints.
+ */
+export declare function generateObject<T extends ZodType>(opts: GenerateObjectOptions<T>): Promise<GenerateObjectResult<z.infer<T>>>;
+import type { z } from 'zod';
+//# sourceMappingURL=generateObject.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generateObject.d.ts","sourceRoot":"","sources":["../../src/api/generateObject.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAC;AAG7C,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAQ7D;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;IAW5C,6DAA6D;aAC7C,OAAO,EAAE,MAAM;IAC/B,8EAA8E;aAC9D,gBAAgB,CAAC,EAAE,QAAQ;IAb7C,kFAAkF;IAClF,SAAkB,IAAI,2BAA2B;IAEjD;;;;OAIG;gBAED,OAAO,EAAE,MAAM;IACf,6DAA6D;IAC7C,OAAO,EAAE,MAAM;IAC/B,8EAA8E;IAC9D,gBAAgB,CAAC,EAAE,QAAQ,YAAA;CAK9C;AAMD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,qBAAqB,CAAC,CAAC,SAAS,OAAO;IACtD;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,qDAAqD;IACrD,MAAM,EAAE,CAAC,CAAC;IAEV;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IAErB,+EAA+E;IAC/E,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB,CAAC,CAAC;IACrC,qEAAqE;IACrE,MAAM,EAAE,CAAC,CAAC;IAEV,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IAEb,sEAAsE;IACtE,KAAK,EAAE,UAAU,CAAC;IAElB;;;OAGG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IAEjB,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAC;CACf;AAiGD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAsB,cAAc,CAAC,CAAC,SAAS,OAAO,EACpD,IAAI,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAqH3C;AAID,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC"}