@futdevpro/fsm-dynamo 1.20.88 → 1.20.93

package/build-esm/_models/data-models/metadata.data-model.js

@@ -0,0 +1,120 @@
+/**
+ * This class is the base class for all data models.
+ * It contains the metadata for the data model.
+ *
+ * @example
+ * ```ts
+ * const metadata: DyFM_Metadata_DataModel = new DyFM_Metadata_DataModel({
+ *   _id: '123',
+ * });
+ * ```
+ */
+export class DyFM_Metadata_DataModel {
+    _id;
+    __created;
+    __createdBy;
+    __lastModified;
+    __lastModifiedBy;
+    __v;
+    _deleted;
+    _deletedBy;
+    _archived;
+    //_archivedBy?: string;
+    //_archiveId?: string;
+    _originalId;
+    constructor(set, init) {
+        // a metadata-init logika a statikus applyMetadata-ban el — igy a `DyFM_Error extends Error`
+        // (ami NEM tudja super()-rel hivni ezt a constructort) ugyanezt a target-en futtathatja.
+        DyFM_Metadata_DataModel.applyMetadata(this, set, init);
+    }
+    /**
+     * Applies the metadata fields onto a target object.
+     *
+     * Kiemelt statikus a constructor-torzsbol: a viselkedes BIT-RE azonos a korabbi
+     * constructorral, de igy a `DyFM_Error extends Error implements DyFM_Metadata_DataModel` is meg
+     * tudja hivni (az Error-bol orokolt osztaly nem tud `super(set, init)`-tel a
+     * DyFM_Metadata_DataModel constructorba lepni, ezert target-alapon kell elerni az init-logikat).
+     *
+     * @param target - The object the metadata fields are written onto (`this`)
+     * @param set - The source metadata to copy from
+     * @param init - Optional id + issuer defaults
+     */
+    static applyMetadata(target, set, init) {
+        if (set) {
+            if (!set._id && set._id !== undefined) {
+                set._id = undefined;
+            }
+            target._id = set._id;
+            target.__created = set.__created;
+            target.__createdBy = set.__createdBy;
+            target.__lastModified = set.__lastModified;
+            target.__lastModifiedBy = set.__lastModifiedBy;
+            target.__v = set.__v;
+            if (set._archived) {
+                target._archived = set._archived;
+                target._originalId = set._originalId;
+            }
+        }
+        if (!target.__created) {
+            target.__created = new Date();
+        }
+        if (!target.__lastModified) {
+            target.__lastModified = new Date();
+        }
+        if (!target.__v) {
+            target.__v = 0;
+        }
+        if (init) {
+            if (!target._id && init?.id) {
+                target._id = init.id;
+            }
+            if (init?.issuer) {
+                if (!target.__createdBy) {
+                    target.__createdBy = init.issuer;
+                }
+                if (!target.__lastModifiedBy) {
+                    target.__lastModifiedBy = init.issuer;
+                }
+            }
+        }
+    }
+    /**
+     * Updates the metadata of a data model
+     * @param data - The data model to update
+     * @param issuer - The issuer of the data model
+     * @param id - The id of the data model
+     * @returns The updated data model
+     *
+     * @example
+     * ```ts
+     * const metadata: DyFM_Metadata_DataModel = new DyFM_Metadata_DataModel({
+     *   _id: '123',
+     * });
+     * const updatedMetadata = DyFM_Metadata_DataModel.updateMetadata(metadata, 'user', '456');
+     * ```
+     */
+    static updateMetadata(data, issuer, id) {
+        if (!data) {
+            return data;
+        }
+        if (data._deleted) {
+            throw new Error('Cannot update metadata of deleted data');
+        }
+        if (!data._id && id) {
+            data._id = id;
+        }
+        if (!data.__created) {
+            data.__created = new Date();
+        }
+        if (!data.__createdBy) {
+            data.__createdBy = issuer;
+        }
+        data.__lastModified = new Date();
+        data.__lastModifiedBy = issuer;
+        data.__v = data.__v ? data.__v + 1 : 1;
+        return data;
+    }
+}
+Object.defineProperty(DyFM_Metadata_DataModel, 'name', { value: 'DyFM_Metadata' });
+/** @deprecated Use DyFM_Metadata_DataModel. Same constructor; no API removal. */
+export { DyFM_Metadata_DataModel as DyFM_Metadata };

