@framers/agentos 0.1.112 → 0.1.114

package/dist/api/toolAdapter.d.ts

@@ -1,12 +1,14 @@
 /**
  * @file toolAdapter.ts
- * Adapts user-supplied tool definitions (plain objects, Zod schemas, or {@link ITool}
- * instances) into the canonical {@link ITool} shape expected by the AgentOS runtime.
+ * Adapts user-supplied tool definitions (plain objects, Zod schemas, or `ITool`
+ * instances) into the canonical `ITool` shape expected by the AgentOS runtime.
  *
  * This module is used internally by {@link generateText} and {@link streamText} to
  * normalise the `tools` option before handing them to a provider.
  */
 import type { ITool } from '../core/tools/ITool.js';
+import type { ToolDefinitionForLLM } from '../core/tools/IToolOrchestrator.js';
+import type { ExternalToolRegistry } from './externalToolRegistry.js';
 /**
  * Loose tool definition accepted by the high-level API.
  * Consumers may supply a plain object with an optional Zod or JSON Schema
@@ -21,7 +23,7 @@ export interface ToolDefinition {
      * to convert it via `zod-to-json-schema`, falling back to an empty object schema
      * if that package is not installed.
      */
-    parameters?: Record<string, unknown>;
+    parameters?: Record<string, unknown> | object;
     /**
      * Async function that receives the parsed tool arguments and returns any value.
      * Omit to create a no-op tool (returns `{ success: true }`).
@@ -31,17 +33,28 @@ export interface ToolDefinition {
 /** Map of tool name → definition accepted by the high-level API. */
 export type ToolDefinitionMap = Record<string, ToolDefinition | ITool>;
 /**
- * Converts a {@link ToolDefinitionMap} into an array of {@link ITool} instances
+ * Additional tool inputs accepted by the high-level API.
+ *
+ * - `ExternalToolRegistry`: host-managed external tools, including `Map` and iterable forms.
+ * - `ToolDefinitionForLLM[]`: prompt-only schemas with no attached executor.
+ */
+export type AdaptableToolInput = ToolDefinitionMap | ExternalToolRegistry | ReadonlyArray<ToolDefinitionForLLM>;
+/**
+ * Converts supported tool inputs into an array of `ITool` instances
  * suitable for use with the AgentOS provider layer.
  *
- * - Existing {@link ITool} instances (identified by `inputSchema` + `id` properties)
+ * - Existing `ITool` instances (identified by `inputSchema` + `id` properties)
  *   are passed through unchanged.
- * - Plain {@link ToolDefinition} objects are wrapped in a minimal {@link ITool}
+ * - Plain `ToolDefinition` objects are wrapped in a minimal `ITool`
  *   implementation.  Zod schemas are converted to JSON Schema when `zod-to-json-schema`
  *   is available.
+ * - {@link ExternalToolRegistry} inputs are adapted into executable `ITool`
+ *   instances, preserving any prompt metadata they expose.
+ * - `ToolDefinitionForLLM[]` arrays are treated as prompt-only schemas and
+ *   produce tools that fail explicitly when invoked without an executor.
  *
  * @param tools - Optional map of tool names to definitions. Returns `[]` when falsy.
- * @returns Flat array of normalised {@link ITool} instances ready for provider dispatch.
+ * @returns Flat array of normalised `ITool` instances ready for provider dispatch.
  *
  * @example
  * ```ts
@@ -54,5 +67,28 @@ export type ToolDefinitionMap = Record<string, ToolDefinition | ITool>;
  * });
  * ```
  */
