aira-sdk 0.3.0 → 0.3.1

package/README.md

@@ -64,7 +64,7 @@ import { Aira } from "aira-sdk";
 import { AiraCallbackHandler } from "aira-sdk/extras/langchain";
 
 const aira = new Aira({ apiKey: "aira_live_xxx" });
-const handler = new AiraCallbackHandler({ client: aira, agentId: "research-agent", modelId: "gpt-4o" });
+const handler = new AiraCallbackHandler({ client: aira, agentId: "research-agent", modelId: "gpt-5.2" });
 
 // Every tool call and chain completion gets a signed receipt
 const result = await chain.invoke({ input: "Analyze Q1 revenue" }, { callbacks: [handler] });
@@ -83,7 +83,7 @@ const middleware = new AiraVercelMiddleware({ client: aira, agentId: "assistant-
 
 // Wrap your Vercel AI calls — receipts at invocation and completion
 const result = await middleware.wrapGenerateText({
-  model: openai("gpt-4o"),
+  model: openai("gpt-5.2"),
   prompt: "Summarize the contract terms",
 });
 ```
@@ -196,7 +196,7 @@ Supported event types: `action.notarized`, `action.authorized`, `agent.registere
 
 ## Core SDK Methods
 
-All 56 methods on `Aira`. Every write operation produces a cryptographic receipt.
+All 52 methods on `Aira`. Every write operation produces a cryptographic receipt.
 
 | Category | Method | Description |
 |---|---|---|
@@ -224,15 +224,9 @@ All 56 methods on `Aira`. Every write operation produces a cryptographic receipt
 | | `revokeCredential()` | Revoke agent's Verifiable Credential |
 | | `requestMutualSign()` | Initiate mutual notarization with counterparty |
 | | `completeMutualSign()` | Complete mutual notarization (counterparty signs) |
-| | `getMutualSignStatus()` | Check status of a mutual sign request |
 | | `getReputation()` | Get agent reputation score and tier |
 | | `listReputationHistory()` | List reputation score history |
-| | `setEndpointPolicy()` | Set endpoint verification policy |
-| | `getEndpointPolicy()` | Get current endpoint policy |
 | | `resolveDid()` | Resolve any DID to its DID Document |
-| | `checkTrust()` | Run full trust check against a counterparty |
-| | `listCredentials()` | List all credentials for an agent |
-| | `getTrustBundle()` | Get DID + VC + reputation in one call |
 | **Cases** | `runCase()` | Multi-model consensus adjudication |
 | | `getCase()` | Retrieve case result |
 | | `listCases()` | List cases |
@@ -320,6 +314,45 @@ console.log(rep.score);  // 84
 console.log(rep.tier);   // "Verified"
 ```
 
+### Endpoint Verification
+
+Control which external APIs your agents can call. When `endpointUrl` is passed to `notarize()`, Aira checks it against your org's whitelist. Unrecognized endpoints are blocked in strict mode.
+
+#### Notarize with endpointUrl
+
+```typescript
+const receipt = await aira.notarize({
+  actionType: "api_call",
+  details: "Charged customer $49.99 for subscription renewal",
+  agentId: "billing-agent",
+  modelId: "claude-sonnet-4-6",
+  endpointUrl: "https://api.stripe.com/v1/charges",
+});
+```
+
+#### Handle ENDPOINT_NOT_WHITELISTED
+
+```typescript
+import { Aira, AiraError } from "aira-sdk";
+
+try {
+  const receipt = await aira.notarize({
+    actionType: "api_call",
+    details: "Send SMS via new provider",
+    agentId: "notifications-agent",
+    endpointUrl: "https://api.newprovider.com/v1/sms",
+  });
+} catch (e) {
+  if (e instanceof AiraError && e.code === "ENDPOINT_NOT_WHITELISTED") {
+    console.log(`Blocked: ${e.message}`);
+    console.log(`Approval request: ${e.details.approval_id}`);
+    console.log(`Suggested pattern: ${e.details.url_pattern_suggested}`);
+  } else {
+    throw e;
+  }
+}
+```
+
 ### Trust Policy in Integrations
 
 Pass a `trustPolicy` to any framework integration to run automated trust checks before agent interactions:
@@ -328,7 +361,7 @@ Pass a `trustPolicy` to any framework integration to run automated trust checks
 import { AiraCallbackHandler } from "aira-sdk/extras/langchain";
 
 const handler = new AiraCallbackHandler(aira, "research-agent", {
-  modelId: "gpt-4o",
+  modelId: "gpt-5.2",
   trustPolicy: {
     verifyCounterparty: true,    // resolve counterparty DID
     minReputation: 60,           // warn if reputation score below 60

package/dist/client.js

@@ -259,7 +259,7 @@ class Aira {
     }
     // ==================== Chat ====================
     async ask(message, params) {
-        return this.post("/chat", buildBody({ message, history: params?.history, model: params?.model }));
+        return this.post("/chat", buildBody({ message, history: params?.history, model_id: params?.model }));
     }
     // ==================== DID ====================
     /** Get full DID info for an agent. */

package/dist/types.d.ts

@@ -1,12 +1,15 @@
 /** Cryptographic receipt from notarizing an action. */
 export interface ActionReceipt {
     action_id: string;
+    receipt_id: string;
     payload_hash: string;
     signature: string;
-    receipt_id: string;
-    action_type: string;
-    agent_id: string | null;
+    timestamp_token: string | null;
     created_at: string;
+    request_id: string;
+    action_type?: string;
+    agent_id?: string | null;
+    warnings?: string[] | null;
 }
 /** Full action details including receipt and authorizations. */
 export interface ActionDetail {
@@ -66,46 +69,62 @@ export interface EvidencePackage {
     id: string;
     title: string;
     description: string | null;
+    action_ids: string[];
     package_hash: string;
     signature: string;
-    action_count: number;
+    status: string;
     created_at: string;
+    request_id: string;
+    agent_slugs?: string[] | null;
 }
 /** Compliance snapshot. */
 export interface ComplianceSnapshot {
     id: string;
     framework: string;
-    agent_slug: string | null;
-    findings: Record<string, string>;
     status: string;
+    findings: Record<string, string>;
+    snapshot_hash: string;
+    signature: string;
+    snapshot_at: string;
     created_at: string;
+    request_id: string;
+    agent_id?: string | null;
 }
 /** Escrow account. */
 export interface EscrowAccount {
     id: string;
-    status: string;
     currency: string;
     balance: string;
-    purpose: string | null;
+    status: string;
     created_at: string;
+    request_id: string;
+    agent_id?: string | null;
+    counterparty_org_id?: string | null;
+    purpose?: string | null;
+    transactions?: EscrowTransaction[];
 }
 /** Escrow transaction (deposit, release, dispute). */
 export interface EscrowTransaction {
     id: string;
     transaction_type: string;
     amount: string;
-    description: string | null;
+    currency: string;
     transaction_hash: string;
     signature: string;
+    status: string;
     created_at: string;
+    description?: string | null;
+    reference_action_id?: string | null;
 }
 /** Public verification result. */
 export interface VerifyResult {
     valid: boolean;
-    receipt_id: string | null;
-    verified_at: string;
     public_key_id: string;
     message: string;
+    verified_at: string;
+    request_id: string;
+    receipt_id?: string | null;
+    action_id?: string | null;
 }
 /** Paginated list response. */
 export interface PaginatedList<T = Record<string, unknown>> {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aira-sdk",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "TypeScript SDK for Aira — legal infrastructure for AI agents",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",