actoviq-agent-sdk 0.4.6 → 0.4.7

package/dist/src/core/usage.js

@@ -0,0 +1,111 @@
+const USAGE_FIELDS = [
+    'requests',
+    'inputTokens',
+    'outputTokens',
+    'totalTokens',
+    'cacheReadTokens',
+    'cacheWriteTokens',
+    'reasoningTokens',
+    'audioInputTokens',
+    'audioOutputTokens',
+    'costUsd',
+];
+const INTEGER_USAGE_FIELDS = new Set([
+    'requests',
+    'inputTokens',
+    'outputTokens',
+    'totalTokens',
+    'cacheReadTokens',
+    'cacheWriteTokens',
+    'reasoningTokens',
+    'audioInputTokens',
+    'audioOutputTokens',
+]);
+export function emptyUsage() {
+    return {
+        requests: 0,
+        inputTokens: 0,
+        outputTokens: 0,
+        totalTokens: 0,
+        cacheReadTokens: 0,
+        cacheWriteTokens: 0,
+        reasoningTokens: 0,
+        audioInputTokens: 0,
+        audioOutputTokens: 0,
+        costUsd: 0,
+    };
+}
+/**
+ * Mutable run-local counter with immutable snapshots.
+ *
+ * Cache and reasoning counters describe token subsets and therefore do not get
+ * added to totalTokens a second time. When a provider omits totalTokens, the
+ * delta total is derived from inputTokens + outputTokens.
+ */
+export class UsageAccumulator {
+    totals = emptyUsage();
+    constructor(initial) {
+        if (initial === undefined)
+            return;
+        if (isIterable(initial)) {
+            this.addAll(initial);
+        }
+        else {
+            this.add(initial);
+        }
+    }
+    add(delta) {
+        const normalized = normalizeUsageDelta(delta);
+        const current = this.totals;
+        this.totals = {
+            requests: current.requests + normalized.requests,
+            inputTokens: current.inputTokens + normalized.inputTokens,
+            outputTokens: current.outputTokens + normalized.outputTokens,
+            totalTokens: current.totalTokens + normalized.totalTokens,
+            cacheReadTokens: current.cacheReadTokens + normalized.cacheReadTokens,
+            cacheWriteTokens: current.cacheWriteTokens + normalized.cacheWriteTokens,
+            reasoningTokens: current.reasoningTokens + normalized.reasoningTokens,
+            audioInputTokens: current.audioInputTokens + normalized.audioInputTokens,
+            audioOutputTokens: current.audioOutputTokens + normalized.audioOutputTokens,
+            costUsd: current.costUsd + normalized.costUsd,
+        };
+        return this;
+    }
+    addAll(deltas) {
+        for (const delta of deltas)
+            this.add(delta);
+        return this;
+    }
+    snapshot() {
+        return Object.freeze({ ...this.totals });
+    }
+    reset() {
+        this.totals = emptyUsage();
+    }
+}
+export function normalizeUsageDelta(delta) {
+    const normalized = emptyUsage();
+    for (const field of USAGE_FIELDS) {
+        const value = delta[field];
+        if (value === undefined)
+            continue;
+        assertUsageCounter(field, value);
+        normalized[field] = value;
+    }
+    if (delta.totalTokens === undefined) {
+        normalized.totalTokens = normalized.inputTokens + normalized.outputTokens;
+    }
+    return normalized;
+}
+function assertUsageCounter(field, value) {
+    if (!Number.isFinite(value) || value < 0) {
+        throw new RangeError(`Usage field "${field}" must be a finite, non-negative number.`);
+    }
+    if (INTEGER_USAGE_FIELDS.has(field) && !Number.isSafeInteger(value)) {
+        throw new RangeError(`Usage field "${field}" must be a non-negative safe integer.`);
+    }
+}
+function isIterable(value) {
+    return Symbol.iterator in value;
+}
+//# sourceMappingURL=usage.js.map

package/dist/src/core/usage.js.map

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

package/dist/src/errors.d.ts

