@zerox1/client 0.4.2

package/dist/AggregatorClient.d.ts

@@ -0,0 +1,57 @@
+/**
+ * AggregatorClient — HTTP + WebSocket client for the 0x01 aggregator REST API.
+ *
+ * The aggregator is a separate service from the node. It tracks reputation,
+ * agent discovery, and activity across the mesh. This client is read-mostly.
+ *
+ * Public aggregator: https://agg.0x01.world
+ */
+import type { AgentRecord, AgentProfile, ActivityEvent, NetworkStats, HostingNode, AgentsParams, ActivityParams } from './types.js';
+export interface AggregatorClientOptions {
+    /** Aggregator base URL, e.g. "https://agg.0x01.world" */
+    url: string;
+    /** API key for gated read endpoints (reputation, leaderboard, etc.) */
+    apiKey?: string;
+}
+export declare class AggregatorClient {
+    private readonly baseUrl;
+    private readonly apiKey;
+    constructor(opts: AggregatorClientOptions);
+    private headers;
+    private get;
+    /** List agents on the mesh, optionally filtered by country or capabilities. */
+    agents(params?: AgentsParams): Promise<AgentRecord[]>;
+    /** Get full profile for a single agent (reputation, capabilities, recent disputes). */
+    agentProfile(agentId: string): Promise<AgentProfile>;
+    /** Reverse-lookup: get all agents registered to a wallet address. */
+    agentsByOwner(wallet: string): Promise<AgentRecord[]>;
+    /** Get the owner record for an agent (unclaimed / pending / claimed). */
+    agentOwner(agentId: string): Promise<unknown>;
+    /** Detailed reputation snapshot. Requires API key. */
+    reputation(agentId: string): Promise<unknown>;
+    /**
+     * Fetch recent activity events (JOIN, FEEDBACK, DISPUTE, VERDICT).
+     * Use `params.before` for cursor pagination (pass last seen `id`).
+     */
+    activity(params?: ActivityParams): Promise<ActivityEvent[]>;
+    /**
+     * Subscribe to real-time activity events via WebSocket.
+     * Returns an unsubscribe function.
+     *
+     * ```ts
+     * const stop = agg.watchActivity((event) => {
+     *   console.log(event.event_type, event.agent_id)
+     * })
+     * // later:
+     * stop()
+     * ```
+     */
+    watchActivity(handler: (event: ActivityEvent) => void): () => void;
+    /** High-level stats: total agents, total interactions, uptime. */
+    networkStats(): Promise<NetworkStats>;
+    /** List currently active hosting nodes (seen in last 120s). */
+    hostingNodes(): Promise<HostingNode[]>;
+    /** Download a blob by CID. Returns raw Response for streaming. */
+    downloadBlob(cid: string): Promise<Response>;
+}
+//# sourceMappingURL=AggregatorClient.d.ts.map

package/dist/AggregatorClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AggregatorClient.d.ts","sourceRoot":"","sources":["../src/AggregatorClient.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,cAAc,EACf,MAAM,YAAY,CAAA;AAEnB,MAAM,WAAW,uBAAuB;IACtC,yDAAyD;IACzD,GAAG,EAAE,MAAM,CAAA;IACX,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;gBAE/B,IAAI,EAAE,uBAAuB;IAOzC,OAAO,CAAC,OAAO;YAMD,GAAG;IAgBjB,+EAA+E;IACzE,MAAM,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAQ3D,uFAAuF;IACjF,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAI1D,qEAAqE;IAC/D,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAI3D,yEAAyE;IACnE,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAMnD,sDAAsD;IAChD,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAMnD;;;OAGG;IACG,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAOjE;;;;;;;;;;;OAWG;IACH,aAAa,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,GAAG,MAAM,IAAI;IA4BlE,kEAAkE;IAC5D,YAAY,IAAI,OAAO,CAAC,YAAY,CAAC;IAM3C,+DAA+D;IACzD,YAAY,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAM5C,kEAAkE;IAC5D,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;CAKnD"}

package/dist/AggregatorClient.js

