@particle-academy/prism 0.0.0

package/dist/text/request.js

@@ -0,0 +1,117 @@
+import { getByPath } from '../json.js';
+import { ToolChoice } from '../enums.js';
+/**
+ * A resolved text request: everything the provider needs, and nothing that only
+ * the builder needed.
+ *
+ * Accessors are methods rather than properties so the shape mirrors the
+ * reference exactly, and so `messages()` can stay a method while `addMessage()`
+ * mutates the list beneath it.
+ */
+export class TextRequest {
+    #model;
+    #providerKey;
+    #systemPrompts;
+    #prompt;
+    #messages;
+    #maxSteps;
+    #maxTokens;
+    #temperature;
+    #topP;
+    #topK;
+    #tools;
+    #clientOptions;
+    #toolChoice;
+    #providerOptions;
+    #providerTools;
+    #reasoningEnabled;
+    constructor(options) {
+        this.#model = options.model;
+        this.#providerKey = options.providerKey ?? null;
+        this.#systemPrompts = options.systemPrompts ?? [];
+        this.#prompt = options.prompt ?? null;
+        this.#messages = options.messages ?? [];
+        this.#maxSteps = options.maxSteps ?? 1;
+        this.#maxTokens = options.maxTokens ?? null;
+        this.#temperature = options.temperature ?? null;
+        this.#topP = options.topP ?? null;
+        this.#topK = options.topK ?? null;
+        this.#tools = options.tools ?? [];
+        this.#clientOptions = options.clientOptions ?? {};
+        this.#toolChoice = options.toolChoice ?? null;
+        this.#providerOptions = { ...(options.providerOptions ?? {}) };
+        this.#providerTools = options.providerTools ?? [];
+        this.#reasoningEnabled = options.reasoningEnabled ?? null;
+    }
+    model() {
+        return this.#model;
+    }
+    provider() {
+        return this.#providerKey;
+    }
+    systemPrompts() {
+        return this.#systemPrompts;
+    }
+    prompt() {
+        return this.#prompt;
+    }
+    messages() {
+        return this.#messages;
+    }
+    maxSteps() {
+        return this.#maxSteps;
+    }
+    maxTokens() {
+        return this.#maxTokens;
+    }
+    temperature() {
+        return this.#temperature;
+    }
+    topP() {
+        return this.#topP;
+    }
+    topK() {
+        return this.#topK;
+    }
+    tools() {
+        return this.#tools;
+    }
+    clientOptions() {
+        return this.#clientOptions;
+    }
+    toolChoice() {
+        return this.#toolChoice;
+    }
+    providerTools() {
+        return this.#providerTools;
+    }
+    reasoningEnabled() {
+        return this.#reasoningEnabled;
+    }
+    providerOptions(path) {
+        return path === undefined ? this.#providerOptions : getByPath(this.#providerOptions, path);
+    }
+    withProviderOptions(options = {}) {
+        this.#providerOptions = { ...options };
+        return this;
+    }
+    addMessage(message) {
+        this.#messages = [...this.#messages, message];
+        return this;
+    }
+    setMessages(messages) {
+        this.#messages = messages;
+        return this;
+    }
+    /**
+     * After a tool has been called once, a forced choice must relax to `Auto` or
+     * the model would be pinned to that tool for every remaining step.
+     */
+    resetToolChoice() {
+        if (typeof this.#toolChoice === 'string' || this.#toolChoice === ToolChoice.Any) {
+            this.#toolChoice = ToolChoice.Auto;
+        }
+        return this;
+    }
+}
+//# sourceMappingURL=request.js.map

package/dist/text/request.js.map

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

package/dist/text/response-builder.d.ts

@@ -0,0 +1,16 @@
+import { TextResponse } from './response.js';
+import type { TextStep } from './step.js';
+/**
+ * Accumulates steps and folds them into one response.
+ *
+ * The response reports the FINAL step's text, finish reason and metadata, but
+ * usage SUMMED across every step — a multi-step generation costs the sum of its
+ * round trips, not the last one.
+ */
+export declare class ResponseBuilder {
+    #private;
+    get steps(): readonly TextStep[];
+    addStep(step: TextStep): this;
+    toResponse(): TextResponse;
+}
+//# sourceMappingURL=response-builder.d.ts.map

