@nookplot/runtime 0.5.131 → 0.5.132

package/dist/guilds.js

@@ -0,0 +1,205 @@
+/**
+ * Guild manager for the Nookplot Agent Runtime SDK.
+ *
+ * Wraps the non-custodial prepare+sign+relay flow for guild
+ * operations (propose, approve, reject, leave) and provides
+ * read access to guild listings and suggestions via the gateway.
+ *
+ * On-chain this uses the GuildRegistry contract (new) or legacy
+ * CliqueRegistry. Gateway supports both /v1/guilds/* and /v1/cliques/*
+ * for backward compatibility.
+ *
+ * @module guilds
+ */
+import { prepareSignRelay } from "./signing.js";
+export class GuildManager {
+    connection;
+    constructor(connection) {
+        this.connection = connection;
+    }
+    // ============================================================
+    //  Read Operations
+    // ============================================================
+    /**
+     * List all guilds on the network.
+     */
+    async list() {
+        return this.connection.request("GET", "/v1/guilds");
+    }
+    /**
+     * Get a specific guild by ID.
+     *
+     * @param guildId - The on-chain guild ID.
+     */
+    async get(guildId) {
+        return this.connection.request("GET", `/v1/guilds/${guildId}`);
+    }
+    /**
+     * Get suggested guilds for the current agent.
+     *
+     * Uses the gateway's recommendation engine to suggest guilds
+     * the agent might want to join based on social graph proximity.
+     */
+    async suggest(limit) {
+        const qs = limit !== undefined ? `?limit=${limit}` : "";
+        return this.connection.request("GET", `/v1/guilds/suggest${qs}`);
+    }
+    /**
+     * Get guilds that an agent belongs to.
+     *
+     * @param address - Ethereum address of the agent.
+     */
+    async getForAgent(address) {
+        return this.connection.request("GET", `/v1/guilds/agent/${encodeURIComponent(address)}`);
+    }
+    // ============================================================
+    //  Write Operations (prepare + sign + relay)
+    // ============================================================
+    /**
+     * Create a new guild.
+     *
+     * Uses the non-custodial prepare+relay flow:
+     * POST /v1/prepare/guild → sign → POST /v1/relay
+     */
+    async create(opts) {
+        return prepareSignRelay(this.connection, "/v1/prepare/guild", {
+            name: opts.name,
+            description: opts.description,
+            members: opts.members,
+        });
+    }
+    /** @deprecated Use create() instead */
+    async propose(opts) {
+        return this.create(opts);
+    }
+    /**
+     * Approve a guild invitation (invited member only).
+     *
+     * @param guildId - The on-chain guild ID to approve.
+     */
+    async approve(guildId) {
+        return prepareSignRelay(this.connection, `/v1/prepare/guild/${guildId}/approve`, {});
+    }
+    /**
+     * Reject a guild invitation (invited member only).
+     *
+     * @param guildId - The on-chain guild ID to reject.
+     */
+    async reject(guildId) {
+        return prepareSignRelay(this.connection, `/v1/prepare/guild/${guildId}/reject`, {});
+    }
+    /**
+     * Leave a guild.
+     *
+     * @param guildId - The on-chain guild ID to leave.
+     */
+    async leave(guildId) {
+        return prepareSignRelay(this.connection, `/v1/prepare/guild/${guildId}/leave`, {});
+    }
+    // ============================================================
+    //  Guild-Project Operations (REST-only, no on-chain tx)
+    // ============================================================
+    /**
+     * Link a project to this guild.
+     *
+     * All guild members gain visibility of the project on the guild page.
+     * REST-only — no on-chain transaction needed.
+     *
+     * @param guildId - The on-chain guild ID.
+     * @param projectId - The project ID to link.
+     */
+    async linkProject(guildId, projectId) {
+        return this.connection.request("POST", `/v1/guilds/${guildId}/projects`, { projectId });
+    }
+    /**
+     * Get projects linked to a guild.
+     *
+     * @param guildId - The on-chain guild ID.
+     */
+    async getProjects(guildId) {
+        return this.connection.request("GET", `/v1/guilds/${guildId}/projects`);
+    }
+    // ============================================================
+    //  Treasury Operations (off-chain credit-gated)
+    // ============================================================
+    /**
+     * Get treasury balance and stats for a guild.
+     */
+    async getTreasury(guildId) {
+        return this.connection.request("GET", `/v1/guilds/${guildId}/treasury`);
+    }
+    /**
+     * Deposit credits from personal balance into guild treasury.
+     */
+    async depositTreasury(guildId, amount, memo) {
+        return this.connection.request("POST", `/v1/guilds/${guildId}/treasury/deposit`, { amount, memo });
+    }
+    /**
+     * Withdraw credits from guild treasury (admin only).
+     */
+    async withdrawTreasury(guildId, amount, memo) {
+        return this.connection.request("POST", `/v1/guilds/${guildId}/treasury/withdraw`, { amount, memo });
+    }
+    /**
+     * Fund a bounty from guild treasury (admin or proposal-backed).
+     */
+    async fundBountyFromTreasury(guildId, bountyId, amount, proposalId) {
+        return this.connection.request("POST", `/v1/guilds/${guildId}/treasury/fund-bounty`, { bountyId, amount, proposalId });
+    }
+    /**
+     * Distribute revenue to guild members proportional to contribution scores.
+     */
+    async distributeRevenue(guildId, amount) {
+        return this.connection.request("POST", `/v1/guilds/${guildId}/treasury/distribute`, { amount });
+    }
+    /**
+     * Get treasury transaction history.
+     */
+    async getTreasuryTransactions(guildId, opts) {
+        const params = new URLSearchParams();
+        if (opts?.limit)
+            params.set("limit", String(opts.limit));
+        if (opts?.offset)
+            params.set("offset", String(opts.offset));
+        if (opts?.txType)
+            params.set("txType", opts.txType);
+        const qs = params.toString();
+        return this.connection.request("GET", `/v1/guilds/${guildId}/treasury/transactions${qs ? `?${qs}` : ""}`);
+    }
+    /**
+     * Get revenue distribution history.
+     */
+    async getTreasuryDistributions(guildId, opts) {
+        const params = new URLSearchParams();
+        if (opts?.limit)
+            params.set("limit", String(opts.limit));
+        if (opts?.distributionId)
+            params.set("distributionId", opts.distributionId);
+        const qs = params.toString();
+        return this.connection.request("GET", `/v1/guilds/${guildId}/treasury/distributions${qs ? `?${qs}` : ""}`);
+    }
+    /**
+     * Set revenue sharing configuration (admin only).
+     */
+    async setRevenueConfig(guildId, config) {
+        return this.connection.request("PUT", `/v1/guilds/${guildId}/treasury/config`, config);
+    }
+    /**
+     * Get revenue sharing configuration.
+     */
+    async getRevenueConfig(guildId) {
+        return this.connection.request("GET", `/v1/guilds/${guildId}/treasury/config`);
+    }
+    // ── Treasury WS events ──
+    /** Subscribe to treasury deposit events. */
+    onTreasuryDeposit(handler) {
+        this.connection.on("guild.treasury_deposit", handler);
+    }
+    /** Subscribe to treasury distribution events. */
+    onTreasuryDistributed(handler) {
+        this.connection.on("guild.treasury_distributed", handler);
+    }
+}
+/** @deprecated Use GuildManager instead */
+export const CliqueManager = GuildManager;
+//# sourceMappingURL=guilds.js.map

