@laserdata/laser-sdk 0.0.1-rc.21 → 0.0.1-rc.22

package/dist/memory/types.js.map

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

package/dist/memory/vector-memory.d.ts

@@ -0,0 +1,20 @@
+import { MemoryId, MemoryKind, type Embedder, type Feedback, type Memory, type MemoryItem, type MemoryQuery, type MemoryScope } from "./types.js";
+export declare class ZeroEmbedder implements Embedder {
+    embed(): Promise<readonly number[]>;
+}
+export declare class VectorMemory implements Memory {
+    private readonly embedder;
+    private readonly laser?;
+    private readonly items;
+    constructor(embedder?: Embedder, laser?: Laser | undefined);
+    static governed(laser: Laser, embedder?: Embedder): VectorMemory;
+    remember(scope: MemoryScope, payload: Uint8Array): Promise<MemoryId>;
+    append(scope: MemoryScope, id: MemoryId, kind: MemoryKind, payload: Uint8Array): Promise<MemoryId>;
+    recall(scope: MemoryScope, query: MemoryQuery): Promise<readonly MemoryItem[]>;
+    improve(scope: MemoryScope, feedback: Feedback): Promise<MemoryId>;
+    forget(scope: MemoryScope, id: MemoryId): Promise<void>;
+    size(): number;
+    private govern;
+}
+import type { Laser } from "../client/laser.js";
+//# sourceMappingURL=vector-memory.d.ts.map

package/dist/memory/vector-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-memory.d.ts","sourceRoot":"","sources":["../../src/memory/vector-memory.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,QAAQ,EACR,UAAU,EAGV,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,KAAK,MAAM,EACX,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,WAAW,EAEjB,MAAM,YAAY,CAAA;AAUnB,qBAAa,YAAa,YAAW,QAAQ;IAC3C,KAAK,IAAI,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAElC;CACF;AAED,qBAAa,YAAa,YAAW,MAAM;IAIvC,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;IAJzB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;IAE1C,YACmB,QAAQ,GAAE,QAA6B,EACvC,KAAK,CAAC,EAAE,KAAK,YAAA,EAC5B;IAEJ,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC,EAAE,QAAQ,GAAG,YAAY,CAE/D;IAEK,QAAQ,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,QAAQ,CAAC,CAEzE;IAEK,MAAM,CACV,KAAK,EAAE,WAAW,EAClB,EAAE,EAAE,QAAQ,EACZ,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,QAAQ,CAAC,CA6BnB;IAEK,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,UAAU,EAAE,CAAC,CA4CnF;IAEK,OAAO,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAYvE;IAEK,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAM5D;IAED,IAAI,IAAI,MAAM,CAEb;YAEa,MAAM;CAoBrB;AAgED,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/memory/vector-memory.js

