@framers/agentos 0.1.126 → 0.1.128

package/dist/api/runtime/processRequestWithExternalTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"processRequestWithExternalTools.js","sourceRoot":"","sources":["../../../src/api/runtime/processRequestWithExternalTools.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,gCAAgC,GAGjC,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAoBlE,KAAK,SAAS,CAAC,CAAC,+BAA+B,CAC7C,OAC8C,EAC9C,MAAsC,EACtC,eAA2C;IAE3C,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QACjC,MAAM,KAAK,CAAC;QAEZ,IAAI,CAAC,gCAAgC,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7C,SAAS;QACX,CAAC;QAED,MAAM,WAAW,GAA6B,EAAE,CAAC;QACjD,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;YACvC,MAAM,SAAS,GAAG,MAAM,eAAe,CAAC;gBACtC,OAAO;gBACP,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,YAAY,EAAE,KAAK;gBACnB,QAAQ;aACT,CAAC,CAAC;YAEH,WAAW,CAAC,IAAI,CAAC;gBACf,UAAU,EAAE,QAAQ,CAAC,EAAE;gBACvB,QAAQ,EAAE,QAAQ,CAAC,IAAI;gBACvB,UAAU,EAAE,SAAS,CAAC,UAAU;gBAChC,SAAS,EAAE,SAAS,CAAC,SAAS,IAAI,IAAI;gBACtC,YAAY,EAAE,SAAS,CAAC,YAAY;aACrC,CAAC,CAAC;QACL,CAAC;QAED,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,CAAC;YACzD,MAAM,IAAI,mBAAmB,CAC3B,4CAA4C,WAAW,CAAC,MAAM,0GAA0G,EACxK,YAAY,CAAC,aAAa,EAC1B;gBACE,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,aAAa,EAAE,KAAK,CAAC,SAAS,CAAC,MAAM;gBACrC,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;oBAC5C,EAAE,EAAE,QAAQ,CAAC,EAAE;oBACf,IAAI,EAAE,QAAQ,CAAC,IAAI;iBACpB,CAAC,CAAC;aACJ,EACD,iCAAiC,CAClC,CAAC;QACJ,CAAC;QAED,KAAK,CAAC,CAAC,+BAA+B,CACpC,OAAO,EACP,WAAW,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,iBAAiB;YACpD,CAAC,CAAC,OAAO,CAAC,gBAAgB,CACtB,KAAK,CAAC,QAAQ,EACd,WAAW,CAAC,CAAC,CAAE,CAAC,UAAU,EAC1B,WAAW,CAAC,CAAC,CAAE,CAAC,QAAQ,EACxB,WAAW,CAAC,CAAC,CAAE,CAAC,UAAU,EAC1B,WAAW,CAAC,CAAC,CAAE,CAAC,SAAS,EACzB,WAAW,CAAC,CAAC,CAAE,CAAC,YAAY,CAC7B;YACH,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAAC,KAAK,CAAC,QAAQ,EAAE,WAAW,CAAC,EAC1D,eAAe,CAChB,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,+BAA+B,CACpD,OAC8C,EAC9C,KAAmB,EACnB,eAA2C;IAE3C,KAAK,CAAC,CAAC,+BAA+B,CACpC,OAAO,EACP,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC,EAC7B,eAAe,CAChB,CAAC;AACJ,CAAC"}

package/dist/api/runtime/processRequestWithRegisteredTools.d.ts

