@sudobility/shapeshyft_engine 1.0.0

package/dist/services/llm/groq.js.map

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

package/dist/services/llm/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @fileoverview LLM provider factory and exports
+ * @description Creates the appropriate LLM provider instance based on provider type.
+ * OpenAI-compatible providers (Mistral, xAI, DeepSeek, Perplexity, Cohere) reuse
+ * the OpenAIProvider class. Groq has a dedicated provider for Whisper transcription.
+ */
+import type { LlmProvider } from "../../types/index.js";
+import type { ILLMProvider, ProviderConfig } from "./types.js";
+export type { ILLMProvider, LLMRequest, LLMResponse, ProviderConfig, } from "./types.js";
+export { estimateCost, getModelPricing } from "./types.js";
+/**
+ * Create an LLM provider instance based on provider type
+ */
+export declare function createLLMProvider(providerType: LlmProvider, config: ProviderConfig): ILLMProvider;
+/**
+ * Provider endpoint hints for Type 3/4 endpoints
+ */
+export declare const PROVIDER_ENDPOINTS: Record<LlmProvider, string>;
+//# sourceMappingURL=index.d.ts.map

package/dist/services/llm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/llm/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAO/D,YAAY,EACV,YAAY,EACZ,UAAU,EACV,WAAW,EACX,cAAc,GACf,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE3D;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,WAAW,EACzB,MAAM,EAAE,cAAc,GACrB,YAAY,CAkDd;AAcD;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAY1D,CAAC"}

package/dist/services/llm/index.js

@@ -0,0 +1,88 @@
+/**
+ * @fileoverview LLM provider factory and exports
+ * @description Creates the appropriate LLM provider instance based on provider type.
+ * OpenAI-compatible providers (Mistral, xAI, DeepSeek, Perplexity, Cohere) reuse
+ * the OpenAIProvider class. Groq has a dedicated provider for Whisper transcription.
+ */
+import { OpenAIProvider } from "./openai.js";
+import { AnthropicProvider } from "./anthropic.js";
+import { GeminiProvider } from "./gemini.js";
+import { GroqProvider } from "./groq.js";
+import { CustomLLMProvider } from "./custom.js";
+export { estimateCost, getModelPricing } from "./types.js";
+/**
+ * Create an LLM provider instance based on provider type
+ */
+export function createLLMProvider(providerType, config) {
+    switch (providerType) {
+        case "openai":
+            // The only caller that is OpenAI itself: its newer models name the output
+            // cap `max_completion_tokens`, which the compatible providers do not know.
+            return new OpenAIProvider(config, { isOpenAi: true });
+        case "anthropic":
+            return new AnthropicProvider(config);
+        case "gemini":
+            return new GeminiProvider(config);
+        case "groq":
+            return new GroqProvider(config); // Groq has dedicated provider for Whisper
+        // Providers with OpenAI-compatible API format. Supply the provider's own
+        // base URL so requests don't fall through to api.openai.com.
+        case "mistral":
+        case "xai":
+        case "perplexity":
+            return new OpenAIProvider({
+                ...config,
+                endpointUrl: config.endpointUrl ?? OPENAI_COMPATIBLE_BASE_URLS[providerType],
+            });
+        /*
+          DeepSeek V4 reasons by default, and thinking mode rejects `tool_choice`.
+    
+          Turning thinking off restores function calling — and is the right trade
+          anyway: measured on the same two-bar plan, 844 output tokens and 8.6s
+          with thinking against 126 tokens and 2.4s without, for an answer of the
+          same size. The reasoning is discarded, so it was working the caller paid
+          for and never saw.
+        */
+        case "deepseek":
+            return new OpenAIProvider({
+                ...config,
+                endpointUrl: config.endpointUrl ?? OPENAI_COMPATIBLE_BASE_URLS[providerType],
+            }, { disableThinking: true });
+        // NOTE: Cohere's API is NOT OpenAI-compatible (different request/response
+        // shape); routing it through OpenAIProvider will not work regardless of base
+        // URL. It needs a dedicated provider — left as-is to avoid changing behavior.
+        case "cohere":
+            return new OpenAIProvider(config);
+        case "lm_studio":
+            return new CustomLLMProvider(config);
+        default:
+            throw new Error(`Unknown provider type: ${providerType}`);
+    }
+}
+/**
+ * OpenAI-SDK base URLs for OpenAI-compatible providers (no /chat/completions —
+ * the SDK appends the path). Used by the factory so these providers reach their
+ * own API rather than api.openai.com.
+ */
+const OPENAI_COMPATIBLE_BASE_URLS = {
+    mistral: "https://api.mistral.ai/v1",
+    xai: "https://api.x.ai/v1",
+    deepseek: "https://api.deepseek.com/v1",
+    perplexity: "https://api.perplexity.ai",
+};
+/**
+ * Provider endpoint hints for Type 3/4 endpoints
+ */
+export const PROVIDER_ENDPOINTS = {
+    openai: "https://api.openai.com/v1/chat/completions",
+    anthropic: "https://api.anthropic.com/v1/messages",
+    gemini: "https://generativelanguage.googleapis.com/v1beta/models/{model}:generateContent",
+    mistral: "https://api.mistral.ai/v1/chat/completions",
+    cohere: "https://api.cohere.ai/v1/chat",
+    groq: "https://api.groq.com/openai/v1/chat/completions",
+    xai: "https://api.x.ai/v1/chat/completions",
+    deepseek: "https://api.deepseek.com/v1/chat/completions",
+    perplexity: "https://api.perplexity.ai/chat/completions",
+    lm_studio: "{custom_endpoint}",
+};
+//# sourceMappingURL=index.js.map

