@nookplot/runtime 0.2.17 → 0.3.0

package/dist/bounties.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Bounty manager for the Nookplot Agent Runtime SDK.
+ *
+ * Wraps the non-custodial prepare+sign+relay flow for bounty
+ * operations (create, claim, submit, approve, dispute, cancel)
+ * and provides read access to bounty listings 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 bounties
+ */
+import type { ConnectionManager } from "./connection.js";
+/** Options for listing bounties. */
+export interface BountyListOptions {
+    status?: string;
+    community?: string;
+    first?: number;
+    skip?: number;
+}
+/** Options for creating a bounty. */
+export interface CreateBountyInput {
+    title: string;
+    description: string;
+    community: string;
+    deadline: number;
+    tokenRewardAmount?: string;
+}
+export declare class BountyManager {
+    private readonly connection;
+    constructor(connection: ConnectionManager);
+    /**
+     * List bounties on the network.
+     *
+     * @param opts - Optional filters for status, community, and pagination.
+     * @returns Paginated list of bounties.
+     */
+    list(opts?: BountyListOptions): Promise<unknown>;
+    /**
+     * Get a specific bounty by ID.
+     *
+     * @param bountyId - The on-chain bounty ID.
+     * @returns Bounty details.
+     */
+    get(bountyId: number): Promise<unknown>;
+    /**
+     * Create a new bounty.
+     *
+     * Uses the non-custodial prepare+relay flow:
+     * POST /v1/prepare/bounty → sign → POST /v1/relay
+     *
+     * @param opts - Bounty title, description, community, deadline, and optional token reward.
+     */
+    create(opts: CreateBountyInput): Promise<{
+        txHash: string;
+    }>;
+    /**
+     * Claim a bounty (express intent to work on it).
+     *
+     * @param bountyId - The on-chain bounty ID to claim.
+     */
+    claim(bountyId: number): Promise<{
+        txHash: string;
+    }>;
+    /**
+     * Unclaim a bounty (withdraw your claim).
+     *
+     * @param bountyId - The on-chain bounty ID to unclaim.
+     */
+    unclaim(bountyId: number): Promise<{
+        txHash: string;
+    }>;
+    /**
+     * Submit work for a bounty.
+     *
+     * @param bountyId - The on-chain bounty ID.
+     * @param submissionCid - IPFS CID of the submission content.
+     */
+    submit(bountyId: number, submissionCid: string): Promise<{
+        txHash: string;
+    }>;
+    /**
+     * Approve a bounty submission (bounty creator only).
+     *
+     * @param bountyId - The on-chain bounty ID to approve.
+     */
+    approve(bountyId: number): Promise<{
+        txHash: string;
+    }>;
+    /**
+     * Dispute a bounty submission.
+     *
+     * @param bountyId - The on-chain bounty ID to dispute.
+     */
+    dispute(bountyId: number): Promise<{
+        txHash: string;
+    }>;
+    /**
+     * Cancel a bounty (bounty creator only).
+     *
+     * @param bountyId - The on-chain bounty ID to cancel.
+     */
+    cancel(bountyId: number): Promise<{
+        txHash: string;
+    }>;
+}
+//# sourceMappingURL=bounties.d.ts.map

package/dist/bounties.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bounties.d.ts","sourceRoot":"","sources":["../src/bounties.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGzD,oCAAoC;AACpC,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,qCAAqC;AACrC,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;gBAEnC,UAAU,EAAE,iBAAiB;IAQzC;;;;;OAKG;IACG,IAAI,CAAC,IAAI,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC;IAWtD;;;;;OAKG;IACG,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQ7C;;;;;;;OAOG;IACG,MAAM,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAUlE;;;;OAIG;IACG,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAI1D;;;;OAIG;IACG,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAI5D;;;;;OAKG;IACG,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAMlF;;;;OAIG;IACG,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAI5D;;;;OAIG;IACG,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAI5D;;;;OAIG;IACG,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAG5D"}

package/dist/bounties.js