@@ -0,0 +1,56 @@
+import type { UserContext } from '../../cognitive_substrate/IGMI';
+import type { ToolExecutionContext } from '../../core/tools/ITool';
+import type { IAgentOS } from '../interfaces/IAgentOS';
+import type { AgentOSInput } from '../types/AgentOSInput';
+import { type ExternalToolRegistry } from './externalToolRegistry';
+import { type AgentOSExternalToolHandler, type AgentOSExternalToolHandlerContext } from './processRequestWithExternalTools';
+import type { AgentOSResponse } from '../types/AgentOSResponse';
+export interface RegisteredExternalToolExecutionOptions {
+    /**
+     * Optional additional user-context fields to merge into the live tool
+     * execution context. `input.userId` always wins.
+     */
+    userContext?: Partial<UserContext>;
+    /**
+     * Trusted runtime-only organization context to propagate into both
+     * `userContext.organizationId` and `sessionData.organizationId`.
+     */
+    organizationId?: string;
+    /**
+     * Optional correlation ID override. Defaults to the tool call ID.
+     */
+    correlationId?: string;
+    /**
+     * Optional fallback for actionable external tool calls that are not
+     * registered in AgentOS. Use this when the same turn can mix
+     * AgentOS-registered tools with custom host-managed tools.
+     */
+    fallbackExternalToolHandler?: AgentOSExternalToolHandler;
+    /**
+     * Optional map, array, or iterable of host-managed external tools to use
+     * when a tool name is not registered in AgentOS itself.
+     */
+    externalTools?: ExternalToolRegistry;
+}
+type RegisteredToolRuntime = Pick<IAgentOS, 'processRequest' | 'handleToolResult' | 'getToolOrchestrator'> & Partial<Pick<IAgentOS, 'getExternalToolRegistry' | 'handleToolResults'>>;
+/**
+ * Builds the `ToolExecutionContext` for a host-managed external tool call that
+ * should execute against AgentOS's registered tool registry during a live
+ * `processRequest(...)` stream.
+ */
+export declare function buildRegisteredExternalToolExecutionContext(input: AgentOSInput, context: Pick<AgentOSExternalToolHandlerContext, 'requestChunk' | 'toolCall'>, options?: RegisteredExternalToolExecutionOptions): ToolExecutionContext;
+/**
+ * Creates an external-tool handler that executes AgentOS-registered tools with
+ * the correct live-turn execution context, then optionally falls back to a
+ * host-provided external tool registry or dynamic callback.
+ */
+export declare function createRegisteredExternalToolHandler(agentos: Pick<IAgentOS, 'getToolOrchestrator'> & Partial<Pick<IAgentOS, 'getExternalToolRegistry'>>, input: AgentOSInput, options?: RegisteredExternalToolExecutionOptions): AgentOSExternalToolHandler;
+/**
+ * Runs a full `AgentOS.processRequest(...)` turn and executes any actionable
+ * external tool pauses against AgentOS's registered tools automatically.
+ * Missing tool names can optionally fall back to `externalTools` or
+ * `fallbackExternalToolHandler`.
+ */
+export declare function processRequestWithRegisteredTools(agentos: RegisteredToolRuntime, input: AgentOSInput, options?: RegisteredExternalToolExecutionOptions): AsyncGenerator<AgentOSResponse, void, undefined>;
+export {};
+//# sourceMappingURL=processRequestWithRegisteredTools.d.ts.map

package/dist/api/runtime/processRequestWithRegisteredTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"processRequestWithRegisteredTools.d.ts","sourceRoot":"","sources":["../../../src/api/runtime/processRequestWithRegisteredTools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAG1D,OAAO,EAIL,KAAK,oBAAoB,EAC1B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAEL,KAAK,0BAA0B,EAC/B,KAAK,iCAAiC,EACvC,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAWhE,MAAM,WAAW,sCAAsC;IACrD;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IACnC;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,2BAA2B,CAAC,EAAE,0BAA0B,CAAC;IACzD;;;OAGG;IACH,aAAa,CAAC,EAAE,oBAAoB,CAAC;CACtC;AAED,KAAK,qBAAqB,GAAG,IAAI,CAC/B,QAAQ,EACR,gBAAgB,GAAG,kBAAkB,GAAG,qBAAqB,CAC9D,GACC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,yBAAyB,GAAG,mBAAmB,CAAC,CAAC,CAAC;AAS3E;;;;GAIG;AACH,wBAAgB,2CAA2C,CACzD,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,IAAI,CAAC,iCAAiC,EAAE,cAAc,GAAG,UAAU,CAAC,EAC7E,OAAO,GAAE,sCAA2C,GACnD,oBAAoB,CA2CtB;AAED;;;;GAIG;AACH,wBAAgB,mCAAmC,CACjD,OAAO,EAAE,IAAI,CAAC,QAAQ,EAAE,qBAAqB,CAAC,GAC5C,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,yBAAyB,CAAC,CAAC,EACpD,KAAK,EAAE,YAAY,EACnB,OAAO,GAAE,sCAA2C,GACnD,0BAA0B,CA4E5B;AAED;;;;;GAKG;AACH,wBAAuB,iCAAiC,CACtD,OAAO,EAAE,qBAAqB,EAC9B,KAAK,EAAE,YAAY,EACnB,OAAO,GAAE,sCAA2C,GACnD,cAAc,CAAC,eAAe,EAAE,IAAI,EAAE,SAAS,CAAC,CAmBlD"}

package/dist/api/runtime/processRequestWithRegisteredTools.js