package/dist/text/response-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-builder.d.ts","sourceRoot":"","sources":["../../src/text/response-builder.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE1C;;;;;;GAMG;AACH,qBAAa,eAAe;;IAG1B,IAAI,KAAK,IAAI,SAAS,QAAQ,EAAE,CAE/B;IAED,OAAO,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI;IAM7B,UAAU,IAAI,YAAY;CA8C3B"}

package/dist/text/response-builder.js

@@ -0,0 +1,52 @@
+import { AssistantMessage } from '../value-objects/messages/index.js';
+import { Usage } from '../value-objects/usage.js';
+import { TextResponse } from './response.js';
+/**
+ * Accumulates steps and folds them into one response.
+ *
+ * The response reports the FINAL step's text, finish reason and metadata, but
+ * usage SUMMED across every step — a multi-step generation costs the sum of its
+ * round trips, not the last one.
+ */
+export class ResponseBuilder {
+    #steps = [];
+    get steps() {
+        return this.#steps;
+    }
+    addStep(step) {
+        this.#steps.push(step);
+        return this;
+    }
+    toResponse() {
+        const finalStep = this.#steps.at(-1);
+        if (finalStep === undefined) {
+            throw new TypeError('Cannot build a response before any step has been added.');
+        }
+        // The conversation the caller gets back already includes the reply, so it
+        // can be fed straight into the next request.
+        const messages = [
+            ...finalStep.messages,
+            new AssistantMessage(finalStep.text, finalStep.toolCalls, finalStep.additionalContent),
+        ];
+        return new TextResponse({
+            steps: [...this.#steps],
+            text: finalStep.text,
+            finishReason: finalStep.finishReason,
+            toolCalls: finalStep.toolCalls,
+            toolResults: finalStep.toolResults,
+            usage: this.#totalUsage(),
+            meta: finalStep.meta,
+            messages,
+            additionalContent: finalStep.additionalContent,
+            raw: finalStep.raw,
+        });
+    }
+    #totalUsage() {
+        const sum = (pick) => this.#steps.reduce((total, step) => total + (pick(step) ?? 0), 0);
+        // A nullable total stays null unless at least one step reported the field:
+        // summing "unreported" to zero would claim a fact nobody stated.
+        const sumIfAnyReported = (pick) => this.#steps.some((step) => pick(step) !== null) ? sum(pick) : null;
+        return new Usage(sum((step) => step.usage.promptTokens), sum((step) => step.usage.completionTokens), sumIfAnyReported((step) => step.usage.cacheWriteInputTokens), sumIfAnyReported((step) => step.usage.cacheReadInputTokens), sumIfAnyReported((step) => step.usage.thoughtTokens), sumIfAnyReported((step) => step.usage.cost));
+    }
+}
+//# sourceMappingURL=response-builder.js.map

package/dist/text/response-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-builder.js","sourceRoot":"","sources":["../../src/text/response-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AACtE,OAAO,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAG7C;;;;;;GAMG;AACH,MAAM,OAAO,eAAe;IACjB,MAAM,GAAe,EAAE,CAAC;IAEjC,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,OAAO,CAAC,IAAc;QACpB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,UAAU;QACR,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAErC,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,MAAM,IAAI,SAAS,CAAC,yDAAyD,CAAC,CAAC;QACjF,CAAC;QAED,0EAA0E;QAC1E,6CAA6C;QAC7C,MAAM,QAAQ,GAAG;YACf,GAAG,SAAS,CAAC,QAAQ;YACrB,IAAI,gBAAgB,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,SAAS,EAAE,SAAS,CAAC,iBAAiB,CAAC;SACvF,CAAC;QAEF,OAAO,IAAI,YAAY,CAAC;YACtB,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;YACvB,IAAI,EAAE,SAAS,CAAC,IAAI;YACpB,YAAY,EAAE,SAAS,CAAC,YAAY;YACpC,SAAS,EAAE,SAAS,CAAC,SAAS;YAC9B,WAAW,EAAE,SAAS,CAAC,WAAW;YAClC,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE;YACzB,IAAI,EAAE,SAAS,CAAC,IAAI;YACpB,QAAQ;YACR,iBAAiB,EAAE,SAAS,CAAC,iBAAiB;YAC9C,GAAG,EAAE,SAAS,CAAC,GAAG;SACnB,CAAC,CAAC;IACL,CAAC;IAED,WAAW;QACT,MAAM,GAAG,GAAG,CAAC,IAAuC,EAAU,EAAE,CAC9D,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAEpE,2EAA2E;QAC3E,iEAAiE;QACjE,MAAM,gBAAgB,GAAG,CAAC,IAAuC,EAAiB,EAAE,CAClF,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAErE,OAAO,IAAI,KAAK,CACd,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,EACtC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,EAC1C,gBAAgB,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,qBAAqB,CAAC,EAC5D,gBAAgB,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,oBAAoB,CAAC,EAC3D,gBAAgB,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,EACpD,gBAAgB,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAC5C,CAAC;IACJ,CAAC;CACF"}

