@memberjunction/ai 6.1.0-edge.6 → 6.1.0-edge.7

package/dist/generic/modelConfiguration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"modelConfiguration.d.ts","sourceRoot":"","sources":["../../src/generic/modelConfiguration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAIH,OAAO,EAAE,UAAU,EAAa,MAAM,gBAAgB,CAAC;AAEvD;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,yBAAyB,GAAG,SAAS,GAAG,WAAW,GAAG,aAAa,GAAG,QAAQ,CAAC;AAE3F;;;GAGG;AACH,MAAM,WAAW,6BAA6B;IAC1C,iDAAiD;IACjD,IAAI,CAAC,EAAE,yBAAyB,CAAC;IACjC,+FAA+F;IAC/F,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;IACpC,oFAAoF;IACpF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yFAAyF;IACzF,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,mGAAmG;AACnG,MAAM,WAAW,iCAAiC;IAC9C;;;;OAIG;IACH,aAAa,CAAC,EAAE,6BAA6B,CAAC;CACjD;AAED;;;;;GAKG;AACH,MAAM,WAAW,4BAA4B;IACzC,6DAA6D;IAC7D,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACjC,uCAAuC;IACvC,GAAG,CAAC,EAAE,4BAA4B,CAAC;IACnC,kEAAkE;IAClE,QAAQ,CAAC,EAAE,iCAAiC,CAAC;IAC7C,8BAA8B;IAC9B,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,uCAAuC;IACvC,KAAK,CAAC,EAAE,UAAU,CAAC;CACtB;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,oBAAoB,GAAG,IAAI,CAUpG;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kCAAkC,CAC9C,GAAG,MAAM,EAAE,KAAK,CAAC,oBAAoB,GAAG,IAAI,GAAG,SAAS,CAAC,GAC1D,oBAAoB,GAAG,IAAI,CAS7B"}
+{"version":3,"file":"modelConfiguration.d.ts","sourceRoot":"","sources":["../../src/generic/modelConfiguration.ts"],"names":[],"mappings":"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"}

package/dist/generic/modelConfiguration.js