@@ -0,0 +1,125 @@
+import { AgentOSServiceError } from '../errors.js';
+import { GMIErrorCode } from '../../core/utils/errors.js';
+import { executeExternalToolFromRegistry, mergeExternalToolRegistries, registerTemporaryExternalTools, } from './externalToolRegistry.js';
+import { processRequestWithExternalTools, } from './processRequestWithExternalTools.js';
+function normalizeOptionalString(value) {
+    if (typeof value !== 'string') {
+        return undefined;
+    }
+    const trimmed = value.trim();
+    return trimmed || undefined;
+}
+function resolveExternalToolsForRuntime(agentos, registry) {
+    return mergeExternalToolRegistries(agentos.getExternalToolRegistry?.(), registry);
+}
+/**
+ * Builds the `ToolExecutionContext` for a host-managed external tool call that
+ * should execute against AgentOS's registered tool registry during a live
+ * `processRequest(...)` stream.
+ */
+export function buildRegisteredExternalToolExecutionContext(input, context, options = {}) {
+    const userContext = {
+        ...(options.userContext ?? {}),
+        userId: input.userId,
+    };
+    const organizationId = normalizeOptionalString(options.organizationId ??
+        context.requestChunk.metadata?.organizationId ??
+        input.organizationId ??
+        userContext.organizationId);
+    if (organizationId) {
+        userContext.organizationId = organizationId;
+    }
+    const sessionId = normalizeOptionalString(context.requestChunk.metadata?.sessionId) ??
+        normalizeOptionalString(input.sessionId) ??
+        undefined;
+    const conversationId = normalizeOptionalString(context.requestChunk.metadata?.conversationId) ??
+        normalizeOptionalString(input.conversationId) ??
+        sessionId;
+    const sessionData = {};
+    if (sessionId) {
+        sessionData.sessionId = sessionId;
+    }
+    if (conversationId) {
+        sessionData.conversationId = conversationId;
+    }
+    if (organizationId) {
+        sessionData.organizationId = organizationId;
+    }
+    return {
+        gmiId: context.requestChunk.gmiInstanceId,
+        personaId: context.requestChunk.personaId,
+        userContext,
+        correlationId: normalizeOptionalString(options.correlationId) ?? context.toolCall.id,
+        ...(Object.keys(sessionData).length > 0 ? { sessionData } : {}),
+    };
+}
+/**
+ * Creates an external-tool handler that executes AgentOS-registered tools with
+ * the correct live-turn execution context, then optionally falls back to a
+ * host-provided external tool registry or dynamic callback.
+ */
+export function createRegisteredExternalToolHandler(agentos, input, options = {}) {
+    const externalTools = resolveExternalToolsForRuntime(agentos, options.externalTools);
+    return async ({ agentos: runtime, streamId, requestChunk, toolCall }) => {
+        const tool = await agentos.getToolOrchestrator().getTool(toolCall.name);
+        if (!tool) {
+            const executionContext = buildRegisteredExternalToolExecutionContext(input, { requestChunk, toolCall }, options);
+            const registryExecution = await executeExternalToolFromRegistry(externalTools, toolCall.name, toolCall.arguments, executionContext, {
+                errorOrigin: 'createRegisteredExternalToolHandler',
+                failureMessage: `Failed to execute external tool '${toolCall.name}' from externalTools registry`,
+            });
+            if (registryExecution) {
+                return registryExecution;
+            }
+            if (options.fallbackExternalToolHandler) {
+                try {
+                    return await options.fallbackExternalToolHandler({
+                        agentos: runtime,
+                        streamId,
+                        requestChunk,
+                        toolCall,
+                    });
+                }
+                catch (error) {
+                    throw AgentOSServiceError.wrap(error, GMIErrorCode.TOOL_ERROR, `Failed to execute fallback external tool '${toolCall.name}'`, 'createRegisteredExternalToolHandler');
+                }
+            }
+            throw new AgentOSServiceError(`Registered external tool '${toolCall.name}' is not available.`, GMIErrorCode.RESOURCE_NOT_FOUND, {
+                streamId: requestChunk.streamId,
+                toolCallId: toolCall.id,
+                toolName: toolCall.name,
+            }, 'createRegisteredExternalToolHandler');
+        }
+        try {
+            const execution = await tool.execute(toolCall.arguments, buildRegisteredExternalToolExecutionContext(input, { requestChunk, toolCall }, options));
+            return {
+                toolOutput: execution.output,
+                isSuccess: execution.success,
+                errorMessage: execution.error,
+            };
+        }
+        catch (error) {
+            throw AgentOSServiceError.wrap(error, GMIErrorCode.TOOL_ERROR, `Failed to execute registered external tool '${toolCall.name}'`, 'createRegisteredExternalToolHandler');
+        }
+    };
+}
+/**
+ * Runs a full `AgentOS.processRequest(...)` turn and executes any actionable
+ * external tool pauses against AgentOS's registered tools automatically.
+ * Missing tool names can optionally fall back to `externalTools` or
+ * `fallbackExternalToolHandler`.
+ */
+export async function* processRequestWithRegisteredTools(agentos, input, options = {}) {
+    const externalTools = resolveExternalToolsForRuntime(agentos, options.externalTools);
+    const cleanup = await registerTemporaryExternalTools(agentos.getToolOrchestrator(), externalTools);
+    try {
+        yield* processRequestWithExternalTools(agentos, input, createRegisteredExternalToolHandler(agentos, input, {
+            ...options,
+            externalTools,
+        }));
+    }
+    finally {
+        await cleanup();
+    }
+}
+//# sourceMappingURL=processRequestWithRegisteredTools.js.map

