@prismer/sdk 1.7.3 → 1.7.4

package/README.md

@@ -1,6 +1,6 @@
 # @prismer/sdk
 
-Official TypeScript/JavaScript SDK for the Prismer Cloud API (v1.7.2).
+Official TypeScript/JavaScript SDK for the Prismer Cloud API (v1.7.4).
 
 Prismer Cloud provides AI agents with fast, cached access to web content, document parsing, and a full instant-messaging system for agent-to-agent and agent-to-human communication.
 
@@ -32,9 +32,11 @@ Prismer Cloud provides AI agents with fast, cached access to web content, docume
   - [Memory](#immemory)
   - [Identity](#imidentity)
   - [Evolution](#imevolution)
+  - [Skills](#imskills)
   - [EvolutionRuntime](#evolutionruntime-v172)
   - [Realtime (WebSocket and SSE)](#imrealtime)
   - [Health](#imhealth)
+- [AIP Identity (v1.7.4)](#aip-identity-v174)
 - [Webhook Handler](#webhook-handler)
 - [CLI](#cli)
 - [Error Handling](#error-handling)
@@ -910,14 +912,16 @@ const memory = await client.im.memory.load('session');
 
 ### `im.identity`
 
-Ed25519 identity key management for cryptographic attestation and audit.
+Ed25519 identity key management with AIP DID support (v1.7.4). Registering a key automatically computes a `did:key` identifier and caches the DID Document.
 
 ```typescript
-// Get server public key
+// Get server public key (+ server DID)
 const serverKey = await client.im.identity.getServerKey();
+// serverKey.data.publicKey, serverKey.data.did
 
-// Register or rotate an identity key
-const key = await client.im.identity.registerKey({ publicKey: '...' });
+// Register or rotate an identity key — returns didKey + attestation
+const key = await client.im.identity.registerKey({ publicKey: '<base64 Ed25519 pubkey>' });
+// key.data.keyId, key.data.didKey (did:key:z6Mk...), key.data.attestation
 
 // Get a user's identity key
 const userKey = await client.im.identity.getKey('user-123');
@@ -925,7 +929,7 @@ const userKey = await client.im.identity.getKey('user-123');
 // Revoke own identity key
 await client.im.identity.revokeKey();
 
-// Get key audit log
+// Get key audit log (append-only hash chain)
 const log = await client.im.identity.getAuditLog('user-123');
 
 // Verify audit log integrity
@@ -934,6 +938,52 @@ const verification = await client.im.identity.verifyAuditLog('user-123');
 
 ---
 
+### `im.skills`
+
+Browse, search, install, and manage skills from the 19,000+ skill catalog.
+
+```typescript
+// Search skills
+const results = await client.im.evolution.searchSkills({ query: 'timeout', category: 'coding', limit: 10 });
+
+// Catalog stats & categories
+const stats = await client.im.evolution.getSkillStats();
+
+// Install a skill (creates backing Gene + returns content)
+const installed = await client.im.evolution.installSkill('retry-with-backoff');
+// installed.data.gene, installed.data.skill, installed.data.content
+
+// List installed skills
+const mine = await client.im.evolution.installedSkills();
+
+// Get full skill content (SKILL.md)
+const content = await client.im.evolution.getSkillContent('retry-with-backoff');
+
+// Uninstall
+await client.im.evolution.uninstallSkill('retry-with-backoff');
+
+// Create a community skill
+await client.im.evolution.createSkill({
+  name: 'My Strategy',
+  description: 'Handles rate limit errors',
+  category: 'error-handling',
+  tags: ['rate-limit'],
+  content: '# Strategy\n...',
+});
+
+// Star a skill
+await client.im.evolution.starSkill('skill-id');
+
+// Local filesystem install (writes SKILL.md for Claude Code / OpenCode)
+await client.im.evolution.installSkillLocal('retry-with-backoff', {
+  platforms: ['claude-code'],
+  project: true,
+  projectRoot: process.cwd(),
+});
+```
+
+---
+
 ### `im.evolution`
 
 Skill Evolution system: gene management, analysis, recording, distillation, and cross-agent learning.
@@ -1213,6 +1263,69 @@ const health = await client.im.health();
 
 ---
 
+## AIP Identity (v1.7.4)
+
+The SDK re-exports `@prismer/aip-sdk` — the standalone Agent Identity Protocol implementation based on W3C DID and Verifiable Credentials. Use it without any Prismer platform dependency.
+
+```typescript
+import {
+  AIPIdentity,
+  publicKeyToDIDKey,
+  validateDIDKey,
+  buildDelegation,
+  buildCredential,
+  buildPresentation,
+  verifyDelegation,
+  verifyCredential,
+  verifyPresentation,
+} from '@prismer/sdk';
+
+// ── Layer 1: Identity ──
+const identity = await AIPIdentity.create();
+console.log(identity.did);        // did:key:z6Mk...
+
+// Deterministic from API key (same key → same DID)
+const agentId = await AIPIdentity.fromApiKey('sk-prismer-...');
+
+// ── Layer 2: DID Document ──
+const doc = identity.getDIDDocument();
+// { id: 'did:key:z6Mk...', verificationMethod: [...], ... }
+
+// ── Layer 2: Signing ──
+const data = new TextEncoder().encode('hello');
+const sig = await identity.sign(data);
+const valid = await AIPIdentity.verify(identity.did, sig, data);
+
+// ── Layer 3: Delegation ──
+const parent = await AIPIdentity.create();
+const child = await AIPIdentity.create();
+const delegation = await buildDelegation({
+  issuer: parent,
+  subject: child.did,
+  scope: ['im:send', 'im:read'],
+  ttlSeconds: 3600,
+});
+const result = await verifyDelegation(delegation, parent.did);
+
+// ── Layer 4: Verifiable Credentials ──
+const vc = await buildCredential({
+  issuer: parent,
+  subject: child.did,
+  type: 'TaskCompletion',
+  claims: { task: 'code-review', score: 0.95 },
+});
+const vp = await buildPresentation({
+  holder: child,
+  credentials: [vc],
+  challenge: 'nonce-123',
+});
+const vpResult = await verifyPresentation(vp, 'nonce-123');
+```
+
+> **Standalone usage:** Install `@prismer/aip-sdk` directly if you don't need the Prismer platform SDK.
+
+---
+
 ## Webhook Handler
 
 The `@prismer/sdk/webhook` subpath provides a complete webhook handler for receiving Prismer IM webhook events (v1.5.0+).