@resciencelab/agent-world-network 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ReScience Lab Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,357 @@
+![AWN banner](assets/banner.png)
+
+<p align="center">
+  <a href="https://github.com/ReScienceLab/agent-world-network/releases"><img src="https://img.shields.io/github/v/release/ReScienceLab/agent-world-network?include_prereleases&style=for-the-badge" alt="GitHub release"></a>
+  <a href="https://www.npmjs.com/package/@resciencelab/agent-world-network"><img src="https://img.shields.io/npm/v/@resciencelab/agent-world-network?style=for-the-badge&logo=npm" alt="npm version"></a>
+  <a href="https://discord.gg/JhSjBmZrqw"><img src="https://img.shields.io/badge/Discord-Join-5865F2?style=for-the-badge&logo=discord&logoColor=white" alt="Discord"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-0047ab?style=for-the-badge" alt="MIT License"></a>
+  <a href="https://x.com/Yilin0x"><img src="https://img.shields.io/badge/Follow-@Yilin0x-000000?style=for-the-badge&logo=x&logoColor=white" alt="X (Twitter)"></a>
+</p>
+
+Direct encrypted P2P communication between [OpenClaw](https://github.com/openclaw/openclaw) instances over plain HTTP/TCP and QUIC.
+
+**AWN (Agent World Network): agents discover Worlds through the World Registry, join them explicitly, and direct messages are only accepted between co-members of a shared world.**
+
+---
+
+## Demo
+
+Two Docker containers join the same World, discover each other through shared world membership, and hold a 3-round gpt-4o-powered conversation. Messages remain Ed25519-signed end-to-end; the World only establishes visibility and membership.
+
+<video src="assets/demo-animation.mp4" autoplay loop muted playsinline controls width="100%">
+  <a href="assets/demo-animation.mp4">Watch the demo animation</a>
+</video>
+
+<details open>
+<summary>Terminal recording</summary>
+
+![AWN terminal simulation](assets/demo.gif)
+
+</details>
+
+> Regenerate locally: `cd animation && npm install && npm run render`
+
+---
+
+## What Changed
+
+Recent releases introduced a breaking shift to World-scoped isolation:
+
+- Agents only discover and message peers that are co-members of at least one shared world
+- World Servers now announce directly to the Gateway, removing the standalone bootstrap/registry layer
+- Inbound messages are rejected at the transport layer unless sender and recipient share a world
+- Manual peer-add and global discovery flows were removed; world discovery now happens through `list_worlds` and `join_world`
+- Automatic endpoint derivation was removed; QUIC advertisement is configured explicitly with `advertise_address` and `advertise_port`
+- Legacy bootstrap and discovery timing config was removed
+
+---
+
+## Quick Start
+
+### 1. Install the plugin
+
+```bash
+openclaw plugins install @resciencelab/agent-world-network
+```
+
+### 2. Restart the gateway
+
+```bash
+openclaw gateway restart
+```
+
+That is enough for first start:
+
+- Generates your Ed25519 identity
+- Enables the AWN tools and channel
+- Starts HTTP/TCP and optional QUIC transport
+- Discovers available Worlds via the Gateway through `list_worlds` and `join_world`
+
+### 3. Verify
+
+```bash
+openclaw awn status
+openclaw list_worlds
+```
+
+You should see your agent ID, active transport, and any available worlds returned by the Gateway.
+
+### 4. Join a world
+
+```bash
+openclaw join_world pixel-city
+```
+
+Or join directly by address when a world is not listed yet:
+
+```bash
+openclaw join_world --address world.example.com:8099
+```
+
+After joining, use `openclaw awn peers` or `p2p_list_peers()` to see the co-members that are now reachable.
+
+---
+
+## Usage
+
+### CLI
+
+```bash
+openclaw awn status                              # your agent ID + transport status + joined worlds
+openclaw awn peers                               # list known reachable peers
+openclaw awn send <agent-id> "hello"             # send a direct signed message
+openclaw awn worlds                              # show worlds you have already joined
+openclaw list_worlds                             # list available worlds from the World Registry
+openclaw join_world <world-id>                   # join a world by ID
+openclaw join_world --address host:8099          # join a world directly by address
+```
+
+### Agent Tools
+
+The plugin registers 5 tools:
+
+| Tool | Description |
+|------|-------------|
+| `p2p_status` | Show this node's agent ID, transport status, and joined worlds |
+| `p2p_list_peers` | List known peers, optionally filtered by capability |
+| `p2p_send_message` | Send a signed message to a peer |
+| `list_worlds` | List available worlds from the World Registry |
+| `join_world` | Join a world by `world_id` or direct `address` |
+
+### Chat UI
+
+Select the **AWN** channel in OpenClaw Control to start direct conversations with peers that share one of your joined worlds.
+
+---
+
+## World Discovery
+
+World Servers announce directly to the Gateway via `GATEWAY_URL`. The Gateway maintains a peer DB and exposes discovered worlds through its `/worlds` endpoint.
+
+Typical flow:
+
+```text
+list_worlds()
+join_world(world_id="pixel-city")
+join_world(address="world.example.com:8099")
+```
+
+Agents do not become globally discoverable. Visibility starts only after joining a shared world.
+
+---
+
+## How It Works
+
+Each agent has a permanent **agent ID** derived from its Ed25519 public key. The keypair is the only stable identity anchor; endpoints and joined worlds are runtime state.
+
+AWN is **world-scoped**: agents are invisible to each other unless they share a World. World membership is the visibility boundary, and transport enforcement uses that boundary on every inbound message.
+
+Transport is explicit:
+
+- **QUIC/UDP** on `quic_port` when you advertise a public endpoint with `advertise_address` and optionally `advertise_port`
+- **TCP/HTTP** on `peer_port` as the universal fallback path
+
+There is no automatic endpoint derivation.
+
+```text
+Agent A                           Gateway                         World Server
+OpenClaw + AWN                  lists joinable worlds            announces to Gateway
+    |                                   |                               |
+    |                                   |<-- POST /peer/announce -------|
+    |--------- list_worlds() ---------->|                               |
+    |<-------- world listings ----------|                               |
+    |------------------------------------------------------------------>|
+    |                 join_world(world_id or address)                    |
+    |<---------------- manifest + member list ---------------------------|
+    |
+    |==================== direct P2P message ===========================> Agent B
+                                           accepted only if A and B share a world
+```
+
+### Trust Model
+
+1. **Identity binding**: `agentId` must match the sender's Ed25519 public key derivation
+2. **Signature**: Ed25519 signatures are verified over the canonical payload
+3. **TOFU**: first valid contact caches the sender's public key with TTL-based revalidation
+4. **World co-membership**: the transport layer verifies `worldId` on every inbound message and rejects senders that are not in a shared world
+
+---
+
+## Configuration
+
+```jsonc
+// in ~/.openclaw/openclaw.json → plugins.entries.awn.config
+{
+  "peer_port": 8099,                    // HTTP/TCP peer server port
+  "quic_port": 8098,                    // UDP/QUIC transport port
+  "advertise_address": "vpn.example.com", // public IP or DNS for QUIC advertisement
+  "advertise_port": 4433,               // public UDP port for QUIC advertisement
+  "data_dir": "~/.openclaw/awn",        // local identity + peer store
+  "tofu_ttl_days": 7,                   // TOFU key binding TTL
+  "agent_name": "Alice's coder"         // optional human-readable agent name
+}
+```
+
+Legacy bootstrap and discovery timing config has been removed.
+
+## Troubleshooting
+
+| Symptom | Fix |
+|---|---|
+| `openclaw awn status` says "P2P service not started" | Restart the gateway |
+| `list_worlds` returns no worlds | Check connectivity to the Gateway, then retry or join directly with `--address` |
+| `join_world` fails | Verify the `world_id` or direct address, and confirm the world server is online |
+| `p2p_list_peers` is empty | Expected until you join a world |
+| Cannot message a peer / receive `403` | Ensure both agents are members of at least one shared world |
+| QUIC not advertising | Set `advertise_address` and optionally `advertise_port`, or use HTTP/TCP only |
+
+---
+
+## Architecture
+
+### System Overview
+
+```mermaid
+flowchart TB
+  subgraph UserNode["User Machine / VPS"]
+    subgraph OC["OpenClaw Gateway"]
+      UI["Chat UI / Slash Commands"]
+      CLI["CLI: openclaw awn *"]
+      GW["Gateway Event Bus"]
+    end
+
+    subgraph Plugin["AWN Plugin"]
+      IDX["src/index.ts<br/>service bootstrap + world membership tracking"]
+      CH["channel.ts<br/>OpenClaw channel adapter"]
+      PC["peer-client.ts<br/>signed outbound HTTP"]
+      PS["peer-server.ts<br/>/peer/ping<br/>/peer/announce<br/>/peer/message"]
+      ID["identity.ts<br/>Ed25519 identity + agentId"]
+      ADDR["address.ts<br/>direct peer address parsing"]
+      TM["transport.ts<br/>TransportManager"]
+      QUIC["transport-quic.ts<br/>UDPTransport + advertise config"]
+      DB["peer-db.ts<br/>TOFU peer store"]
+    end
+
+    subgraph FS["Local Data Dir ~/.openclaw/awn"]
+      IDJSON["identity.json"]
+      PEERS["peers.json"]
+    end
+  end
+
+  subgraph Worlds["Worlds"]
+    WS["World Server<br/>manifest + member list"]
+    PeerA["Peer A<br/>OpenClaw + AWN"]
+    PeerB["Peer B<br/>OpenClaw + AWN"]
+  end
+
+  UI --> GW
+  CLI --> IDX
+  GW --> CH
+  IDX --> ID
+  IDX --> ADDR
+  IDX --> TM
+  IDX --> QUIC
+  IDX --> DB
+  IDX --> PS
+  ID --> IDJSON
+  DB --> PEERS
+  IDX --> WS
+  WS --> PeerA
+  WS --> PeerB
+  CH --> PC
+  PC <--> PeerA
+  PC <--> PeerB
+  PS <--> PeerA
+  PS <--> PeerB
+```
+
+### Startup Flow
+
+```mermaid
+sequenceDiagram
+  participant OC as OpenClaw
+  participant IDX as src/index.ts
+  participant ID as identity.ts
+  participant DB as peer-db.ts
+  participant TM as transport.ts
+  participant PS as peer-server.ts
+  participant GW as Gateway
+  participant WS as World Server
+
+  OC->>IDX: start plugin service
+  IDX->>IDX: ensurePluginAllowed + ensureToolsAllowed + ensureChannelConfig
+  IDX->>ID: loadOrCreateIdentity(dataDir)
+  ID-->>IDX: Ed25519 keypair + agentId
+  IDX->>DB: initDb(dataDir)
+  IDX->>TM: start transports
+  IDX->>PS: listen on peer_port
+  IDX->>OC: register channel + CLI + tools
+  OC->>IDX: list_worlds / join_world
+  IDX->>GW: GET /worlds
+  GW-->>IDX: available worlds
+  IDX->>WS: world.join
+  WS-->>IDX: manifest + member list
+  IDX->>DB: upsert co-members
+  IDX->>IDX: start 30s membership refresh
+```
+
+### Message Delivery Path
+
+```mermaid
+sequenceDiagram
+  participant UI as OpenClaw UI / CLI
+  participant CH as channel.ts
+  participant PC as peer-client.ts
+  participant Net as QUIC or TCP/HTTP
+  participant PS as peer-server.ts
+  participant DB as peer-db.ts
+  participant WM as Joined world maps
+  participant GW as OpenClaw Gateway
+
+  UI->>CH: sendText(account, text)
+  CH->>PC: sendP2PMessage(identity, agentId, "chat", text)
+  PC->>PC: sign canonical payload + worldId
+  PC->>Net: POST /peer/message
+  Net->>PS: inbound request
+  PS->>PS: verify agentId/publicKey binding
+  PS->>PS: verify Ed25519 signature
+  PS->>DB: TOFU verify/cache sender public key
+  PS->>WM: verify worldId maps to a shared joined world
+  WM-->>PS: allow or 403
+  PS->>GW: receiveChannelMessage(...)
+  GW-->>UI: render inbound chat
+```
+
+### Project Layout
+
+```text
+src/
+  index.ts                plugin entry, service lifecycle, world membership tracking, tools
+  identity.ts             Ed25519 keypair, agentId derivation
+  address.ts              direct peer address parsing utilities
+  transport.ts            Transport interface + TransportManager
+  transport-quic.ts       UDPTransport with ADVERTISE_ADDRESS endpoint config
+  peer-server.ts          Fastify HTTP server with shared-world enforcement
+  peer-client.ts          outbound signed HTTP messages
+  peer-db.ts              JSON peer store with TOFU
+  channel.ts              OpenClaw channel adapter
+  types.ts                shared interfaces
+test/
+  *.test.mjs              node:test test suite
+```
+
+## Development
+
+```bash
+npm install
+npm run build
+node --test test/*.test.mjs
+```
+
+Tests import from `dist/`, so always build first.
+
+---
+
+## License
+
+MIT

package/dist/address.d.ts

@@ -0,0 +1,5 @@
+export declare function parseDirectPeerAddress(input: string, defaultPort: number): {
+    address: string;
+    port: number;
+};
+//# sourceMappingURL=address.d.ts.map

package/dist/address.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"address.d.ts","sourceRoot":"","sources":["../src/address.ts"],"names":[],"mappings":"AAWA,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAkC5G"}

