@futdevpro/nts-dynamo 1.15.463 → 1.15.465

package/build/_modules/ai/_models/interfaces/dynts-ai-agent-rendered-context.interface.d.ts

@@ -0,0 +1,12 @@
+import { DyNTS_AI_Agent_ContextItem_Interface } from './dynts-ai-agent-context-item.interface';
+import { DyNTS_AI_Agent_ContextReport_Interface } from './dynts-ai-agent-context-report.interface';
+/** BFR-MYASSISTANT-026 — the context block of a message, as it is sent. */
+export interface DyNTS_AI_Agent_RenderedContext_Interface {
+    /** The block in front of the message (empty: no context goes). */
+    text: string;
+    /** What happened to each item. */
+    report: DyNTS_AI_Agent_ContextReport_Interface;
+    /** The items as they went (a cut item with its cut text). */
+    sentItems: DyNTS_AI_Agent_ContextItem_Interface[];
+}
+//# sourceMappingURL=dynts-ai-agent-rendered-context.interface.d.ts.map

package/build/_modules/ai/_models/interfaces/dynts-ai-agent-rendered-context.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynts-ai-agent-rendered-context.interface.d.ts","sourceRoot":"","sources":["../../../../../src/_modules/ai/_models/interfaces/dynts-ai-agent-rendered-context.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oCAAoC,EAAE,MAAM,yCAAyC,CAAC;AAC/F,OAAO,EAAE,sCAAsC,EAAE,MAAM,2CAA2C,CAAC;AAEnG,2EAA2E;AAC3E,MAAM,WAAW,wCAAwC;IACvD,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,MAAM,EAAE,sCAAsC,CAAC;IAC/C,6DAA6D;IAC7D,SAAS,EAAE,oCAAoC,EAAE,CAAC;CACnD"}

package/build/_modules/ai/_models/interfaces/dynts-ai-agent-rendered-context.interface.js

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

package/build/_modules/ai/_models/interfaces/dynts-ai-agent-rendered-context.interface.js.map

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

package/build/_modules/ai/_models/interfaces/dynts-ai-agent-result.interface.d.ts

@@ -0,0 +1,12 @@
+import { DyNTS_AI_Agent_ContextReport_Interface } from './dynts-ai-agent-context-report.interface';
+import { DyNTS_AI_Agent_Turn_Interface } from './dynts-ai-agent-turn.interface';
+/** BFR-MYASSISTANT-026 — the answer of a `run`: the turn to store, and what happened to the context. */
+export interface DyNTS_AI_Agent_Result_Interface {
+    /** The final answer (= `turn.answer`). */
+    answer: string;
+    /** The exchange to append to the history. */
+    turn: DyNTS_AI_Agent_Turn_Interface;
+    /** Which context items were sent, cut, dropped or switched off. */
+    contextReport: DyNTS_AI_Agent_ContextReport_Interface;
+}
+//# sourceMappingURL=dynts-ai-agent-result.interface.d.ts.map

package/build/_modules/ai/_models/interfaces/dynts-ai-agent-result.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynts-ai-agent-result.interface.d.ts","sourceRoot":"","sources":["../../../../../src/_modules/ai/_models/interfaces/dynts-ai-agent-result.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sCAAsC,EAAE,MAAM,2CAA2C,CAAC;AACnG,OAAO,EAAE,6BAA6B,EAAE,MAAM,iCAAiC,CAAC;AAEhF,wGAAwG;AACxG,MAAM,WAAW,+BAA+B;IAC9C,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,IAAI,EAAE,6BAA6B,CAAC;IACpC,mEAAmE;IACnE,aAAa,EAAE,sCAAsC,CAAC;CACvD"}

package/build/_modules/ai/_models/interfaces/dynts-ai-agent-result.interface.js

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

package/build/_modules/ai/_models/interfaces/dynts-ai-agent-result.interface.js.map

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

package/build/_modules/ai/_models/interfaces/dynts-ai-agent-settings.interface.d.ts