@@ -0,0 +1,193 @@
+import { Lifetime, MemoryId, MemoryKind, RecallStrategy, ZERO_CONVERSATION } from "./types.js";
+export class ZeroEmbedder {
+    embed() {
+        return Promise.resolve([0]);
+    }
+}
+export class VectorMemory {
+    embedder;
+    laser;
+    items = [];
+    constructor(embedder = new ZeroEmbedder(), laser) {
+        this.embedder = embedder;
+        this.laser = laser;
+    }
+    static governed(laser, embedder) {
+        return new VectorMemory(embedder, laser);
+    }
+    async remember(scope, payload) {
+        return this.append(scope, MemoryId.new(), MemoryKind.Fact, payload);
+    }
+    async append(scope, id, kind, payload) {
+        if (this.items.some((entry) => entry.id.equals(id)))
+            return id;
+        const governed = await this.govern(scope, {
+            kind: "item",
+            id: id.toString(),
+            memoryKind: kind,
+            body: payload
+        });
+        if (governed.kind !== "item")
+            throw new TypeError("governed memory item changed record kind");
+        const embedding = await this.embedder.embed(new TextDecoder().decode(governed.body));
+        const provenance = {
+            conversationId: scope.conversation ?? ZERO_CONVERSATION,
+            ...(scope.agent !== undefined ? { agent: scope.agent } : {}),
+            idempotencyKey: id.toString()
+        };
+        this.items.push({
+            id,
+            scope: normalizedScope(scope),
+            embedding: [...embedding],
+            item: {
+                id,
+                payload: governed.body.slice(),
+                provenance,
+                kind,
+                signals: []
+            },
+            feedback: 0
+        });
+        return id;
+    }
+    async recall(scope, query) {
+        const limit = query.limit ?? 50;
+        const strategy = query.strategy ?? RecallStrategy.Auto;
+        const text = query.semantic;
+        const wantsSemantic = text !== undefined &&
+            strategy !== RecallStrategy.Keyword &&
+            strategy !== RecallStrategy.Recent;
+        const wantsKeyword = text !== undefined &&
+            (strategy === RecallStrategy.Keyword || strategy === RecallStrategy.Hybrid);
+        const queryEmbedding = wantsSemantic ? await this.embedder.embed(text) : undefined;
+        const queryTokens = wantsKeyword ? tokenize(text) : undefined;
+        const agent = query.agent ?? scope.agent;
+        const matched = this.items.filter((entry) => matchesScope(entry.scope, scope, agent));
+        if (queryEmbedding === undefined && queryTokens === undefined && !matched.some(hasFeedback)) {
+            return matched
+                .slice()
+                .reverse()
+                .slice(0, limit)
+                .map((entry) => copyItem(entry.item));
+        }
+        return matched
+            .map((entry) => {
+            const semantic = queryEmbedding === undefined ? undefined : cosine(queryEmbedding, entry.embedding);
+            const keyword = queryTokens === undefined ? undefined : keywordScore(queryTokens, entry.item.payload);
+            const score = entry.feedback + (semantic ?? 0) + (keyword ?? 0);
+            const signals = [];
+            if (semantic !== undefined)
+                signals.push({ strategy: RecallStrategy.Semantic, rank: 0, score: semantic });
+            if (keyword !== undefined)
+                signals.push({ strategy: RecallStrategy.Keyword, rank: 0, score: keyword });
+            if (entry.feedback !== 0) {
+                signals.push({ strategy: RecallStrategy.Auto, rank: 0, score: entry.feedback });
+            }
+            return { entry, score, signals };
+        })
+            .sort((left, right) => right.score - left.score)
+            .slice(0, limit)
+            .map(({ entry, score, signals }) => ({ ...copyItem(entry.item), score, signals }));
+    }
+    async improve(scope, feedback) {
+        const governed = await this.govern(scope, {
+            kind: "feedback",
+            target: feedback.target.toString(),
+            weight: feedback.weight
+        });
+        if (governed.kind !== "feedback") {
+            throw new TypeError("governed memory feedback changed record kind");
+        }
+        const entry = this.items.find((candidate) => candidate.id.toString() === governed.target);
+        if (entry !== undefined)
+            entry.feedback += governed.weight;
+        return MemoryId.new();
+    }
+    async forget(scope, id) {
+        const governed = await this.govern(scope, { kind: "forget", target: id.toString() });
+        if (governed.kind !== "forget")
+            throw new TypeError("governed memory forget changed record kind");
+        const index = this.items.findIndex((entry) => entry.id.toString() === governed.target);
+        if (index !== -1)
+            this.items.splice(index, 1);
+    }
+    size() {
+        return this.items.length;
+    }
+    async govern(scope, record) {
+        if (this.laser === undefined)
+            return record;
+        const stream = this.laser.defaultStream;
+        if (stream === undefined)
+            throw new NoStreamError("governed vector memory requires a stream");
+        const encoded = record.kind === "item" ? record.body : encodeMemoryRecordFrame(record);
+        const payload = await this.laser[INTERNAL_GOVERN]({
+            kind: ActionKind.MemoryWrite,
+            stream,
+            topic: AgentTopic.Audit,
+            ...(scope.agent !== undefined ? { source: scope.agent.asString() } : {}),
+            ...(scope.conversation !== undefined ? { conversation: scope.conversation } : {}),
+            payload: encoded,
+            signed: false
+        });
+        if (record.kind === "item")
+            return { ...record, body: payload };
+        return decodeMemoryRecord(decodeOne(payload, "governed memory record"), "governed memory record");
+    }
+}
+function normalizedScope(scope) {
+    return { ...scope, lifetime: scope.lifetime ?? Lifetime.Session };
+}
+function matchesScope(stored, requested, agent) {
+    return ((requested.stream === undefined || stored.stream === requested.stream) &&
+        (requested.user === undefined || stored.user === requested.user) &&
+        (agent === undefined || stored.agent?.equals(agent) === true) &&
+        (requested.conversation === undefined ||
+            stored.conversation?.equals(requested.conversation) === true) &&
+        (requested.application === undefined || stored.application === requested.application) &&
+        (requested.lifetime === undefined ||
+            (stored.lifetime ?? Lifetime.Session) === requested.lifetime));
+}
+function hasFeedback(entry) {
+    return entry.feedback !== 0;
+}
+function copyItem(item) {
+    return { ...item, payload: item.payload.slice(), signals: [...item.signals] };
+}
+function cosine(left, right) {
+    let dot = 0;
+    let leftNorm = 0;
+    let rightNorm = 0;
+    const length = Math.min(left.length, right.length);
+    for (let index = 0; index < length; index += 1) {
+        const leftValue = left[index] ?? 0;
+        const rightValue = right[index] ?? 0;
+        dot += leftValue * rightValue;
+        leftNorm += leftValue * leftValue;
+        rightNorm += rightValue * rightValue;
+    }
+    return leftNorm === 0 || rightNorm === 0 ? 0 : dot / Math.sqrt(leftNorm * rightNorm);
+}
+function tokenize(text) {
+    return new Set(text
+        .toLowerCase()
+        .split(/[^\p{L}\p{N}]+/u)
+        .filter(Boolean));
+}
+function keywordScore(query, payload) {
+    if (query.size === 0)
+        return 0;
+    const body = tokenize(new TextDecoder().decode(payload));
+    let hits = 0;
+    for (const token of query)
+        if (body.has(token))
+            hits += 1;
+    return hits / query.size;
+}
+import { NoStreamError } from "../client/errors.js";
+import { INTERNAL_GOVERN } from "../client/internals.js";
+import { ActionKind } from "../govern.js";
+import { AgentTopic } from "../provenance/agent-topic.js";
+import { decodeOne } from "../wire/cbor.js";
+import { decodeMemoryRecord, encodeMemoryRecordFrame } from "../wire/memory.js";
+//# sourceMappingURL=vector-memory.js.map