-export declare function adaptTools(tools: ToolDefinitionMap | undefined): ITool[];
+export declare function adaptTools(tools: AdaptableToolInput | undefined): ITool[];
+/**
+ * Converts any supported tool input into a named tool map.
+ *
+ * Later helpers such as `agent()` / `agency()` use this to safely merge tool
+ * inputs that may arrive as records, `Map` registries, or prompt-only schemas.
+ * The returned map always contains executable `ITool` instances keyed by
+ * tool name.
+ *
+ * @param tools - Optional high-level tool input.
+ * @returns A name-keyed tool map. Returns `{}` when no tools are supplied.
+ */
+export declare function adaptToolsToMap(tools: AdaptableToolInput | undefined): ToolDefinitionMap;
+/**
+ * Merges supported tool inputs with later inputs taking precedence by tool name.
+ *
+ * This normalizes each input first, which means agency-level defaults can be
+ * combined safely with per-agent maps, external registries, or prompt-only tool
+ * schemas without relying on object spread semantics.
+ *
+ * @param inputs - Tool inputs ordered from lowest to highest precedence.
+ * @returns A merged tool map, or `undefined` when no tools were supplied.
+ */
+export declare function mergeAdaptableTools(...inputs: Array<AdaptableToolInput | undefined>): ToolDefinitionMap | undefined;
 //# sourceMappingURL=toolAdapter.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"toolAdapter.d.ts","sourceRoot":"","sources":["../../src/api/toolAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,KAAK,EAA+D,MAAM,wBAAwB,CAAC;AAEjH;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;CACvC;AAED,oEAAoE;AACpE,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,KAAK,CAAC,CAAC;AAEvE;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,iBAAiB,GAAG,SAAS,GAAG,KAAK,EAAE,CAiDxE"}
