zanii-connect 0.1.1 → 0.2.1

package/README.md

@@ -25,6 +25,10 @@ const nc = new ZaniiClient({ apiKey: "nsk_..." });
 const nc = new ZaniiClient();
 await nc.login("info@zanii.agency", "password");
 
+// Or with a bearer token you already hold — a vault session JWT, or a Zanii ID
+// access token minted for the vault resource (aud = https://vault.zanii.agency/mcp):
+const nc = new ZaniiClient({ token: "..." });
+
 console.log((await nc.me()).organization.name);
 
 // Connect a provider (open the returned URL in a browser to complete OAuth):
@@ -49,7 +53,7 @@ const result = await nc.waitForJob(job.job_id, 300);
 
 - **Retries**: 429/502/503/504 are retried up to 3 times with exponential backoff.
 - **Idempotency**: pass `{ idempotencyKey }` to `execute()` to make retries safe for side-effecting actions.
-- **Errors**: non-2xx responses throw `ZaniiError` with `.statusCode` and `.detail`.
+- **Errors**: non-2xx responses throw `ZaniiError` with `.statusCode` and `.detail`. A failed tool call's `.detail` is the provider's real message (e.g. `provider 404: Requested entity was not found.`), never empty.
 - **MCP**: AI agents that speak MCP don't need this SDK — point them at
   `POST https://vault.zanii.agency/api/v1/mcp` with an `X-API-Key` header.
 
@@ -65,7 +69,8 @@ Mirrors the Python SDK (`sdk/python`), camelCased — covers the full API:
 - **Execution**: `execute`, `executeAsync`, `job`, `waitForJob` · approvals (`approvals`, `approve`)
 - **Browser sandbox**: `createBrowserSession`, `browserSession`, `browserRun`, `browserRunAsync`
 - **Secrets / automation**: `secrets`, `setSecret`, `deleteSecret`, triggers, webhook subscriptions
-- **Observability**: `executions`, `audit`, `auditExportCsv`, `health`
+- **Observability**: `executions` (each row carries `receipt_hash` + `proof_url`), `audit`, `auditExportCsv`, `health`
+- **Proof-of-action**: `receiptsBundle` (offline-verifiable audit bundle), `complianceReport` (json/markdown)
 
 ## License
 

package/dist/index.d.ts

@@ -158,4 +158,14 @@ export declare class ZaniiClient {
     }): Promise<any>;
     /** Full audit log as CSV text. */
     auditExportCsv(): Promise<string>;
+    /**
+     * The platform's audit bundle from the transparency log + this org's receipt
+     * hashes. Verify offline with @zanii/core verifyAuditBundle.
+     */
+    receiptsBundle(): Promise<any>;
+    /**
+     * Auditor-ready report over the cryptographically verified audit bundle.
+     * format "markdown" returns text; "json" returns the structured report.
+     */
+    complianceReport(format?: "json" | "markdown"): Promise<any>;
 }

package/dist/index.js

@@ -386,4 +386,22 @@ export class ZaniiClient {
     auditExportCsv() {
         return this.req("GET", "/audit/export", { raw: true });
     }
+    // -- proof-of-action (Zanii transparency ledger) ---------------------------
+    /**
+     * The platform's audit bundle from the transparency log + this org's receipt
+     * hashes. Verify offline with @zanii/core verifyAuditBundle.
+     */
+    receiptsBundle() {
+        return this.req("GET", "/org/receipts/bundle");
+    }
+    /**
+     * Auditor-ready report over the cryptographically verified audit bundle.
+     * format "markdown" returns text; "json" returns the structured report.
+     */
+    complianceReport(format = "json") {
+        return this.req("GET", "/org/compliance-report", {
+            params: { format },
+            raw: format === "markdown",
+        });
+    }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zanii-connect",
-  "version": "0.1.1",
+  "version": "0.2.1",
   "description": "TypeScript SDK for Zanii Connect — OAuth connections and tool execution for AI agents",
   "type": "module",
   "main": "./dist/index.js",
@@ -11,7 +11,11 @@
       "import": "./dist/index.js"
     }
   },
-  "files": ["dist", "README.md", "LICENSE"],
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
   "keywords": [
     "zanii",
     "oauth",
@@ -25,7 +29,9 @@
   "bugs": {
     "email": "info@zanii.agency"
   },
-  "engines": { "node": ">=18" },
+  "engines": {
+    "node": ">=18"
+  },
   "scripts": {
     "build": "tsc",
     "prepublishOnly": "tsc"