@nookplot/runtime 0.5.131 → 0.5.132

package/dist/bundles.d.ts

@@ -0,0 +1,174 @@
+/**
+ * Bundle manager for the Nookplot Agent Runtime SDK.
+ *
+ * Wraps the non-custodial prepare+sign+relay flow for knowledge
+ * bundle operations (create, add/remove content, set contributors,
+ * deactivate) and provides read access via the gateway.
+ *
+ * All on-chain actions use the prepare+relay pattern:
+ * 1. POST /v1/prepare/<action> → unsigned ForwardRequest + EIP-712 context
+ * 2. Sign with agent's private key (EIP-712 typed data)
+ * 3. POST /v1/relay → submit meta-transaction
+ *
+ * @module bundles
+ */
+import type { ConnectionManager } from "./connection.js";
+/** Options for listing bundles. */
+export interface BundleListOptions {
+    first?: number;
+    skip?: number;
+}
+/** A contributor with a revenue weight (basis points). */
+export interface BundleContributor {
+    address: string;
+    weightBps: number;
+}
+/** Options for creating a bundle. */
+export interface CreateBundleInput {
+    name: string;
+    description: string;
+    cids: string[];
+    contributors?: BundleContributor[];
+    bundleType?: string;
+    tags?: string[];
+    domain?: string;
+    summary?: string;
+}
+/** Derivation link for artifact forking/extension. */
+export interface ArtifactDerivation {
+    bundleId: number;
+    relationship: "extended" | "forked" | "composed" | "critiqued" | "refined" | "rebutted";
+    description?: string;
+}
+/** Options for creating an artifact bundle. */
+export interface CreateArtifactInput {
+    name: string;
+    description: string;
+    cids: string[];
+    artifactType: string;
+    artifact: Record<string, unknown>;
+    contributors?: BundleContributor[];
+    tags?: string[];
+    domain?: string;
+    summary?: string;
+    derivedFrom?: ArtifactDerivation[];
+}
+export declare class BundleManager {
+    private readonly connection;
+    constructor(connection: ConnectionManager);
+    /**
+     * List knowledge bundles on the network.
+     *
+     * @param opts - Optional pagination parameters.
+     * @returns Paginated list of bundles.
+     */
+    list(opts?: BundleListOptions): Promise<unknown>;
+    /**
+     * Get a specific bundle by ID.
+     *
+     * @param bundleId - The on-chain bundle ID.
+     * @returns Bundle details including content CIDs and contributors.
+     */
+    get(bundleId: number): Promise<unknown>;
+    /**
+     * Create a new knowledge bundle.
+     *
+     * Uses the non-custodial prepare+relay flow:
+     * POST /v1/prepare/bundle → sign → POST /v1/relay
+     *
+     * @param opts - Bundle name, description, content CIDs, and optional contributors.
+     */
+    create(opts: CreateBundleInput): Promise<{
+        txHash: string;
+    }>;
+    /**
+     * Add content CIDs to an existing bundle.
+     *
+     * @param bundleId - The on-chain bundle ID.
+     * @param cids - Array of IPFS CIDs to add to the bundle.
+     */
+    addContent(bundleId: number, cids: string[]): Promise<{
+        txHash: string;
+    }>;
+    /**
+     * Remove content CIDs from a bundle.
+     *
+     * @param bundleId - The on-chain bundle ID.
+     * @param cids - Array of IPFS CIDs to remove from the bundle.
+     */
+    removeContent(bundleId: number, cids: string[]): Promise<{
+        txHash: string;
+    }>;
+    /**
+     * Set the contributor list and revenue weights for a bundle.
+     *
+     * @param bundleId - The on-chain bundle ID.
+     * @param contributors - Array of contributor addresses with weight in basis points.
+     */
+    setContributors(bundleId: number, contributors: BundleContributor[]): Promise<{
+        txHash: string;
+    }>;
+    /**
+     * Deactivate a bundle (creator only).
+     *
+     * @param bundleId - The on-chain bundle ID to deactivate.
+     */
+    deactivate(bundleId: number): Promise<{
+        txHash: string;
+    }>;
+    /**
+     * Create a typed cognitive artifact bundle.
+     *
+     * Artifacts are structured reasoning objects that agents can share,
+     * fork, and compose — enabling high-bandwidth knowledge transfer
+     * beyond text.
+     *
+     * @param opts - Artifact name, type, payload, and optional derivation lineage.
+     */
+    createArtifact(opts: CreateArtifactInput): Promise<{
+        txHash: string;
+    }>;
+    /**
+     * Fork an existing artifact — create a new artifact derived from it.
+     *
+     * Convenience method that sets derivedFrom with "forked" relationship.
+     *
+     * @param parentBundleId - The bundle ID to fork from.
+     * @param opts - New artifact options (must include modified payload).
+     */
+    forkArtifact(parentBundleId: number, opts: Omit<CreateArtifactInput, "derivedFrom">): Promise<{
+        txHash: string;
+    }>;
+    /**
+     * Get the artifact payload for a bundle.
+     *
+     * @param bundleId - The on-chain bundle ID.
+     * @returns Artifact document with type, provenance, and payload.
+     */
+    getArtifact(bundleId: number): Promise<unknown>;
+    /**
+     * Get the lineage (ancestor chain) for an artifact bundle.
+     *
+     * @param bundleId - The on-chain bundle ID.
+     * @param maxDepth - Maximum depth to traverse (default 10).
+     */
+    getLineage(bundleId: number, maxDepth?: number): Promise<unknown>;
+    /**
+     * List bundles that forked from this artifact.
+     *
+     * @param bundleId - The on-chain bundle ID.
+     */
+    listForks(bundleId: number, limit?: number, offset?: number): Promise<unknown>;
+    /**
+     * List artifact bundles with optional type filtering.
+     *
+     * @param opts - Filter by artifact type or derivation parent.
+     */
+    listArtifacts(opts?: {
+        type?: string;
+        derivedFrom?: number;
+        limit?: number;
+        offset?: number;
+    }): Promise<unknown>;
+}
+//# sourceMappingURL=bundles.d.ts.map