package/dist/memory/vector-memory.js.map

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

package/dist/memory.d.ts

@@ -0,0 +1,7 @@
+export { LogMemory } from "./memory/log-memory.js";
+export { MemoryBackend, MemoryHandle, RecallBuilder, RememberBuilder } from "./memory/handle.js";
+export { MemoryTopicBuilder } from "./memory/topic.js";
+export { Lifetime, MemoryClass, MemoryId, MemoryKind, RecallStrategy, fuseReciprocalRank, memoryClass, toContextBlock } from "./memory/types.js";
+export type { ConsolidationReport, Consolidator, Embedder, Feedback, Memory, MemoryItem, MemoryQuery, MemoryScope, RecallSignal, Reranker } from "./memory/types.js";
+export { VectorMemory, ZeroEmbedder } from "./memory/vector-memory.js";
+//# sourceMappingURL=memory.d.ts.map

package/dist/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../src/memory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAA;AAClD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAChG,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,EACL,QAAQ,EACR,WAAW,EACX,QAAQ,EACR,UAAU,EACV,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,cAAc,EACf,MAAM,mBAAmB,CAAA;AAC1B,YAAY,EACV,mBAAmB,EACnB,YAAY,EACZ,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,UAAU,EACV,WAAW,EACX,WAAW,EACX,YAAY,EACZ,QAAQ,EACT,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA"}

package/dist/memory.js