@@ -0,0 +1,20 @@
+import { DyFM_AI_CallSettings } from '@futdevpro/fsm-dynamo/ai';
+import { DyNTS_AI_Agent_Llm_Interface } from './dynts-ai-agent-llm.interface';
+/** BFR-MYASSISTANT-026 — the setup of a `DyNTS_AI_Agent_ControlService`. */
+export interface DyNTS_AI_Agent_Settings_Interface {
+    /** The model (any `DyNTS_AI_LLM_ServiceBase` provider). */
+    llm: DyNTS_AI_Agent_Llm_Interface;
+    /** The agent's instructions (default: the call settings' own system prompt). */
+    systemPrompt?: string;
+    /** The call settings (default: the provider's `defaultSettings`). */
+    callSettings?: DyFM_AI_CallSettings;
+    /** The most tool rounds of one answer (default 8). */
+    maxIterations?: number;
+    /** How many earlier turns are sent (default 20, the latest ones). */
+    historyLimit?: number;
+    /** The most context characters sent with a message (default 12 000). */
+    maxContextLength?: number;
+    /** The most characters of one tool result given to the model (default 20 000). */
+    maxToolResultLength?: number;
+}
+//# sourceMappingURL=dynts-ai-agent-settings.interface.d.ts.map

package/build/_modules/ai/_models/interfaces/dynts-ai-agent-settings.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynts-ai-agent-settings.interface.d.ts","sourceRoot":"","sources":["../../../../../src/_modules/ai/_models/interfaces/dynts-ai-agent-settings.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEhE,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAE9E,4EAA4E;AAC5E,MAAM,WAAW,iCAAiC;IAChD,2DAA2D;IAC3D,GAAG,EAAE,4BAA4B,CAAC;IAClC,gFAAgF;IAChF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qEAAqE;IACrE,YAAY,CAAC,EAAE,oBAAoB,CAAC;IACpC,sDAAsD;IACtD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qEAAqE;IACrE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kFAAkF;IAClF,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B"}

package/build/_modules/ai/_models/interfaces/dynts-ai-agent-settings.interface.js

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

package/build/_modules/ai/_models/interfaces/dynts-ai-agent-settings.interface.js.map

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

package/build/_modules/ai/_models/interfaces/dynts-ai-agent-tool-run.interface.d.ts

@@ -0,0 +1,16 @@
+/** BFR-MYASSISTANT-026 — the record of one tool run in an answer (for the UI and the audit). */
+export interface DyNTS_AI_Agent_ToolRun_Interface {
+    /** The tool's name. */
+    toolName: string;
+    /** The arguments the model gave. */
+    arguments: Record<string, unknown>;
+    /** The handler threw (the model got an `ERROR …` result). */
+    isError: boolean;
+    /** How long the handler ran. */
+    durationMs: number;
+    /** The length of the handler's result (before any cut). */
+    resultLength: number;
+    /** The result was longer than `maxToolResultLength`: the model got the first part only. */
+    isResultTruncated: boolean;
+}
+//# sourceMappingURL=dynts-ai-agent-tool-run.interface.d.ts.map

package/build/_modules/ai/_models/interfaces/dynts-ai-agent-tool-run.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynts-ai-agent-tool-run.interface.d.ts","sourceRoot":"","sources":["../../../../../src/_modules/ai/_models/interfaces/dynts-ai-agent-tool-run.interface.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,MAAM,WAAW,gCAAgC;IAC/C,uBAAuB;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,6DAA6D;IAC7D,OAAO,EAAE,OAAO,CAAC;IACjB,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,YAAY,EAAE,MAAM,CAAC;IACrB,2FAA2F;IAC3F,iBAAiB,EAAE,OAAO,CAAC;CAC5B"}

package/build/_modules/ai/_models/interfaces/dynts-ai-agent-tool-run.interface.js

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

package/build/_modules/ai/_models/interfaces/dynts-ai-agent-tool-run.interface.js.map

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

package/build/_modules/ai/_models/interfaces/dynts-ai-agent-tool.interface.d.ts