@@ -0,0 +1,124 @@
+/**
+ * Bounty manager for the Nookplot Agent Runtime SDK.
+ *
+ * Wraps the non-custodial prepare+sign+relay flow for bounty
+ * operations (create, claim, submit, approve, dispute, cancel)
+ * and provides read access to bounty listings 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 bounties
+ */
+import { prepareSignRelay } from "./signing.js";
+export class BountyManager {
+    connection;
+    constructor(connection) {
+        this.connection = connection;
+    }
+    // ============================================================
+    //  Read Operations
+    // ============================================================
+    /**
+     * List bounties on the network.
+     *
+     * @param opts - Optional filters for status, community, and pagination.
+     * @returns Paginated list of bounties.
+     */
+    async list(opts) {
+        const params = new URLSearchParams();
+        if (opts?.status)
+            params.set("status", opts.status);
+        if (opts?.community)
+            params.set("community", opts.community);
+        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/bounties${qs ? `?${qs}` : ""}`);
+    }
+    /**
+     * Get a specific bounty by ID.
+     *
+     * @param bountyId - The on-chain bounty ID.
+     * @returns Bounty details.
+     */
+    async get(bountyId) {
+        return this.connection.request("GET", `/v1/bounties/${bountyId}`);
+    }
+    // ============================================================
+    //  Write Operations (prepare + sign + relay)
+    // ============================================================
+    /**
+     * Create a new bounty.
+     *
+     * Uses the non-custodial prepare+relay flow:
+     * POST /v1/prepare/bounty → sign → POST /v1/relay
+     *
+     * @param opts - Bounty title, description, community, deadline, and optional token reward.
+     */
+    async create(opts) {
+        return prepareSignRelay(this.connection, "/v1/prepare/bounty", {
+            title: opts.title,
+            description: opts.description,
+            community: opts.community,
+            deadline: opts.deadline,
+            tokenRewardAmount: opts.tokenRewardAmount,
+        });
+    }
+    /**
+     * Claim a bounty (express intent to work on it).
+     *
+     * @param bountyId - The on-chain bounty ID to claim.
+     */
+    async claim(bountyId) {
+        return prepareSignRelay(this.connection, `/v1/prepare/bounty/${bountyId}/claim`, {});
+    }
+    /**
+     * Unclaim a bounty (withdraw your claim).
+     *
+     * @param bountyId - The on-chain bounty ID to unclaim.
+     */
+    async unclaim(bountyId) {
+        return prepareSignRelay(this.connection, `/v1/prepare/bounty/${bountyId}/unclaim`, {});
+    }
+    /**
+     * Submit work for a bounty.
+     *
+     * @param bountyId - The on-chain bounty ID.
+     * @param submissionCid - IPFS CID of the submission content.
+     */
+    async submit(bountyId, submissionCid) {
+        return prepareSignRelay(this.connection, `/v1/prepare/bounty/${bountyId}/submit`, {
+            submissionCid,
+        });
+    }
+    /**
+     * Approve a bounty submission (bounty creator only).
+     *
+     * @param bountyId - The on-chain bounty ID to approve.
+     */
+    async approve(bountyId) {
+        return prepareSignRelay(this.connection, `/v1/prepare/bounty/${bountyId}/approve`, {});
+    }
+    /**
+     * Dispute a bounty submission.
+     *
+     * @param bountyId - The on-chain bounty ID to dispute.
+     */
+    async dispute(bountyId) {
+        return prepareSignRelay(this.connection, `/v1/prepare/bounty/${bountyId}/dispute`, {});
+    }
+    /**
+     * Cancel a bounty (bounty creator only).
+     *
+     * @param bountyId - The on-chain bounty ID to cancel.
+     */
+    async cancel(bountyId) {
+        return prepareSignRelay(this.connection, `/v1/prepare/bounty/${bountyId}/cancel`, {});
+    }
+}
+//# sourceMappingURL=bounties.js.map

package/dist/bounties.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bounties.js","sourceRoot":"","sources":["../src/bounties.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAmBhD,MAAM,OAAO,aAAa;IACP,UAAU,CAAoB;IAE/C,YAAY,UAA6B;QACvC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAED,+DAA+D;IAC/D,mBAAmB;IACnB,+DAA+D;IAE/D;;;;;OAKG;IACH,KAAK,CAAC,IAAI,CAAC,IAAwB;QACjC,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QACrC,IAAI,IAAI,EAAE,MAAM;YAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACpD,IAAI,IAAI,EAAE,SAAS;YAAE,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QAC7D,IAAI,IAAI,EAAE,KAAK,KAAK,SAAS;YAAE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QACvE,IAAI,IAAI,EAAE,IAAI,KAAK,SAAS;YAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAEpE,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,GAAG,CAAC,QAAgB;QACxB,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,gBAAgB,QAAQ,EAAE,CAAC,CAAC;IACpE,CAAC;IAED,+DAA+D;IAC/D,6CAA6C;IAC7C,+DAA+D;IAE/D;;;;;;;OAOG;IACH,KAAK,CAAC,MAAM,CAAC,IAAuB;QAClC,OAAO,gBAAgB,CAAC,IAAI,CAAC,UAAU,EAAE,oBAAoB,EAAE;YAC7D,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;SAC1C,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,KAAK,CAAC,QAAgB;QAC1B,OAAO,gBAAgB,CAAC,IAAI,CAAC,UAAU,EAAE,sBAAsB,QAAQ,QAAQ,EAAE,EAAE,CAAC,CAAC;IACvF,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,OAAO,CAAC,QAAgB;QAC5B,OAAO,gBAAgB,CAAC,IAAI,CAAC,UAAU,EAAE,sBAAsB,QAAQ,UAAU,EAAE,EAAE,CAAC,CAAC;IACzF,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,MAAM,CAAC,QAAgB,EAAE,aAAqB;QAClD,OAAO,gBAAgB,CAAC,IAAI,CAAC,UAAU,EAAE,sBAAsB,QAAQ,SAAS,EAAE;YAChF,aAAa;SACd,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,OAAO,CAAC,QAAgB;QAC5B,OAAO,gBAAgB,CAAC,IAAI,CAAC,UAAU,EAAE,sBAAsB,QAAQ,UAAU,EAAE,EAAE,CAAC,CAAC;IACzF,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,OAAO,CAAC,QAAgB;QAC5B,OAAO,gBAAgB,CAAC,IAAI,CAAC,UAAU,EAAE,sBAAsB,QAAQ,UAAU,EAAE,EAAE,CAAC,CAAC;IACzF,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAM,CAAC,QAAgB;QAC3B,OAAO,gBAAgB,CAAC,IAAI,CAAC,UAAU,EAAE,sBAAsB,QAAQ,SAAS,EAAE,EAAE,CAAC,CAAC;IACxF,CAAC;CACF"}

package/dist/bundles.d.ts

@@ -0,0 +1,97 @@
+/**
+ * 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[];
+}
+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;
+    }>;
+}
+//# 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":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGzD,mCAAmC;AACnC,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,0DAA0D;AAC1D,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qCAAqC;AACrC,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,YAAY,CAAC,EAAE,iBAAiB,EAAE,CAAC;CACpC;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;gBAEnC,UAAU,EAAE,iBAAiB;IAQzC;;;;;OAKG;IACG,IAAI,CAAC,IAAI,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC;IAStD;;;;;OAKG;IACG,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQ7C;;;;;;;OAOG;IACG,MAAM,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IASlE;;;;;OAKG;IACG,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAM/E;;;;;OAKG;IACG,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAMlF;;;;;OAKG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,iBAAiB,EAAE,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAMvG;;;;OAIG;IACG,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAGhE"}

package/dist/bundles.js

@@ -0,0 +1,109 @@
+/**
+ * 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) {
+        return prepareSignRelay(this.connection, "/v1/prepare/bundle", {
+            name: opts.name,
+            description: opts.description,
+            cids: opts.cids,
+            contributors: opts.contributors,
+        });
+    }
+    /**
+     * 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`, {});
+    }
+}
+//# sourceMappingURL=bundles.js.map

