@futdevpro/fsm-dynamo 1.15.16 → 1.15.17

package/build/_modules/ai/_modules/open-ai/_collections/oai-models.const.js

@@ -0,0 +1,240 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyFM_OAI_Models = void 0;
+const ai_provider_enum_1 = require("../../../_enums/ai-provider.enum");
+const ai_model_type_enum_1 = require("../../../_enums/ai-model-type.enum");
+const oai_model_enum_1 = require("../_enums/oai-model.enum");
+/**
+ * OpenAI model registry — verified 2026-06-01 against developers.openai.com docs.
+ *
+ * Contains current GA + still-callable legacy models. Retired models are omitted;
+ * sunsetting ones carry `status: 'deprecated'` + `successorId` + `sunsetDate`.
+ *
+ * Tool-calling note: native function calling is universal across current OpenAI
+ * chat models. The `-pro` reasoning models support tools but NOT streaming and
+ * are Responses-API-only — reflected in `capabilities.streaming`.
+ */
+exports.DyFM_OAI_Models = [
+    // ── Chat / reasoning (current GA) ──
+    {
+        id: oai_model_enum_1.DyFM_OAI_Model.gpt55,
+        provider: ai_provider_enum_1.DyFM_AI_Provider.OpenAI,
+        modelType: ai_model_type_enum_1.DyFM_AI_ModelType.Chat,
+        displayName: 'GPT-5.5',
+        tier: 'flagship',
+        status: 'ga',
+        contextWindow: 1_050_000,
+        maxOutputTokens: 128_000,
+        capabilities: {
+            functionCalling: true,
+            vision: true,
+            streaming: true,
+            jsonMode: true,
+            audioInput: false,
+            audioOutput: false,
+            imageGeneration: false,
+            embeddings: false,
+        },
+    },
+    {
+        id: oai_model_enum_1.DyFM_OAI_Model.gpt55_pro,
+        provider: ai_provider_enum_1.DyFM_AI_Provider.OpenAI,
+        modelType: ai_model_type_enum_1.DyFM_AI_ModelType.Chat,
+        displayName: 'GPT-5.5 Pro',
+        tier: 'pro',
+        status: 'ga',
+        contextWindow: 1_050_000,
+        maxOutputTokens: 128_000,
+        capabilities: {
+            functionCalling: true,
+            vision: true,
+            streaming: false, // Responses-API-only, no streaming
+            jsonMode: true,
+            audioInput: false,
+            audioOutput: false,
+            imageGeneration: false,
+            embeddings: false,
+        },
+    },
+    {
+        id: oai_model_enum_1.DyFM_OAI_Model.gpt54,
+        provider: ai_provider_enum_1.DyFM_AI_Provider.OpenAI,
+        modelType: ai_model_type_enum_1.DyFM_AI_ModelType.Chat,
+        displayName: 'GPT-5.4',
+        tier: 'flagship',
+        status: 'ga',
+        contextWindow: 1_000_000,
+        maxOutputTokens: 128_000,
+        capabilities: {
+            functionCalling: true,
+            vision: true,
+            streaming: true,
+            jsonMode: true,
+            audioInput: false,
+            audioOutput: false,
+            imageGeneration: false,
+            embeddings: false,
+        },
+    },
+    {
+        id: oai_model_enum_1.DyFM_OAI_Model.gpt54_mini,
+        provider: ai_provider_enum_1.DyFM_AI_Provider.OpenAI,
+        modelType: ai_model_type_enum_1.DyFM_AI_ModelType.Chat,
+        displayName: 'GPT-5.4 mini',
+        tier: 'mini',
+        status: 'ga',
+        contextWindow: 400_000,
+        maxOutputTokens: 128_000,
+        capabilities: {
+            functionCalling: true,
+            vision: true,
+            streaming: true,
+            jsonMode: true,
+            audioInput: false,
+            audioOutput: false,
+            imageGeneration: false,
+            embeddings: false,
+        },
+    },
+    {
+        id: oai_model_enum_1.DyFM_OAI_Model.gpt54_nano,
+        provider: ai_provider_enum_1.DyFM_AI_Provider.OpenAI,
+        modelType: ai_model_type_enum_1.DyFM_AI_ModelType.Chat,
+        displayName: 'GPT-5.4 nano',
+        tier: 'nano',
+        status: 'ga',
+        contextWindow: 400_000,
+        maxOutputTokens: 128_000,
+        capabilities: {
+            functionCalling: true,
+            vision: true,
+            streaming: true,
+            jsonMode: true,
+            audioInput: false,
+            audioOutput: false,
+            imageGeneration: false,
+            embeddings: false,
+        },
+    },
+    {
+        id: oai_model_enum_1.DyFM_OAI_Model.o3_pro,
+        provider: ai_provider_enum_1.DyFM_AI_Provider.OpenAI,
+        modelType: ai_model_type_enum_1.DyFM_AI_ModelType.Chat,
+        displayName: 'o3-pro',
+        tier: 'pro',
+        status: 'ga',
+        contextWindow: 200_000,
+        maxOutputTokens: 100_000,
+        capabilities: {
+            functionCalling: true,
+            vision: true,
+            streaming: false, // Responses-API-only, no streaming
+            jsonMode: true,
+            audioInput: false,
+            audioOutput: false,
+            imageGeneration: false,
+            embeddings: false,
+        },
+    },
+    // ── Chat (legacy-active, sunsetting) ──
+    {
+        id: oai_model_enum_1.DyFM_OAI_Model.gpt4o,
+        provider: ai_provider_enum_1.DyFM_AI_Provider.OpenAI,
+        modelType: ai_model_type_enum_1.DyFM_AI_ModelType.Chat,
+        displayName: 'GPT-4o',
+        tier: 'legacy',
+        status: 'deprecated',
+        successorId: oai_model_enum_1.DyFM_OAI_Model.gpt54_mini,
+        sunsetDate: '2026-10-23',
+        contextWindow: 128_000,
+        maxOutputTokens: 16_384,
+        capabilities: {
+            functionCalling: true,
+            vision: true,
+            streaming: true,
+            jsonMode: true,
+            audioInput: false,
+            audioOutput: false,
+            imageGeneration: false,
+            embeddings: false,
+        },
+    },
+    {
+        id: oai_model_enum_1.DyFM_OAI_Model.gpt4o_mini,
+        provider: ai_provider_enum_1.DyFM_AI_Provider.OpenAI,
+        modelType: ai_model_type_enum_1.DyFM_AI_ModelType.Chat,
+        displayName: 'GPT-4o mini',
+        tier: 'legacy',
+        status: 'deprecated',
+        successorId: oai_model_enum_1.DyFM_OAI_Model.gpt54_mini,
+        sunsetDate: '2026-10-23',
+        contextWindow: 128_000,
+        maxOutputTokens: 16_384,
+        capabilities: {
+            functionCalling: true,
+            vision: true,
+            streaming: true,
+            jsonMode: true,
+            audioInput: false,
+            audioOutput: false,
+            imageGeneration: false,
+            embeddings: false,
+        },
+    },
+    // ── Embeddings (current GA) ──
+    {
+        id: oai_model_enum_1.DyFM_OAI_Model.textEmbedding_3Small,
+        provider: ai_provider_enum_1.DyFM_AI_Provider.OpenAI,
+        modelType: ai_model_type_enum_1.DyFM_AI_ModelType.Embedding,
+        displayName: 'text-embedding-3-small',
+        status: 'ga',
+        contextWindow: 8_191,
+        capabilities: {
+            functionCalling: false,
+            vision: false,
+            streaming: false,
+            jsonMode: false,
+            audioInput: false,
+            audioOutput: false,
+            imageGeneration: false,
+            embeddings: true,
+        },
+    },
+    {
+        id: oai_model_enum_1.DyFM_OAI_Model.textEmbedding_3Large,
+        provider: ai_provider_enum_1.DyFM_AI_Provider.OpenAI,
+        modelType: ai_model_type_enum_1.DyFM_AI_ModelType.Embedding,
+        displayName: 'text-embedding-3-large',
+        status: 'ga',
+        contextWindow: 8_191,
+        capabilities: {
+            functionCalling: false,
+            vision: false,
+            streaming: false,
+            jsonMode: false,
+            audioInput: false,
+            audioOutput: false,
+            imageGeneration: false,
+            embeddings: true,
+        },
+    },
+    // ── Image generation (current GA) ──
+    {
+        id: oai_model_enum_1.DyFM_OAI_Model.gptImage_2,
+        provider: ai_provider_enum_1.DyFM_AI_Provider.OpenAI,
+        modelType: ai_model_type_enum_1.DyFM_AI_ModelType.Image,
+        displayName: 'GPT Image 2',
+        status: 'ga',
+        capabilities: {
+            functionCalling: false,
+            vision: true, // accepts image input for editing
+            streaming: false,
+            jsonMode: false,
+            audioInput: false,
+            audioOutput: false,
+            imageGeneration: true,
+            embeddings: false,
+        },
+    },
+];
+//# sourceMappingURL=oai-models.const.js.map

