@atcn/sdk 1.4.1 → 1.5.1

package/README.md

@@ -1,25 +1,41 @@
 # @atcn/sdk
 
-The ATCN TypeScript SDK. It includes:
+The TypeScript SDK for [ATCN](https://github.com/fadnisnikhil/atcn), a cost record for AI agent jobs that anyone can verify. Use it to:
 
-- **Signing.** `EventSigner` signs obligation events. `buildTerms`, `termsData`, `acceptanceData` and `buildEvidenceEnvelope` build their contents.
-- **API clients.** `AtcnClient` is for the clearing network. `SubledgerClient` and its `CaptureQueue` record tasks, delegations and charges. `ReceiptLinkClient` is for providers.
-- **Offline verifiers.** `verifySubledgerDocument` checks task closures and receipts, and `verifyClosurePackage` checks obligation closure packages.
-- **Webhooks and response statements.** `verifyWebhook` and `signWebhook` handle webhook signatures. `buildResponseStatement`, `signStatement` and `verifyStatementSignature` handle provider response statements.
+- **check signed documents offline:** task closures, provider receipts and closure packages, with no network calls;
+- **record jobs** (tasks, delegations, charges, estimates, holds) through a hosted ATCN API;
+- **sign** obligation events, provider response statements and webhooks.
+
+The same package is also published as [`atcn-sdk`](https://www.npmjs.com/package/atcn-sdk).
 
 ```bash
 npm install @atcn/sdk
 ```
 
+## Verify a closure someone sent you
+
 ```ts
+import { readFileSync } from "node:fs";
 import { verifySubledgerDocument } from "@atcn/sdk";
 
+const closure = JSON.parse(readFileSync("task-closure.json", "utf8"));
+const trustedKeys = JSON.parse(readFileSync("keys.json", "utf8")).items;
+
 const report = verifySubledgerDocument(closure, { trustedKeys });
 console.log(report.valid ? "VALID" : report.checks.filter((c) => !c.ok));
 ```
 
-The API clients need an ATCN API at `baseUrl`. The hosted API is not open for signup yet. Everything else works offline.
+`report.checks` lists every check by name with its details, so a failure says exactly what doesn't add up. To try it without writing a closure first, run `npx @atcn/local-runner demo` and point this at the files it prints.
+
+## What's inside
+
+- **Offline verifiers.** `verifySubledgerDocument` checks task closures and receipts, and `verifyClosurePackage` checks obligation closure packages. Clearing verdicts are checked by `verifyClearingVerdict` in [`@atcn/core`](https://www.npmjs.com/package/@atcn/core).
+- **Signed estimates and outcomes.** `buildExpectationStatement` and `signExpectation` let a provider sign its estimate or hold; `buildOutcomeStatement` and `signOutcomeStatement` let it sign how a task ended.
+- **API clients.** `SubledgerClient` and its `CaptureQueue` record tasks, delegations and charges. `AtcnClient` is for obligations, and `ReceiptLinkClient` is for providers. They need an ATCN API at `baseUrl`; the hosted API is not open for signup yet.
+- **Signing.** `EventSigner` signs obligation events. `buildTerms`, `termsData`, `acceptanceData` and `buildEvidenceEnvelope` build their contents.
+- **Webhooks and response statements.** `verifyWebhook` and `signWebhook` handle webhook signatures. `buildResponseStatement`, `signStatement` and `verifyStatementSignature` handle provider response statements.
+- **Agent traces.** `traceFromOtelSpans` turns an OpenTelemetry GenAI span export into an ATCN trace.
 
-`npx atcn init` records whether this machine shares anonymous usage metrics. Reporting is off by default and needs `ATCN_USAGE_URL`; see [docs/USAGE_DATA.md](../../docs/USAGE_DATA.md).
+`npx atcn init` records whether this machine shares anonymous usage metrics. Reporting is off by default and needs `ATCN_USAGE_URL`; see [usage data](https://github.com/fadnisnikhil/atcn/blob/main/docs/USAGE_DATA.md).
 
-Part of [ATCN](../../README.md). Apache-2.0.
+Source, docs and examples: [github.com/fadnisnikhil/atcn](https://github.com/fadnisnikhil/atcn). Apache-2.0.

package/dist/builders.d.ts

@@ -1,4 +1,4 @@
-import { type Deliverable, type EvidenceEnvelope, type ObligationTerms, type PolicyTemplate, type SkillRef } from "@atcn/schema";
+import { type Deliverable, type EvidenceEnvelope, type ObligationTerms, type PolicyTemplate, type Pricing, type RefundTerms, type SkillRef, type WitnessPolicy } from "@atcn/schema";
 export interface TermsInput {
     parentObligationId?: string | null;
     principalId: string;
@@ -24,6 +24,12 @@ export interface TermsInput {
     verifierAgentIds?: string[];
     /** The skill the counterparty performs (for A2A, the AgentSkill id). Produces schema_version 1.1 terms. */
     skill?: SkillRef;
+    /** Usage prices for the usage_cost verifier. Produces schema_version 1.2 terms. */
+    pricing?: Pricing;
+    /** What happens on failure or timeout, and the post-settlement refund budget. Produces schema_version 1.2 terms. */
+    refundTerms?: RefundTerms;
+    /** Independent witnesses the witness_quorum verifier requires. Produces schema_version 1.2 terms. */
+    witnessPolicy?: WitnessPolicy;
 }
 /** Builds version-1 obligation terms with sensible defaults (7-day deadline, 1-day offer window). */
 export declare function buildTerms(input: TermsInput): ObligationTerms;

package/dist/builders.js

@@ -4,7 +4,7 @@ const DAY_MS = 24 * 3600 * 1000;
 export function buildTerms(input) {
     const now = Date.now();
     return {
-        schema_version: input.skill ? "1.1" : "1.0",
+        schema_version: input.pricing || input.refundTerms || input.witnessPolicy ? "1.2" : input.skill ? "1.1" : "1.0",
         obligation_id: newId("obligation"),
         terms_version: 1,
         parent_obligation_id: input.parentObligationId ?? null,
@@ -28,6 +28,9 @@ export function buildTerms(input) {
         verifier_agent_ids: input.verifierAgentIds ?? [],
         issued_at: new Date(now).toISOString(),
         ...(input.skill ? { skill: input.skill } : {}),
+        ...(input.pricing ? { pricing: input.pricing } : {}),
+        ...(input.refundTerms ? { refund_terms: input.refundTerms } : {}),
+        ...(input.witnessPolicy ? { witness_policy: input.witnessPolicy } : {}),
     };
 }
 /** Data for obligation.created / obligation.offered / obligation.amended events. */

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-import type { ClearingDecision, EventPayload, PublicKeyRecord, Signed } from "@atcn/schema";
+import type { ClearingDecision, ClearingVerdict, ClosurePackage, EventPayload, PublicKeyRecord, Signed } from "@atcn/schema";
 export declare class AtcnApiError extends Error {
     readonly status: number;
     readonly code: string;
@@ -9,7 +9,7 @@ export declare class AtcnApiError extends Error {
     constructor(status: number, code: string, message: string, reason: string | undefined, retryable: boolean, correlationId: string | undefined, details: unknown);
 }
 /** Must equal this package's version in package.json (checked by a test). */
-export declare const SDK_VERSION = "1.4.1";
+export declare const SDK_VERSION = "1.5.1";
 /** Names the SDK and its version on every request, so the API operator can count SDK versions in use. Nothing else is sent. */
 export declare const SDK_HEADER = "atcn-sdk";
 export interface ClientOptions {
@@ -105,6 +105,14 @@ export declare class AtcnClient {
     listDecisions(obligationId: string): Promise<{
         items: ClearingDecision[];
     }>;
+    /** The decision in effect as a signed, record-only verdict, with the closure package it was read from (verifyClearingVerdict). */
+    clearingVerdict(obligationId: string, escrow?: {
+        rail: string;
+        escrow_ref: string;
+    }): Promise<{
+        verdict: ClearingVerdict;
+        closure_package: ClosurePackage;
+    }>;
     finalize(decisionId: string, idempotencyKey?: string): Promise<Json>;
     openDispute(decisionId: string, signed: SignedEvent): Promise<Json>;
     reviewDispute(disputeId: string, signed: SignedEvent): Promise<Json>;
@@ -131,7 +139,7 @@ export declare class AtcnClient {
     }>;
     exportClosurePackage(obligationId: string): Promise<{
         payload: {
-            package_version: "1.0";
+            package_version: "1.0" | "1.1";
             generated_at: string;
             root_obligation_id: string;
             requested_obligation_id: string;
@@ -140,7 +148,7 @@ export declare class AtcnClient {
                 parent_obligation_id: string | null;
                 redacted: boolean;
                 effective_terms: {
-                    schema_version: "1.0" | "1.1";
+                    schema_version: "1.0" | "1.1" | "1.2";
                     obligation_id: string;
                     terms_version: number;
                     parent_obligation_id: string | null;
@@ -186,6 +194,33 @@ export declare class AtcnClient {
                         skill_id: string;
                         agent_card_url?: string | undefined;
                     } | undefined;
+                    pricing?: {
+                        rates: {
+                            meter: "input_tokens" | "output_tokens" | "cache_read_input_tokens" | "model_call" | "tool_call" | "a2a_call";
+                            price_numerator: number;
+                            price_denominator: number;
+                            model?: {
+                                provider: string;
+                                name: string;
+                            } | undefined;
+                            tool_name?: string | undefined;
+                        }[];
+                        tolerance_bps: number;
+                        fixed_minor?: number | undefined;
+                    } | undefined;
+                    refund_terms?: {
+                        on_failure: "dispute" | "refund";
+                        on_timeout: "dispute" | "refund";
+                        after_settlement: {
+                            cap_minor: number;
+                            window_seconds: number;
+                        };
+                    } | undefined;
+                    witness_policy?: {
+                        min_independent_witnesses: number;
+                        independence: "distinct_verified_domain";
+                        witness_agent_ids?: string[] | undefined;
+                    } | undefined;
                 } | null;
                 effective_terms_digest: string | null;
                 state: string;
@@ -228,7 +263,7 @@ export declare class AtcnClient {
                 task_type: string;
                 description: string;
                 evidence_admissibility: {
-                    allowed_producers: ("issuer" | "counterparty" | "verifier")[];
+                    allowed_producers: ("issuer" | "counterparty" | "verifier" | "witness")[];
                     require_digest_match: boolean;
                 };
                 required_evidence: string[];
@@ -313,7 +348,7 @@ export declare class AtcnClient {
                     amount_minor: number;
                     outcome: "insufficient_evidence" | "disputed" | "accepted" | "rejected";
                     reasons: {
-                        code: "invalid_evidence" | "missing_evidence" | "failed_criteria" | "verifier_unavailable" | "probabilistic_review_required" | "partial_not_permitted" | "passed" | "dispute_amended" | "dispute_upheld";
+                        code: "invalid_evidence" | "missing_evidence" | "failed_criteria" | "verifier_unavailable" | "probabilistic_review_required" | "partial_not_permitted" | "passed" | "dispute_amended" | "dispute_upheld" | "failure_terms_dispute" | "conflicting_attestations" | "witness_quorum_not_met";
                         check_id?: string | undefined;
                         evidence_type?: string | undefined;
                         detail?: string | undefined;
@@ -366,7 +401,7 @@ export declare class AtcnClient {
                 adapter: "manual" | "sandbox" | "stripe";
                 idempotency_key: string;
                 expires_at: string;
-                status: "unknown" | "failed" | "refunded" | "settled" | "returned" | "submitted" | "processing";
+                status: "unknown" | "pending_finality" | "failed" | "refunded" | "settled" | "returned" | "submitted" | "processing";
                 created_at: string;
             }[];
             settlement_events: {
@@ -376,12 +411,22 @@ export declare class AtcnClient {
                 provider_event_id: string;
                 provider_reference: string;
                 provider_status: string;
-                normalized_status: "unknown" | "failed" | "refunded" | "settled" | "returned" | "submitted" | "processing";
+                normalized_status: "unknown" | "pending_finality" | "failed" | "refunded" | "settled" | "returned" | "submitted" | "processing";
                 currency: string;
                 amount_minor: number;
                 raw_json: string;
                 reported_at: string;
             }[];
+            attestations?: {
+                evidence_id: string;
+                content: string;
+            }[] | undefined;
+            attestation_conflicts?: {
+                kind: "disputed" | "equivocation" | "disagreement" | "execution_mismatch";
+                subject: string;
+                attestation_digests: string[];
+                signers: string[];
+            }[] | undefined;
         };
         signature: {
             key_id: string;

package/dist/client.js

@@ -16,7 +16,7 @@ export class AtcnApiError extends Error {
     }
 }
 /** Must equal this package's version in package.json (checked by a test). */
-export const SDK_VERSION = "1.4.1";
+export const SDK_VERSION = "1.5.1";
 /** Names the SDK and its version on every request, so the API operator can count SDK versions in use. Nothing else is sent. */
 export const SDK_HEADER = "atcn-sdk";
 /** Thin HTTP client for the ATCN API. Every mutating call carries an Idempotency-Key. */
@@ -126,6 +126,12 @@ export class AtcnClient {
     listDecisions(obligationId) {
         return this.request("GET", `/v1/obligations/${obligationId}/decisions`);
     }
+    /** The decision in effect as a signed, record-only verdict, with the closure package it was read from (verifyClearingVerdict). */
+    clearingVerdict(obligationId, escrow) {
+        return this.request("GET", `/v1/obligations/${obligationId}/verdict`, undefined, {
+            query: { rail: escrow?.rail, escrow_ref: escrow?.escrow_ref },
+        });
+    }
     finalize(decisionId, idempotencyKey) {
         return this.request("POST", `/v1/decisions/${decisionId}/finalize`, undefined, { idempotencyKey });
     }

package/dist/index.d.ts

@@ -1,7 +1,11 @@
 export { EventSigner, type SignerIdentity } from "./signer.js";
 export { buildTerms, termsData, acceptanceData, buildEvidenceEnvelope, type TermsInput, type EnvelopeInput } from "./builders.js";
 export { AtcnClient, AtcnApiError, SDK_HEADER, SDK_VERSION, type ClientOptions, type RequestOptions } from "./client.js";
-export { verifyClosurePackage, REFERENCE_POLICIES, CODE_CHANGE_POLICY_V1, CODE_CHANGE_POLICY_V1_1, CODE_CHANGE_SUBTASK_POLICY_V1 } from "@atcn/core";
+export { verifyClosurePackage, REFERENCE_POLICIES, CODE_CHANGE_POLICY_V1, CODE_CHANGE_POLICY_V1_1, CODE_CHANGE_SUBTASK_POLICY_V1, AGENT_USAGE_POLICY_V1 } from "@atcn/core";
 export { SubledgerClient, ReceiptLinkClient, CaptureQueue, ext, stableKey, type CaptureOperation, type CaptureQueueOptions, type FlushResult } from "./subledger.js";
 export { verifySubledgerDocument, buildResponseStatement, signStatement, verifyStatementSignature } from "@atcn/subledger";
+export { buildExpectationStatement, signExpectation, verifyExpectationSignature, type ExpectationStatement, type ExpectationStatementInput } from "@atcn/subledger";
+export { buildOutcomeStatement, signOutcomeStatement, verifyOutcomeSignature, type EvidenceRef, type OutcomeStatement, type SignedClaimType } from "@atcn/subledger";
 export { verifyWebhook, signWebhook, WEBHOOK_SIGNATURE_HEADER, generateKeyPair, digestOf, sha256Digest, canonicalize, executionBinding } from "@atcn/schema";
+export { traceDigest, summarizeTrace, traceProblems, checkTrace, expectedCostFromUsage, allowedDifference, usageCostDetails, type AgentTrace, type UsageSummary, type Pricing, type ExecutionDescriptor } from "@atcn/schema";
+export { traceFromOtelSpans, OTEL_GENAI_CONVENTIONS, A2A_TASK_ID_ATTRIBUTE, type OtlpTraceExport, type OtelImportResult, type SkippedSpan } from "./otel.js";

package/dist/index.js

@@ -1,7 +1,11 @@
 export { EventSigner } from "./signer.js";
 export { buildTerms, termsData, acceptanceData, buildEvidenceEnvelope } from "./builders.js";
 export { AtcnClient, AtcnApiError, SDK_HEADER, SDK_VERSION } from "./client.js";
-export { verifyClosurePackage, REFERENCE_POLICIES, CODE_CHANGE_POLICY_V1, CODE_CHANGE_POLICY_V1_1, CODE_CHANGE_SUBTASK_POLICY_V1 } from "@atcn/core";
+export { verifyClosurePackage, REFERENCE_POLICIES, CODE_CHANGE_POLICY_V1, CODE_CHANGE_POLICY_V1_1, CODE_CHANGE_SUBTASK_POLICY_V1, AGENT_USAGE_POLICY_V1 } from "@atcn/core";
 export { SubledgerClient, ReceiptLinkClient, CaptureQueue, ext, stableKey } from "./subledger.js";
 export { verifySubledgerDocument, buildResponseStatement, signStatement, verifyStatementSignature } from "@atcn/subledger";
+export { buildExpectationStatement, signExpectation, verifyExpectationSignature } from "@atcn/subledger";
+export { buildOutcomeStatement, signOutcomeStatement, verifyOutcomeSignature } from "@atcn/subledger";
 export { verifyWebhook, signWebhook, WEBHOOK_SIGNATURE_HEADER, generateKeyPair, digestOf, sha256Digest, canonicalize, executionBinding } from "@atcn/schema";
+export { traceDigest, summarizeTrace, traceProblems, checkTrace, expectedCostFromUsage, allowedDifference, usageCostDetails } from "@atcn/schema";
+export { traceFromOtelSpans, OTEL_GENAI_CONVENTIONS, A2A_TASK_ID_ATTRIBUTE } from "./otel.js";

package/dist/otel.d.ts

@@ -0,0 +1,48 @@
+import { type AgentTrace, type ExecutionBinding } from "@atcn/schema";
+/**
+ * The OpenTelemetry GenAI conventions this mapping was written against. They are at "Development" status, so names may
+ * change; every attribute name used below is in this file only.
+ */
+export declare const OTEL_GENAI_CONVENTIONS = "OpenTelemetry semantic conventions 1.41.0, GenAI spans";
+/** Not an OpenTelemetry attribute: set it on invoke_agent spans that call another agent over A2A, with the A2A task id. */
+export declare const A2A_TASK_ID_ATTRIBUTE = "atcn.a2a.task_id";
+interface OtlpAnyValue {
+    stringValue?: string;
+    intValue?: string | number;
+    doubleValue?: number;
+    boolValue?: boolean;
+}
+interface OtlpSpan {
+    spanId?: string;
+    name?: string;
+    startTimeUnixNano?: string | number;
+    endTimeUnixNano?: string | number;
+    attributes?: {
+        key: string;
+        value?: OtlpAnyValue;
+    }[];
+}
+/** An OTLP JSON trace export: resourceSpans[].scopeSpans[].spans[]. */
+export interface OtlpTraceExport {
+    resourceSpans?: {
+        scopeSpans?: {
+            spans?: OtlpSpan[];
+        }[];
+    }[];
+}
+export interface SkippedSpan {
+    span_id: string;
+    name: string;
+    reason: string;
+}
+export interface OtelImportResult {
+    trace: AgentTrace;
+    /** Spans that did not become steps, with the reason, so nothing is dropped silently. */
+    skipped: SkippedSpan[];
+}
+/**
+ * Builds an AgentTrace for one run from an OTLP JSON export of GenAI spans. Steps are ordered by start time, then span
+ * id. Spans that are not model calls, tool calls or A2A calls are returned in `skipped` with the reason.
+ */
+export declare function traceFromOtelSpans(otlp: OtlpTraceExport, execution: ExecutionBinding): OtelImportResult;
+export {};

package/dist/otel.js

@@ -0,0 +1,116 @@
+import { AgentTraceSchema, TRACE_VERSION } from "@atcn/schema";
+/**
+ * The OpenTelemetry GenAI conventions this mapping was written against. They are at "Development" status, so names may
+ * change; every attribute name used below is in this file only.
+ */
+export const OTEL_GENAI_CONVENTIONS = "OpenTelemetry semantic conventions 1.41.0, GenAI spans";
+const MODEL_OPERATIONS = ["chat", "generate_content", "text_completion", "embeddings"];
+/** Not an OpenTelemetry attribute: set it on invoke_agent spans that call another agent over A2A, with the A2A task id. */
+export const A2A_TASK_ID_ATTRIBUTE = "atcn.a2a.task_id";
+function attributes(span) {
+    const map = new Map();
+    for (const a of span.attributes ?? []) {
+        const v = a.value ?? {};
+        if (v.stringValue !== undefined)
+            map.set(a.key, v.stringValue);
+        else if (v.intValue !== undefined)
+            map.set(a.key, Number(v.intValue));
+        else if (v.doubleValue !== undefined)
+            map.set(a.key, v.doubleValue);
+        else if (v.boolValue !== undefined)
+            map.set(a.key, v.boolValue);
+    }
+    return map;
+}
+function text(attrs, key) {
+    const value = attrs.get(key);
+    return typeof value === "string" && value.length > 0 ? value : undefined;
+}
+function count(attrs, key) {
+    const value = attrs.get(key);
+    return typeof value === "number" && Number.isSafeInteger(value) && value >= 0 ? value : undefined;
+}
+function isoFromNanos(nanos) {
+    if (nanos === undefined)
+        return undefined;
+    return new Date(Number(BigInt(nanos) / 1000000n)).toISOString();
+}
+function nanosOf(span) {
+    return span.startTimeUnixNano === undefined ? 0n : BigInt(span.startTimeUnixNano);
+}
+function stepFromSpan(span) {
+    const attrs = attributes(span);
+    const operation = text(attrs, "gen_ai.operation.name");
+    if (operation === undefined)
+        return "no gen_ai.operation.name";
+    const started_at = isoFromNanos(span.startTimeUnixNano);
+    const ended_at = isoFromNanos(span.endTimeUnixNano);
+    if (started_at === undefined || ended_at === undefined)
+        return "missing start or end time";
+    if (MODEL_OPERATIONS.includes(operation)) {
+        const provider = text(attrs, "gen_ai.provider.name");
+        const name = text(attrs, "gen_ai.response.model") ?? text(attrs, "gen_ai.request.model");
+        if (provider === undefined)
+            return "model call without gen_ai.provider.name";
+        if (name === undefined)
+            return "model call without gen_ai.response.model or gen_ai.request.model";
+        const input = count(attrs, "gen_ai.usage.input_tokens");
+        const output = count(attrs, "gen_ai.usage.output_tokens");
+        const cached = count(attrs, "gen_ai.usage.cache_read.input_tokens");
+        const upstream = text(attrs, "gen_ai.response.id");
+        return {
+            kind: "model_call",
+            started_at,
+            ended_at,
+            model: { provider, name },
+            ...(input !== undefined || output !== undefined
+                ? { usage: { input_tokens: input ?? 0, output_tokens: output ?? 0, ...(cached !== undefined ? { cache_read_input_tokens: cached } : {}) } }
+                : {}),
+            ...(upstream !== undefined ? { upstream_ref: upstream } : {}),
+        };
+    }
+    if (operation === "execute_tool") {
+        const name = text(attrs, "gen_ai.tool.name");
+        if (name === undefined)
+            return "tool call without gen_ai.tool.name";
+        const upstream = text(attrs, "gen_ai.tool.call.id");
+        return { kind: "tool_call", started_at, ended_at, tool: { name }, ...(upstream !== undefined ? { upstream_ref: upstream } : {}) };
+    }
+    if (operation === "invoke_agent") {
+        const taskId = text(attrs, A2A_TASK_ID_ATTRIBUTE);
+        if (taskId === undefined)
+            return `invoke_agent without ${A2A_TASK_ID_ATTRIBUTE}`;
+        const agentId = text(attrs, "gen_ai.agent.id");
+        return { kind: "a2a_call", started_at, ended_at, remote: { ...(agentId !== undefined ? { agent_id: agentId } : {}), task_id: taskId } };
+    }
+    return `operation ${operation} is not mapped`;
+}
+/**
+ * Builds an AgentTrace for one run from an OTLP JSON export of GenAI spans. Steps are ordered by start time, then span
+ * id. Spans that are not model calls, tool calls or A2A calls are returned in `skipped` with the reason.
+ */
+export function traceFromOtelSpans(otlp, execution) {
+    const spans = (otlp.resourceSpans ?? []).flatMap((r) => (r.scopeSpans ?? []).flatMap((s) => s.spans ?? []));
+    const ordered = [...spans].sort((a, b) => {
+        const at = nanosOf(a);
+        const bt = nanosOf(b);
+        if (at !== bt)
+            return at < bt ? -1 : 1;
+        const aid = a.spanId ?? "";
+        const bid = b.spanId ?? "";
+        return aid < bid ? -1 : aid > bid ? 1 : 0;
+    });
+    const steps = [];
+    const skipped = [];
+    for (const span of ordered) {
+        const step = stepFromSpan(span);
+        if (typeof step === "string")
+            skipped.push({ span_id: span.spanId ?? "", name: span.name ?? "", reason: step });
+        else
+            steps.push({ seq: steps.length, ...step });
+    }
+    if (steps.length === 0)
+        throw new Error("the export has no GenAI model, tool or A2A spans");
+    const trace = AgentTraceSchema.parse({ trace_version: TRACE_VERSION, execution, steps });
+    return { trace, skipped };
+}

package/dist/subledger.d.ts

@@ -1,11 +1,26 @@
 import type { z } from "zod";
-import { type AllocationInputSchema, type AllocationRuleInputSchema, type AttestableField, type Correction, type DelegationEventInputSchema, type DelegationInputSchema, type EvidenceRef, type FinancialEventInput, type OperatorKeyRecord, type ProviderInputSchema, type ResponseType, type SignedClosure, type SignedReceipt, type TaskInputSchema } from "@atcn/subledger";
+import { type AllocationInputSchema, type AllocationRuleInputSchema, type AttestableField, type CaptureGapInput, type Correction, type DelegationEventInputSchema, type DelegationInputSchema, type EvidenceRef, type ExpectationIssuer, type FinancialEventInput, type ImportField, type OperatorKeyRecord, type ProviderInputSchema, type RailAttestation, type ResponseType, type SignedClosure, type SignedReceipt, type TaskInputSchema } from "@atcn/subledger";
 import { type AttestationRef, type ExecutionBinding } from "@atcn/schema";
 import { AtcnClient, type ClientOptions } from "./client.js";
 type Json = Record<string, unknown>;
 type Opts = {
     idempotencyKey?: string;
 };
+/**
+ * How the hosted importer reads a CSV export: key_columns is a comma-separated list of columns that identify a row,
+ * map names the export's column for an import field, and minor_digits is the decimal places of amount_major (default 2).
+ * preset reads a LiteLLM, OpenRouter or Stripe export (CSV, JSON or JSONL) without a column map.
+ */
+type CsvImportOptions = {
+    preset?: "litellm" | "openrouter" | "stripe";
+    kind?: "charge" | "invoice" | "estimate" | "hold";
+    source?: string;
+    key_columns?: string;
+    currency?: string;
+    issued_by?: ExpectationIssuer;
+    map?: Partial<Record<ImportField, string>>;
+    minor_digits?: number;
+};
 /** Caller-supplied references address records before their server IDs are known: ext("job-42"). */
 export declare const ext: (externalRef: string) => string;
 /** Idempotency key derived from the caller's stable references; long references are hashed to fit 8-200 chars. */
@@ -43,10 +58,24 @@ export declare class SubledgerClient {
         match_id: string | null;
         exception_ids: string[];
     }>;
-    importCsv(csv: string, opts?: Opts): Promise<{
+    recordRailAttestation(input: {
+        attestation: RailAttestation;
+        source: string;
+        match?: Record<string, string>;
+        event_date?: string;
+    }, opts?: Opts): Promise<{
+        financial_event: Json;
+        deduplicated: boolean;
+        attributed?: boolean;
+        attribution: Json | null;
+        match_id: string | null;
+        exception_ids: string[];
+    }>;
+    importCsv(csv: string, opts?: Opts & CsvImportOptions): Promise<{
         imported: number;
         deduplicated: number;
         rejected: number;
+        skipped?: number;
         rows: Json[];
     }>;
     listFinancialEvents(query?: {
@@ -80,7 +109,7 @@ export declare class SubledgerClient {
     }, opts?: Opts): Promise<Json>;
     reportCaptureGap(taskId: string, gap: {
         delegation_id?: string | null;
-        kind: "capture_failed" | "queue_overflow" | "provider_undisclosed" | "manual_gap";
+        kind: CaptureGapInput["kind"];
         detail: string;
     }, opts?: Opts): Promise<Json>;
     closeTask(taskId: string, opts?: Opts): Promise<{
@@ -90,7 +119,7 @@ export declare class SubledgerClient {
     getClosure(taskId: string, version?: number): Promise<{
         payload: {
             document_type: "atcn.subledger.closure";
-            schema_version: "1.4" | "1.2" | "1.3";
+            schema_version: "1.2" | "1.3" | "1.4" | "1.5";
             closure_id: string;
             version: number;
             previous_closure_id: string | null;
@@ -112,6 +141,7 @@ export declare class SubledgerClient {
                 scope_ref: string | null;
                 retrospective: boolean;
                 created_at: string;
+                estimate_tolerance_bps?: number | undefined;
             };
             delegations: {
                 delegation_id: string;
@@ -145,6 +175,11 @@ export declare class SubledgerClient {
                             name: string;
                             version: string;
                         } | undefined;
+                        additional_models?: {
+                            provider: string;
+                            name: string;
+                            version: string;
+                        }[] | undefined;
                         config_digest?: string | undefined;
                     };
                     protocol?: {
@@ -158,13 +193,40 @@ export declare class SubledgerClient {
                         agent_card_url?: string | undefined;
                     } | undefined;
                 } | undefined;
+                pricing?: {
+                    rates: {
+                        meter: "input_tokens" | "output_tokens" | "cache_read_input_tokens" | "model_call" | "tool_call" | "a2a_call";
+                        price_numerator: number;
+                        price_denominator: number;
+                        model?: {
+                            provider: string;
+                            name: string;
+                        } | undefined;
+                        tool_name?: string | undefined;
+                    }[];
+                    tolerance_bps: number;
+                    fixed_minor?: number | undefined;
+                } | undefined;
+                refund_terms?: {
+                    on_failure: "dispute" | "refund";
+                    on_timeout: "dispute" | "refund";
+                    after_settlement: {
+                        cap_minor: number;
+                        window_seconds: number;
+                    };
+                } | undefined;
+                witness_policy?: {
+                    min_independent_witnesses: number;
+                    independence: "distinct_verified_domain";
+                    witness_provider_ids?: string[] | undefined;
+                } | undefined;
             }[];
             delivery_claims: {
                 event_id: string;
                 delegation_id: string;
                 type: "acceptance" | "completion" | "partial_completion" | "cancellation" | "provider_failure" | "terms_update" | "correction";
                 asserted_by: "provider" | "buyer" | "clearing_policy" | "dispute_reviewer" | "clearing_network";
-                assurance: ("expired" | "contested" | "issuer_signed" | "buyer_recorded" | "network_recorded" | "recipient_viewed" | "link_authenticated_response" | "provider_identity_bound" | "provider_key_signed" | "superseded" | "revoked")[];
+                assurance: ("expired" | "rail_attested" | "contested" | "issuer_signed" | "buyer_recorded" | "network_recorded" | "recipient_viewed" | "link_authenticated_response" | "provider_identity_bound" | "provider_key_signed" | "superseded" | "revoked" | "gateway_signed")[];
                 note: string | null;
                 evidence: {
                     uri: string;
@@ -176,11 +238,35 @@ export declare class SubledgerClient {
                 retrospective: boolean;
                 occurred_at: string;
                 recorded_at: string;
+                usage?: {
+                    trace_digest: string;
+                    summary: {
+                        models: {
+                            provider: string;
+                            name: string;
+                            calls: number;
+                            input_tokens: number;
+                            output_tokens: number;
+                            cache_read_input_tokens: number;
+                        }[];
+                        tools: {
+                            name: string;
+                            calls: number;
+                        }[];
+                        a2a_calls: number;
+                    };
+                } | undefined;
+                signer?: {
+                    provider_id: string;
+                    binding_id: string;
+                    key_id: string;
+                    value: string;
+                } | undefined;
             }[];
             financial_events: {
                 record: {
                     financial_event_id: string;
-                    type: "quote" | "invoice" | "charge" | "payment_reported" | "refund" | "reversal" | "fee" | "credit" | "adjustment" | "fx_rate";
+                    type: "refund" | "charge" | "invoice" | "estimate" | "hold" | "quote" | "payment_reported" | "reversal" | "fee" | "credit" | "adjustment" | "fx_rate";
                     source: string;
                     source_event_id: string;
                     provider_id: string | null;
@@ -190,7 +276,7 @@ export declare class SubledgerClient {
                     event_date: string;
                     imported_at: string;
                     provider_status: string | null;
-                    normalized_status: "unknown" | "quoted" | "issued" | "pending" | "reported_paid" | "failed" | "refunded" | "reversed" | "void";
+                    normalized_status: "unknown" | "quoted" | "issued" | "pending" | "reported_paid" | "pending_finality" | "failed" | "refunded" | "reversed" | "void";
                     evidence: {
                         uri: string;
                         digest: string | null;
@@ -210,6 +296,29 @@ export declare class SubledgerClient {
                         rate_denominator: number;
                     } | null;
                     reason: string | null;
+                    skill?: {
+                        namespace: string;
+                        skill_id: string;
+                        agent_card_url?: string | undefined;
+                    } | undefined;
+                    expectation?: {
+                        issued_by: "agent" | "gateway" | "operator";
+                        source_ref: string | null;
+                        basis: string | null;
+                        expires_at: string | null;
+                        supersedes: string | null;
+                        hold_status?: "expired" | "open" | "captured" | "released" | undefined;
+                        signer?: {
+                            provider_id: string;
+                            binding_id: string;
+                            key_id: string;
+                            value: string;
+                        } | undefined;
+                    } | undefined;
+                    rail_attestation?: {
+                        scheme: string;
+                        record: Record<string, unknown>;
+                    } | undefined;
                 };
                 event_digest: string;
                 attributed_to: string;
@@ -348,7 +457,7 @@ export declare class SubledgerClient {
                     receipt_revision: number;
                     issuer_operator_id: string;
                     response_type: "acknowledge_view" | "acknowledge_delivery" | "submit_evidence" | "propose_correction" | "signed_attestation";
-                    fields: ("delivery.status" | "delivery.evidence" | "scope.terms_digest" | "financial.amounts" | "financial.status")[];
+                    fields: ("delivery.status" | "delivery.evidence" | "scope.terms_digest" | "financial.amounts" | "financial.status" | "delivery.usage")[];
                     note: string | null;
                     evidence: {
                         uri: string;
@@ -356,7 +465,7 @@ export declare class SubledgerClient {
                         evidence_type: string;
                     }[];
                     corrections: {
-                        field: "delivery.status" | "delivery.evidence" | "scope.terms_digest" | "financial.amounts" | "financial.status";
+                        field: "delivery.status" | "delivery.evidence" | "scope.terms_digest" | "financial.amounts" | "financial.status" | "delivery.usage";
                         proposed_value: string;
                         reason: string;
                     }[];
@@ -371,6 +480,7 @@ export declare class SubledgerClient {
                         attestation_digest: string;
                         reason: string;
                     }[] | undefined;
+                    role?: "witness" | undefined;
                 };
                 statement_digest: string;
                 provider_signature: {
@@ -378,7 +488,7 @@ export declare class SubledgerClient {
                     binding_id: string;
                     value: string;
                 } | null;
-                assurance: ("expired" | "contested" | "issuer_signed" | "buyer_recorded" | "network_recorded" | "recipient_viewed" | "link_authenticated_response" | "provider_identity_bound" | "provider_key_signed" | "superseded" | "revoked")[];
+                assurance: ("expired" | "rail_attested" | "contested" | "issuer_signed" | "buyer_recorded" | "network_recorded" | "recipient_viewed" | "link_authenticated_response" | "provider_identity_bound" | "provider_key_signed" | "superseded" | "revoked" | "gateway_signed")[];
                 decision: {
                     status: "accepted" | "rejected";
                     reason: string;
@@ -422,6 +532,81 @@ export declare class SubledgerClient {
                 decision_id: string | null;
                 decision_digest: string | null;
             }[] | undefined;
+            usage_checks?: {
+                delegation_id: string;
+                currency: string;
+                expected_minor: number | null;
+                lines: {
+                    meter: "input_tokens" | "output_tokens" | "cache_read_input_tokens" | "model_call" | "tool_call" | "a2a_call";
+                    units: number;
+                    cost_minor: number;
+                    model?: {
+                        provider: string;
+                        name: string;
+                    } | undefined;
+                    tool_name?: string | undefined;
+                }[];
+                billed_minor: number;
+                difference_minor: number | null;
+                allowed_difference_minor: number | null;
+                within_tolerance: boolean | null;
+                unpriced: string[];
+                trace_digests: string[];
+                assurance: ("expired" | "rail_attested" | "contested" | "issuer_signed" | "buyer_recorded" | "network_recorded" | "recipient_viewed" | "link_authenticated_response" | "provider_identity_bound" | "provider_key_signed" | "superseded" | "revoked" | "gateway_signed")[];
+            }[] | undefined;
+            expectation_report?: {
+                currency: string;
+                task: {
+                    estimated_minor: number | null;
+                    held_minor: number;
+                    actual_minor: number;
+                    variance_vs_estimate_minor: number | null;
+                    variance_vs_estimate_bps: number | null;
+                    variance_vs_hold_minor: number | null;
+                    variance_vs_hold_bps: number | null;
+                    unestimated_minor: number;
+                };
+                nodes: {
+                    estimated_minor: number | null;
+                    held_minor: number;
+                    actual_minor: number;
+                    variance_vs_estimate_minor: number | null;
+                    variance_vs_estimate_bps: number | null;
+                    variance_vs_hold_minor: number | null;
+                    variance_vs_hold_bps: number | null;
+                    node_id: string;
+                    estimate_event_id: string | null;
+                }[];
+                records: {
+                    financial_event_id: string;
+                    node_id: string;
+                    type: "estimate" | "hold";
+                    issued_by: "agent" | "gateway" | "operator";
+                    status: "superseded" | "current" | "not_latest" | "after_charge" | "other_currency";
+                    hold_status: "expired" | "open" | "captured" | "released" | null;
+                    assurance: ("expired" | "rail_attested" | "contested" | "issuer_signed" | "buyer_recorded" | "network_recorded" | "recipient_viewed" | "link_authenticated_response" | "provider_identity_bound" | "provider_key_signed" | "superseded" | "revoked" | "gateway_signed")[];
+                }[];
+            } | undefined;
+            rail_attestations?: {
+                financial_event_id: string;
+                scheme: string;
+                rail: string;
+                rail_ref: string;
+                anchor: string;
+                assurance: ["rail_attested"];
+            }[] | undefined;
+            resolved_exceptions?: {
+                exception_id: string;
+                kind: string;
+                status: "open" | "dismissed" | "resolved";
+                delegation_id: string | null;
+                financial_event_id: string | null;
+                detail: string;
+                created_at: string;
+                resolved_by: string;
+                resolved_at: string;
+                resolution: string | null;
+            }[] | undefined;
         };
         signature: {
             key_id: string;
@@ -443,7 +628,7 @@ export declare class SubledgerClient {
     getReceipt(receiptId: string): Promise<{
         payload: {
             document_type: "atcn.subledger.receipt";
-            schema_version: "1.4" | "1.2" | "1.3";
+            schema_version: "1.2" | "1.3" | "1.4" | "1.5";
             receipt_id: string;
             revision: number;
             previous_receipt_id: string | null;
@@ -480,6 +665,11 @@ export declare class SubledgerClient {
                             name: string;
                             version: string;
                         } | undefined;
+                        additional_models?: {
+                            provider: string;
+                            name: string;
+                            version: string;
+                        }[] | undefined;
                         config_digest?: string | undefined;
                     };
                     protocol?: {
@@ -493,6 +683,33 @@ export declare class SubledgerClient {
                         agent_card_url?: string | undefined;
                     } | undefined;
                 } | undefined;
+                pricing?: {
+                    rates: {
+                        meter: "input_tokens" | "output_tokens" | "cache_read_input_tokens" | "model_call" | "tool_call" | "a2a_call";
+                        price_numerator: number;
+                        price_denominator: number;
+                        model?: {
+                            provider: string;
+                            name: string;
+                        } | undefined;
+                        tool_name?: string | undefined;
+                    }[];
+                    tolerance_bps: number;
+                    fixed_minor?: number | undefined;
+                } | undefined;
+                refund_terms?: {
+                    on_failure: "dispute" | "refund";
+                    on_timeout: "dispute" | "refund";
+                    after_settlement: {
+                        cap_minor: number;
+                        window_seconds: number;
+                    };
+                } | undefined;
+                witness_policy?: {
+                    min_independent_witnesses: number;
+                    independence: "distinct_verified_domain";
+                    witness_provider_ids?: string[] | undefined;
+                } | undefined;
             };
             provider: {
                 provider_id: string | null;
@@ -514,14 +731,38 @@ export declare class SubledgerClient {
                 supersedes_event_id: string | null;
                 reason: string | null;
                 event_id: string;
-                assurance: ("expired" | "contested" | "issuer_signed" | "buyer_recorded" | "network_recorded" | "recipient_viewed" | "link_authenticated_response" | "provider_identity_bound" | "provider_key_signed" | "superseded" | "revoked")[];
+                assurance: ("expired" | "rail_attested" | "contested" | "issuer_signed" | "buyer_recorded" | "network_recorded" | "recipient_viewed" | "link_authenticated_response" | "provider_identity_bound" | "provider_key_signed" | "superseded" | "revoked" | "gateway_signed")[];
                 recorded_at: string;
+                signer?: {
+                    provider_id: string;
+                    binding_id: string;
+                    key_id: string;
+                    value: string;
+                } | undefined;
+                usage?: {
+                    trace_digest: string;
+                    summary: {
+                        models: {
+                            provider: string;
+                            name: string;
+                            calls: number;
+                            input_tokens: number;
+                            output_tokens: number;
+                            cache_read_input_tokens: number;
+                        }[];
+                        tools: {
+                            name: string;
+                            calls: number;
+                        }[];
+                        a2a_calls: number;
+                    };
+                } | undefined;
             }[];
             financial_events: {
-                type: "quote" | "invoice" | "charge" | "payment_reported" | "refund" | "reversal" | "fee" | "credit" | "adjustment" | "fx_rate";
+                type: "refund" | "charge" | "invoice" | "estimate" | "hold" | "quote" | "payment_reported" | "reversal" | "fee" | "credit" | "adjustment" | "fx_rate";
+                provider_id: string | null;
                 currency: string;
                 retrospective: boolean;
-                provider_id: string | null;
                 evidence: {
                     uri: string;
                     digest: string | null;
@@ -534,7 +775,7 @@ export declare class SubledgerClient {
                 source_event_id: string;
                 provider_reference: string | null;
                 provider_status: string | null;
-                normalized_status: "unknown" | "quoted" | "issued" | "pending" | "reported_paid" | "failed" | "refunded" | "reversed" | "void";
+                normalized_status: "unknown" | "quoted" | "issued" | "pending" | "reported_paid" | "pending_finality" | "failed" | "refunded" | "reversed" | "void";
                 payer: "provider" | "buyer" | "other";
                 included_in_event_id: string | null;
                 reverses_event_id: string | null;
@@ -542,6 +783,29 @@ export declare class SubledgerClient {
                 imported_at: string;
                 financial_event_id: string;
                 allocation_version: number;
+                skill?: {
+                    namespace: string;
+                    skill_id: string;
+                    agent_card_url?: string | undefined;
+                } | undefined;
+                expectation?: {
+                    issued_by: "agent" | "gateway" | "operator";
+                    source_ref: string | null;
+                    basis: string | null;
+                    expires_at: string | null;
+                    supersedes: string | null;
+                    hold_status?: "expired" | "open" | "captured" | "released" | undefined;
+                    signer?: {
+                        provider_id: string;
+                        binding_id: string;
+                        key_id: string;
+                        value: string;
+                    } | undefined;
+                } | undefined;
+                rail_attestation?: {
+                    scheme: string;
+                    record: Record<string, unknown>;
+                } | undefined;
             }[];
             totals: Record<string, {
                 quoted: number;
@@ -557,23 +821,34 @@ export declare class SubledgerClient {
                 unresolved: number;
                 downstream_reported: number;
             }>;
-            field_status: Record<"delivery.status" | "delivery.evidence" | "scope.terms_digest" | "financial.amounts" | "financial.status", "contested" | "missing" | "imported" | "buyer_asserted" | "provider_reported">;
-            unverified_fields: ("delivery.status" | "delivery.evidence" | "scope.terms_digest" | "financial.amounts" | "financial.status")[];
+            field_status: Partial<Record<"delivery.status" | "delivery.evidence" | "scope.terms_digest" | "financial.amounts" | "financial.status" | "delivery.usage", "contested" | "missing" | "imported" | "buyer_asserted" | "provider_reported">>;
+            unverified_fields: ("delivery.status" | "delivery.evidence" | "scope.terms_digest" | "financial.amounts" | "financial.status" | "delivery.usage")[];
             corrections: {
                 response_id: string;
                 receipt_revision: number;
-                fields: ("delivery.status" | "delivery.evidence" | "scope.terms_digest" | "financial.amounts" | "financial.status")[];
+                fields: ("delivery.status" | "delivery.evidence" | "scope.terms_digest" | "financial.amounts" | "financial.status" | "delivery.usage")[];
                 decision: "accepted" | "rejected" | "open";
             }[];
             lineage: {
                 complete: boolean;
                 capture_gaps: {
+                    kind: string;
                     detail: string;
                     reported_at: string;
                     gap_id: string;
-                    kind: string;
                 }[];
             };
+            key_bindings?: {
+                binding_id: string;
+                provider_id: string;
+                key_id: string;
+                public_key: string;
+                method: "operator_configured" | "domain_challenge";
+                created_by: string;
+                created_at: string;
+                revoked_at: string | null;
+                domain?: string | null | undefined;
+            }[] | undefined;
         };
         signature: {
             key_id: string;
@@ -596,6 +871,15 @@ export declare class SubledgerClient {
         expires_at: string;
         allowed_actions: string[];
     }>;
+    /** A witness link: lets another provider (not the delegation's own) sign that it observed the run. It allows only viewing and witnessing. */
+    createWitnessShare(receiptId: string, witnessProviderId: string, ttlHours?: number, opts?: Opts): Promise<{
+        share_id: string;
+        token: string;
+        url: string;
+        expires_at: string;
+        allowed_actions: string[];
+        witness_provider_id: string;
+    }>;
     revokeReceiptShare(shareId: string, opts?: Opts): Promise<Json>;
     listResponses(receiptId: string): Promise<{
         items: Json[];
@@ -664,6 +948,8 @@ export declare class ReceiptLinkClient {
         issued_at?: string;
         expires_at?: string;
         refs?: AttestationRef[];
+        /** Schema 1.5: a witness statement, sent through a witness link. */
+        role?: "witness";
     }, signing?: {
         bindingId: string;
         keyId: string;

package/dist/subledger.js

@@ -46,9 +46,14 @@ export class SubledgerClient {
     recordFinancialEvent(input, opts = {}) {
         return this.http.request("POST", "/v1/financial-events", input, { idempotencyKey: opts.idempotencyKey ?? stableKey("financial", input.source, input.source_event_id) });
     }
+    recordRailAttestation(input, opts = {}) {
+        return this.http.request("POST", "/v1/financial-events/rail-attestations", input, opts);
+    }
     importCsv(csv, opts = {}) {
+        const { idempotencyKey, map, ...query } = opts;
         return this.http.request("POST", "/v1/financial-events/import", undefined, {
-            idempotencyKey: opts.idempotencyKey,
+            idempotencyKey,
+            query: { ...query, map: map === undefined ? undefined : JSON.stringify(map) },
             textBody: { contentType: "text/csv", text: csv },
         });
     }
@@ -97,6 +102,10 @@ export class SubledgerClient {
     createReceiptShare(receiptId, allowedActions = ["view"], ttlHours, opts = {}) {
         return this.http.request("POST", "/v1/receipt-shares", { receipt_id: receiptId, allowed_actions: allowedActions, ttl_hours: ttlHours }, opts);
     }
+    /** A witness link: lets another provider (not the delegation's own) sign that it observed the run. It allows only viewing and witnessing. */
+    createWitnessShare(receiptId, witnessProviderId, ttlHours, opts = {}) {
+        return this.http.request("POST", "/v1/receipt-shares", { receipt_id: receiptId, allowed_actions: ["view", "witness_attestation"], ttl_hours: ttlHours, witness_provider_id: witnessProviderId }, opts);
+    }
     revokeReceiptShare(shareId, opts = {}) {
         return this.http.request("DELETE", `/v1/receipt-shares/${shareId}`, undefined, opts);
     }
@@ -179,6 +188,7 @@ export class ReceiptLinkClient {
                 issued_at: response.issued_at,
                 expires_at: response.expires_at,
                 refs: response.refs,
+                role: response.role,
             });
             provider_signature = { binding_id: signing.bindingId, key_id: signing.keyId, value: signStatement(statement, signing.privateKey) };
         }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@atcn/sdk",
-  "version": "1.4.1",
-  "description": "TypeScript SDK for ATCN: sign events, build terms and evidence envelopes, call the API, verify webhooks, closures, and closure packages",
+  "version": "1.5.1",
+  "description": "TypeScript SDK for ATCN, a cost record for AI agent jobs that anyone can verify: record tasks and charges, sign events, verify closures offline",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
@@ -36,10 +36,10 @@
     "build": "tsc -p tsconfig.build.json"
   },
   "dependencies": {
-    "@atcn/core": "1.4.1",
-    "@atcn/schema": "1.4.1",
-    "@atcn/subledger": "1.4.1",
-    "@atcn/usage": "1.4.1",
+    "@atcn/core": "1.5.1",
+    "@atcn/schema": "1.5.1",
+    "@atcn/subledger": "1.5.1",
+    "@atcn/usage": "1.5.1",
     "zod": "^4.1.0"
   }
 }