package/dist/api/runtime/processRequestWithRegisteredTools.js.map

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

package/dist/api/runtime/provider-defaults.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @file provider-defaults.ts
+ * Default model mappings for each supported provider.
+ *
+ * When a user specifies `provider: 'openai'` without an explicit `model`,
+ * the system looks up the default model for the requested task type here.
+ */
+/**
+ * Default model identifiers for a given provider, keyed by task type.
+ * Only fields relevant to the provider need to be populated.
+ */
+export interface ProviderDefaults {
+    /** Default model for generateText / streamText */
+    text?: string;
+    /** Default model for generateImage */
+    image?: string;
+    /** Default embedding model */
+    embedding?: string;
+    /** Cheapest model for internal/discovery use */
+    cheap?: string;
+}
+/** Task keys supported by the default-model registry. */
+export type ProviderDefaultTask = 'text' | 'image' | 'embedding';
+/**
+ * Registry of default models per provider, keyed by provider identifier.
+ *
+ * These defaults are used when a caller specifies `provider: 'openai'` without
+ * an explicit `model` field.  The task type (`'text'`, `'image'`, `'embedding'`)
+ * selects which sub-key to read.
+ */
+export declare const PROVIDER_DEFAULTS: Record<string, ProviderDefaults>;
+/**
+ * Auto-detects the active provider by scanning well-known environment variables
+ * and CLI binaries in priority order.
+ *
+ * Returns the identifier of the first provider whose key/URL env var is non-empty
+ * or whose CLI binary is on PATH, or `undefined` when no recognisable runtime is present.
+ *
+ * Priority: openrouter → openai → anthropic → gemini → claude-code-cli → gemini-cli → ollama → …
+ */
+export declare function autoDetectProvider(task?: ProviderDefaultTask): string | undefined;
+//# sourceMappingURL=provider-defaults.d.ts.map

package/dist/api/runtime/provider-defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-defaults.d.ts","sourceRoot":"","sources":["../../../src/api/runtime/provider-defaults.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,kDAAkD;IAClD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,yDAAyD;AACzD,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,OAAO,GAAG,WAAW,CAAC;AAEjE;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAgE9D,CAAC;AAgCF;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,CAAC,EAAE,mBAAmB,GAAG,MAAM,GAAG,SAAS,CAYjF"}

package/dist/api/runtime/provider-defaults.js

