@nookplot/runtime 0.5.123 → 0.5.124

package/dist/manifestActivationHook.js

@@ -0,0 +1,180 @@
+import { hooks as defaultHooks } from "./hooks.js";
+/* ------------------------------------------------------------------ */
+/*  Allowlists                                                         */
+/* ------------------------------------------------------------------ */
+/**
+ * Signal types that represent a real cognitive task worth broadcasting as
+ * `current_focus`. Excludes pure social/notification signals (`channel_message`,
+ * `dm_received`, `new_follower`, `attestation_received`, `welcome_guide`)
+ * whose embedding text would be meaningless for routing.
+ */
+export const TASK_BEARING_SIGNALS = new Set([
+    "mining_opportunity",
+    "bounty",
+    "bounty_posted_to_project",
+    "bounty_application_approved",
+    "bounty_application_submitted",
+    "bounty_work_submitted",
+    "bounty_submission_selected",
+    "bounty_claimer_approved",
+    "task_assigned",
+    "task_created",
+    "agreement_created",
+    "credit_agreement_created",
+    "credit_agreement_accepted",
+    "intent_matched",
+    "intent_accepted",
+    "proposal_received",
+    "swarm_subtask_available",
+    "teaching_opportunity",
+    "teaching_proposed",
+    "teaching_accepted",
+    "community_gap",
+    "attestation_opportunity",
+    "team_invitation",
+    "team_assembly_suggested",
+    "collab_request",
+    "pending_review",
+    "revision_requested",
+    "review_comment_added",
+    "submission_verified",
+    "milestone_reached",
+    "files_committed",
+    "interesting_project",
+    "specialization_path",
+    "onboarding_suggestion",
+    "new_bundle_in_domain",
+    "bundle_cited",
+    "work_delivered",
+    "agreement_disputed",
+    "dream_prompt",
+]);
+/**
+ * Action types that meaningfully complete a task — clearing `current_focus`
+ * after one of these fires lets matching algorithms know the agent moved on.
+ * Conservative: missing entries leave focus stuck until the next
+ * task-bearing signal, which is benign.
+ */
+export const TERMINAL_ACTIONS = new Set([
+    "submit_mining_solution",
+    "deliver_work",
+    "submit_credit_work",
+    "accept_credit_agreement",
+    "accept_bounty_submission",
+    "mark_task_done",
+    "complete_review",
+    "finalize_swarm_subtask",
+    "finalize_rlm_trajectory",
+    "resolve_clarification",
+    "settle_agreement",
+    "release_payment",
+    "publish_bundle",
+]);
+const DEFAULT_ERROR_WINDOW_MS = 5 * 60 * 1000;
+const DEFAULT_ERROR_THRESHOLD = 3;
+const DEFAULT_MAX_UNCERTAINTIES = 20;
+/* ------------------------------------------------------------------ */
+/*  Domain extraction                                                  */
+/* ------------------------------------------------------------------ */
+/**
+ * Best-effort domain inference from a signal payload. Returns `"general"` as
+ * a non-empty fallback so the resulting `focusText` always clears the
+ * `manifestService` 10-character minimum.
+ */
+export function extractDomain(data) {
+    const tags = data.domainTags;
+    if (Array.isArray(tags) && tags.length > 0 && typeof tags[0] === "string" && tags[0].length > 0) {
+        return tags[0];
+    }
+    const dom = data.domain;
+    if (typeof dom === "string" && dom.length > 0)
+        return dom;
+    const skill = data.skillDomain;
+    if (typeof skill === "string" && skill.length > 0)
+        return skill;
+    const meta = data.metadata;
+    if (meta && typeof meta === "object") {
+        const md = meta.domain;
+        if (typeof md === "string" && md.length > 0)
+            return md;
+    }
+    if (typeof data.community === "string" && data.community.length > 0)
+        return data.community;
+    return "general";
+}
+/* ------------------------------------------------------------------ */
+/*  Installer                                                          */
+/* ------------------------------------------------------------------ */
+/**
+ * Subscribe to runtime lifecycle hooks and write to the agent's manifest as
+ * tasks start, complete, or fail. Returns a disposer that removes every
+ * registered listener.
+ */
+export function installManifestActivationHook(runtime, opts = {}) {
+    const hooks = opts.hooks ?? runtime.hooks ?? defaultHooks;
+    const windowMs = opts.errorDebounceWindowMs ?? DEFAULT_ERROR_WINDOW_MS;
+    const threshold = opts.errorThreshold ?? DEFAULT_ERROR_THRESHOLD;
+    const maxUncertainties = opts.maxUncertainties ?? DEFAULT_MAX_UNCERTAINTIES;
+    /** Per-actionType error counter, scoped to this hook installation. */
+    const errorCounters = new Map();
+    const onSignal = (data) => {
+        const signalType = data.signalType ?? "";
+        if (!signalType || !TASK_BEARING_SIGNALS.has(signalType))
+            return;
+        const domain = extractDomain(data);
+        runtime.manifests
+            .setFocus({ taskType: signalType, domain })
+            .catch(() => { });
+    };
+    const onActionEnd = (payload) => {
+        if (!TERMINAL_ACTIONS.has(payload.actionType))
+            return;
+        runtime.manifests
+            .updateManifest({ currentFocus: null })
+            .catch(() => { });
+    };
+    const onActionError = (payload) => {
+        const now = Date.now();
+        const entry = errorCounters.get(payload.actionType);
+        if (!entry || now - entry.firstAt > windowMs) {
+            errorCounters.set(payload.actionType, { count: 1, firstAt: now });
+            return;
+        }
+        entry.count += 1;
+        if (entry.count < threshold)
+            return;
+        errorCounters.delete(payload.actionType);
+        const msg = payload.error?.message ?? String(payload.error ?? "unknown");
+        void appendUncertainty(runtime, `Stuck on ${payload.actionType}: ${msg.slice(0, 200)}`, 0.7, maxUncertainties);
+    };
+    const onDoomLoop = (payload) => {
+        void appendUncertainty(runtime, `Doom loop on ${payload.offender}`, 0.9, maxUncertainties);
+    };
+    const disposers = [
+        hooks.register("signal_received", onSignal),
+        hooks.register("action_end", onActionEnd),
+        hooks.register("action_error", onActionError),
+        hooks.register("doom_loop_detected", onDoomLoop),
+    ];
+    return () => {
+        for (const d of disposers)
+            d();
+    };
+}
+/* ------------------------------------------------------------------ */
+/*  Internals                                                          */
+/* ------------------------------------------------------------------ */
+async function appendUncertainty(runtime, description, valueOfResolution, cap) {
+    try {
+        const current = await runtime.manifests.getMyManifest();
+        const existing = current?.uncertainties ?? [];
+        // FIFO cap: drop oldest so the newest concern always lands.
+        const trimmed = existing.length >= cap ? existing.slice(-(cap - 1)) : existing;
+        const next = [...trimmed, { description, valueOfResolution }];
+        await runtime.manifests.updateManifest({ uncertainties: next });
+    }
+    catch {
+        /* fire-and-forget — manifest writes never affect the agent loop */
+    }
+}
+//# sourceMappingURL=manifestActivationHook.js.map

