a1-ai 2.8.0

package/dist/esm/swarm.d.ts

@@ -0,0 +1,78 @@
+/**
+ * a1 swarm — SwarmPassport TypeScript client.
+ *
+ * ```typescript
+ * import { SwarmClient, SwarmRole } from '@a1/sdk/swarm';
+ *
+ * const swarm = new SwarmClient('http://localhost:8080', { adminSecret: process.env.A1_ADMIN_SECRET });
+ *
+ * const swarmId = await swarm.createSwarm({
+ *   name: 'acme-trading-swarm',
+ *   capabilities: ['trade.equity', 'portfolio.read'],
+ *   ttlDays: 30,
+ *   signingKeyHex: ROOT_SK_HEX,
+ * });
+ *
+ * const member = await swarm.addMember({
+ *   swarmId,
+ *   agentPkHex: WORKER_PK,
+ *   role: SwarmRole.Worker,
+ *   capabilities: ['trade.equity'],
+ *   ttlSeconds: 3600,
+ *   signingKeyHex: ROOT_SK_HEX,
+ * });
+ * ```
+ */
+export declare enum SwarmRole {
+    Orchestrator = "orchestrator",
+    Worker = "worker",
+    Supervisor = "supervisor",
+    Auditor = "auditor"
+}
+export interface SwarmMemberInfo {
+    agentDid: string;
+    agentPkHex: string;
+    role: string;
+    issuedAtUnix: number;
+    expiresAtUnix: number;
+    certFingerprintHex?: string;
+}
+export interface CreateSwarmOptions {
+    name: string;
+    capabilities: string[];
+    ttlDays?: number;
+    signingKeyHex: string;
+}
+export interface AddMemberOptions {
+    swarmId: string;
+    agentPkHex: string;
+    role: SwarmRole | string;
+    capabilities: string[];
+    ttlSeconds?: number;
+    signingKeyHex: string;
+}
+export interface GetChainOptions {
+    swarmId: string;
+    agentPkHex: string;
+    ttlSeconds?: number;
+    signingKeyHex: string;
+}
+export declare class SwarmError extends Error {
+    readonly code: string;
+    constructor(message: string, code?: string);
+}
+export declare class SwarmClient {
+    private readonly base;
+    private readonly headers;
+    constructor(gatewayUrl: string, opts?: {
+        adminSecret?: string;
+    });
+    createSwarm(opts: CreateSwarmOptions): Promise<string>;
+    addMember(opts: AddMemberOptions): Promise<SwarmMemberInfo>;
+    getChain(opts: GetChainOptions): Promise<Record<string, unknown>>;
+    listMembers(swarmId: string): Promise<SwarmMemberInfo[]>;
+    removeMember(swarmId: string, agentDid: string): Promise<void>;
+    private post;
+    private get;
+}
+//# sourceMappingURL=swarm.d.ts.map

package/dist/esm/swarm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swarm.d.ts","sourceRoot":"","sources":["../../src/swarm.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,oBAAY,SAAS;IACnB,YAAY,iBAAiB;IAC7B,MAAM,WAAW;IACjB,UAAU,eAAe;IACzB,OAAO,YAAY;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,SAAS,GAAG,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,UAAW,SAAQ,KAAK;aACU,IAAI;gBAArC,OAAO,EAAE,MAAM,EAAkB,IAAI,SAAgB;CAIlE;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;gBAErC,UAAU,EAAE,MAAM,EAAE,IAAI,GAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAO;IAQ7D,WAAW,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC;IAUtD,SAAS,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;IAoB3D,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IASjE,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAYxD,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAItD,IAAI;YAWJ,GAAG;CAQlB"}

package/dist/esm/swarm.js