+{"version":3,"file":"toolAdapter.d.ts","sourceRoot":"","sources":["../../src/api/toolAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EACV,KAAK,EAIN,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEtE;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC;IAC9C;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;CACvC;AAED,oEAAoE;AACpE,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,KAAK,CAAC,CAAC;AAEvE;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAC1B,iBAAiB,GACjB,oBAAoB,GACpB,aAAa,CAAC,oBAAoB,CAAC,CAAC;AAsNxC;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,kBAAkB,GAAG,SAAS,GAAG,KAAK,EAAE,CAyBzE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,kBAAkB,GAAG,SAAS,GAAG,iBAAiB,CAQxF;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,MAAM,EAAE,KAAK,CAAC,kBAAkB,GAAG,SAAS,CAAC,GAC/C,iBAAiB,GAAG,SAAS,CAQ/B"}

package/dist/api/toolAdapter.js

@@ -1,15 +1,184 @@
+function defaultObjectSchema() {
+    return { type: 'object', properties: {} };
+}
+function humanizeToolName(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 isIterableInput(value) {
+    return (value !== null &&
+        value !== undefined &&
+        typeof value !== 'string' &&
+        !Array.isArray(value) &&
+        typeof value[Symbol.iterator] === 'function');
+}
+function isITool(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        'id' in value &&
+        'inputSchema' in value &&
+        typeof value.execute === 'function');
+}
+function isToolDefinitionForLLM(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        typeof value.name === 'string' &&
+        typeof value.description === 'string' &&
+        typeof value.inputSchema === 'object' &&
+        value.inputSchema !== null &&
+        !('execute' in value));
+}
+function isNamedExternalToolEntry(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        typeof value.name === 'string' &&
+        ('execute' in value ||
+            'inputSchema' in value ||
+            'description' in value ||
+            'displayName' in value));
+}
+function isExternalRegistryObjectEntry(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        typeof value.execute === 'function' &&
+        !('parameters' in value));
+}
+function normalizeExecutionResult(output) {
+    if (typeof output === 'object' &&
+        output !== null &&
+        'success' in output &&
+        typeof output.success === 'boolean') {
+        return output;
+    }
+    return {
+        success: true,
+        output,
+    };
+}
+function createPromptOnlyTool(definition) {
+    return {
+        id: `${definition.name}-prompt-only-v1`,
+        name: definition.name,
+        displayName: humanizeToolName(definition.name),
+        description: definition.description,
+        inputSchema: definition.inputSchema,
+        outputSchema: definition.outputSchema,
+        hasSideEffects: false,
+        async execute() {
+            return {
+                success: false,
+                error: `No executor configured for prompt-only tool "${definition.name}".`,
+            };
+        },
+    };
+}
+function createToolFromDefinition(name, def) {
+    let schema;
+    if (def.parameters && '_def' in def.parameters) {
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-require-imports
+            const { zodToJsonSchema } = require('zod-to-json-schema');
+            schema = zodToJsonSchema(def.parameters);
+        }
+        catch {
+            schema = defaultObjectSchema();
+        }
+    }
+    else {
+        schema = (def.parameters ?? defaultObjectSchema());
+    }
+    const executeFn = def.execute ?? (async () => ({ success: true }));
+    return {
+        id: `${name}-v1`,
+        name,
+        displayName: humanizeToolName(name),
+        description: def.description ?? '',
+        inputSchema: schema,
+        hasSideEffects: false,
+        async execute(args, _ctx) {
+            try {
+                return normalizeExecutionResult(await executeFn(args));
+            }
+            catch (err) {
+                return { success: false, error: err?.message ?? String(err) };
+            }
+        },
+    };
+}
+function createToolFromExternalEntry(name, entry) {
+    const displayName = entry.displayName ?? humanizeToolName(name);
+    const description = typeof entry.description === 'string' && entry.description.trim().length > 0
+        ? entry.description
+        : displayName;
+    const executeFn = typeof entry.execute === 'function'
+        ? entry.execute
+        : async () => ({
+            success: false,
+            error: `No executor configured for external tool "${name}".`,
+        });
+    return {
+        id: `${name}-external-v1`,
+        name,
+        displayName,
+        description,
+        inputSchema: entry.inputSchema ?? defaultObjectSchema(),
+        outputSchema: entry.outputSchema,
+        requiredCapabilities: entry.requiredCapabilities,
+        category: entry.category,
+        version: entry.version,
+        hasSideEffects: entry.hasSideEffects ?? false,
+        async execute(args, context) {
+            try {
+                return normalizeExecutionResult(await executeFn(args, context));
+            }
+            catch (err) {
+                return { success: false, error: err?.message ?? String(err) };
+            }
+        },
+    };
+}
+function adaptNamedEntries(entries) {
+    const result = [];
+    for (const [name, def] of entries) {
+        if (isITool(def)) {
+            result.push(def);
+            continue;
+        }
+        if (typeof def === 'function') {
+            result.push(createToolFromExternalEntry(name, {
+                name,
+                execute: def,
+            }));
+            continue;
+        }
+        if (isExternalRegistryObjectEntry(def)) {
+            result.push(createToolFromExternalEntry(name, def));
+            continue;
+        }
+        result.push(createToolFromDefinition(name, def));
+    }
+    return result;
+}
 /**
- * Converts a {@link ToolDefinitionMap} into an array of {@link ITool} instances
+ * Converts supported tool inputs into an array of `ITool` instances
  * suitable for use with the AgentOS provider layer.
  *
- * - Existing {@link ITool} instances (identified by `inputSchema` + `id` properties)
+ * - Existing `ITool` instances (identified by `inputSchema` + `id` properties)
  *   are passed through unchanged.
- * - Plain {@link ToolDefinition} objects are wrapped in a minimal {@link ITool}
+ * - Plain `ToolDefinition` objects are wrapped in a minimal `ITool`
  *   implementation.  Zod schemas are converted to JSON Schema when `zod-to-json-schema`
  *   is available.
+ * - {@link ExternalToolRegistry} inputs are adapted into executable `ITool`
+ *   instances, preserving any prompt metadata they expose.
+ * - `ToolDefinitionForLLM[]` arrays are treated as prompt-only schemas and
+ *   produce tools that fail explicitly when invoked without an executor.
  *
  * @param tools - Optional map of tool names to definitions. Returns `[]` when falsy.
- * @returns Flat array of normalised {@link ITool} instances ready for provider dispatch.
+ * @returns Flat array of normalised `ITool` instances ready for provider dispatch.
  *
  * @example
  * ```ts
@@ -25,49 +194,59 @@
 export function adaptTools(tools) {
     if (!tools)
         return [];
-    const result = [];
-    for (const [name, def] of Object.entries(tools)) {
-        // ITool pass-through (has inputSchema + execute as ITool signature)
-        if ('inputSchema' in def && 'id' in def) {
-            result.push(def);
-            continue;
+    if (Array.isArray(tools)) {
+        if (tools.every(isToolDefinitionForLLM)) {
+            return tools.map((definition) => createPromptOnlyTool(definition));
         }
-        const td = def;
-        let schema;
-        if (td.parameters && '_def' in td.parameters) {
-            // Zod schema — convert to JSON Schema
-            try {
-                // eslint-disable-next-line @typescript-eslint/no-require-imports
-                const { zodToJsonSchema } = require('zod-to-json-schema');
-                schema = zodToJsonSchema(td.parameters);
-            }
-            catch {
-                // zod-to-json-schema not installed — use basic extraction
-                schema = { type: 'object', properties: {} };
-            }
+        if (tools.every(isNamedExternalToolEntry)) {
+            return adaptNamedEntries(tools.map((entry) => [entry.name, entry]));
         }
-        else {
-            schema = (td.parameters ?? { type: 'object', properties: {} });
-        }
-        const executeFn = td.execute ?? (async () => ({ success: true }));
-        result.push({
-            id: `${name}-v1`,
-            name,
-            displayName: name.replace(/([A-Z])/g, ' $1').replace(/^./, s => s.toUpperCase()).trim(),
-            description: td.description ?? '',
-            inputSchema: schema,
-            hasSideEffects: false,
-            async execute(args, _ctx) {
-                try {
-                    const output = await executeFn(args);
-                    return { success: true, output };
-                }
-                catch (err) {
-                    return { success: false, error: err?.message ?? String(err) };
-                }
-            },
-        });
+        return [];
     }
-    return result;
+    if (tools instanceof Map) {
+        return adaptNamedEntries(tools.entries());
+    }
+    if (isIterableInput(tools)) {
+        const namedEntries = Array.from(tools).filter(isNamedExternalToolEntry);
+        return adaptNamedEntries(namedEntries.map((entry) => [entry.name, entry]));
+    }
+    return adaptNamedEntries(Object.entries(tools));
+}
+/**
+ * Converts any supported tool input into a named tool map.
+ *
+ * Later helpers such as `agent()` / `agency()` use this to safely merge tool
+ * inputs that may arrive as records, `Map` registries, or prompt-only schemas.
+ * The returned map always contains executable `ITool` instances keyed by
+ * tool name.
+ *
+ * @param tools - Optional high-level tool input.
+ * @returns A name-keyed tool map. Returns `{}` when no tools are supplied.
+ */
+export function adaptToolsToMap(tools) {
+    if (!tools)
+        return {};
+    const map = {};
+    for (const tool of adaptTools(tools)) {
+        map[tool.name] = tool;
+    }
+    return map;
+}
+/**
+ * Merges supported tool inputs with later inputs taking precedence by tool name.
+ *
+ * This normalizes each input first, which means agency-level defaults can be
+ * combined safely with per-agent maps, external registries, or prompt-only tool
+ * schemas without relying on object spread semantics.
+ *
+ * @param inputs - Tool inputs ordered from lowest to highest precedence.
+ * @returns A merged tool map, or `undefined` when no tools were supplied.
+ */
+export function mergeAdaptableTools(...inputs) {
+    const merged = {};
+    for (const input of inputs) {
+        Object.assign(merged, adaptToolsToMap(input));
+    }
+    return Object.keys(merged).length > 0 ? merged : undefined;
 }
 //# sourceMappingURL=toolAdapter.js.map