package/build-esm/_models/interfaces/box-bounds.interface.js

@@ -0,0 +1 @@
+export {};

package/build-esm/_models/interfaces/environment/global-log-settings.interface.js

@@ -0,0 +1 @@
+export {};

package/build-esm/_models/interfaces/environment/global-settings.interface.js

@@ -0,0 +1 @@
+export {};

package/build-esm/_models/interfaces/error-defaults.interface.js

@@ -0,0 +1 @@
+export {};

package/build-esm/_models/interfaces/operation-authz-result.interface.js

@@ -0,0 +1 @@
+export {};

package/build-esm/_models/interfaces/operation-authz.interface.js

@@ -0,0 +1 @@
+export {};

package/build-esm/_models/interfaces/operation-exposure.interface.js

@@ -0,0 +1 @@
+export {};

package/build-esm/_models/interfaces/operation-guardrails.interface.js

@@ -0,0 +1 @@
+export {};

package/build-esm/_models/interfaces/operation-input-settings.interface.js

@@ -0,0 +1 @@
+export {};

package/build-esm/_models/interfaces/operation-json-schema.interface.js

@@ -0,0 +1 @@
+export {};

package/build-esm/_models/interfaces/operation-patch-field.interface.js

@@ -0,0 +1 @@
+export {};

package/build-esm/_models/interfaces/operation-patch-result.interface.js

@@ -0,0 +1 @@
+export {};

package/build-esm/_models/interfaces/operation-patch-violation.interface.js

@@ -0,0 +1 @@
+export {};

package/build-esm/_models/interfaces/operation-run-result.interface.js

@@ -0,0 +1 @@
+export {};

package/build-esm/_models/interfaces/paged.interface.js

@@ -0,0 +1 @@
+export {};

package/build-esm/_models/interfaces/poll-handle.interface.js

@@ -0,0 +1 @@
+export {};

package/build-esm/_models/interfaces/random-weight.interface.js

@@ -0,0 +1 @@
+export {};

package/build-esm/_models/interfaces/route-settings.interface.js

@@ -0,0 +1 @@
+export {};

package/build-esm/_models/interfaces/search-query.interface.js

@@ -0,0 +1 @@
+export {};

package/build-esm/_models/interfaces/search-result.interface.js

@@ -0,0 +1 @@
+export {};

package/build-esm/_models/interfaces/server-error-statistics.interface.js

@@ -0,0 +1 @@
+export {};

package/build-esm/_models/interfaces/vector2.interface.js

@@ -0,0 +1 @@
+export {};

package/build-esm/_models/types/db-filter.type.js

@@ -0,0 +1 @@
+export {};

package/build-esm/_models/types/db-sort.type.js

@@ -0,0 +1 @@
+export {};

package/build-esm/_models/types/deprecated-boolean-alias.type.js

@@ -0,0 +1 @@
+export {};

package/build-esm/_models/types/ds-filter.type.js

@@ -0,0 +1,15 @@
+export var DyFM_SpecialSearch_Type;
+(function (DyFM_SpecialSearch_Type) {
+    /**
+     * searches each word in the string, returns true if ANY word is found in ANY order
+     * */
+    DyFM_SpecialSearch_Type["stringListSearchAny"] = "stringListSearchAny";
+    /**
+     * searches each word in the string, returns true if ALL words are found in ANY order
+     * */
+    DyFM_SpecialSearch_Type["stringListSearch"] = "stringListSearch";
+    /**
+     * searches each word in the string, returns true if ALL words are found in the SAME order
+     * */
+    DyFM_SpecialSearch_Type["stringListSearchOrdered"] = "stringListSearchOrdered";
+})(DyFM_SpecialSearch_Type || (DyFM_SpecialSearch_Type = {}));

package/build-esm/_models/types/ds-sort.type.js

@@ -0,0 +1 @@
+export {};

package/build-esm/_modules/ai/_collections/ai-media-provenance.util.js