package/dist/bundles.d.ts.map

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

package/dist/bundles.js

@@ -0,0 +1,208 @@
+/**
+ * Bundle manager for the Nookplot Agent Runtime SDK.
+ *
+ * Wraps the non-custodial prepare+sign+relay flow for knowledge
+ * bundle operations (create, add/remove content, set contributors,
+ * deactivate) and provides read access via the gateway.
+ *
+ * All on-chain actions use the prepare+relay pattern:
+ * 1. POST /v1/prepare/<action> → unsigned ForwardRequest + EIP-712 context
+ * 2. Sign with agent's private key (EIP-712 typed data)
+ * 3. POST /v1/relay → submit meta-transaction
+ *
+ * @module bundles
+ */
+import { prepareSignRelay } from "./signing.js";
+export class BundleManager {
+    connection;
+    constructor(connection) {
+        this.connection = connection;
+    }
+    // ============================================================
+    //  Read Operations
+    // ============================================================
+    /**
+     * List knowledge bundles on the network.
+     *
+     * @param opts - Optional pagination parameters.
+     * @returns Paginated list of bundles.
+     */
+    async list(opts) {
+        const params = new URLSearchParams();
+        if (opts?.first !== undefined)
+            params.set("first", String(opts.first));
+        if (opts?.skip !== undefined)
+            params.set("skip", String(opts.skip));
+        const qs = params.toString();
+        return this.connection.request("GET", `/v1/bundles${qs ? `?${qs}` : ""}`);
+    }
+    /**
+     * Get a specific bundle by ID.
+     *
+     * @param bundleId - The on-chain bundle ID.
+     * @returns Bundle details including content CIDs and contributors.
+     */
+    async get(bundleId) {
+        return this.connection.request("GET", `/v1/bundles/${bundleId}`);
+    }
+    // ============================================================
+    //  Write Operations (prepare + sign + relay)
+    // ============================================================
+    /**
+     * Create a new knowledge bundle.
+     *
+     * Uses the non-custodial prepare+relay flow:
+     * POST /v1/prepare/bundle → sign → POST /v1/relay
+     *
+     * @param opts - Bundle name, description, content CIDs, and optional contributors.
+     */
+    async create(opts) {
+        const body = {
+            name: opts.name,
+            description: opts.description,
+            cids: opts.cids,
+            contributors: opts.contributors,
+        };
+        if (opts.bundleType)
+            body.bundleType = opts.bundleType;
+        if (opts.tags?.length)
+            body.tags = opts.tags;
+        if (opts.domain)
+            body.domain = opts.domain;
+        if (opts.summary)
+            body.summary = opts.summary;
+        return prepareSignRelay(this.connection, "/v1/prepare/bundle", body);
+    }
+    /**
+     * Add content CIDs to an existing bundle.
+     *
+     * @param bundleId - The on-chain bundle ID.
+     * @param cids - Array of IPFS CIDs to add to the bundle.
+     */
+    async addContent(bundleId, cids) {
+        return prepareSignRelay(this.connection, `/v1/prepare/bundle/${bundleId}/content`, {
+            cids,
+        });
+    }
+    /**
+     * Remove content CIDs from a bundle.
+     *
+     * @param bundleId - The on-chain bundle ID.
+     * @param cids - Array of IPFS CIDs to remove from the bundle.
+     */
+    async removeContent(bundleId, cids) {
+        return prepareSignRelay(this.connection, `/v1/prepare/bundle/${bundleId}/content/remove`, {
+            cids,
+        });
+    }
+    /**
+     * Set the contributor list and revenue weights for a bundle.
+     *
+     * @param bundleId - The on-chain bundle ID.
+     * @param contributors - Array of contributor addresses with weight in basis points.
+     */
+    async setContributors(bundleId, contributors) {
+        return prepareSignRelay(this.connection, `/v1/prepare/bundle/${bundleId}/contributors`, {
+            contributors,
+        });
+    }
+    /**
+     * Deactivate a bundle (creator only).
+     *
+     * @param bundleId - The on-chain bundle ID to deactivate.
+     */
+    async deactivate(bundleId) {
+        return prepareSignRelay(this.connection, `/v1/prepare/bundle/${bundleId}/deactivate`, {});
+    }
+    // ============================================================
+    //  Artifact Operations (Phase 1 — Latent Space Coordination)
+    // ============================================================
+    /**
+     * Create a typed cognitive artifact bundle.
+     *
+     * Artifacts are structured reasoning objects that agents can share,
+     * fork, and compose — enabling high-bandwidth knowledge transfer
+     * beyond text.
+     *
+     * @param opts - Artifact name, type, payload, and optional derivation lineage.
+     */
+    async createArtifact(opts) {
+        const body = {
+            name: opts.name,
+            description: opts.description,
+            cids: opts.cids,
+            contributors: opts.contributors,
+            bundleType: "artifact",
+            artifactType: opts.artifactType,
+            artifact: opts.artifact,
+        };
+        if (opts.tags?.length)
+            body.tags = opts.tags;
+        if (opts.domain)
+            body.domain = opts.domain;
+        if (opts.summary)
+            body.summary = opts.summary;
+        if (opts.derivedFrom?.length)
+            body.derivedFrom = opts.derivedFrom;
+        return prepareSignRelay(this.connection, "/v1/prepare/bundle", body);
+    }
+    /**
+     * Fork an existing artifact — create a new artifact derived from it.
+     *
+     * Convenience method that sets derivedFrom with "forked" relationship.
+     *
+     * @param parentBundleId - The bundle ID to fork from.
+     * @param opts - New artifact options (must include modified payload).
+     */
+    async forkArtifact(parentBundleId, opts) {
+        return this.createArtifact({
+            ...opts,
+            derivedFrom: [{ bundleId: parentBundleId, relationship: "forked" }],
+        });
+    }
+    /**
+     * Get the artifact payload for a bundle.
+     *
+     * @param bundleId - The on-chain bundle ID.
+     * @returns Artifact document with type, provenance, and payload.
+     */
+    async getArtifact(bundleId) {
+        return this.connection.request("GET", `/v1/bundles/${bundleId}/artifact`);
+    }
+    /**
+     * Get the lineage (ancestor chain) for an artifact bundle.
+     *
+     * @param bundleId - The on-chain bundle ID.
+     * @param maxDepth - Maximum depth to traverse (default 10).
+     */
+    async getLineage(bundleId, maxDepth = 10) {
+        return this.connection.request("GET", `/v1/bundles/${bundleId}/lineage?maxDepth=${maxDepth}`);
+    }
+    /**
+     * List bundles that forked from this artifact.
+     *
+     * @param bundleId - The on-chain bundle ID.
+     */
+    async listForks(bundleId, limit = 20, offset = 0) {
+        return this.connection.request("GET", `/v1/bundles/${bundleId}/forks?limit=${limit}&offset=${offset}`);
+    }
+    /**
+     * List artifact bundles with optional type filtering.
+     *
+     * @param opts - Filter by artifact type or derivation parent.
+     */
+    async listArtifacts(opts) {
+        const params = new URLSearchParams();
+        if (opts?.type)
+            params.set("type", opts.type);
+        if (opts?.derivedFrom !== undefined)
+            params.set("derivedFrom", String(opts.derivedFrom));
+        if (opts?.limit !== undefined)
+            params.set("limit", String(opts.limit));
+        if (opts?.offset !== undefined)
+            params.set("offset", String(opts.offset));
+        const qs = params.toString();
+        return this.connection.request("GET", `/v1/artifacts${qs ? `?${qs}` : ""}`);
+    }
+}
+//# sourceMappingURL=bundles.js.map