@@ -0,0 +1,127 @@
+/**
+ * @file provider-defaults.ts
+ * Default model mappings for each supported provider.
+ *
+ * When a user specifies `provider: 'openai'` without an explicit `model`,
+ * the system looks up the default model for the requested task type here.
+ */
+import { spawnSync } from 'node:child_process';
+/**
+ * Registry of default models per provider, keyed by provider identifier.
+ *
+ * These defaults are used when a caller specifies `provider: 'openai'` without
+ * an explicit `model` field.  The task type (`'text'`, `'image'`, `'embedding'`)
+ * selects which sub-key to read.
+ */
+export const PROVIDER_DEFAULTS = {
+    openai: {
+        text: 'gpt-4o',
+        image: 'gpt-image-1',
+        embedding: 'text-embedding-3-small',
+        cheap: 'gpt-4o-mini',
+    },
+    anthropic: {
+        text: 'claude-sonnet-4-20250514',
+        cheap: 'claude-haiku-4-5-20251001',
+    },
+    ollama: {
+        text: 'llama3.2',
+        image: 'stable-diffusion',
+        embedding: 'nomic-embed-text',
+        cheap: 'llama3.2',
+    },
+    openrouter: {
+        text: 'openai/gpt-4o',
+        cheap: 'openai/gpt-4o-mini',
+    },
+    gemini: {
+        text: 'gemini-2.5-flash',
+        cheap: 'gemini-2.0-flash',
+    },
+    'claude-code-cli': {
+        text: 'claude-sonnet-4-20250514',
+        cheap: 'claude-haiku-4-5-20251001',
+    },
+    'gemini-cli': {
+        text: 'gemini-2.5-flash',
+        cheap: 'gemini-2.0-flash-lite',
+    },
+    stability: {
+        image: 'stable-diffusion-xl-1024-v1-0',
+    },
+    replicate: {
+        image: 'black-forest-labs/flux-1.1-pro',
+    },
+    'stable-diffusion-local': {
+        image: 'v1-5-pruned-emaonly',
+    },
+    bfl: {
+        image: 'flux-pro-1.1',
+    },
+    fal: {
+        image: 'fal-ai/flux/dev',
+    },
+    groq: {
+        text: 'llama-3.3-70b-versatile',
+        cheap: 'gemma2-9b-it',
+    },
+    together: {
+        text: 'meta-llama/Meta-Llama-3.1-70B-Instruct-Turbo',
+        cheap: 'meta-llama/Meta-Llama-3.1-8B-Instruct-Turbo',
+    },
+    mistral: {
+        text: 'mistral-large-latest',
+        cheap: 'mistral-small-latest',
+    },
+    xai: {
+        text: 'grok-2',
+        cheap: 'grok-2-mini',
+    },
+};
+const AUTO_DETECT_ORDER = [
+    { envKey: 'OPENROUTER_API_KEY', provider: 'openrouter' },
+    { envKey: 'OPENAI_API_KEY', provider: 'openai' },
+    { envKey: 'ANTHROPIC_API_KEY', provider: 'anthropic' },
+    { envKey: 'GEMINI_API_KEY', provider: 'gemini' },
+    { envKey: 'GROQ_API_KEY', provider: 'groq' },
+    { envKey: 'TOGETHER_API_KEY', provider: 'together' },
+    { envKey: 'MISTRAL_API_KEY', provider: 'mistral' },
+    { envKey: 'XAI_API_KEY', provider: 'xai' },
+    { binaryName: 'claude', provider: 'claude-code-cli' },
+    { binaryName: 'gemini', provider: 'gemini-cli' },
+    { envKey: 'OLLAMA_BASE_URL', provider: 'ollama' },
+    { envKey: 'STABILITY_API_KEY', provider: 'stability' },
+    { envKey: 'REPLICATE_API_TOKEN', provider: 'replicate' },
+    { envKey: 'STABLE_DIFFUSION_LOCAL_BASE_URL', provider: 'stable-diffusion-local' },
+    { envKey: 'BFL_API_KEY', provider: 'bfl' },
+    { envKey: 'FAL_API_KEY', provider: 'fal' },
+];
+function isBinaryOnPath(binaryName) {
+    const lookupCommand = process.platform === 'win32' ? 'where' : 'which';
+    const result = spawnSync(lookupCommand, [binaryName], { stdio: 'ignore' });
+    return result.status === 0;
+}
+/**
+ * Auto-detects the active provider by scanning well-known environment variables
+ * and CLI binaries in priority order.
+ *
+ * Returns the identifier of the first provider whose key/URL env var is non-empty
+ * or whose CLI binary is on PATH, or `undefined` when no recognisable runtime is present.
+ *
+ * Priority: openrouter → openai → anthropic → gemini → claude-code-cli → gemini-cli → ollama → …
+ */
+export function autoDetectProvider(task) {
+    for (const probe of AUTO_DETECT_ORDER) {
+        const available = 'envKey' in probe
+            ? Boolean(process.env[probe.envKey])
+            : isBinaryOnPath(probe.binaryName);
+        if (!available)
+            continue;
+        const { provider } = probe;
+        if (task && !PROVIDER_DEFAULTS[provider]?.[task])
+            continue;
+        return provider;
+    }
+    return undefined;
+}
+//# sourceMappingURL=provider-defaults.js.map

package/dist/api/runtime/provider-defaults.js.map

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

package/dist/api/runtime/resumeExternalToolRequestWithRegisteredTools.d.ts

