@atcn/sdk 1.3.0 → 1.4.0

package/dist/builders.d.ts

@@ -1,4 +1,4 @@
-import { type Deliverable, type EvidenceEnvelope, type ObligationTerms, type PolicyTemplate } from "@atcn/schema";
+import { type Deliverable, type EvidenceEnvelope, type ObligationTerms, type PolicyTemplate, type SkillRef } from "@atcn/schema";
 export interface TermsInput {
     parentObligationId?: string | null;
     principalId: string;
@@ -22,6 +22,8 @@ export interface TermsInput {
     } | null;
     disputeReviewerId?: string | null;
     verifierAgentIds?: string[];
+    /** The skill the counterparty performs (for A2A, the AgentSkill id). Produces schema_version 1.1 terms. */
+    skill?: SkillRef;
 }
 /** 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: "1.0",
+        schema_version: input.skill ? "1.1" : "1.0",
         obligation_id: newId("obligation"),
         terms_version: 1,
         parent_obligation_id: input.parentObligationId ?? null,
@@ -27,6 +27,7 @@ export function buildTerms(input) {
         dispute_reviewer_id: input.disputeReviewerId ?? null,
         verifier_agent_ids: input.verifierAgentIds ?? [],
         issued_at: new Date(now).toISOString(),
+        ...(input.skill ? { skill: input.skill } : {}),
     };
 }
 /** Data for obligation.created / obligation.offered / obligation.amended events. */

package/dist/client.d.ts

@@ -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.3.0";
+export declare const SDK_VERSION = "1.4.0";
 /** 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 {
@@ -140,7 +140,7 @@ export declare class AtcnClient {
                 parent_obligation_id: string | null;
                 redacted: boolean;
                 effective_terms: {
-                    schema_version: "1.0";
+                    schema_version: "1.0" | "1.1";
                     obligation_id: string;
                     terms_version: number;
                     parent_obligation_id: string | null;
@@ -181,6 +181,11 @@ export declare class AtcnClient {
                     dispute_reviewer_id: string | null;
                     verifier_agent_ids: string[];
                     issued_at: string;
+                    skill?: {
+                        namespace: string;
+                        skill_id: string;
+                        agent_card_url?: string | undefined;
+                    } | undefined;
                 } | null;
                 effective_terms_digest: string | null;
                 state: 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.3.0";
+export const SDK_VERSION = "1.4.0";
 /** 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. */

package/dist/index.d.ts