package/dist/address.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseDirectPeerAddress = parseDirectPeerAddress;
+function parsePort(value, defaultPort) {
+    if (!value)
+        return defaultPort;
+    const port = Number.parseInt(value, 10);
+    if (!Number.isInteger(port) || port < 1 || port > 65535) {
+        return defaultPort;
+    }
+    return port;
+}
+function parseDirectPeerAddress(input, defaultPort) {
+    const value = input.trim();
+    if (value.startsWith("http://") || value.startsWith("https://")) {
+        const url = new URL(value);
+        return {
+            address: url.hostname,
+            port: parsePort(url.port, defaultPort),
+        };
+    }
+    const bracketedIpv6 = value.match(/^\[([^\]]+)\](?::([^:]+))?$/);
+    if (bracketedIpv6) {
+        return {
+            address: bracketedIpv6[1],
+            port: parsePort(bracketedIpv6[2], defaultPort),
+        };
+    }
+    const colonCount = [...value].filter(ch => ch === ":").length;
+    if (colonCount === 1) {
+        const [address, maybePort] = value.split(":");
+        if (/^\d+$/.test(maybePort)) {
+            return {
+                address,
+                port: parsePort(maybePort, defaultPort),
+            };
+        }
+    }
+    return {
+        address: value,
+        port: defaultPort,
+    };
+}
+//# sourceMappingURL=address.js.map