@@ -0,0 +1,6 @@
+export { LogMemory } from "./memory/log-memory.js";
+export { MemoryBackend, MemoryHandle, RecallBuilder, RememberBuilder } from "./memory/handle.js";
+export { MemoryTopicBuilder } from "./memory/topic.js";
+export { Lifetime, MemoryClass, MemoryId, MemoryKind, RecallStrategy, fuseReciprocalRank, memoryClass, toContextBlock } from "./memory/types.js";
+export { VectorMemory, ZeroEmbedder } from "./memory/vector-memory.js";
+//# sourceMappingURL=memory.js.map

package/dist/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../src/memory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAA;AAClD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAChG,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,EACL,QAAQ,EACR,WAAW,EACX,QAAQ,EACR,UAAU,EACV,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,cAAc,EACf,MAAM,mBAAmB,CAAA;AAa1B,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA"}

package/dist/observe.d.ts

@@ -0,0 +1,10 @@
+export type ObservationLevel = "debug" | "info" | "warn" | "error";
+export interface SpanScope {
+    end(error?: unknown): void;
+}
+export interface LaserObserver {
+    start(operation: string, attributes: Readonly<Record<string, unknown>>): SpanScope;
+    event(level: ObservationLevel, name: string, fields: Readonly<Record<string, unknown>>): void;
+}
+export declare const NOOP_OBSERVER: LaserObserver;
+//# sourceMappingURL=observe.d.ts.map

package/dist/observe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observe.d.ts","sourceRoot":"","sources":["../src/observe.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;AAElE,MAAM,WAAW,SAAS;IACxB,GAAG,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAAA;IAClF,KAAK,CAAC,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,CAAA;CAC9F;AAED,eAAO,MAAM,aAAa,EAAE,aAG1B,CAAA"}

package/dist/observe.js

@@ -0,0 +1,5 @@
+export const NOOP_OBSERVER = Object.freeze({
+    start: () => ({ end: () => undefined }),
+    event: () => undefined
+});
+//# sourceMappingURL=observe.js.map

package/dist/observe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observe.js","sourceRoot":"","sources":["../src/observe.ts"],"names":[],"mappings":"AAWA,MAAM,CAAC,MAAM,aAAa,GAAkB,MAAM,CAAC,MAAM,CAAC;IACxD,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC;IACvC,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS;CACvB,CAAC,CAAA"}

package/dist/opentelemetry.d.ts

@@ -0,0 +1,22 @@
+import type { LaserObserver, ObservationLevel, SpanScope } from "./observe.js";
+export interface OpenTelemetrySpan {
+    setAttribute(name: string, value: string | number | boolean): this;
+    setStatus(status: {
+        readonly code: number;
+        readonly message?: string;
+    }): this;
+    addEvent(name: string, attributes?: Readonly<Record<string, string | number | boolean>>): this;
+    end(): void;
+}
+export interface OpenTelemetryTracer {
+    startSpan(name: string, options?: {
+        readonly attributes?: Readonly<Record<string, string | number | boolean>>;
+    }): OpenTelemetrySpan;
+}
+export declare class OpenTelemetryObserver implements LaserObserver {
+    private readonly tracer;
+    constructor(tracer: OpenTelemetryTracer);
+    start(operation: string, attributes: Readonly<Record<string, unknown>>): SpanScope;
+    event(level: ObservationLevel, name: string, fields: Readonly<Record<string, unknown>>): void;
+}
+//# sourceMappingURL=opentelemetry.d.ts.map

package/dist/opentelemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opentelemetry.d.ts","sourceRoot":"","sources":["../src/opentelemetry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAE9E,MAAM,WAAW,iBAAiB;IAChC,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAA;IAClE,SAAS,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;IAC7E,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAA;IAC9F,GAAG,IAAI,IAAI,CAAA;CACZ;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,CACP,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC,CAAA;KAAE,GACtF,iBAAiB,CAAA;CACrB;AAkBD,qBAAa,qBAAsB,YAAW,aAAa;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM;IAAnC,YAA6B,MAAM,EAAE,mBAAmB,EAAI;IAE5D,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAkBjF;IAED,KAAK,CAAC,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,CAI5F;CACF"}

package/dist/opentelemetry.js

