@sudobility/shapeshyft_engine 1.0.0

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

@@ -0,0 +1,110 @@
+/**
+ * @fileoverview LLM provider type definitions
+ * @description Core types for the LLM provider system including request/response
+ * types, the provider interface, and cost estimation re-exports.
+ */
+import type { FinishReason, JsonSchema, LlmProvider, MediaContent, GeneratedMedia } from "../../types/index.js";
+export type { MediaContent, GeneratedMedia, LlmProvider };
+export { estimateCost, formatCost, formatCostPerMillion, } from "../../types/index.js";
+export type { ModelPricing } from "../../types/index.js";
+export { getModelPricing } from "../../config/providers.js";
+/**
+ * Base request fields shared by all variants
+ */
+interface LLMRequestBase {
+    prompt: string;
+    systemPrompt?: string;
+    outputSchema: JsonSchema;
+    model?: string;
+    temperature?: number;
+    maxTokens?: number;
+    /** Input media (images, audio, video) */
+    media?: MediaContent[];
+    /** What media types this endpoint generates */
+    expectsMediaOutput?: {
+        image?: boolean;
+        audio?: boolean;
+        video?: boolean;
+    };
+    /** Enable web search (OpenAI Responses API) */
+    webSearch?: boolean;
+    /** For Whisper: model to use for structured extraction from transcription */
+    extractionModel?: string;
+    /** For Whisper: API key for the extraction model's provider */
+    extractionApiKey?: string;
+}
+/**
+ * Request variant when outputMediaFormat is "url" - entityId is REQUIRED
+ */
+interface LLMRequestWithUrlOutput extends LLMRequestBase {
+    outputMediaFormat: "url";
+    entityId: string;
+}
+/**
+ * Request variant when outputMediaFormat is "base64" or undefined - entityId is optional
+ */
+interface LLMRequestWithBase64Output extends LLMRequestBase {
+    outputMediaFormat?: "base64";
+    entityId?: string;
+}
+/**
+ * Discriminated union ensures entityId is required when outputMediaFormat === "url"
+ */
+export type LLMRequest = LLMRequestWithUrlOutput | LLMRequestWithBase64Output;
+/**
+ * Type guard for URL output requests
+ */
+export declare function requiresEntityId(request: LLMRequest): request is LLMRequestWithUrlOutput;
+/**
+ * Response from an LLM provider
+ */
+export interface LLMResponse {
+    content: unknown;
+    rawResponse: string;
+    usage: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+    model: string;
+    provider: LlmProvider;
+    latencyMs: number;
+    /**
+     * Why the model stopped, normalized across providers. `"length"` means the
+     * output ceiling was hit and `content` is truncated. Undefined when the
+     * provider reported nothing usable.
+     */
+    finishReason?: FinishReason;
+    /** Generated media (images, audio, video) from generative models */
+    generatedMedia?: GeneratedMedia[];
+}
+/**
+ * Provider configuration
+ */
+export interface ProviderConfig {
+    apiKey?: string;
+    endpointUrl?: string;
+    model?: string;
+    /**
+     * Wall-clock ceiling for one provider call, in milliseconds. Only the custom
+     * (LM Studio) provider honours it today; its default is ten minutes. The
+     * caller supplies it -- in the API shells, from LM_STUDIO_TIMEOUT_MS.
+     */
+    timeoutMs?: number;
+}
+/**
+ * LLM Provider interface
+ */
+export interface ILLMProvider {
+    readonly providerName: LlmProvider;
+    /**
+     * Generate a structured response from the LLM
+     */
+    generate(request: LLMRequest): Promise<LLMResponse>;
+    /**
+     * Build the API payload without calling the LLM
+     * Used for Type 3 and Type 4 endpoints
+     */
+    buildApiPayload(request: LLMRequest): Record<string, unknown>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/llm/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,UAAU,EACV,WAAW,EACX,YAAY,EACZ,cAAc,EACf,MAAM,sBAAsB,CAAC;AAG9B,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,CAAC;AAG1D,OAAO,EACL,YAAY,EACZ,UAAU,EACV,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGzD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAM5D;;GAEG;AACH,UAAU,cAAc;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,UAAU,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,KAAK,CAAC,EAAE,YAAY,EAAE,CAAC;IACvB,+CAA+C;IAC/C,kBAAkB,CAAC,EAAE;QACnB,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB,CAAC;IACF,+CAA+C;IAC/C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,6EAA6E;IAC7E,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,+DAA+D;IAC/D,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,UAAU,uBAAwB,SAAQ,cAAc;IACtD,iBAAiB,EAAE,KAAK,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,UAAU,0BAA2B,SAAQ,cAAc;IACzD,iBAAiB,CAAC,EAAE,QAAQ,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,uBAAuB,GAAG,0BAA0B,CAAC;AAE9E;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,UAAU,GAClB,OAAO,IAAI,uBAAuB,CAEpC;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE;QACL,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;QACzB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,WAAW,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,oEAAoE;IACpE,cAAc,CAAC,EAAE,cAAc,EAAE,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC;IAEnC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAEpD;;;OAGG;IACH,eAAe,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/D"}

package/dist/services/llm/types.js

@@ -0,0 +1,16 @@
+/**
+ * @fileoverview LLM provider type definitions
+ * @description Core types for the LLM provider system including request/response
+ * types, the provider interface, and cost estimation re-exports.
+ */
+// Re-export cost estimation functions from types package
+export { estimateCost, formatCost, formatCostPerMillion, } from "../../types/index.js";
+// Re-export getModelPricing from local providers config (data is now server-side)
+export { getModelPricing } from "../../config/providers.js";
+/**
+ * Type guard for URL output requests
+ */
+export function requiresEntityId(request) {
+    return request.outputMediaFormat === "url";
+}
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/services/llm/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAaH,yDAAyD;AACzD,OAAO,EACL,YAAY,EACZ,UAAU,EACV,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAG9B,kFAAkF;AAClF,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAqD5D;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAAmB;IAEnB,OAAO,OAAO,CAAC,iBAAiB,KAAK,KAAK,CAAC;AAC7C,CAAC"}