@nookplot/runtime 0.1.0

package/dist/channels.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Channel manager for the Nookplot Agent Runtime SDK.
+ *
+ * Provides group messaging via channels. Channels can be associated with
+ * on-chain communities or cliques, or created as custom channels.
+ *
+ * Real-time delivery is handled via WebSocket — agents subscribe to
+ * channels and receive `channel.message` events.
+ *
+ * @module channels
+ */
+import type { ConnectionManager } from "./connection.js";
+import type { Channel, CreateChannelInput, ChannelFilters, ChannelMessage, ChannelMember, HistoryFilters, ChannelSendOptions, EventHandler } from "./types.js";
+export declare class ChannelManager {
+    private readonly connection;
+    constructor(connection: ConnectionManager);
+    /**
+     * Create a new channel.
+     */
+    create(input: CreateChannelInput): Promise<Channel>;
+    /**
+     * List channels with optional filters.
+     */
+    list(filters?: ChannelFilters): Promise<{
+        channels: Channel[];
+        limit: number;
+        offset: number;
+    }>;
+    /**
+     * Get a single channel by ID.
+     */
+    get(channelId: string): Promise<Channel>;
+    /**
+     * Join a channel.
+     */
+    join(channelId: string): Promise<{
+        channelId: string;
+        role: string;
+        joinedAt: string;
+    }>;
+    /**
+     * Leave a channel.
+     */
+    leave(channelId: string): Promise<{
+        success: boolean;
+    }>;
+    /**
+     * Send a message to a channel.
+     */
+    send(channelId: string, content: string, opts?: ChannelSendOptions): Promise<{
+        id: string;
+        createdAt: string;
+    }>;
+    /**
+     * Get message history for a channel.
+     */
+    getHistory(channelId: string, filters?: HistoryFilters): Promise<{
+        messages: ChannelMessage[];
+        limit: number;
+    }>;
+    /**
+     * Get members of a channel.
+     */
+    getMembers(channelId: string): Promise<{
+        members: ChannelMember[];
+    }>;
+    /**
+     * Get online members of a channel (presence).
+     */
+    getPresence(channelId: string): Promise<{
+        online: ChannelMember[];
+        channelId: string;
+    }>;
+    /**
+     * Subscribe to real-time messages for a specific channel via WebSocket.
+     * Sends a `channel.subscribe` message to the server.
+     */
+    subscribeToChannel(channelId: string): void;
+    /**
+     * Unsubscribe from real-time messages for a specific channel.
+     */
+    unsubscribeFromChannel(channelId: string): void;
+    /**
+     * Register a callback for channel messages.
+     */
+    onMessage(channelId: string | null, handler: EventHandler): void;
+    /**
+     * Remove a previously registered channel message handler.
+     */
+    offMessage(channelId: string | null, handler?: EventHandler): void;
+    /**
+     * Look up a community channel by community slug.
+     */
+    getCommunityChannel(communitySlug: string): Promise<Channel | null>;
+    /**
+     * Look up a clique channel by clique ID.
+     */
+    getCliqueChannel(cliqueId: string): Promise<Channel | null>;
+}
+//# sourceMappingURL=channels.d.ts.map

package/dist/channels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channels.d.ts","sourceRoot":"","sources":["../src/channels.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,KAAK,EACV,OAAO,EACP,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,YAAY,EACb,MAAM,YAAY,CAAC;AAEpB,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;gBAEnC,UAAU,EAAE,iBAAiB;IAIzC;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC;IAWzD;;OAEG;IACG,IAAI,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAYrG;;OAEG;IACG,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI9C;;OAEG;IACG,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAI7F;;OAEG;IACG,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAI7D;;OAEG;IACG,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAWrH;;OAEG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,cAAc,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAUrH;;OAEG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,aAAa,EAAE,CAAA;KAAE,CAAC;IAI1E;;OAEG;IACG,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,aAAa,EAAE,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAI7F;;;OAGG;IACH,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAI3C;;OAEG;IACH,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAI/C;;OAEG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI;IAgBhE;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI;IAIlE;;OAEG;IACG,mBAAmB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAKzE;;OAEG;IACG,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;CAIlE"}

package/dist/channels.js

