@futdevpro/fsm-dynamo 1.15.15 → 1.15.17

package/.dynamo/pipeline.cicd.config.json

@@ -0,0 +1,128 @@
+{
+  "name": "Dynamo-FSM CI/CD Pipeline",
+  "outputDir": "./logs/cicd-pipeline",
+  "timing": {
+    "stepTimeout": "10m",
+    "teeMaxRuntime": "10m",
+    "stepCooldown": "1s"
+  },
+  "log": {
+    "runtimeMaxBytes": 5242880,
+    "trimCheckEveryN": 1000
+  },
+  "versionBump": {
+    "enabled": false
+  },
+  "report": {
+    "fileName": "cicd-report.json",
+    "includeLogTail": true,
+    "logTailLines": 10000,
+    "includeStepLogs": false
+  },
+  "steps": [
+    {
+      "label": "discord-start",
+      "command": "dc ci-dn-s '{\"appName\":\"Dynamo-FSM\",\"appEmoji\":\"🧱\",\"commitMessage\":\"$COMMIT_MESSAGE\",\"branchName\":\"$GITHUB_REF_NAME\",\"author\":\"$GITHUB_ACTOR\",\"runNumber\":\"$GITHUB_RUN_NUMBER\",\"runId\":\"$GITHUB_RUN_ID\",\"repository\":\"$GITHUB_REPOSITORY\",\"eventName\":\"$GITHUB_EVENT_NAME\",\"eventDateTime\":\"$EVENT_DATETIME\"}'",
+      "fatal": false,
+      "discord": {
+        "hide": true
+      },
+      "condition": {
+        "envSet": [
+          "DISCORD_WEBHOOK_ID"
+        ]
+      }
+    },
+    {
+      "label": "pre-flight",
+      "type": "pre-flight-check",
+      "fatal": true,
+      "discord": {
+        "emoji": "🔐",
+        "name": "Pre-flight Check"
+      },
+      "settings": {
+        "requiredEnvVars": [
+          "NPM_TOKEN"
+        ]
+      }
+    },
+    {
+      "label": "install",
+      "command": "pnpm i",
+      "fatal": true,
+      "discord": {
+        "hide": true
+      }
+    },
+    {
+      "label": "build",
+      "command": "npx tsc",
+      "fatal": true,
+      "discord": {
+        "emoji": "🏗️",
+        "name": "Build"
+      }
+    },
+    {
+      "label": "test",
+      "command": "npx jasmine",
+      "fatal": true,
+      "discord": {
+        "emoji": "🧪",
+        "name": "Tests"
+      }
+    },
+    {
+      "label": "npm-publish",
+      "type": "npm-publish",
+      "fatal": false,
+      "discord": {
+        "emoji": "📦",
+        "name": "NPM Publish"
+      },
+      "condition": {
+        "branchMatch": [
+          "master"
+        ]
+      },
+      "settings": {
+        "directory": ".",
+        "skipIfPublished": true,
+        "retryAttempts": 3,
+        "retryDelaySeconds": 30
+      }
+    },
+    {
+      "label": "pipeline-report",
+      "command": "fdp pipeline-report --report ./logs/cicd-pipeline/cicd-report.json --overseer-url $OVERSEER_URL --overseer-secret $OVERSEER_SECRET_KEY --branch $GITHUB_REF_NAME",
+      "fatal": false,
+      "always": true,
+      "discord": {
+        "emoji": "📊",
+        "name": "Build Report"
+      },
+      "condition": {
+        "envSet": [
+          "OVERSEER_URL"
+        ]
+      }
+    },
+    {
+      "label": "discord-result",
+      "command": "fdp pipeline-notify --report ./logs/cicd-pipeline/cicd-report.json --config ./pipeline.cicd.config.json --app-name Dynamo-FSM --app-emoji 🧱 --webhook-id $DISCORD_WEBHOOK_ID --webhook-token $DISCORD_WEBHOOK_TOKEN --overseer-url $OVERSEER_DASHBOARD_URL",
+      "fatal": false,
+      "retryOnFail": 2,
+      "retryDelaySec": 5,
+      "always": true,
+      "discord": {
+        "hide": true
+      },
+      "condition": {
+        "envSet": [
+          "DISCORD_WEBHOOK_ID"
+        ]
+      }
+    }
+  ]
+}