@@ -0,0 +1,71 @@
+import type { UserContext, ToolCallRequest } from '../../cognitive_substrate/IGMI';
+import type { ToolExecutionContext } from '../../core/tools/ITool';
+import type { IAgentOS } from '../interfaces/IAgentOS';
+import type { AgentOSPendingExternalToolRequest, AgentOSResumeExternalToolRequestOptions } from '../types/AgentOSExternalToolRequest';
+import type { AgentOSResponse } from '../types/AgentOSResponse';
+import type { AgentOSToolResultInput } from '../types/AgentOSToolResult';
+import { type ExternalToolRegistry } from './externalToolRegistry';
+import type { AgentOSExternalToolHandlerResult } from './processRequestWithExternalTools';
+export interface PendingExternalToolExecutionOptions {
+    /**
+     * Optional additional user-context fields to merge into the execution
+     * context. `pendingRequest.userId` always wins.
+     */
+    userContext?: Partial<UserContext>;
+    /**
+     * Trusted runtime-only organization context to propagate into both
+     * `userContext.organizationId` and `sessionData.organizationId`.
+     */
+    organizationId?: string;
+    /**
+     * Optional correlation ID for tool execution tracing. Defaults to the pending
+     * stream ID when omitted.
+     */
+    correlationId?: string;
+    /**
+     * Optional fallback for pending external tool calls that are not registered
+     * in AgentOS. Use this when the same persisted pause can mix AgentOS-
+     * registered tools with custom host-managed tools.
+     */
+    fallbackExternalToolHandler?: PendingExternalToolHandler;
+    /**
+     * Optional map, array, or iterable of host-managed external tools to use
+     * when a tool name is not registered in AgentOS itself.
+     */
+    externalTools?: ExternalToolRegistry;
+}
+export interface ResumeExternalToolRequestWithRegisteredToolsOptions extends PendingExternalToolExecutionOptions, AgentOSResumeExternalToolRequestOptions {
+}
+type RegisteredToolExecutionRuntime = Pick<IAgentOS, 'getToolOrchestrator' | 'resumeExternalToolRequest'> & Partial<Pick<IAgentOS, 'getExternalToolRegistry'>>;
+export interface PendingExternalToolHandlerContext {
+    agentos: Pick<IAgentOS, 'getToolOrchestrator'>;
+    pendingRequest: AgentOSPendingExternalToolRequest;
+    toolCall: ToolCallRequest;
+}
+export type PendingExternalToolHandler = (context: PendingExternalToolHandlerContext) => Promise<AgentOSExternalToolHandlerResult>;
+/**
+ * Builds the `ToolExecutionContext` that a host should use when it wants to
+ * execute a persisted external tool pause against AgentOS's registered tool
+ * registry after restart.
+ */
+export declare function buildPendingExternalToolExecutionContext(pendingRequest: AgentOSPendingExternalToolRequest, options?: PendingExternalToolExecutionOptions): ToolExecutionContext;
+/**
+ * Executes one pending external tool call through AgentOS's registered tool
+ * registry using the correct resume-time execution context, then optionally
+ * falls back to a host-provided external tool registry or dynamic callback.
+ */
+export declare function executePendingExternalToolCall(agentos: Pick<IAgentOS, 'getToolOrchestrator'> & Partial<Pick<IAgentOS, 'getExternalToolRegistry'>>, pendingRequest: AgentOSPendingExternalToolRequest, toolCall: ToolCallRequest, options?: PendingExternalToolExecutionOptions): Promise<AgentOSToolResultInput>;
+/**
+ * Executes all tool calls from a persisted external-tool pause, in order,
+ * through AgentOS's registered tool registry.
+ */
+export declare function executePendingExternalToolCalls(agentos: Pick<IAgentOS, 'getToolOrchestrator'> & Partial<Pick<IAgentOS, 'getExternalToolRegistry'>>, pendingRequest: AgentOSPendingExternalToolRequest, options?: PendingExternalToolExecutionOptions): Promise<AgentOSToolResultInput[]>;
+/**
+ * Executes all pending registered tool calls from a persisted external-tool
+ * pause and immediately resumes the AgentOS stream on the caller's behalf.
+ * Missing tool names can optionally fall back to `externalTools` or
+ * `fallbackExternalToolHandler`.
+ */
+export declare function resumeExternalToolRequestWithRegisteredTools(agentos: RegisteredToolExecutionRuntime, pendingRequest: AgentOSPendingExternalToolRequest, options?: ResumeExternalToolRequestWithRegisteredToolsOptions): AsyncGenerator<AgentOSResponse, void, undefined>;
+export {};
+//# sourceMappingURL=resumeExternalToolRequestWithRegisteredTools.d.ts.map