@@ -0,0 +1,38 @@
+const STATUS_ERROR = 2;
+function safeAttributes(fields) {
+    return Object.fromEntries(Object.entries(fields).flatMap(([key, value]) => typeof value === "string" || typeof value === "number" || typeof value === "boolean"
+        ? [[key, value]]
+        : typeof value === "bigint"
+            ? [[key, value.toString()]]
+            : []));
+}
+export class OpenTelemetryObserver {
+    tracer;
+    constructor(tracer) {
+        this.tracer = tracer;
+    }
+    start(operation, attributes) {
+        const span = this.tracer.startSpan(operation, { attributes: safeAttributes(attributes) });
+        return {
+            end(error) {
+                if (error !== undefined) {
+                    span.setStatus({
+                        code: STATUS_ERROR,
+                        message: error instanceof Error
+                            ? error.message
+                            : typeof error === "string"
+                                ? error
+                                : "operation failed with a non-Error value"
+                    });
+                }
+                span.end();
+            }
+        };
+    }
+    event(level, name, fields) {
+        const span = this.tracer.startSpan("laser.event");
+        span.addEvent(name, { level, ...safeAttributes(fields) });
+        span.end();
+    }
+}
+//# sourceMappingURL=opentelemetry.js.map

package/dist/opentelemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opentelemetry.js","sourceRoot":"","sources":["../src/opentelemetry.ts"],"names":[],"mappings":"AAgBA,MAAM,YAAY,GAAG,CAAC,CAAA;AAEtB,SAAS,cAAc,CACrB,MAAyC;IAEzC,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAC9C,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS;QAClF,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAU,CAAC;QACzB,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ;YACzB,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAU,CAAC;YACpC,CAAC,CAAC,EAAE,CACT,CACF,CAAA;AACH,CAAC;AAED,MAAM,OAAO,qBAAqB;IACH,MAAM;IAAnC,YAA6B,MAA2B;sBAA3B,MAAM;IAAwB,CAAC;IAE5D,KAAK,CAAC,SAAiB,EAAE,UAA6C;QACpE,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,UAAU,EAAE,cAAc,CAAC,UAAU,CAAC,EAAE,CAAC,CAAA;QACzF,OAAO;YACL,GAAG,CAAC,KAAe;gBACjB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;oBACxB,IAAI,CAAC,SAAS,CAAC;wBACb,IAAI,EAAE,YAAY;wBAClB,OAAO,EACL,KAAK,YAAY,KAAK;4BACpB,CAAC,CAAC,KAAK,CAAC,OAAO;4BACf,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ;gCACzB,CAAC,CAAC,KAAK;gCACP,CAAC,CAAC,yCAAyC;qBAClD,CAAC,CAAA;gBACJ,CAAC;gBACD,IAAI,CAAC,GAAG,EAAE,CAAA;YACZ,CAAC;SACF,CAAA;IACH,CAAC;IAED,KAAK,CAAC,KAAuB,EAAE,IAAY,EAAE,MAAyC;QACpF,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,aAAa,CAAC,CAAA;QACjD,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,GAAG,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;QACzD,IAAI,CAAC,GAAG,EAAE,CAAA;IACZ,CAAC;CACF"}

package/dist/provenance/agent-topic.d.ts

@@ -0,0 +1,14 @@
+export declare const AgentTopic: {
+    readonly Commands: "agent.commands";
+    readonly Responses: "agent.responses";
+    readonly ToolCalls: "agent.tool_calls";
+    readonly ToolResults: "agent.tool_results";
+    readonly LlmIo: "agent.llm_io";
+    readonly HumanInput: "agent.human_input";
+    readonly Audit: "agent.audit";
+    readonly Registry: "agent.registry";
+    readonly WorkflowJournal: "agent.workflow_journal";
+    readonly Dlq: "agent.dlq";
+};
+export type AgentTopic = (typeof AgentTopic)[keyof typeof AgentTopic];
+//# sourceMappingURL=agent-topic.d.ts.map