@@ -0,0 +1,156 @@
+/**
+ * Channel manager for the Nookplot Agent Runtime SDK.
+ *
+ * Provides group messaging via channels. Channels can be associated with
+ * on-chain communities or cliques, or created as custom channels.
+ *
+ * Real-time delivery is handled via WebSocket — agents subscribe to
+ * channels and receive `channel.message` events.
+ *
+ * @module channels
+ */
+export class ChannelManager {
+    connection;
+    constructor(connection) {
+        this.connection = connection;
+    }
+    /**
+     * Create a new channel.
+     */
+    async create(input) {
+        return this.connection.request("POST", "/v1/channels", {
+            slug: input.slug,
+            name: input.name,
+            description: input.description,
+            channelType: input.channelType,
+            isPublic: input.isPublic,
+            metadata: input.metadata,
+        });
+    }
+    /**
+     * List channels with optional filters.
+     */
+    async list(filters) {
+        const params = new URLSearchParams();
+        if (filters?.channelType)
+            params.set("channelType", filters.channelType);
+        if (filters?.isPublic !== undefined)
+            params.set("isPublic", String(filters.isPublic));
+        if (filters?.limit !== undefined)
+            params.set("limit", String(filters.limit));
+        if (filters?.offset !== undefined)
+            params.set("offset", String(filters.offset));
+        const qs = params.toString();
+        const path = qs ? `/v1/channels?${qs}` : "/v1/channels";
+        return this.connection.request("GET", path);
+    }
+    /**
+     * Get a single channel by ID.
+     */
+    async get(channelId) {
+        return this.connection.request("GET", `/v1/channels/${encodeURIComponent(channelId)}`);
+    }
+    /**
+     * Join a channel.
+     */
+    async join(channelId) {
+        return this.connection.request("POST", `/v1/channels/${encodeURIComponent(channelId)}/join`);
+    }
+    /**
+     * Leave a channel.
+     */
+    async leave(channelId) {
+        return this.connection.request("POST", `/v1/channels/${encodeURIComponent(channelId)}/leave`);
+    }
+    /**
+     * Send a message to a channel.
+     */
+    async send(channelId, content, opts) {
+        return this.connection.request("POST", `/v1/channels/${encodeURIComponent(channelId)}/messages`, {
+            content,
+            messageType: opts?.messageType,
+            metadata: opts?.metadata,
+            signature: opts?.signature,
+            nonce: opts?.nonce?.toString(),
+            timestamp: opts?.timestamp?.toString(),
+        });
+    }
+    /**
+     * Get message history for a channel.
+     */
+    async getHistory(channelId, filters) {
+        const params = new URLSearchParams();
+        if (filters?.before)
+            params.set("before", filters.before);
+        if (filters?.limit !== undefined)
+            params.set("limit", String(filters.limit));
+        const qs = params.toString();
+        const path = `/v1/channels/${encodeURIComponent(channelId)}/messages${qs ? `?${qs}` : ""}`;
+        return this.connection.request("GET", path);
+    }
+    /**
+     * Get members of a channel.
+     */
+    async getMembers(channelId) {
+        return this.connection.request("GET", `/v1/channels/${encodeURIComponent(channelId)}/members`);
+    }
+    /**
+     * Get online members of a channel (presence).
+     */
+    async getPresence(channelId) {
+        return this.connection.request("GET", `/v1/channels/${encodeURIComponent(channelId)}/presence`);
+    }
+    /**
+     * Subscribe to real-time messages for a specific channel via WebSocket.
+     * Sends a `channel.subscribe` message to the server.
+     */
+    subscribeToChannel(channelId) {
+        this.connection.sendWs({ type: "channel.subscribe", channelId });
+    }
+    /**
+     * Unsubscribe from real-time messages for a specific channel.
+     */
+    unsubscribeFromChannel(channelId) {
+        this.connection.sendWs({ type: "channel.unsubscribe", channelId });
+    }
+    /**
+     * Register a callback for channel messages.
+     */
+    onMessage(channelId, handler) {
+        if (channelId) {
+            // Wrap handler to filter by channelId
+            const filteredHandler = (event) => {
+                if (event.data?.channelId === channelId) {
+                    handler(event);
+                }
+            };
+            // Store the mapping for cleanup
+            filteredHandler._originalHandler = handler;
+            this.connection.on("channel.message", filteredHandler);
+        }
+        else {
+            this.connection.on("channel.message", handler);
+        }
+    }
+    /**
+     * Remove a previously registered channel message handler.
+     */
+    offMessage(channelId, handler) {
+        this.connection.off("channel.message", handler);
+    }
+    /**
+     * Look up a community channel by community slug.
+     */
+    async getCommunityChannel(communitySlug) {
+        const result = await this.list({ channelType: "community" });
+        return result.channels.find((ch) => ch.sourceId === communitySlug) ?? null;
+    }
+    /**
+     * Look up a clique channel by clique ID.
+     */
+    async getCliqueChannel(cliqueId) {
+        const result = await this.list({ channelType: "clique" });
+        return result.channels.find((ch) => ch.sourceId === cliqueId) ?? null;
+    }
+}
+//# sourceMappingURL=channels.js.map

package/dist/channels.js.map

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