package/build/_modules/ai/_modules/open-ai/_collections/oai-models.const.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oai-models.const.js","sourceRoot":"","sources":["../../../../../../src/_modules/ai/_modules/open-ai/_collections/oai-models.const.ts"],"names":[],"mappings":"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"}

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

@@ -2,6 +2,14 @@
  * Models available through the OpenAI API.
  */
 export declare enum DyFM_OAI_Model {
+    gpt55 = "gpt-5.5",
+    gpt55_pro = "gpt-5.5-pro",
+    gpt54 = "gpt-5.4",
+    gpt54_mini = "gpt-5.4-mini",
+    gpt54_nano = "gpt-5.4-nano",
+    o3_pro = "o3-pro",
+    gptImage_2 = "gpt-image-2",
+    gptImage_1 = "gpt-image-1",
     gpt5 = "gpt-5",
     gpt51 = "gpt-5.1",
     gpt5_mini = "gpt-5-mini",

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

@@ -1 +1 @@
-{"version":3,"file":"oai-model.enum.d.ts","sourceRoot":"","sources":["../../../../../../src/_modules/ai/_modules/open-ai/_enums/oai-model.enum.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,oBAAY,cAAc;IAExB,IAAI,UAAU;IACd,KAAK,YAAY;IACjB,SAAS,eAAe;IACxB,SAAS,eAAe;IACxB,eAAe,sBAAsB;IACrC,gBAAgB,wBAAwB;IACxC,UAAU,gBAAgB;IAC1B,WAAW,kBAAkB;IAa7B,KAAK,WAAW,CAAE,0BAA0B;IAE5C,cAAc,sBAAsB,CAAE,6BAA6B;IAEnE,cAAc,sBAAsB,CAAE,0BAA0B;IAYhE,UAAU,gBAAgB,CAAE,6BAA6B;IAEzD,kBAAkB,2BAA2B,CAAE,gCAAgC;IAuB/E;;;OAGG;IACH,oBAAoB,2BAA2B,CAAE,wBAAwB;IACzE;;;OAGG;IACH,oBAAoB,2BAA2B,CAAE,wBAAwB;IACzE;;;OAGG;IACH,oBAAoB,2BAA2B;CAsEhD;AAED,MAAM,MAAM,uBAAuB,GACjC,cAAc,CAAC,oBAAoB,GACnC,cAAc,CAAC,oBAAoB,GACnC,cAAc,CAAC,oBAAoB,CAAC;AAEtC,eAAO,MAAM,2BAA2B,EAAE,uBAAuB,EAIhE,CAAC"}
+{"version":3,"file":"oai-model.enum.d.ts","sourceRoot":"","sources":["../../../../../../src/_modules/ai/_modules/open-ai/_enums/oai-model.enum.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,oBAAY,cAAc;IAExB,KAAK,YAAY;IACjB,SAAS,gBAAgB;IACzB,KAAK,YAAY;IACjB,UAAU,iBAAiB;IAC3B,UAAU,iBAAiB;IAC3B,MAAM,WAAW;IAEjB,UAAU,gBAAgB;IAC1B,UAAU,gBAAgB;IAG1B,IAAI,UAAU;IACd,KAAK,YAAY;IACjB,SAAS,eAAe;IACxB,SAAS,eAAe;IACxB,eAAe,sBAAsB;IACrC,gBAAgB,wBAAwB;IACxC,UAAU,gBAAgB;IAC1B,WAAW,kBAAkB;IAa7B,KAAK,WAAW,CAAE,0BAA0B;IAE5C,cAAc,sBAAsB,CAAE,6BAA6B;IAEnE,cAAc,sBAAsB,CAAE,0BAA0B;IAYhE,UAAU,gBAAgB,CAAE,6BAA6B;IAEzD,kBAAkB,2BAA2B,CAAE,gCAAgC;IAuB/E;;;OAGG;IACH,oBAAoB,2BAA2B,CAAE,wBAAwB;IACzE;;;OAGG;IACH,oBAAoB,2BAA2B,CAAE,wBAAwB;IACzE;;;OAGG;IACH,oBAAoB,2BAA2B;CAsEhD;AAED,MAAM,MAAM,uBAAuB,GACjC,cAAc,CAAC,oBAAoB,GACnC,cAAc,CAAC,oBAAoB,GACnC,cAAc,CAAC,oBAAoB,CAAC;AAEtC,eAAO,MAAM,2BAA2B,EAAE,uBAAuB,EAIhE,CAAC"}

package/build/_modules/ai/_modules/open-ai/_enums/oai-model.enum.js

@@ -6,6 +6,16 @@ exports.DyFM_OAI_allEmbeddingModels = exports.DyFM_OAI_Model = void 0;
  */
 var DyFM_OAI_Model;
 (function (DyFM_OAI_Model) {
+    // GPT-5.5 / 5.4 (current flagships — verified 2026-06)
+    DyFM_OAI_Model["gpt55"] = "gpt-5.5";
+    DyFM_OAI_Model["gpt55_pro"] = "gpt-5.5-pro";
+    DyFM_OAI_Model["gpt54"] = "gpt-5.4";
+    DyFM_OAI_Model["gpt54_mini"] = "gpt-5.4-mini";
+    DyFM_OAI_Model["gpt54_nano"] = "gpt-5.4-nano";
+    DyFM_OAI_Model["o3_pro"] = "o3-pro";
+    // Image generation (current)
+    DyFM_OAI_Model["gptImage_2"] = "gpt-image-2";
+    DyFM_OAI_Model["gptImage_1"] = "gpt-image-1";
     // GPT-5
     DyFM_OAI_Model["gpt5"] = "gpt-5";
     DyFM_OAI_Model["gpt51"] = "gpt-5.1";

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

@@ -1 +1 @@
-{"version":3,"file":"oai-model.enum.js","sourceRoot":"","sources":["../../../../../../src/_modules/ai/_modules/open-ai/_enums/oai-model.enum.ts"],"names":[],"mappings":";;;AAKA;;GAEG;AACH,IAAY,cAmJX;AAnJD,WAAY,cAAc;IACxB,QAAQ;IACR,gCAAc,CAAA;IACd,mCAAiB,CAAA;IACjB,0CAAwB,CAAA;IACxB,0CAAwB,CAAA;IACxB,uDAAqC,CAAA;IACrC,0DAAwC,CAAA;IACxC,4CAA0B,CAAA;IAC1B,+CAA6B,CAAA;IAC7B,6BAA6B,CAAC,iBAAiB;IAE/C,UAAU;IACV;;;;;+DAK2D;IAE3D,QAAQ;IACR,QAAQ;IACR,kCAAgB,CAAA;IAChB,oBAAoB;IACpB,sDAAoC,CAAA;IACpC,oBAAoB;IACpB,sDAAoC,CAAA;IAEpC;;;;;;iDAM6C;IAE7C,WAAW;IACX,cAAc;IACd,4CAA0B,CAAA;IAC1B,yBAAyB;IACzB,+DAA6C,CAAA;IAG7C,SAAS;IACT;;;qDAGiD;IAEjD,SAAS;IACT;;;+BAG2B;IAE3B,uBAAuB;IACvB;;;;+BAI2B;IAE3B,kBAAkB;IAClB;;;OAGG;IACH,iEAA+C,CAAA;IAC/C;;;OAGG;IACH,iEAA+C,CAAA;IAC/C;;;OAGG;IACH,iEAA+C,CAAA;IAE/C;;uDAEmD;IAEnD,sBAAsB;IACtB;;wDAEoD;IAGpD,iCAAiC;IAYjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kCA6C8B;AAChC,CAAC,EAnJW,cAAc,8BAAd,cAAc,QAmJzB;AAOY,QAAA,2BAA2B,GAA8B;IACpE,cAAc,CAAC,oBAAoB;IACnC,cAAc,CAAC,oBAAoB;IACnC,cAAc,CAAC,oBAAoB;CACpC,CAAC"}
+{"version":3,"file":"oai-model.enum.js","sourceRoot":"","sources":["../../../../../../src/_modules/ai/_modules/open-ai/_enums/oai-model.enum.ts"],"names":[],"mappings":";;;AAKA;;GAEG;AACH,IAAY,cA8JX;AA9JD,WAAY,cAAc;IACxB,uDAAuD;IACvD,mCAAiB,CAAA;IACjB,2CAAyB,CAAA;IACzB,mCAAiB,CAAA;IACjB,6CAA2B,CAAA;IAC3B,6CAA2B,CAAA;IAC3B,mCAAiB,CAAA;IACjB,6BAA6B;IAC7B,4CAA0B,CAAA;IAC1B,4CAA0B,CAAA;IAE1B,QAAQ;IACR,gCAAc,CAAA;IACd,mCAAiB,CAAA;IACjB,0CAAwB,CAAA;IACxB,0CAAwB,CAAA;IACxB,uDAAqC,CAAA;IACrC,0DAAwC,CAAA;IACxC,4CAA0B,CAAA;IAC1B,+CAA6B,CAAA;IAC7B,6BAA6B,CAAC,iBAAiB;IAE/C,UAAU;IACV;;;;;+DAK2D;IAE3D,QAAQ;IACR,QAAQ;IACR,kCAAgB,CAAA;IAChB,oBAAoB;IACpB,sDAAoC,CAAA;IACpC,oBAAoB;IACpB,sDAAoC,CAAA;IAEpC;;;;;;iDAM6C;IAE7C,WAAW;IACX,cAAc;IACd,4CAA0B,CAAA;IAC1B,yBAAyB;IACzB,+DAA6C,CAAA;IAG7C,SAAS;IACT;;;qDAGiD;IAEjD,SAAS;IACT;;;+BAG2B;IAE3B,uBAAuB;IACvB;;;;+BAI2B;IAE3B,kBAAkB;IAClB;;;OAGG;IACH,iEAA+C,CAAA;IAC/C;;;OAGG;IACH,iEAA+C,CAAA;IAC/C;;;OAGG;IACH,iEAA+C,CAAA;IAE/C;;uDAEmD;IAEnD,sBAAsB;IACtB;;wDAEoD;IAGpD,iCAAiC;IAYjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kCA6C8B;AAChC,CAAC,EA9JW,cAAc,8BAAd,cAAc,QA8JzB;AAOY,QAAA,2BAA2B,GAA8B;IACpE,cAAc,CAAC,oBAAoB;IACnC,cAAc,CAAC,oBAAoB;IACnC,cAAc,CAAC,oBAAoB;CACpC,CAAC"}

package/build/_modules/ai/_modules/open-ai/index.d.ts

@@ -1,4 +1,5 @@
 export * from './_collections/oai-embedding-model-dimensions.const';
+export * from './_collections/oai-models.const';
 export * from './_enums/oai-model.enum';
 export * from './_models/oai-call-settings.control-model';
 export * from './_models/oai-client-options.interface';

package/build/_modules/ai/_modules/open-ai/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/_modules/ai/_modules/open-ai/index.ts"],"names":[],"mappings":"AAaA,cAAc,qDAAqD,CAAC;AAGpE,cAAc,yBAAyB,CAAC;AAGxC,cAAc,2CAA2C,CAAC;AAC1D,cAAc,wCAAwC,CAAC;AACvD,cAAc,wCAAwC,CAAC;AACvD,cAAc,sCAAsC,CAAC;AACrD,cAAc,kDAAkD,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/_modules/ai/_modules/open-ai/index.ts"],"names":[],"mappings":"AAaA,cAAc,qDAAqD,CAAC;AACpE,cAAc,iCAAiC,CAAC;AAGhD,cAAc,yBAAyB,CAAC;AAGxC,cAAc,2CAA2C,CAAC;AAC1D,cAAc,wCAAwC,CAAC;AACvD,cAAc,wCAAwC,CAAC;AACvD,cAAc,sCAAsC,CAAC;AACrD,cAAc,kDAAkD,CAAC"}

package/build/_modules/ai/_modules/open-ai/index.js

@@ -11,6 +11,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
 // COLLECTIONS
 tslib_1.__exportStar(require("./_collections/oai-embedding-model-dimensions.const"), exports);
+tslib_1.__exportStar(require("./_collections/oai-models.const"), exports);
 // ENUMS
 tslib_1.__exportStar(require("./_enums/oai-model.enum"), exports);
 // MODELS

package/build/_modules/ai/_modules/open-ai/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/_modules/ai/_modules/open-ai/index.ts"],"names":[],"mappings":";AAGA;;;;;;;IAOI;;;AAEJ,cAAc;AACd,8FAAoE;AAEpE,QAAQ;AACR,kEAAwC;AAExC,SAAS;AACT,oFAA0D;AAC1D,iFAAuD;AACvD,iFAAuD;AACvD,+EAAqD;AACrD,2FAAiE"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/_modules/ai/_modules/open-ai/index.ts"],"names":[],"mappings":";AAGA;;;;;;;IAOI;;;AAEJ,cAAc;AACd,8FAAoE;AACpE,0EAAgD;AAEhD,QAAQ;AACR,kEAAwC;AAExC,SAAS;AACT,oFAA0D;AAC1D,iFAAuD;AACvD,iFAAuD;AACvD,+EAAqD;AACrD,2FAAiE"}

package/build/_modules/ai/index.d.ts

@@ -1,4 +1,5 @@
 export * from './_collections/ai-model-ref.util';
+export * from './_collections/ai-model-registry.util';
 export * from './_enums/ai-provider.enum';
 export * from './_enums/ai-model-type.enum';
 export * from './_enums/ai-message-role.enum';
@@ -9,7 +10,14 @@ export * from './_models/ai-embedding-response.interface';
 export * from './_models/ai-llm-request.interface';
 export * from './_models/ai-llm-response.interface';
 export * from './_models/ai-message.interface';
+export * from './_models/ai-model-capabilities.interface';
+export * from './_models/ai-model-info.interface';
+export * from './_models/ai-model-settings-schema.interface';
 export * from './_models/ai-provider-capabilities.interface';
 export * from './_models/ai-settings.interface';
+export * from './_models/ai-tool.interface';
+export * from './_models/ai-tool-call.interface';
+export * from './_models/ai-tool-result.interface';
+export * from './_models/ai-tool-handler.type';
 export * from './_models/ai-user-provider-config.control-model';
 //# sourceMappingURL=index.d.ts.map

package/build/_modules/ai/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/_modules/ai/index.ts"],"names":[],"mappings":"AACA,cAAc,kCAAkC,CAAC;AAGjD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAG9C,cAAc,sCAAsC,CAAC;AACrD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0CAA0C,CAAC;AACzD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,oCAAoC,CAAC;AACnD,cAAc,qCAAqC,CAAC;AACpD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8CAA8C,CAAC;AAC7D,cAAc,iCAAiC,CAAC;AAChD,cAAc,iDAAiD,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/_modules/ai/index.ts"],"names":[],"mappings":"AACA,cAAc,kCAAkC,CAAC;AACjD,cAAc,uCAAuC,CAAC;AAGtD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAG9C,cAAc,sCAAsC,CAAC;AACrD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0CAA0C,CAAC;AACzD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,oCAAoC,CAAC;AACnD,cAAc,qCAAqC,CAAC;AACpD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2CAA2C,CAAC;AAC1D,cAAc,mCAAmC,CAAC;AAClD,cAAc,8CAA8C,CAAC;AAC7D,cAAc,8CAA8C,CAAC;AAC7D,cAAc,iCAAiC,CAAC;AAChD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kCAAkC,CAAC;AACjD,cAAc,oCAAoC,CAAC;AACnD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iDAAiD,CAAC"}

package/build/_modules/ai/index.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
 // COLLECTIONS
 tslib_1.__exportStar(require("./_collections/ai-model-ref.util"), exports);
+tslib_1.__exportStar(require("./_collections/ai-model-registry.util"), exports);
 // ENUMS
 tslib_1.__exportStar(require("./_enums/ai-provider.enum"), exports);
 tslib_1.__exportStar(require("./_enums/ai-model-type.enum"), exports);
@@ -15,7 +16,14 @@ tslib_1.__exportStar(require("./_models/ai-embedding-response.interface"), expor
 tslib_1.__exportStar(require("./_models/ai-llm-request.interface"), exports);
 tslib_1.__exportStar(require("./_models/ai-llm-response.interface"), exports);
 tslib_1.__exportStar(require("./_models/ai-message.interface"), exports);
+tslib_1.__exportStar(require("./_models/ai-model-capabilities.interface"), exports);
+tslib_1.__exportStar(require("./_models/ai-model-info.interface"), exports);
+tslib_1.__exportStar(require("./_models/ai-model-settings-schema.interface"), exports);
 tslib_1.__exportStar(require("./_models/ai-provider-capabilities.interface"), exports);
 tslib_1.__exportStar(require("./_models/ai-settings.interface"), exports);
+tslib_1.__exportStar(require("./_models/ai-tool.interface"), exports);
+tslib_1.__exportStar(require("./_models/ai-tool-call.interface"), exports);
+tslib_1.__exportStar(require("./_models/ai-tool-result.interface"), exports);
+tslib_1.__exportStar(require("./_models/ai-tool-handler.type"), exports);
 tslib_1.__exportStar(require("./_models/ai-user-provider-config.control-model"), exports);
 //# sourceMappingURL=index.js.map

package/build/_modules/ai/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/_modules/ai/index.ts"],"names":[],"mappings":";;;AAAA,cAAc;AACd,2EAAiD;AAEjD,QAAQ;AACR,oEAA0C;AAC1C,sEAA4C;AAC5C,wEAA8C;AAE9C,SAAS;AACT,+EAAqD;AACrD,wEAA8C;AAC9C,mFAAyD;AACzD,oFAA0D;AAC1D,6EAAmD;AACnD,8EAAoD;AACpD,yEAA+C;AAC/C,uFAA6D;AAC7D,0EAAgD;AAChD,0FAAgE"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/_modules/ai/index.ts"],"names":[],"mappings":";;;AAAA,cAAc;AACd,2EAAiD;AACjD,gFAAsD;AAEtD,QAAQ;AACR,oEAA0C;AAC1C,sEAA4C;AAC5C,wEAA8C;AAE9C,SAAS;AACT,+EAAqD;AACrD,wEAA8C;AAC9C,mFAAyD;AACzD,oFAA0D;AAC1D,6EAAmD;AACnD,8EAAoD;AACpD,yEAA+C;AAC/C,oFAA0D;AAC1D,4EAAkD;AAClD,uFAA6D;AAC7D,uFAA6D;AAC7D,0EAAgD;AAChD,sEAA4C;AAC5C,2EAAiD;AACjD,6EAAmD;AACnD,yEAA+C;AAC/C,0FAAgE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@futdevpro/fsm-dynamo",
-  "version": "01.15.16",
+  "version": "01.15.17",
   "description": "Full Stack Model Collection for Dynamic (NodeJS-Typescript) Framework called Dynamo, by Future Development Ltd.",
   "DyBu_settings": {
     "packageType": "full-stack-package",

package/src/_modules/ai/_collections/ai-model-registry.util.spec.ts

@@ -0,0 +1,37 @@
+import { DyFM_AI_ModelRegistry_Util } from './ai-model-registry.util';
+import { DyFM_OAI_Models } from '../_modules/open-ai/_collections/oai-models.const';
+import { DyFM_OAI_Model } from '../_modules/open-ai/_enums/oai-model.enum';
+
+describe('| DyFM_AI_ModelRegistry_Util', (): void => {
+
+  describe('| findModelInfo', (): void => {
+    it('| should find a known model by id', (): void => {
+      const info = DyFM_AI_ModelRegistry_Util.findModelInfo(DyFM_OAI_Models, DyFM_OAI_Model.gpt55);
+
+      expect(info).toBeTruthy();
+      expect(info?.id).toBe(DyFM_OAI_Model.gpt55);
+    });
+
+    it('| should return undefined for an unknown id', (): void => {
+      const info = DyFM_AI_ModelRegistry_Util.findModelInfo(DyFM_OAI_Models, 'no-such-model');
+
+      expect(info).toBeUndefined();
+    });
+  });
+
+  describe('| modelSupportsTools', (): void => {
+    it('| should return true for a tool-capable chat model', (): void => {
+      expect(DyFM_AI_ModelRegistry_Util.modelSupportsTools(DyFM_OAI_Models, DyFM_OAI_Model.gpt55)).toBe(true);
+    });
+
+    it('| should return false for an embedding model', (): void => {
+      expect(
+        DyFM_AI_ModelRegistry_Util.modelSupportsTools(DyFM_OAI_Models, DyFM_OAI_Model.textEmbedding_3Small)
+      ).toBe(false);
+    });
+
+    it('| should return false for an unknown id (no assumption of tool support)', (): void => {
+      expect(DyFM_AI_ModelRegistry_Util.modelSupportsTools(DyFM_OAI_Models, 'no-such-model')).toBe(false);
+    });
+  });
+});

package/src/_modules/ai/_collections/ai-model-registry.util.ts

@@ -0,0 +1,30 @@
+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 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 {
+    return models.find((model: DyFM_AI_ModelInfo) => 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: DyFM_AI_ModelInfo[], id: string): boolean {
+    return DyFM_AI_ModelRegistry_Util.findModelInfo(models, id)?.capabilities?.functionCalling ?? false;
+  }
+}

package/src/_modules/ai/_enums/ai-message-role.enum.ts

@@ -2,4 +2,6 @@ export enum DyFM_AI_MessageRole {
   system = 'system',
   user = 'user',
   assistant = 'assistant',
+  /** Tool-result message (function calling). Provider translators map this to their native shape. */
+  tool = 'tool',
 }

package/src/_modules/ai/_enums/ai-model-type.enum.ts

@@ -2,4 +2,6 @@ export enum DyFM_AI_ModelType {
   LLM = 'llm',
   Embedding = 'embedding',
   Chat = 'chat',
+  Image = 'image',
+  Audio = 'audio',
 }

package/src/_modules/ai/_models/ai-call-settings.interface.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 class DyFM_AI_CallSettings {
   systemPrompt?: string = '';
   useModel?: string;

package/src/_modules/ai/_models/ai-llm-response.interface.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
@@ -13,6 +14,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; // Provider-specific raw response
 }
 

package/src/_modules/ai/_models/ai-message.interface.ts

@@ -1,7 +1,12 @@
 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;
 }
 

package/src/_modules/ai/_models/ai-model-capabilities.interface.ts

@@ -0,0 +1,27 @@
+/**
+ * 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;
+}

package/src/_modules/ai/_models/ai-model-info.interface.ts

@@ -0,0 +1,63 @@
+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;
+}