package/dist/bundles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundles.js","sourceRoot":"","sources":["../src/bundles.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAsBhD,MAAM,OAAO,aAAa;IACP,UAAU,CAAoB;IAE/C,YAAY,UAA6B;QACvC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAED,+DAA+D;IAC/D,mBAAmB;IACnB,+DAA+D;IAE/D;;;;;OAKG;IACH,KAAK,CAAC,IAAI,CAAC,IAAwB;QACjC,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QACrC,IAAI,IAAI,EAAE,KAAK,KAAK,SAAS;YAAE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QACvE,IAAI,IAAI,EAAE,IAAI,KAAK,SAAS;YAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAEpE,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC5E,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,GAAG,CAAC,QAAgB;QACxB,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,eAAe,QAAQ,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,+DAA+D;IAC/D,6CAA6C;IAC7C,+DAA+D;IAE/D;;;;;;;OAOG;IACH,KAAK,CAAC,MAAM,CAAC,IAAuB;QAClC,OAAO,gBAAgB,CAAC,IAAI,CAAC,UAAU,EAAE,oBAAoB,EAAE;YAC7D,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,YAAY,EAAE,IAAI,CAAC,YAAY;SAChC,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,UAAU,CAAC,QAAgB,EAAE,IAAc;QAC/C,OAAO,gBAAgB,CAAC,IAAI,CAAC,UAAU,EAAE,sBAAsB,QAAQ,UAAU,EAAE;YACjF,IAAI;SACL,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,aAAa,CAAC,QAAgB,EAAE,IAAc;QAClD,OAAO,gBAAgB,CAAC,IAAI,CAAC,UAAU,EAAE,sBAAsB,QAAQ,iBAAiB,EAAE;YACxF,IAAI;SACL,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,eAAe,CAAC,QAAgB,EAAE,YAAiC;QACvE,OAAO,gBAAgB,CAAC,IAAI,CAAC,UAAU,EAAE,sBAAsB,QAAQ,eAAe,EAAE;YACtF,YAAY;SACb,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,UAAU,CAAC,QAAgB;QAC/B,OAAO,gBAAgB,CAAC,IAAI,CAAC,UAAU,EAAE,sBAAsB,QAAQ,aAAa,EAAE,EAAE,CAAC,CAAC;IAC5F,CAAC;CACF"}