@@ -0,0 +1,120 @@
+/**
+ * a1 swarm — SwarmPassport TypeScript client.
+ *
+ * ```typescript
+ * import { SwarmClient, SwarmRole } from '@a1/sdk/swarm';
+ *
+ * const swarm = new SwarmClient('http://localhost:8080', { adminSecret: process.env.A1_ADMIN_SECRET });
+ *
+ * const swarmId = await swarm.createSwarm({
+ *   name: 'acme-trading-swarm',
+ *   capabilities: ['trade.equity', 'portfolio.read'],
+ *   ttlDays: 30,
+ *   signingKeyHex: ROOT_SK_HEX,
+ * });
+ *
+ * const member = await swarm.addMember({
+ *   swarmId,
+ *   agentPkHex: WORKER_PK,
+ *   role: SwarmRole.Worker,
+ *   capabilities: ['trade.equity'],
+ *   ttlSeconds: 3600,
+ *   signingKeyHex: ROOT_SK_HEX,
+ * });
+ * ```
+ */
+export var SwarmRole;
+(function (SwarmRole) {
+    SwarmRole["Orchestrator"] = "orchestrator";
+    SwarmRole["Worker"] = "worker";
+    SwarmRole["Supervisor"] = "supervisor";
+    SwarmRole["Auditor"] = "auditor";
+})(SwarmRole || (SwarmRole = {}));
+export class SwarmError extends Error {
+    code;
+    constructor(message, code = 'SWARM_ERROR') {
+        super(message);
+        this.code = code;
+        this.name = 'SwarmError';
+    }
+}
+export class SwarmClient {
+    base;
+    headers;
+    constructor(gatewayUrl, opts = {}) {
+        this.base = gatewayUrl.replace(/\/$/, '');
+        this.headers = {
+            'Content-Type': 'application/json',
+            ...(opts.adminSecret ? { Authorization: `Bearer ${opts.adminSecret}` } : {}),
+        };
+    }
+    async createSwarm(opts) {
+        const data = await this.post('/v1/swarm/create', {
+            swarm_name: opts.name,
+            capabilities: opts.capabilities,
+            ttl_days: opts.ttlDays ?? 30,
+            signing_key_hex: opts.signingKeyHex,
+        });
+        return data.swarm_id;
+    }
+    async addMember(opts) {
+        const data = await this.post('/v1/swarm/member/add', {
+            swarm_id: opts.swarmId,
+            agent_pk_hex: opts.agentPkHex,
+            role: typeof opts.role === 'string' ? opts.role : opts.role,
+            capabilities: opts.capabilities,
+            ttl_seconds: opts.ttlSeconds ?? 3600,
+            signing_key_hex: opts.signingKeyHex,
+        });
+        const m = data.member;
+        return {
+            agentDid: m.agent_did,
+            agentPkHex: m.agent_pk_hex,
+            role: m.role,
+            issuedAtUnix: m.issued_at_unix,
+            expiresAtUnix: m.expires_at_unix,
+            certFingerprintHex: m.cert_fingerprint_hex,
+        };
+    }
+    async getChain(opts) {
+        return this.post('/v1/swarm/member/chain', {
+            swarm_id: opts.swarmId,
+            agent_pk_hex: opts.agentPkHex,
+            ttl_seconds: opts.ttlSeconds ?? 3600,
+            signing_key_hex: opts.signingKeyHex,
+        });
+    }
+    async listMembers(swarmId) {
+        const data = await this.get(`/v1/swarm/${swarmId}/members`);
+        return (data.members ?? []).map(m => ({
+            agentDid: m.agent_did,
+            agentPkHex: m.agent_pk_hex,
+            role: m.role,
+            issuedAtUnix: m.issued_at_unix,
+            expiresAtUnix: m.expires_at_unix,
+            certFingerprintHex: m.cert_fingerprint_hex,
+        }));
+    }
+    async removeMember(swarmId, agentDid) {
+        await this.post('/v1/swarm/member/remove', { swarm_id: swarmId, agent_did: agentDid });
+    }
+    async post(path, body) {
+        const resp = await fetch(`${this.base}${path}`, {
+            method: 'POST', headers: this.headers, body: JSON.stringify(body),
+        });
+        if (!resp.ok) {
+            const err = await resp.json().catch(() => ({ error: resp.statusText }));
+            throw new SwarmError(err.error ?? resp.statusText);
+        }
+        return resp.json();
+    }
+    async get(path) {
+        const resp = await fetch(`${this.base}${path}`, { headers: this.headers });
+        if (!resp.ok) {
+            const err = await resp.json().catch(() => ({ error: resp.statusText }));
+            throw new SwarmError(err.error ?? resp.statusText);
+        }
+        return resp.json();
+    }
+}
+//# sourceMappingURL=swarm.js.map

package/dist/esm/swarm.js.map

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

package/package.json

@@ -0,0 +1,112 @@
+{
+  "name": "a1-ai",
+  "version": "2.8.0",
+  "description": "TypeScript/Node.js client for A1: cryptographic identity and authorization for AI agents",
+  "author": "dyolo <dyologician@users.noreply.github.com>",
+  "license": "MIT OR Apache-2.0",
+  "homepage": "https://github.com/dyologician/a1",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dyologician/a1.git"
+  },
+  "keywords": [
+    "ai-agents",
+    "delegation",
+    "authorization",
+    "cryptography",
+    "langchain",
+    "langgraph",
+    "openai",
+    "autogen",
+    "crewai",
+    "semantic-kernel",
+    "zero-knowledge",
+    "ed25519"
+  ],
+  "bugs": {
+    "url": "https://github.com/dyologician/a1/issues"
+  },
+  "sideEffects": false,
+  "type": "module",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/cjs/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/esm/index.d.ts",
+        "default": "./dist/esm/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/index.d.ts",
+        "default": "./dist/cjs/index.js"
+      }
+    },
+    "./integrations": {
+      "import": {
+        "types": "./dist/esm/integrations.d.ts",
+        "default": "./dist/esm/integrations.js"
+      },
+      "require": {
+        "types": "./dist/cjs/integrations.d.ts",
+        "default": "./dist/cjs/integrations.js"
+      }
+    },
+    "./passport": {
+      "import": {
+        "types": "./dist/esm/passport.d.ts",
+        "default": "./dist/esm/passport.js"
+      },
+      "require": {
+        "types": "./dist/cjs/passport.d.ts",
+        "default": "./dist/cjs/passport.js"
+      }
+    },
+    "./middleware": {
+      "import": {
+        "types": "./dist/esm/middleware.d.ts",
+        "default": "./dist/esm/middleware.js"
+      },
+      "require": {
+        "types": "./dist/cjs/middleware.d.ts",
+        "default": "./dist/cjs/middleware.js"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build:esm": "tsc -p tsconfig.esm.json",
+    "build:cjs": "tsc -p tsconfig.cjs.json",
+    "build": "npm run build:esm && npm run build:cjs",
+    "test": "jest",
+    "test:coverage": "jest --coverage",
+    "prepublishOnly": "npm run build && npm run test"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@jest/globals": "^29.7.0",
+    "@types/jest": "^29.5.12",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.1.4",
+    "typescript": "^5.4.0",
+    "ts-node": "^10.9.2"
+  },
+  "optionalDependencies": {
+    "@noble/ed25519": "^2.1.0"
+  },
+  "peerDependencies": {
+    "@noble/ed25519": "^2.1.0"
+  },
+  "peerDependenciesMeta": {
+    "@noble/ed25519": {
+      "optional": true
+    }
+  }
+}