package/dist/text/response.d.ts

@@ -0,0 +1,36 @@
+import type { JsonObject } from '../json.js';
+import type { FinishReason } from '../enums.js';
+import type { Message } from '../value-objects/messages/index.js';
+import type { Meta } from '../value-objects/meta.js';
+import type { ToolCall } from '../value-objects/tool-call.js';
+import type { ToolResult } from '../value-objects/tool-result.js';
+import type { Usage } from '../value-objects/usage.js';
+import type { TextStep } from './step.js';
+export interface TextResponseOptions {
+    steps: readonly TextStep[];
+    text: string;
+    finishReason: FinishReason;
+    toolCalls?: readonly ToolCall[];
+    toolResults?: readonly ToolResult[];
+    usage: Usage;
+    meta: Meta;
+    messages: readonly Message[];
+    additionalContent?: Readonly<JsonObject>;
+    raw?: JsonObject | null;
+}
+export declare class TextResponse {
+    readonly steps: readonly TextStep[];
+    readonly text: string;
+    readonly finishReason: FinishReason;
+    readonly toolCalls: readonly ToolCall[];
+    readonly toolResults: readonly ToolResult[];
+    readonly usage: Usage;
+    readonly meta: Meta;
+    /** The conversation as it now stands: the input messages plus the reply. */
+    readonly messages: readonly Message[];
+    readonly additionalContent: Readonly<JsonObject>;
+    readonly raw: JsonObject | null;
+    constructor(options: TextResponseOptions);
+    toObject(): JsonObject;
+}
+//# sourceMappingURL=response.d.ts.map

package/dist/text/response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.d.ts","sourceRoot":"","sources":["../../src/text/response.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oCAAoC,CAAC;AAClE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE1C,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,YAAY,CAAC;IAC3B,SAAS,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;IAChC,WAAW,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IACpC,KAAK,EAAE,KAAK,CAAC;IACb,IAAI,EAAE,IAAI,CAAC;IACX,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;IAC7B,iBAAiB,CAAC,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;IACzC,GAAG,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;CACzB;AAED,qBAAa,YAAY;IACvB,QAAQ,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAC;IAEpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IAEpC,QAAQ,CAAC,SAAS,EAAE,SAAS,QAAQ,EAAE,CAAC;IAExC,QAAQ,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,CAAC;IAE5C,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IAEtB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IAEpB,4EAA4E;IAC5E,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;IAEtC,QAAQ,CAAC,iBAAiB,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;IAEjD,QAAQ,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI,CAAC;gBAEpB,OAAO,EAAE,mBAAmB;IAaxC,QAAQ,IAAI,UAAU;CAcvB"}

package/dist/text/response.js

@@ -0,0 +1,40 @@
+export class TextResponse {
+    steps;
+    text;
+    finishReason;
+    toolCalls;
+    toolResults;
+    usage;
+    meta;
+    /** The conversation as it now stands: the input messages plus the reply. */
+    messages;
+    additionalContent;
+    raw;
+    constructor(options) {
+        this.steps = options.steps;
+        this.text = options.text;
+        this.finishReason = options.finishReason;
+        this.toolCalls = options.toolCalls ?? [];
+        this.toolResults = options.toolResults ?? [];
+        this.usage = options.usage;
+        this.meta = options.meta;
+        this.messages = options.messages;
+        this.additionalContent = options.additionalContent ?? {};
+        this.raw = options.raw ?? null;
+    }
+    toObject() {
+        return {
+            steps: this.steps.map((step) => step.toObject()),
+            text: this.text,
+            finish_reason: this.finishReason,
+            tool_calls: this.toolCalls.map((toolCall) => toolCall.toObject()),
+            tool_results: this.toolResults.map((toolResult) => toolResult.toObject()),
+            usage: this.usage.toObject(),
+            meta: this.meta.toObject(),
+            messages: this.messages.map((message) => message.toObject()),
+            additional_content: { ...this.additionalContent },
+            raw: this.raw === null ? null : { ...this.raw },
+        };
+    }
+}
+//# sourceMappingURL=response.js.map