package/dist/api/toolAdapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"toolAdapter.js","sourceRoot":"","sources":["../../src/api/toolAdapter.ts"],"names":[],"mappings":"AAmCA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,UAAU,CAAC,KAAoC;IAC7D,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,MAAM,MAAM,GAAY,EAAE,CAAC;IAE3B,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAChD,oEAAoE;QACpE,IAAI,aAAa,IAAI,GAAG,IAAI,IAAI,IAAI,GAAG,EAAE,CAAC;YACxC,MAAM,CAAC,IAAI,CAAC,GAAY,CAAC,CAAC;YAC1B,SAAS;QACX,CAAC;QAED,MAAM,EAAE,GAAG,GAAqB,CAAC;QACjC,IAAI,MAAwB,CAAC;QAE7B,IAAI,EAAE,CAAC,UAAU,IAAI,MAAM,IAAK,EAAE,CAAC,UAAkB,EAAE,CAAC;YACtD,sCAAsC;YACtC,IAAI,CAAC;gBACH,iEAAiE;gBACjE,MAAM,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,oBAAoB,CAAQ,CAAC;gBACjE,MAAM,GAAG,eAAe,CAAC,EAAE,CAAC,UAAU,CAAqB,CAAC;YAC9D,CAAC;YAAC,MAAM,CAAC;gBACP,0DAA0D;gBAC1D,MAAM,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;YAC9C,CAAC;QACH,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,CAAC,EAAE,CAAC,UAAU,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,CAAqB,CAAC;QACrF,CAAC;QAED,MAAM,SAAS,GAAG,EAAE,CAAC,OAAO,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAElE,MAAM,CAAC,IAAI,CAAC;YACV,EAAE,EAAE,GAAG,IAAI,KAAK;YAChB,IAAI;YACJ,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,EAAE;YACvF,WAAW,EAAE,EAAE,CAAC,WAAW,IAAI,EAAE;YACjC,WAAW,EAAE,MAAM;YACnB,cAAc,EAAE,KAAK;YACrB,KAAK,CAAC,OAAO,CAAC,IAAS,EAAE,IAA0B;gBACjD,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC;oBACrC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;gBACnC,CAAC;gBAAC,OAAO,GAAQ,EAAE,CAAC;oBAClB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;gBAChE,CAAC;YACH,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"toolAdapter.js","sourceRoot":"","sources":["../../src/api/toolAdapter.ts"],"names":[],"mappings":"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"}

