tenzro-sdk 0.2.0 → 0.4.0

package/dist/workflow.d.ts

@@ -0,0 +1,98 @@
+import type { RpcClient } from './rpc';
+export type WorkflowStatus = 'created' | 'open' | 'executing' | 'verifying' | 'compensating' | 'finalized' | 'failed';
+export type SagaStepStatus = 'pending' | 'executing' | 'verifying' | 'verified' | 'compensating' | 'compensated' | 'failed';
+export interface SagaStep {
+    step_id: string;
+    status: SagaStepStatus;
+    actor_did?: string;
+    escrow_amount?: string;
+    payload?: unknown;
+    result?: unknown;
+}
+export interface SagaWorkflow {
+    workflow_id: string;
+    steps: SagaStep[];
+    status: WorkflowStatus;
+}
+export interface WorkflowPayload {
+    workflow_id?: string;
+    creator_did: string;
+    participants: string[];
+    steps: SagaStep[];
+    metadata?: Record<string, unknown>;
+}
+/**
+ * A DID-signed envelope. The shape matches `tenzro_types::IdentityEnvelope`:
+ * a canonical-JSON payload + signature + DID + algorithm tag.
+ */
+export interface DidEnvelope {
+    payload: unknown;
+    signature: string;
+    signer_did: string;
+    alg: string;
+    [extra: string]: unknown;
+}
+/**
+ * Multi-agent saga workflow client.
+ *
+ * A workflow is an ordered sequence of saga steps with per-step
+ * Execute → Verify → Compensate lifecycles, optional per-step escrow,
+ * durable lifecycle state, and optional mirroring to Canton DAML for
+ * institutional counterparties. The full lifecycle is mediated by
+ * `tenzro_workflow*` RPCs.
+ *
+ * @example
+ * ```ts
+ * const workflow = client.workflow;
+ *
+ * const opened = await workflow.open({
+ *   creator_did: 'did:tenzro:human:...',
+ *   participants: ['did:tenzro:machine:...'],
+ *   steps: [{ step_id: 'step-1', status: 'pending' }],
+ * });
+ *
+ * await workflow.stepExecute(opened.workflow_id, 'step-1');
+ * await workflow.stepVerify(opened.workflow_id, 'step-1');
+ * await workflow.finalize(opened.workflow_id);
+ * ```
+ */
+export declare class WorkflowClient {
+    private readonly rpc;
+    constructor(rpc: RpcClient);
+    /** Open a multi-agent saga workflow. */
+    open(workflow: WorkflowPayload): Promise<unknown>;
+    /** Transition a step Pending → Executing, optionally locking per-step escrow. */
+    stepExecute(workflowId: string, stepId: string, escrowAmount?: bigint): Promise<unknown>;
+    /** Verify a step's outcome. */
+    stepVerify(workflowId: string, stepId: string): Promise<unknown>;
+    /** Compensate a step (roll back). */
+    stepCompensate(workflowId: string, stepId: string): Promise<unknown>;
+    /**
+     * Finalize the workflow — emits a `WorkflowReceipt` when all steps have
+     * completed successfully (or compensated cleanly).
+     */
+    finalize(workflowId: string): Promise<unknown>;
+    /** Read the current state of a workflow. */
+    get(workflowId: string): Promise<unknown>;
+    /** Read the underlying saga (step-level execution state). */
+    getSaga(workflowId: string): Promise<unknown>;
+    /** Read the durable lifecycle record. */
+    getLifecycle(workflowId: string): Promise<unknown>;
+    /** Read the receipt emitted when the workflow finalized. */
+    getReceipt(workflowId: string): Promise<unknown>;
+    /** Read operational metrics for a workflow. */
+    getOperationalMetrics(workflowId: string): Promise<unknown>;
+    /** List recent workflow receipts. */
+    listReceipts(limit?: number): Promise<unknown>;
+    /** List workflows authored by a creator DID. */
+    listByCreator(creatorDid: string): Promise<unknown>;
+    /** List workflows where `participant_did` appears as a step actor. */
+    listByParticipant(participantDid: string): Promise<unknown>;
+    /** List workflows currently in a given status. */
+    listByStatus(status: WorkflowStatus): Promise<unknown>;
+    /** Mirror a workflow's receipt into Canton DAML. */
+    mirrorToCanton(workflowId: string): Promise<unknown>;
+    /** Verify a DID-signed envelope (e.g. an off-chain signed step result). */
+    verifyDidEnvelope(envelope: DidEnvelope): Promise<unknown>;
+}
+//# sourceMappingURL=workflow.d.ts.map

package/dist/workflow.d.ts.map

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

package/dist/workflow.js