@@ -0,0 +1,24 @@
+/**
+ * Chain-depth rules of the media provenance contract.
+ *
+ * A generation made from a previous generation's output loses quality, and its provenance stops pointing at
+ * anything a person made - so consumers ban such chains, and an explicit override may allow a bounded number
+ * of steps. The depth arithmetic lives here once, so every writer records, and every reader checks, the same
+ * number. It is the rule `dc media-image` already applies (dynamo-cli `DyCLI_MIG_Provenance_Util`).
+ */
+export class DyFM_AI_MediaProvenance_Util {
+    /**
+     * The chain depth a new output gets: 0 when none of its inputs is a recorded generation (a prompt-only
+     * generation, or an edit of originals), otherwise the deepest generated input's depth + 1.
+     * A generated input recorded without `chainDepth` counts as a first generation (depth 0).
+     */
+    static nextChainDepth(generatedInputs) {
+        return generatedInputs.reduce((depth, input) => Math.max(depth, (input.chainDepth ?? 0) + 1), 0);
+    }
+    /**
+     * True when using `generatedInput` as an input would create a chain deeper than `maxChainDepth`.
+     */
+    static exceedsChainLimit(generatedInput, maxChainDepth) {
+        return (generatedInput.chainDepth ?? 0) + 1 > maxChainDepth;
+    }
+}

package/build-esm/_modules/ai/_collections/ai-model-ref.util.js

@@ -0,0 +1,70 @@
+import { DyFM_AI_Provider } from '../_enums/ai-provider.enum';
+/**
+ * AI modell hivatkozas formatum: {provider}:{model}
+ *
+ * Peldak: "open-ai:gpt-4o", "anthropic:claude-3-5-sonnet-latest", "fdp-ai:fdp-base-1"
+ * A provider resz a DyFM_AI_Provider enum erteke, a model resz a provider sajat modell azonositoja.
+ */
+export class DyFM_AI_ModelRef_Util {
+    /** az elvlaszto karakter a provider es modell kozott */
+    static separator = ':';
+    /** az osszes ervenyes provider ertek gyorstarhely */
+    static validProviders = new Set(Object.values(DyFM_AI_Provider));
+    /**
+     * Osszeallitas provider + model -bol
+     * @param provider - AI provider enum ertek
+     * @param model - provider-specifikus modell azonosito
+     */
+    static create(provider, model) {
+        return `${provider}${DyFM_AI_ModelRef_Util.separator}${model}`;
+    }
+    /**
+     * Szetbontas provider + model -re
+     * @param modelRef - formatum: {provider}:{model}
+     */
+    static parse(modelRef) {
+        const separatorIndex = modelRef.indexOf(DyFM_AI_ModelRef_Util.separator);
+        if (separatorIndex < 0) {
+            throw new Error(`Ervenytelen modelRef formatum: "${modelRef}" -- hianyzik a "${DyFM_AI_ModelRef_Util.separator}" elvlaszto`);
+        }
+        const provider = modelRef.substring(0, separatorIndex);
+        const model = modelRef.substring(separatorIndex + 1);
+        if (!DyFM_AI_ModelRef_Util.validProviders.has(provider)) {
+            throw new Error(`Ismeretlen AI provider: "${provider}" a modelRef-ben: "${modelRef}"`);
+        }
+        if (!model) {
+            throw new Error(`Ures modell azonosito a modelRef-ben: "${modelRef}"`);
+        }
+        return { provider: provider, model: model };
+    }
+    /**
+     * Provider kinyerese a modelRef-bol
+     * @param modelRef - formatum: {provider}:{model}
+     */
+    static getProvider(modelRef) {
+        return DyFM_AI_ModelRef_Util.parse(modelRef).provider;
+    }
+    /**
+     * Model kinyerese a modelRef-bol
+     * @param modelRef - formatum: {provider}:{model}
+     */
+    static getModel(modelRef) {
+        return DyFM_AI_ModelRef_Util.parse(modelRef).model;
+    }
+    /**
+     * Validalas -- ellenorzi, hogy a modelRef megfelel-e a {provider}:{model} formatumnak
+     * @param modelRef - a vizsgalando string
+     */
+    static isValid(modelRef) {
+        if (!modelRef) {
+            return false;
+        }
+        const separatorIndex = modelRef.indexOf(DyFM_AI_ModelRef_Util.separator);
+        if (separatorIndex < 0) {
+            return false;
+        }
+        const provider = modelRef.substring(0, separatorIndex);
+        const model = modelRef.substring(separatorIndex + 1);
+        return DyFM_AI_ModelRef_Util.validProviders.has(provider) && !!model;
+    }
+}

package/build-esm/_modules/ai/_collections/ai-model-registry.util.js

@@ -0,0 +1,37 @@
+/**
+ * Lookups over a per-provider model registry (`DyFM_OAI_Models`, `DyFM_AAI_Models`, …).
+ *
+ * The registry array is passed IN — this keeps the agnostic `./ai` core free of
+ * any provider-submodule dependency (the execution-layer service supplies its own
+ * provider's registry). The lookup is by exact API model `id`.
+ */
+export class DyFM_AI_ModelRegistry_Util {
+    /**
+     * A modell-descriptor megkeresese id alapjan a megadott registry-ben.
+     * @param models - a provider registry tomb (pl. DyFM_OAI_Models)
+     * @param id - pontos API modell-azonosito (pl. 'gpt-5.5')
+     */
+    static findModelInfo(models, id) {
+        return models.find((model) => model.id === id);
+    }
+    /**
+     * Tamogatja-e a modell a function calling-ot (tool use)?
+     * Ismeretlen id eseten `false` (honesty — soha ne feltetelezzunk tool-kepesseget).
+     * @param models - a provider registry tomb
+     * @param id - pontos API modell-azonosito
+     */
+    static modelSupportsTools(models, id) {
+        return DyFM_AI_ModelRegistry_Util.findModelInfo(models, id)?.capabilities?.functionCalling ?? false;
+    }
+    /**
+     * Registry entries that were NOT verified against the provider on or after the given date.
+     *
+     * An entry without `lastVerified` counts as unverified: an undated entry is exactly the drift this surfaces —
+     * provider catalogues churn, and a model kept "from memory" goes stale without any signal.
+     * @param models - a provider registry array (e.g. DyFM_OAI_Models)
+     * @param sinceIsoDate - ISO date (yyyy-mm-dd); entries verified on or after it are fresh
+     */
+    static findUnverifiedSince(models, sinceIsoDate) {
+        return models.filter((model) => !model.lastVerified || model.lastVerified < sinceIsoDate);
+    }
+}

package/build-esm/_modules/ai/_enums/ai-message-role.enum.js

@@ -0,0 +1,8 @@
+export var DyFM_AI_MessageRole;
+(function (DyFM_AI_MessageRole) {
+    DyFM_AI_MessageRole["system"] = "system";
+    DyFM_AI_MessageRole["user"] = "user";
+    DyFM_AI_MessageRole["assistant"] = "assistant";
+    /** Tool-result message (function calling). Provider translators map this to their native shape. */
+    DyFM_AI_MessageRole["tool"] = "tool";
+})(DyFM_AI_MessageRole || (DyFM_AI_MessageRole = {}));

package/build-esm/_modules/ai/_enums/ai-model-type.enum.js

@@ -0,0 +1,8 @@
+export var DyFM_AI_ModelType;
+(function (DyFM_AI_ModelType) {
+    DyFM_AI_ModelType["LLM"] = "llm";
+    DyFM_AI_ModelType["Embedding"] = "embedding";
+    DyFM_AI_ModelType["Chat"] = "chat";
+    DyFM_AI_ModelType["Image"] = "image";
+    DyFM_AI_ModelType["Audio"] = "audio";
+})(DyFM_AI_ModelType || (DyFM_AI_ModelType = {}));

package/build-esm/_modules/ai/_enums/ai-provider.enum.js

@@ -0,0 +1,8 @@
+export var DyFM_AI_Provider;
+(function (DyFM_AI_Provider) {
+    DyFM_AI_Provider["OpenAI"] = "open-ai";
+    DyFM_AI_Provider["Anthropic"] = "anthropic";
+    DyFM_AI_Provider["Google"] = "google";
+    DyFM_AI_Provider["LocalAI"] = "local-ai";
+    DyFM_AI_Provider["FdpAI"] = "fdp-ai";
+})(DyFM_AI_Provider || (DyFM_AI_Provider = {}));

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