package/dist/api/types/AgentOSExternalToolRequest.d.ts

@@ -0,0 +1,35 @@
+import type { ToolCallRequest } from '../../cognitive_substrate/IGMI';
+/**
+ * Conversation-metadata snapshot describing an external tool pause that can be
+ * recovered after process restart.
+ */
+export interface AgentOSPendingExternalToolRequest {
+    streamId: string;
+    sessionId: string;
+    conversationId: string;
+    userId: string;
+    personaId: string;
+    gmiInstanceId: string;
+    toolCalls: ToolCallRequest[];
+    rationale?: string;
+    requestedAt: string;
+}
+/**
+ * Optional runtime-only data needed when resuming a persisted external tool
+ * pause after the original AgentOS process is gone.
+ */
+export interface AgentOSResumeExternalToolRequestOptions {
+    userApiKeys?: Record<string, string>;
+    preferredModelId?: string;
+    preferredProviderId?: string;
+    /**
+     * Trusted request-scoped organization context to re-apply after restart.
+     *
+     * This is intentionally runtime-only and is not persisted into conversation
+     * metadata, so callers must re-supply it after tenant membership checks when
+     * the resumed turn needs organization-scoped memory or routing.
+     */
+    organizationId?: string;
+}
+export declare const AGENTOS_PENDING_EXTERNAL_TOOL_REQUEST_METADATA_KEY = "agentosPendingExternalToolRequest";
+//# sourceMappingURL=AgentOSExternalToolRequest.d.ts.map

package/dist/api/types/AgentOSExternalToolRequest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentOSExternalToolRequest.d.ts","sourceRoot":"","sources":["../../../src/api/types/AgentOSExternalToolRequest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEtE;;;GAGG;AACH,MAAM,WAAW,iCAAiC;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,uCAAuC;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,eAAO,MAAM,kDAAkD,sCAC1B,CAAC"}

package/dist/api/types/AgentOSExternalToolRequest.js

@@ -0,0 +1,2 @@
+export const AGENTOS_PENDING_EXTERNAL_TOOL_REQUEST_METADATA_KEY = 'agentosPendingExternalToolRequest';
+//# sourceMappingURL=AgentOSExternalToolRequest.js.map

package/dist/api/types/AgentOSExternalToolRequest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentOSExternalToolRequest.js","sourceRoot":"","sources":["../../../src/api/types/AgentOSExternalToolRequest.ts"],"names":[],"mappings":"AAoCA,MAAM,CAAC,MAAM,kDAAkD,GAC7D,mCAAmC,CAAC"}

package/dist/api/types/AgentOSResponse.d.ts

@@ -60,6 +60,12 @@ export interface AgentOSSystemProgressChunk extends AgentOSResponseChunk {
     progressPercentage?: number;
     statusCode?: string;
 }