package/build/_collections/utils/require-env.util.d.ts

@@ -5,7 +5,7 @@ export interface DyFM_RequireEnv_Options {
     /**
      * Stable error code emitted on the DyFM_Error when the env-var is missing
      * and no fallback is configured. Convention: `<PACKAGE>-ENV-MISSING-<KEY>`,
-     * e.g. `DyNM-ENV-MISSING-STORAGE-KEY`, `FDP-ENV-MISSING-AUTH-KEY`.
+     * e.g. `DyNM-ENV-MISSING-STORAGE-KEY`, `FDP-ENV-MISSING-CORE-FE-AUTH-KEY`.
      */
     errorCode: string;
     /**
@@ -60,8 +60,8 @@ export interface DyFM_RequireEnv_Options {
  * import { DyFM_requireEnv } from '@futdevpro/fsm-dynamo';
  *
  * export const FDP_keysEnv_settingsBase = {
- *   authKey: DyFM_requireEnv('FDP_AUTH_KEY', {
- *     errorCode: 'FDP-ENV-MISSING-AUTH-KEY',
+ *   authKey: DyFM_requireEnv('FDP_CORE_FE_AUTH_KEY', {
+ *     errorCode: 'FDP-ENV-MISSING-CORE-FE-AUTH-KEY',
  *     issuerService: 'fdp-templates',
  *     fallback: '<inherit literal>',   // remove for Wave 3
  *   }),

package/build/_collections/utils/require-env.util.js

@@ -33,8 +33,8 @@ const global_settings_const_1 = require("../constants/global-settings.const");
  * import { DyFM_requireEnv } from '@futdevpro/fsm-dynamo';
  *
  * export const FDP_keysEnv_settingsBase = {
- *   authKey: DyFM_requireEnv('FDP_AUTH_KEY', {
- *     errorCode: 'FDP-ENV-MISSING-AUTH-KEY',
+ *   authKey: DyFM_requireEnv('FDP_CORE_FE_AUTH_KEY', {
+ *     errorCode: 'FDP-ENV-MISSING-CORE-FE-AUTH-KEY',
  *     issuerService: 'fdp-templates',
  *     fallback: '<inherit literal>',   // remove for Wave 3
  *   }),

package/build/_models/interfaces/environment/global-settings.interface.d.ts

@@ -29,7 +29,7 @@ export interface DyFM_Global_Settings {
      * import { environment } from './environments/environment';
      *
      * DyFM_global_settings.envOverrides = {
-     *   FDP_AUTH_KEY: environment.authKey,
+     *   FDP_CORE_FE_AUTH_KEY: environment.authKey,
      *   FDP_EXTRA_AUTH_STORAGE_KEY: environment.extraAuthStorageKey,
      *   DyNM_STORAGE_ENCRYPTION_KEY: environment.storageEncryptionKey,
      * };

package/build/_modules/ai/_collections/ai-model-registry.util.d.ts

@@ -0,0 +1,24 @@
+import { DyFM_AI_ModelInfo } from '../_models/ai-model-info.interface';
+/**
+ * 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 declare 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: DyFM_AI_ModelInfo[], id: string): DyFM_AI_ModelInfo | undefined;
+    /**
+     * 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: DyFM_AI_ModelInfo[], id: string): boolean;
+}
+//# sourceMappingURL=ai-model-registry.util.d.ts.map

package/build/_modules/ai/_collections/ai-model-registry.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-model-registry.util.d.ts","sourceRoot":"","sources":["../../../../src/_modules/ai/_collections/ai-model-registry.util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAEvE;;;;;;GAMG;AACH,qBAAa,0BAA0B;IAErC;;;;OAIG;IACH,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,iBAAiB,EAAE,EAAE,EAAE,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAI5F;;;;;OAKG;IACH,MAAM,CAAC,kBAAkB,CAAC,MAAM,EAAE,iBAAiB,EAAE,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO;CAG5E"}

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

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyFM_AI_ModelRegistry_Util = void 0;
+/**
+ * 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`.
+ */
+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;
+    }
+}
+exports.DyFM_AI_ModelRegistry_Util = DyFM_AI_ModelRegistry_Util;
+//# sourceMappingURL=ai-model-registry.util.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ai-model-registry.util.js","sourceRoot":"","sources":["../../../../src/_modules/ai/_collections/ai-model-registry.util.ts"],"names":[],"mappings":";;;AAEA;;;;;;GAMG;AACH,MAAa,0BAA0B;IAErC;;;;OAIG;IACH,MAAM,CAAC,aAAa,CAAC,MAA2B,EAAE,EAAU;QAC1D,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,KAAwB,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IACpE,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,kBAAkB,CAAC,MAA2B,EAAE,EAAU;QAC/D,OAAO,0BAA0B,CAAC,aAAa,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,YAAY,EAAE,eAAe,IAAI,KAAK,CAAC;IACtG,CAAC;CACF;AApBD,gEAoBC"}