@@ -4,4 +4,4 @@ export { AtcnClient, AtcnApiError, SDK_HEADER, SDK_VERSION, type ClientOptions,
 export { verifyClosurePackage, REFERENCE_POLICIES, CODE_CHANGE_POLICY_V1, CODE_CHANGE_POLICY_V1_1, CODE_CHANGE_SUBTASK_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 { verifyWebhook, signWebhook, WEBHOOK_SIGNATURE_HEADER, generateKeyPair, digestOf, sha256Digest, canonicalize } from "@atcn/schema";
+export { verifyWebhook, signWebhook, WEBHOOK_SIGNATURE_HEADER, generateKeyPair, digestOf, sha256Digest, canonicalize, executionBinding } from "@atcn/schema";

package/dist/index.js

@@ -4,4 +4,4 @@ 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 { SubledgerClient, ReceiptLinkClient, CaptureQueue, ext, stableKey } from "./subledger.js";
 export { verifySubledgerDocument, buildResponseStatement, signStatement, verifyStatementSignature } from "@atcn/subledger";
-export { verifyWebhook, signWebhook, WEBHOOK_SIGNATURE_HEADER, generateKeyPair, digestOf, sha256Digest, canonicalize } from "@atcn/schema";
+export { verifyWebhook, signWebhook, WEBHOOK_SIGNATURE_HEADER, generateKeyPair, digestOf, sha256Digest, canonicalize, executionBinding } from "@atcn/schema";

package/dist/subledger.d.ts

@@ -1,5 +1,6 @@
 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 AttestationRef, type ExecutionBinding } from "@atcn/schema";
 import { AtcnClient, type ClientOptions } from "./client.js";
 type Json = Record<string, unknown>;
 type Opts = {
@@ -89,7 +90,7 @@ export declare class SubledgerClient {
     getClosure(taskId: string, version?: number): Promise<{
         payload: {
             document_type: "atcn.subledger.closure";
-            schema_version: "1.3" | "1.2";
+            schema_version: "1.4" | "1.2" | "1.3";
             closure_id: string;
             version: number;
             previous_closure_id: string | null;
@@ -133,13 +134,37 @@ export declare class SubledgerClient {
                 delivery_status: string;
                 retrospective: boolean;
                 created_at: string;
+                execution?: {
+                    execution_id: string;
+                    agent: {
+                        agent_id: string;
+                        agent_version: string;
+                        card_digest?: string | undefined;
+                        model?: {
+                            provider: string;
+                            name: string;
+                            version: string;
+                        } | undefined;
+                        config_digest?: string | undefined;
+                    };
+                    protocol?: {
+                        name: "a2a";
+                        task_id: string;
+                        context_id?: string | undefined;
+                    } | undefined;
+                    skill?: {
+                        namespace: string;
+                        skill_id: string;
+                        agent_card_url?: string | undefined;
+                    } | 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: ("contested" | "issuer_signed" | "buyer_recorded" | "network_recorded" | "recipient_viewed" | "link_authenticated_response" | "provider_identity_bound" | "provider_key_signed" | "superseded")[];
+                assurance: ("expired" | "contested" | "issuer_signed" | "buyer_recorded" | "network_recorded" | "recipient_viewed" | "link_authenticated_response" | "provider_identity_bound" | "provider_key_signed" | "superseded" | "revoked")[];
                 note: string | null;
                 evidence: {
                     uri: string;
@@ -335,6 +360,17 @@ export declare class SubledgerClient {
                         proposed_value: string;
                         reason: string;
                     }[];
+                    execution?: {
+                        execution_id: string;
+                        execution_digest: string;
+                    } | undefined;
+                    issued_at?: string | undefined;
+                    expires_at?: string | undefined;
+                    refs?: {
+                        relation: "revokes" | "disputes";
+                        attestation_digest: string;
+                        reason: string;
+                    }[] | undefined;
                 };
                 statement_digest: string;
                 provider_signature: {
@@ -342,7 +378,7 @@ export declare class SubledgerClient {
                     binding_id: string;
                     value: string;
                 } | null;
-                assurance: ("contested" | "issuer_signed" | "buyer_recorded" | "network_recorded" | "recipient_viewed" | "link_authenticated_response" | "provider_identity_bound" | "provider_key_signed" | "superseded")[];
+                assurance: ("expired" | "contested" | "issuer_signed" | "buyer_recorded" | "network_recorded" | "recipient_viewed" | "link_authenticated_response" | "provider_identity_bound" | "provider_key_signed" | "superseded" | "revoked")[];
                 decision: {
                     status: "accepted" | "rejected";
                     reason: string;
@@ -407,7 +443,7 @@ export declare class SubledgerClient {
     getReceipt(receiptId: string): Promise<{
         payload: {
             document_type: "atcn.subledger.receipt";
-            schema_version: "1.3" | "1.2";
+            schema_version: "1.4" | "1.2" | "1.3";
             receipt_id: string;
             revision: number;
             previous_receipt_id: string | null;
@@ -433,6 +469,30 @@ export declare class SubledgerClient {
                 expected_delivery: string | null;
                 retrospective: boolean;
                 downstream_visibility: "unknown" | "disclosed" | "none";
+                execution?: {
+                    execution_id: string;
+                    agent: {
+                        agent_id: string;
+                        agent_version: string;
+                        card_digest?: string | undefined;
+                        model?: {
+                            provider: string;
+                            name: string;
+                            version: string;
+                        } | undefined;
+                        config_digest?: string | undefined;
+                    };
+                    protocol?: {
+                        name: "a2a";
+                        task_id: string;
+                        context_id?: string | undefined;
+                    } | undefined;
+                    skill?: {
+                        namespace: string;
+                        skill_id: string;
+                        agent_card_url?: string | undefined;
+                    } | undefined;
+                } | undefined;
             };
             provider: {
                 provider_id: string | null;
@@ -454,7 +514,7 @@ export declare class SubledgerClient {
                 supersedes_event_id: string | null;
                 reason: string | null;
                 event_id: string;
-                assurance: ("contested" | "issuer_signed" | "buyer_recorded" | "network_recorded" | "recipient_viewed" | "link_authenticated_response" | "provider_identity_bound" | "provider_key_signed" | "superseded")[];
+                assurance: ("expired" | "contested" | "issuer_signed" | "buyer_recorded" | "network_recorded" | "recipient_viewed" | "link_authenticated_response" | "provider_identity_bound" | "provider_key_signed" | "superseded" | "revoked")[];
                 recorded_at: string;
             }[];
             financial_events: {
@@ -600,6 +660,10 @@ export declare class ReceiptLinkClient {
         note?: string | null;
         evidence?: EvidenceRef[];
         corrections?: Correction[];
+        execution?: ExecutionBinding;
+        issued_at?: string;
+        expires_at?: string;
+        refs?: AttestationRef[];
     }, signing?: {
         bindingId: string;
         keyId: string;

package/dist/subledger.js

@@ -175,6 +175,10 @@ export class ReceiptLinkClient {
                 note: response.note ?? null,
                 evidence: response.evidence ?? [],
                 corrections: response.corrections ?? [],
+                execution: response.execution,
+                issued_at: response.issued_at,
+                expires_at: response.expires_at,
+                refs: response.refs,
             });
             provider_signature = { binding_id: signing.bindingId, key_id: signing.keyId, value: signStatement(statement, signing.privateKey) };
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atcn/sdk",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "TypeScript SDK for ATCN: sign events, build terms and evidence envelopes, call the API, verify webhooks, closures, and closure packages",
   "license": "Apache-2.0",
   "repository": {
@@ -36,10 +36,10 @@
     "build": "tsc -p tsconfig.build.json"
   },
   "dependencies": {
-    "@atcn/core": "1.3.0",
-    "@atcn/schema": "1.3.0",
-    "@atcn/subledger": "1.3.0",
-    "@atcn/usage": "1.3.0",
+    "@atcn/core": "1.4.0",
+    "@atcn/schema": "1.4.0",
+    "@atcn/subledger": "1.4.0",
+    "@atcn/usage": "1.4.0",
     "zod": "^4.1.0"
   }
 }