@@ -1,9 +1,8 @@
 /**
- * The canonical `ModelConfiguration` shape + the pure cascade resolver.
+ * The canonical AI configuration shapes + the pure cascade resolvers.
  *
- * `ModelConfiguration` is a JSONType `nvarchar(max)` column that exists at THREE levels of the
- * model catalog, forming an inherit-with-override cascade (the structured generalization of the
- * scalar `SupportsPrefill` / `PrefillFallbackText` cascade those same three entities already carry):
+ * The AI stack carries `nvarchar(max)` JSONType configuration bags at five levels, in two cascades.
+ * The MODEL CATALOG cascade describes the model:
  *
  * ```
  * MJ: AI Model Types . ModelConfiguration     (type-wide default — e.g. every Realtime model)
@@ -11,16 +10,28 @@
  *     < MJ: AI Model Vendors . ModelConfiguration   (per model-on-this-provider — the winner)
  * ```
  *
- * **Lockstep contract**: this interface is the package-side mirror of
- * `metadata/entities/JSONType-interfaces/IAIModelConfiguration.ts`, which is pushed into
- * `EntityField.JSONTypeDefinition` and drives the CodeGen-generated `ModelConfigurationObject`
- * accessors on the three entities. Keep the two in step when adding a section or property —
- * the same pact `IAgentSettings` follows with `@memberjunction/ai-core-plus`.
+ * The PROMPT cascade describes what a given prompt asks for, and layers on top of the catalog:
+ *
+ * ```
+ * MJ: AI Prompts . PromptConfiguration        (per-prompt)
+ *   < MJ: AI Prompt Models . PromptConfiguration  (per prompt-on-this-model — the winner)
+ * ```
+ *
+ * Both compose the SAME per-modality section types ({@link LLMConfigurationSettings},
+ * {@link RealtimeConfigurationSettings}, …) — one definition of what "the LLM configuration" means,
+ * reused at every layer. Only the outer per-table type differs.
+ *
+ * **Lockstep contract**: these interfaces mirror
+ * `metadata/entities/JSONType-interfaces/IAIConfiguration.ts`, which is pushed into
+ * `EntityField.JSONTypeDefinition` and drives the CodeGen-generated `ModelConfigurationObject` /
+ * `PromptConfigurationObject` accessors on the five entities. Keep the two in step when adding a section
+ * or property — the same pact `IAgentSettings` follows with `@memberjunction/ai-core-plus`.
  *
  * **Boundary rule** (also documented on the metadata interface): anything the engine filters,
  * sorts, or joins on stays a COLUMN (`PowerRank`, `IsActive`, `Priority`, `Status` — SQL cannot
- * cheaply predicate into this bag); anything a driver consumes at session/call time belongs HERE.
- * New capability knobs go in this bag — do not add a new capability column per knob.
+ * cheaply predicate into this bag); anything a driver or runner consumes at call time belongs HERE.
+ * New capability knobs go in the bag — do not add a capability column per knob. A knob graduates to
+ * a real column when it needs a foreign key or becomes a first-class platform concept.
  */
 import { IsPlainObject } from '@memberjunction/global';
 /**

package/dist/generic/modelConfiguration.js.map

@@ -1 +1 @@
-{"version":3,"file":"modelConfiguration.js","sourceRoot":"","sources":["../../src/generic/modelConfiguration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAyEvD;;;;;;;GAOG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAA+B;IACnE,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvD,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,IAAI,CAAC;QACD,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACzC,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAE,MAA+B,CAAC,CAAC,CAAC,IAAI,CAAC;IAC3E,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,IAAI,CAAC;IAChB,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,kCAAkC,CAC9C,GAAG,MAAsD;IAEzD,MAAM,MAAM,GAAe,EAAE,CAAC;IAC9B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QACzB,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;YACxB,SAAS;QACb,CAAC;QACD,SAAS,CAAC,MAAM,EAAE,KAA8B,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAE,MAA+B,CAAC,CAAC,CAAC,IAAI,CAAC;AACpF,CAAC;AAED,uGAAuG;AACvG,SAAS,SAAS,CAAC,MAAkB,EAAE,MAAkB;IACrD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACpC,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YACzB,SAAS;QACb,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,aAAa,CAAC,QAAQ,CAAC,IAAI,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC;YACrD,SAAS,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAClC,CAAC;aAAM,IAAI,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,GAAe,EAAE,CAAC;YAC5B,SAAS,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YAC1B,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;QACvB,CAAC;aAAM,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YACjC,MAAM,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,KAAK,EAAiB,CAAC;QAClD,CAAC;aAAM,CAAC;YACJ,MAAM,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC;QAC3B,CAAC;IACL,CAAC;AACL,CAAC"}
+{"version":3,"file":"modelConfiguration.js","sourceRoot":"","sources":["../../src/generic/modelConfiguration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAgMvD;;;;;;;GAOG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAA+B;IACnE,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvD,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,IAAI,CAAC;QACD,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACzC,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAE,MAA+B,CAAC,CAAC,CAAC,IAAI,CAAC;IAC3E,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,IAAI,CAAC;IAChB,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,kCAAkC,CAC9C,GAAG,MAAsD;IAEzD,MAAM,MAAM,GAAe,EAAE,CAAC;IAC9B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QACzB,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;YACxB,SAAS;QACb,CAAC;QACD,SAAS,CAAC,MAAM,EAAE,KAA8B,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAE,MAA+B,CAAC,CAAC,CAAC,IAAI,CAAC;AACpF,CAAC;AAED,uGAAuG;AACvG,SAAS,SAAS,CAAC,MAAkB,EAAE,MAAkB;IACrD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACpC,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YACzB,SAAS;QACb,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,aAAa,CAAC,QAAQ,CAAC,IAAI,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC;YACrD,SAAS,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAClC,CAAC;aAAM,IAAI,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,GAAe,EAAE,CAAC;YAC5B,SAAS,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YAC1B,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;QACvB,CAAC;aAAM,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YACjC,MAAM,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,KAAK,EAAiB,CAAC;QAClD,CAAC;aAAM,CAAC;YACJ,MAAM,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC;QAC3B,CAAC;IACL,CAAC;AACL,CAAC"}

package/dist/generic/openAICompatibleTools.d.ts

@@ -0,0 +1,129 @@
+/**
+ * openAICompatibleTools.ts — the tool-calling wire mapping shared by every OpenAI-shaped provider.
+ *
+ * OpenAI's function-calling shape is the de-facto standard: Groq, Cerebras, Fireworks, xAI,
+ * Together, LM Studio, DeepSeek, Moonshot, Z.AI, MiniMax and OpenRouter all speak it. The mapping
+ * between MJ's neutral surface and that shape is therefore written **once, here**, rather than
+ * per driver.
+ *
+ * That matters more than it saves. The mapping has three details that are easy to get subtly
+ * wrong and impossible to notice from a passing test:
+ *
+ *   1. arguments cross the wire as a **JSON string**, not an object;
+ *   2. a tool RESULT is its own `tool`-role message with a `tool_call_id`, so one MJ tool turn
+ *      expands into N provider messages;
+ *   3. a call whose arguments are malformed JSON must still be **surfaced**, because an agent loop
+ *      that sees nothing cannot tell "the model said nothing" from "the model said something broken".
+ *
+ * Three implementations of that would drift. One cannot.
+ *
+ * These functions return plain structural objects rather than any SDK's types, because every
+ * provider ships its own near-identical copies. Each driver assigns the result into its own SDK
+ * type at the boundary, which is where the compiler can still check the shape.
+ */
+import type { ChatMessage, ChatTool, ChatToolCall, ChatToolChoice } from './chat.types.js';
+/** A tool declaration in the OpenAI-compatible request body. */
+export interface OpenAICompatibleToolDeclaration {
+    type: 'function';
+    function: {
+        name: string;
+        description?: string;
+        parameters: Record<string, unknown>;
+    };
+}
+/** The `tool_choice` field. The string forms pass through; only the named form is reshaped. */
+export type OpenAICompatibleToolChoice = 'auto' | 'none' | 'required' | {
+    type: 'function';
+    function: {
+        name: string;
+    };
+};
+/**
+ * A tool call as it arrives on an assistant turn — note `arguments` is a JSON STRING.
+ *
+ * The index signature is deliberate. Provider SDKs declare their own near-identical copies of this
+ * shape, several of them WITH an open index signature (Cerebras does), and a closed type is not
+ * assignable to an open one. Declaring these wire types open keeps them assignable in both
+ * directions, which is what lets one mapping serve every OpenAI-shaped provider — and it is honest
+ * about what they are: a body providers are free to extend.
+ */
+export interface OpenAICompatibleToolCall {
+    id: string;
+    type: 'function';
+    function: {
+        name: string;
+        arguments: string;
+    };
+    [key: string]: unknown;
+}
+/** One `tool`-role message carrying the result of one call. */
+export interface OpenAICompatibleToolResultMessage {
+    role: 'tool';
+    tool_call_id: string;
+    content: string;
+    [key: string]: unknown;
+}
+/**
+ * A non-tool message in the OpenAI-compatible request body.
+ *
+ * Discriminated on `role` rather than a single interface with a union-typed role, because every
+ * provider SDK models it that way — a flat interface fails to narrow when assigned to theirs.
+ * `tool_calls` rides on the assistant turn; without it the `tool` messages answering those calls
+ * are orphaned and the provider rejects the conversation.
+ */
+export type OpenAICompatibleChatMessage = {
+    role: 'system';
+    content: string;
+    [key: string]: unknown;
+} | {
+    role: 'user';
+    content: string;
+    [key: string]: unknown;
+} | {
+    role: 'assistant';
+    content: string;
+    tool_calls?: OpenAICompatibleToolCall[];
+    [key: string]: unknown;
+};
+/** Any message in an OpenAI-compatible request body. */
+export type OpenAICompatibleMessage = OpenAICompatibleChatMessage | OpenAICompatibleToolResultMessage;
+/** The subset of a raw response tool call this module can read, whatever SDK produced it. */
+export interface RawOpenAICompatibleToolCall {
+    id?: string;
+    type?: string;
+    function?: {
+        name?: string;
+        arguments?: string;
+    };
+}
+/** Maps MJ tool declarations onto the request's `tools` array. */
+export declare function buildOpenAICompatibleTools(tools: ChatTool[]): OpenAICompatibleToolDeclaration[];
+/** Maps the neutral {@link ChatToolChoice} onto the provider's `tool_choice`. */
+export declare function buildOpenAICompatibleToolChoice(choice: ChatToolChoice): OpenAICompatibleToolChoice;
+/**
+ * Maps normalized calls from a prior assistant turn back onto the wire.
+ *
+ * Round-tripping matters: without the assistant's `tool_calls`, the `tool` messages answering them
+ * are orphaned and the provider rejects the conversation.
+ */
+export declare function buildOpenAICompatibleToolCalls(toolCalls: ChatToolCall[]): OpenAICompatibleToolCall[];
+/**
+ * Expands one MJ `tool`-role message into the provider's per-result `tool` messages.
+ *
+ * Returns an empty array — and warns — for a tool turn carrying no result blocks, rather than
+ * emitting a malformed message the provider would reject with an opaque error.
+ */
+export declare function buildOpenAICompatibleToolResults(message: ChatMessage, providerName: string): OpenAICompatibleToolResultMessage[];
+/**
+ * Normalizes raw response tool calls into {@link ChatToolCall}s with PARSED arguments.
+ *
+ * A model can emit malformed JSON for its arguments. That is a tool-specific failure the caller
+ * must be able to see, so the call is surfaced with empty arguments and a warning rather than
+ * dropped — dropping it would look to an agent loop like the model said nothing at all.
+ *
+ * @param toolCalls Raw calls from the response, if any
+ * @param providerName Used only in the warning, so a log line names the provider
+ * @returns Normalized calls, or `undefined` when the model called nothing
+ */
+export declare function extractOpenAICompatibleToolCalls(toolCalls: RawOpenAICompatibleToolCall[] | undefined | null, providerName: string): ChatToolCall[] | undefined;
+//# sourceMappingURL=openAICompatibleTools.d.ts.map