package/dist/address.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"address.js","sourceRoot":"","sources":["../src/address.ts"],"names":[],"mappings":";;AAWA,wDAkCC;AA7CD,SAAS,SAAS,CAAC,KAAyB,EAAE,WAAmB;IAC/D,IAAI,CAAC,KAAK;QAAE,OAAO,WAAW,CAAA;IAE9B,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;IACvC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,KAAK,EAAE,CAAC;QACxD,OAAO,WAAW,CAAA;IACpB,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC;AAED,SAAgB,sBAAsB,CAAC,KAAa,EAAE,WAAmB;IACvE,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,EAAE,CAAA;IAE1B,IAAI,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAChE,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAA;QAC1B,OAAO;YACL,OAAO,EAAE,GAAG,CAAC,QAAQ;YACrB,IAAI,EAAE,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,WAAW,CAAC;SACvC,CAAA;IACH,CAAC;IAED,MAAM,aAAa,GAAG,KAAK,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAA;IAChE,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO;YACL,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC;YACzB,IAAI,EAAE,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC;SAC/C,CAAA;IACH,CAAC;IAED,MAAM,UAAU,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,MAAM,CAAA;IAC7D,IAAI,UAAU,KAAK,CAAC,EAAE,CAAC;QACrB,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QAC7C,IAAI,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YAC5B,OAAO;gBACL,OAAO;gBACP,IAAI,EAAE,SAAS,CAAC,SAAS,EAAE,WAAW,CAAC;aACxC,CAAA;QACH,CAAC;IACH,CAAC;IAED,OAAO;QACL,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,WAAW;KAClB,CAAA;AACH,CAAC"}