+/**
+ * Indicates whether a tool request is informational because the runtime will
+ * execute the tool internally, or whether the host must execute the tool and
+ * resume the turn through `handleToolResult(...)`.
+ */
+export type AgentOSToolCallExecutionMode = 'internal' | 'external';
 /**
  * @typedef {Object} AgentOSToolCallRequestChunk
  * Informs the client that the agent has decided to call one or more tools.
@@ -69,6 +75,8 @@ export interface AgentOSToolCallRequestChunk extends AgentOSResponseChunk {
     type: AgentOSResponseChunkType.TOOL_CALL_REQUEST;
     toolCalls: ToolCallRequest[];
     rationale?: string;
+    executionMode: AgentOSToolCallExecutionMode;
+    requiresExternalToolResult: boolean;
 }
 /**
  * @typedef {Object} AgentOSToolResultEmissionChunk
@@ -194,4 +202,21 @@ export interface AgentOSProvenanceEventChunk extends AgentOSResponseChunk {
  * Union type representing any possible chunk that can be streamed from AgentOS.
  */
 export type AgentOSResponse = AgentOSTextDeltaChunk | AgentOSSystemProgressChunk | AgentOSToolCallRequestChunk | AgentOSToolResultEmissionChunk | AgentOSUICommandChunk | AgentOSFinalResponseChunk | AgentOSErrorChunk | AgentOSMetadataUpdateChunk | AgentOSWorkflowUpdateChunk | AgentOSAgencyUpdateChunk | AgentOSProvenanceEventChunk;
+/**
+ * A host-actionable tool request chunk. Hosts should execute or surface the
+ * tool call and resume the stream through `handleToolResult(...)`.
+ */
+export type AgentOSActionableToolCallRequestChunk = AgentOSToolCallRequestChunk & {
+    executionMode: 'external';
+    requiresExternalToolResult: true;
+};
+/**
+ * Runtime type guard for streamed tool-call request chunks.
+ */
+export declare function isToolCallRequestChunk(chunk: unknown): chunk is AgentOSToolCallRequestChunk;
+/**
+ * Runtime type guard for tool-call request chunks that require the host to
+ * call `handleToolResult(...)` to continue the turn.
+ */
+export declare function isActionableToolCallRequestChunk(chunk: unknown): chunk is AgentOSActionableToolCallRequestChunk;
 //# sourceMappingURL=AgentOSResponse.d.ts.map