package/dist/generic/openAICompatibleTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openAICompatibleTools.d.ts","sourceRoot":"","sources":["../../src/generic/openAICompatibleTools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAGxF,gEAAgE;AAChE,MAAM,WAAW,+BAA+B;IAC5C,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACvC,CAAC;CACL;AAED,+FAA+F;AAC/F,MAAM,MAAM,0BAA0B,GAChC,MAAM,GACN,MAAM,GACN,UAAU,GACV;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC;AAEvD;;;;;;;;GAQG;AACH,MAAM,WAAW,wBAAwB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED,+DAA+D;AAC/D,MAAM,WAAW,iCAAiC;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,2BAA2B,GACjC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,GAC3D;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,GACzD;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,wBAAwB,EAAE,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC;AAE9G,wDAAwD;AACxD,MAAM,MAAM,uBAAuB,GAAG,2BAA2B,GAAG,iCAAiC,CAAC;AAEtG,6FAA6F;AAC7F,MAAM,WAAW,2BAA2B;IACxC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACpD;AAED,kEAAkE;AAClE,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,+BAA+B,EAAE,CAS/F;AAED,iFAAiF;AACjF,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,cAAc,GAAG,0BAA0B,CAIlG;AAED;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAAC,SAAS,EAAE,YAAY,EAAE,GAAG,wBAAwB,EAAE,CASpG;AAED;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAC5C,OAAO,EAAE,WAAW,EACpB,YAAY,EAAE,MAAM,GACrB,iCAAiC,EAAE,CAarC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gCAAgC,CAC5C,SAAS,EAAE,2BAA2B,EAAE,GAAG,SAAS,GAAG,IAAI,EAC3D,YAAY,EAAE,MAAM,GACrB,YAAY,EAAE,GAAG,SAAS,CA0B5B"}