package/dist/text/response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.js","sourceRoot":"","sources":["../../src/text/response.ts"],"names":[],"mappings":"AAsBA,MAAM,OAAO,YAAY;IACd,KAAK,CAAsB;IAE3B,IAAI,CAAS;IAEb,YAAY,CAAe;IAE3B,SAAS,CAAsB;IAE/B,WAAW,CAAwB;IAEnC,KAAK,CAAQ;IAEb,IAAI,CAAO;IAEpB,4EAA4E;IACnE,QAAQ,CAAqB;IAE7B,iBAAiB,CAAuB;IAExC,GAAG,CAAoB;IAEhC,YAAY,OAA4B;QACtC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;QACzC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC;QACzC,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,EAAE,CAAC;QAC7C,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,IAAI,EAAE,CAAC;QACzD,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC;IACjC,CAAC;IAED,QAAQ;QACN,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YAChD,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,aAAa,EAAE,IAAI,CAAC,YAAY;YAChC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;YACjE,YAAY,EAAE,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;YACzE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE;YAC5B,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE;YAC1B,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;YAC5D,kBAAkB,EAAE,EAAE,GAAG,IAAI,CAAC,iBAAiB,EAAE;YACjD,GAAG,EAAE,IAAI,CAAC,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE;SAChD,CAAC;IACJ,CAAC;CACF"}

package/dist/text/step.d.ts

@@ -0,0 +1,41 @@
+import type { JsonObject } from '../json.js';
+import type { FinishReason } from '../enums.js';
+import type { Message, SystemMessage } from '../value-objects/messages/index.js';
+import type { Meta } from '../value-objects/meta.js';
+import type { ToolCall } from '../value-objects/tool-call.js';
+import type { ToolResult } from '../value-objects/tool-result.js';
+import type { Usage } from '../value-objects/usage.js';
+export interface TextStepOptions {
+    text: string;
+    finishReason: FinishReason;
+    toolCalls?: readonly ToolCall[];
+    toolResults?: readonly ToolResult[];
+    /** Carried verbatim: provider-tool RESPONSES are outside this port's slice. */
+    providerToolCalls?: readonly JsonObject[];
+    usage: Usage;
+    meta: Meta;
+    messages?: readonly Message[];
+    systemPrompts?: readonly SystemMessage[];
+    additionalContent?: Readonly<JsonObject>;
+    raw?: JsonObject | null;
+    /** Carried verbatim: tool approval is outside this port's slice. */
+    toolApprovalRequests?: readonly JsonObject[];
+}
+/** One round trip to the provider. */
+export declare class TextStep {
+    readonly text: string;
+    readonly finishReason: FinishReason;
+    readonly toolCalls: readonly ToolCall[];
+    readonly toolResults: readonly ToolResult[];
+    readonly providerToolCalls: readonly JsonObject[];
+    readonly usage: Usage;
+    readonly meta: Meta;
+    readonly messages: readonly Message[];
+    readonly systemPrompts: readonly SystemMessage[];
+    readonly additionalContent: Readonly<JsonObject>;
+    readonly raw: JsonObject | null;
+    readonly toolApprovalRequests: readonly JsonObject[];
+    constructor(options: TextStepOptions);
+    toObject(): JsonObject;
+}
+//# sourceMappingURL=step.d.ts.map

package/dist/text/step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step.d.ts","sourceRoot":"","sources":["../../src/text/step.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACjF,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAEvD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,YAAY,CAAC;IAC3B,SAAS,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;IAChC,WAAW,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IACpC,+EAA+E;IAC/E,iBAAiB,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IAC1C,KAAK,EAAE,KAAK,CAAC;IACb,IAAI,EAAE,IAAI,CAAC;IACX,QAAQ,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IAC9B,aAAa,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;IACzC,iBAAiB,CAAC,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;IACzC,GAAG,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IACxB,oEAAoE;IACpE,oBAAoB,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;CAC9C;AAED,sCAAsC;AACtC,qBAAa,QAAQ;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IAEpC,QAAQ,CAAC,SAAS,EAAE,SAAS,QAAQ,EAAE,CAAC;IAExC,QAAQ,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,CAAC;IAE5C,QAAQ,CAAC,iBAAiB,EAAE,SAAS,UAAU,EAAE,CAAC;IAElD,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IAEtB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IAEpB,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;IAEtC,QAAQ,CAAC,aAAa,EAAE,SAAS,aAAa,EAAE,CAAC;IAEjD,QAAQ,CAAC,iBAAiB,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;IAEjD,QAAQ,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI,CAAC;IAEhC,QAAQ,CAAC,oBAAoB,EAAE,SAAS,UAAU,EAAE,CAAC;gBAEzC,OAAO,EAAE,eAAe;IAepC,QAAQ,IAAI,UAAU;CAgBvB"}