package/dist/services/llm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/llm/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAQhD,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE3D;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,YAAyB,EACzB,MAAsB;IAEtB,QAAQ,YAAY,EAAE,CAAC;QACrB,KAAK,QAAQ;YACX,0EAA0E;YAC1E,2EAA2E;YAC3E,OAAO,IAAI,cAAc,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QACxD,KAAK,WAAW;YACd,OAAO,IAAI,iBAAiB,CAAC,MAAM,CAAC,CAAC;QACvC,KAAK,QAAQ;YACX,OAAO,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;QACpC,KAAK,MAAM;YACT,OAAO,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,0CAA0C;QAC7E,yEAAyE;QACzE,6DAA6D;QAC7D,KAAK,SAAS,CAAC;QACf,KAAK,KAAK,CAAC;QACX,KAAK,YAAY;YACf,OAAO,IAAI,cAAc,CAAC;gBACxB,GAAG,MAAM;gBACT,WAAW,EACT,MAAM,CAAC,WAAW,IAAI,2BAA2B,CAAC,YAAY,CAAC;aAClE,CAAC,CAAC;QACL;;;;;;;;UAQE;QACF,KAAK,UAAU;YACb,OAAO,IAAI,cAAc,CACvB;gBACE,GAAG,MAAM;gBACT,WAAW,EACT,MAAM,CAAC,WAAW,IAAI,2BAA2B,CAAC,YAAY,CAAC;aAClE,EACD,EAAE,eAAe,EAAE,IAAI,EAAE,CAC1B,CAAC;QACJ,0EAA0E;QAC1E,6EAA6E;QAC7E,8EAA8E;QAC9E,KAAK,QAAQ;YACX,OAAO,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;QACpC,KAAK,WAAW;YACd,OAAO,IAAI,iBAAiB,CAAC,MAAM,CAAC,CAAC;QACvC;YACE,MAAM,IAAI,KAAK,CAAC,0BAA0B,YAAY,EAAE,CAAC,CAAC;IAC9D,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,2BAA2B,GAAyC;IACxE,OAAO,EAAE,2BAA2B;IACpC,GAAG,EAAE,qBAAqB;IAC1B,QAAQ,EAAE,6BAA6B;IACvC,UAAU,EAAE,2BAA2B;CACxC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAgC;IAC7D,MAAM,EAAE,4CAA4C;IACpD,SAAS,EAAE,uCAAuC;IAClD,MAAM,EACJ,iFAAiF;IACnF,OAAO,EAAE,4CAA4C;IACrD,MAAM,EAAE,+BAA+B;IACvC,IAAI,EAAE,iDAAiD;IACvD,GAAG,EAAE,sCAAsC;IAC3C,QAAQ,EAAE,8CAA8C;IACxD,UAAU,EAAE,4CAA4C;IACxD,SAAS,EAAE,mBAAmB;CAC/B,CAAC"}

package/dist/services/llm/openai.d.ts