package/dist/generic/openAICompatibleTools.js

@@ -0,0 +1,94 @@
+import { getToolResultBlocks } from './chat.types.js';
+/** Maps MJ tool declarations onto the request's `tools` array. */
+export function buildOpenAICompatibleTools(tools) {
+    return tools.map((tool) => ({
+        type: 'function',
+        function: {
+            name: tool.name,
+            description: tool.description,
+            parameters: tool.inputSchema
+        }
+    }));
+}
+/** Maps the neutral {@link ChatToolChoice} onto the provider's `tool_choice`. */
+export function buildOpenAICompatibleToolChoice(choice) {
+    return typeof choice === 'string'
+        ? choice
+        : { type: 'function', function: { name: choice.name } };
+}
+/**
+ * Maps normalized calls from a prior assistant turn back onto the wire.
+ *
+ * Round-tripping matters: without the assistant's `tool_calls`, the `tool` messages answering them
+ * are orphaned and the provider rejects the conversation.
+ */
+export function buildOpenAICompatibleToolCalls(toolCalls) {
+    return toolCalls.map((call) => ({
+        id: call.id,
+        type: 'function',
+        function: {
+            name: call.name,
+            arguments: JSON.stringify(call.arguments ?? {})
+        }
+    }));
+}
+/**
+ * Expands one MJ `tool`-role message into the provider's per-result `tool` messages.
+ *
+ * Returns an empty array — and warns — for a tool turn carrying no result blocks, rather than
+ * emitting a malformed message the provider would reject with an opaque error.
+ */
+export function buildOpenAICompatibleToolResults(message, providerName) {
+    const blocks = getToolResultBlocks(message.content);
+    if (blocks.length === 0) {
+        console.warn(`${providerName}: a tool-role message carried no tool_result blocks; skipping it.`);
+        return [];
+    }
+    return blocks.map((block) => ({
+        role: 'tool',
+        tool_call_id: block.toolCallId,
+        // This wire shape has no error flag on a tool result, so a failure has to be marked in the
+        // text or the model cannot tell a failure from a result.
+        content: block.isError ? `ERROR: ${block.content}` : block.content
+    }));
+}
+/**
+ * Normalizes raw response tool calls into {@link ChatToolCall}s with PARSED arguments.
+ *
+ * A model can emit malformed JSON for its arguments. That is a tool-specific failure the caller
+ * must be able to see, so the call is surfaced with empty arguments and a warning rather than
+ * dropped — dropping it would look to an agent loop like the model said nothing at all.
+ *
+ * @param toolCalls Raw calls from the response, if any
+ * @param providerName Used only in the warning, so a log line names the provider
+ * @returns Normalized calls, or `undefined` when the model called nothing
+ */
+export function extractOpenAICompatibleToolCalls(toolCalls, providerName) {
+    if (!toolCalls || toolCalls.length === 0) {
+        return undefined;
+    }
+    const calls = [];
+    for (const call of toolCalls) {
+        // Custom (non-function) tool types are not part of the neutral surface.
+        if (call.type !== undefined && call.type !== 'function') {
+            continue;
+        }
+        const name = call.function?.name;
+        if (!name) {
+            continue;
+        }
+        let parsedArguments = {};
+        try {
+            const parsed = JSON.parse(call.function?.arguments || '{}');
+            if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
+                parsedArguments = parsed;
+            }
+        }
+        catch {
+            console.warn(`${providerName}: could not parse arguments for tool call '${name}'; surfacing the call with empty arguments.`);
+        }
+        calls.push({ id: call.id ?? '', name, arguments: parsedArguments });
+    }
+    return calls.length > 0 ? calls : undefined;
+}
+//# sourceMappingURL=openAICompatibleTools.js.map