package/build/_modules/ai/_enums/ai-message-role.enum.d.ts

@@ -1,6 +1,8 @@
 export declare enum DyFM_AI_MessageRole {
     system = "system",
     user = "user",
-    assistant = "assistant"
+    assistant = "assistant",
+    /** Tool-result message (function calling). Provider translators map this to their native shape. */
+    tool = "tool"
 }
 //# sourceMappingURL=ai-message-role.enum.d.ts.map

package/build/_modules/ai/_enums/ai-message-role.enum.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai-message-role.enum.d.ts","sourceRoot":"","sources":["../../../../src/_modules/ai/_enums/ai-message-role.enum.ts"],"names":[],"mappings":"AAAA,oBAAY,mBAAmB;IAC7B,MAAM,WAAW;IACjB,IAAI,SAAS;IACb,SAAS,cAAc;CACxB"}
+{"version":3,"file":"ai-message-role.enum.d.ts","sourceRoot":"","sources":["../../../../src/_modules/ai/_enums/ai-message-role.enum.ts"],"names":[],"mappings":"AAAA,oBAAY,mBAAmB;IAC7B,MAAM,WAAW;IACjB,IAAI,SAAS;IACb,SAAS,cAAc;IACvB,mGAAmG;IACnG,IAAI,SAAS;CACd"}

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

@@ -6,5 +6,7 @@ var 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 || (exports.DyFM_AI_MessageRole = DyFM_AI_MessageRole = {}));
 //# sourceMappingURL=ai-message-role.enum.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"ai-message-role.enum.js","sourceRoot":"","sources":["../../../../src/_modules/ai/_enums/ai-message-role.enum.ts"],"names":[],"mappings":";;;AAAA,IAAY,mBAIX;AAJD,WAAY,mBAAmB;IAC7B,wCAAiB,CAAA;IACjB,oCAAa,CAAA;IACb,8CAAuB,CAAA;AACzB,CAAC,EAJW,mBAAmB,mCAAnB,mBAAmB,QAI9B"}
+{"version":3,"file":"ai-message-role.enum.js","sourceRoot":"","sources":["../../../../src/_modules/ai/_enums/ai-message-role.enum.ts"],"names":[],"mappings":";;;AAAA,IAAY,mBAMX;AAND,WAAY,mBAAmB;IAC7B,wCAAiB,CAAA;IACjB,oCAAa,CAAA;IACb,8CAAuB,CAAA;IACvB,mGAAmG;IACnG,oCAAa,CAAA;AACf,CAAC,EANW,mBAAmB,mCAAnB,mBAAmB,QAM9B"}