package/dist/api/runtime/resumeExternalToolRequestWithRegisteredTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resumeExternalToolRequestWithRegisteredTools.d.ts","sourceRoot":"","sources":["../../../src/api/runtime/resumeExternalToolRequestWithRegisteredTools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACnF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEvD,OAAO,KAAK,EACV,iCAAiC,EACjC,uCAAuC,EACxC,MAAM,qCAAqC,CAAC;AAC7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAEzE,OAAO,EAIL,KAAK,oBAAoB,EAC1B,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,mCAAmC,CAAC;AAgC1F,MAAM,WAAW,mCAAmC;IAClD;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IACnC;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,2BAA2B,CAAC,EAAE,0BAA0B,CAAC;IACzD;;;OAGG;IACH,aAAa,CAAC,EAAE,oBAAoB,CAAC;CACtC;AAED,MAAM,WAAW,mDACf,SAAQ,mCAAmC,EACzC,uCAAuC;CAAG;AAE9C,KAAK,8BAA8B,GAAG,IAAI,CACxC,QAAQ,EACR,qBAAqB,GAAG,2BAA2B,CACpD,GACC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,yBAAyB,CAAC,CAAC,CAAC;AASrD,MAAM,WAAW,iCAAiC;IAChD,OAAO,EAAE,IAAI,CAAC,QAAQ,EAAE,qBAAqB,CAAC,CAAC;IAC/C,cAAc,EAAE,iCAAiC,CAAC;IAClD,QAAQ,EAAE,eAAe,CAAC;CAC3B;AAED,MAAM,MAAM,0BAA0B,GAAG,CACvC,OAAO,EAAE,iCAAiC,KACvC,OAAO,CAAC,gCAAgC,CAAC,CAAC;AAE/C;;;;GAIG;AACH,wBAAgB,wCAAwC,CACtD,cAAc,EAAE,iCAAiC,EACjD,OAAO,GAAE,mCAAwC,GAChD,oBAAoB,CA4BtB;AAED;;;;GAIG;AACH,wBAAsB,8BAA8B,CAClD,OAAO,EAAE,IAAI,CAAC,QAAQ,EAAE,qBAAqB,CAAC,GAC5C,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,yBAAyB,CAAC,CAAC,EACpD,cAAc,EAAE,iCAAiC,EACjD,QAAQ,EAAE,eAAe,EACzB,OAAO,GAAE,mCAAwC,GAChD,OAAO,CAAC,sBAAsB,CAAC,CA2FjC;AAED;;;GAGG;AACH,wBAAsB,+BAA+B,CACnD,OAAO,EAAE,IAAI,CAAC,QAAQ,EAAE,qBAAqB,CAAC,GAC5C,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,yBAAyB,CAAC,CAAC,EACpD,cAAc,EAAE,iCAAiC,EACjD,OAAO,GAAE,mCAAwC,GAChD,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAUnC;AAED;;;;;GAKG;AACH,wBAAuB,4CAA4C,CACjE,OAAO,EAAE,8BAA8B,EACvC,cAAc,EAAE,iCAAiC,EACjD,OAAO,GAAE,mDAAwD,GAChE,cAAc,CAAC,eAAe,EAAE,IAAI,EAAE,SAAS,CAAC,CAoBlD"}

package/dist/api/runtime/resumeExternalToolRequestWithRegisteredTools.js