package/dist/provenance/agent-topic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-topic.d.ts","sourceRoot":"","sources":["../../src/provenance/agent-topic.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU;aACrB,QAAQ,EAAE,gBAAgB;aAC1B,SAAS,EAAE,iBAAiB;aAC5B,SAAS,EAAE,kBAAkB;aAC7B,WAAW,EAAE,oBAAoB;aACjC,KAAK,EAAE,cAAc;aACrB,UAAU,EAAE,mBAAmB;aAC/B,KAAK,EAAE,aAAa;aACpB,QAAQ,EAAE,gBAAgB;aAC1B,eAAe,EAAE,wBAAwB;aACzC,GAAG,EAAE,WAAW;CACR,CAAA;AAEV,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,CAAA"}

package/dist/provenance/agent-topic.js

@@ -0,0 +1,13 @@
+export const AgentTopic = {
+    Commands: "agent.commands",
+    Responses: "agent.responses",
+    ToolCalls: "agent.tool_calls",
+    ToolResults: "agent.tool_results",
+    LlmIo: "agent.llm_io",
+    HumanInput: "agent.human_input",
+    Audit: "agent.audit",
+    Registry: "agent.registry",
+    WorkflowJournal: "agent.workflow_journal",
+    Dlq: "agent.dlq"
+};
+//# sourceMappingURL=agent-topic.js.map

package/dist/provenance/agent-topic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-topic.js","sourceRoot":"","sources":["../../src/provenance/agent-topic.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,QAAQ,EAAE,gBAAgB;IAC1B,SAAS,EAAE,iBAAiB;IAC5B,SAAS,EAAE,kBAAkB;IAC7B,WAAW,EAAE,oBAAoB;IACjC,KAAK,EAAE,cAAc;IACrB,UAAU,EAAE,mBAAmB;IAC/B,KAAK,EAAE,aAAa;IACpB,QAAQ,EAAE,gBAAgB;IAC1B,eAAe,EAAE,wBAAwB;IACzC,GAAG,EAAE,WAAW;CACR,CAAA"}

package/dist/provenance/provenance.d.ts

@@ -0,0 +1,24 @@
+import type { IggyHeaderValue } from "../iggy/apache-iggy.js";
+import { AgentId, ConversationId, type MessageId } from "../types/ids.js";
+export interface LlmUsage {
+    readonly inputTokens?: bigint;
+    readonly outputTokens?: bigint;
+    readonly costUsd?: number;
+}
+export interface Provenance {
+    readonly conversationId: ConversationId;
+    readonly causalParent?: MessageId;
+    readonly parentConversationId?: ConversationId;
+    readonly rootConversationId?: ConversationId;
+    readonly agent?: AgentId;
+    readonly targetAgentId?: AgentId;
+    readonly usage?: LlmUsage;
+    readonly deadlineMicros?: bigint;
+    readonly idempotencyKey?: string;
+    readonly correlationId?: string;
+    readonly fenceToken?: bigint;
+}
+export declare function provenancePartitionKey(provenance: Provenance): string;
+export declare function encodeProvenanceHeaders(provenance: Provenance): ReadonlyMap<string, IggyHeaderValue>;
+export declare function decodeProvenanceHeaders(headers: ReadonlyMap<string, IggyHeaderValue>): Provenance;
+//# sourceMappingURL=provenance.d.ts.map

package/dist/provenance/provenance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provenance.d.ts","sourceRoot":"","sources":["../../src/provenance/provenance.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAC7D,OAAO,EACL,OAAO,EACP,cAAc,EACd,KAAK,SAAS,EAGf,MAAM,iBAAiB,CAAA;AAoBxB,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAA;IACvC,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,CAAA;IACjC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,cAAc,CAAA;IAC9C,QAAQ,CAAC,kBAAkB,CAAC,EAAE,cAAc,CAAA;IAC5C,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAA;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAA;IACzB,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAC7B;AAED,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAErE;AA2BD,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,UAAU,GACrB,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC,CAqDtC;AAwBD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,UAAU,CA0FjG"}

package/dist/provenance/provenance.js