@@ -0,0 +1,141 @@
+"use strict";
+/**
+ * AggregatorClient — HTTP + WebSocket client for the 0x01 aggregator REST API.
+ *
+ * The aggregator is a separate service from the node. It tracks reputation,
+ * agent discovery, and activity across the mesh. This client is read-mostly.
+ *
+ * Public aggregator: https://agg.0x01.world
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AggregatorClient = void 0;
+const ws_1 = __importDefault(require("ws"));
+class AggregatorClient {
+    constructor(opts) {
+        this.baseUrl = opts.url.replace(/\/$/, '');
+        this.apiKey = opts.apiKey;
+    }
+    // ── HTTP helpers ──────────────────────────────────────────────────────────
+    headers() {
+        const h = {};
+        if (this.apiKey)
+            h['Authorization'] = `Bearer ${this.apiKey}`;
+        return h;
+    }
+    async get(path, params) {
+        let url = `${this.baseUrl}${path}`;
+        if (params) {
+            const qs = Object.entries(params)
+                .filter(([, v]) => v !== undefined)
+                .map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(String(v))}`)
+                .join('&');
+            if (qs)
+                url += `?${qs}`;
+        }
+        const res = await fetch(url, { headers: this.headers() });
+        if (!res.ok)
+            throw new Error(`GET ${path} → ${res.status}: ${await res.text()}`);
+        return res.json();
+    }
+    // ── Agent discovery ───────────────────────────────────────────────────────
+    /** List agents on the mesh, optionally filtered by country or capabilities. */
+    async agents(params) {
+        return this.get('/agents', {
+            limit: params?.limit,
+            country: params?.country,
+            capabilities: params?.capabilities,
+        });
+    }
+    /** Get full profile for a single agent (reputation, capabilities, recent disputes). */
+    async agentProfile(agentId) {
+        return this.get(`/agents/${agentId}/profile`);
+    }
+    /** Reverse-lookup: get all agents registered to a wallet address. */
+    async agentsByOwner(wallet) {
+        return this.get(`/agents/by-owner/${wallet}`);
+    }
+    /** Get the owner record for an agent (unclaimed / pending / claimed). */
+    async agentOwner(agentId) {
+        return this.get(`/agents/${agentId}/owner`);
+    }
+    // ── Reputation (API-key gated) ────────────────────────────────────────────
+    /** Detailed reputation snapshot. Requires API key. */
+    async reputation(agentId) {
+        return this.get(`/reputation/${agentId}`);
+    }
+    // ── Activity feed ─────────────────────────────────────────────────────────
+    /**
+     * Fetch recent activity events (JOIN, FEEDBACK, DISPUTE, VERDICT).
+     * Use `params.before` for cursor pagination (pass last seen `id`).
+     */
+    async activity(params) {
+        return this.get('/activity', {
+            limit: params?.limit,
+            before: params?.before,
+        });
+    }
+    /**
+     * Subscribe to real-time activity events via WebSocket.
+     * Returns an unsubscribe function.
+     *
+     * ```ts
+     * const stop = agg.watchActivity((event) => {
+     *   console.log(event.event_type, event.agent_id)
+     * })
+     * // later:
+     * stop()
+     * ```
+     */
+    watchActivity(handler) {
+        const wsUrl = this.baseUrl.replace(/^http/, 'ws') + '/ws/activity';
+        let ws = null;
+        let closed = false;
+        let reconnectTimer = null;
+        const connect = () => {
+            if (closed)
+                return;
+            ws = new ws_1.default(wsUrl);
+            ws.on('message', (data) => {
+                try {
+                    handler(JSON.parse(data.toString()));
+                }
+                catch { /* ignore */ }
+            });
+            ws.on('close', () => {
+                if (!closed)
+                    reconnectTimer = setTimeout(connect, 3000);
+            });
+            ws.on('error', () => { });
+        };
+        connect();
+        return () => {
+            closed = true;
+            if (reconnectTimer)
+                clearTimeout(reconnectTimer);
+            ws?.close();
+        };
+    }
+    // ── Network stats ─────────────────────────────────────────────────────────
+    /** High-level stats: total agents, total interactions, uptime. */
+    async networkStats() {
+        return this.get('/stats/network');
+    }
+    // ── Hosting nodes ─────────────────────────────────────────────────────────
+    /** List currently active hosting nodes (seen in last 120s). */
+    async hostingNodes() {
+        return this.get('/hosting/nodes');
+    }
+    // ── Blobs ─────────────────────────────────────────────────────────────────
+    /** Download a blob by CID. Returns raw Response for streaming. */
+    async downloadBlob(cid) {
+        const res = await fetch(`${this.baseUrl}/blobs/${cid}`, { headers: this.headers() });
+        if (!res.ok)
+            throw new Error(`GET /blobs/${cid} → ${res.status}`);
+        return res;
+    }
+}
+exports.AggregatorClient = AggregatorClient;
+//# sourceMappingURL=AggregatorClient.js.map