@@ -0,0 +1,13 @@
+import { DyFM_AI_Tool, DyFM_AI_ToolHandler } from '@futdevpro/fsm-dynamo/ai';
+/**
+ * BFR-MYASSISTANT-026 — one custom tool of a `DyNTS_AI_Agent_ControlService`: the definition the model sees
+ * (`name`, `description`, `parameters` JSON Schema) and the handler that runs it, in ONE object.
+ *
+ * The handler gets the parsed arguments and returns the result text (fed back to the model). A thrown error becomes
+ * an `ERROR …` result for the model (the loop goes on); it never reaches the user as a technical message.
+ */
+export interface DyNTS_AI_Agent_Tool_Interface extends DyFM_AI_Tool {
+    /** Runs the tool. */
+    handler: DyFM_AI_ToolHandler;
+}
+//# sourceMappingURL=dynts-ai-agent-tool.interface.d.ts.map

package/build/_modules/ai/_models/interfaces/dynts-ai-agent-tool.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynts-ai-agent-tool.interface.d.ts","sourceRoot":"","sources":["../../../../../src/_modules/ai/_models/interfaces/dynts-ai-agent-tool.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE7E;;;;;;GAMG;AACH,MAAM,WAAW,6BAA8B,SAAQ,YAAY;IACjE,qBAAqB;IACrB,OAAO,EAAE,mBAAmB,CAAC;CAC9B"}

package/build/_modules/ai/_models/interfaces/dynts-ai-agent-tool.interface.js

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

package/build/_modules/ai/_models/interfaces/dynts-ai-agent-tool.interface.js.map

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

package/build/_modules/ai/_models/interfaces/dynts-ai-agent-turn.interface.d.ts

@@ -0,0 +1,23 @@
+import { DyNTS_AI_Agent_ContextItem_Interface } from './dynts-ai-agent-context-item.interface';
+import { DyNTS_AI_Agent_ToolRun_Interface } from './dynts-ai-agent-tool-run.interface';
+/**
+ * BFR-MYASSISTANT-026 — one finished exchange, as the project stores it. The next request's history is built from
+ * `message` + `answer` only: the `context` stays bound to this message (shown / audited), it is NOT resent.
+ */
+export interface DyNTS_AI_Agent_Turn_Interface {
+    /** The user's message, without the context. */
+    message: string;
+    /** The final answer. */
+    answer: string;
+    /** The context items that went with the message (as sent; empty: none). */
+    context: DyNTS_AI_Agent_ContextItem_Interface[];
+    /** The tools that ran for this answer. */
+    toolRuns: DyNTS_AI_Agent_ToolRun_Interface[];
+    /** The model that answered. */
+    model?: string;
+    /** The tokens of the FINAL model call (the loop does not sum the earlier tool rounds). */
+    finalCallTokens?: number;
+    /** When it was answered (epoch ms). */
+    createdAt: number;
+}
+//# sourceMappingURL=dynts-ai-agent-turn.interface.d.ts.map

package/build/_modules/ai/_models/interfaces/dynts-ai-agent-turn.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynts-ai-agent-turn.interface.d.ts","sourceRoot":"","sources":["../../../../../src/_modules/ai/_models/interfaces/dynts-ai-agent-turn.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oCAAoC,EAAE,MAAM,yCAAyC,CAAC;AAC/F,OAAO,EAAE,gCAAgC,EAAE,MAAM,qCAAqC,CAAC;AAEvF;;;GAGG;AACH,MAAM,WAAW,6BAA6B;IAC5C,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,wBAAwB;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,OAAO,EAAE,oCAAoC,EAAE,CAAC;IAChD,0CAA0C;IAC1C,QAAQ,EAAE,gCAAgC,EAAE,CAAC;IAC7C,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0FAA0F;IAC1F,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/build/_modules/ai/_models/interfaces/dynts-ai-agent-turn.interface.js

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

package/build/_modules/ai/_models/interfaces/dynts-ai-agent-turn.interface.js.map

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

package/build/_modules/ai/_models/interfaces/dynts-ai-field-assist-complete.type.d.ts

@@ -0,0 +1,8 @@
+import { DyFM_AI_LLM_Response } from '@futdevpro/fsm-dynamo/ai';
+import { DyNTS_AI_FieldAssist_Messages_Interface } from './dynts-ai-field-assist-messages.interface';
+/**
+ * BFR-MYASSISTANT-009 — the project's LLM call (its provider, its key, its token accounting): two messages in, the
+ * normalized response out (`content`, `usage`, `model`).
+ */
+export type DyNTS_AI_FieldAssist_Complete = (messages: DyNTS_AI_FieldAssist_Messages_Interface) => Promise<DyFM_AI_LLM_Response>;
+//# sourceMappingURL=dynts-ai-field-assist-complete.type.d.ts.map

