aira-sdk 0.4.0 → 1.0.0

package/README.md

@@ -1,11 +1,9 @@
-# Aira TypeScript SDK
-
-**AI governance infrastructure.**
+# Aira TypeScript SDK — The authorization and audit layer for AI agents.
 
 [![npm version](https://img.shields.io/npm/v/aira-sdk.svg)](https://www.npmjs.com/package/aira-sdk)
 [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
 
-Policies evaluate every agent action. Humans approve high-stakes decisions. Cryptographic receipts prove it all. Rules, AI, and multi-model consensus govern what your agents can do — with Ed25519 signatures, RFC 3161 timestamps, and W3C DID identity. Built for EU AI Act, SR 11-7, and GDPR compliance.
+Drop Aira into your agent stack in one line. Define policies without changing code. Get cryptographic proof of every decision — for your auditors, your board, or a court. Not because regulation requires it. Because your agents are acting in production right now.
 
 ```bash
 npm install aira-sdk

package/dist/client.js

@@ -10,7 +10,7 @@ const MAX_DETAILS_LENGTH = 50_000;
 function buildBody(obj) {
     return Object.fromEntries(Object.entries(obj).filter(([, v]) => v !== undefined && v !== null));
 }
-function sanitizeDetails(text) {
+function truncateDetails(text) {
     return text.length > MAX_DETAILS_LENGTH ? text.slice(0, MAX_DETAILS_LENGTH) + "...[truncated]" : text;
 }
 class Aira {
@@ -69,9 +69,17 @@ class Aira {
         return this.request("POST", path, body);
     }
     put(path, body) {
+        if (this.queue) {
+            const qid = this.queue.enqueue("PUT", path, body);
+            return Promise.resolve({ _offline: true, _queue_id: qid });
+        }
         return this.request("PUT", path, body);
     }
     del(path) {
+        if (this.queue) {
+            const qid = this.queue.enqueue("DELETE", path, {});
+            return Promise.resolve({ _offline: true, _queue_id: qid });
+        }
         return this.request("DELETE", path);
     }
     paginated(data) {
@@ -82,7 +90,7 @@ class Aira {
     async notarize(params) {
         const body = buildBody({
             action_type: params.actionType,
-            details: sanitizeDetails(params.details),
+            details: truncateDetails(params.details),
             agent_id: params.agentId,
             agent_version: params.agentVersion,
             model_id: params.modelId,

package/dist/extras/mcp.js

@@ -12,6 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getTools = getTools;
 exports.handleToolCall = handleToolCall;
 exports.createServer = createServer;
+const types_1 = require("../types");
 /** MCP tool definitions exposed by the Aira server. */
 function getTools() {
     return [
@@ -138,7 +139,10 @@ async function handleToolCall(client, name, args) {
         return [{ type: "text", text: JSON.stringify({ error: `Unknown tool: ${name}` }) }];
     }
     catch (e) {
-        return [{ type: "text", text: JSON.stringify({ error: String(e) }) }];
+        if (e instanceof types_1.AiraError) {
+            return [{ type: "text", text: JSON.stringify({ error: e.message, code: e.code }) }];
+        }
+        return [{ type: "text", text: JSON.stringify({ error: "Internal error", code: "SDK_ERROR" }) }];
     }
 }
 /**

package/dist/types.d.ts

@@ -1,10 +1,10 @@
 /** Cryptographic receipt from notarizing an action. */
 export interface ActionReceipt {
     action_id: string;
-    receipt_id: string;
-    payload_hash: string;
-    signature: string;
-    timestamp_token: string | null;
+    receipt_id?: string;
+    payload_hash?: string;
+    signature?: string;
+    timestamp_token?: string | null;
     created_at: string;
     request_id: string;
     status?: string;
@@ -71,6 +71,7 @@ export interface AgentVersion {
     changelog: string | null;
     status: string;
     published_at: string | null;
+    created_at: string;
 }
 /** Sealed evidence package. */
 export interface EvidencePackage {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "aira-sdk",
-  "version": "0.4.0",
-  "description": "TypeScript SDK for Aira — AI governance infrastructure",
+  "version": "1.0.0",
+  "description": "The authorization and audit layer for AI agents",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {