@futdevpro/fsm-dynamo 1.16.39 → 1.20.2

package/build/_modules/ai/_models/ai-call-settings.interface.js

@@ -1,82 +1,82 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DyFM_AI_CallSettings = void 0;
-/**
- * Agnostic LLM call settings — the provider-neutral tuning bag.
- *
- * The typed fields below are the common, broadly-supported knobs. The
- * `[key: string]: any` escape hatch carries provider/model-specific params
- * until they are first-classed.
- *
- * IMPORTANT — per-model variance (FR-048, reserved): NOT every model accepts
- * every field here, and sending an unsupported param can hard-fail the call
- * (e.g. Anthropic Opus 4.7+ rejects `temperature`/`topP`/`topK` with HTTP 400;
- * reasoning models take an extra `reasoningEffort`; pro models drop streaming).
- * This flat bag intentionally does NOT encode those constraints — the future
- * per-model settings system ({@link DyFM_AI_ModelSettingsSchema} on the model
- * registry + a reconciler in `DyNTS_AI_LLM_ServiceBase`) will validate, clamp,
- * and drop params against what each model actually accepts. Until then,
- * provider translators drop model-rejected params locally (see FR-047 Phase 4
- * Anthropic). Do not assume a field here is universally accepted.
- *
- * See: `__agent/feature-requests/FR-048-per-model-agnostic-settings.md`
- *      `fdp-documentations/guidelines/development/ai-per-model-settings.md`
- */
-class DyFM_AI_CallSettings {
-    systemPrompt = '';
-    useModel;
-    project;
-    debugLog;
-    /**
-     * This parameter controls the randomness and creativity of the generated output.
-     *
-     * Lower values (e.g., 0.2) produce more focused, predictable results,
-     * while higher values (e.g., 0.8) introduce more variation and unexpected outputs,
-     * making the model more creative and exploratory.
-     *
-     * Adjust this setting to balance between creativity and consistency.
-     */
-    temperature = 0;
-    /**
-     * Defines the upper limit of tokens (words or parts of words)
-     * the model can generate in a single response.
-     *
-     * The total token count includes both the input (prompt) and the output (response).
-     *
-     * You can allocate up to 4096 tokens per request, but be mindful of prompt length,
-     * as it affects how many tokens remain for the response.
-     */
-    maxTokens = 2000;
-    /**
-     * This parameter adjusts the diversity of the output using nucleus sampling,
-     * where the model considers tokens based on cumulative probability.
-     *
-     * A value of 0.5 ensures that only the most likely half of all possible tokens
-     * are considered, while increasing the value (up to 1)
-     * allows for a broader range of token options, leading to more varied responses.
-     */
-    topP = 0.75;
-    /**
-     * This setting penalizes tokens that have already appeared frequently in the generated text,
-     * discouraging repetition and encouraging the model to introduce new content.
-     *
-     * Higher values result in less repetition, making the output more diverse.
-     */
-    frequencyPenalty = 0;
-    /**
-     * This parameter influences the model by penalizing tokens based on
-     * their presence in the text so far.
-     *
-     * It encourages the introduction of new topics or ideas by reducing the likelihood of
-     * generating tokens that have already appeared,
-     * helping to keep the conversation or text more varied and engaging.
-     */
-    presencePenalty = 0;
-    constructor(set) {
-        if (set) {
-            Object.assign(this, set);
-        }
-    }
-}
-exports.DyFM_AI_CallSettings = DyFM_AI_CallSettings;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyFM_AI_CallSettings = void 0;
+/**
+ * Agnostic LLM call settings — the provider-neutral tuning bag.
+ *
+ * The typed fields below are the common, broadly-supported knobs. The
+ * `[key: string]: any` escape hatch carries provider/model-specific params
+ * until they are first-classed.
+ *
+ * IMPORTANT — per-model variance (FR-048, reserved): NOT every model accepts
+ * every field here, and sending an unsupported param can hard-fail the call
+ * (e.g. Anthropic Opus 4.7+ rejects `temperature`/`topP`/`topK` with HTTP 400;
+ * reasoning models take an extra `reasoningEffort`; pro models drop streaming).
+ * This flat bag intentionally does NOT encode those constraints — the future
+ * per-model settings system ({@link DyFM_AI_ModelSettingsSchema} on the model
+ * registry + a reconciler in `DyNTS_AI_LLM_ServiceBase`) will validate, clamp,
+ * and drop params against what each model actually accepts. Until then,
+ * provider translators drop model-rejected params locally (see FR-047 Phase 4
+ * Anthropic). Do not assume a field here is universally accepted.
+ *
+ * See: `__agent/feature-requests/FR-048-per-model-agnostic-settings.md`
+ *      `fdp-documentations/guidelines/development/ai-per-model-settings.md`
+ */
+class DyFM_AI_CallSettings {
+    systemPrompt = '';
+    useModel;
+    project;
+    debugLog;
+    /**
+     * This parameter controls the randomness and creativity of the generated output.
+     *
+     * Lower values (e.g., 0.2) produce more focused, predictable results,
+     * while higher values (e.g., 0.8) introduce more variation and unexpected outputs,
+     * making the model more creative and exploratory.
+     *
+     * Adjust this setting to balance between creativity and consistency.
+     */
+    temperature = 0;
+    /**
+     * Defines the upper limit of tokens (words or parts of words)
+     * the model can generate in a single response.
+     *
+     * The total token count includes both the input (prompt) and the output (response).
+     *
+     * You can allocate up to 4096 tokens per request, but be mindful of prompt length,
+     * as it affects how many tokens remain for the response.
+     */
+    maxTokens = 2000;
+    /**
+     * This parameter adjusts the diversity of the output using nucleus sampling,
+     * where the model considers tokens based on cumulative probability.
+     *
+     * A value of 0.5 ensures that only the most likely half of all possible tokens
+     * are considered, while increasing the value (up to 1)
+     * allows for a broader range of token options, leading to more varied responses.
+     */
+    topP = 0.75;
+    /**
+     * This setting penalizes tokens that have already appeared frequently in the generated text,
+     * discouraging repetition and encouraging the model to introduce new content.
+     *
+     * Higher values result in less repetition, making the output more diverse.
+     */
+    frequencyPenalty = 0;
+    /**
+     * This parameter influences the model by penalizing tokens based on
+     * their presence in the text so far.
+     *
+     * It encourages the introduction of new topics or ideas by reducing the likelihood of
+     * generating tokens that have already appeared,
+     * helping to keep the conversation or text more varied and engaging.
+     */
+    presencePenalty = 0;
+    constructor(set) {
+        if (set) {
+            Object.assign(this, set);
+        }
+    }
+}
+exports.DyFM_AI_CallSettings = DyFM_AI_CallSettings;
 //# sourceMappingURL=ai-call-settings.interface.js.map

package/build/_modules/ai/_models/ai-config.interface.d.ts

@@ -1,15 +1,15 @@
-export interface DyFM_AI_Config {
-    apiKey?: string;
-    organization?: string;
-    project?: string;
-    baseURL?: string;
-    timeout?: number;
-    httpAgent?: any;
-    fetch?: any;
-    maxRetries?: number;
-    defaultHeaders?: any;
-    defaultQuery?: any;
-    dangerouslyAllowBrowser?: boolean;
-    [key: string]: any;
-}
+export interface DyFM_AI_Config {
+    apiKey?: string;
+    organization?: string;
+    project?: string;
+    baseURL?: string;
+    timeout?: number;
+    httpAgent?: any;
+    fetch?: any;
+    maxRetries?: number;
+    defaultHeaders?: any;
+    defaultQuery?: any;
+    dangerouslyAllowBrowser?: boolean;
+    [key: string]: any;
+}
 //# sourceMappingURL=ai-config.interface.d.ts.map

package/build/_modules/ai/_models/ai-config.interface.js

@@ -1,3 +1,3 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
 //# sourceMappingURL=ai-config.interface.js.map

package/build/_modules/ai/_models/ai-embedding-request.interface.d.ts

@@ -1,20 +1,20 @@
-/**
- * Generic embedding request structure
- * Used by all AI providers for embedding operations
- */
-export interface DyFM_AI_Embedding_Request {
-    text: string;
-    model: string;
-    issuer: string;
-    debugLog?: boolean;
-}
-/**
- * Batch embedding request for multiple texts
- */
-export interface DyFM_AI_Embedding_Batch_Request {
-    texts: string[];
-    model: string;
-    issuer: string;
-    debugLog?: boolean;
-}
+/**
+ * Generic embedding request structure
+ * Used by all AI providers for embedding operations
+ */
+export interface DyFM_AI_Embedding_Request {
+    text: string;
+    model: string;
+    issuer: string;
+    debugLog?: boolean;
+}
+/**
+ * Batch embedding request for multiple texts
+ */
+export interface DyFM_AI_Embedding_Batch_Request {
+    texts: string[];
+    model: string;
+    issuer: string;
+    debugLog?: boolean;
+}
 //# sourceMappingURL=ai-embedding-request.interface.d.ts.map

package/build/_modules/ai/_models/ai-embedding-request.interface.js

@@ -1,3 +1,3 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
 //# sourceMappingURL=ai-embedding-request.interface.js.map

package/build/_modules/ai/_models/ai-embedding-response.interface.d.ts

@@ -1,26 +1,26 @@
-/**
- * Generic embedding response structure
- * Used by all AI providers for embedding operations
- */
-export interface DyFM_AI_Embedding_Response {
-    embedding: number[];
-    model: string;
-    usage?: {
-        promptTokens: number;
-        totalTokens: number;
-    };
-    rawResponse?: any;
-}
-/**
- * Batch embedding response for multiple texts
- */
-export interface DyFM_AI_Embedding_Batch_Response {
-    embeddings: number[][];
-    model: string;
-    usage?: {
-        promptTokens: number;
-        totalTokens: number;
-    };
-    rawResponse?: any;
-}
+/**
+ * Generic embedding response structure
+ * Used by all AI providers for embedding operations
+ */
+export interface DyFM_AI_Embedding_Response {
+    embedding: number[];
+    model: string;
+    usage?: {
+        promptTokens: number;
+        totalTokens: number;
+    };
+    rawResponse?: any;
+}
+/**
+ * Batch embedding response for multiple texts
+ */
+export interface DyFM_AI_Embedding_Batch_Response {
+    embeddings: number[][];
+    model: string;
+    usage?: {
+        promptTokens: number;
+        totalTokens: number;
+    };
+    rawResponse?: any;
+}
 //# sourceMappingURL=ai-embedding-response.interface.d.ts.map

package/build/_modules/ai/_models/ai-embedding-response.interface.js

@@ -1,3 +1,3 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
 //# sourceMappingURL=ai-embedding-response.interface.js.map

package/build/_modules/ai/_models/ai-llm-request.interface.d.ts

@@ -1,23 +1,23 @@
-import { DyFM_AI_Message } from './ai-message.interface';
-import { DyFM_AI_CallSettings } from './ai-call-settings.interface';
-/**
- * Generic LLM request structure
- * Used by all AI providers for LLM operations
- */
-export interface DyFM_AI_LLM_Request {
-    messages: DyFM_AI_Message[];
-    settings?: DyFM_AI_CallSettings;
-    issuer: string;
-    debugLog?: boolean;
-}
-/**
- * Simple LLM request with system and user messages
- */
-export interface DyFM_AI_LLM_Simple_Request {
-    systemMessage: string;
-    userMessage: string;
-    settings?: DyFM_AI_CallSettings;
-    issuer: string;
-    debugLog?: boolean;
-}
+import { DyFM_AI_Message } from './ai-message.interface';
+import { DyFM_AI_CallSettings } from './ai-call-settings.interface';
+/**
+ * Generic LLM request structure
+ * Used by all AI providers for LLM operations
+ */
+export interface DyFM_AI_LLM_Request {
+    messages: DyFM_AI_Message[];
+    settings?: DyFM_AI_CallSettings;
+    issuer: string;
+    debugLog?: boolean;
+}
+/**
+ * Simple LLM request with system and user messages
+ */
+export interface DyFM_AI_LLM_Simple_Request {
+    systemMessage: string;
+    userMessage: string;
+    settings?: DyFM_AI_CallSettings;
+    issuer: string;
+    debugLog?: boolean;
+}
 //# sourceMappingURL=ai-llm-request.interface.d.ts.map

package/build/_modules/ai/_models/ai-llm-request.interface.js

@@ -1,3 +1,3 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
 //# sourceMappingURL=ai-llm-request.interface.js.map

package/build/_modules/ai/_models/ai-llm-response.interface.d.ts

@@ -1,29 +1,29 @@
-import { DyFM_AI_Message } from './ai-message.interface';
-import { DyFM_AI_ToolCall } from './ai-tool-call.interface';
-/**
- * Generic LLM response structure
- * Used by all AI providers for LLM operations
- */
-export interface DyFM_AI_LLM_Response {
-    content: string;
-    usage?: {
-        promptTokens: number;
-        completionTokens: number;
-        totalTokens: number;
-    };
-    model?: string;
-    finishReason?: string;
-    /** Present when the model requested tool calls (function calling); normalized across providers. */
-    toolCalls?: DyFM_AI_ToolCall[];
-    /** Normalized stop reason (e.g. 'tool_use', 'stop', 'length'). */
-    stopReason?: string;
-    rawResponse?: any;
-}
-/**
- * Raw LLM response with full provider details
- */
-export interface DyFM_AI_LLM_Raw_Response extends DyFM_AI_LLM_Response {
-    messages: DyFM_AI_Message[];
-    rawResponse: any;
-}
+import { DyFM_AI_Message } from './ai-message.interface';
+import { DyFM_AI_ToolCall } from './ai-tool-call.interface';
+/**
+ * Generic LLM response structure
+ * Used by all AI providers for LLM operations
+ */
+export interface DyFM_AI_LLM_Response {
+    content: string;
+    usage?: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+    model?: string;
+    finishReason?: string;
+    /** Present when the model requested tool calls (function calling); normalized across providers. */
+    toolCalls?: DyFM_AI_ToolCall[];
+    /** Normalized stop reason (e.g. 'tool_use', 'stop', 'length'). */
+    stopReason?: string;
+    rawResponse?: any;
+}
+/**
+ * Raw LLM response with full provider details
+ */
+export interface DyFM_AI_LLM_Raw_Response extends DyFM_AI_LLM_Response {
+    messages: DyFM_AI_Message[];
+    rawResponse: any;
+}
 //# sourceMappingURL=ai-llm-response.interface.d.ts.map

package/build/_modules/ai/_models/ai-llm-response.interface.js

@@ -1,3 +1,3 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
 //# sourceMappingURL=ai-llm-response.interface.js.map

package/build/_modules/ai/_models/ai-message.interface.d.ts

@@ -1,11 +1,11 @@
-import { DyFM_AI_MessageRole } from '../_enums/ai-message-role.enum';
-import { DyFM_AI_ToolCall } from './ai-tool-call.interface';
-export interface DyFM_AI_Message {
-    role: DyFM_AI_MessageRole;
-    content: string;
-    /** Present on an assistant turn that requested tool calls (function calling). */
-    toolCalls?: DyFM_AI_ToolCall[];
-    /** Present on a `tool`-role message — which {@link DyFM_AI_ToolCall.id} this result answers. */
-    toolCallId?: string;
-}
+import { DyFM_AI_MessageRole } from '../_enums/ai-message-role.enum';
+import { DyFM_AI_ToolCall } from './ai-tool-call.interface';
+export interface DyFM_AI_Message {
+    role: DyFM_AI_MessageRole;
+    content: string;
+    /** Present on an assistant turn that requested tool calls (function calling). */
+    toolCalls?: DyFM_AI_ToolCall[];
+    /** Present on a `tool`-role message — which {@link DyFM_AI_ToolCall.id} this result answers. */
+    toolCallId?: string;
+}
 //# sourceMappingURL=ai-message.interface.d.ts.map