package/dist/text/step.js

@@ -0,0 +1,46 @@
+/** One round trip to the provider. */
+export class TextStep {
+    text;
+    finishReason;
+    toolCalls;
+    toolResults;
+    providerToolCalls;
+    usage;
+    meta;
+    messages;
+    systemPrompts;
+    additionalContent;
+    raw;
+    toolApprovalRequests;
+    constructor(options) {
+        this.text = options.text;
+        this.finishReason = options.finishReason;
+        this.toolCalls = options.toolCalls ?? [];
+        this.toolResults = options.toolResults ?? [];
+        this.providerToolCalls = options.providerToolCalls ?? [];
+        this.usage = options.usage;
+        this.meta = options.meta;
+        this.messages = options.messages ?? [];
+        this.systemPrompts = options.systemPrompts ?? [];
+        this.additionalContent = options.additionalContent ?? {};
+        this.raw = options.raw ?? null;
+        this.toolApprovalRequests = options.toolApprovalRequests ?? [];
+    }
+    toObject() {
+        return {
+            text: this.text,
+            finish_reason: this.finishReason,
+            tool_calls: this.toolCalls.map((toolCall) => toolCall.toObject()),
+            tool_results: this.toolResults.map((toolResult) => toolResult.toObject()),
+            provider_tool_calls: this.providerToolCalls.map((call) => ({ ...call })),
+            usage: this.usage.toObject(),
+            meta: this.meta.toObject(),
+            messages: this.messages.map((message) => message.toObject()),
+            system_prompts: this.systemPrompts.map((systemPrompt) => systemPrompt.toObject()),
+            additional_content: { ...this.additionalContent },
+            raw: this.raw === null ? null : { ...this.raw },
+            tool_approval_requests: this.toolApprovalRequests.map((request) => ({ ...request })),
+        };
+    }
+}
+//# sourceMappingURL=step.js.map

package/dist/text/step.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"step.js","sourceRoot":"","sources":["../../src/text/step.ts"],"names":[],"mappings":"AAyBA,sCAAsC;AACtC,MAAM,OAAO,QAAQ;IACV,IAAI,CAAS;IAEb,YAAY,CAAe;IAE3B,SAAS,CAAsB;IAE/B,WAAW,CAAwB;IAEnC,iBAAiB,CAAwB;IAEzC,KAAK,CAAQ;IAEb,IAAI,CAAO;IAEX,QAAQ,CAAqB;IAE7B,aAAa,CAA2B;IAExC,iBAAiB,CAAuB;IAExC,GAAG,CAAoB;IAEvB,oBAAoB,CAAwB;IAErD,YAAY,OAAwB;QAClC,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;QACzC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC;QACzC,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,EAAE,CAAC;QAC7C,IAAI,CAAC,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,IAAI,EAAE,CAAC;QACzD,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC;QACvC,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,EAAE,CAAC;QACjD,IAAI,CAAC,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,IAAI,EAAE,CAAC;QACzD,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC;QAC/B,IAAI,CAAC,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,IAAI,EAAE,CAAC;IACjE,CAAC;IAED,QAAQ;QACN,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,aAAa,EAAE,IAAI,CAAC,YAAY;YAChC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;YACjE,YAAY,EAAE,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;YACzE,mBAAmB,EAAE,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;YACxE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE;YAC5B,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE;YAC1B,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;YAC5D,cAAc,EAAE,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC;YACjF,kBAAkB,EAAE,EAAE,GAAG,IAAI,CAAC,iBAAiB,EAAE;YACjD,GAAG,EAAE,IAAI,CAAC,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE;YAC/C,sBAAsB,EAAE,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;SACrF,CAAC;IACJ,CAAC;CACF"}