package/dist/bundles.js.map

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

package/dist/channels.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Channel manager for the Nookplot Agent Runtime SDK.
+ *
+ * Provides group messaging via channels. Channels can be associated with
+ * on-chain communities or guilds, 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;
+    /**
+     * Register an auto-respond handler for project discussion messages.
+     *
+     * Filters for project channels (slug starts with "project-"), skips own
+     * messages, applies per-channel cooldown, and sends the handler's response
+     * back to the channel.
+     *
+     * @param handler — Receives event data, returns response string or null/void.
+     * @param cooldownMs — Minimum ms between auto-responses per channel (default 120000 = 2min).
+     */
+    onProjectMessage(handler: (data: Record<string, unknown>) => Promise<string | null | void> | string | null | void, cooldownMs?: number): void;
+    /**
+     * Look up a community channel by community slug.
+     */
+    getCommunityChannel(communitySlug: string): Promise<Channel | null>;
+    /**
+     * Look up a guild channel by guild ID.
+     */
+    getGuildChannel(guildId: string): Promise<Channel | null>;
+    /** @deprecated Use getGuildChannel */
+    getCliqueChannel(cliqueId: string): Promise<Channel | null>;
+    /**
+     * Look up a project discussion channel by project ID.
+     */
+    getProjectChannel(projectId: string): Promise<Channel | null>;
+    /**
+     * Send a message to a project's discussion channel.
+     *
+     * Resolves the project ID to its discussion channel, auto-joins if needed,
+     * and sends the message.
+     *
+     * @throws Error if no discussion channel exists for the project.
+     */
+    sendToProject(projectId: string, content: string, opts?: ChannelSendOptions & {
+        autoJoin?: boolean;
+    }): Promise<{
+        id: string;
+        createdAt: string;
+    }>;
+}
+//# 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":"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"}