package/build/_modules/ai/_models/interfaces/dynts-ai-field-assist-complete.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynts-ai-field-assist-complete.type.d.ts","sourceRoot":"","sources":["../../../../../src/_modules/ai/_models/interfaces/dynts-ai-field-assist-complete.type.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEhE,OAAO,EAAE,uCAAuC,EAAE,MAAM,4CAA4C,CAAC;AAErG;;;GAGG;AACH,MAAM,MAAM,6BAA6B,GACvC,CAAC,QAAQ,EAAE,uCAAuC,KAAK,OAAO,CAAC,oBAAoB,CAAC,CAAC"}

package/build/_modules/ai/_models/interfaces/dynts-ai-field-assist-complete.type.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=dynts-ai-field-assist-complete.type.js.map

package/build/_modules/ai/_models/interfaces/dynts-ai-field-assist-complete.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynts-ai-field-assist-complete.type.js","sourceRoot":"","sources":["../../../../../src/_modules/ai/_models/interfaces/dynts-ai-field-assist-complete.type.ts"],"names":[],"mappings":""}

package/build/_modules/ai/_models/interfaces/dynts-ai-field-assist-messages.interface.d.ts

@@ -0,0 +1,6 @@
+/** BFR-MYASSISTANT-009 — the two messages of a field-assist call (for any provider's simple request). */
+export interface DyNTS_AI_FieldAssist_Messages_Interface {
+    systemMessage: string;
+    userMessage: string;
+}
+//# sourceMappingURL=dynts-ai-field-assist-messages.interface.d.ts.map

package/build/_modules/ai/_models/interfaces/dynts-ai-field-assist-messages.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynts-ai-field-assist-messages.interface.d.ts","sourceRoot":"","sources":["../../../../../src/_modules/ai/_models/interfaces/dynts-ai-field-assist-messages.interface.ts"],"names":[],"mappings":"AAAA,yGAAyG;AACzG,MAAM,WAAW,uCAAuC;IACtD,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACrB"}

package/build/_modules/ai/_models/interfaces/dynts-ai-field-assist-messages.interface.js

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

package/build/_modules/ai/_models/interfaces/dynts-ai-field-assist-messages.interface.js.map

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

package/build/_modules/ai/_models/interfaces/dynts-ai-field-assist-request.interface.d.ts

@@ -0,0 +1,21 @@
+import { DyNTS_AI_FieldAssistMode_Type } from '../../_enums/dynts-ai-field-assist-mode.type-enum';
+/**
+ * BFR-MYASSISTANT-009 — a field-assist request as the client sends it (the field names of the ngx-dynamo
+ * `DyNX_AiFieldAssist_Request_Interface`, so the app's endpoint passes the body on as it is).
+ */
+export interface DyNTS_AI_FieldAssist_Request_Interface {
+    mode: DyNTS_AI_FieldAssistMode_Type | `${DyNTS_AI_FieldAssistMode_Type}`;
+    /** What the field is (e.g. "Description"). */
+    fieldLabel: string;
+    /** What the field is for (optional context). */
+    purpose?: string;
+    /** Write: what the user wants to see. Improve: an optional hint. */
+    instruction?: string;
+    /** The field's current text. */
+    currentText?: string;
+    /** The field's length limit (characters). */
+    maxLength?: number;
+    /** The page language (`hu` / `en` / …). */
+    language?: string;
+}
+//# sourceMappingURL=dynts-ai-field-assist-request.interface.d.ts.map

package/build/_modules/ai/_models/interfaces/dynts-ai-field-assist-request.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynts-ai-field-assist-request.interface.d.ts","sourceRoot":"","sources":["../../../../../src/_modules/ai/_models/interfaces/dynts-ai-field-assist-request.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,mDAAmD,CAAC;AAElG;;;GAGG;AACH,MAAM,WAAW,sCAAsC;IACrD,IAAI,EAAE,6BAA6B,GAAG,GAAG,6BAA6B,EAAE,CAAC;IACzE,8CAA8C;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gCAAgC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/build/_modules/ai/_models/interfaces/dynts-ai-field-assist-request.interface.js

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

