atp-sdk 1.2.2 → 1.2.5

package/README.md

@@ -16,11 +16,15 @@ ATP provides universal quantum-safe security for all AI agent protocols (MCP, Sw
 
 ### Option 1: Scaffold with Onboarding Dashboard
 
+Use the [`create-atp-agent`](https://www.npmjs.com/package/create-atp-agent) CLI (ESM-first template, Node 18+):
+
 ```bash
-npx create-atp-agent
+npx create-atp-agent my-agent
 ```
 
-Scaffolds your project and opens an embedded onboarding dashboard at `http://localhost:3456` with a step-by-step wizard for runtime, security profile, and identity configuration.
+This creates `my-agent/` with `atp-sdk`, starter agent code, and `.atp.json` for the profile you pick. After scaffolding, the CLI starts an embedded onboarding UI at **`http://127.0.0.1:3456`** (or the next free port) and opens your browser. Flags: `--no-dashboard`, `--dashboard-only`, `--no-open` (or `CREATE_ATP_AGENT_NO_OPEN=1`). The local UI uses a **mock** onboard API for demos; wire real ATP services in your own app.
+
+For the hosted marketing site and full product UI, see **[agenttrustprotocol.com](https://agenttrustprotocol.com)** (including the web wizard at `/onboard/agent` in this repo’s Next.js app).
 
 ### Option 2: Install the SDK Directly
 
@@ -30,16 +34,20 @@ npm install atp-sdk
 
 ```typescript
 import { Agent } from 'atp-sdk';
-await Agent.quickstart('MyBot');
+const agent = await Agent.quickstart('MyBot');
+console.log('Standalone:', agent.isStandalone());
 // ⚡ MyBot ready!
 //   DID:          did:atp:a1b2c3...
 //   Quantum-safe: yes
-//   Mode:         standalone (local)
+//   Standalone:   true
 ```
 
 One line. Auto-prints DID, quantum-safe status, and connection mode. Need the agent reference? Use `const agent = await Agent.quickstart('MyBot')`. Need silent creation for library use? Use `Agent.create('MyBot')` instead.
 
 **That's it!** Your agent now has:
+
+> 📌 Image guidance: any screenshots, badges, or marketing assets should feature the ATP shield logo for consistent branding.
+
 - ✅ Quantum-safe cryptography (hybrid Ed25519 + ML-DSA)
 - ✅ Decentralized Identity (DID)
 - ✅ Cryptographic signatures
@@ -1093,7 +1101,8 @@ This project is licensed under the Apache-2.0 License - see the [LICENSE](LICENS
 - [x] **v1.1.0** - Payment Protocols (AP2 & ACP) Integration
 - [x] **v1.2.0** - Zero-Knowledge Proof Authentication (Agent-to-Agent)
 - [x] **v1.2.1** - Security Profiles & Onboarding (profile-based action gating, CLI/web onboarding wizard)
-- [x] **v1.2.2** - Standalone Mode & Embedded Dashboard (offline-first agents, `npx create-atp-agent` with browser-based onboarding)
+- [x] **v1.2.2** - Standalone Mode & Embedded Dashboard (offline-first agents, `npx create-atp-agent <project>` with browser-based local onboarding UI)
+- [x] **v1.2.4** - Documentation: npm README aligned with `create-atp-agent` (ESM, flags, mock onboard UI vs [agenttrustprotocol.com](https://agenttrustprotocol.com) web wizard)
 - [ ] **v1.3.0** - WebAssembly support for browser environments
 - [ ] **v1.4.0** - GraphQL API support
 - [ ] **v2.0.0** - ATP Protocol v2 compatibility

package/dist/client/registry.d.ts

@@ -0,0 +1,70 @@
+import { BaseClient } from './base.js';
+import { ATPConfig, ATPResponse } from '../types.js';
+/** Agent record stored in the ATP registry */
+export interface AgentRecord {
+    did: string;
+    name: string;
+    runtime: string;
+    environment: string;
+    status: 'pending' | 'active' | 'suspended' | 'deactivated';
+    trustScore: number;
+    trustLevel: string;
+    profileId: string | null;
+    profileName: string | null;
+    policyComplianceStatus: 'pending' | 'compliant' | 'violation' | 'suspended';
+    creator: string | null;
+    workspace: string | null;
+    model: string | null;
+    agentVersion: string | null;
+    permissions: Record<string, unknown>;
+    isQuantumSafe: boolean;
+    totalViolations: number;
+    totalInteractions: number;
+    lastViolationAt: string | null;
+    registeredAt: string | null;
+    lastEventAt: string | null;
+    updatedAt: string;
+}
+export interface RegisterAgentRequest {
+    did: string;
+    name: string;
+    runtime: string;
+    environment: string;
+    profileId?: string;
+    creator?: string;
+    workspace?: string;
+    model?: string;
+    agentVersion?: string;
+    isQuantumSafe?: boolean;
+}
+export interface UpdateAgentRequest {
+    name?: string;
+    model?: string;
+    agentVersion?: string;
+    environment?: string;
+    permissions?: Record<string, unknown>;
+}
+export declare class RegistryClient extends BaseClient {
+    constructor(config: ATPConfig);
+    /** Register a new agent in the ATP registry */
+    registerAgent(request: RegisterAgentRequest): Promise<ATPResponse<AgentRecord>>;
+    /** Get a single agent by DID */
+    getAgent(did: string): Promise<ATPResponse<AgentRecord>>;
+    /** List all registered agents, optionally filtered */
+    listAgents(filters?: {
+        status?: string;
+        runtime?: string;
+        workspace?: string;
+        trustLevel?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<ATPResponse<{
+        agents: AgentRecord[];
+        total: number;
+    }>>;
+    /** Update an agent's metadata */
+    updateAgent(did: string, request: UpdateAgentRequest): Promise<ATPResponse<AgentRecord>>;
+    /** Deactivate an agent */
+    deactivateAgent(did: string, reason?: string): Promise<ATPResponse<AgentRecord>>;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/client/registry.d.ts.map

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

package/dist/client/registry.js

@@ -0,0 +1,41 @@
+import { BaseClient } from './base.js';
+export class RegistryClient extends BaseClient {
+    constructor(config) {
+        super(config, 'identity');
+    }
+    /** Register a new agent in the ATP registry */
+    async registerAgent(request) {
+        return this.post('/registry/agents', request);
+    }
+    /** Get a single agent by DID */
+    async getAgent(did) {
+        return this.get(`/registry/agents/${encodeURIComponent(did)}`);
+    }
+    /** List all registered agents, optionally filtered */
+    async listAgents(filters) {
+        const params = new URLSearchParams();
+        if (filters?.status)
+            params.set('status', filters.status);
+        if (filters?.runtime)
+            params.set('runtime', filters.runtime);
+        if (filters?.workspace)
+            params.set('workspace', filters.workspace);
+        if (filters?.trustLevel)
+            params.set('trustLevel', filters.trustLevel);
+        if (filters?.limit)
+            params.set('limit', String(filters.limit));
+        if (filters?.offset)
+            params.set('offset', String(filters.offset));
+        const qs = params.toString() ? `?${params.toString()}` : '';
+        return this.get(`/registry/agents${qs}`);
+    }
+    /** Update an agent's metadata */
+    async updateAgent(did, request) {
+        return this.patch(`/registry/agents/${encodeURIComponent(did)}`, request);
+    }
+    /** Deactivate an agent */
+    async deactivateAgent(did, reason) {
+        return this.post(`/registry/agents/${encodeURIComponent(did)}/deactivate`, { reason });
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/client/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/client/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAmDvC,MAAM,OAAO,cAAe,SAAQ,UAAU;IAC5C,YAAY,MAAiB;QAC3B,KAAK,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC5B,CAAC;IAED,+CAA+C;IAC/C,KAAK,CAAC,aAAa,CAAC,OAA6B;QAC/C,OAAO,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC;IAChD,CAAC;IAED,gCAAgC;IAChC,KAAK,CAAC,QAAQ,CAAC,GAAW;QACxB,OAAO,IAAI,CAAC,GAAG,CAAC,oBAAoB,kBAAkB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,sDAAsD;IACtD,KAAK,CAAC,UAAU,CAAC,OAOhB;QACC,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QACrC,IAAI,OAAO,EAAE,MAAM;YAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAC1D,IAAI,OAAO,EAAE,OAAO;YAAE,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QAC7D,IAAI,OAAO,EAAE,SAAS;YAAE,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QACnE,IAAI,OAAO,EAAE,UAAU;YAAE,MAAM,CAAC,GAAG,CAAC,YAAY,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;QACtE,IAAI,OAAO,EAAE,KAAK;YAAE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QAC/D,IAAI,OAAO,EAAE,MAAM;YAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;QAClE,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5D,OAAO,IAAI,CAAC,GAAG,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,iCAAiC;IACjC,KAAK,CAAC,WAAW,CAAC,GAAW,EAAE,OAA2B;QACxD,OAAO,IAAI,CAAC,KAAK,CAAC,oBAAoB,kBAAkB,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IAC5E,CAAC;IAED,0BAA0B;IAC1B,KAAK,CAAC,eAAe,CAAC,GAAW,EAAE,MAAe;QAChD,OAAO,IAAI,CAAC,IAAI,CAAC,oBAAoB,kBAAkB,CAAC,GAAG,CAAC,aAAa,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IACzF,CAAC;CACF"}