@@ -0,0 +1,101 @@
+/**
+ * @fileoverview OpenAI LLM provider
+ * @description Implements the ILLMProvider interface for OpenAI models.
+ * Also used by Mistral, xAI, DeepSeek, Perplexity, and Cohere
+ * (OpenAI-compatible APIs). Supports function calling for structured output,
+ * multimodal input (images, audio), and audio output generation.
+ */
+import { type ILLMProvider, type LLMRequest, type LLMResponse, type ProviderConfig } from "./types.js";
+/**
+ * What a provider calls its cap on generated tokens.
+ *
+ * OpenAI's own newer models reject `max_tokens` outright —
+ * "Unsupported parameter: 'max_tokens' is not supported with this model. Use
+ * 'max_completion_tokens' instead" — while the OpenAI-*compatible* third
+ * parties served by this same class (DeepSeek, Mistral, xAI, Perplexity) know
+ * only `max_tokens`. One class, two vocabularies, so the caller says which.
+ */
+export type TokenLimitParam = "max_tokens" | "max_completion_tokens";
+/**
+ * What to call the output cap for this provider and model.
+ *
+ * Both halves matter. The provider decides the vocabulary available; the model
+ * decides which of it applies, and the model is chosen per endpoint rather than
+ * per provider — so this cannot be settled when the client is constructed.
+ */
+export declare function tokenLimitParamFor(isOpenAi: boolean, model: string): TokenLimitParam;
+export declare class OpenAIProvider implements ILLMProvider {
+    readonly providerName: "openai";
+    private client;
+    private defaultModel;
+    private disableThinking;
+    /** Whether this client talks to OpenAI itself, or an OpenAI-compatible third party. */
+    private isOpenAi;
+    constructor(config: ProviderConfig, 
+    /**
+     * Per-provider quirks. Defaults keep every provider that works today
+     * working; only one known to need otherwise opts out.
+     */
+    options?: {
+        /**
+         * Turn the model's chain of thought off.
+         *
+         * DeepSeek V4 reasons by default, and that is measurably the wrong
+         * trade here: the same two-bar plan cost 844 output tokens and 8.6s
+         * thinking, against 126 tokens and 2.4s with it off — and the reasoning
+         * is discarded, so the caller pays for working it never sees. Worse,
+         * thinking mode *rejects* `tool_choice`, so leaving it on also costs the
+         * structured-output guarantee.
+         *
+         * Sent as DeepSeek's native `thinking` object. Its type error on a
+         * boolean — "thinking: invalid type: boolean `false`, expected .." — is
+         * what identified the parameter.
+         */
+        disableThinking?: boolean;
+        /**
+         * True for OpenAI itself. The OpenAI-compatible providers served by this
+         * same class (DeepSeek, Mistral, xAI, Perplexity, Cohere) are not, and
+         * only know `max_tokens`.
+         */
+        isOpenAi?: boolean;
+    });
+    generate(request: LLMRequest): Promise<LLMResponse>;
+    /**
+     * Generate using the OpenAI Responses API with web search enabled.
+     * The model can search the web and then call the structured_response function.
+     */
+    private static INPUT_LAYOUTS;
+    /** Check if a renderable tree contains input controls (clarification). */
+    private containsInputControls;
+    /**
+     * Wrap the user's output schema in a container that lets the AI signal
+     * whether it needs a web search before it can answer.
+     */
+    private buildTriageSchema;
+    /**
+     * Build the system prompt for step 1: try to answer fully, signal
+     * web_search_needed only if real-time data is genuinely required.
+     */
+    /**
+     * Call the Responses API with a forced function call.
+     * Used for both the triage step and the structuring step.
+     */
+    private callResponsesStructured;
+    /**
+     * Search the web via the Responses API and return a text summary.
+     */
+    private searchWeb;
+    /** Build Responses API input from an LLM request. */
+    private buildResponsesInput;
+    /**
+     * Main entry point when web search is enabled on the endpoint.
+     *
+     * 1. Try to answer via Responses API with triage wrapper schema.
+     *    AI provides full answer OR signals web_search_needed.
+     * 2. If no search needed → return user_data directly.
+     * 3. If search needed → web search → structure results.
+     */
+    private generateWithSearch;
+    buildApiPayload(request: LLMRequest): Record<string, unknown>;
+}
+//# sourceMappingURL=openai.d.ts.map

package/dist/services/llm/openai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../../src/services/llm/openai.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,cAAc,EACpB,MAAM,YAAY,CAAC;AAsBpB;;;;;;;;GAQG;AACH,MAAM,MAAM,eAAe,GAAG,YAAY,GAAG,uBAAuB,CAAC;AAgBrE;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,OAAO,EACjB,KAAK,EAAE,MAAM,GACZ,eAAe,CAIjB;AAED,qBAAa,cAAe,YAAW,YAAY;IACjD,QAAQ,CAAC,YAAY,EAAG,QAAQ,CAAU;IAC1C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,YAAY,CAAS;IAE7B,OAAO,CAAC,eAAe,CAAU;IAEjC,uFAAuF;IACvF,OAAO,CAAC,QAAQ,CAAU;gBAGxB,MAAM,EAAE,cAAc;IACtB;;;OAGG;IACH,OAAO,GAAE;QACP;;;;;;;;;;;;;WAaG;QACH,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B;;;;WAIG;QACH,QAAQ,CAAC,EAAE,OAAO,CAAC;KACf;IAgBF,QAAQ,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC;IA4LzD;;;OAGG;IAKH,OAAO,CAAC,MAAM,CAAC,aAAa,CAUzB;IAEH,0EAA0E;IAC1E,OAAO,CAAC,qBAAqB;IAa7B;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAsBzB;;;OAGG;IAEH;;;OAGG;YACW,uBAAuB;IAwErC;;OAEG;YACW,SAAS;IAoCvB,qDAAqD;IACrD,OAAO,CAAC,mBAAmB;IAgC3B;;;;;;;OAOG;YACW,kBAAkB;IAyJhC,eAAe,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CA4E9D"}