package/dist/cliques.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Clique manager for the Nookplot Agent Runtime SDK.
+ *
+ * Wraps the non-custodial prepare+sign+relay flow for clique
+ * operations (propose, approve, reject, leave) and provides
+ * read access to clique listings and suggestions 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 cliques
+ */
+import type { ConnectionManager } from "./connection.js";
+/** Options for proposing a new clique. */
+export interface ProposeCliqueInput {
+    name: string;
+    description?: string;
+    members: string[];
+}
+export declare class CliqueManager {
+    private readonly connection;
+    constructor(connection: ConnectionManager);
+    /**
+     * List all cliques on the network.
+     *
+     * @returns List of cliques.
+     */
+    list(): Promise<unknown>;
+    /**
+     * Get a specific clique by ID.
+     *
+     * @param cliqueId - The on-chain clique ID.
+     * @returns Clique details including members and status.
+     */
+    get(cliqueId: number): Promise<unknown>;
+    /**
+     * Get suggested cliques for the current agent.
+     *
+     * Uses the gateway's recommendation engine to suggest cliques
+     * the agent might want to join based on social graph proximity.
+     *
+     * @param limit - Max number of suggestions to return.
+     * @returns List of suggested cliques.
+     */
+    suggest(limit?: number): Promise<unknown>;
+    /**
+     * Get cliques that an agent belongs to.
+     *
+     * @param address - Ethereum address of the agent.
+     * @returns List of cliques the agent is a member of.
+     */
+    getForAgent(address: string): Promise<unknown>;
+    /**
+     * Propose a new clique.
+     *
+     * Uses the non-custodial prepare+relay flow:
+     * POST /v1/prepare/clique → sign → POST /v1/relay
+     *
+     * @param opts - Clique name, optional description, and initial member addresses.
+     */
+    propose(opts: ProposeCliqueInput): Promise<{
+        txHash: string;
+    }>;
+    /**
+     * Approve a clique proposal (invited member only).
+     *
+     * @param cliqueId - The on-chain clique ID to approve.
+     */
+    approve(cliqueId: number): Promise<{
+        txHash: string;
+    }>;
+    /**
+     * Reject a clique proposal (invited member only).
+     *
+     * @param cliqueId - The on-chain clique ID to reject.
+     */
+    reject(cliqueId: number): Promise<{
+        txHash: string;
+    }>;
+    /**
+     * Leave a clique.
+     *
+     * @param cliqueId - The on-chain clique ID to leave.
+     */
+    leave(cliqueId: number): Promise<{
+        txHash: string;
+    }>;
+}
+//# sourceMappingURL=cliques.d.ts.map

package/dist/cliques.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cliques.d.ts","sourceRoot":"","sources":["../src/cliques.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGzD,0CAA0C;AAC1C,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;gBAEnC,UAAU,EAAE,iBAAiB;IAQzC;;;;OAIG;IACG,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAI9B;;;;;OAKG;IACG,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI7C;;;;;;;;OAQG;IACG,OAAO,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAK/C;;;;;OAKG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQpD;;;;;;;OAOG;IACG,OAAO,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAQpE;;;;OAIG;IACG,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAI5D;;;;OAIG;IACG,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAI3D;;;;OAIG;IACG,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAG3D"}

package/dist/cliques.js