@@ -0,0 +1,131 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkflowClient = void 0;
+// ── Client ──
+/**
+ * Multi-agent saga workflow client.
+ *
+ * A workflow is an ordered sequence of saga steps with per-step
+ * Execute → Verify → Compensate lifecycles, optional per-step escrow,
+ * durable lifecycle state, and optional mirroring to Canton DAML for
+ * institutional counterparties. The full lifecycle is mediated by
+ * `tenzro_workflow*` RPCs.
+ *
+ * @example
+ * ```ts
+ * const workflow = client.workflow;
+ *
+ * const opened = await workflow.open({
+ *   creator_did: 'did:tenzro:human:...',
+ *   participants: ['did:tenzro:machine:...'],
+ *   steps: [{ step_id: 'step-1', status: 'pending' }],
+ * });
+ *
+ * await workflow.stepExecute(opened.workflow_id, 'step-1');
+ * await workflow.stepVerify(opened.workflow_id, 'step-1');
+ * await workflow.finalize(opened.workflow_id);
+ * ```
+ */
+class WorkflowClient {
+    rpc;
+    constructor(rpc) {
+        this.rpc = rpc;
+    }
+    /** Open a multi-agent saga workflow. */
+    async open(workflow) {
+        return this.rpc.call('tenzro_workflowOpen', { workflow });
+    }
+    /** Transition a step Pending → Executing, optionally locking per-step escrow. */
+    async stepExecute(workflowId, stepId, escrowAmount) {
+        const params = {
+            workflow_id: workflowId,
+            step_id: stepId,
+        };
+        if (escrowAmount !== undefined) {
+            params.escrow_amount = escrowAmount.toString();
+        }
+        return this.rpc.call('tenzro_workflowStepExecute', params);
+    }
+    /** Verify a step's outcome. */
+    async stepVerify(workflowId, stepId) {
+        return this.rpc.call('tenzro_workflowStepVerify', {
+            workflow_id: workflowId,
+            step_id: stepId,
+        });
+    }
+    /** Compensate a step (roll back). */
+    async stepCompensate(workflowId, stepId) {
+        return this.rpc.call('tenzro_workflowStepCompensate', {
+            workflow_id: workflowId,
+            step_id: stepId,
+        });
+    }
+    /**
+     * Finalize the workflow — emits a `WorkflowReceipt` when all steps have
+     * completed successfully (or compensated cleanly).
+     */
+    async finalize(workflowId) {
+        return this.rpc.call('tenzro_workflowFinalize', { workflow_id: workflowId });
+    }
+    /** Read the current state of a workflow. */
+    async get(workflowId) {
+        return this.rpc.call('tenzro_getWorkflow', { workflow_id: workflowId });
+    }
+    /** Read the underlying saga (step-level execution state). */
+    async getSaga(workflowId) {
+        return this.rpc.call('tenzro_getWorkflowSaga', { workflow_id: workflowId });
+    }
+    /** Read the durable lifecycle record. */
+    async getLifecycle(workflowId) {
+        return this.rpc.call('tenzro_getWorkflowLifecycle', {
+            workflow_id: workflowId,
+        });
+    }
+    /** Read the receipt emitted when the workflow finalized. */
+    async getReceipt(workflowId) {
+        return this.rpc.call('tenzro_getWorkflowReceipt', {
+            workflow_id: workflowId,
+        });
+    }
+    /** Read operational metrics for a workflow. */
+    async getOperationalMetrics(workflowId) {
+        return this.rpc.call('tenzro_getWorkflowOperationalMetrics', {
+            workflow_id: workflowId,
+        });
+    }
+    /** List recent workflow receipts. */
+    async listReceipts(limit) {
+        const params = {};
+        if (limit !== undefined)
+            params.limit = limit;
+        return this.rpc.call('tenzro_listWorkflowReceipts', params);
+    }
+    /** List workflows authored by a creator DID. */
+    async listByCreator(creatorDid) {
+        return this.rpc.call('tenzro_listWorkflowsByCreator', {
+            creator_did: creatorDid,
+        });
+    }
+    /** List workflows where `participant_did` appears as a step actor. */
+    async listByParticipant(participantDid) {
+        return this.rpc.call('tenzro_listWorkflowsByParticipant', {
+            participant_did: participantDid,
+        });
+    }
+    /** List workflows currently in a given status. */
+    async listByStatus(status) {
+        return this.rpc.call('tenzro_listWorkflowsByStatus', { status });
+    }
+    /** Mirror a workflow's receipt into Canton DAML. */
+    async mirrorToCanton(workflowId) {
+        return this.rpc.call('tenzro_mirrorWorkflowToCanton', {
+            workflow_id: workflowId,
+        });
+    }
+    /** Verify a DID-signed envelope (e.g. an off-chain signed step result). */
+    async verifyDidEnvelope(envelope) {
+        return this.rpc.call('tenzro_verifyDidEnvelope', { envelope });
+    }
+}
+exports.WorkflowClient = WorkflowClient;
+//# sourceMappingURL=workflow.js.map

package/dist/workflow.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tenzro-sdk",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Tenzro Network SDK — wallets, identity, agents, inference, bridge, crypto, TEE, ZK proofs, custody, and settlement",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -36,6 +36,7 @@
     "LICENSE"
   ],
   "devDependencies": {
+    "@types/node": "^20.11.0",
     "typescript": "^5.9.3"
   }
 }