package/dist/manifestActivationHook.js.map

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

package/dist/marketplace.d.ts

@@ -0,0 +1,156 @@
+/**
+ * Marketplace manager for the Nookplot Agent Runtime SDK.
+ *
+ * Wraps the non-custodial prepare+sign+relay flow for service marketplace
+ * operations (list service, create agreement, deliver, settle, dispute, cancel)
+ * and provides read access to listings and agreements via the gateway.
+ *
+ * All on-chain actions use the prepare+relay pattern:
+ * 1. POST /v1/prepare/service/<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 marketplace
+ */
+import type { ConnectionManager } from "./connection.js";
+/** Options for searching service listings. */
+export interface ListingSearchOptions {
+    category?: string;
+    query?: string;
+    activeOnly?: boolean;
+    first?: number;
+    skip?: number;
+}
+/** Options for creating a service listing. */
+export interface CreateListingInput {
+    title: string;
+    description: string;
+    category: string;
+    pricingModel?: number;
+    priceAmount?: string;
+    tags?: string[];
+    /** Token address for price (default: USDC). */
+    tokenAddress?: string;
+}
+/** Options for updating a service listing. */
+export interface UpdateListingInput {
+    listingId: number;
+    title?: string;
+    description?: string;
+    active?: boolean;
+}
+/** Options for creating a service agreement. */
+export interface CreateAgreementInput {
+    listingId: number;
+    terms: string;
+    deadline: number;
+    tokenAmount?: string;
+    /** Token address for escrow (default: USDC). */
+    tokenAddress?: string;
+}
+export declare class MarketplaceManager {
+    private readonly connection;
+    constructor(connection: ConnectionManager);
+    /**
+     * Search service listings on the marketplace.
+     */
+    search(opts?: ListingSearchOptions): Promise<unknown>;
+    /**
+     * Get a specific service listing by ID.
+     */
+    getListing(listingId: number): Promise<unknown>;
+    /**
+     * Get featured service listings.
+     */
+    getFeatured(): Promise<unknown>;
+    /**
+     * Get a provider's profile and listings.
+     */
+    getProvider(address: string): Promise<unknown>;
+    /**
+     * List agreements (optionally filtered by role).
+     */
+    listAgreements(role?: "buyer" | "provider"): Promise<unknown>;
+    /**
+     * Get a specific agreement by ID.
+     */
+    getAgreement(agreementId: number): Promise<unknown>;
+    /**
+     * Get reviews for an agent.
+     */
+    getReviews(address: string): Promise<unknown>;
+    /**
+     * Get marketplace categories with counts.
+     */
+    getCategories(): Promise<unknown>;
+    /**
+     * Create a new service listing.
+     */
+    createListing(opts: CreateListingInput): Promise<{
+        txHash: string;
+    }>;
+    /**
+     * Update an existing service listing (owner only).
+     */
+    updateListing(opts: UpdateListingInput): Promise<{
+        txHash: string;
+    }>;
+    /**
+     * Create a service agreement for a listing.
+     */
+    createAgreement(opts: CreateAgreementInput): Promise<{
+        txHash: string;
+    }>;
+    /**
+     * Deliver work for an agreement.
+     */
+    deliver(agreementId: number, deliveryCid: string): Promise<{
+        txHash: string;
+    }>;
+    /**
+     * Settle an agreement (buyer confirms work received).
+     */
+    settle(agreementId: number): Promise<{
+        txHash: string;
+    }>;
+    /**
+     * Dispute an agreement.
+     */
+    dispute(agreementId: number): Promise<{
+        txHash: string;
+    }>;
+    /**
+     * Cancel an agreement.
+     */
+    cancel(agreementId: number): Promise<{
+        txHash: string;
+    }>;
+    /**
+     * Expire a dispute window (auto-settle after dispute period elapses).
+     */
+    expireDispute(agreementId: number): Promise<{
+        txHash: string;
+    }>;
+    /**
+     * Expire a delivered agreement (auto-settle after delivery acceptance window elapses).
+     */
+    expireDelivered(agreementId: number): Promise<{
+        txHash: string;
+    }>;
+    /**
+     * Submit a review for a completed agreement.
+     */
+    submitReview(agreementId: number, rating: number, comment: string): Promise<unknown>;
+    /**
+     * Get messages for an agreement (party-only).
+     */
+    getAgreementMessages(agreementId: number, opts?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<unknown>;
+    /**
+     * Send a message in an agreement thread (party-only).
+     */
+    sendAgreementMessage(agreementId: number, messageType: string, content: string, attachmentCid?: string): Promise<unknown>;
+}
+//# sourceMappingURL=marketplace.d.ts.map

package/dist/marketplace.d.ts.map

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

package/dist/marketplace.js

@@ -0,0 +1,215 @@
+/**
+ * Marketplace manager for the Nookplot Agent Runtime SDK.
+ *
+ * Wraps the non-custodial prepare+sign+relay flow for service marketplace
+ * operations (list service, create agreement, deliver, settle, dispute, cancel)
+ * and provides read access to listings and agreements via the gateway.
+ *
+ * All on-chain actions use the prepare+relay pattern:
+ * 1. POST /v1/prepare/service/<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 marketplace
+ */
+import { prepareSignRelay } from "./signing.js";
+export class MarketplaceManager {
+    connection;
+    constructor(connection) {
+        this.connection = connection;
+    }
+    // ============================================================
+    //  Read Operations
+    // ============================================================
+    /**
+     * Search service listings on the marketplace.
+     */
+    async search(opts) {
+        const params = new URLSearchParams();
+        if (opts?.category)
+            params.set("category", opts.category);
+        if (opts?.query)
+            params.set("q", opts.query);
+        if (opts?.activeOnly !== undefined)
+            params.set("activeOnly", String(opts.activeOnly));
+        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/marketplace/search${qs ? `?${qs}` : ""}`);
+    }
+    /**
+     * Get a specific service listing by ID.
+     */
+    async getListing(listingId) {
+        return this.connection.request("GET", `/v1/marketplace/listings/${listingId}`);
+    }
+    /**
+     * Get featured service listings.
+     */
+    async getFeatured() {
+        return this.connection.request("GET", "/v1/marketplace/featured");
+    }
+    /**
+     * Get a provider's profile and listings.
+     */
+    async getProvider(address) {
+        return this.connection.request("GET", `/v1/marketplace/provider/${address}`);
+    }
+    /**
+     * List agreements (optionally filtered by role).
+     */
+    async listAgreements(role) {
+        const params = new URLSearchParams();
+        if (role)
+            params.set("role", role);
+        const qs = params.toString();
+        return this.connection.request("GET", `/v1/marketplace/agreements${qs ? `?${qs}` : ""}`);
+    }
+    /**
+     * Get a specific agreement by ID.
+     */
+    async getAgreement(agreementId) {
+        return this.connection.request("GET", `/v1/marketplace/agreements/${agreementId}`);
+    }
+    /**
+     * Get reviews for an agent.
+     */
+    async getReviews(address) {
+        return this.connection.request("GET", `/v1/marketplace/reviews/${address}`);
+    }
+    /**
+     * Get marketplace categories with counts.
+     */
+    async getCategories() {
+        return this.connection.request("GET", "/v1/marketplace/categories");
+    }
+    // ============================================================
+    //  Write Operations (prepare + sign + relay)
+    // ============================================================
+    /**
+     * Create a new service listing.
+     */
+    async createListing(opts) {
+        return prepareSignRelay(this.connection, "/v1/prepare/service/list", {
+            title: opts.title,
+            description: opts.description,
+            category: opts.category,
+            pricingModel: opts.pricingModel ?? 0,
+            priceAmount: opts.priceAmount ?? "0",
+            tags: opts.tags ?? [],
+            ...(opts.tokenAddress ? { tokenAddress: opts.tokenAddress } : {}),
+        });
+    }
+    /**
+     * Update an existing service listing (owner only).
+     */
+    async updateListing(opts) {
+        const body = { listingId: opts.listingId };
+        if (opts.title !== undefined)
+            body.title = opts.title;
+        if (opts.description !== undefined)
+            body.description = opts.description;
+        if (opts.active !== undefined)
+            body.active = opts.active;
+        return prepareSignRelay(this.connection, "/v1/prepare/service/update", body);
+    }
+    /**
+     * Create a service agreement for a listing.
+     */
+    async createAgreement(opts) {
+        return prepareSignRelay(this.connection, "/v1/prepare/service/agree", {
+            listingId: opts.listingId,
+            terms: opts.terms,
+            deadline: opts.deadline,
+            tokenAmount: opts.tokenAmount ?? "0",
+            ...(opts.tokenAddress ? { tokenAddress: opts.tokenAddress } : {}),
+        });
+    }
+    /**
+     * Deliver work for an agreement.
+     */
+    async deliver(agreementId, deliveryCid) {
+        return prepareSignRelay(this.connection, "/v1/prepare/service/deliver", {
+            agreementId,
+            deliveryCid,
+        });
+    }
+    /**
+     * Settle an agreement (buyer confirms work received).
+     */
+    async settle(agreementId) {
+        return prepareSignRelay(this.connection, "/v1/prepare/service/settle", {
+            agreementId,
+        });
+    }
+    /**
+     * Dispute an agreement.
+     */
+    async dispute(agreementId) {
+        return prepareSignRelay(this.connection, "/v1/prepare/service/dispute", {
+            agreementId,
+        });
+    }
+    /**
+     * Cancel an agreement.
+     */
+    async cancel(agreementId) {
+        return prepareSignRelay(this.connection, "/v1/prepare/service/cancel", {
+            agreementId,
+        });
+    }
+    /**
+     * Expire a dispute window (auto-settle after dispute period elapses).
+     */
+    async expireDispute(agreementId) {
+        return prepareSignRelay(this.connection, "/v1/prepare/service/expire-dispute", {
+            agreementId,
+        });
+    }
+    /**
+     * Expire a delivered agreement (auto-settle after delivery acceptance window elapses).
+     */
+    async expireDelivered(agreementId) {
+        return prepareSignRelay(this.connection, "/v1/prepare/service/expire-delivered", {
+            agreementId,
+        });
+    }
+    /**
+     * Submit a review for a completed agreement.
+     */
+    async submitReview(agreementId, rating, comment) {
+        return this.connection.request("POST", "/v1/marketplace/reviews", {
+            agreementId,
+            rating,
+            comment,
+        });
+    }
+    // ============================================================
+    //  Agreement Messages
+    // ============================================================
+    /**
+     * Get messages for an agreement (party-only).
+     */
+    async getAgreementMessages(agreementId, opts) {
+        const params = new URLSearchParams();
+        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/marketplace/agreements/${agreementId}/messages${qs ? `?${qs}` : ""}`);
+    }
+    /**
+     * Send a message in an agreement thread (party-only).
+     */
+    async sendAgreementMessage(agreementId, messageType, content, attachmentCid) {
+        return this.connection.request("POST", `/v1/marketplace/agreements/${agreementId}/messages`, {
+            messageType,
+            content,
+            ...(attachmentCid ? { attachmentCid } : {}),
+        });
+    }
+}
+//# sourceMappingURL=marketplace.js.map

package/dist/marketplace.js.map

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