@@ -0,0 +1,88 @@
+/**
+ * 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`
+ */
+export class DyFM_AI_CallSettings {
+    systemPrompt = '';
+    useModel;
+    project;
+    /** @deprecated Use isDebugLogEnabled; debugLog remains the serialized compatibility key. */
+    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);
+        }
+    }
+}
+Object.defineProperty(DyFM_AI_CallSettings.prototype, 'isDebugLogEnabled', {
+    configurable: true,
+    enumerable: false,
+    get: function () {
+        return this.debugLog;
+    },
+    set: function (isValue) {
+        this.debugLog = isValue;
+    },
+});

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

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1 @@
+export {};

package/build-esm/_modules/ai/_models/ai-image-request.interface.js

@@ -0,0 +1 @@
+export {};

package/build-esm/_modules/ai/_models/ai-image-response.interface.js

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1 @@
+export {};

package/build-esm/_modules/ai/_models/ai-media-file.interface.js

@@ -0,0 +1 @@
+export {};

package/build-esm/_modules/ai/_models/ai-media-provenance.interface.js

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1 @@
+export {};

package/build-esm/_modules/ai/_models/ai-model-info.interface.js

@@ -0,0 +1 @@
+export {};

package/build-esm/_modules/ai/_models/ai-model-settings-schema.interface.js

@@ -0,0 +1 @@
+export {};

package/build-esm/_modules/ai/_models/ai-model3d-request.interface.js

@@ -0,0 +1 @@
+export {};

package/build-esm/_modules/ai/_models/ai-model3d-response.interface.js

@@ -0,0 +1 @@
+export {};

package/build-esm/_modules/ai/_models/ai-provider-capabilities.interface.js

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,10 @@
+export class DyFM_AI_Settings {
+    provider;
+    config;
+    defaultSettings;
+    constructor(set) {
+        if (set) {
+            Object.assign(this, set);
+        }
+    }
+}

package/build-esm/_modules/ai/_models/ai-speech-request.interface.js

@@ -0,0 +1 @@
+export {};

package/build-esm/_modules/ai/_models/ai-speech-response.interface.js

@@ -0,0 +1 @@
+export {};

package/build-esm/_modules/ai/_models/ai-tool-call.interface.js

@@ -0,0 +1 @@
+export {};

package/build-esm/_modules/ai/_models/ai-tool-handler.type.js

@@ -0,0 +1 @@
+export {};

package/build-esm/_modules/ai/_models/ai-tool-result.interface.js

@@ -0,0 +1 @@
+export {};

package/build-esm/_modules/ai/_models/ai-tool.interface.js

@@ -0,0 +1 @@
+export {};

package/build-esm/_modules/ai/_models/ai-user-provider-config.control-model.js

@@ -0,0 +1,31 @@
+/**
+ * User szintu AI provider konfiguracio base class
+ *
+ * Tartalmazz a provider API kulcs titkositott valtozatat, annak suffix-et a megjeleníteshez,
+ * es az alap beallitasokat. Provider-specifikus leszarmazottak bovitik sajat mezoikkel.
+ */
+export class DyFM_AI_UserProviderConfig_ControlModel {
+    // Preserve constructor metadata for existing consumers of the legacy export alias.
+    static {
+        Object.defineProperty(this, 'name', { value: 'DyFM_AI_UserProviderConfig' });
+    }
+    provider;
+    /** titkositott API kulcs (csak szerver oldalon tarolva, kliensre sosem kerul) */
+    encryptedApiKey;
+    /** az API kulcs utolso ~4 karaktere megjeleníteshez (pl. "...xR7q") */
+    keySuffix;
+    isActive;
+    label;
+    lastTestedAt;
+    lastUsedAt;
+    /** a user altal kivalasztott modellek (providerrol lekerdezett listabol) */
+    selectedModels;
+    /** Initializes the model with the existing defaults and caller-provided overrides. */
+    constructor(set) {
+        if (set) {
+            Object.assign(this, set);
+        }
+    }
+}
+/** @deprecated Use DyFM_AI_UserProviderConfig_ControlModel. Same constructor; no API removal. */
+export { DyFM_AI_UserProviderConfig_ControlModel as DyFM_AI_UserProviderConfig };