package/dist/tool.d.ts

@@ -0,0 +1,34 @@
+import type { JsonObject, JsonValue } from './json.js';
+import type { Schema } from './schema/index.js';
+export type ToolHandler = (args: JsonObject) => string | Promise<string>;
+/**
+ * A tool the model may call.
+ *
+ * Declaration ORDER matters twice over: the order parameters are added decides
+ * the key order of the JSON Schema `properties` object, and the order tools are
+ * added decides the order they reach the model, which influences selection.
+ * Both are backed by insertion-ordered structures on purpose.
+ */
+export declare class Tool {
+    #private;
+    as(name: string): this;
+    for(description: string): this;
+    using(handler: ToolHandler): this;
+    withParameter(parameter: Schema, required?: boolean): this;
+    withStringParameter(name: string, description: string, required?: boolean): this;
+    withNumberParameter(name: string, description: string, required?: boolean): this;
+    withBooleanParameter(name: string, description: string, required?: boolean): this;
+    withProviderOptions(options?: JsonObject): this;
+    name(): string;
+    description(): string;
+    parameters(): ReadonlyMap<string, Schema>;
+    hasParameters(): boolean;
+    requiredParameters(): readonly string[];
+    /** The `properties` block of the tool's JSON Schema, in declaration order. */
+    parametersAsObject(): JsonObject;
+    providerOptions(): JsonObject;
+    providerOptions(path: string): JsonValue | undefined;
+    hasHandler(): boolean;
+    handle(args: JsonObject): Promise<string>;
+}
+//# sourceMappingURL=tool.d.ts.map

package/dist/tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../src/tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAGhD,MAAM,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,UAAU,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;AAEzE;;;;;;;GAOG;AACH,qBAAa,IAAI;;IAaf,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAMtB,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAM9B,KAAK,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAMjC,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,UAAO,GAAG,IAAI;IAUvD,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,UAAO,GAAG,IAAI;IAI7E,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,UAAO,GAAG,IAAI;IAI7E,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,UAAO,GAAG,IAAI;IAI9E,mBAAmB,CAAC,OAAO,GAAE,UAAe,GAAG,IAAI;IAMnD,IAAI,IAAI,MAAM;IAId,WAAW,IAAI,MAAM;IAIrB,UAAU,IAAI,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC;IAIzC,aAAa,IAAI,OAAO;IAIxB,kBAAkB,IAAI,SAAS,MAAM,EAAE;IAIvC,8EAA8E;IAC9E,kBAAkB,IAAI,UAAU;IAUhC,eAAe,IAAI,UAAU;IAC7B,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAKpD,UAAU,IAAI,OAAO;IAIf,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;CAOhD"}

package/dist/tool.js

@@ -0,0 +1,86 @@
+import { getByPath } from './json.js';
+import { BooleanSchema, NumberSchema, StringSchema } from './schema/index.js';
+/**
+ * A tool the model may call.
+ *
+ * Declaration ORDER matters twice over: the order parameters are added decides
+ * the key order of the JSON Schema `properties` object, and the order tools are
+ * added decides the order they reach the model, which influences selection.
+ * Both are backed by insertion-ordered structures on purpose.
+ */
+export class Tool {
+    #name = '';
+    #description = '';
+    #parameters = new Map();
+    #requiredParameters = [];
+    #providerOptions = {};
+    #handler = null;
+    as(name) {
+        this.#name = name;
+        return this;
+    }
+    for(description) {
+        this.#description = description;
+        return this;
+    }
+    using(handler) {
+        this.#handler = handler;
+        return this;
+    }
+    withParameter(parameter, required = true) {
+        this.#parameters.set(parameter.name, parameter);
+        if (required) {
+            this.#requiredParameters.push(parameter.name);
+        }
+        return this;
+    }
+    withStringParameter(name, description, required = true) {
+        return this.withParameter(new StringSchema(name, description), required);
+    }
+    withNumberParameter(name, description, required = true) {
+        return this.withParameter(new NumberSchema(name, description), required);
+    }
+    withBooleanParameter(name, description, required = true) {
+        return this.withParameter(new BooleanSchema(name, description), required);
+    }
+    withProviderOptions(options = {}) {
+        this.#providerOptions = { ...options };
+        return this;
+    }
+    name() {
+        return this.#name;
+    }
+    description() {
+        return this.#description;
+    }
+    parameters() {
+        return this.#parameters;
+    }
+    hasParameters() {
+        return this.#parameters.size > 0;
+    }
+    requiredParameters() {
+        return this.#requiredParameters;
+    }
+    /** The `properties` block of the tool's JSON Schema, in declaration order. */
+    parametersAsObject() {
+        const properties = {};
+        for (const [name, schema] of this.#parameters) {
+            properties[name] = schema.toObject();
+        }
+        return properties;
+    }
+    providerOptions(path) {
+        return path === undefined ? this.#providerOptions : getByPath(this.#providerOptions, path);
+    }
+    hasHandler() {
+        return this.#handler !== null;
+    }
+    async handle(args) {
+        if (this.#handler === null) {
+            throw new TypeError(`Tool handler not defined for tool: ${this.#name}`);
+        }
+        return this.#handler(args);
+    }
+}
+//# sourceMappingURL=tool.js.map

package/dist/tool.js.map

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

package/dist/value-objects/artifact.d.ts

@@ -0,0 +1,14 @@
+import type { JsonObject } from '../json.js';
+/** A binary payload a tool produced alongside its textual result. */
+export declare class Artifact {
+    readonly data: string;
+    readonly mimeType: string;
+    readonly metadata: Readonly<JsonObject>;
+    readonly id: string | null;
+    constructor(data: string, mimeType: string, metadata?: Readonly<JsonObject>, id?: string | null);
+    rawContent(): Uint8Array;
+    static fromRawContent(content: string | Uint8Array, mimeType: string, metadata?: Readonly<JsonObject>, id?: string | null): Artifact;
+    toObject(): JsonObject;
+    static fromObject(object: JsonObject): Artifact;
+}
+//# sourceMappingURL=artifact.d.ts.map

package/dist/value-objects/artifact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact.d.ts","sourceRoot":"","sources":["../../src/value-objects/artifact.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAG7C,qEAAqE;AACrE,qBAAa,QAAQ;IAEjB,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM;IACzB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC;IACvC,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;gBAHjB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,QAAQ,GAAE,QAAQ,CAAC,UAAU,CAAM,EACnC,EAAE,GAAE,MAAM,GAAG,IAAW;IAGnC,UAAU,IAAI,UAAU;IAIxB,MAAM,CAAC,cAAc,CACnB,OAAO,EAAE,MAAM,GAAG,UAAU,EAC5B,QAAQ,EAAE,MAAM,EAChB,QAAQ,GAAE,QAAQ,CAAC,UAAU,CAAM,EACnC,EAAE,GAAE,MAAM,GAAG,IAAW,GACvB,QAAQ;IAIX,QAAQ,IAAI,UAAU;IAStB,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,QAAQ;CAQhD"}

package/dist/value-objects/artifact.js

@@ -0,0 +1,32 @@
+import { isJsonObject } from '../json.js';
+/** A binary payload a tool produced alongside its textual result. */
+export class Artifact {
+    data;
+    mimeType;
+    metadata;
+    id;
+    constructor(data, mimeType, metadata = {}, id = null) {
+        this.data = data;
+        this.mimeType = mimeType;
+        this.metadata = metadata;
+        this.id = id;
+    }
+    rawContent() {
+        return Uint8Array.from(Buffer.from(this.data, 'base64'));
+    }
+    static fromRawContent(content, mimeType, metadata = {}, id = null) {
+        return new Artifact(Buffer.from(content).toString('base64'), mimeType, metadata, id);
+    }
+    toObject() {
+        return {
+            id: this.id,
+            data: this.data,
+            mime_type: this.mimeType,
+            metadata: { ...this.metadata },
+        };
+    }
+    static fromObject(object) {
+        return new Artifact(typeof object.data === 'string' ? object.data : '', typeof object.mime_type === 'string' ? object.mime_type : '', isJsonObject(object.metadata) ? object.metadata : {}, typeof object.id === 'string' ? object.id : null);
+    }
+}
+//# sourceMappingURL=artifact.js.map