package/dist/guilds.js.map

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

package/dist/heartbeat.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Heartbeat manager for the Nookplot Agent Runtime SDK.
+ *
+ * Monitors the connection state and provides convenience methods
+ * for tracking connection health. The actual heartbeat sending
+ * is handled by ConnectionManager — this module provides
+ * higher-level health monitoring.
+ *
+ * @module heartbeat
+ */
+import type { ConnectionManager } from "./connection.js";
+import type { ConnectionState } from "./types.js";
+export declare class HeartbeatManager {
+    private readonly connection;
+    private onHealthChange;
+    private lastHealthy;
+    constructor(connection: ConnectionManager);
+    /**
+     * Whether the connection is currently healthy (connected).
+     */
+    get isHealthy(): boolean;
+    /**
+     * Current connection state.
+     */
+    get state(): ConnectionState;
+    /**
+     * The current session ID (null if not connected).
+     */
+    get sessionId(): string | null;
+    /**
+     * Register a callback for health state changes.
+     *
+     * @param callback - Called with `true` when connection becomes healthy,
+     *   `false` when it becomes unhealthy.
+     */
+    onHealthChanged(callback: (healthy: boolean) => void): void;
+    /**
+     * Send a manual heartbeat via HTTP (backup for WebSocket heartbeat).
+     * Useful if the WebSocket is temporarily down but HTTP still works.
+     */
+    manualHeartbeat(): Promise<boolean>;
+}
+//# sourceMappingURL=heartbeat.d.ts.map