@@ -0,0 +1,186 @@
+import { CodecError, InvalidError } from "../client/errors.js";
+import { AgentId, ConversationId, messageIdToString, parseMessageId } from "../types/ids.js";
+import { AGENT_ID, CAUSAL_PARENT, CONVERSATION_ID, CORRELATION_ID, COST_USD, DEADLINE, FENCE, HEADER_FRAMING_BYTES, HEADER_SOFT_CAP, HEADER_VALUE_MAX, IDEMPOTENCY_KEY, PARENT_CONVERSATION_ID, ROOT_CONVERSATION_ID, TARGET_AGENT_ID, USAGE_INPUT_TOKENS, USAGE_OUTPUT_TOKENS } from "../wire/headers.js";
+export function provenancePartitionKey(provenance) {
+    return provenance.conversationId.toString();
+}
+function putHeader(map, key, value) {
+    if (value.length === 0) {
+        throw new InvalidError(`header \`${key}\` value must not be empty`);
+    }
+    const bytes = new TextEncoder().encode(value);
+    if (bytes.length > HEADER_VALUE_MAX) {
+        throw new InvalidError(`header \`${key}\` value is ${String(bytes.length)}B, exceeds max ${String(HEADER_VALUE_MAX)}B`);
+    }
+    for (const byte of bytes) {
+        if (byte < 0x20 || byte === 0x7f) {
+            throw new InvalidError(`header \`${key}\` value must not contain control characters or NUL`);
+        }
+    }
+    map.set(key, { kind: "string", value });
+}
+function putFinite(map, key, value) {
+    if (!Number.isFinite(value)) {
+        throw new InvalidError(`non-finite floating-point value for header \`${key}\``);
+    }
+    putHeader(map, key, String(value));
+}
+export function encodeProvenanceHeaders(provenance) {
+    const map = new Map();
+    putHeader(map, CONVERSATION_ID, provenance.conversationId.toString());
+    if (provenance.parentConversationId !== undefined) {
+        putHeader(map, PARENT_CONVERSATION_ID, provenance.parentConversationId.toString());
+    }
+    if (provenance.rootConversationId !== undefined) {
+        putHeader(map, ROOT_CONVERSATION_ID, provenance.rootConversationId.toString());
+    }
+    if (provenance.causalParent !== undefined) {
+        putHeader(map, CAUSAL_PARENT, messageIdToString(provenance.causalParent));
+    }
+    if (provenance.agent !== undefined) {
+        putHeader(map, AGENT_ID, provenance.agent.asString());
+    }
+    if (provenance.targetAgentId !== undefined) {
+        putHeader(map, TARGET_AGENT_ID, provenance.targetAgentId.asString());
+    }
+    if (provenance.idempotencyKey !== undefined) {
+        putHeader(map, IDEMPOTENCY_KEY, provenance.idempotencyKey);
+    }
+    if (provenance.correlationId !== undefined) {
+        putHeader(map, CORRELATION_ID, provenance.correlationId);
+    }
+    if (provenance.fenceToken !== undefined) {
+        putHeader(map, FENCE, provenance.fenceToken.toString());
+    }
+    if (provenance.deadlineMicros !== undefined) {
+        putHeader(map, DEADLINE, provenance.deadlineMicros.toString());
+    }
+    if (provenance.usage !== undefined) {
+        if (provenance.usage.inputTokens !== undefined) {
+            putHeader(map, USAGE_INPUT_TOKENS, provenance.usage.inputTokens.toString());
+        }
+        if (provenance.usage.outputTokens !== undefined) {
+            putHeader(map, USAGE_OUTPUT_TOKENS, provenance.usage.outputTokens.toString());
+        }
+        if (provenance.usage.costUsd !== undefined) {
+            putFinite(map, COST_USD, provenance.usage.costUsd);
+        }
+    }
+    let size = 0;
+    for (const [key, value] of map) {
+        const valueBytes = value.kind === "string" ? new TextEncoder().encode(value.value).length : 0;
+        size += new TextEncoder().encode(key).length + valueBytes + HEADER_FRAMING_BYTES;
+    }
+    if (size > HEADER_SOFT_CAP) {
+        throw new InvalidError(`provenance headers ${String(size)}B exceed soft cap ${String(HEADER_SOFT_CAP)}B`);
+    }
+    return map;
+}
+function strValue(value, key) {
+    if (value.kind !== "string") {
+        throw new CodecError(`invalid value for header \`${key}\``, "provenance", "decode");
+    }
+    return value.value;
+}
+function parseUnsignedBigInt(text, key) {
+    if (!/^[0-9]+$/.test(text)) {
+        throw new CodecError(`invalid value for header \`${key}\``, "provenance", "decode");
+    }
+    return BigInt(text);
+}
+function parseFloatValue(text, key) {
+    const parsed = Number(text);
+    if (Number.isNaN(parsed) && text.trim().toLowerCase() !== "nan") {
+        throw new CodecError(`invalid value for header \`${key}\``, "provenance", "decode");
+    }
+    return parsed;
+}
+export function decodeProvenanceHeaders(headers) {
+    let conversationId;
+    let causalParent;
+    let parentConversationId;
+    let rootConversationId;
+    let agent;
+    let targetAgentId;
+    let idempotencyKey;
+    let correlationId;
+    let fenceToken;
+    let deadlineMicros;
+    let inputTokens;
+    let outputTokens;
+    let costUsd;
+    let hasUsage = false;
+    for (const [key, value] of headers) {
+        switch (key) {
+            case CONVERSATION_ID:
+                conversationId = ConversationId.parse(strValue(value, key));
+                break;
+            case CAUSAL_PARENT:
+                causalParent = parseMessageId(strValue(value, key));
+                break;
+            case PARENT_CONVERSATION_ID:
+                parentConversationId = ConversationId.parse(strValue(value, key));
+                break;
+            case ROOT_CONVERSATION_ID:
+                rootConversationId = ConversationId.parse(strValue(value, key));
+                break;
+            case AGENT_ID:
+                agent = AgentId.new(strValue(value, key));
+                break;
+            case TARGET_AGENT_ID:
+                targetAgentId = AgentId.new(strValue(value, key));
+                break;
+            case IDEMPOTENCY_KEY:
+                idempotencyKey = strValue(value, key);
+                break;
+            case CORRELATION_ID:
+                correlationId = strValue(value, key);
+                break;
+            case FENCE:
+                fenceToken = parseUnsignedBigInt(strValue(value, key), key);
+                break;
+            case DEADLINE:
+                deadlineMicros = parseUnsignedBigInt(strValue(value, key), key);
+                break;
+            case USAGE_INPUT_TOKENS:
+                inputTokens = parseUnsignedBigInt(strValue(value, key), key);
+                hasUsage = true;
+                break;
+            case USAGE_OUTPUT_TOKENS:
+                outputTokens = parseUnsignedBigInt(strValue(value, key), key);
+                hasUsage = true;
+                break;
+            case COST_USD:
+                costUsd = parseFloatValue(strValue(value, key), key);
+                hasUsage = true;
+                break;
+            default:
+                break;
+        }
+    }
+    if (conversationId === undefined) {
+        throw new CodecError(`missing required header \`${CONVERSATION_ID}\``, "provenance", "decode");
+    }
+    return {
+        conversationId,
+        ...(causalParent !== undefined ? { causalParent } : {}),
+        ...(parentConversationId !== undefined ? { parentConversationId } : {}),
+        ...(rootConversationId !== undefined ? { rootConversationId } : {}),
+        ...(agent !== undefined ? { agent } : {}),
+        ...(targetAgentId !== undefined ? { targetAgentId } : {}),
+        ...(hasUsage
+            ? {
+                usage: {
+                    ...(inputTokens !== undefined ? { inputTokens } : {}),
+                    ...(outputTokens !== undefined ? { outputTokens } : {}),
+                    ...(costUsd !== undefined ? { costUsd } : {})
+                }
+            }
+            : {}),
+        ...(deadlineMicros !== undefined ? { deadlineMicros } : {}),
+        ...(idempotencyKey !== undefined ? { idempotencyKey } : {}),
+        ...(correlationId !== undefined ? { correlationId } : {}),
+        ...(fenceToken !== undefined ? { fenceToken } : {})
+    };
+}
+//# sourceMappingURL=provenance.js.map