@nookplot/runtime 0.5.131 → 0.5.132

package/dist/manifest.js

@@ -0,0 +1,123 @@
+/**
+ * Agent Manifest manager — Phase 5 of Latent Space Coordination.
+ *
+ * Dynamic cognitive state broadcasts that enable geometric matching
+ * via embedding similarity rather than keyword tags.
+ *
+ * @module manifest
+ */
+/* ------------------------------------------------------------------ */
+/*  Manager                                                            */
+/* ------------------------------------------------------------------ */
+export class ManifestManager {
+    conn;
+    constructor(conn) {
+        this.conn = conn;
+    }
+    /** Get the current agent's manifest. */
+    async getMyManifest() {
+        try {
+            return await this.conn.request("GET", "/v1/agents/me/manifest");
+        }
+        catch {
+            return null;
+        }
+    }
+    /** Get another agent's manifest. */
+    async getManifest(agentIdOrAddress) {
+        try {
+            return await this.conn.request("GET", `/v1/agents/${agentIdOrAddress}/manifest`);
+        }
+        catch {
+            return null;
+        }
+    }
+    /** Update the current agent's manifest. */
+    async updateManifest(update) {
+        return this.conn.request("PUT", "/v1/agents/me/manifest", update);
+    }
+    /** Set current focus (convenience). */
+    async setFocus(focus) {
+        return this.updateManifest({ currentFocus: focus });
+    }
+    /** Add a need (convenience — merges with existing needs). */
+    async addNeed(need) {
+        const current = await this.getMyManifest();
+        const needs = [...(current?.needs ?? []), need];
+        return this.updateManifest({ needs });
+    }
+    /** Remove a need by index (convenience). */
+    async removeNeed(index) {
+        const current = await this.getMyManifest();
+        const needs = [...(current?.needs ?? [])];
+        needs.splice(index, 1);
+        return this.updateManifest({ needs });
+    }
+    /** Set capacity (convenience). */
+    async setCapacity(capacity) {
+        return this.updateManifest({ capacity });
+    }
+    /** Send heartbeat to keep manifest alive. */
+    async heartbeat() {
+        await this.conn.request("POST", "/v1/agents/me/manifest/heartbeat", {});
+    }
+    /** Delete the current agent's manifest. */
+    async deleteManifest() {
+        await this.conn.request("DELETE", "/v1/agents/me/manifest");
+    }
+    /** Browse manifests from other agents. */
+    async listManifests(opts) {
+        const params = new URLSearchParams();
+        if (opts?.limit)
+            params.set("limit", String(opts.limit));
+        if (opts?.hasFocus)
+            params.set("hasFocus", "true");
+        if (opts?.hasNeeds)
+            params.set("hasNeeds", "true");
+        const qs = params.toString();
+        const res = await this.conn.request("GET", `/v1/manifests${qs ? `?${qs}` : ""}`);
+        return res.manifests ?? [];
+    }
+    /**
+     * Geometric matching — find agents by embedding similarity.
+     *
+     * Match types:
+     *   - capability: "who can help me?" (my needs ↔ their capacity)
+     *   - attention: "who's working on related things?" (my focus ↔ their focus)
+     *   - uncertainty-resolution: "who just figured out what I'm stuck on?" (my needs ↔ their focus)
+     */
+    async matchGeometric(matchType, opts) {
+        const res = await this.conn.request("POST", "/v1/match/geometric", {
+            matchType,
+            ...opts,
+        });
+        return res.matches ?? [];
+    }
+    /** Get unacknowledged attention signals. */
+    async getAttentionSignals(opts) {
+        const params = new URLSearchParams();
+        if (opts?.acknowledged !== undefined)
+            params.set("acknowledged", String(opts.acknowledged));
+        if (opts?.limit)
+            params.set("limit", String(opts.limit));
+        const qs = params.toString();
+        const res = await this.conn.request("GET", `/v1/agents/me/attention-signals${qs ? `?${qs}` : ""}`);
+        return res.signals ?? [];
+    }
+    /** Acknowledge attention signals. */
+    async acknowledgeSignals(signalIds) {
+        const res = await this.conn.request("POST", "/v1/agents/me/attention-signals/ack", { signalIds });
+        return res.acknowledged ?? 0;
+    }
+    /** Generate an intent from the current manifest's needs. */
+    async generateIntentFromManifest() {
+        try {
+            const res = await this.conn.request("POST", "/v1/intents/from-manifest", {});
+            return res.generatedIntent ?? null;
+        }
+        catch {
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

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

package/dist/manifestActivationHook.d.ts

@@ -0,0 +1,72 @@
+/**
+ * manifestActivationHook — auto-populates `agent_manifests.{current_focus,
+ * uncertainties}` as the agent runs its autonomous loop, so broadcast
+ * clarification routing (`clarificationService.routeBroadcast` →
+ * `manifestService.matchByText("uncertainty-resolution")`) has live data
+ * to match against.
+ *
+ * Subscribes to four runtime hooks:
+ *   - `signal_received`  → setFocus when the signal is task-bearing
+ *   - `action_end`       → clearFocus when the action terminates a task
+ *   - `action_error`     → append uncertainty when the same actionType fails
+ *                          ≥3 times within the debounce window
+ *   - `doom_loop_detected` → append uncertainty unconditionally
+ *
+ * Auto-installed by `NookplotRuntime.connect()` unless the runtime was
+ * constructed with `{ autoInstallHooks: false }`. All gateway calls are
+ * fire-and-forget — manifest write failures never affect the agent loop.
+ *
+ * @module manifestActivationHook
+ */
+import type { NookplotRuntime } from "./index.js";
+import type { SignalEvent } from "./autonomous.js";
+import type { HookRegistry } from "./hooks.js";
+/**
+ * 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 declare const TASK_BEARING_SIGNALS: ReadonlySet<string>;
+/**
+ * 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 declare const TERMINAL_ACTIONS: ReadonlySet<string>;
+export interface ManifestActivationHookOptions {
+    /** Override the registry the hook subscribes to. Defaults to `runtime.hooks`. */
+    hooks?: HookRegistry;
+    /**
+     * Window in milliseconds for the per-actionType error counter. Three errors
+     * for the same actionType within this window trip an uncertainty write.
+     * Default 5 minutes — tuned so chronic failures surface but transient blips
+     * do not.
+     */
+    errorDebounceWindowMs?: number;
+    /**
+     * Number of repeated errors required to trip an uncertainty write. Default 3.
+     * Lower values are more sensitive; higher values reduce noise.
+     */
+    errorThreshold?: number;
+    /**
+     * Maximum number of uncertainties to keep in the manifest. Older entries are
+     * dropped FIFO-style when this cap is hit. Default 20 — matches the MCP
+     * tool's documented maximum.
+     */
+    maxUncertainties?: number;
+}
+/**
+ * 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 declare function extractDomain(data: SignalEvent): string;
+/**
+ * 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 declare function installManifestActivationHook(runtime: NookplotRuntime, opts?: ManifestActivationHookOptions): () => void;
+//# sourceMappingURL=manifestActivationHook.d.ts.map

package/dist/manifestActivationHook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifestActivationHook.d.ts","sourceRoot":"","sources":["../src/manifestActivationHook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EACV,YAAY,EAIb,MAAM,YAAY,CAAC;AAOpB;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,EAAE,WAAW,CAAC,MAAM,CAwCnD,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,MAAM,CAc/C,CAAC;AAMH,MAAM,WAAW,6BAA6B;IAC5C,iFAAiF;IACjF,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB;;;;;OAKG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAUD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAgBvD;AAMD;;;;GAIG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,eAAe,EACxB,IAAI,GAAE,6BAAkC,GACvC,MAAM,IAAI,CA+DZ"}

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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"}