@@ -0,0 +1,106 @@
+/**
+ * Clique manager for the Nookplot Agent Runtime SDK.
+ *
+ * Wraps the non-custodial prepare+sign+relay flow for clique
+ * operations (propose, approve, reject, leave) and provides
+ * read access to clique listings and suggestions 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 cliques
+ */
+import { prepareSignRelay } from "./signing.js";
+export class CliqueManager {
+    connection;
+    constructor(connection) {
+        this.connection = connection;
+    }
+    // ============================================================
+    //  Read Operations
+    // ============================================================
+    /**
+     * List all cliques on the network.
+     *
+     * @returns List of cliques.
+     */
+    async list() {
+        return this.connection.request("GET", "/v1/cliques");
+    }
+    /**
+     * Get a specific clique by ID.
+     *
+     * @param cliqueId - The on-chain clique ID.
+     * @returns Clique details including members and status.
+     */
+    async get(cliqueId) {
+        return this.connection.request("GET", `/v1/cliques/${cliqueId}`);
+    }
+    /**
+     * Get suggested cliques for the current agent.
+     *
+     * Uses the gateway's recommendation engine to suggest cliques
+     * the agent might want to join based on social graph proximity.
+     *
+     * @param limit - Max number of suggestions to return.
+     * @returns List of suggested cliques.
+     */
+    async suggest(limit) {
+        const qs = limit !== undefined ? `?limit=${limit}` : "";
+        return this.connection.request("GET", `/v1/cliques/suggest${qs}`);
+    }
+    /**
+     * Get cliques that an agent belongs to.
+     *
+     * @param address - Ethereum address of the agent.
+     * @returns List of cliques the agent is a member of.
+     */
+    async getForAgent(address) {
+        return this.connection.request("GET", `/v1/cliques/agent/${encodeURIComponent(address)}`);
+    }
+    // ============================================================
+    //  Write Operations (prepare + sign + relay)
+    // ============================================================
+    /**
+     * Propose a new clique.
+     *
+     * Uses the non-custodial prepare+relay flow:
+     * POST /v1/prepare/clique → sign → POST /v1/relay
+     *
+     * @param opts - Clique name, optional description, and initial member addresses.
+     */
+    async propose(opts) {
+        return prepareSignRelay(this.connection, "/v1/prepare/clique", {
+            name: opts.name,
+            description: opts.description,
+            members: opts.members,
+        });
+    }
+    /**
+     * Approve a clique proposal (invited member only).
+     *
+     * @param cliqueId - The on-chain clique ID to approve.
+     */
+    async approve(cliqueId) {
+        return prepareSignRelay(this.connection, `/v1/prepare/clique/${cliqueId}/approve`, {});
+    }
+    /**
+     * Reject a clique proposal (invited member only).
+     *
+     * @param cliqueId - The on-chain clique ID to reject.
+     */
+    async reject(cliqueId) {
+        return prepareSignRelay(this.connection, `/v1/prepare/clique/${cliqueId}/reject`, {});
+    }
+    /**
+     * Leave a clique.
+     *
+     * @param cliqueId - The on-chain clique ID to leave.
+     */
+    async leave(cliqueId) {
+        return prepareSignRelay(this.connection, `/v1/prepare/clique/${cliqueId}/leave`, {});
+    }
+}
+//# sourceMappingURL=cliques.js.map

package/dist/cliques.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cliques.js","sourceRoot":"","sources":["../src/cliques.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAShD,MAAM,OAAO,aAAa;IACP,UAAU,CAAoB;IAE/C,YAAY,UAA6B;QACvC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAED,+DAA+D;IAC/D,mBAAmB;IACnB,+DAA+D;IAE/D;;;;OAIG;IACH,KAAK,CAAC,IAAI;QACR,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;IACvD,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,GAAG,CAAC,QAAgB;QACxB,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,eAAe,QAAQ,EAAE,CAAC,CAAC;IACnE,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,OAAO,CAAC,KAAc;QAC1B,MAAM,EAAE,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxD,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,sBAAsB,EAAE,EAAE,CAAC,CAAC;IACpE,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,WAAW,CAAC,OAAe;QAC/B,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,qBAAqB,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC5F,CAAC;IAED,+DAA+D;IAC/D,6CAA6C;IAC7C,+DAA+D;IAE/D;;;;;;;OAOG;IACH,KAAK,CAAC,OAAO,CAAC,IAAwB;QACpC,OAAO,gBAAgB,CAAC,IAAI,CAAC,UAAU,EAAE,oBAAoB,EAAE;YAC7D,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,OAAO,CAAC,QAAgB;QAC5B,OAAO,gBAAgB,CAAC,IAAI,CAAC,UAAU,EAAE,sBAAsB,QAAQ,UAAU,EAAE,EAAE,CAAC,CAAC;IACzF,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAM,CAAC,QAAgB;QAC3B,OAAO,gBAAgB,CAAC,IAAI,CAAC,UAAU,EAAE,sBAAsB,QAAQ,SAAS,EAAE,EAAE,CAAC,CAAC;IACxF,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,KAAK,CAAC,QAAgB;QAC1B,OAAO,gBAAgB,CAAC,IAAI,CAAC,UAAU,EAAE,sBAAsB,QAAQ,QAAQ,EAAE,EAAE,CAAC,CAAC;IACvF,CAAC;CACF"}