package/dist/value-objects/artifact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact.js","sourceRoot":"","sources":["../../src/value-objects/artifact.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,qEAAqE;AACrE,MAAM,OAAO,QAAQ;IAER;IACA;IACA;IACA;IAJX,YACW,IAAY,EACZ,QAAgB,EAChB,WAAiC,EAAE,EACnC,KAAoB,IAAI;QAHxB,SAAI,GAAJ,IAAI,CAAQ;QACZ,aAAQ,GAAR,QAAQ,CAAQ;QAChB,aAAQ,GAAR,QAAQ,CAA2B;QACnC,OAAE,GAAF,EAAE,CAAsB;IAChC,CAAC;IAEJ,UAAU;QACR,OAAO,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED,MAAM,CAAC,cAAc,CACnB,OAA4B,EAC5B,QAAgB,EAChB,WAAiC,EAAE,EACnC,KAAoB,IAAI;QAExB,OAAO,IAAI,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;IACvF,CAAC;IAED,QAAQ;QACN,OAAO;YACL,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,SAAS,EAAE,IAAI,CAAC,QAAQ;YACxB,QAAQ,EAAE,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE;SAC/B,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,UAAU,CAAC,MAAkB;QAClC,OAAO,IAAI,QAAQ,CACjB,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAClD,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAC5D,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EACpD,OAAO,MAAM,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CACjD,CAAC;IACJ,CAAC;CACF"}

package/dist/value-objects/embedding.d.ts

@@ -0,0 +1,24 @@
+import type { JsonObject } from '../json.js';
+/**
+ * One vector.
+ *
+ * A class rather than a bare `number[]`, matching the reference, and the reason
+ * survives the port: an embedding and an arbitrary array of numbers are the same
+ * shape and different things. A function taking `number[]` accepts a list of
+ * token counts by mistake; one taking `Embedding` does not.
+ */
+export declare class Embedding {
+    readonly embedding: readonly number[];
+    constructor(embedding: readonly number[]);
+    /**
+     * Non-numeric members are DROPPED rather than coerced.
+     *
+     * `Number(null)` is 0 and `Number('')` is 0, so coercing would silently push
+     * a zero into a vector and shift every distance computed against it. A
+     * provider that sent a null in a vector has malfunctioned, and a shorter
+     * vector is a visible fault where a zeroed one is not.
+     */
+    static fromArray(values: readonly unknown[]): Embedding;
+    toObject(): JsonObject;
+}
+//# sourceMappingURL=embedding.d.ts.map

package/dist/value-objects/embedding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding.d.ts","sourceRoot":"","sources":["../../src/value-objects/embedding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;;;;;;GAOG;AACH,qBAAa,SAAS;IACR,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE;gBAA5B,SAAS,EAAE,SAAS,MAAM,EAAE;IAEjD;;;;;;;OAOG;IACH,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,GAAG,SAAS;IAIvD,QAAQ,IAAI,UAAU;CAGvB"}

package/dist/value-objects/embedding.js

@@ -0,0 +1,29 @@
+/**
+ * One vector.
+ *
+ * A class rather than a bare `number[]`, matching the reference, and the reason
+ * survives the port: an embedding and an arbitrary array of numbers are the same
+ * shape and different things. A function taking `number[]` accepts a list of
+ * token counts by mistake; one taking `Embedding` does not.
+ */
+export class Embedding {
+    embedding;
+    constructor(embedding) {
+        this.embedding = embedding;
+    }
+    /**
+     * Non-numeric members are DROPPED rather than coerced.
+     *
+     * `Number(null)` is 0 and `Number('')` is 0, so coercing would silently push
+     * a zero into a vector and shift every distance computed against it. A
+     * provider that sent a null in a vector has malfunctioned, and a shorter
+     * vector is a visible fault where a zeroed one is not.
+     */
+    static fromArray(values) {
+        return new Embedding(values.filter((value) => typeof value === 'number'));
+    }
+    toObject() {
+        return { embedding: [...this.embedding] };
+    }
+}
+//# sourceMappingURL=embedding.js.map

package/dist/value-objects/embedding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding.js","sourceRoot":"","sources":["../../src/value-objects/embedding.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,OAAO,SAAS;IACC;IAArB,YAAqB,SAA4B;QAA5B,cAAS,GAAT,SAAS,CAAmB;IAAG,CAAC;IAErD;;;;;;;OAOG;IACH,MAAM,CAAC,SAAS,CAAC,MAA0B;QACzC,OAAO,IAAI,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC;IAC7F,CAAC;IAED,QAAQ;QACN,OAAO,EAAE,SAAS,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;IAC5C,CAAC;CACF"}