package/build/_modules/ai/_models/interfaces/dynts-ai-field-assist-request.interface.js.map

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

package/build/_modules/ai/_models/interfaces/dynts-ai-field-assist-result.interface.d.ts

@@ -0,0 +1,15 @@
+/**
+ * BFR-MYASSISTANT-009 — what the server returns to the client (the ngx-dynamo
+ * `DyNX_AiFieldAssist_Result_Interface`).
+ */
+export interface DyNTS_AI_FieldAssist_Result_Interface {
+    /** The cleaned field content. */
+    text: string;
+    /** The answer was longer than `maxLength` and was cut at a word boundary. */
+    isTruncated: boolean;
+    /** The tokens the call used (when the provider reports them). */
+    totalTokens?: number;
+    /** The model that answered. */
+    model?: string;
+}
+//# sourceMappingURL=dynts-ai-field-assist-result.interface.d.ts.map

package/build/_modules/ai/_models/interfaces/dynts-ai-field-assist-result.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynts-ai-field-assist-result.interface.d.ts","sourceRoot":"","sources":["../../../../../src/_modules/ai/_models/interfaces/dynts-ai-field-assist-result.interface.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,qCAAqC;IACpD,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,6EAA6E;IAC7E,WAAW,EAAE,OAAO,CAAC;IACrB,iEAAiE;IACjE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/build/_modules/ai/_models/interfaces/dynts-ai-field-assist-result.interface.js

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

package/build/_modules/ai/_models/interfaces/dynts-ai-field-assist-result.interface.js.map

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

package/build/_modules/ai/_services/ai-agent.control-service.d.ts