package/build/_modules/ai/_models/ai-message.interface.js

@@ -1,3 +1,3 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
 //# sourceMappingURL=ai-message.interface.js.map

package/build/_modules/ai/_models/ai-model-capabilities.interface.d.ts

@@ -1,36 +1,36 @@
-/**
- * Per-model capability flags.
- *
- * Where {@link DyFM_AI_ProviderCapabilities} describes what a PROVIDER can do
- * in aggregate, this describes what a single concrete MODEL supports. This is
- * the honest source of truth for feature-gating: e.g. an embedding model has
- * functionCalling=false, a reasoning chat model has functionCalling=true, a
- * local generic model may have functionCalling decided at runtime.
- */
-export interface DyFM_AI_ModelCapabilities {
-    /** Native function calling / tool use. The driver for the tool-calling feature. */
-    functionCalling: boolean;
-    /** Image input (vision). */
-    vision: boolean;
-    /** Streaming responses. */
-    streaming: boolean;
-    /** Structured output / JSON mode (OpenAI structured outputs, Gemini responseSchema, etc.). */
-    jsonMode: boolean;
-    /** Audio input (speech-to-text / audio understanding). */
-    audioInput: boolean;
-    /** Audio output (text-to-speech / speech generation). */
-    audioOutput: boolean;
-    /** Image generation (the model produces images). */
-    imageGeneration: boolean;
-    /** Embedding generation (vector output). */
-    embeddings: boolean;
-    /**
-     * Can generate adult / uncensored / NSFW content (no content-policy refusal on
-     * mature themes). Mainstream cloud models (OpenAI, Anthropic, Google) are filtered
-     * → false. Uncensored / local models may set true. Used for content-routing and
-     * age-gating (e.g. Adventor mature mode). For generic local models this is
-     * model-dependent — confirm per loaded model rather than assume.
-     */
-    adultContent: boolean;
-}
+/**
+ * Per-model capability flags.
+ *
+ * Where {@link DyFM_AI_ProviderCapabilities} describes what a PROVIDER can do
+ * in aggregate, this describes what a single concrete MODEL supports. This is
+ * the honest source of truth for feature-gating: e.g. an embedding model has
+ * functionCalling=false, a reasoning chat model has functionCalling=true, a
+ * local generic model may have functionCalling decided at runtime.
+ */
+export interface DyFM_AI_ModelCapabilities {
+    /** Native function calling / tool use. The driver for the tool-calling feature. */
+    functionCalling: boolean;
+    /** Image input (vision). */
+    vision: boolean;
+    /** Streaming responses. */
+    streaming: boolean;
+    /** Structured output / JSON mode (OpenAI structured outputs, Gemini responseSchema, etc.). */
+    jsonMode: boolean;
+    /** Audio input (speech-to-text / audio understanding). */
+    audioInput: boolean;
+    /** Audio output (text-to-speech / speech generation). */
+    audioOutput: boolean;
+    /** Image generation (the model produces images). */
+    imageGeneration: boolean;
+    /** Embedding generation (vector output). */
+    embeddings: boolean;
+    /**
+     * Can generate adult / uncensored / NSFW content (no content-policy refusal on
+     * mature themes). Mainstream cloud models (OpenAI, Anthropic, Google) are filtered
+     * → false. Uncensored / local models may set true. Used for content-routing and
+     * age-gating (e.g. Adventor mature mode). For generic local models this is
+     * model-dependent — confirm per loaded model rather than assume.
+     */
+    adultContent: boolean;
+}
 //# sourceMappingURL=ai-model-capabilities.interface.d.ts.map

package/build/_modules/ai/_models/ai-model-capabilities.interface.js

@@ -1,3 +1,3 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
 //# sourceMappingURL=ai-model-capabilities.interface.js.map