tenzro-sdk 0.2.0 → 0.4.0

package/dist/task.js

@@ -1,6 +1,20 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TaskClient = void 0;
+/**
+ * Task-marketplace client.
+ *
+ * Full settlement cycle on the live testnet:
+ *
+ *   await client.task.postTask({ title, poster, max_price, task_type, input })
+ *   await client.task.quoteTask(taskId, providerAddress, price, { model_id, ... })
+ *   await client.task.assignTask(taskId, providerAddress, quotedPrice)
+ *   await client.task.completeTask(taskId, output)   // <- triggers TNZO transfer
+ *
+ * `completeTask` performs the on-chain settlement: `tenzro-token`
+ * transfers `final_price` (the quoted price, or `max_price` if unquoted)
+ * from poster to assignee through the unified token registry.
+ */
 class TaskClient {
     rpc;
     constructor(rpc) {
@@ -18,53 +32,73 @@ class TaskClient {
     async cancelTask(taskId) {
         return this.rpc.call('tenzro_cancelTask', [{ task_id: taskId }]);
     }
-    async submitQuote(taskId, price, modelId, estimatedDurationSecs) {
-        return this.rpc.call('tenzro_submitQuote', [{
-                task_id: taskId,
-                price,
-                model_id: modelId,
-                estimated_duration_secs: estimatedDurationSecs,
-            }]);
-    }
     /**
-     * Submit a quote for a task with price and estimated completion time.
-     * @param taskId - The task to quote
-     * @param price - Quoted price (in TNZO wei)
-     * @param estimatedTime - Estimated completion time (e.g., "120s", "5m", "1h")
-     * @returns Quote result
+     * Submit a quote for a task.
+     *
+     * @param taskId - The task to quote.
+     * @param provider - Provider address (hex). Required — the live RPC
+     *   rejects quotes that lack a provider address.
+     * @param price - Quoted price in TNZO wei (u128 as decimal string).
+     * @param opts.modelId - Optional model identifier (default: `"any"`).
+     * @param opts.confidence - Quote confidence 0–100 (default: 80).
+     * @param opts.estimatedDurationSecs - Estimated runtime in seconds (default: 60).
+     * @param opts.notes - Optional free-form notes.
      */
-    async quoteTask(taskId, price, estimatedTime) {
+    async quoteTask(taskId, provider, price, opts) {
         return this.rpc.call('tenzro_quoteTask', [
-            { task_id: taskId, price, estimated_time: estimatedTime },
+            {
+                task_id: taskId,
+                provider,
+                price,
+                model_id: opts?.modelId,
+                confidence: opts?.confidence,
+                estimated_duration_secs: opts?.estimatedDurationSecs,
+                notes: opts?.notes,
+            },
         ]);
     }
     /**
-     * Assign a task to a specific agent.
-     * @param taskId - The task to assign
-     * @param agentId - The agent to assign it to
-     * @returns Assignment result with status
+     * Assign a task to a specific provider address.
+     *
+     * The live RPC handler keys assignment on the provider's wallet
+     * address, not an agent_id — the task's `assignee` field is set to
+     * `provider`, and `quoted_price` is stored on the task so that
+     * `completeTask` can settle to it.
+     *
+     * @param taskId - The task to assign.
+     * @param provider - Provider wallet address (hex).
+     * @param quotedPrice - Optional locked-in price in TNZO wei
+     *   (u128 as decimal string). If omitted, the task's `max_price`
+     *   is used at settlement time.
      */
-    async assignTask(taskId, agentId) {
+    async assignTask(taskId, provider, quotedPrice) {
         return this.rpc.call('tenzro_assignTask', [
-            { task_id: taskId, agent_id: agentId },
+            {
+                task_id: taskId,
+                provider,
+                quoted_price: quotedPrice,
+            },
         ]);
     }
     /**
-     * Mark a task as completed with the final result.
-     * @param taskId - The task to complete
-     * @param result - The output / result of the task
-     * @returns Completion result with status and optional settlement tx hash
+     * Mark a task as completed and trigger on-chain TNZO settlement.
+     *
+     * The live RPC handler:
+     *   1. transfers `final_price` from poster to assignee via the token registry,
+     *   2. sets `task.status = Completed`,
+     *   3. stores `output` on the task,
+     *   4. returns the new poster/assignee balances under `settlement`.
+     *
+     * @param taskId - The task to complete.
+     * @param output - The result / output text to attach to the task.
      */
-    async completeTask(taskId, result) {
+    async completeTask(taskId, output) {
         return this.rpc.call('tenzro_completeTask', [
-            { task_id: taskId, result },
+            { task_id: taskId, output },
         ]);
     }
     /**
-     * Update an existing task.
-     * @param taskId - The task to update
-     * @param options - Fields to update (partial)
-     * @returns Updated task information
+     * Update an existing task (creator only).
      */
     async updateTask(taskId, options) {
         return this.rpc.call('tenzro_updateTask', [

package/dist/task.js.map

@@ -1 +1 @@
-{"version":3,"file":"task.js","sourceRoot":"","sources":["../src/task.ts"],"names":[],"mappings":";;;AAGA,MAAa,UAAU;IACQ;IAA7B,YAA6B,GAAc;QAAd,QAAG,GAAH,GAAG,CAAW;IAAG,CAAC;IAE/C,KAAK,CAAC,QAAQ,CAAC,MAAsB;QACnC,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAW,iBAAiB,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAC9D,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,MAAmB;QACjC,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAa,kBAAkB,EAAE,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC;IACvE,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,MAAc;QAC1B,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAW,gBAAgB,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IAC1E,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,MAAc;QAC7B,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAU,mBAAmB,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IAC5E,CAAC;IAED,KAAK,CAAC,WAAW,CACf,MAAc,EACd,KAAa,EACb,OAAe,EACf,qBAA6B;QAE7B,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAY,oBAAoB,EAAE,CAAC;gBACrD,OAAO,EAAE,MAAM;gBACf,KAAK;gBACL,QAAQ,EAAE,OAAO;gBACjB,uBAAuB,EAAE,qBAAqB;aAC/C,CAAC,CAAC,CAAC;IACN,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,SAAS,CACb,MAAc,EACd,KAAa,EACb,aAAqB;QAErB,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,kBAAkB,EAAE;YACvC,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE;SAC1D,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,UAAU,CAAC,MAAc,EAAE,OAAe;QAC9C,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAmB,mBAAmB,EAAE;YAC1D,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE;SACvC,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,YAAY,CAAC,MAAc,EAAE,MAAc;QAC/C,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAqB,qBAAqB,EAAE;YAC9D,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE;SAC5B,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,UAAU,CACd,MAAc,EACd,OAKC;QAED,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,mBAAmB,EAAE;YACxC,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE;SAChC,CAAC,CAAC;IACL,CAAC;CACF;AA7FD,gCA6FC"}
+{"version":3,"file":"task.js","sourceRoot":"","sources":["../src/task.ts"],"names":[],"mappings":";;;AAUA;;;;;;;;;;;;;GAaG;AACH,MAAa,UAAU;IACQ;IAA7B,YAA6B,GAAc;QAAd,QAAG,GAAH,GAAG,CAAW;IAAG,CAAC;IAE/C,KAAK,CAAC,QAAQ,CAAC,MAAsB;QACnC,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAW,iBAAiB,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAC9D,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,MAAmB;QACjC,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAa,kBAAkB,EAAE,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC;IACvE,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,MAAc;QAC1B,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAW,gBAAgB,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IAC1E,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,MAAc;QAC7B,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAU,mBAAmB,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IAC5E,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,SAAS,CACb,MAAc,EACd,QAAgB,EAChB,KAAa,EACb,IAKC;QAED,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAY,kBAAkB,EAAE;YAClD;gBACE,OAAO,EAAE,MAAM;gBACf,QAAQ;gBACR,KAAK;gBACL,QAAQ,EAAE,IAAI,EAAE,OAAO;gBACvB,UAAU,EAAE,IAAI,EAAE,UAAU;gBAC5B,uBAAuB,EAAE,IAAI,EAAE,qBAAqB;gBACpD,KAAK,EAAE,IAAI,EAAE,KAAK;aACnB;SACF,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,UAAU,CACd,MAAc,EACd,QAAgB,EAChB,WAAoB;QAEpB,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAmB,mBAAmB,EAAE;YAC1D;gBACE,OAAO,EAAE,MAAM;gBACf,QAAQ;gBACR,YAAY,EAAE,WAAW;aAC1B;SACF,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,YAAY,CAAC,MAAc,EAAE,MAAc;QAC/C,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAqB,qBAAqB,EAAE;YAC9D,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE;SAC5B,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CACd,MAAc,EACd,OAKC;QAED,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAW,mBAAmB,EAAE;YAClD,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE;SAChC,CAAC,CAAC;IACL,CAAC;CACF;AArHD,gCAqHC"}

package/dist/token.d.ts

@@ -37,14 +37,14 @@ export interface ListTokensParams {
 /** Parameters for a cross-VM token transfer. */
 export interface CrossVmTransferParams {
     /** Sender address */
-    from: string;
+    from_address: string;
     /** Recipient address */
-    to: string;
+    to_address: string;
     /** Amount as a decimal string */
     amount: string;
-    /** Source VM: "evm", "svm", or "daml" */
+    /** Source VM: "evm", "svm", "daml", or "native" */
     from_vm: string;
-    /** Destination VM: "evm", "svm", or "daml" */
+    /** Destination VM: "evm", "svm", "daml", or "native" */
     to_vm: string;
     /** Token symbol (default: "TNZO") */
     token?: string;
@@ -77,16 +77,46 @@ export interface TokenListResult {
     /** Total number of tokens matching the filter */
     total: number;
 }
-/** Token balance across VMs. */
+/** Native TNZO view (18 decimals). */
+export interface NativeBalance {
+    /** Balance in wei (decimal string) */
+    balance_wei: string;
+    /** Number of decimals (always 18) */
+    decimals: number;
+}
+/** EVM wTNZO ERC-20 view — same wei as native, 18 decimals. */
+export interface EvmBalance {
+    /** Balance in wei (decimal string) */
+    balance_wei: string;
+    /** Number of decimals (always 18) */
+    decimals: number;
+}
+/** SVM wTNZO SPL view — 9-decimal truncation of native balance. */
+export interface SvmBalance {
+    /** Balance in SPL base units (decimal string, 9 decimals) */
+    balance_base_units: string;
+    /** Number of decimals (always 9) */
+    decimals: number;
+}
+/** DAML CIP-56 holding view — same wei as native, 18 decimals. */
+export interface DamlBalance {
+    /** Holding amount in wei (decimal string) */
+    amount_wei: string;
+    /** Number of decimals (always 18) */
+    decimals: number;
+}
+/** Token balance across all four VM views (pointer model). */
 export interface TokenBalance {
     /** Address queried */
     address: string;
-    /** Token symbol */
-    token: string;
-    /** Total balance as a decimal string */
-    balance: string;
-    /** Per-VM breakdown */
-    balances?: Record<string, string>;
+    /** Native TNZO balance (18-decimal wei) */
+    native: NativeBalance;
+    /** EVM wTNZO ERC-20 view — tracks native 1:1 */
+    evm_wtnzo: EvmBalance;
+    /** SVM wTNZO SPL view — 9-decimal truncation */
+    svm_wtnzo: SvmBalance;
+    /** DAML CIP-56 holding view — tracks native 1:1 */
+    daml_holding: DamlBalance;
 }
 /** Result of wrapping native TNZO into a VM representation. */
 export interface WrapResult {

package/dist/token.d.ts.map

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

package/dist/token.js.map

@@ -1 +1 @@
-{"version":3,"file":"token.js","sourceRoot":"","sources":["../src/token.ts"],"names":[],"mappings":";;;AAEA;;;;GAIG;AACU,QAAA,iBAAiB,GAAG,4CAA4C,CAAC;AA0H9E,eAAe;AAEf;;;;GAIG;AACH,MAAa,WAAW;IACO;IAA7B,YAA6B,GAAc;QAAd,QAAG,GAAH,GAAG,CAAW;IAAG,CAAC;IAE/C;;;;;OAKG;IACH,KAAK,CAAC,WAAW,CAAC,MAAyB;QACzC,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAY,oBAAoB,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAClE,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,YAAY,CAAC,MAA0B;QAC3C,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAY,iBAAiB,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAC/D,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,UAAU,CAAC,MAAyB;QACxC,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAkB,mBAAmB,EAAE,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC;IAC7E,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,eAAe,CAAC,OAAe,EAAE,KAAc;QACnD,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAe,wBAAwB,EAAE;YAC3D,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,IAAI,MAAM,EAAE;SACpC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,QAAQ,CAAC,OAAe,EAAE,MAAc,EAAE,IAAY;QAC1D,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAa,iBAAiB,EAAE;YAClD,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE;SACnC,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,eAAe,CAAC,MAA6B;QACjD,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAiB,wBAAwB,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAC3E,CAAC;CACF;AAjED,kCAiEC"}
+{"version":3,"file":"token.js","sourceRoot":"","sources":["../src/token.ts"],"names":[],"mappings":";;;AAEA;;;;GAIG;AACU,QAAA,iBAAiB,GAAG,4CAA4C,CAAC;AA4J9E,eAAe;AAEf;;;;GAIG;AACH,MAAa,WAAW;IACO;IAA7B,YAA6B,GAAc;QAAd,QAAG,GAAH,GAAG,CAAW;IAAG,CAAC;IAE/C;;;;;OAKG;IACH,KAAK,CAAC,WAAW,CAAC,MAAyB;QACzC,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAY,oBAAoB,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAClE,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,YAAY,CAAC,MAA0B;QAC3C,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAY,iBAAiB,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAC/D,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,UAAU,CAAC,MAAyB;QACxC,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAkB,mBAAmB,EAAE,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC;IAC7E,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,eAAe,CAAC,OAAe,EAAE,KAAc;QACnD,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAe,wBAAwB,EAAE;YAC3D,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,IAAI,MAAM,EAAE;SACpC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,QAAQ,CAAC,OAAe,EAAE,MAAc,EAAE,IAAY;QAC1D,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAa,iBAAiB,EAAE;YAClD,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE;SACnC,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,eAAe,CAAC,MAA6B;QACjD,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAiB,wBAAwB,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAC3E,CAAC;CACF;AAjED,kCAiEC"}

package/dist/training.d.ts

@@ -0,0 +1,108 @@
+import { RpcClient } from "./rpc";
+/**
+ * Lifecycle status of a `TrainingRun`. Mirrors the Rust
+ * `tenzro_types::training::TrainingRunStatus` enum.
+ */
+export type TrainingRunStatus = "Pending" | "Active" | "Completed" | "Failed" | "Cancelled";
+/**
+ * Read-side view of a `TrainingRun` — the protocol-side run header
+ * the syncer maintains for an in-flight training task. Field shape
+ * matches `tenzro_types::training::TrainingRun` verbatim; opaque
+ * sub-payloads (current `SyncRound`, aggregator config, attestations)
+ * are passed through as `unknown` so this SDK doesn't lock callers to
+ * a specific decode shape.
+ */
+export interface TrainingRun {
+    task_id: string;
+    task_spec: unknown;
+    status: TrainingRunStatus;
+    current_round: number;
+    state_root: string;
+    enrolled_trainers: string[];
+    created_at_ms: number;
+    updated_at_ms: number;
+    /** Present once `status` reaches `Completed` / `Failed` / `Cancelled`. */
+    receipt?: unknown;
+    /** Aggregator parameters, decay schedule, witness committee config. */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Sealed training receipt — produced when a run reaches its terminal
+ * state. The receipt commits to the final state root, the aggregated
+ * outer-gradient sequence, the witness committee that finalized each
+ * round, and (for Confidential-tier runs) the sealed-shard manifest
+ * hash. Persisted under `CF_TRAINING_RECEIPTS`.
+ */
+export interface TrainingReceipt {
+    task_id: string;
+    final_state_root: string;
+    rounds_completed: number;
+    witness_committees: unknown[];
+    manifest_hash?: string;
+    sealed_at_ms: number;
+    [k: string]: unknown;
+}
+/**
+ * Confidential-tier sealed-shard manifest. Each envelope wraps one
+ * trainer's encrypted shard along with the HPKE-wrapped data key and
+ * the enclave attestation the sponsor sealed to.
+ */
+export interface SealedDatasetManifest {
+    task_id: string;
+    manifest_hash: string;
+    envelopes: SealedShardEnvelope[];
+    created_at_ms: number;
+    [k: string]: unknown;
+}
+export interface SealedShardEnvelope {
+    trainer_did: string;
+    shard_index: number;
+    shard_ciphertext_hash: string;
+    shard_ciphertext_bytes: number;
+    wrapped_data_key: string;
+    /** Always `"hpke-x25519-hkdf-sha256-aes-256-gcm"`. */
+    wrap_alg: string;
+    enclave_pubkey: string;
+    enclave_measurements_hex: string;
+    created_at_ms: number;
+}
+export interface ListTrainingRunsResult {
+    runs: TrainingRun[];
+}
+/**
+ * Read-only client for the Tenzro Train protocol-side run state —
+ * the surface operators / dashboards / analytics use to inspect
+ * in-flight runs, fetch sealed receipts, and audit Confidential-tier
+ * sealed-shard manifests.
+ *
+ * Backed by the `tenzro_training_listRuns` / `tenzro_training_getRun` /
+ * `tenzro_training_getReceipt` / `tenzro_training_getSealedManifest`
+ * RPCs. Write-side endpoints (`postTask`, `enrollTrainer`,
+ * `submitOuterGradient`, `finalizeRound`, `installSealedManifest`)
+ * live in a future write-side client — this read client is safe to
+ * expose to monitoring agents that should never mutate state.
+ */
+export declare class TrainingInspectionClient {
+    private rpc;
+    constructor(rpc: RpcClient);
+    /** List every active training run this node is syncing. */
+    listRuns(): Promise<ListTrainingRunsResult>;
+    /**
+     * Look up a single training run by `task_id`. Throws JSON-RPC
+     * `-32602` if the run is unknown — callers that want a nullable
+     * result should catch and translate.
+     */
+    getRun(taskId: string): Promise<TrainingRun>;
+    /**
+     * Fetch the sealed receipt for a finalized run. Returns `null`
+     * when the run is still active (no receipt has been written yet).
+     */
+    getReceipt(taskId: string): Promise<TrainingReceipt | null>;
+    /**
+     * Fetch the installed sealed-shard manifest for a Confidential-tier
+     * task. Returns `null` when no manifest has been installed (Open
+     * and Verified tiers never have a manifest).
+     */
+    getSealedManifest(taskId: string): Promise<SealedDatasetManifest | null>;
+}
+//# sourceMappingURL=training.d.ts.map

package/dist/training.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"training.d.ts","sourceRoot":"","sources":["../src/training.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAElC;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GACzB,SAAS,GACT,QAAQ,GACR,WAAW,GACX,QAAQ,GACR,WAAW,CAAC;AAEhB;;;;;;;GAOG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,0EAA0E;IAC1E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,OAAO,EAAE,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,mBAAmB,EAAE,CAAC;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,gBAAgB,EAAE,MAAM,CAAC;IACzB,sDAAsD;IACtD,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,wBAAwB,EAAE,MAAM,CAAC;IACjC,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,WAAW,EAAE,CAAC;CACrB;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,wBAAwB;IACvB,OAAO,CAAC,GAAG;gBAAH,GAAG,EAAE,SAAS;IAElC,2DAA2D;IACrD,QAAQ,IAAI,OAAO,CAAC,sBAAsB,CAAC;IAIjD;;;;OAIG;IACG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAIlD;;;OAGG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAIjE;;;;OAIG;IACG,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC;CAK/E"}

package/dist/training.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TrainingInspectionClient = void 0;
+/**
+ * Read-only client for the Tenzro Train protocol-side run state —
+ * the surface operators / dashboards / analytics use to inspect
+ * in-flight runs, fetch sealed receipts, and audit Confidential-tier
+ * sealed-shard manifests.
+ *
+ * Backed by the `tenzro_training_listRuns` / `tenzro_training_getRun` /
+ * `tenzro_training_getReceipt` / `tenzro_training_getSealedManifest`
+ * RPCs. Write-side endpoints (`postTask`, `enrollTrainer`,
+ * `submitOuterGradient`, `finalizeRound`, `installSealedManifest`)
+ * live in a future write-side client — this read client is safe to
+ * expose to monitoring agents that should never mutate state.
+ */
+class TrainingInspectionClient {
+    rpc;
+    constructor(rpc) {
+        this.rpc = rpc;
+    }
+    /** List every active training run this node is syncing. */
+    async listRuns() {
+        return this.rpc.call("tenzro_training_listRuns", []);
+    }
+    /**
+     * Look up a single training run by `task_id`. Throws JSON-RPC
+     * `-32602` if the run is unknown — callers that want a nullable
+     * result should catch and translate.
+     */
+    async getRun(taskId) {
+        return this.rpc.call("tenzro_training_getRun", [{ task_id: taskId }]);
+    }
+    /**
+     * Fetch the sealed receipt for a finalized run. Returns `null`
+     * when the run is still active (no receipt has been written yet).
+     */
+    async getReceipt(taskId) {
+        return this.rpc.call("tenzro_training_getReceipt", [{ task_id: taskId }]);
+    }
+    /**
+     * Fetch the installed sealed-shard manifest for a Confidential-tier
+     * task. Returns `null` when no manifest has been installed (Open
+     * and Verified tiers never have a manifest).
+     */
+    async getSealedManifest(taskId) {
+        return this.rpc.call("tenzro_training_getSealedManifest", [
+            { task_id: taskId },
+        ]);
+    }
+}
+exports.TrainingInspectionClient = TrainingInspectionClient;
+//# sourceMappingURL=training.js.map

package/dist/training.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"training.js","sourceRoot":"","sources":["../src/training.ts"],"names":[],"mappings":";;;AAmFA;;;;;;;;;;;;GAYG;AACH,MAAa,wBAAwB;IACf;IAApB,YAAoB,GAAc;QAAd,QAAG,GAAH,GAAG,CAAW;IAAG,CAAC;IAEtC,2DAA2D;IAC3D,KAAK,CAAC,QAAQ;QACZ,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,0BAA0B,EAAE,EAAE,CAAC,CAAC;IACvD,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAM,CAAC,MAAc;QACzB,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,wBAAwB,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IACxE,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,UAAU,CAAC,MAAc;QAC7B,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,4BAA4B,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IAC5E,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,iBAAiB,CAAC,MAAc;QACpC,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,mCAAmC,EAAE;YACxD,EAAE,OAAO,EAAE,MAAM,EAAE;SACpB,CAAC,CAAC;IACL,CAAC;CACF;AAnCD,4DAmCC"}