package/dist/generic/openAICompatibleTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openAICompatibleTools.js","sourceRoot":"","sources":["../../src/generic/openAICompatibleTools.ts"],"names":[],"mappings":"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"}

package/dist/generic/realtimeProxyRegistry.d.ts

@@ -5,6 +5,14 @@ import { BaseSingleton } from '@memberjunction/global';
  * (in Core) so the minting side (driver) and the serving side (MJServer proxy) can never drift.
  */
 export declare const REALTIME_PROXY_PATH = "/realtime-proxy";
+/**
+ * The URL path MJAPI's realtime WebRTC SDP broker listens on for offer/answer exchanges.
+ */
+export declare const REALTIME_SDP_EXCHANGE_PATH = "/realtime/sdp-exchange";
+/**
+ * @deprecated Use `REALTIME_SDP_EXCHANGE_PATH`.
+ */
+export declare const OPENAI_LIVE_SDP_EXCHANGE_PATH = "/realtime/sdp-exchange";
 /**
  * A short-lived, one-time authorization to open ONE upstream realtime websocket through the
  * MJAPI realtime proxy. Stored server-side only — the upstream URL and (optional) auth header
@@ -28,6 +36,13 @@ export interface RealtimeProxyTicketEntry {
     UpstreamAuthHeader?: string;
     /** The MJ user this ticket was minted for (for audit / optional validation at consume time). */
     UserID?: string;
+    /** The driver class authorizing this ticket (e.g. 'OpenAILiveRealtime'). */
+    DriverClass?: string;
+    /**
+     * Authoritative session configuration minted by the server (e.g. for WebRTC SDP exchanges).
+     * Prevents clients from tampering with upstream model, reasoning, or tools.
+     */
+    SessionConfig?: Record<string, unknown>;
     /** Epoch-ms after which the ticket is invalid. Enforced on {@link RealtimeProxyRegistry.Consume}. */
     ExpiresAtMs: number;
 }
@@ -39,6 +54,10 @@ export interface RealtimeProxyIssueParams {
     UpstreamAuthHeader?: string;
     /** The MJ user the ticket is for (optional). */
     UserID?: string;
+    /** The driver class authorizing this ticket (optional). */
+    DriverClass?: string;
+    /** Authoritative session configuration minted by the server (optional). */
+    SessionConfig?: Record<string, unknown>;
     /** Time-to-live, in seconds, for the ONE upstream open this ticket authorizes. */
     TTLSeconds: number;
 }