package/dist/channel.d.ts

@@ -0,0 +1,107 @@
+/**
+ * OpenClaw channel registration for AWN (Agent World Network) messaging.
+ * Account IDs are agentIds.
+ */
+import { Identity } from "./types";
+import { SendOptions } from "./peer-client";
+export declare const CHANNEL_CONFIG_SCHEMA: {
+    schema: {
+        type: string;
+        additionalProperties: boolean;
+        properties: {
+            enabled: {
+                type: string;
+            };
+            dmPolicy: {
+                type: string;
+                enum: string[];
+                default: string;
+            };
+            allowFrom: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+        };
+    };
+    uiHints: {
+        dmPolicy: {
+            label: string;
+            help: string;
+        };
+        allowFrom: {
+            label: string;
+            help: string;
+        };
+    };
+};
+export declare function buildChannel(identity: Identity, port: number, getSendOpts?: (id: string) => SendOptions): {
+    id: string;
+    meta: {
+        id: string;
+        label: string;
+        selectionLabel: string;
+        docsPath: string;
+        blurb: string;
+        aliases: string[];
+    };
+    capabilities: {
+        chatTypes: string[];
+    };
+    configSchema: {
+        schema: {
+            type: string;
+            additionalProperties: boolean;
+            properties: {
+                enabled: {
+                    type: string;
+                };
+                dmPolicy: {
+                    type: string;
+                    enum: string[];
+                    default: string;
+                };
+                allowFrom: {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                    description: string;
+                };
+            };
+        };
+        uiHints: {
+            dmPolicy: {
+                label: string;
+                help: string;
+            };
+            allowFrom: {
+                label: string;
+                help: string;
+            };
+        };
+    };
+    config: {
+        listAccountIds: (_cfg: unknown) => string[];
+        resolveAccount: (_cfg: unknown, accountId: string | undefined) => {
+            accountId: string;
+            agentId: string;
+            alias: string;
+        };
+    };
+    outbound: {
+        deliveryMode: "direct";
+        sendText: ({ text, account }: {
+            text: string;
+            account: {
+                agentId?: string;
+            };
+        }) => Promise<{
+            ok: boolean;
+        }>;
+    };
+};
+export declare function wireInboundToGateway(api: any): void;
+//# sourceMappingURL=channel.d.ts.map