package/build/_modules/ai/_enums/ai-model-type.enum.d.ts

@@ -1,6 +1,8 @@
 export declare enum DyFM_AI_ModelType {
     LLM = "llm",
     Embedding = "embedding",
-    Chat = "chat"
+    Chat = "chat",
+    Image = "image",
+    Audio = "audio"
 }
 //# sourceMappingURL=ai-model-type.enum.d.ts.map

package/build/_modules/ai/_enums/ai-model-type.enum.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai-model-type.enum.d.ts","sourceRoot":"","sources":["../../../../src/_modules/ai/_enums/ai-model-type.enum.ts"],"names":[],"mappings":"AAAA,oBAAY,iBAAiB;IAC3B,GAAG,QAAQ;IACX,SAAS,cAAc;IACvB,IAAI,SAAS;CACd"}
+{"version":3,"file":"ai-model-type.enum.d.ts","sourceRoot":"","sources":["../../../../src/_modules/ai/_enums/ai-model-type.enum.ts"],"names":[],"mappings":"AAAA,oBAAY,iBAAiB;IAC3B,GAAG,QAAQ;IACX,SAAS,cAAc;IACvB,IAAI,SAAS;IACb,KAAK,UAAU;IACf,KAAK,UAAU;CAChB"}

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

@@ -6,5 +6,7 @@ var 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 || (exports.DyFM_AI_ModelType = DyFM_AI_ModelType = {}));
 //# sourceMappingURL=ai-model-type.enum.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"ai-model-type.enum.js","sourceRoot":"","sources":["../../../../src/_modules/ai/_enums/ai-model-type.enum.ts"],"names":[],"mappings":";;;AAAA,IAAY,iBAIX;AAJD,WAAY,iBAAiB;IAC3B,gCAAW,CAAA;IACX,4CAAuB,CAAA;IACvB,kCAAa,CAAA;AACf,CAAC,EAJW,iBAAiB,iCAAjB,iBAAiB,QAI5B"}
+{"version":3,"file":"ai-model-type.enum.js","sourceRoot":"","sources":["../../../../src/_modules/ai/_enums/ai-model-type.enum.ts"],"names":[],"mappings":";;;AAAA,IAAY,iBAMX;AAND,WAAY,iBAAiB;IAC3B,gCAAW,CAAA;IACX,4CAAuB,CAAA;IACvB,kCAAa,CAAA;IACb,oCAAe,CAAA;IACf,oCAAe,CAAA;AACjB,CAAC,EANW,iBAAiB,iCAAjB,iBAAiB,QAM5B"}

package/build/_modules/ai/_models/ai-call-settings.interface.d.ts