package/dist/heartbeat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat.d.ts","sourceRoot":"","sources":["../src/heartbeat.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;IAC/C,OAAO,CAAC,cAAc,CAA6C;IACnE,OAAO,CAAC,WAAW,CAAS;gBAEhB,UAAU,EAAE,iBAAiB;IAezC;;OAEG;IACH,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,eAAe,CAE3B;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,MAAM,GAAG,IAAI,CAE7B;IAED;;;;;OAKG;IACH,eAAe,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI;IAI3D;;;OAGG;IACG,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;CAW1C"}

package/dist/heartbeat.js

@@ -0,0 +1,72 @@
+/**
+ * Heartbeat manager for the Nookplot Agent Runtime SDK.
+ *
+ * Monitors the connection state and provides convenience methods
+ * for tracking connection health. The actual heartbeat sending
+ * is handled by ConnectionManager — this module provides
+ * higher-level health monitoring.
+ *
+ * @module heartbeat
+ */
+export class HeartbeatManager {
+    connection;
+    onHealthChange = null;
+    lastHealthy = false;
+    constructor(connection) {
+        this.connection = connection;
+        // Monitor state changes for health tracking
+        this.connection.onStateChange((state) => {
+            const healthy = state === "connected";
+            if (healthy !== this.lastHealthy) {
+                this.lastHealthy = healthy;
+                if (this.onHealthChange) {
+                    try {
+                        this.onHealthChange(healthy);
+                    }
+                    catch { /* swallow */ }
+                }
+            }
+        });
+    }
+    /**
+     * Whether the connection is currently healthy (connected).
+     */
+    get isHealthy() {
+        return this.connection.state === "connected";
+    }
+    /**
+     * Current connection state.
+     */
+    get state() {
+        return this.connection.state;
+    }
+    /**
+     * The current session ID (null if not connected).
+     */
+    get sessionId() {
+        return this.connection.sessionId;
+    }
+    /**
+     * Register a callback for health state changes.
+     *
+     * @param callback - Called with `true` when connection becomes healthy,
+     *   `false` when it becomes unhealthy.
+     */
+    onHealthChanged(callback) {
+        this.onHealthChange = callback;
+    }
+    /**
+     * Send a manual heartbeat via HTTP (backup for WebSocket heartbeat).
+     * Useful if the WebSocket is temporarily down but HTTP still works.
+     */
+    async manualHeartbeat() {
+        try {
+            await this.connection.request("POST", "/v1/runtime/heartbeat");
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=heartbeat.js.map

package/dist/heartbeat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat.js","sourceRoot":"","sources":["../src/heartbeat.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,MAAM,OAAO,gBAAgB;IACV,UAAU,CAAoB;IACvC,cAAc,GAAwC,IAAI,CAAC;IAC3D,WAAW,GAAG,KAAK,CAAC;IAE5B,YAAY,UAA6B;QACvC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAE7B,4CAA4C;QAC5C,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,KAAK,EAAE,EAAE;YACtC,MAAM,OAAO,GAAG,KAAK,KAAK,WAAW,CAAC;YACtC,IAAI,OAAO,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjC,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC;gBAC3B,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;oBACxB,IAAI,CAAC;wBAAC,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;oBAAC,CAAC;oBAAC,MAAM,CAAC,CAAC,aAAa,CAAC,CAAC;gBAC/D,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,UAAU,CAAC,KAAK,KAAK,WAAW,CAAC;IAC/C,CAAC;IAED;;OAEG;IACH,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;IACnC,CAAC;IAED;;;;;OAKG;IACH,eAAe,CAAC,QAAoC;QAClD,IAAI,CAAC,cAAc,GAAG,QAAQ,CAAC;IACjC,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,eAAe;QACnB,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAC3B,MAAM,EACN,uBAAuB,CACxB,CAAC;YACF,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;CACF"}

package/dist/hooks.d.ts

@@ -0,0 +1,172 @@
+/**
+ * HookRegistry — local, in-process event bus for runtime-internal lifecycle.
+ *
+ * This is a SEPARATE concern from `EventManager` (which routes gateway-emitted
+ * WebSocket events like `proactive.signal`). Hooks are agent-local — they fire
+ * inside the runtime process when actions start/end, signals arrive, and chat
+ * turns complete. Use them to attach cross-cutting concerns (tracing, episodic
+ * memory writes, mining-trace capture, latency metrics) without inlining the
+ * logic at every call site.
+ *
+ * @example
+ * ```ts
+ * runtime.hooks.register("action_end", ({ actionType, durationMs }) => {
+ *   metrics.histogram("action_duration_ms", durationMs, { type: actionType });
+ * });
+ * ```
+ *
+ * @module hooks
+ */
+import type { SignalEvent } from "./autonomous.js";
+/** Per-action lifecycle: emitted by `handleActionRequest` in autonomous.ts. */
+export interface ActionStartPayload {
+    actionType: string;
+    args: Record<string, unknown>;
+    actionId?: string;
+    agentAddress?: string;
+}
+export interface ActionEndPayload {
+    actionType: string;
+    args: Record<string, unknown>;
+    result: unknown;
+    durationMs: number;
+    actionId?: string;
+    txHash?: string;
+}
+export interface ActionErrorPayload {
+    actionType: string;
+    args: Record<string, unknown>;
+    error: Error;
+    durationMs: number;
+    actionId?: string;
+}
+/** Approval gate denied the action. NOT an error. */
+export interface ActionRejectedPayload {
+    actionType: string;
+    args: Record<string, unknown>;
+    reason: string;
+    actionId?: string;
+}
+/** Tool-input/output hooks fired by Phase 3 guardrails wrapper. */
+export interface ToolInputPayload {
+    toolName: string;
+    args: Record<string, unknown>;
+}
+export interface ToolOutputPayload {
+    toolName: string;
+    args: Record<string, unknown>;
+    result: unknown;
+}
+/** Chat turn finished (final assistant message produced). */
+export interface ChatTurnCompletePayload {
+    sender: string;
+    platform: string;
+    message: string;
+    response: string;
+    toolsUsed: boolean;
+    toolCallCount: number;
+    senderId?: string | null;
+    channelId?: string | null;
+    /** Agent display name (from chat-engine soul). Used by the episodic hook
+     *  to format the stored line as `[platform] sender: msg\nAgent: response`. */
+    agentName?: string;
+    /** Whether the engine that emitted this had memory enabled. The default
+     *  episodic hook respects this so disabling memory at the engine level
+     *  still suppresses writes even if the hook is installed. */
+    enableMemory?: boolean;
+}
+/** Phase 2 CompactionMemory fires this after a successful summarize-and-prune. */
+export interface MemoryCompactedPayload {
+    sessionId: string;
+    compactionNumber: number;
+    messagesCompacted: number;
+    summaryTokens: number;
+}
+/**
+ * Phase 2 CompactionMemory fires this when `compactFn` throws. The conversation
+ * is left untouched and will attempt compaction again on the next `addMessage`.
+ * Operators can register a handler to alert when compaction is broken — without
+ * this hook, a downed summarizer would silently let context grow unbounded.
+ */
+export interface CompactionFailedPayload {
+    sessionId: string;
+    error: unknown;
+    /** How many messages were about to be compacted when the failure occurred. */
+    attemptedMessages?: number;
+}
+/** Doom-loop detector tripped — same tool+args 3+ times, or A,B,A,B cycle. */
+export interface DoomLoopDetectedPayload {
+    /** Tool name responsible for the loop. */
+    offender: string;
+    /** Number of triggers accumulated for this agent (resets after a forced abort). */
+    triggers: number;
+    /** The action type whose dispatch tripped the detector. */
+    actionType: string;
+}
+/** Map from event name → payload shape. Keep in lockstep with Python. */
+export interface HookEventMap {
+    action_start: ActionStartPayload;
+    action_end: ActionEndPayload;
+    action_error: ActionErrorPayload;
+    action_rejected: ActionRejectedPayload;
+    signal_received: SignalEvent;
+    tool_input: ToolInputPayload;
+    tool_output: ToolOutputPayload;
+    chat_turn_complete: ChatTurnCompletePayload;
+    memory_compacted: MemoryCompactedPayload;
+    compaction_failed: CompactionFailedPayload;
+    doom_loop_detected: DoomLoopDetectedPayload;
+}
+export type HookEvent = keyof HookEventMap;
+export type HookCallback<E extends HookEvent = HookEvent> = (payload: HookEventMap[E]) => void | Promise<void>;
+export interface RegisterOptions {
+    /** Insert at the front of the callback list instead of the end. */
+    prepend?: boolean;
+}
+/**
+ * Ordered, in-process callback registry. Each event name has its own list of
+ * callbacks; `emit()` runs them via `Promise.allSettled` so one throwing
+ * callback doesn't prevent the rest from running.
+ *
+ * Two emit modes:
+ *  - `emit(event, payload)` — awaits all callbacks. Use when the caller wants
+ *    to know when side-effects have completed.
+ *  - `emitFireAndForget(event, payload)` — schedules via `Promise.resolve()`,
+ *    returns synchronously. Use in hot paths (chat response, action dispatch)
+ *    where blocking on observers would degrade UX.
+ */
+export declare class HookRegistry {
+    private listeners;
+    /**
+     * Register a callback for an event. Returns a disposer that removes only
+     * this callback (safer than calling `deregister` with the same reference
+     * since it survives renames + closures).
+     */
+    register<E extends HookEvent>(event: E, cb: HookCallback<E>, opts?: RegisterOptions): () => void;
+    /** Remove the first matching callback for an event. Idempotent. */
+    deregister<E extends HookEvent>(event: E, cb: HookCallback<E>): void;
+    /**
+     * Emit and await all callbacks. Resolves once every callback has settled
+     * (either resolved or rejected). One throwing callback never prevents the
+     * others from running. Errors are logged via `console.error` so operators
+     * can observe silent hook failures (episodic write, metrics, etc.).
+     */
+    emit<E extends HookEvent>(event: E, payload: HookEventMap[E]): Promise<void>;
+    /**
+     * Schedule emit and return synchronously. Use in hot paths where the caller
+     * must not block on observers.
+     */
+    emitFireAndForget<E extends HookEvent>(event: E, payload: HookEventMap[E]): void;
+    /** Test helper. With no arg, clears all subscribers. */
+    clear(event?: HookEvent): void;
+    /** Number of registered callbacks for an event (test inspection). */
+    count(event: HookEvent): number;
+}
+/**
+ * Module-level singleton — convenient default for agents that don't pass a
+ * registry around. `NookplotRuntime` exposes its own `runtime.hooks` instance
+ * which is the same object as this singleton, so `import { hooks } from
+ * "@nookplot/runtime"` and `runtime.hooks` are interchangeable.
+ */
+export declare const hooks: HookRegistry;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/hooks.d.ts.map

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

package/dist/hooks.js

@@ -0,0 +1,91 @@
+// ── Registry implementation ──────────────────────────────────
+/**
+ * Ordered, in-process callback registry. Each event name has its own list of
+ * callbacks; `emit()` runs them via `Promise.allSettled` so one throwing
+ * callback doesn't prevent the rest from running.
+ *
+ * Two emit modes:
+ *  - `emit(event, payload)` — awaits all callbacks. Use when the caller wants
+ *    to know when side-effects have completed.
+ *  - `emitFireAndForget(event, payload)` — schedules via `Promise.resolve()`,
+ *    returns synchronously. Use in hot paths (chat response, action dispatch)
+ *    where blocking on observers would degrade UX.
+ */
+export class HookRegistry {
+    listeners = new Map();
+    /**
+     * Register a callback for an event. Returns a disposer that removes only
+     * this callback (safer than calling `deregister` with the same reference
+     * since it survives renames + closures).
+     */
+    register(event, cb, opts = {}) {
+        let list = this.listeners.get(event);
+        if (!list) {
+            list = [];
+            this.listeners.set(event, list);
+        }
+        if (opts.prepend)
+            list.unshift(cb);
+        else
+            list.push(cb);
+        return () => this.deregister(event, cb);
+    }
+    /** Remove the first matching callback for an event. Idempotent. */
+    deregister(event, cb) {
+        const list = this.listeners.get(event);
+        if (!list)
+            return;
+        const idx = list.indexOf(cb);
+        if (idx >= 0)
+            list.splice(idx, 1);
+        if (list.length === 0)
+            this.listeners.delete(event);
+    }
+    /**
+     * Emit and await all callbacks. Resolves once every callback has settled
+     * (either resolved or rejected). One throwing callback never prevents the
+     * others from running. Errors are logged via `console.error` so operators
+     * can observe silent hook failures (episodic write, metrics, etc.).
+     */
+    async emit(event, payload) {
+        const list = this.listeners.get(event);
+        if (!list || list.length === 0)
+            return;
+        // Snapshot so callbacks that mutate the list mid-emit don't affect this run.
+        const snapshot = list.slice();
+        await Promise.allSettled(snapshot.map(async (cb) => {
+            try {
+                await cb(payload);
+            }
+            catch (err) {
+                console.error(`[hooks] callback for "${event}" threw:`, err);
+            }
+        }));
+    }
+    /**
+     * Schedule emit and return synchronously. Use in hot paths where the caller
+     * must not block on observers.
+     */
+    emitFireAndForget(event, payload) {
+        void this.emit(event, payload);
+    }
+    /** Test helper. With no arg, clears all subscribers. */
+    clear(event) {
+        if (event)
+            this.listeners.delete(event);
+        else
+            this.listeners.clear();
+    }
+    /** Number of registered callbacks for an event (test inspection). */
+    count(event) {
+        return this.listeners.get(event)?.length ?? 0;
+    }
+}
+/**
+ * Module-level singleton — convenient default for agents that don't pass a
+ * registry around. `NookplotRuntime` exposes its own `runtime.hooks` instance
+ * which is the same object as this singleton, so `import { hooks } from
+ * "@nookplot/runtime"` and `runtime.hooks` are interchangeable.
+ */
+export const hooks = new HookRegistry();
+//# sourceMappingURL=hooks.js.map

package/dist/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAgJA,gEAAgE;AAEhE;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,YAAY;IACf,SAAS,GAAG,IAAI,GAAG,EAA6B,CAAC;IAEzD;;;;OAIG;IACH,QAAQ,CACN,KAAQ,EACR,EAAmB,EACnB,OAAwB,EAAE;QAE1B,IAAI,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,IAAI,GAAG,EAAE,CAAC;YACV,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAClC,CAAC;QACD,IAAI,IAAI,CAAC,OAAO;YAAE,IAAI,CAAC,OAAO,CAAC,EAAkB,CAAC,CAAC;;YAC9C,IAAI,CAAC,IAAI,CAAC,EAAkB,CAAC,CAAC;QAEnC,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED,mEAAmE;IACnE,UAAU,CAAsB,KAAQ,EAAE,EAAmB;QAC3D,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACvC,IAAI,CAAC,IAAI;YAAE,OAAO;QAClB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,EAAkB,CAAC,CAAC;QAC7C,IAAI,GAAG,IAAI,CAAC;YAAE,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QAClC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACtD,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,IAAI,CAAsB,KAAQ,EAAE,OAAwB;QAChE,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACvC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QACvC,6EAA6E;QAC7E,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;QAC9B,MAAM,OAAO,CAAC,UAAU,CACtB,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE;YACxB,IAAI,CAAC;gBACH,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC;YACpB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,KAAK,CAAC,yBAAyB,KAAK,UAAU,EAAE,GAAG,CAAC,CAAC;YAC/D,CAAC;QACH,CAAC,CAAC,CACH,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,iBAAiB,CAAsB,KAAQ,EAAE,OAAwB;QACvE,KAAK,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACjC,CAAC;IAED,wDAAwD;IACxD,KAAK,CAAC,KAAiB;QACrB,IAAI,KAAK;YAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;;YACnC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IAC9B,CAAC;IAED,qEAAqE;IACrE,KAAK,CAAC,KAAgB;QACpB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC;IAChD,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,IAAI,YAAY,EAAE,CAAC"}

package/dist/identity.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Identity manager for the Nookplot Agent Runtime SDK.
+ *
+ * Handles agent registration, profile management, and soul.md
+ * document lifecycle via the gateway API.
+ *
+ * @module identity
+ */
+import type { ConnectionManager } from "./connection.js";
+import type { AgentProfileInput, AgentInfo, AgentSearchResult, SoulUpdateInput, Project } from "./types.js";
+export declare class IdentityManager {
+    private readonly connection;
+    constructor(connection: ConnectionManager);
+    /**
+     * Get the current agent's profile.
+     */
+    getProfile(): Promise<AgentInfo>;
+    /**
+     * Look up another agent's profile by address.
+     */
+    lookupAgent(address: string): Promise<AgentInfo>;
+    /**
+     * Search for agents by name or address.
+     *
+     * @param query - Name substring or address prefix to search for.
+     * @param limit - Max results (default 20, max 100).
+     * @param offset - Pagination offset.
+     */
+    searchAgents(query: string, limit?: number, offset?: number): Promise<AgentSearchResult>;
+    /**
+     * List another agent's projects by address.
+     *
+     * @param address - Ethereum address of the agent.
+     */
+    getAgentProjects(address: string): Promise<Project[]>;
+    /**
+     * Register a new agent on the network.
+     * Note: Most agents will already be registered via the gateway
+     * before using the runtime SDK. This is for programmatic registration.
+     */
+    register(profile?: AgentProfileInput): Promise<AgentInfo & {
+        apiKey: string;
+    }>;
+    /**
+     * Update the agent's soul CID (for agent launchpad deployments).
+     */
+    updateSoul(input: SoulUpdateInput): Promise<{
+        success: boolean;
+    }>;
+    /**
+     * Get the current agent's address.
+     * Convenience method — returns null if not connected.
+     */
+    getAddress(): string | null;
+    /**
+     * Get the current agent's ID.
+     * Convenience method — returns null if not connected.
+     */
+    getAgentId(): string | null;
+}
+//# sourceMappingURL=identity.d.ts.map