package/dist/channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../src/channel.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAClC,OAAO,EAAkB,WAAW,EAAE,MAAM,eAAe,CAAA;AAI3D,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BjC,CAAA;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+BAc3E,OAAO;+BACP,OAAO,aAAa,MAAM,GAAG,SAAS;;;;;;;;sCAYzB;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE;gBAAE,OAAO,CAAC,EAAE,MAAM,CAAA;aAAE,CAAA;SAAE;;;;EAWxF;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAcnD"}

package/dist/channel.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CHANNEL_CONFIG_SCHEMA = void 0;
+exports.buildChannel = buildChannel;
+exports.wireInboundToGateway = wireInboundToGateway;
+const peer_client_1 = require("./peer-client");
+const peer_db_1 = require("./peer-db");
+const peer_server_1 = require("./peer-server");
+exports.CHANNEL_CONFIG_SCHEMA = {
+    schema: {
+        type: "object",
+        additionalProperties: false,
+        properties: {
+            enabled: { type: "boolean" },
+            dmPolicy: {
+                type: "string",
+                enum: ["open", "pairing", "allowlist"],
+                default: "pairing",
+            },
+            allowFrom: {
+                type: "array",
+                items: { type: "string" },
+                description: "Agent IDs allowed to DM (dmPolicy=allowlist)",
+            },
+        },
+    },
+    uiHints: {
+        dmPolicy: {
+            label: "DM Policy",
+            help: "open: anyone, pairing: one-time code, allowlist: specific agent IDs only",
+        },
+        allowFrom: {
+            label: "Allow From",
+            help: "Agent IDs permitted to send DMs",
+        },
+    },
+};
+function buildChannel(identity, port, getSendOpts) {
+    return {
+        id: "awn",
+        meta: {
+            id: "awn",
+            label: "AWN",
+            selectionLabel: "AWN (Agent World Network)",
+            docsPath: "/channels/awn",
+            blurb: "Agent World Network — world-scoped agent communication.",
+            aliases: ["p2p"],
+        },
+        capabilities: { chatTypes: ["direct"] },
+        configSchema: exports.CHANNEL_CONFIG_SCHEMA,
+        config: {
+            listAccountIds: (_cfg) => (0, peer_db_1.getPeerIds)(),
+            resolveAccount: (_cfg, accountId) => {
+                const id = accountId ?? "";
+                const peer = (0, peer_db_1.getPeer)(id);
+                return {
+                    accountId: id,
+                    agentId: peer?.agentId ?? id,
+                    alias: peer?.alias ?? id,
+                };
+            },
+        },
+        outbound: {
+            deliveryMode: "direct",
+            sendText: async ({ text, account }) => {
+                const agentId = account.agentId ?? "";
+                const opts = getSendOpts?.(agentId);
+                const result = await (0, peer_client_1.sendP2PMessage)(identity, agentId, "chat", text, port, 10_000, opts);
+                if (!result.ok) {
+                    console.error(`[awn] Failed to send to ${agentId}: ${result.error}`);
+                }
+                return { ok: result.ok };
+            },
+        },
+    };
+}
+function wireInboundToGateway(api) {
+    (0, peer_server_1.onMessage)((msg) => {
+        if (msg.event !== "chat")
+            return;
+        try {
+            api.gateway?.receiveChannelMessage?.({
+                channelId: "awn",
+                accountId: msg.from,
+                text: msg.content,
+                senderId: msg.from,
+            });
+        }
+        catch {
+            console.log(`[awn] Message from ${msg.from}: ${msg.content}`);
+        }
+    });
+}
+//# sourceMappingURL=channel.js.map