@@ -1,3 +1,24 @@
+/**
+ * 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`
+ *      `documentations/guidelines/development/ai-per-model-settings.md`
+ */
 export declare class DyFM_AI_CallSettings {
     systemPrompt?: string;
     useModel?: string;

package/build/_modules/ai/_models/ai-call-settings.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai-call-settings.interface.d.ts","sourceRoot":"","sources":["../../../../src/_modules/ai/_models/ai-call-settings.interface.ts"],"names":[],"mappings":"AAAA,qBAAa,oBAAoB;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAM;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;;;;;;OAQG;IACH,WAAW,CAAC,EAAE,MAAM,CAAK;IACzB;;;;;;;;OAQG;IACH,SAAS,CAAC,EAAE,MAAM,CAAQ;IAC1B;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,MAAM,CAAQ;IACrB;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAK;IAC9B;;;;;;;OAOG;IACH,eAAe,CAAC,EAAE,MAAM,CAAK;IAG7B,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;gBAGjB,GAAG,CAAC,EAAE,oBAAoB;CAM7B"}
+{"version":3,"file":"ai-call-settings.interface.d.ts","sourceRoot":"","sources":["../../../../src/_modules/ai/_models/ai-call-settings.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,oBAAoB;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAM;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;;;;;;OAQG;IACH,WAAW,CAAC,EAAE,MAAM,CAAK;IACzB;;;;;;;;OAQG;IACH,SAAS,CAAC,EAAE,MAAM,CAAQ;IAC1B;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,MAAM,CAAQ;IACrB;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAK;IAC9B;;;;;;;OAOG;IACH,eAAe,CAAC,EAAE,MAAM,CAAK;IAG7B,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;gBAGjB,GAAG,CAAC,EAAE,oBAAoB;CAM7B"}

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

@@ -1,6 +1,27 @@
 "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`
+ *      `documentations/guidelines/development/ai-per-model-settings.md`
+ */
 class DyFM_AI_CallSettings {
     systemPrompt = '';
     useModel;

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

@@ -1 +1 @@
-{"version":3,"file":"ai-call-settings.interface.js","sourceRoot":"","sources":["../../../../src/_modules/ai/_models/ai-call-settings.interface.ts"],"names":[],"mappings":";;;AAAA,MAAa,oBAAoB;IAC/B,YAAY,GAAY,EAAE,CAAC;IAC3B,QAAQ,CAAU;IAClB,OAAO,CAAU;IACjB,QAAQ,CAAW;IAEnB;;;;;;;;OAQG;IACH,WAAW,GAAY,CAAC,CAAC;IACzB;;;;;;;;OAQG;IACH,SAAS,GAAY,IAAI,CAAC;IAC1B;;;;;;;OAOG;IACH,IAAI,GAAY,IAAI,CAAC;IACrB;;;;;OAKG;IACH,gBAAgB,GAAY,CAAC,CAAC;IAC9B;;;;;;;OAOG;IACH,eAAe,GAAY,CAAC,CAAC;IAK7B,YACE,GAA0B;QAE1B,IAAI,GAAG,EAAE,CAAC;YACR,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;CACF;AA9DD,oDA8DC"}
+{"version":3,"file":"ai-call-settings.interface.js","sourceRoot":"","sources":["../../../../src/_modules/ai/_models/ai-call-settings.interface.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAa,oBAAoB;IAC/B,YAAY,GAAY,EAAE,CAAC;IAC3B,QAAQ,CAAU;IAClB,OAAO,CAAU;IACjB,QAAQ,CAAW;IAEnB;;;;;;;;OAQG;IACH,WAAW,GAAY,CAAC,CAAC;IACzB;;;;;;;;OAQG;IACH,SAAS,GAAY,IAAI,CAAC;IAC1B;;;;;;;OAOG;IACH,IAAI,GAAY,IAAI,CAAC;IACrB;;;;;OAKG;IACH,gBAAgB,GAAY,CAAC,CAAC;IAC9B;;;;;;;OAOG;IACH,eAAe,GAAY,CAAC,CAAC;IAK7B,YACE,GAA0B;QAE1B,IAAI,GAAG,EAAE,CAAC;YACR,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;CACF;AA9DD,oDA8DC"}

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

@@ -1,4 +1,5 @@
 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
@@ -12,6 +13,10 @@ export interface DyFM_AI_LLM_Response {
     };
     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;
 }
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"ai-llm-response.interface.d.ts","sourceRoot":"","sources":["../../../../src/_modules/ai/_models/ai-llm-response.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE;QACN,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;QACzB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,GAAG,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAyB,SAAQ,oBAAoB;IACpE,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,WAAW,EAAE,GAAG,CAAC;CAClB"}
+{"version":3,"file":"ai-llm-response.interface.d.ts","sourceRoot":"","sources":["../../../../src/_modules/ai/_models/ai-llm-response.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE;QACN,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;QACzB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mGAAmG;IACnG,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/B,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,GAAG,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAyB,SAAQ,oBAAoB;IACpE,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,WAAW,EAAE,GAAG,CAAC;CAClB"}

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

@@ -1,6 +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;
 }
 //# sourceMappingURL=ai-message.interface.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ai-message.interface.d.ts","sourceRoot":"","sources":["../../../../src/_modules/ai/_models/ai-message.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAErE,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,mBAAmB,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;CACjB"}
+{"version":3,"file":"ai-message.interface.d.ts","sourceRoot":"","sources":["../../../../src/_modules/ai/_models/ai-message.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,mBAAmB,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,iFAAiF;IACjF,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/B,gGAAgG;IAChG,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}

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

@@ -0,0 +1,28 @@
+/**
+ * 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;
+}
+//# sourceMappingURL=ai-model-capabilities.interface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ai-model-capabilities.interface.d.ts","sourceRoot":"","sources":["../../../../src/_modules/ai/_models/ai-model-capabilities.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,WAAW,yBAAyB;IACxC,mFAAmF;IACnF,eAAe,EAAE,OAAO,CAAC;IACzB,4BAA4B;IAC5B,MAAM,EAAE,OAAO,CAAC;IAChB,2BAA2B;IAC3B,SAAS,EAAE,OAAO,CAAC;IACnB,8FAA8F;IAC9F,QAAQ,EAAE,OAAO,CAAC;IAClB,0DAA0D;IAC1D,UAAU,EAAE,OAAO,CAAC;IACpB,yDAAyD;IACzD,WAAW,EAAE,OAAO,CAAC;IACrB,oDAAoD;IACpD,eAAe,EAAE,OAAO,CAAC;IACzB,4CAA4C;IAC5C,UAAU,EAAE,OAAO,CAAC;CACrB"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"ai-model-capabilities.interface.js","sourceRoot":"","sources":["../../../../src/_modules/ai/_models/ai-model-capabilities.interface.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,62 @@
+import { DyFM_AI_Provider } from '../_enums/ai-provider.enum';
+import { DyFM_AI_ModelType } from '../_enums/ai-model-type.enum';
+import { DyFM_AI_ModelCapabilities } from './ai-model-capabilities.interface';
+import { DyFM_AI_ModelSettingsSchema } from './ai-model-settings-schema.interface';
+/**
+ * Lifecycle status of a model in the provider's catalogue.
+ *
+ * `ga` — generally available, recommended for new work.
+ * `preview` — available but pre-GA (API/behaviour may change).
+ * `deprecated` — still callable but on a sunset path; prefer {@link DyFM_AI_ModelInfo.successorId}.
+ */
+export type DyFM_AI_ModelStatus = 'ga' | 'preview' | 'deprecated';
+/**
+ * Single-model descriptor for the provider model registry.
+ *
+ * The provider registries (`DyFM_OAI_Models`, `DyFM_AAI_Models`, …) are arrays
+ * of these — an SDK-free, data-only source of truth for which models exist and
+ * what each can do. The bare model enums (`DyFM_OAI_Model`, …) remain the typed
+ * id keys; a registry entry's `id` references one of those values.
+ *
+ * Note: model line-ups churn fast (see the 2026-06 research) — keep the registry
+ * current and rely on `status`/`successorId` rather than silently breaking on a
+ * retired id.
+ */
+export interface DyFM_AI_ModelInfo {
+    /** Exact API model string (e.g. 'gpt-5.5', 'claude-opus-4-8', 'gemini-3.5-flash'). */
+    id: string;
+    /** The provider that serves this model. */
+    provider: DyFM_AI_Provider;
+    /** The kind of model (chat / embedding / image / audio). */
+    modelType: DyFM_AI_ModelType;
+    /** What this specific model can DO (feature gates). */
+    capabilities: DyFM_AI_ModelCapabilities;
+    /**
+     * RESERVED (FR-048) — which tuning PARAMETERS this model accepts/rejects.
+     *
+     * Sibling of {@link capabilities}. NOT populated by FR-047 and NOT yet
+     * consumed by any reconciler — reserved space for the future per-model
+     * agnostic settings system. Each model accepts a different settings surface
+     * (e.g. Opus 4.7+ rejects temperature/topP/topK; reasoning models add
+     * reasoningEffort), and that knowledge must be curated continuously like the
+     * model registry itself.
+     *
+     * See: `__agent/feature-requests/FR-048-per-model-agnostic-settings.md`
+     */
+    settingsSchema?: DyFM_AI_ModelSettingsSchema;
+    /** Input context window in tokens, if applicable. */
+    contextWindow?: number;
+    /** Maximum output tokens, if applicable. */
+    maxOutputTokens?: number;
+    /** Lifecycle status; defaults to `ga` when omitted. */
+    status?: DyFM_AI_ModelStatus;
+    /** When `deprecated`/sunsetting, the recommended replacement model id. */
+    successorId?: string;
+    /** When `deprecated`, the earliest known shutdown date (ISO yyyy-mm-dd). */
+    sunsetDate?: string;
+    /** Human-readable name for UI (e.g. 'GPT-5.5', 'Claude Opus 4.8'). */
+    displayName?: string;
+    /** Provider-specific tier label (e.g. 'flagship', 'mini', 'Opus', 'Sonnet', 'Haiku'). */
+    tier?: string;
+}
+//# sourceMappingURL=ai-model-info.interface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ai-model-info.interface.d.ts","sourceRoot":"","sources":["../../../../src/_modules/ai/_models/ai-model-info.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAE,2BAA2B,EAAE,MAAM,sCAAsC,CAAC;AAEnF;;;;;;GAMG;AACH,MAAM,MAAM,mBAAmB,GAAG,IAAI,GAAG,SAAS,GAAG,YAAY,CAAC;AAElE;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,iBAAiB;IAChC,sFAAsF;IACtF,EAAE,EAAE,MAAM,CAAC;IACX,2CAA2C;IAC3C,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,4DAA4D;IAC5D,SAAS,EAAE,iBAAiB,CAAC;IAC7B,uDAAuD;IACvD,YAAY,EAAE,yBAAyB,CAAC;IACxC;;;;;;;;;;;OAWG;IACH,cAAc,CAAC,EAAE,2BAA2B,CAAC;IAC7C,qDAAqD;IACrD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4CAA4C;IAC5C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,uDAAuD;IACvD,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,0EAA0E;IAC1E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4EAA4E;IAC5E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yFAAyF;IACzF,IAAI,CAAC,EAAE,MAAM,CAAC;CACf"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"ai-model-info.interface.js","sourceRoot":"","sources":["../../../../src/_modules/ai/_models/ai-model-info.interface.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,52 @@
+/**
+ * RESERVED — per-model settings schema (FR-048; NOT implemented by FR-047).
+ *
+ * Sibling of {@link DyFM_AI_ModelCapabilities}: capabilities describe what a
+ * model can DO; this describes which tuning PARAMETERS it accepts, their
+ * bounds, and which it REJECTS. A flat {@link DyFM_AI_CallSettings} bag cannot
+ * express this, yet sending an unsupported param can hard-fail a call (e.g.
+ * Anthropic Opus 4.7+ rejects `temperature`/`top_p`/`top_k` with HTTP 400).
+ *
+ * This type reserves the architectural space and documents intent. The
+ * registry consts do NOT populate `settingsSchema` yet, and no reconciler
+ * consumes it yet — both are FR-048 work. The exact shape may evolve when
+ * FR-048 is built; treat this as a forward placeholder, not a frozen contract.
+ *
+ * See: `__agent/feature-requests/FR-048-per-model-agnostic-settings.md`
+ *      `documentations/guidelines/development/ai-per-model-settings.md`
+ */
+export interface DyFM_AI_ModelSettingsSchema {
+    /** Agnostic setting keys this model ACCEPTS (e.g. 'temperature','topP','maxTokens','reasoningEffort'). */
+    supported?: string[];
+    /**
+     * Agnostic setting keys this model REJECTS — sending them errors.
+     * Example: Opus 4.7+ → ['temperature','topP','topK'] (HTTP 400 on non-default).
+     * The future reconciler drops these (debug-log, never silently).
+     */
+    unsupported?: string[];
+    /** Per-key value constraints (range / enum / default). */
+    constraints?: Record<string, DyFM_AI_SettingConstraint>;
+    /**
+     * Provider/model-specific knobs NOT present on the agnostic CallSettings
+     * (e.g. OpenAI 'reasoningEffort', Gemini 'thinkingConfig'). The provider
+     * translator maps these to the native param.
+     */
+    extraParams?: string[];
+}
+/**
+ * RESERVED (FR-048) — value constraint for a single tuning parameter.
+ * Forward placeholder; shape may evolve when FR-048 is built.
+ */
+export interface DyFM_AI_SettingConstraint {
+    /** Minimum numeric value (inclusive), if applicable. */
+    min?: number;
+    /** Maximum numeric value (inclusive), if applicable. */
+    max?: number;
+    /** Default value the provider applies when omitted. */
+    default?: unknown;
+    /** Allowed discrete values (enum-like params, e.g. reasoningEffort). */
+    allowed?: unknown[];
+    /** Free-text note (Hunglish ok) — e.g. provider quirk, version gate. */
+    note?: string;
+}
+//# sourceMappingURL=ai-model-settings-schema.interface.d.ts.map

package/build/_modules/ai/_models/ai-model-settings-schema.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-model-settings-schema.interface.d.ts","sourceRoot":"","sources":["../../../../src/_modules/ai/_models/ai-model-settings-schema.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,2BAA2B;IAC1C,0GAA0G;IAC1G,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC;IACxD;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACxC,wDAAwD;IACxD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,wEAAwE;IACxE,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;IACpB,wEAAwE;IACxE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"ai-model-settings-schema.interface.js","sourceRoot":"","sources":["../../../../src/_modules/ai/_models/ai-model-settings-schema.interface.ts"],"names":[],"mappings":""}

package/build/_modules/ai/_models/ai-tool-call.interface.d.ts

@@ -0,0 +1,19 @@
+/**
+ * A normalized tool invocation requested by the model.
+ *
+ * Each provider's native shape is normalized into this at the translator boundary:
+ *  - OpenAI:    message.tool_calls[] → { id, name, arguments: JSON.parse(function.arguments) }
+ *  - Anthropic: content[] { type:'tool_use', id, name, input } → { id, name, arguments: input }
+ *  - Gemini:    parts[].functionCall { id, name, args } → { id, name, arguments: args }
+ *
+ * `arguments` is ALWAYS a parsed object (OpenAI's JSON string is parsed at the boundary).
+ */
+export interface DyFM_AI_ToolCall {
+    /** Provider call id — echoed back when returning the result. */
+    id: string;
+    /** The invoked tool's name. */
+    name: string;
+    /** Parsed arguments object. */
+    arguments: Record<string, unknown>;
+}
+//# sourceMappingURL=ai-tool-call.interface.d.ts.map

package/build/_modules/ai/_models/ai-tool-call.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-tool-call.interface.d.ts","sourceRoot":"","sources":["../../../../src/_modules/ai/_models/ai-tool-call.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gEAAgE;IAChE,EAAE,EAAE,MAAM,CAAC;IACX,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"ai-tool-call.interface.js","sourceRoot":"","sources":["../../../../src/_modules/ai/_models/ai-tool-call.interface.ts"],"names":[],"mappings":""}