package/dist/api/types/AgentOSResponse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AgentOSResponse.d.ts","sourceRoot":"","sources":["../../../src/api/types/AgentOSResponse.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"AgentOSResponse.d.ts","sourceRoot":"","sources":["../../../src/api/types/AgentOSResponse.ts"],"names":[],"mappings":"AACA;;;;;GAKG;AAEH,OAAO,EACL,eAAe,EAAE,oEAAoE;AACrF,iBAAiB,EACjB,iBAAiB,EACjB,SAAS,EACT,mBAAmB,IAAI,cAAc,EAAE,2DAA2D;AAClG,cAAc,EACf,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,mBAAmB,EAAE,MAAM,6CAA6C,CAAC;AAClF,OAAO,EAAE,kBAAkB,EAAE,MAAM,uDAAuD,CAAC;AAC3F,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAEjF;;;GAGG;AACH,oBAAY,wBAAwB;IAClC,UAAU,eAAe;IACzB,eAAe,oBAAoB;IACnC,iBAAiB,sBAAsB;IACvC,oBAAoB,yBAAyB;IAC7C,UAAU,eAAe;IACzB,cAAc,mBAAmB;IACjC,KAAK,UAAU;IACf,eAAe,oBAAoB;IACnC,eAAe,oBAAoB;IACnC,aAAa,kBAAkB;IAC/B,gBAAgB,qBAAqB;CACtC;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,wBAAwB,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAsB,SAAQ,oBAAoB;IACjE,IAAI,EAAE,wBAAwB,CAAC,UAAU,CAAC;IAC1C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,0BAA2B,SAAQ,oBAAoB;IACtE,IAAI,EAAE,wBAAwB,CAAC,eAAe,CAAC;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,MAAM,4BAA4B,GAAG,UAAU,GAAG,UAAU,CAAC;AAEnE;;;;GAIG;AACH,MAAM,WAAW,2BAA4B,SAAQ,oBAAoB;IACvE,IAAI,EAAE,wBAAwB,CAAC,iBAAiB,CAAC;IACjD,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,4BAA4B,CAAC;IAC5C,0BAA0B,EAAE,OAAO,CAAC;CACrC;AAED;;;;GAIG;AACH,MAAM,WAAW,8BAA+B,SAAQ,oBAAoB;IAC1E,IAAI,EAAE,wBAAwB,CAAC,oBAAoB,CAAC;IACpD,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,GAAG,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAGD;;;;GAIG;AACH,MAAM,WAAW,qBAAsB,SAAQ,oBAAoB;IACjE,IAAI,EAAE,wBAAwB,CAAC,UAAU,CAAC;IAC1C,UAAU,EAAE,SAAS,EAAE,CAAC;CACzB;AAED;;;;GAIG;AACH,MAAM,WAAW,yBAA0B,SAAQ,oBAAoB;IACrE,IAAI,EAAE,wBAAwB,CAAC,cAAc,CAAC;IAC9C,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC;;;OAGG;IACH,sBAAsB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,cAAc,CAAC,EAAE,eAAe,EAAE,CAAC;IACnC,eAAe,CAAC,EAAE,SAAS,EAAE,CAAC;IAC9B,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,cAAc,CAAC,EAAE,cAAc,EAAE,CAAC;IAClC,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,GAAG,CAAA;KAAE,CAAC;IACzD,0BAA0B,CAAC,EAAE,mBAAmB,CAAC;IACjD,oBAAoB,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAEnD;;;;;OAKG;IACH,UAAU,CAAC,EAAE,OAAO,WAAW,EAAE,iBAAiB,EAAE,CAAC;CACtD;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAkB,SAAQ,oBAAoB;IAC7D,IAAI,EAAE,wBAAwB,CAAC,KAAK,CAAC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,GAAG,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,WAAW,0BAA2B,SAAQ,oBAAoB;IACtE,IAAI,EAAE,wBAAwB,CAAC,eAAe,CAAC;IAC/C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC9B;AAED;;;;GAIG;AACH,MAAM,WAAW,0BAA2B,SAAQ,oBAAoB;IACtE,IAAI,EAAE,wBAAwB,CAAC,eAAe,CAAC;IAC/C,QAAQ,EAAE,sBAAsB,CAAC;CAClC;AAED;;;;GAIG;AACH,MAAM,WAAW,wBAAyB,SAAQ,oBAAoB;IACpE,IAAI,EAAE,wBAAwB,CAAC,aAAa,CAAC;IAC7C,MAAM,EAAE;QACN,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,KAAK,EAAE,KAAK,CAAC;YACX,MAAM,EAAE,MAAM,CAAC;YACf,aAAa,EAAE,MAAM,CAAC;YACtB,SAAS,EAAE,MAAM,CAAC;YAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;SACpC,CAAC,CAAC;QACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,CAAC;CACH;AAED;;;;GAIG;AACH,MAAM,WAAW,2BAA4B,SAAQ,oBAAoB;IACvE,IAAI,EAAE,wBAAwB,CAAC,gBAAgB,CAAC;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;;GAGG;AACH,MAAM,MAAM,eAAe,GACvB,qBAAqB,GACrB,0BAA0B,GAC1B,2BAA2B,GAC3B,8BAA8B,GAC9B,qBAAqB,GACrB,yBAAyB,GACzB,iBAAiB,GACjB,0BAA0B,GAC1B,0BAA0B,GAC1B,wBAAwB,GACxB,2BAA2B,CAAC;AAEhC;;;GAGG;AACH,MAAM,MAAM,qCAAqC,GAC/C,2BAA2B,GAAG;IAC5B,aAAa,EAAE,UAAU,CAAC;IAC1B,0BAA0B,EAAE,IAAI,CAAC;CAClC,CAAC;AAMJ;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,2BAA2B,CAMtC;AAED;;;GAGG;AACH,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,qCAAqC,CAMhD"}

package/dist/api/types/AgentOSResponse.js

@@ -23,4 +23,24 @@ export var AgentOSResponseChunkType;
     AgentOSResponseChunkType["AGENCY_UPDATE"] = "agency_update";
     AgentOSResponseChunkType["PROVENANCE_EVENT"] = "provenance_event";
 })(AgentOSResponseChunkType || (AgentOSResponseChunkType = {}));