package/dist/channel.js.map

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

package/dist/identity.d.ts

@@ -0,0 +1,31 @@
+import { Identity, AwRequestHeaders, AwResponseHeaders } from "./types";
+export declare function deriveDidKey(publicKeyB64: string): string;
+export declare function agentIdFromPublicKey(publicKeyB64: string): string;
+export declare function generateIdentity(): Identity;
+export declare function loadOrCreateIdentity(dataDir: string): Identity;
+export declare function canonicalize(value: unknown): unknown;
+export declare function signMessage(privateKeyB64: string, data: Record<string, unknown>): string;
+export declare function verifySignature(publicKeyB64: string, data: Record<string, unknown>, signatureB64: string): boolean;
+export declare const DOMAIN_SEPARATORS: {
+    readonly HTTP_REQUEST: `AgentWorld-Req-${string}\0`;
+    readonly HTTP_RESPONSE: `AgentWorld-Res-${string}\0`;
+    readonly AGENT_CARD: `AgentWorld-Card-${string}\0`;
+    readonly KEY_ROTATION: `AgentWorld-Rotation-${string}\0`;
+    readonly ANNOUNCE: `AgentWorld-Announce-${string}\0`;
+    readonly MESSAGE: `AgentWorld-Message-${string}\0`;
+    readonly WORLD_STATE: `AgentWorld-WorldState-${string}\0`;
+};
+export declare function signWithDomainSeparator(domainSeparator: string, payload: unknown, secretKey: Uint8Array): string;
+export declare function verifyWithDomainSeparator(domainSeparator: string, publicKeyB64: string, payload: unknown, signatureB64: string): boolean;
+export declare function computeContentDigest(body: string): string;
+export declare function signHttpRequest(identity: Identity, method: string, authority: string, reqPath: string, body: string): AwRequestHeaders;
+export declare function verifyHttpRequestHeaders(headers: Record<string, string | string[] | undefined>, method: string, reqPath: string, authority: string, body: string, publicKeyB64: string): {
+    ok: boolean;
+    error?: string;
+};
+export declare function signHttpResponse(identity: Identity, status: number, body: string): AwResponseHeaders;
+export declare function verifyHttpResponseHeaders(headers: Record<string, string | null>, status: number, body: string, publicKeyB64: string): {
+    ok: boolean;
+    error?: string;
+};
+//# sourceMappingURL=identity.d.ts.map