@@ -12,6 +12,18 @@ export declare class ConfigurationError extends ActoviqSdkError {
 export declare class SessionNotFoundError extends ActoviqSdkError {
     constructor(sessionId: string);
 }
+export declare class SessionConflictError extends ActoviqSdkError {
+    readonly sessionId: string;
+    readonly expectedRevision: number;
+    readonly actualRevision: number;
+    constructor(sessionId: string, expectedRevision: number, actualRevision: number);
+}
+export declare class SessionDataError extends ActoviqSdkError {
+    readonly sessionId: string;
+    constructor(sessionId: string, message: string, options?: {
+        cause?: unknown;
+    });
+}
 export declare class ToolExecutionError extends ActoviqSdkError {
     readonly toolName: string;
     constructor(toolName: string, message: string, options?: {
@@ -23,6 +35,13 @@ export declare class RunAbortedError extends ActoviqSdkError {
         cause?: unknown;
     });
 }
+export declare class DeadlineExceededError extends ActoviqSdkError {
+    readonly scope: string;
+    readonly timeoutMs: number;
+    constructor(scope: string, timeoutMs: number, options?: {
+        cause?: unknown;
+    });
+}
 export declare class ActoviqProviderApiError extends ActoviqSdkError {
     readonly status: number;
     readonly errorType?: string;

package/dist/src/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,OAAO,EAAE,MAAM,EAAE,IAAI,SAAsB,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAKvF;AAED,qBAAa,kBAAmB,SAAQ,eAAe;gBACzC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAG3D;AAED,qBAAa,oBAAqB,SAAQ,eAAe;gBAC3C,SAAS,EAAE,MAAM;CAG9B;AAED,qBAAa,kBAAmB,SAAQ,eAAe;IACrD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAI7E;AAED,qBAAa,eAAgB,SAAQ,eAAe;gBACtC,OAAO,SAAyB,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAG5E;AAED,qBAAa,uBAAwB,SAAQ,eAAe;IAC1D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;gBAG1B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;QACP,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB;CAMJ;AAED,qBAAa,yBAA0B,SAAQ,eAAe;IAC5D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;gBAGhC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE;CAM3E"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,OAAO,EAAE,MAAM,EAAE,IAAI,SAAsB,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAKvF;AAED,qBAAa,kBAAmB,SAAQ,eAAe;gBACzC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAG3D;AAED,qBAAa,oBAAqB,SAAQ,eAAe;gBAC3C,SAAS,EAAE,MAAM;CAG9B;AAED,qBAAa,oBAAqB,SAAQ,eAAe;IACvD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;gBAEpB,SAAS,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM;CAShF;AAED,qBAAa,gBAAiB,SAAQ,eAAe;IACnD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAEf,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAI9E;AAED,qBAAa,kBAAmB,SAAQ,eAAe;IACrD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAI7E;AAED,qBAAa,eAAgB,SAAQ,eAAe;gBACtC,OAAO,SAAyB,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAG5E;AAED,qBAAa,qBAAsB,SAAQ,eAAe;IACxD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAEf,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAK5E;AAED,qBAAa,uBAAwB,SAAQ,eAAe;IAC1D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;gBAG1B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;QACP,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB;CAMJ;AAED,qBAAa,yBAA0B,SAAQ,eAAe;IAC5D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;gBAGhC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE;CAM3E"}

package/dist/src/errors.js

@@ -16,6 +16,24 @@ export class SessionNotFoundError extends ActoviqSdkError {
         super(`Session "${sessionId}" was not found.`, 'SESSION_NOT_FOUND');
     }
 }
+export class SessionConflictError extends ActoviqSdkError {
+    sessionId;
+    expectedRevision;
+    actualRevision;
+    constructor(sessionId, expectedRevision, actualRevision) {
+        super(`Session "${sessionId}" changed since it was loaded (expected revision ${expectedRevision}, actual revision ${actualRevision}).`, 'SESSION_CONFLICT');
+        this.sessionId = sessionId;
+        this.expectedRevision = expectedRevision;
+        this.actualRevision = actualRevision;
+    }
+}
+export class SessionDataError extends ActoviqSdkError {
+    sessionId;
+    constructor(sessionId, message, options) {
+        super(`Session "${sessionId}" is invalid: ${message}`, 'SESSION_DATA_INVALID', options);
+        this.sessionId = sessionId;
+    }
+}
 export class ToolExecutionError extends ActoviqSdkError {
     toolName;
     constructor(toolName, message, options) {
@@ -28,6 +46,15 @@ export class RunAbortedError extends ActoviqSdkError {
         super(message, 'RUN_ABORTED', options);
     }
 }
+export class DeadlineExceededError extends ActoviqSdkError {
+    scope;
+    timeoutMs;
+    constructor(scope, timeoutMs, options) {
+        super(`${scope} exceeded its ${timeoutMs}ms deadline.`, 'DEADLINE_EXCEEDED', options);
+        this.scope = scope;
+        this.timeoutMs = timeoutMs;
+    }
+}
 export class ActoviqProviderApiError extends ActoviqSdkError {
     status;
     errorType;

package/dist/src/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAC/B,IAAI,CAAS;IAEtB,YAAY,OAAe,EAAE,IAAI,GAAG,mBAAmB,EAAE,OAA6B;QACpF,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,eAAe;IACrD,YAAY,OAAe,EAAE,OAA6B;QACxD,KAAK,CAAC,OAAO,EAAE,qBAAqB,EAAE,OAAO,CAAC,CAAC;IACjD,CAAC;CACF;AAED,MAAM,OAAO,oBAAqB,SAAQ,eAAe;IACvD,YAAY,SAAiB;QAC3B,KAAK,CAAC,YAAY,SAAS,kBAAkB,EAAE,mBAAmB,CAAC,CAAC;IACtE,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,eAAe;IAC5C,QAAQ,CAAS;IAE1B,YAAY,QAAgB,EAAE,OAAe,EAAE,OAA6B;QAC1E,KAAK,CAAC,OAAO,EAAE,sBAAsB,EAAE,OAAO,CAAC,CAAC;QAChD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,eAAe;IAClD,YAAY,OAAO,GAAG,sBAAsB,EAAE,OAA6B;QACzE,KAAK,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;CACF;AAED,MAAM,OAAO,uBAAwB,SAAQ,eAAe;IACjD,MAAM,CAAS;IACf,SAAS,CAAU;IAE5B,YACE,OAAe,EACf,OAIC;QAED,KAAK,CAAC,OAAO,EAAE,4BAA4B,EAAE,OAAO,CAAC,CAAC;QACtD,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IACrC,CAAC;CACF;AAED,MAAM,OAAO,yBAA0B,SAAQ,eAAe;IACnD,MAAM,CAAU;IAChB,QAAQ,CAAiB;IAElC,YACE,OAAe,EACf,OAAwE;QAExE,KAAK,CAAC,OAAO,EAAE,8BAA8B,EAAE,OAAO,CAAC,CAAC;QACxD,IAAI,CAAC,MAAM,GAAG,OAAO,EAAE,MAAM,CAAC;QAC9B,IAAI,CAAC,QAAQ,GAAG,OAAO,EAAE,QAAQ,CAAC;IACpC,CAAC;CACF"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAC/B,IAAI,CAAS;IAEtB,YAAY,OAAe,EAAE,IAAI,GAAG,mBAAmB,EAAE,OAA6B;QACpF,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,eAAe;IACrD,YAAY,OAAe,EAAE,OAA6B;QACxD,KAAK,CAAC,OAAO,EAAE,qBAAqB,EAAE,OAAO,CAAC,CAAC;IACjD,CAAC;CACF;AAED,MAAM,OAAO,oBAAqB,SAAQ,eAAe;IACvD,YAAY,SAAiB;QAC3B,KAAK,CAAC,YAAY,SAAS,kBAAkB,EAAE,mBAAmB,CAAC,CAAC;IACtE,CAAC;CACF;AAED,MAAM,OAAO,oBAAqB,SAAQ,eAAe;IAC9C,SAAS,CAAS;IAClB,gBAAgB,CAAS;IACzB,cAAc,CAAS;IAEhC,YAAY,SAAiB,EAAE,gBAAwB,EAAE,cAAsB;QAC7E,KAAK,CACH,YAAY,SAAS,oDAAoD,gBAAgB,qBAAqB,cAAc,IAAI,EAChI,kBAAkB,CACnB,CAAC;QACF,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;QACzC,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;IACvC,CAAC;CACF;AAED,MAAM,OAAO,gBAAiB,SAAQ,eAAe;IAC1C,SAAS,CAAS;IAE3B,YAAY,SAAiB,EAAE,OAAe,EAAE,OAA6B;QAC3E,KAAK,CAAC,YAAY,SAAS,iBAAiB,OAAO,EAAE,EAAE,sBAAsB,EAAE,OAAO,CAAC,CAAC;QACxF,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,eAAe;IAC5C,QAAQ,CAAS;IAE1B,YAAY,QAAgB,EAAE,OAAe,EAAE,OAA6B;QAC1E,KAAK,CAAC,OAAO,EAAE,sBAAsB,EAAE,OAAO,CAAC,CAAC;QAChD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,eAAe;IAClD,YAAY,OAAO,GAAG,sBAAsB,EAAE,OAA6B;QACzE,KAAK,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;CACF;AAED,MAAM,OAAO,qBAAsB,SAAQ,eAAe;IAC/C,KAAK,CAAS;IACd,SAAS,CAAS;IAE3B,YAAY,KAAa,EAAE,SAAiB,EAAE,OAA6B;QACzE,KAAK,CAAC,GAAG,KAAK,iBAAiB,SAAS,cAAc,EAAE,mBAAmB,EAAE,OAAO,CAAC,CAAC;QACtF,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,OAAO,uBAAwB,SAAQ,eAAe;IACjD,MAAM,CAAS;IACf,SAAS,CAAU;IAE5B,YACE,OAAe,EACf,OAIC;QAED,KAAK,CAAC,OAAO,EAAE,4BAA4B,EAAE,OAAO,CAAC,CAAC;QACtD,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IACrC,CAAC;CACF;AAED,MAAM,OAAO,yBAA0B,SAAQ,eAAe;IACnD,MAAM,CAAU;IAChB,QAAQ,CAAiB;IAElC,YACE,OAAe,EACf,OAAwE;QAExE,KAAK,CAAC,OAAO,EAAE,8BAA8B,EAAE,OAAO,CAAC,CAAC;QACxD,IAAI,CAAC,MAAM,GAAG,OAAO,EAAE,MAAM,CAAC;QAC9B,IAAI,CAAC,QAAQ,GAAG,OAAO,EAAE,QAAQ,CAAC;IACpC,CAAC;CACF"}

package/dist/src/events/index.d.ts

@@ -0,0 +1,4 @@
+export * from './runEvents.js';
+export * from './processors.js';
+export * from './openTelemetry.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/events/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/events/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC"}

package/dist/src/events/index.js

@@ -0,0 +1,4 @@
+export * from './runEvents.js';
+export * from './processors.js';
+export * from './openTelemetry.js';
+//# sourceMappingURL=index.js.map

package/dist/src/events/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/events/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC"}

package/dist/src/events/openTelemetry.d.ts

@@ -0,0 +1,51 @@
+import type { EventSink, RunEvent } from './runEvents.js';
+export interface OpenTelemetrySpanEvent {
+    readonly name: string;
+    readonly time: string;
+    readonly attributes: Readonly<Record<string, unknown>>;
+}
+/** Dependency-free span DTO shaped for an OpenTelemetry exporter adapter. */
+export interface OpenTelemetryReadableSpan {
+    readonly name: string;
+    readonly traceId: string;
+    readonly spanId: string;
+    readonly parentSpanId?: string;
+    readonly startTime: string;
+    readonly endTime: string;
+    readonly status: {
+        readonly code: 'UNSET' | 'OK' | 'ERROR';
+        readonly message?: string;
+    };
+    readonly attributes: Readonly<Record<string, unknown>>;
+    readonly events: readonly OpenTelemetrySpanEvent[];
+}
+export interface OpenTelemetryExportResult {
+    readonly code: 0 | 1;
+    readonly error?: Error;
+}
+/** Matches the callback/export lifecycle of OpenTelemetry JS SpanExporter. */
+export interface OpenTelemetryCompatibleExporter {
+    export(spans: readonly OpenTelemetryReadableSpan[], resultCallback: (result: OpenTelemetryExportResult) => void): void;
+    forceFlush?(): Promise<void>;
+    shutdown?(): Promise<void>;
+}
+export interface OpenTelemetryRunEventSinkOptions {
+    readonly exporter: OpenTelemetryCompatibleExporter;
+    readonly maxBufferedEventsPerRun?: number;
+    readonly serviceName?: string;
+}
+/** Converts one run's versioned event stream into one exportable trace span. */
+export declare class OpenTelemetryRunEventSink implements EventSink {
+    readonly id = "opentelemetry";
+    private readonly pending;
+    private readonly seenEvents;
+    private readonly exporter;
+    private readonly maxBufferedEventsPerRun;
+    private readonly serviceName;
+    private closed;
+    constructor(options: OpenTelemetryRunEventSinkOptions);
+    write(event: RunEvent): Promise<void>;
+    close(): Promise<void>;
+    private exportSpan;
+}
+//# sourceMappingURL=openTelemetry.d.ts.map

package/dist/src/events/openTelemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openTelemetry.d.ts","sourceRoot":"","sources":["../../../src/events/openTelemetry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1D,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACxD;AAED,6EAA6E;AAC7E,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,GAAG,OAAO,CAAC;QAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxF,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACvD,QAAQ,CAAC,MAAM,EAAE,SAAS,sBAAsB,EAAE,CAAC;CACpD;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;CACxB;AAED,8EAA8E;AAC9E,MAAM,WAAW,+BAA+B;IAC9C,MAAM,CACJ,KAAK,EAAE,SAAS,yBAAyB,EAAE,EAC3C,cAAc,EAAE,CAAC,MAAM,EAAE,yBAAyB,KAAK,IAAI,GAC1D,IAAI,CAAC;IACR,UAAU,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,QAAQ,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAED,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,QAAQ,EAAE,+BAA+B,CAAC;IACnD,QAAQ,CAAC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IAC1C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AASD,gFAAgF;AAChF,qBAAa,yBAA0B,YAAW,SAAS;IACzD,QAAQ,CAAC,EAAE,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkC;IAC1D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;IAChD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkC;IAC3D,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAS;IACjD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,MAAM,CAAS;gBAEX,OAAO,EAAE,gCAAgC;IAU/C,KAAK,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BrC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAY5B,OAAO,CAAC,UAAU;CAWnB"}

package/dist/src/events/openTelemetry.js

@@ -0,0 +1,116 @@
+/** Converts one run's versioned event stream into one exportable trace span. */
+export class OpenTelemetryRunEventSink {
+    id = 'opentelemetry';
+    pending = new Map();
+    seenEvents = new Set();
+    exporter;
+    maxBufferedEventsPerRun;
+    serviceName;
+    closed = false;
+    constructor(options) {
+        if (!Number.isSafeInteger(options.maxBufferedEventsPerRun ?? 256)
+            || (options.maxBufferedEventsPerRun ?? 256) < 1) {
+            throw new RangeError('maxBufferedEventsPerRun must be a positive safe integer.');
+        }
+        this.exporter = options.exporter;
+        this.maxBufferedEventsPerRun = options.maxBufferedEventsPerRun ?? 256;
+        this.serviceName = options.serviceName ?? 'actoviq-agent-sdk';
+    }
+    async write(event) {
+        if (this.closed)
+            throw new Error('OpenTelemetryRunEventSink is closed.');
+        if (this.seenEvents.has(event.eventId))
+            return;
+        this.seenEvents.add(event.eventId);
+        let span = this.pending.get(event.runId);
+        if (!span) {
+            span = { first: event, last: event, events: [], droppedEvents: 0 };
+            this.pending.set(event.runId, span);
+        }
+        if (event.sequence <= span.last.sequence && event !== span.first) {
+            throw new Error(`Run ${event.runId} emitted non-monotonic trace event ${event.sequence}.`);
+        }
+        span.last = event;
+        span.events.push(toSpanEvent(event));
+        if (span.events.length > this.maxBufferedEventsPerRun) {
+            span.events.shift();
+            span.droppedEvents += 1;
+        }
+        if (isTerminalEvent(event.type)) {
+            this.pending.delete(event.runId);
+            await this.exportSpan(toReadableSpan(span, this.serviceName));
+        }
+    }
+    async close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        const incomplete = [...this.pending.values()];
+        this.pending.clear();
+        for (const span of incomplete) {
+            await this.exportSpan(toReadableSpan(span, this.serviceName, true));
+        }
+        await this.exporter.forceFlush?.();
+        await this.exporter.shutdown?.();
+    }
+    exportSpan(span) {
+        return new Promise((resolve, reject) => {
+            let settled = false;
+            this.exporter.export([span], result => {
+                if (settled)
+                    return;
+                settled = true;
+                if (result.code === 0)
+                    resolve();
+                else
+                    reject(result.error ?? new Error('OpenTelemetry exporter failed.'));
+            });
+        });
+    }
+}
+function toSpanEvent(event) {
+    return {
+        name: event.type,
+        time: event.timestamp,
+        attributes: {
+            'actoviq.event.id': event.eventId,
+            'actoviq.event.sequence': event.sequence,
+            'actoviq.event.schema_version': event.schemaVersion,
+            'actoviq.event.data': event.data,
+        },
+    };
+}
+function toReadableSpan(span, serviceName, incomplete = false) {
+    const terminal = span.last.type;
+    const isError = terminal === 'run.failed' || terminal === 'run.error';
+    const isSuccess = terminal === 'run.completed';
+    return {
+        name: `agent.run ${span.first.runId}`,
+        traceId: span.first.traceId,
+        spanId: span.first.spanId,
+        parentSpanId: span.first.parentSpanId,
+        startTime: span.first.timestamp,
+        endTime: span.last.timestamp,
+        status: isError
+            ? { code: 'ERROR', message: terminal }
+            : isSuccess
+                ? { code: 'OK' }
+                : { code: 'UNSET', ...(incomplete ? { message: 'incomplete' } : {}) },
+        attributes: {
+            'service.name': serviceName,
+            'actoviq.run.id': span.first.runId,
+            ...(span.first.parentRunId ? { 'actoviq.run.parent_id': span.first.parentRunId } : {}),
+            'actoviq.events.dropped': span.droppedEvents,
+            'actoviq.run.incomplete': incomplete,
+        },
+        events: Object.freeze([...span.events]),
+    };
+}
+function isTerminalEvent(type) {
+    return type === 'run.completed'
+        || type === 'run.failed'
+        || type === 'run.error'
+        || type === 'run.cancelled'
+        || type === 'run.interrupted';
+}
+//# sourceMappingURL=openTelemetry.js.map

package/dist/src/events/openTelemetry.js.map

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

package/dist/src/events/processors.d.ts

@@ -0,0 +1,14 @@
+import type { EventProcessor, RunEvent } from './runEvents.js';
+export interface SensitiveDataRedactionOptions {
+    readonly replacement?: string;
+    readonly additionalKeys?: readonly (string | RegExp)[];
+}
+/** Redacts secret-bearing object fields before events cross a sink boundary. */
+export declare class SensitiveDataRedactionProcessor implements EventProcessor {
+    readonly id = "sensitive-data-redaction";
+    private readonly replacement;
+    private readonly keys;
+    constructor(options?: SensitiveDataRedactionOptions);
+    process(event: RunEvent): RunEvent;
+}
+//# sourceMappingURL=processors.d.ts.map

package/dist/src/events/processors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"processors.d.ts","sourceRoot":"","sources":["../../../src/events/processors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/D,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;CACxD;AAaD,gFAAgF;AAChF,qBAAa,+BAAgC,YAAW,cAAc;IACpE,QAAQ,CAAC,EAAE,8BAA8B;IACzC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA+B;gBAExC,OAAO,GAAE,6BAAkC;IAKvD,OAAO,CAAC,KAAK,EAAE,QAAQ,GAAG,QAAQ;CAGnC"}

package/dist/src/events/processors.js

@@ -0,0 +1,60 @@
+const DEFAULT_SENSITIVE_KEYS = Object.freeze([
+    /^authorization$/i,
+    /^proxy-authorization$/i,
+    /^(?:api|access|refresh|auth)[_-]?token$/i,
+    /^(?:api|private|secret)[_-]?key$/i,
+    /^(?:client|shared)?[_-]?secret$/i,
+    /^password$/i,
+    /^cookie$/i,
+    /^set-cookie$/i,
+]);
+/** Redacts secret-bearing object fields before events cross a sink boundary. */
+export class SensitiveDataRedactionProcessor {
+    id = 'sensitive-data-redaction';
+    replacement;
+    keys;
+    constructor(options = {}) {
+        this.replacement = options.replacement ?? '[REDACTED]';
+        this.keys = [...DEFAULT_SENSITIVE_KEYS, ...(options.additionalKeys ?? [])];
+    }
+    process(event) {
+        return { ...event, data: redactValue(event.data, this.keys, this.replacement, new WeakMap()) };
+    }
+}
+function redactValue(value, keys, replacement, seen) {
+    if (Array.isArray(value)) {
+        const previous = seen.get(value);
+        if (previous)
+            return previous;
+        const clone = [];
+        seen.set(value, clone);
+        for (const item of value)
+            clone.push(redactValue(item, keys, replacement, seen));
+        return clone;
+    }
+    if (!isPlainObject(value))
+        return value;
+    const previous = seen.get(value);
+    if (previous)
+        return previous;
+    const clone = {};
+    seen.set(value, clone);
+    for (const [key, item] of Object.entries(value)) {
+        clone[key] = isSensitiveKey(key, keys)
+            ? replacement
+            : redactValue(item, keys, replacement, seen);
+    }
+    return clone;
+}
+function isSensitiveKey(key, patterns) {
+    return patterns.some(pattern => typeof pattern === 'string'
+        ? pattern.toLowerCase() === key.toLowerCase()
+        : pattern.test(key));
+}
+function isPlainObject(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+}
+//# sourceMappingURL=processors.js.map

package/dist/src/events/processors.js.map

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

package/dist/src/events/runEvents.d.ts

@@ -0,0 +1,66 @@
+export interface TraceContext {
+    traceId: string;
+    spanId: string;
+    parentSpanId?: string;
+}
+export interface RunEvent<TData = unknown> extends TraceContext {
+    schemaVersion: 1;
+    eventId: string;
+    sequence: number;
+    runId: string;
+    parentRunId?: string;
+    type: string;
+    timestamp: string;
+    data: TData;
+}
+export interface RunEventContext extends TraceContext {
+    runId: string;
+    parentRunId?: string;
+}
+export interface EventSink {
+    readonly id: string;
+    write(event: RunEvent): Promise<void> | void;
+    close?(): Promise<void> | void;
+}
+export interface EventProcessor {
+    readonly id: string;
+    process(event: RunEvent): Promise<RunEvent | null> | RunEvent | null;
+}
+export interface EventDispatcherOptions {
+    processors?: readonly EventProcessor[];
+    sinks?: readonly EventSink[];
+    failureMode?: 'throw' | 'isolate';
+    onSinkError?: (sink: EventSink, error: unknown, event: RunEvent) => void;
+    onProcessorError?: (processor: EventProcessor, error: unknown, event: RunEvent) => void;
+}
+/** Creates versioned, monotonically sequenced events for exactly one run. */
+export declare class RunEventSequencer {
+    readonly context: RunEventContext;
+    private sequence;
+    constructor(context: RunEventContext, lastCommittedSequence?: number);
+    next<TData>(type: string, data: TData, timestamp?: string): RunEvent<TData>;
+    get lastSequence(): number;
+}
+/** Awaited processor/sink pipeline: sink speed applies backpressure to the run. */
+export declare class EventDispatcher {
+    private readonly processors;
+    private readonly sinks;
+    private readonly failureMode;
+    private readonly onSinkError?;
+    private readonly onProcessorError?;
+    private closed;
+    constructor(options?: EventDispatcherOptions);
+    dispatch(event: RunEvent): Promise<RunEvent | null>;
+    close(): Promise<void>;
+}
+/** Test/local sink with event-id deduplication and per-run sequence validation. */
+export declare class InMemoryEventSink implements EventSink {
+    readonly id = "memory";
+    private readonly eventIds;
+    private readonly lastSequenceByRun;
+    readonly events: RunEvent[];
+    write(event: RunEvent): void;
+}
+export declare function createRootTraceContext(runId: string): RunEventContext;
+export declare function createChildTraceContext(runId: string, parentRunId: string, parent: TraceContext): RunEventContext;
+//# sourceMappingURL=runEvents.d.ts.map

package/dist/src/events/runEvents.d.ts.map

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