@@ -0,0 +1,104 @@
+import { DyFM_AI_CallSettings, DyFM_AI_Message } from '@futdevpro/fsm-dynamo/ai';
+import { DyNTS_AI_Agent_ContextProvider_Interface } from '../_models/interfaces/dynts-ai-agent-context-provider.interface';
+import { DyNTS_AI_Agent_Draft_Interface } from '../_models/interfaces/dynts-ai-agent-draft.interface';
+import { DyNTS_AI_Agent_RenderedContext_Interface } from '../_models/interfaces/dynts-ai-agent-rendered-context.interface';
+import { DyNTS_AI_Agent_Result_Interface } from '../_models/interfaces/dynts-ai-agent-result.interface';
+import { DyNTS_AI_Agent_Settings_Interface } from '../_models/interfaces/dynts-ai-agent-settings.interface';
+import { DyNTS_AI_Agent_Tool_Interface } from '../_models/interfaces/dynts-ai-agent-tool.interface';
+import { DyNTS_AI_Agent_Turn_Interface } from '../_models/interfaces/dynts-ai-agent-turn.interface';
+/**
+ * BFR-MYASSISTANT-026 — a plain, general agentic loop: the project gives the tools and the context providers, the
+ * model (any `DyNTS_AI_LLM_ServiceBase` provider) runs the tool loop.
+ *
+ * - **tools:** `addTool({ name, description, parameters, handler })` — the definition and the handler in one object;
+ *   a tool's error becomes an `ERROR …` result for the model, a long result is cut (`maxToolResultLength`);
+ * - **context bound to the user message, NOT to the history:** `prepare` runs the context providers (e.g. RAG) for a
+ *   message and gives a draft; the user adjusts it (switches items off, edits, reorders, adds); `run` sends the
+ *   message with exactly that context. The history sent later holds only the messages and the answers — the context
+ *   stays in the turn (shown / audited), it is not resent;
+ * - the context is sent as DATA between markers (`DyNTS_AI_AgentContext_Util`), within `maxContextLength`, and the
+ *   result reports which item was sent, cut, dropped or switched off;
+ * - stateless between requests: the project stores the turns; one instance serves any number of requests.
+ *
+ * @example
+ * ```ts
+ * const agent = new DyNTS_AI_Agent_ControlService({ llm: openAiService, systemPrompt: 'You are the order assistant.' })
+ *   .addTool({ name: 'find_order', description: 'Finds an order by id.', parameters: orderIdSchema,
+ *     handler: (args) => this.orders.describe(`${args.id}`) })
+ *   .addContextProvider({ name: 'docs', provide: ({ message }) => this.rag.search(message) });
+ *
+ * const draft = await agent.prepare({ message: text, history: turns });   // ⇒ to the client, adjusted there
+ * const result = await agent.run({ draft: adjustedDraft, history: turns, issuer: accountId });
+ * turns.push(result.turn);
+ * ```
+ */
+export declare class DyNTS_AI_Agent_ControlService {
+    private readonly settings;
+    /** The longest user message accepted (characters). */
+    static readonly maxMessageLength: number;
+    /** The most context items of one message. */
+    static readonly maxContextItems: number;
+    /** A tool name the providers accept (OpenAI / Anthropic / Gemini). */
+    static readonly toolNamePattern: RegExp;
+    /** The defaults of the optional settings. */
+    static readonly defaults: {
+        maxIterations: number;
+        historyLimit: number;
+        maxContextLength: number;
+        maxToolResultLength: number;
+    };
+    /** The tools, by name. */
+    private readonly tools;
+    /** The context providers, in their order. */
+    private readonly contextProviders;
+    /** An agent with its model and limits; the tools and the context providers are added after. */
+    constructor(settings: DyNTS_AI_Agent_Settings_Interface);
+    /** The registered tools' names. */
+    getToolNames(): string[];
+    /** The registered context providers' names. */
+    getContextProviderNames(): string[];
+    /** Adds a tool (a unique, provider-safe name). */
+    addTool(tool: DyNTS_AI_Agent_Tool_Interface): this;
+    /** Adds a context provider (a unique name). */
+    addContextProvider(provider: DyNTS_AI_Agent_ContextProvider_Interface): this;
+    /** Runs the context providers for a message ⇒ the draft to adjust before sending. */
+    prepare(set: {
+        message: string;
+        history?: DyNTS_AI_Agent_Turn_Interface[];
+    }): Promise<DyNTS_AI_Agent_Draft_Interface>;
+    /** Sends the (adjusted) draft: the tool loop until the final answer ⇒ the turn to store. */
+    run(set: {
+        draft: DyNTS_AI_Agent_Draft_Interface;
+        history?: DyNTS_AI_Agent_Turn_Interface[];
+        issuer: string;
+        signal?: AbortSignal;
+    }): Promise<DyNTS_AI_Agent_Result_Interface>;
+    /** `prepare` + `run` in one step (no adjusting): the providers' context is sent as it came. */
+    ask(set: {
+        message: string;
+        history?: DyNTS_AI_Agent_Turn_Interface[];
+        issuer: string;
+        signal?: AbortSignal;
+    }): Promise<DyNTS_AI_Agent_Result_Interface>;
+    /**
+     * What `run` sends (for a preview / a test): the history as plain messages + answers, then the message with its
+     * context block; the call settings with the agent's system prompt (+ the context rule when context goes).
+     */
+    build(set: {
+        draft: DyNTS_AI_Agent_Draft_Interface;
+        history: DyNTS_AI_Agent_Turn_Interface[];
+    }): {
+        conversation: DyFM_AI_Message[];
+        settings: DyFM_AI_CallSettings;
+        context: DyNTS_AI_Agent_RenderedContext_Interface;
+    };
+    /** The handlers of one run: each records its run, and cuts a long result. */
+    private handlers;
+    /** The message, trimmed (a 400 when empty or too long). */
+    private static validMessage;
+    /** The draft's context, checked (it comes back from the client). */
+    private static validContext;
+    /** The reason the user sees (the error's user message, or a plain one); the technical text goes to the log. */
+    private static reason;
+}
+//# sourceMappingURL=ai-agent.control-service.d.ts.map

package/build/_modules/ai/_services/ai-agent.control-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-agent.control-service.d.ts","sourceRoot":"","sources":["../../../../src/_modules/ai/_services/ai-agent.control-service.ts"],"names":[],"mappings":"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"}