+function isChunkRecord(value) {
+    return value !== null && typeof value === 'object';
+}
+/**
+ * Runtime type guard for streamed tool-call request chunks.
+ */
+export function isToolCallRequestChunk(chunk) {
+    return (isChunkRecord(chunk) &&
+        chunk.type === AgentOSResponseChunkType.TOOL_CALL_REQUEST &&
+        Array.isArray(chunk.toolCalls));
+}
+/**
+ * Runtime type guard for tool-call request chunks that require the host to
+ * call `handleToolResult(...)` to continue the turn.
+ */
+export function isActionableToolCallRequestChunk(chunk) {
+    return (isToolCallRequestChunk(chunk) &&
+        chunk.executionMode === 'external' &&
+        chunk.requiresExternalToolResult === true);
+}
 //# sourceMappingURL=AgentOSResponse.js.map

package/dist/api/types/AgentOSResponse.js.map

@@ -1 +1 @@
-{"version":3,"file":"AgentOSResponse.js","sourceRoot":"","sources":["../../../src/api/types/AgentOSResponse.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD;;;;;GAKG;AAcH;;;GAGG;AACH,MAAM,CAAN,IAAY,wBAYX;AAZD,WAAY,wBAAwB;IAClC,qDAAyB,CAAA;IACzB,+DAAmC,CAAA;IACnC,mEAAuC,CAAA;IACvC,yEAA6C,CAAA;IAC7C,qDAAyB,CAAA;IACzB,6DAAiC,CAAA;IACjC,2CAAe,CAAA;IACf,+DAAmC,CAAA;IACnC,+DAAmC,CAAA;IACnC,2DAA+B,CAAA;IAC/B,iEAAqC,CAAA;AACvC,CAAC,EAZW,wBAAwB,KAAxB,wBAAwB,QAYnC"}
+{"version":3,"file":"AgentOSResponse.js","sourceRoot":"","sources":["../../../src/api/types/AgentOSResponse.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD;;;;;GAKG;AAcH;;;GAGG;AACH,MAAM,CAAN,IAAY,wBAYX;AAZD,WAAY,wBAAwB;IAClC,qDAAyB,CAAA;IACzB,+DAAmC,CAAA;IACnC,mEAAuC,CAAA;IACvC,yEAA6C,CAAA;IAC7C,qDAAyB,CAAA;IACzB,6DAAiC,CAAA;IACjC,2CAAe,CAAA;IACf,+DAAmC,CAAA;IACnC,+DAAmC,CAAA;IACnC,2DAA+B,CAAA;IAC/B,iEAAqC,CAAA;AACvC,CAAC,EAZW,wBAAwB,KAAxB,wBAAwB,QAYnC;AAkND,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC;AACrD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CACpC,KAAc;IAEd,OAAO,CACL,aAAa,CAAC,KAAK,CAAC;QACpB,KAAK,CAAC,IAAI,KAAK,wBAAwB,CAAC,iBAAiB;QACzD,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAC/B,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gCAAgC,CAC9C,KAAc;IAEd,OAAO,CACL,sBAAsB,CAAC,KAAK,CAAC;QAC7B,KAAK,CAAC,aAAa,KAAK,UAAU;QAClC,KAAK,CAAC,0BAA0B,KAAK,IAAI,CAC1C,CAAC;AACJ,CAAC"}

package/dist/api/types/AgentOSToolResult.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Host-provided result for one externally executed tool call.
+ */
+export interface AgentOSToolResultInput {
+    toolCallId: string;
+    toolName: string;
+    toolOutput: any;
+    isSuccess: boolean;
+    errorMessage?: string;
+}
+//# sourceMappingURL=AgentOSToolResult.d.ts.map

package/dist/api/types/AgentOSToolResult.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentOSToolResult.d.ts","sourceRoot":"","sources":["../../../src/api/types/AgentOSToolResult.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,GAAG,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB"}

package/dist/api/types/AgentOSToolResult.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=AgentOSToolResult.js.map

package/dist/api/types/AgentOSToolResult.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentOSToolResult.js","sourceRoot":"","sources":["../../../src/api/types/AgentOSToolResult.ts"],"names":[],"mappings":""}