package/dist/generic/realtimeProxyRegistry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"realtimeProxyRegistry.d.ts","sourceRoot":"","sources":["../../src/generic/realtimeProxyRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,oBAAoB,CAAC;AAErD;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,wBAAwB;IACrC,uGAAuG;IACvG,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gGAAgG;IAChG,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qGAAqG;IACrG,WAAW,EAAE,MAAM,CAAC;CACvB;AAED,yFAAyF;AACzF,MAAM,WAAW,wBAAwB;IACrC,wDAAwD;IACxD,WAAW,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kFAAkF;IAClF,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,wGAAwG;AACxG,MAAM,WAAW,mBAAmB;IAChC,4FAA4F;IAC5F,EAAE,EAAE,MAAM,CAAC;IACX,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,qBAAsB,SAAQ,aAAa,CAAC,qBAAqB,CAAC;IAC3E,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoD;IAE7E,SAAS;IAIT,uCAAuC;IACvC,WAAkB,QAAQ,IAAI,qBAAqB,CAElD;IAED;;;OAGG;IACI,KAAK,CAAC,MAAM,EAAE,wBAAwB,GAAG,mBAAmB;IAanE;;;;OAIG;IACI,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,wBAAwB,GAAG,IAAI;IAgB3D,wFAAwF;IACxF,IAAW,KAAK,IAAI,MAAM,CAGzB;IAED,kDAAkD;IAClD,OAAO,CAAC,YAAY;IASpB,0FAA0F;IAC1F,OAAO,CAAC,MAAM,CAAC,WAAW;CAY7B"}
+{"version":3,"file":"realtimeProxyRegistry.d.ts","sourceRoot":"","sources":["../../src/generic/realtimeProxyRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,oBAAoB,CAAC;AAErD;;GAEG;AACH,eAAO,MAAM,0BAA0B,2BAA2B,CAAC;AAEnE;;GAEG;AACH,eAAO,MAAM,6BAA6B,2BAA6B,CAAC;AAExE;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,wBAAwB;IACrC,uGAAuG;IACvG,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gGAAgG;IAChG,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,qGAAqG;IACrG,WAAW,EAAE,MAAM,CAAC;CACvB;AAED,yFAAyF;AACzF,MAAM,WAAW,wBAAwB;IACrC,wDAAwD;IACxD,WAAW,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2EAA2E;IAC3E,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,kFAAkF;IAClF,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,wGAAwG;AACxG,MAAM,WAAW,mBAAmB;IAChC,4FAA4F;IAC5F,EAAE,EAAE,MAAM,CAAC;IACX,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,qBAAsB,SAAQ,aAAa,CAAC,qBAAqB,CAAC;IAC3E,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoD;IAE7E,SAAS;IAIT,uCAAuC;IACvC,WAAkB,QAAQ,IAAI,qBAAqB,CAElD;IAED;;;OAGG;IACI,KAAK,CAAC,MAAM,EAAE,wBAAwB,GAAG,mBAAmB;IAenE;;;;OAIG;IACI,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,wBAAwB,GAAG,IAAI;IAgB3D,wFAAwF;IACxF,IAAW,KAAK,IAAI,MAAM,CAGzB;IAED,kDAAkD;IAClD,OAAO,CAAC,YAAY;IASpB,0FAA0F;IAC1F,OAAO,CAAC,MAAM,CAAC,WAAW;CAY7B"}

package/dist/generic/realtimeProxyRegistry.js

@@ -5,6 +5,14 @@ import { BaseSingleton } from '@memberjunction/global';
  * (in Core) so the minting side (driver) and the serving side (MJServer proxy) can never drift.
  */
 export const REALTIME_PROXY_PATH = '/realtime-proxy';
+/**
+ * The URL path MJAPI's realtime WebRTC SDP broker listens on for offer/answer exchanges.
+ */
+export const REALTIME_SDP_EXCHANGE_PATH = '/realtime/sdp-exchange';
+/**
+ * @deprecated Use `REALTIME_SDP_EXCHANGE_PATH`.
+ */
+export const OPENAI_LIVE_SDP_EXCHANGE_PATH = REALTIME_SDP_EXCHANGE_PATH;
 /**
  * Process-wide, in-memory registry of one-time realtime-proxy tickets (Global Object Store backed
  * via {@link BaseSingleton}, so the provider driver that mints and the MJAPI proxy that consumes
@@ -39,6 +47,8 @@ export class RealtimeProxyRegistry extends BaseSingleton {
             UpstreamUrl: params.UpstreamUrl,
             UpstreamAuthHeader: params.UpstreamAuthHeader,
             UserID: params.UserID,
+            DriverClass: params.DriverClass,
+            SessionConfig: params.SessionConfig,
             ExpiresAtMs: expiresAtMs,
         });
         return { ID: id, ExpiresAt: new Date(expiresAtMs).toISOString() };

package/dist/generic/realtimeProxyRegistry.js.map

@@ -1 +1 @@
-{"version":3,"file":"realtimeProxyRegistry.js","sourceRoot":"","sources":["../../src/generic/realtimeProxyRegistry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"realtimeProxyRegistry.js","sourceRoot":"","sources":["../../src/generic/realtimeProxyRegistry.ts"],"names":[],"mappings":"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"}

package/dist/generic/realtimeToolBatchBarrier.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Coordinates batched tool-call completions for realtime sessions that require
+ * a single turn-continuation trigger (e.g. OpenAI Live `response.create`) per
+ * batch of parallel tool calls, rather than firing per tool result.
+ *
+ * Requirements (§4.2 / §4.3 of plans/realtime/gpt-live-1.md):
+ * - Multiple parallel tool calls arrive in a single turn.
+ * - Each tool output must be appended (e.g. `response.item.create`).
+ * - Exactly ONE `response.create` must be sent when the outstanding set drains.
+ * - A safety timeout ensures a lost or unreturned tool call does not wedge the session indefinitely.
+ * - Unknown or duplicate results for already closed calls never re-fire response.create.
+ */
+export declare class RealtimeToolBatchBarrier {
+    private _outstanding;
+    private _timer;
+    private _onTimeoutFlush?;
+    private _timeoutMs;
+    /**
+     * @param defaultTimeoutMs Maximum time in milliseconds to wait for remaining tool results before flushing (default 15s).
+     */
+    constructor(defaultTimeoutMs?: number);
+    /**
+     * Records an outstanding tool call ID that must be answered.
+     * @param callId The tool call identifier.
+     * @param onTimeoutFlush Optional callback to invoke if the batch times out waiting for remaining results.
+     */
+    Opened(callId: string, onTimeoutFlush?: () => void): void;
+    /**
+     * Alias for Opened.
+     */
+    TrackPendingCall(callId: string, onTimeoutFlush?: () => void): void;
+    /**
+     * Returns true when THIS result drains the batch and the caller should send response.create.
+     * If the call was not in the outstanding set (unknown or duplicate), returns false.
+     *
+     * @param callId The tool call identifier.
+     */
+    Closed(callId: string): boolean;
+    /**
+     * Alias for Closed.
+     */
+    RecordResult(callId: string): boolean;
+    /**
+     * Returns true if there are no outstanding tool calls.
+     */
+    get IsEmpty(): boolean;
+    /**
+     * Number of tool calls still awaiting results in the current batch.
+     */
+    get PendingCount(): number;
+    /**
+     * Arms or re-arms the timeout with a custom duration and callback.
+     */
+    ArmTimeout(ms: number, onTimeoutFlush: () => void): void;
+    /**
+     * Resets the barrier state and cancels any pending timeout (alias for Clear).
+     */
+    Reset(): void;
+    /**
+     * Clears all pending tool calls and cancels any active timeout (e.g. on user interruption,
+     * error, or session close).
+     */
+    Clear(): void;
+    private resetTimeout;
+    private clearTimeout;
+}
+//# sourceMappingURL=realtimeToolBatchBarrier.d.ts.map

package/dist/generic/realtimeToolBatchBarrier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtimeToolBatchBarrier.d.ts","sourceRoot":"","sources":["../../src/generic/realtimeToolBatchBarrier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,qBAAa,wBAAwB;IACjC,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,MAAM,CAA8C;IAC5D,OAAO,CAAC,eAAe,CAAC,CAAa;IACrC,OAAO,CAAC,UAAU,CAAS;IAE3B;;OAEG;gBACS,gBAAgB,GAAE,MAAc;IAI5C;;;;OAIG;IACI,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,IAAI,GAAG,IAAI;IAWhE;;OAEG;IACI,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,IAAI,GAAG,IAAI;IAI1E;;;;;OAKG;IACI,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAYtC;;OAEG;IACI,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAI5C;;OAEG;IACH,IAAW,OAAO,IAAI,OAAO,CAE5B;IAED;;OAEG;IACH,IAAW,YAAY,IAAI,MAAM,CAEhC;IAED;;OAEG;IACI,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,IAAI,GAAG,IAAI;IAM/D;;OAEG;IACI,KAAK,IAAI,IAAI;IAIpB;;;OAGG;IACI,KAAK,IAAI,IAAI;IAKpB,OAAO,CAAC,YAAY;IAapB,OAAO,CAAC,YAAY;CAMvB"}

package/dist/generic/realtimeToolBatchBarrier.js

@@ -0,0 +1,119 @@
+/**
+ * Coordinates batched tool-call completions for realtime sessions that require
+ * a single turn-continuation trigger (e.g. OpenAI Live `response.create`) per
+ * batch of parallel tool calls, rather than firing per tool result.
+ *
+ * Requirements (§4.2 / §4.3 of plans/realtime/gpt-live-1.md):
+ * - Multiple parallel tool calls arrive in a single turn.
+ * - Each tool output must be appended (e.g. `response.item.create`).
+ * - Exactly ONE `response.create` must be sent when the outstanding set drains.
+ * - A safety timeout ensures a lost or unreturned tool call does not wedge the session indefinitely.
+ * - Unknown or duplicate results for already closed calls never re-fire response.create.
+ */
+export class RealtimeToolBatchBarrier {
+    /**
+     * @param defaultTimeoutMs Maximum time in milliseconds to wait for remaining tool results before flushing (default 15s).
+     */
+    constructor(defaultTimeoutMs = 15000) {
+        this._outstanding = new Set();
+        this._timer = null;
+        this._timeoutMs = defaultTimeoutMs;
+    }
+    /**
+     * Records an outstanding tool call ID that must be answered.
+     * @param callId The tool call identifier.
+     * @param onTimeoutFlush Optional callback to invoke if the batch times out waiting for remaining results.
+     */
+    Opened(callId, onTimeoutFlush) {
+        if (!callId) {
+            return;
+        }
+        this._outstanding.add(callId);
+        if (onTimeoutFlush) {
+            this._onTimeoutFlush = onTimeoutFlush;
+        }
+        this.resetTimeout();
+    }
+    /**
+     * Alias for Opened.
+     */
+    TrackPendingCall(callId, onTimeoutFlush) {
+        this.Opened(callId, onTimeoutFlush);
+    }
+    /**
+     * Returns true when THIS result drains the batch and the caller should send response.create.
+     * If the call was not in the outstanding set (unknown or duplicate), returns false.
+     *
+     * @param callId The tool call identifier.
+     */
+    Closed(callId) {
+        if (!this._outstanding.delete(callId)) {
+            return false; // unknown or duplicate result — never re-fire
+        }
+        if (this._outstanding.size === 0) {
+            this.clearTimeout();
+            return true;
+        }
+        this.resetTimeout();
+        return false;
+    }
+    /**
+     * Alias for Closed.
+     */
+    RecordResult(callId) {
+        return this.Closed(callId);
+    }
+    /**
+     * Returns true if there are no outstanding tool calls.
+     */
+    get IsEmpty() {
+        return this._outstanding.size === 0;
+    }
+    /**
+     * Number of tool calls still awaiting results in the current batch.
+     */
+    get PendingCount() {
+        return this._outstanding.size;
+    }
+    /**
+     * Arms or re-arms the timeout with a custom duration and callback.
+     */
+    ArmTimeout(ms, onTimeoutFlush) {
+        this._timeoutMs = ms;
+        this._onTimeoutFlush = onTimeoutFlush;
+        this.resetTimeout();
+    }
+    /**
+     * Resets the barrier state and cancels any pending timeout (alias for Clear).
+     */
+    Reset() {
+        this.Clear();
+    }
+    /**
+     * Clears all pending tool calls and cancels any active timeout (e.g. on user interruption,
+     * error, or session close).
+     */
+    Clear() {
+        this._outstanding.clear();
+        this.clearTimeout();
+    }
+    resetTimeout() {
+        this.clearTimeout();
+        if (this._outstanding.size > 0 && this._onTimeoutFlush) {
+            this._timer = setTimeout(() => {
+                this._timer = null;
+                if (this._outstanding.size > 0) {
+                    this._outstanding.clear();
+                    this._onTimeoutFlush?.();
+                }
+            }, this._timeoutMs);
+        }
+    }
+    clearTimeout() {
+        if (this._timer) {
+            clearTimeout(this._timer);
+            this._timer = null;
+        }
+    }
+}
+//# sourceMappingURL=realtimeToolBatchBarrier.js.map

package/dist/generic/realtimeToolBatchBarrier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtimeToolBatchBarrier.js","sourceRoot":"","sources":["../../src/generic/realtimeToolBatchBarrier.ts"],"names":[],"mappings":"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"}

package/dist/generic/toolTurnEncoding.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Re-encodes native tool turns as plain text — the form a model sees when it is NOT given tool
+ * declarations.
+ *
+ * A conversation that ran natively holds an assistant turn carrying `toolCalls` and a `tool` turn of
+ * `tool_result` blocks. Providers accept those only alongside tool declarations (and Gemini also
+ * polices their order), so a request that strips the declarations but keeps the turns fails for a
+ * second, unrelated reason. This is the one encoding for that history the envelope path has always
+ * used: the call turn keeps only its prose (the agent loop never appends the model's own call turn on
+ * the envelope path), and each result becomes a user message of the loop's
+ * `[Action Result] <tool> succeeded|failed. <content>` form.
+ *
+ * Used by the prompt runner's native→envelope fallback and by the eval harness, which writes each
+ * multi-turn case once in the neutral tool form and renders it per arm.
+ *
+ * @module generic/toolTurnEncoding
+ */
+import type { ChatMessage } from './chat.types.js';
+/** Prefix of the user message a tool result becomes. */
+export declare const ACTION_RESULT_TEXT_PREFIX = "[Action Result]";
+/**
+ * Returns a copy of `messages` with every native tool turn rendered as text. Messages that carry no
+ * tool turn are passed through untouched (same object), so an already-textual history is unchanged.
+ */
+export declare function EncodeToolTurnsAsText(messages: readonly ChatMessage[]): ChatMessage[];
+//# sourceMappingURL=toolTurnEncoding.d.ts.map

package/dist/generic/toolTurnEncoding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolTurnEncoding.d.ts","sourceRoot":"","sources":["../../src/generic/toolTurnEncoding.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,WAAW,EAA2B,MAAM,cAAc,CAAC;AAEzE,wDAAwD;AACxD,eAAO,MAAM,yBAAyB,oBAAoB,CAAC;AAS3D;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,GAAG,WAAW,EAAE,CA4BrF"}