@framers/agentos 0.1.112 → 0.1.114

package/dist/api/model.js

@@ -14,6 +14,10 @@ const ENV_KEY_MAP = {
     anthropic: 'ANTHROPIC_API_KEY',
     openrouter: 'OPENROUTER_API_KEY',
     gemini: 'GEMINI_API_KEY',
+    groq: 'GROQ_API_KEY',
+    together: 'TOGETHER_API_KEY',
+    mistral: 'MISTRAL_API_KEY',
+    xai: 'XAI_API_KEY',
     stability: 'STABILITY_API_KEY',
     replicate: 'REPLICATE_API_TOKEN',
 };
@@ -34,7 +38,7 @@ const ENV_URL_MAP = {
  *
  * @param model - A `provider:model` string such as `"openai:gpt-4o"`,
  *   `"ollama:llama3.2"`, or `"openrouter:anthropic/claude-sonnet-4-5-20250929"`.
- * @returns A {@link ParsedModel} with `providerId` and `modelId` fields.
+ * @returns A `ParsedModel` with `providerId` and `modelId` fields.
  * @throws {Error} When the string is missing, not a string, or does not match
  *   the expected `provider:model` format.
  */
@@ -63,14 +67,14 @@ export function parseModelString(model) {
  * @param modelId - Model identifier within the provider.
  * @param overrides - Optional explicit API key and/or base URL that take precedence
  *   over environment variable lookups.
- * @returns A {@link ResolvedProvider} ready for {@link createProviderManager}.
+ * @returns A `ResolvedProvider` ready for `createProviderManager()`.
  * @throws {Error} When no credentials can be resolved for the given provider.
  */
 export function resolveProvider(providerId, modelId, overrides) {
-    const apiKey = overrides?.apiKey
-        ?? (ENV_KEY_MAP[providerId] ? process.env[ENV_KEY_MAP[providerId]] : undefined);
-    const baseUrl = overrides?.baseUrl
-        ?? (ENV_URL_MAP[providerId] ? process.env[ENV_URL_MAP[providerId]] : undefined);
+    const apiKey = overrides?.apiKey ??
+        (ENV_KEY_MAP[providerId] ? process.env[ENV_KEY_MAP[providerId]] : undefined);
+    const baseUrl = overrides?.baseUrl ??
+        (ENV_URL_MAP[providerId] ? process.env[ENV_URL_MAP[providerId]] : undefined);
     if (providerId === 'ollama') {
         if (!baseUrl) {
             throw new Error(`No base URL for ollama. Set OLLAMA_BASE_URL or pass baseUrl.`);
@@ -102,14 +106,14 @@ export function resolveProvider(providerId, modelId, overrides) {
  * @param providerId - Provider identifier (e.g. `"stability"`, `"replicate"`, `"ollama"`).
  * @param modelId - Model identifier within the provider.
  * @param overrides - Optional explicit API key and/or base URL overrides.
- * @returns A {@link ResolvedProvider} ready for use with an image provider factory.
+ * @returns A `ResolvedProvider` ready for use with an image provider factory.
  * @throws {Error} When a known provider is missing its required API key or base URL.
  */
 export function resolveMediaProvider(providerId, modelId, overrides) {
-    const apiKey = overrides?.apiKey
-        ?? (ENV_KEY_MAP[providerId] ? process.env[ENV_KEY_MAP[providerId]] : undefined);
-    const baseUrl = overrides?.baseUrl
-        ?? (ENV_URL_MAP[providerId] ? process.env[ENV_URL_MAP[providerId]] : undefined);
+    const apiKey = overrides?.apiKey ??
+        (ENV_KEY_MAP[providerId] ? process.env[ENV_KEY_MAP[providerId]] : undefined);
+    const baseUrl = overrides?.baseUrl ??
+        (ENV_URL_MAP[providerId] ? process.env[ENV_URL_MAP[providerId]] : undefined);
     if (providerId === 'ollama') {
         if (!baseUrl) {
             throw new Error(`No base URL for ollama. Set OLLAMA_BASE_URL or pass baseUrl.`);
@@ -143,7 +147,7 @@ export function resolveMediaProvider(providerId, modelId, overrides) {
  *
  * @param opts - Caller options containing optional `provider` and/or `model`.
  * @param task - Task type used to select the correct default model. Defaults to `"text"`.
- * @returns A {@link ParsedModel} with `providerId` and `modelId`.
+ * @returns A `ParsedModel` with `providerId` and `modelId`.
  * @throws {Error} When no provider can be determined, the provider is unknown,
  *   or the provider has no default model for the requested task.
  */
@@ -192,8 +196,8 @@ export function resolveModelOption(opts, task = 'text') {
  * `manager.initialize()` before returning.  The returned manager is ready for
  * immediate use via `manager.getProvider(providerId)`.
  *
- * @param resolved - A {@link ResolvedProvider} produced by {@link resolveProvider}
- *   or {@link resolveMediaProvider}.
+ * @param resolved - A `ResolvedProvider` produced by {@link resolveProvider}
+ *   or `resolveMediaProvider()`.
  * @returns A fully initialised {@link AIModelProviderManager} instance.
  */
 export async function createProviderManager(resolved) {
@@ -206,12 +210,14 @@ export async function createProviderManager(resolved) {
         providerConfig.baseUrl = resolved.baseUrl;
     }
     await manager.initialize({
-        providers: [{
+        providers: [
+            {
                 providerId: resolved.providerId,
                 enabled: true,
                 isDefault: true,
                 config: providerConfig,
-            }],
+            },
+        ],
     });
     return manager;
 }

package/dist/api/model.js.map

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

package/dist/api/processRequestWithExternalTools.d.ts

@@ -0,0 +1,26 @@
+import type { AgentOSInput } from './types/AgentOSInput';
+import { type AgentOSActionableToolCallRequestChunk, type AgentOSResponse } from './types/AgentOSResponse';
+import type { IAgentOS } from './interfaces/IAgentOS';
+import type { ToolCallRequest } from '../cognitive_substrate/IGMI';
+export interface AgentOSExternalToolHandlerContext {
+    agentos: Pick<IAgentOS, 'handleToolResult'> & Partial<Pick<IAgentOS, 'handleToolResults'>>;
+    streamId: string;
+    requestChunk: AgentOSActionableToolCallRequestChunk;
+    toolCall: ToolCallRequest;
+}
+export interface AgentOSExternalToolHandlerResult {
+    toolOutput: unknown;
+    isSuccess?: boolean;
+    errorMessage?: string;
+}
+export type AgentOSExternalToolHandler = (context: AgentOSExternalToolHandlerContext) => Promise<AgentOSExternalToolHandlerResult>;
+/**
+ * Runs a full `AgentOS.processRequest(...)` turn and automatically resumes any
+ * actionable external tool pauses through `handleToolResult(...)`.
+ *
+ * Actionable external tool calls are executed in emitted order. When a pause
+ * contains multiple actionable tool calls, the helper batches their results and
+ * resumes the stream once through `handleToolResults(...)` when available.
+ */
+export declare function processRequestWithExternalTools(agentos: Pick<IAgentOS, 'processRequest' | 'handleToolResult'> & Partial<Pick<IAgentOS, 'handleToolResults'>>, input: AgentOSInput, executeToolCall: AgentOSExternalToolHandler): AsyncGenerator<AgentOSResponse, void, undefined>;
+//# sourceMappingURL=processRequestWithExternalTools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"processRequestWithExternalTools.d.ts","sourceRoot":"","sources":["../../src/api/processRequestWithExternalTools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD,OAAO,EAEL,KAAK,qCAAqC,EAC1C,KAAK,eAAe,EACrB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAInE,MAAM,WAAW,iCAAiC;IAChD,OAAO,EAAE,IAAI,CAAC,QAAQ,EAAE,kBAAkB,CAAC,GACzC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,mBAAmB,CAAC,CAAC,CAAC;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,qCAAqC,CAAC;IACpD,QAAQ,EAAE,eAAe,CAAC;CAC3B;AAED,MAAM,WAAW,gCAAgC;IAC/C,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,0BAA0B,GAAG,CACvC,OAAO,EAAE,iCAAiC,KACvC,OAAO,CAAC,gCAAgC,CAAC,CAAC;AAkE/C;;;;;;;GAOG;AACH,wBAAuB,+BAA+B,CACpD,OAAO,EAAE,IAAI,CAAC,QAAQ,EAAE,gBAAgB,GAAG,kBAAkB,CAAC,GAC5D,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,mBAAmB,CAAC,CAAC,EAC9C,KAAK,EAAE,YAAY,EACnB,eAAe,EAAE,0BAA0B,GAC1C,cAAc,CAAC,eAAe,EAAE,IAAI,EAAE,SAAS,CAAC,CAMlD"}

package/dist/api/processRequestWithExternalTools.js

@@ -0,0 +1,52 @@
+import { isActionableToolCallRequestChunk, } from './types/AgentOSResponse.js';
+import { AgentOSServiceError } from './errors.js';
+import { GMIErrorCode } from '../utils/errors.js';
+async function* continueStreamWithExternalTools(agentos, stream, executeToolCall) {
+    for await (const chunk of stream) {
+        yield chunk;
+        if (!isActionableToolCallRequestChunk(chunk)) {
+            continue;
+        }
+        const toolResults = [];
+        for (const toolCall of chunk.toolCalls) {
+            const execution = await executeToolCall({
+                agentos,
+                streamId: chunk.streamId,
+                requestChunk: chunk,
+                toolCall,
+            });
+            toolResults.push({
+                toolCallId: toolCall.id,
+                toolName: toolCall.name,
+                toolOutput: execution.toolOutput,
+                isSuccess: execution.isSuccess ?? true,
+                errorMessage: execution.errorMessage,
+            });
+        }
+        if (toolResults.length > 1 && !agentos.handleToolResults) {
+            throw new AgentOSServiceError(`processRequestWithExternalTools received ${toolResults.length} actionable external tool calls, but the provided AgentOS runtime does not support batched continuation.`, GMIErrorCode.INVALID_STATE, {
+                streamId: chunk.streamId,
+                toolCallCount: chunk.toolCalls.length,
+                toolCalls: chunk.toolCalls.map((toolCall) => ({
+                    id: toolCall.id,
+                    name: toolCall.name,
+                })),
+            }, 'processRequestWithExternalTools');
+        }
+        yield* continueStreamWithExternalTools(agentos, toolResults.length === 1 || !agentos.handleToolResults
+            ? agentos.handleToolResult(chunk.streamId, toolResults[0].toolCallId, toolResults[0].toolName, toolResults[0].toolOutput, toolResults[0].isSuccess, toolResults[0].errorMessage)
+            : agentos.handleToolResults(chunk.streamId, toolResults), executeToolCall);
+    }
+}
+/**
+ * Runs a full `AgentOS.processRequest(...)` turn and automatically resumes any
+ * actionable external tool pauses through `handleToolResult(...)`.
+ *
+ * Actionable external tool calls are executed in emitted order. When a pause
+ * contains multiple actionable tool calls, the helper batches their results and
+ * resumes the stream once through `handleToolResults(...)` when available.
+ */
+export async function* processRequestWithExternalTools(agentos, input, executeToolCall) {
+    yield* continueStreamWithExternalTools(agentos, agentos.processRequest(input), executeToolCall);
+}
+//# sourceMappingURL=processRequestWithExternalTools.js.map

package/dist/api/processRequestWithExternalTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"processRequestWithExternalTools.js","sourceRoot":"","sources":["../../src/api/processRequestWithExternalTools.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,gCAAgC,GAGjC,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAoB7D,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/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/processRequestWithRegisteredTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"processRequestWithRegisteredTools.d.ts","sourceRoot":"","sources":["../../src/api/processRequestWithRegisteredTools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGzD,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,yBAAyB,CAAC;AAW/D,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/processRequestWithRegisteredTools.js

@@ -0,0 +1,125 @@
+import { AgentOSServiceError } from './errors.js';
+import { GMIErrorCode } from '../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/processRequestWithRegisteredTools.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"provider-defaults.d.ts","sourceRoot":"","sources":["../../src/api/provider-defaults.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;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;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAkC9D,CAAC;AAcF;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,GAAG,SAAS,CAKvD"}
+{"version":3,"file":"provider-defaults.d.ts","sourceRoot":"","sources":["../../src/api/provider-defaults.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;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;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAwD9D,CAAC;AAoBF;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,GAAG,SAAS,CAKvD"}

package/dist/api/provider-defaults.js

@@ -46,6 +46,28 @@ export const PROVIDER_DEFAULTS = {
     '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',
+    },
 };
 /** Env var keys checked for auto-detection, in priority order */
 const AUTO_DETECT_ORDER = [
@@ -53,10 +75,16 @@ const AUTO_DETECT_ORDER = [
     { envKey: 'ANTHROPIC_API_KEY', provider: 'anthropic' },
     { envKey: 'OPENROUTER_API_KEY', provider: 'openrouter' },
     { 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' },
     { 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' },
 ];
 /**
  * Auto-detects the active provider by scanning well-known environment variables

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

@@ -1 +1 @@
-{"version":3,"file":"provider-defaults.js","sourceRoot":"","sources":["../../src/api/provider-defaults.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAiBH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAqC;IACjE,MAAM,EAAE;QACN,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,aAAa;QACpB,SAAS,EAAE,wBAAwB;QACnC,KAAK,EAAE,aAAa;KACrB;IACD,SAAS,EAAE;QACT,IAAI,EAAE,0BAA0B;QAChC,KAAK,EAAE,2BAA2B;KACnC;IACD,MAAM,EAAE;QACN,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,kBAAkB;QACzB,SAAS,EAAE,kBAAkB;QAC7B,KAAK,EAAE,UAAU;KAClB;IACD,UAAU,EAAE;QACV,IAAI,EAAE,eAAe;QACrB,KAAK,EAAE,oBAAoB;KAC5B;IACD,MAAM,EAAE;QACN,IAAI,EAAE,kBAAkB;QACxB,KAAK,EAAE,kBAAkB;KAC1B;IACD,SAAS,EAAE;QACT,KAAK,EAAE,+BAA+B;KACvC;IACD,SAAS,EAAE;QACT,KAAK,EAAE,gCAAgC;KACxC;IACD,wBAAwB,EAAE;QACxB,KAAK,EAAE,qBAAqB;KAC7B;CACF,CAAC;AAEF,iEAAiE;AACjE,MAAM,iBAAiB,GAAgD;IACrE,EAAE,MAAM,EAAE,gBAAgB,EAAE,QAAQ,EAAE,QAAQ,EAAE;IAChD,EAAE,MAAM,EAAE,mBAAmB,EAAE,QAAQ,EAAE,WAAW,EAAE;IACtD,EAAE,MAAM,EAAE,oBAAoB,EAAE,QAAQ,EAAE,YAAY,EAAE;IACxD,EAAE,MAAM,EAAE,gBAAgB,EAAE,QAAQ,EAAE,QAAQ,EAAE;IAChD,EAAE,MAAM,EAAE,iBAAiB,EAAE,QAAQ,EAAE,QAAQ,EAAE;IACjD,EAAE,MAAM,EAAE,mBAAmB,EAAE,QAAQ,EAAE,WAAW,EAAE;IACtD,EAAE,MAAM,EAAE,qBAAqB,EAAE,QAAQ,EAAE,WAAW,EAAE;IACxD,EAAE,MAAM,EAAE,iCAAiC,EAAE,QAAQ,EAAE,wBAAwB,EAAE;CAClF,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB;IAChC,KAAK,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,iBAAiB,EAAE,CAAC;QACrD,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC;YAAE,OAAO,QAAQ,CAAC;IAC3C,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}
+{"version":3,"file":"provider-defaults.js","sourceRoot":"","sources":["../../src/api/provider-defaults.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAiBH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAqC;IACjE,MAAM,EAAE;QACN,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,aAAa;QACpB,SAAS,EAAE,wBAAwB;QACnC,KAAK,EAAE,aAAa;KACrB;IACD,SAAS,EAAE;QACT,IAAI,EAAE,0BAA0B;QAChC,KAAK,EAAE,2BAA2B;KACnC;IACD,MAAM,EAAE;QACN,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,kBAAkB;QACzB,SAAS,EAAE,kBAAkB;QAC7B,KAAK,EAAE,UAAU;KAClB;IACD,UAAU,EAAE;QACV,IAAI,EAAE,eAAe;QACrB,KAAK,EAAE,oBAAoB;KAC5B;IACD,MAAM,EAAE;QACN,IAAI,EAAE,kBAAkB;QACxB,KAAK,EAAE,kBAAkB;KAC1B;IACD,SAAS,EAAE;QACT,KAAK,EAAE,+BAA+B;KACvC;IACD,SAAS,EAAE;QACT,KAAK,EAAE,gCAAgC;KACxC;IACD,wBAAwB,EAAE;QACxB,KAAK,EAAE,qBAAqB;KAC7B;IACD,GAAG,EAAE;QACH,KAAK,EAAE,cAAc;KACtB;IACD,GAAG,EAAE;QACH,KAAK,EAAE,iBAAiB;KACzB;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,yBAAyB;QAC/B,KAAK,EAAE,cAAc;KACtB;IACD,QAAQ,EAAE;QACR,IAAI,EAAE,8CAA8C;QACpD,KAAK,EAAE,6CAA6C;KACrD;IACD,OAAO,EAAE;QACP,IAAI,EAAE,sBAAsB;QAC5B,KAAK,EAAE,sBAAsB;KAC9B;IACD,GAAG,EAAE;QACH,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,aAAa;KACrB;CACF,CAAC;AAEF,iEAAiE;AACjE,MAAM,iBAAiB,GAAgD;IACrE,EAAE,MAAM,EAAE,gBAAgB,EAAE,QAAQ,EAAE,QAAQ,EAAE;IAChD,EAAE,MAAM,EAAE,mBAAmB,EAAE,QAAQ,EAAE,WAAW,EAAE;IACtD,EAAE,MAAM,EAAE,oBAAoB,EAAE,QAAQ,EAAE,YAAY,EAAE;IACxD,EAAE,MAAM,EAAE,gBAAgB,EAAE,QAAQ,EAAE,QAAQ,EAAE;IAChD,EAAE,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,EAAE;IAC5C,EAAE,MAAM,EAAE,kBAAkB,EAAE,QAAQ,EAAE,UAAU,EAAE;IACpD,EAAE,MAAM,EAAE,iBAAiB,EAAE,QAAQ,EAAE,SAAS,EAAE;IAClD,EAAE,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,KAAK,EAAE;IAC1C,EAAE,MAAM,EAAE,iBAAiB,EAAE,QAAQ,EAAE,QAAQ,EAAE;IACjD,EAAE,MAAM,EAAE,mBAAmB,EAAE,QAAQ,EAAE,WAAW,EAAE;IACtD,EAAE,MAAM,EAAE,qBAAqB,EAAE,QAAQ,EAAE,WAAW,EAAE;IACxD,EAAE,MAAM,EAAE,iCAAiC,EAAE,QAAQ,EAAE,wBAAwB,EAAE;IACjF,EAAE,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,KAAK,EAAE;IAC1C,EAAE,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,KAAK,EAAE;CAC3C,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB;IAChC,KAAK,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,iBAAiB,EAAE,CAAC;QACrD,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC;YAAE,OAAO,QAAQ,CAAC;IAC3C,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/api/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/resumeExternalToolRequestWithRegisteredTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resumeExternalToolRequestWithRegisteredTools.d.ts","sourceRoot":"","sources":["../../src/api/resumeExternalToolRequestWithRegisteredTools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAChF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,KAAK,EACV,iCAAiC,EACjC,uCAAuC,EACxC,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAExE,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"}