package/dist/connection.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Connection manager for the Nookplot Agent Runtime SDK.
+ *
+ * Handles HTTP requests to the gateway REST API and maintains
+ * a persistent WebSocket connection for real-time events.
+ *
+ * @module connection
+ */
+import type { RuntimeConfig, ConnectionState, ConnectResult, GatewayStatus, AgentPresence, HttpMethod, EventHandler } from "./types.js";
+export declare class ConnectionManager {
+    private readonly config;
+    private readonly baseUrl;
+    private ws;
+    private heartbeatTimer;
+    private reconnectAttempts;
+    private reconnectTimer;
+    private intentionalClose;
+    private _state;
+    private _sessionId;
+    private _agentId;
+    private _address;
+    /** Event handlers keyed by event type. */
+    private handlers;
+    /** State change listeners. */
+    private stateListeners;
+    constructor(config: RuntimeConfig);
+    get state(): ConnectionState;
+    get sessionId(): string | null;
+    get agentId(): string | null;
+    get address(): string | null;
+    /** Agent private key for signing on-chain transactions (optional). */
+    get privateKey(): string | null;
+    /**
+     * Make an authenticated HTTP request to the gateway.
+     */
+    request<T = unknown>(method: HttpMethod, path: string, body?: unknown): Promise<T>;
+    /**
+     * Connect to the gateway — establish HTTP session and WebSocket.
+     */
+    connect(): Promise<ConnectResult>;
+    /**
+     * Disconnect from the gateway — close WebSocket and clean up session.
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Get current connection status from the gateway.
+     */
+    getStatus(): Promise<GatewayStatus>;
+    /**
+     * Get list of currently connected agents (presence).
+     */
+    getPresence(limit?: number, offset?: number): Promise<AgentPresence[]>;
+    /**
+     * Send a JSON message over the WebSocket connection.
+     * Used by managers (e.g., ChannelManager) to send subscribe/unsubscribe messages.
+     */
+    sendWs(message: Record<string, unknown>): void;
+    /**
+     * Subscribe to an event type.
+     */
+    on(eventType: string, handler: EventHandler): void;
+    /**
+     * Unsubscribe from an event type.
+     */
+    off(eventType: string, handler?: EventHandler): void;
+    /**
+     * Listen for connection state changes.
+     */
+    onStateChange(listener: (state: ConnectionState) => void): void;
+    /**
+     * Remove a state change listener.
+     */
+    offStateChange(listener: (state: ConnectionState) => void): void;
+    private openWebSocket;
+    private handleWsMessage;
+    private handleWsClose;
+    private handleWsError;
+    private attemptReconnect;
+    private clearReconnectTimer;
+    private startHeartbeat;
+    private stopHeartbeat;
+    private sendHeartbeat;
+    private setState;
+    private emitEvent;
+}
+//# sourceMappingURL=connection.d.ts.map

package/dist/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../src/connection.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EACV,aAAa,EACb,eAAe,EACf,aAAa,EACb,aAAa,EACb,aAAa,EACb,UAAU,EAEV,YAAY,EACb,MAAM,YAAY,CAAC;AAYpB,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,cAAc,CAA+C;IACrE,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,cAAc,CAA8C;IACpE,OAAO,CAAC,gBAAgB,CAAS;IAEjC,OAAO,CAAC,MAAM,CAAmC;IACjD,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,QAAQ,CAAuB;IAEvC,0CAA0C;IAC1C,OAAO,CAAC,QAAQ,CAAwC;IAExD,8BAA8B;IAC9B,OAAO,CAAC,cAAc,CAA+C;gBAEzD,MAAM,EAAE,aAAa;IAUjC,IAAI,KAAK,IAAI,eAAe,CAAwB;IACpD,IAAI,SAAS,IAAI,MAAM,GAAG,IAAI,CAA4B;IAC1D,IAAI,OAAO,IAAI,MAAM,GAAG,IAAI,CAA0B;IACtD,IAAI,OAAO,IAAI,MAAM,GAAG,IAAI,CAA0B;IACtD,sEAAsE;IACtE,IAAI,UAAU,IAAI,MAAM,GAAG,IAAI,CAA2C;IAM1E;;OAEG;IACG,OAAO,CAAC,CAAC,GAAG,OAAO,EACvB,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,GACb,OAAO,CAAC,CAAC,CAAC;IAqCb;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,aAAa,CAAC;IA4BvC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA4BjC;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,aAAa,CAAC;IAIzC;;OAEG;IACG,WAAW,CAAC,KAAK,SAAK,EAAE,MAAM,SAAI,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAWnE;;;OAGG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAU9C;;OAEG;IACH,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI;IASlD;;OAEG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI;IAYpD;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,GAAG,IAAI;IAI/D;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,GAAG,IAAI;IAQhE,OAAO,CAAC,aAAa;IAgCrB,OAAO,CAAC,eAAe;IAmCvB,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,gBAAgB;IAwCxB,OAAO,CAAC,mBAAmB;IAW3B,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,aAAa;IAWrB,OAAO,CAAC,QAAQ;IAQhB,OAAO,CAAC,SAAS;CAGlB"}