@framers/agentos 0.1.112 → 0.1.114

package/dist/core/llm/providers/implementations/TogetherProvider.d.ts

@@ -0,0 +1,107 @@
+/**
+ * @fileoverview Implements the IProvider interface for Together AI's inference API.
+ *
+ * Together AI exposes a fully OpenAI-compatible `/v1/chat/completions` endpoint,
+ * so this provider delegates to the existing {@link OpenAIProvider} with Together's
+ * base URL and credentials. The wrapper provides Together-specific provider ID,
+ * default model catalog, and configuration.
+ *
+ * @module backend/agentos/core/llm/providers/implementations/TogetherProvider
+ * @implements {IProvider}
+ */
+import { IProvider, ChatMessage, ModelCompletionOptions, ModelCompletionResponse, ModelInfo, ProviderEmbeddingOptions, ProviderEmbeddingResponse } from '../IProvider';
+/**
+ * Configuration for the TogetherProvider.
+ *
+ * @example
+ * const config: TogetherProviderConfig = {
+ *   apiKey: process.env.TOGETHER_API_KEY!,
+ *   defaultModelId: 'meta-llama/Meta-Llama-3.1-70B-Instruct-Turbo',
+ * };
+ */
+export interface TogetherProviderConfig {
+    /** Together API key. Sourced from `TOGETHER_API_KEY`. */
+    apiKey: string;
+    /**
+     * Base URL override.
+     * @default "https://api.together.xyz/v1"
+     */
+    baseURL?: string;
+    /**
+     * Default model to use when none is specified.
+     * @default "meta-llama/Meta-Llama-3.1-70B-Instruct-Turbo"
+     */
+    defaultModelId?: string;
+    /** Request timeout in milliseconds. @default 60000 */
+    requestTimeout?: number;
+}
+/**
+ * @class TogetherProvider
+ * @implements {IProvider}
+ *
+ * Thin wrapper around {@link OpenAIProvider} that targets Together AI's
+ * OpenAI-compatible API endpoint. Together hosts a wide range of open-source
+ * models (Llama, Mixtral, etc.) with competitive pricing and fast inference.
+ *
+ * @example
+ * const together = new TogetherProvider();
+ * await together.initialize({ apiKey: process.env.TOGETHER_API_KEY! });
+ * const res = await together.generateCompletion(
+ *   'meta-llama/Meta-Llama-3.1-70B-Instruct-Turbo', messages, {},
+ * );
+ */
+export declare class TogetherProvider implements IProvider {
+    /** @inheritdoc */
+    readonly providerId: string;
+    /** @inheritdoc */
+    isInitialized: boolean;
+    /** @inheritdoc */
+    defaultModelId?: string;
+    /**
+     * Internal OpenAI provider instance that handles the actual API communication.
+     * Together's API is fully OpenAI-compatible, so we reuse the OpenAI transport layer.
+     */
+    private delegate;
+    constructor();
+    /**
+     * Initializes the provider by configuring the underlying OpenAI delegate
+     * with Together's base URL and the caller's API key.
+     *
+     * @param {TogetherProviderConfig} config - Together-specific configuration.
+     * @returns {Promise<void>}
+     * @throws {Error} If the API key is missing.
+     */
+    initialize(config: TogetherProviderConfig): Promise<void>;
+    /** @inheritdoc */
+    generateCompletion(modelId: string, messages: ChatMessage[], options: ModelCompletionOptions): Promise<ModelCompletionResponse>;
+    /** @inheritdoc */
+    generateCompletionStream(modelId: string, messages: ChatMessage[], options: ModelCompletionOptions): AsyncGenerator<ModelCompletionResponse, void, undefined>;
+    /**
+     * Together AI supports embeddings for some models, delegated to the OpenAI-compatible endpoint.
+     *
+     * @param {string} modelId - Embedding model ID.
+     * @param {string[]} texts - Texts to embed.
+     * @param {ProviderEmbeddingOptions} [options] - Embedding options.
+     * @returns {Promise<ProviderEmbeddingResponse>} Embedding response.
+     */
+    generateEmbeddings(modelId: string, texts: string[], options?: ProviderEmbeddingOptions): Promise<ProviderEmbeddingResponse>;
+    /**
+     * Returns a static catalog of well-known Together-hosted models.
+     *
+     * @param {{ capability?: string }} [filter] - Optional capability filter.
+     * @returns {Promise<ModelInfo[]>} Together model catalog.
+     */
+    listAvailableModels(filter?: {
+        capability?: string;
+    }): Promise<ModelInfo[]>;
+    /** @inheritdoc */
+    getModelInfo(modelId: string): Promise<ModelInfo | undefined>;
+    /** @inheritdoc */
+    checkHealth(): Promise<{
+        isHealthy: boolean;
+        details?: unknown;
+    }>;
+    /** @inheritdoc */
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=TogetherProvider.d.ts.map

package/dist/core/llm/providers/implementations/TogetherProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TogetherProvider.d.ts","sourceRoot":"","sources":["../../../../../src/core/llm/providers/implementations/TogetherProvider.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAEH,OAAO,EACL,SAAS,EACT,WAAW,EACX,sBAAsB,EACtB,uBAAuB,EACvB,SAAS,EACT,wBAAwB,EACxB,yBAAyB,EAC1B,MAAM,cAAc,CAAC;AAOtB;;;;;;;;GAQG;AACH,MAAM,WAAW,sBAAsB;IACrC,yDAAyD;IACzD,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sDAAsD;IACtD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AA4CD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,gBAAiB,YAAW,SAAS;IAChD,kBAAkB;IAClB,SAAgB,UAAU,EAAE,MAAM,CAAc;IAChD,kBAAkB;IACX,aAAa,EAAE,OAAO,CAAS;IACtC,kBAAkB;IACX,cAAc,CAAC,EAAE,MAAM,CAAC;IAE/B;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAwB;;IAIxC;;;;;;;OAOG;IACU,UAAU,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBtE,kBAAkB;IACL,kBAAkB,CAC7B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,WAAW,EAAE,EACvB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,uBAAuB,CAAC;IAInC,kBAAkB;IACJ,wBAAwB,CACpC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,WAAW,EAAE,EACvB,OAAO,EAAE,sBAAsB,GAC9B,cAAc,CAAC,uBAAuB,EAAE,IAAI,EAAE,SAAS,CAAC;IAI3D;;;;;;;OAOG;IACU,kBAAkB,CAC7B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EAAE,EACf,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,yBAAyB,CAAC;IAIrC;;;;;OAKG;IACU,mBAAmB,CAAC,MAAM,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAOxF,kBAAkB;IACL,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC;IAI1E,kBAAkB;IACL,WAAW,IAAI,OAAO,CAAC;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAI9E,kBAAkB;IACL,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAKvC"}

package/dist/core/llm/providers/implementations/TogetherProvider.js

@@ -0,0 +1,138 @@
+// File: backend/agentos/core/llm/providers/implementations/TogetherProvider.ts
+import { OpenAIProvider } from './OpenAIProvider.js';
+// ---------------------------------------------------------------------------
+// Known model catalog
+// ---------------------------------------------------------------------------
+/** Static catalog of well-known Together AI models. */
+const TOGETHER_MODELS = [
+    {
+        modelId: 'meta-llama/Meta-Llama-3.1-70B-Instruct-Turbo',
+        providerId: 'together',
+        displayName: 'Llama 3.1 70B Instruct Turbo',
+        description: 'Meta Llama 3.1 70B optimized for fast instruction-following on Together.',
+        capabilities: ['chat', 'tool_use'],
+        contextWindowSize: 131072,
+        supportsStreaming: true,
+        status: 'active',
+    },
+    {
+        modelId: 'meta-llama/Meta-Llama-3.1-8B-Instruct-Turbo',
+        providerId: 'together',
+        displayName: 'Llama 3.1 8B Instruct Turbo',
+        description: 'Meta Llama 3.1 8B — cost-effective instruction model on Together.',
+        capabilities: ['chat', 'tool_use'],
+        contextWindowSize: 131072,
+        supportsStreaming: true,
+        status: 'active',
+    },
+    {
+        modelId: 'mistralai/Mixtral-8x7B-Instruct-v0.1',
+        providerId: 'together',
+        displayName: 'Mixtral 8x7B Instruct v0.1',
+        description: 'Mistral AI Mixtral MoE instruction-tuned on Together.',
+        capabilities: ['chat', 'tool_use'],
+        contextWindowSize: 32768,
+        supportsStreaming: true,
+        status: 'active',
+    },
+];
+// ---------------------------------------------------------------------------
+// Provider implementation
+// ---------------------------------------------------------------------------
+/**
+ * @class TogetherProvider
+ * @implements {IProvider}
+ *
+ * Thin wrapper around {@link OpenAIProvider} that targets Together AI's
+ * OpenAI-compatible API endpoint. Together hosts a wide range of open-source
+ * models (Llama, Mixtral, etc.) with competitive pricing and fast inference.
+ *
+ * @example
+ * const together = new TogetherProvider();
+ * await together.initialize({ apiKey: process.env.TOGETHER_API_KEY! });
+ * const res = await together.generateCompletion(
+ *   'meta-llama/Meta-Llama-3.1-70B-Instruct-Turbo', messages, {},
+ * );
+ */
+export class TogetherProvider {
+    constructor() {
+        /** @inheritdoc */
+        this.providerId = 'together';
+        /** @inheritdoc */
+        this.isInitialized = false;
+        /**
+         * Internal OpenAI provider instance that handles the actual API communication.
+         * Together's API is fully OpenAI-compatible, so we reuse the OpenAI transport layer.
+         */
+        this.delegate = new OpenAIProvider();
+    }
+    /**
+     * Initializes the provider by configuring the underlying OpenAI delegate
+     * with Together's base URL and the caller's API key.
+     *
+     * @param {TogetherProviderConfig} config - Together-specific configuration.
+     * @returns {Promise<void>}
+     * @throws {Error} If the API key is missing.
+     */
+    async initialize(config) {
+        if (!config.apiKey) {
+            throw new Error('API key is required for TogetherProvider. Set TOGETHER_API_KEY.');
+        }
+        this.defaultModelId = config.defaultModelId ?? 'meta-llama/Meta-Llama-3.1-70B-Instruct-Turbo';
+        // Delegate to OpenAI provider with Together's endpoint
+        await this.delegate.initialize({
+            apiKey: config.apiKey,
+            baseURL: config.baseURL ?? 'https://api.together.xyz/v1',
+            defaultModelId: this.defaultModelId,
+            requestTimeout: config.requestTimeout ?? 60000,
+        });
+        this.isInitialized = true;
+        console.log(`TogetherProvider initialized. Default model: ${this.defaultModelId}.`);
+    }
+    /** @inheritdoc */
+    async generateCompletion(modelId, messages, options) {
+        return this.delegate.generateCompletion(modelId, messages, options);
+    }
+    /** @inheritdoc */
+    async *generateCompletionStream(modelId, messages, options) {
+        yield* this.delegate.generateCompletionStream(modelId, messages, options);
+    }
+    /**
+     * Together AI supports embeddings for some models, delegated to the OpenAI-compatible endpoint.
+     *
+     * @param {string} modelId - Embedding model ID.
+     * @param {string[]} texts - Texts to embed.
+     * @param {ProviderEmbeddingOptions} [options] - Embedding options.
+     * @returns {Promise<ProviderEmbeddingResponse>} Embedding response.
+     */
+    async generateEmbeddings(modelId, texts, options) {
+        return this.delegate.generateEmbeddings(modelId, texts, options);
+    }
+    /**
+     * Returns a static catalog of well-known Together-hosted models.
+     *
+     * @param {{ capability?: string }} [filter] - Optional capability filter.
+     * @returns {Promise<ModelInfo[]>} Together model catalog.
+     */
+    async listAvailableModels(filter) {
+        if (filter?.capability) {
+            return TOGETHER_MODELS.filter(m => m.capabilities.includes(filter.capability));
+        }
+        return [...TOGETHER_MODELS];
+    }
+    /** @inheritdoc */
+    async getModelInfo(modelId) {
+        return TOGETHER_MODELS.find(m => m.modelId === modelId);
+    }
+    /** @inheritdoc */
+    async checkHealth() {
+        return this.delegate.checkHealth();
+    }
+    /** @inheritdoc */
+    async shutdown() {
+        await this.delegate.shutdown();
+        this.isInitialized = false;
+        console.log('TogetherProvider shutdown complete.');
+    }
+}
+//# sourceMappingURL=TogetherProvider.js.map

package/dist/core/llm/providers/implementations/TogetherProvider.js.map

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

package/dist/core/llm/providers/implementations/XAIProvider.d.ts

@@ -0,0 +1,102 @@
+/**
+ * @fileoverview Implements the IProvider interface for xAI's Grok API.
+ *
+ * xAI exposes a fully OpenAI-compatible `/v1/chat/completions` endpoint at
+ * `https://api.x.ai`. This provider delegates to the existing {@link OpenAIProvider}
+ * with xAI's base URL and credentials, providing xAI-specific provider identity
+ * and a curated catalog of Grok models.
+ *
+ * @module backend/agentos/core/llm/providers/implementations/XAIProvider
+ * @implements {IProvider}
+ */
+import { IProvider, ChatMessage, ModelCompletionOptions, ModelCompletionResponse, ModelInfo, ProviderEmbeddingOptions, ProviderEmbeddingResponse } from '../IProvider';
+/**
+ * Configuration for the XAIProvider.
+ *
+ * @example
+ * const config: XAIProviderConfig = {
+ *   apiKey: process.env.XAI_API_KEY!,
+ *   defaultModelId: 'grok-2',
+ * };
+ */
+export interface XAIProviderConfig {
+    /** xAI API key. Sourced from `XAI_API_KEY`. */
+    apiKey: string;
+    /**
+     * Base URL override.
+     * @default "https://api.x.ai/v1"
+     */
+    baseURL?: string;
+    /**
+     * Default model to use when none is specified.
+     * @default "grok-2"
+     */
+    defaultModelId?: string;
+    /** Request timeout in milliseconds. @default 60000 */
+    requestTimeout?: number;
+}
+/**
+ * @class XAIProvider
+ * @implements {IProvider}
+ *
+ * Thin wrapper around {@link OpenAIProvider} that targets xAI's
+ * OpenAI-compatible Grok API endpoint. xAI's Grok models are known for
+ * wit, real-time knowledge, and strong reasoning capabilities.
+ *
+ * @example
+ * const xai = new XAIProvider();
+ * await xai.initialize({ apiKey: process.env.XAI_API_KEY! });
+ * const res = await xai.generateCompletion('grok-2', messages, {});
+ */
+export declare class XAIProvider implements IProvider {
+    /** @inheritdoc */
+    readonly providerId: string;
+    /** @inheritdoc */
+    isInitialized: boolean;
+    /** @inheritdoc */
+    defaultModelId?: string;
+    /**
+     * Internal OpenAI provider instance that handles the actual API communication.
+     * xAI's API is fully OpenAI-compatible, so we reuse the OpenAI transport layer.
+     */
+    private delegate;
+    constructor();
+    /**
+     * Initializes the provider by configuring the underlying OpenAI delegate
+     * with xAI's base URL and the caller's API key.
+     *
+     * @param {XAIProviderConfig} config - xAI-specific configuration.
+     * @returns {Promise<void>}
+     * @throws {Error} If the API key is missing.
+     */
+    initialize(config: XAIProviderConfig): Promise<void>;
+    /** @inheritdoc */
+    generateCompletion(modelId: string, messages: ChatMessage[], options: ModelCompletionOptions): Promise<ModelCompletionResponse>;
+    /** @inheritdoc */
+    generateCompletionStream(modelId: string, messages: ChatMessage[], options: ModelCompletionOptions): AsyncGenerator<ModelCompletionResponse, void, undefined>;
+    /**
+     * xAI does not currently offer an embeddings API.
+     *
+     * @throws {Error} Always — embeddings are not supported on xAI.
+     */
+    generateEmbeddings(_modelId: string, _texts: string[], _options?: ProviderEmbeddingOptions): Promise<ProviderEmbeddingResponse>;
+    /**
+     * Returns a static catalog of known xAI Grok models.
+     *
+     * @param {{ capability?: string }} [filter] - Optional capability filter.
+     * @returns {Promise<ModelInfo[]>} xAI model catalog.
+     */
+    listAvailableModels(filter?: {
+        capability?: string;
+    }): Promise<ModelInfo[]>;
+    /** @inheritdoc */
+    getModelInfo(modelId: string): Promise<ModelInfo | undefined>;
+    /** @inheritdoc */
+    checkHealth(): Promise<{
+        isHealthy: boolean;
+        details?: unknown;
+    }>;
+    /** @inheritdoc */
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=XAIProvider.d.ts.map

package/dist/core/llm/providers/implementations/XAIProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"XAIProvider.d.ts","sourceRoot":"","sources":["../../../../../src/core/llm/providers/implementations/XAIProvider.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAEH,OAAO,EACL,SAAS,EACT,WAAW,EACX,sBAAsB,EACtB,uBAAuB,EACvB,SAAS,EACT,wBAAwB,EACxB,yBAAyB,EAC1B,MAAM,cAAc,CAAC;AAOtB;;;;;;;;GAQG;AACH,MAAM,WAAW,iBAAiB;IAChC,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sDAAsD;IACtD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAkCD;;;;;;;;;;;;GAYG;AACH,qBAAa,WAAY,YAAW,SAAS;IAC3C,kBAAkB;IAClB,SAAgB,UAAU,EAAE,MAAM,CAAS;IAC3C,kBAAkB;IACX,aAAa,EAAE,OAAO,CAAS;IACtC,kBAAkB;IACX,cAAc,CAAC,EAAE,MAAM,CAAC;IAE/B;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAwB;;IAIxC;;;;;;;OAOG;IACU,UAAU,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBjE,kBAAkB;IACL,kBAAkB,CAC7B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,WAAW,EAAE,EACvB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,uBAAuB,CAAC;IAInC,kBAAkB;IACJ,wBAAwB,CACpC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,WAAW,EAAE,EACvB,OAAO,EAAE,sBAAsB,GAC9B,cAAc,CAAC,uBAAuB,EAAE,IAAI,EAAE,SAAS,CAAC;IAI3D;;;;OAIG;IACU,kBAAkB,CAC7B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EAAE,EAChB,QAAQ,CAAC,EAAE,wBAAwB,GAClC,OAAO,CAAC,yBAAyB,CAAC;IAIrC;;;;;OAKG;IACU,mBAAmB,CAAC,MAAM,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAOxF,kBAAkB;IACL,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC;IAI1E,kBAAkB;IACL,WAAW,IAAI,OAAO,CAAC;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAI9E,kBAAkB;IACL,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAKvC"}

package/dist/core/llm/providers/implementations/XAIProvider.js

@@ -0,0 +1,123 @@
+// File: backend/agentos/core/llm/providers/implementations/XAIProvider.ts
+import { OpenAIProvider } from './OpenAIProvider.js';
+// ---------------------------------------------------------------------------
+// Known model catalog
+// ---------------------------------------------------------------------------
+/** Static catalog of well-known xAI Grok models. */
+const XAI_MODELS = [
+    {
+        modelId: 'grok-2',
+        providerId: 'xai',
+        displayName: 'Grok 2',
+        description: 'xAI flagship model with strong reasoning and real-time knowledge.',
+        capabilities: ['chat', 'tool_use'],
+        contextWindowSize: 131072,
+        supportsStreaming: true,
+        status: 'active',
+    },
+    {
+        modelId: 'grok-2-mini',
+        providerId: 'xai',
+        displayName: 'Grok 2 Mini',
+        description: 'Smaller, faster xAI model for cost-effective everyday tasks.',
+        capabilities: ['chat', 'tool_use'],
+        contextWindowSize: 131072,
+        supportsStreaming: true,
+        status: 'active',
+    },
+];
+// ---------------------------------------------------------------------------
+// Provider implementation
+// ---------------------------------------------------------------------------
+/**
+ * @class XAIProvider
+ * @implements {IProvider}
+ *
+ * Thin wrapper around {@link OpenAIProvider} that targets xAI's
+ * OpenAI-compatible Grok API endpoint. xAI's Grok models are known for
+ * wit, real-time knowledge, and strong reasoning capabilities.
+ *
+ * @example
+ * const xai = new XAIProvider();
+ * await xai.initialize({ apiKey: process.env.XAI_API_KEY! });
+ * const res = await xai.generateCompletion('grok-2', messages, {});
+ */
+export class XAIProvider {
+    constructor() {
+        /** @inheritdoc */
+        this.providerId = 'xai';
+        /** @inheritdoc */
+        this.isInitialized = false;
+        /**
+         * Internal OpenAI provider instance that handles the actual API communication.
+         * xAI's API is fully OpenAI-compatible, so we reuse the OpenAI transport layer.
+         */
+        this.delegate = new OpenAIProvider();
+    }
+    /**
+     * Initializes the provider by configuring the underlying OpenAI delegate
+     * with xAI's base URL and the caller's API key.
+     *
+     * @param {XAIProviderConfig} config - xAI-specific configuration.
+     * @returns {Promise<void>}
+     * @throws {Error} If the API key is missing.
+     */
+    async initialize(config) {
+        if (!config.apiKey) {
+            throw new Error('API key is required for XAIProvider. Set XAI_API_KEY.');
+        }
+        this.defaultModelId = config.defaultModelId ?? 'grok-2';
+        // Delegate to OpenAI provider with xAI's endpoint
+        await this.delegate.initialize({
+            apiKey: config.apiKey,
+            baseURL: config.baseURL ?? 'https://api.x.ai/v1',
+            defaultModelId: this.defaultModelId,
+            requestTimeout: config.requestTimeout ?? 60000,
+        });
+        this.isInitialized = true;
+        console.log(`XAIProvider initialized. Default model: ${this.defaultModelId}.`);
+    }
+    /** @inheritdoc */
+    async generateCompletion(modelId, messages, options) {
+        return this.delegate.generateCompletion(modelId, messages, options);
+    }
+    /** @inheritdoc */
+    async *generateCompletionStream(modelId, messages, options) {
+        yield* this.delegate.generateCompletionStream(modelId, messages, options);
+    }
+    /**
+     * xAI does not currently offer an embeddings API.
+     *
+     * @throws {Error} Always — embeddings are not supported on xAI.
+     */
+    async generateEmbeddings(_modelId, _texts, _options) {
+        throw new Error('xAI does not currently support embeddings. Use a dedicated embedding provider.');
+    }
+    /**
+     * Returns a static catalog of known xAI Grok models.
+     *
+     * @param {{ capability?: string }} [filter] - Optional capability filter.
+     * @returns {Promise<ModelInfo[]>} xAI model catalog.
+     */
+    async listAvailableModels(filter) {
+        if (filter?.capability) {
+            return XAI_MODELS.filter(m => m.capabilities.includes(filter.capability));
+        }
+        return [...XAI_MODELS];
+    }
+    /** @inheritdoc */
+    async getModelInfo(modelId) {
+        return XAI_MODELS.find(m => m.modelId === modelId);
+    }
+    /** @inheritdoc */
+    async checkHealth() {
+        return this.delegate.checkHealth();
+    }
+    /** @inheritdoc */
+    async shutdown() {
+        await this.delegate.shutdown();
+        this.isInitialized = false;
+        console.log('XAIProvider shutdown complete.');
+    }
+}
+//# sourceMappingURL=XAIProvider.js.map

package/dist/core/llm/providers/implementations/XAIProvider.js.map

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

package/dist/core/orchestration/AgentOrchestrator.d.ts.map

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

package/dist/core/orchestration/AgentOrchestrator.js

@@ -149,7 +149,13 @@ export class AgentOSOrchestrator {
                 chunk = { ...baseChunk, message: data.message, progressPercentage: data.progressPercentage, statusCode: data.statusCode };
                 break;
             case AgentOSResponseChunkType.TOOL_CALL_REQUEST:
-                chunk = { ...baseChunk, toolCalls: data.toolCalls, rationale: data.rationale };
+                chunk = {
+                    ...baseChunk,
+                    toolCalls: data.toolCalls,
+                    rationale: data.rationale,
+                    executionMode: data.executionMode,
+                    requiresExternalToolResult: data.requiresExternalToolResult,
+                };
                 break;
             case AgentOSResponseChunkType.TOOL_RESULT_EMISSION:
                 chunk = { ...baseChunk, toolCallId: data.toolCallId, toolName: data.toolName, toolResult: data.toolResult, isSuccess: data.isSuccess, errorMessage: data.errorMessage };
@@ -272,7 +278,7 @@ export class AgentOSOrchestrator {
      * @param {string} activePersonaId - The definitive ID of the persona resolved for this turn. Guaranteed to be a string by caller.
      * @returns {GMITurnInput} The structured input object ready for the GMI.
      */
-    constructGMITurnInput(agentOSStreamId, agentOSInput, activePersonaId) {
+    constructGMITurnInput(agentOSStreamId, agentOSInput, activePersonaId, conversationId) {
         const { userId, sessionId, options, textInput, visionInputs, audioInput, userFeedback, selectedPersonaId, userApiKeys } = agentOSInput;
         const gmiInputMetadata = {
             options: {
@@ -285,6 +291,8 @@ export class AgentOSOrchestrator {
                 toolChoice: options?.toolChoice,
                 responseFormat: options?.responseFormat,
             },
+            sessionId,
+            conversationId,
             userApiKeys,
             userFeedback,
             explicitPersonaSwitchId: selectedPersonaId !== activePersonaId ? selectedPersonaId : undefined,
@@ -367,7 +375,7 @@ export class AgentOSOrchestrator {
             };
             this.activeStreamContexts.set(agentOSStreamId, activeStreamCtx);
             await this.pushChunkToStream(agentOSStreamId, AgentOSResponseChunkType.SYSTEM_PROGRESS, gmiInstanceIdForChunks, activePersonaId, false, { message: `Persona ${activePersonaId} ready. GMI Instance: ${gmiInstanceIdForChunks}`, progressPercentage: 10 });
-            const gmiTurnInput = this.constructGMITurnInput(agentOSStreamId, input, activePersonaId);
+            const gmiTurnInput = this.constructGMITurnInput(agentOSStreamId, input, activePersonaId, conversationContext.sessionId);
             // --- Org context + long-term memory policy (persisted per conversation) ---
             if (conversationContext) {
                 const inboundOrg = typeof input.organizationId === 'string' ? input.organizationId.trim() : '';
@@ -763,7 +771,12 @@ export class AgentOSOrchestrator {
             const gmiOutputAfterTool = await gmi.handleToolResult(toolCallId, toolName, toolResultPayload, userId, userApiKeys || {});
             await this.processGMIOutput(agentOSStreamId, streamContext, gmiOutputAfterTool, true);
             if (gmiOutputAfterTool.toolCalls && gmiOutputAfterTool.toolCalls.length > 0 && !gmiOutputAfterTool.isFinal) {
-                await this.pushChunkToStream(agentOSStreamId, AgentOSResponseChunkType.TOOL_CALL_REQUEST, gmiInstanceIdForChunks, personaId, false, { toolCalls: gmiOutputAfterTool.toolCalls, rationale: gmiOutputAfterTool.responseText || "Agent requires further tool execution based on previous tool's result." });
+                await this.pushChunkToStream(agentOSStreamId, AgentOSResponseChunkType.TOOL_CALL_REQUEST, gmiInstanceIdForChunks, personaId, false, {
+                    toolCalls: gmiOutputAfterTool.toolCalls,
+                    rationale: gmiOutputAfterTool.responseText || "Agent requires further tool execution based on previous tool's result.",
+                    executionMode: 'external',
+                    requiresExternalToolResult: true,
+                });
             }
             else if (gmiOutputAfterTool.isFinal) {
                 console.log(`AgentOSOrchestrator (Stream: ${agentOSStreamId}): GMI interaction concluded as final after tool result processing.`);
@@ -882,8 +895,16 @@ export class AgentOSOrchestrator {
                 if (gmiChunk.content && Array.isArray(gmiChunk.content) && gmiChunk.content.length > 0) {
                     const toolCalls = gmiChunk.content;
                     const rationale = gmiChunk.metadata?.rationale || "Agent is considering using tools.";
+                    const executionMode = gmiChunk.metadata?.executionMode === 'external' ? 'external' : 'internal';
                     await this.pushChunkToStream(agentOSStreamId, AgentOSResponseChunkType.TOOL_CALL_REQUEST, gmiInstanceIdForChunks, personaId, false, // Tool call requests are typically not final for the turn
-                    { toolCalls, rationale });
+                    {
+                        toolCalls,
+                        rationale,
+                        executionMode,
+                        requiresExternalToolResult: typeof gmiChunk.metadata?.requiresExternalToolResult === 'boolean'
+                            ? gmiChunk.metadata.requiresExternalToolResult
+                            : executionMode === 'external',
+                    });
                 }
                 break;
             }