@@ -0,0 +1,159 @@
+import { AgentOSServiceError } from '../errors.js';
+import { GMIErrorCode } from '../../core/utils/errors.js';
+import { executeExternalToolFromRegistry, mergeExternalToolRegistries, registerTemporaryExternalTools, } from './externalToolRegistry.js';
+function normalizeOptionalString(value) {
+    if (typeof value !== 'string') {
+        return undefined;
+    }
+    const trimmed = value.trim();
+    return trimmed || undefined;
+}
+function buildResumeOptions(options) {
+    const resumeOptions = {};
+    if (options.userApiKeys) {
+        resumeOptions.userApiKeys = options.userApiKeys;
+    }
+    if (options.preferredModelId) {
+        resumeOptions.preferredModelId = options.preferredModelId;
+    }
+    if (options.preferredProviderId) {
+        resumeOptions.preferredProviderId = options.preferredProviderId;
+    }
+    if (options.organizationId) {
+        resumeOptions.organizationId = options.organizationId;
+    }
+    return resumeOptions;
+}
+function resolveExternalToolsForRuntime(agentos, registry) {
+    return mergeExternalToolRegistries(agentos.getExternalToolRegistry?.(), registry);
+}
+/**
+ * Builds the `ToolExecutionContext` that a host should use when it wants to
+ * execute a persisted external tool pause against AgentOS's registered tool
+ * registry after restart.
+ */
+export function buildPendingExternalToolExecutionContext(pendingRequest, options = {}) {
+    const userContext = {
+        ...(options.userContext ?? {}),
+        userId: pendingRequest.userId,
+    };
+    const organizationId = normalizeOptionalString(options.organizationId ?? userContext.organizationId);
+    if (organizationId) {
+        userContext.organizationId = organizationId;
+    }
+    const sessionData = {
+        sessionId: pendingRequest.sessionId,
+        conversationId: pendingRequest.conversationId,
+    };
+    if (organizationId) {
+        sessionData.organizationId = organizationId;
+    }
+    return {
+        gmiId: pendingRequest.gmiInstanceId,
+        personaId: pendingRequest.personaId,
+        userContext,
+        correlationId: normalizeOptionalString(options.correlationId) ?? pendingRequest.streamId,
+        sessionData,
+    };
+}
+/**
+ * Executes one pending external tool call through AgentOS's registered tool
+ * registry using the correct resume-time execution context, then optionally
+ * falls back to a host-provided external tool registry or dynamic callback.
+ */
+export async function executePendingExternalToolCall(agentos, pendingRequest, toolCall, options = {}) {
+    const externalTools = resolveExternalToolsForRuntime(agentos, options.externalTools);
+    const tool = await agentos.getToolOrchestrator().getTool(toolCall.name);
+    if (!tool) {
+        const executionContext = buildPendingExternalToolExecutionContext(pendingRequest, {
+            ...options,
+            correlationId: options.correlationId ?? toolCall.id,
+        });
+        const registryExecution = await executeExternalToolFromRegistry(externalTools, toolCall.name, toolCall.arguments, executionContext, {
+            errorOrigin: 'executePendingExternalToolCall',
+            failureMessage: `Failed to execute external tool '${toolCall.name}' from externalTools registry`,
+        });
+        if (registryExecution) {
+            return {
+                toolCallId: toolCall.id,
+                toolName: toolCall.name,
+                toolOutput: registryExecution.toolOutput,
+                isSuccess: registryExecution.isSuccess ?? true,
+                errorMessage: registryExecution.errorMessage,
+            };
+        }
+        if (options.fallbackExternalToolHandler) {
+            try {
+                const execution = await options.fallbackExternalToolHandler({
+                    agentos,
+                    pendingRequest,
+                    toolCall,
+                });
+                return {
+                    toolCallId: toolCall.id,
+                    toolName: toolCall.name,
+                    toolOutput: execution.toolOutput,
+                    isSuccess: execution.isSuccess ?? true,
+                    errorMessage: execution.errorMessage,
+                };
+            }
+            catch (error) {
+                throw AgentOSServiceError.wrap(error, GMIErrorCode.TOOL_ERROR, `Failed to execute fallback external tool '${toolCall.name}'`, 'executePendingExternalToolCall');
+            }
+        }
+        throw new AgentOSServiceError(`Pending external tool '${toolCall.name}' is not registered.`, GMIErrorCode.RESOURCE_NOT_FOUND, {
+            conversationId: pendingRequest.conversationId,
+            streamId: pendingRequest.streamId,
+            toolCallId: toolCall.id,
+            toolName: toolCall.name,
+        }, 'executePendingExternalToolCall');
+    }
+    try {
+        const execution = await tool.execute(toolCall.arguments, buildPendingExternalToolExecutionContext(pendingRequest, {
+            ...options,
+            correlationId: options.correlationId ?? toolCall.id,
+        }));
+        return {
+            toolCallId: toolCall.id,
+            toolName: toolCall.name,
+            toolOutput: execution.output,
+            isSuccess: execution.success,
+            errorMessage: execution.error,
+        };
+    }
+    catch (error) {
+        throw AgentOSServiceError.wrap(error, GMIErrorCode.TOOL_ERROR, `Failed to execute pending external tool '${toolCall.name}'`, 'executePendingExternalToolCall');
+    }
+}
+/**
+ * Executes all tool calls from a persisted external-tool pause, in order,
+ * through AgentOS's registered tool registry.
+ */
+export async function executePendingExternalToolCalls(agentos, pendingRequest, options = {}) {
+    const toolResults = [];
+    for (const toolCall of pendingRequest.toolCalls) {
+        toolResults.push(await executePendingExternalToolCall(agentos, pendingRequest, toolCall, options));
+    }
+    return toolResults;
+}
+/**
+ * Executes all pending registered tool calls from a persisted external-tool
+ * pause and immediately resumes the AgentOS stream on the caller's behalf.
+ * Missing tool names can optionally fall back to `externalTools` or
+ * `fallbackExternalToolHandler`.
+ */
+export async function* resumeExternalToolRequestWithRegisteredTools(agentos, pendingRequest, options = {}) {
+    const externalTools = resolveExternalToolsForRuntime(agentos, options.externalTools);
+    const toolResults = await executePendingExternalToolCalls(agentos, pendingRequest, {
+        ...options,
+        externalTools,
+    });
+    const cleanup = await registerTemporaryExternalTools(agentos.getToolOrchestrator(), externalTools);
+    try {
+        yield* agentos.resumeExternalToolRequest(pendingRequest, toolResults, buildResumeOptions(options));
+    }
+    finally {
+        await cleanup();
+    }
+}
+//# sourceMappingURL=resumeExternalToolRequestWithRegisteredTools.js.map

package/dist/api/runtime/resumeExternalToolRequestWithRegisteredTools.js.map

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