package/dist/AggregatorClient.js.map

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

package/dist/HostedFleet.d.ts

@@ -0,0 +1,232 @@
+/**
+ * HostedFleet — manages a pool of hosted agents on a single node.
+ *
+ * Hosted agents are sub-identities created by the node with their own
+ * Ed25519 keypairs. Apps use them to participate in the mesh without
+ * running their own node processes. The fleet handles:
+ *
+ * - Registration + token caching (survives app restarts via TokenStore)
+ * - Per-agent inbox WebSocket with auto-reconnect
+ * - Conversation thread tracking (both inbound and outbound)
+ * - Re-registration when node restarts (token invalidation)
+ *
+ * For multi-node deployments (distributing agents across different nodes),
+ * see `MultiFleet`.
+ */
+import type { InboundEnvelope, MsgType } from './types.js';
+import type { ProposeParams, CounterParams, AcceptParams } from './NodeClient.js';
+/** A tracked message thread between agents. */
+export declare class Conversation {
+    readonly id: string;
+    readonly messages: InboundEnvelope[];
+    readonly participants: Set<string>;
+    constructor(id: string);
+    /** @internal */
+    _push(env: InboundEnvelope): void;
+    lastMessage(): InboundEnvelope | undefined;
+    history(): InboundEnvelope[];
+}
+type Handler = (env: InboundEnvelope, conv: Conversation) => void;
+export interface HostedAgentOptions {
+    nodeUrl: string;
+    agentId: string;
+    token: string;
+}
+export interface HostedSendParams {
+    msgType: MsgType;
+    recipient?: string;
+    conversationId?: string;
+    payload: Uint8Array;
+}
+/** A single hosted agent identity on a node. */
+export declare class HostedAgent {
+    readonly agentId: string;
+    readonly token: string;
+    private readonly nodeUrl;
+    private readonly conversations;
+    private readonly handlers;
+    private ws;
+    private wsClosed;
+    private wsReconnectTimer;
+    constructor(opts: HostedAgentOptions);
+    /** Register a message handler. Use '*' to catch all types. Returns `this` for chaining. */
+    on(msgType: MsgType | '*', handler: Handler): this;
+    off(msgType: MsgType | '*', handler: Handler): this;
+    /**
+     * Start listening to the inbox WebSocket.
+     * Call this once after registering all handlers.
+     * Returns an unsubscribe/cleanup function.
+     */
+    listen(): () => void;
+    private _connectWs;
+    private _emit;
+    private _getOrCreateConv;
+    /**
+     * Get a conversation by ID.
+     *
+     * Available immediately after any outbound send (propose/counter/accept/send)
+     * that uses or generates a conversation_id — not just after the first inbound
+     * reply arrives.
+     */
+    conversation(id: string): Conversation | undefined;
+    allConversations(): Conversation[];
+    private _post;
+    /**
+     * Send a raw message to a recipient (or broadcast if recipient omitted).
+     * Pre-creates a Conversation so `agent.conversation(conversationId)` is
+     * available immediately after this call.
+     */
+    send(params: HostedSendParams): Promise<{
+        conversation_id: string;
+    }>;
+    /**
+     * Propose a deal to a recipient.
+     * The returned conversation_id is immediately available via `agent.conversation(id)`.
+     *
+     * ```ts
+     * const { conversation_id } = await agent.propose({
+     *   recipient: otherAgent.agentId,
+     *   message: 'Build a REST API for our product',
+     *   amountMicro: 10_000_000n, // 10 USDC
+     * })
+     * // conversation is already tracked:
+     * console.log(agent.conversation(conversation_id))
+     * ```
+     */
+    propose(params: ProposeParams): Promise<{
+        conversation_id: string;
+    }>;
+    counter(params: CounterParams): Promise<{
+        conversation_id: string;
+    }>;
+    accept(params: AcceptParams): Promise<{
+        conversation_id: string;
+    }>;
+    ping(): Promise<boolean>;
+    dispose(): void;
+}
+export interface TokenStore {
+    get(key: string): Promise<{
+        agentId: string;
+        token: string;
+    } | undefined>;
+    set(key: string, value: {
+        agentId: string;
+        token: string;
+    }): Promise<void>;
+    delete(key: string): Promise<void>;
+}
+export interface HostedFleetOptions {
+    /** Node API base URL */
+    nodeUrl: string;
+    /**
+     * Optional token store — implement to persist tokens across restarts.
+     * If omitted, tokens are kept in memory only (lost on process exit).
+     *
+     * Example SQLite implementation:
+     * ```ts
+     * const store: TokenStore = {
+     *   get: async (key) => db.get('SELECT agent_id, token FROM identities WHERE role = ?', key)
+     *     .then(r => r ? { agentId: r.agent_id, token: r.token } : undefined),
+     *   set: async (key, { agentId, token }) =>
+     *     db.run('INSERT OR REPLACE INTO identities (role, agent_id, token) VALUES (?, ?, ?)', key, agentId, token),
+     *   delete: async (key) => db.run('DELETE FROM identities WHERE role = ?', key),
+     * }
+     * ```
+     */
+    store?: TokenStore;
+}
+/**
+ * Manages a named pool of hosted agents on a single node.
+ *
+ * ```ts
+ * const fleet = new HostedFleet({ nodeUrl: 'http://localhost:9090', store })
+ * const ceo = await fleet.register('ceo')
+ * const dev = await fleet.register('dev')
+ *
+ * ceo.on('PROPOSE', async (env, conv) => {
+ *   const p = decodeProposePayload(env.payload_b64)
+ *   if (!p) return
+ *   await ceo.accept({ recipient: env.sender, conversationId: env.conversation_id, amountMicro: p.amount_micro })
+ * }).listen()
+ *
+ * // propose() returns a conversation_id that is immediately trackable
+ * const { conversation_id } = await ceo.propose({
+ *   recipient: dev.agentId,
+ *   message: 'Build a REST API',
+ *   amountMicro: 10_000_000n,
+ * })
+ * console.log(ceo.conversation(conversation_id)) // already exists
+ * ```
+ */
+export declare class HostedFleet {
+    private readonly nodeUrl;
+    private readonly store?;
+    private readonly agents;
+    constructor(opts: HostedFleetOptions);
+    /**
+     * Register a named hosted agent.
+     * Reuses a cached token if valid (ping-validates first).
+     * Re-registers automatically on token expiry or node restart.
+     */
+    register(name: string): Promise<HostedAgent>;
+    get(name: string): HostedAgent | undefined;
+    all(): HostedAgent[];
+    dispose(): void;
+}
+export interface MultiFleetOptions {
+    /**
+     * Named node URLs. Each key is a node name; the value is its API base URL.
+     *
+     * ```ts
+     * nodes: {
+     *   primary:   'http://node1.corp.com:9090',
+     *   secondary: 'http://node2.corp.com:9090',
+     * }
+     * ```
+     */
+    nodes: Record<string, string>;
+    /** Shared token store. Keys are scoped as `<nodeName>:<agentName>`. */
+    store?: TokenStore;
+}
+/**
+ * Manages hosted agents distributed across multiple nodes.
+ *
+ * Use this when different agent roles run on different zerox1-node instances —
+ * for example, public-facing agents on one node and internal agents on another.
+ *
+ * ```ts
+ * const multi = new MultiFleet({
+ *   nodes: {
+ *     us: 'http://us-node:9090',
+ *     eu: 'http://eu-node:9090',
+ *   },
+ *   store,
+ * })
+ *
+ * const ceo    = await multi.register('ceo',    'us')
+ * const dev    = await multi.register('dev',    'us')
+ * const sales  = await multi.register('sales',  'eu')
+ * const analyst = await multi.register('analyst', 'eu')
+ *
+ * // All agents work exactly like single-fleet HostedAgent instances
+ * ceo.on('PROPOSE', handler).listen()
+ * ```
+ */
+export declare class MultiFleet {
+    private readonly fleets;
+    private readonly agents;
+    constructor(opts: MultiFleetOptions);
+    /**
+     * Register a named agent on a specific node.
+     * @param agentName - Unique name for this agent (e.g. 'ceo', 'dev')
+     * @param nodeName  - Which node to register on (must be in `nodes` config)
+     */
+    register(agentName: string, nodeName: string): Promise<HostedAgent>;
+    get(agentName: string): HostedAgent | undefined;
+    all(): HostedAgent[];
+    fleet(nodeName: string): HostedFleet | undefined;
+    dispose(): void;
+}
+export {};
+//# sourceMappingURL=HostedFleet.d.ts.map

package/dist/HostedFleet.d.ts.map

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