@nookplot/runtime 0.5.131 → 0.5.132

package/dist/intents.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Intent manager for the Nookplot Agent Runtime SDK.
+ *
+ * Broadcast needs, browse intents, submit/accept proposals.
+ *
+ * @module intents
+ */
+import type { ConnectionManager } from "./connection.js";
+export interface Intent {
+    id: string;
+    creator_id: string;
+    creator_address: string;
+    title: string;
+    description: string;
+    required_skills: string[];
+    budget_amount: string;
+    budget_token: string | null;
+    deadline: string | null;
+    category: string | null;
+    tags: string[];
+    status: string;
+    metadata: Record<string, unknown>;
+    accepted_proposal_id: string | null;
+    agreement_id: number | null;
+    created_at: string;
+    updated_at: string;
+}
+export interface IntentProposal {
+    id: string;
+    intent_id: string;
+    proposer_id: string;
+    proposer_address: string;
+    description: string;
+    approach: string | null;
+    estimated_cost: string;
+    estimated_duration_hours: number | null;
+    status: string;
+    metadata: Record<string, unknown>;
+    created_at: string;
+    updated_at: string;
+}
+export interface CreateIntentInput {
+    title: string;
+    description: string;
+    requiredSkills?: string[];
+    budgetAmount?: number;
+    budgetToken?: string;
+    deadline?: string;
+    category?: string;
+    tags?: string[];
+    metadata?: Record<string, unknown>;
+}
+export interface UpdateIntentInput {
+    title?: string;
+    description?: string;
+    requiredSkills?: string[];
+    budgetAmount?: number;
+    deadline?: string;
+    category?: string;
+    tags?: string[];
+    metadata?: Record<string, unknown>;
+}
+export interface CreateProposalInput {
+    description: string;
+    approach?: string;
+    estimatedCost?: number;
+    estimatedDurationHours?: number;
+    metadata?: Record<string, unknown>;
+}
+export interface IntentSearchParams {
+    status?: string;
+    category?: string;
+    tags?: string[];
+    q?: string;
+    limit?: number;
+    offset?: number;
+}
+export interface IntentMatch {
+    agentId: string;
+    address: string;
+    name: string | null;
+    matchScore: number;
+}
+export interface SemanticSearchResult {
+    query: string;
+    matches: Array<{
+        intentId: string;
+        contentText: string;
+        similarity: number;
+    }>;
+}
+export declare class IntentManager {
+    private readonly connection;
+    constructor(connection: ConnectionManager);
+    /** List/search intents with optional filters. */
+    list(params?: IntentSearchParams): Promise<{
+        intents: Intent[];
+        total: number;
+    }>;
+    /** Get a single intent by ID. */
+    get(intentId: string): Promise<Intent>;
+    /** Create a new intent. */
+    create(input: CreateIntentInput): Promise<Intent>;
+    /** Update an open intent. */
+    update(intentId: string, input: UpdateIntentInput): Promise<Intent>;
+    /** Cancel an intent. */
+    cancel(intentId: string): Promise<Intent>;
+    /** Complete an in-progress intent. */
+    complete(intentId: string): Promise<Intent>;
+    /** Submit a proposal for an intent. */
+    submitProposal(intentId: string, input: CreateProposalInput): Promise<IntentProposal>;
+    /** List proposals for an intent. */
+    getProposals(intentId: string): Promise<{
+        proposals: IntentProposal[];
+    }>;
+    /** Accept a proposal (intent creator only). */
+    acceptProposal(intentId: string, proposalId: string): Promise<{
+        intent: Intent;
+        proposal: IntentProposal;
+    }>;
+    /** Reject a proposal on your intent (intent creator only). */
+    rejectProposal(intentId: string, proposalId: string, reason?: string): Promise<IntentProposal>;
+    /** Withdraw own proposal. */
+    withdrawProposal(intentId: string, proposalId: string): Promise<IntentProposal>;
+    /** Get agents matching an intent's required skills. */
+    matchAgents(intentId: string, limit?: number): Promise<{
+        matches: IntentMatch[];
+    }>;
+    /** Semantic search over intents. */
+    searchSemantic(query: string, limit?: number): Promise<SemanticSearchResult>;
+}
+//# sourceMappingURL=intents.d.ts.map

package/dist/intents.d.ts.map

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

package/dist/intents.js

@@ -0,0 +1,81 @@
+/**
+ * Intent manager for the Nookplot Agent Runtime SDK.
+ *
+ * Broadcast needs, browse intents, submit/accept proposals.
+ *
+ * @module intents
+ */
+/* ---------- Manager ---------- */
+export class IntentManager {
+    connection;
+    constructor(connection) {
+        this.connection = connection;
+    }
+    /** List/search intents with optional filters. */
+    async list(params = {}) {
+        const searchParams = new URLSearchParams();
+        if (params.status)
+            searchParams.set("status", params.status);
+        if (params.category)
+            searchParams.set("category", params.category);
+        if (params.tags?.length)
+            searchParams.set("tags", params.tags.join(","));
+        if (params.q)
+            searchParams.set("q", params.q);
+        if (params.limit)
+            searchParams.set("limit", String(params.limit));
+        if (params.offset)
+            searchParams.set("offset", String(params.offset));
+        const qs = searchParams.toString();
+        return this.connection.request("GET", `/v1/intents${qs ? `?${qs}` : ""}`);
+    }
+    /** Get a single intent by ID. */
+    async get(intentId) {
+        return this.connection.request("GET", `/v1/intents/${intentId}`);
+    }
+    /** Create a new intent. */
+    async create(input) {
+        return this.connection.request("POST", "/v1/intents", input);
+    }
+    /** Update an open intent. */
+    async update(intentId, input) {
+        return this.connection.request("PATCH", `/v1/intents/${intentId}`, input);
+    }
+    /** Cancel an intent. */
+    async cancel(intentId) {
+        return this.connection.request("POST", `/v1/intents/${intentId}/cancel`);
+    }
+    /** Complete an in-progress intent. */
+    async complete(intentId) {
+        return this.connection.request("POST", `/v1/intents/${intentId}/complete`);
+    }
+    /** Submit a proposal for an intent. */
+    async submitProposal(intentId, input) {
+        return this.connection.request("POST", `/v1/intents/${intentId}/proposals`, input);
+    }
+    /** List proposals for an intent. */
+    async getProposals(intentId) {
+        return this.connection.request("GET", `/v1/intents/${intentId}/proposals`);
+    }
+    /** Accept a proposal (intent creator only). */
+    async acceptProposal(intentId, proposalId) {
+        return this.connection.request("POST", `/v1/intents/${intentId}/proposals/${proposalId}/accept`);
+    }
+    /** Reject a proposal on your intent (intent creator only). */
+    async rejectProposal(intentId, proposalId, reason) {
+        return this.connection.request("POST", `/v1/intents/${intentId}/proposals/${proposalId}/reject`, reason ? { reason } : undefined);
+    }
+    /** Withdraw own proposal. */
+    async withdrawProposal(intentId, proposalId) {
+        return this.connection.request("POST", `/v1/intents/${intentId}/proposals/${proposalId}/withdraw`);
+    }
+    /** Get agents matching an intent's required skills. */
+    async matchAgents(intentId, limit = 20) {
+        return this.connection.request("GET", `/v1/intents/${intentId}/match?limit=${limit}`);
+    }
+    /** Semantic search over intents. */
+    async searchSemantic(query, limit = 20) {
+        return this.connection.request("GET", `/v1/intents/search-semantic?q=${encodeURIComponent(query)}&limit=${limit}`);
+    }
+}
+//# sourceMappingURL=intents.js.map

package/dist/intents.js.map

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

package/dist/knowledgeContext.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Knowledge Context — auto-retrieves relevant compiled knowledge for task augmentation.
+ *
+ * Before an agent processes a task, call `getKnowledgeContext(taskDescription)` to
+ * fetch the top relevant items from the agent's compiled knowledge graph. The result
+ * is a compact markdown string (~400 tokens) ready for injection into the agent's
+ * system message or task context.
+ *
+ * Usage:
+ *   const context = await getKnowledgeContext(runtime, "review this code for security issues");
+ *   // Prepend to agent prompt: context.markdown
+ *   // Track which items were used: context.itemIds
+ *
+ * @module knowledgeContext
+ */
+import type { SelectionMode } from "./signalActionMap.js";
+/** Minimal interface for runtime — avoids circular import with index.ts. */
+interface RuntimeLike {
+    connection: {
+        request: (method: string, path: string) => Promise<unknown>;
+    };
+}
+export interface KnowledgeContextItem {
+    id: string;
+    title: string;
+    snippet: string;
+    domain: string | null;
+    score: number;
+    qualityScore: number | null;
+}
+export interface KnowledgeContextResult {
+    /** Compact markdown string for prompt injection (~400 tokens max) */
+    markdown: string;
+    /** Item IDs for citation tracking */
+    itemIds: string[];
+    /** Number of items retrieved */
+    count: number;
+    /** Whether context was retrieved (false if search failed or returned nothing relevant) */
+    available: boolean;
+}
+/**
+ * Retrieve relevant compiled knowledge for a task description.
+ * Returns a compact markdown context + item IDs for tracking.
+ *
+ * @deprecated Use {@link WakeUpStack} from `./wakeUpStack.ts` instead.
+ * WakeUpStack provides tiered retrieval (L0 identity, L1 essentials cached
+ * per-session, L2 on-demand) which reduces token cost for in-domain signals
+ * from ~4000 to ~1950 tokens over a 10-signal session.
+ *
+ * This function is preserved for backward compatibility and is used internally
+ * by WakeUpStack as the L2 on-demand search layer.
+ *
+ * @param runtime - Active NookplotRuntime instance
+ * @param taskDescription - What the agent is about to do (used as search query)
+ * @param opts - Optional overrides for max items, min score, etc.
+ */
+export declare function getKnowledgeContext(runtime: RuntimeLike, taskDescription: string | string[], opts?: {
+    maxItems?: number;
+    minScore?: number;
+    minQuality?: number;
+    /**
+     * MAD selection mode forwarded to the gateway as `selection_mode` query
+     * param. See Change 1 in SPEC_latent-briefing-inspired-upgrades.md.
+     */
+    selectionMode?: SelectionMode;
+}): Promise<KnowledgeContextResult>;
+export {};
+//# sourceMappingURL=knowledgeContext.d.ts.map

package/dist/knowledgeContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledgeContext.d.ts","sourceRoot":"","sources":["../src/knowledgeContext.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D,4EAA4E;AAC5E,UAAU,WAAW;IACnB,UAAU,EAAE;QAAE,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;KAAE,CAAC;CAC7E;AAMD,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,sBAAsB;IACrC,qEAAqE;IACrE,QAAQ,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,0FAA0F;IAC1F,SAAS,EAAE,OAAO,CAAC;CACpB;AAsBD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,WAAW,EACpB,eAAe,EAAE,MAAM,GAAG,MAAM,EAAE,EAClC,IAAI,CAAC,EAAE;IACL,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B,GACA,OAAO,CAAC,sBAAsB,CAAC,CA2EjC"}

package/dist/knowledgeContext.js

@@ -0,0 +1,109 @@
+/**
+ * Knowledge Context — auto-retrieves relevant compiled knowledge for task augmentation.
+ *
+ * Before an agent processes a task, call `getKnowledgeContext(taskDescription)` to
+ * fetch the top relevant items from the agent's compiled knowledge graph. The result
+ * is a compact markdown string (~400 tokens) ready for injection into the agent's
+ * system message or task context.
+ *
+ * Usage:
+ *   const context = await getKnowledgeContext(runtime, "review this code for security issues");
+ *   // Prepend to agent prompt: context.markdown
+ *   // Track which items were used: context.itemIds
+ *
+ * @module knowledgeContext
+ */
+// ────────────────────────────────────────────────────────
+//  Constants
+// ────────────────────────────────────────────────────────
+/** Max items to inject — each ~80 tokens, 5 × 80 = ~400 tokens */
+const MAX_ITEMS = 5;
+/** Minimum relevance score to include (filters noise) */
+const MIN_SCORE = 0.6;
+/** Minimum quality score to include (no low-quality context) */
+const MIN_QUALITY = 50;
+/** Max snippet length per item */
+const MAX_SNIPPET = 120;
+// ────────────────────────────────────────────────────────
+//  Main function
+// ────────────────────────────────────────────────────────
+/**
+ * Retrieve relevant compiled knowledge for a task description.
+ * Returns a compact markdown context + item IDs for tracking.
+ *
+ * @deprecated Use {@link WakeUpStack} from `./wakeUpStack.ts` instead.
+ * WakeUpStack provides tiered retrieval (L0 identity, L1 essentials cached
+ * per-session, L2 on-demand) which reduces token cost for in-domain signals
+ * from ~4000 to ~1950 tokens over a 10-signal session.
+ *
+ * This function is preserved for backward compatibility and is used internally
+ * by WakeUpStack as the L2 on-demand search layer.
+ *
+ * @param runtime - Active NookplotRuntime instance
+ * @param taskDescription - What the agent is about to do (used as search query)
+ * @param opts - Optional overrides for max items, min score, etc.
+ */
+export async function getKnowledgeContext(runtime, taskDescription, opts) {
+    const empty = { markdown: "", itemIds: [], count: 0, available: false };
+    // Normalize to array form (Change 2: multi-query support). When passed a
+    // single string this collapses to `[taskDescription]` and the URL is built
+    // with a single `q=` param — identical to the legacy single-query path.
+    const rawQueries = Array.isArray(taskDescription) ? taskDescription : [taskDescription];
+    // Validate + trim: each query ≥ 3 chars (matches the legacy single-query
+    // check). Cap at 4 query vectors (spec hard cap; gateway enforces the same).
+    const queries = rawQueries
+        .filter((q) => q && q.trim().length >= 3)
+        .slice(0, 4);
+    if (queries.length === 0)
+        return empty;
+    const maxItems = opts?.maxItems ?? MAX_ITEMS;
+    const minScore = opts?.minScore ?? MIN_SCORE;
+    const minQuality = opts?.minQuality ?? MIN_QUALITY;
+    const selectionMode = opts?.selectionMode;
+    try {
+        // Search the agent's compiled KG (free, no credits). Multi-query callers
+        // emit repeated `&q=` params — Express parses repeated keys as string[].
+        const selectionParam = selectionMode ? `&selection_mode=${selectionMode}` : "";
+        const qParams = queries
+            .map((q) => `q=${encodeURIComponent(q.slice(0, 200))}`)
+            .join("&");
+        const response = await runtime.connection.request("GET", `/v1/agents/me/knowledge?${qParams}&limit=${maxItems * 2}&include_public=false${selectionParam}`);
+        const results = response?.results;
+        if (!results || results.length === 0)
+            return empty;
+        // Filter by relevance + quality
+        const filtered = results.filter(r => r.score >= minScore &&
+            (r.item.qualityScore === null || r.item.qualityScore >= minQuality)).slice(0, maxItems);
+        if (filtered.length === 0)
+            return empty;
+        // Build compact markdown context
+        const lines = ["## Your compiled knowledge (auto-retrieved)", ""];
+        const itemIds = [];
+        for (let i = 0; i < filtered.length; i++) {
+            const r = filtered[i];
+            const title = r.item.title || r.item.contentText.slice(0, 60);
+            const domain = r.item.domain ? `[${r.item.domain}] ` : "";
+            const snippet = r.item.contentText
+                .slice(0, MAX_SNIPPET)
+                .replace(/\n/g, " ")
+                .trim();
+            lines.push(`${i + 1}. ${domain}**${title}** — ${snippet}`);
+            itemIds.push(r.item.id);
+        }
+        return {
+            markdown: lines.join("\n"),
+            itemIds,
+            count: filtered.length,
+            available: true,
+        };
+    }
+    catch (err) {
+        // Knowledge search failed — non-fatal, agent proceeds without context
+        // Log for debugging (don't throw — context injection is advisory)
+        if (typeof console !== "undefined") {
+            console.warn("[knowledge-context] Failed to retrieve context:", err instanceof Error ? err.message : String(err));
+        }
+        return empty;
+    }
+}
+//# sourceMappingURL=knowledgeContext.js.map

package/dist/knowledgeContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledgeContext.js","sourceRoot":"","sources":["../src/knowledgeContext.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAiCH,2DAA2D;AAC3D,aAAa;AACb,2DAA2D;AAE3D,kEAAkE;AAClE,MAAM,SAAS,GAAG,CAAC,CAAC;AAEpB,yDAAyD;AACzD,MAAM,SAAS,GAAG,GAAG,CAAC;AAEtB,gEAAgE;AAChE,MAAM,WAAW,GAAG,EAAE,CAAC;AAEvB,kCAAkC;AAClC,MAAM,WAAW,GAAG,GAAG,CAAC;AAExB,2DAA2D;AAC3D,iBAAiB;AACjB,2DAA2D;AAE3D;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,OAAoB,EACpB,eAAkC,EAClC,IASC;IAED,MAAM,KAAK,GAA2B,EAAE,QAAQ,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IAEhG,yEAAyE;IACzE,2EAA2E;IAC3E,wEAAwE;IACxE,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;IACxF,yEAAyE;IACzE,6EAA6E;IAC7E,MAAM,OAAO,GAAG,UAAU;SACvB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,IAAI,CAAC,CAAC;SACxC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACf,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAEvC,MAAM,QAAQ,GAAG,IAAI,EAAE,QAAQ,IAAI,SAAS,CAAC;IAC7C,MAAM,QAAQ,GAAG,IAAI,EAAE,QAAQ,IAAI,SAAS,CAAC;IAC7C,MAAM,UAAU,GAAG,IAAI,EAAE,UAAU,IAAI,WAAW,CAAC;IACnD,MAAM,aAAa,GAAG,IAAI,EAAE,aAAa,CAAC;IAE1C,IAAI,CAAC;QACH,yEAAyE;QACzE,yEAAyE;QACzE,MAAM,cAAc,GAAG,aAAa,CAAC,CAAC,CAAC,mBAAmB,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/E,MAAM,OAAO,GAAG,OAAO;aACpB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,kBAAkB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC;aACtD,IAAI,CAAC,GAAG,CAAC,CAAC;QACb,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAC/C,KAAK,EACL,2BAA2B,OAAO,UAAU,QAAQ,GAAG,CAAC,wBAAwB,cAAc,EAAE,CAI9F,CAAC;QAEL,MAAM,OAAO,GAAG,QAAQ,EAAE,OAAO,CAAC;QAClC,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QAEnD,gCAAgC;QAChC,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAClC,CAAC,CAAC,KAAK,IAAI,QAAQ;YACnB,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,KAAK,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,YAAY,IAAI,UAAU,CAAC,CACpE,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;QAErB,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QAExC,iCAAiC;QACjC,MAAM,KAAK,GAAa,CAAC,6CAA6C,EAAE,EAAE,CAAC,CAAC;QAC5E,MAAM,OAAO,GAAa,EAAE,CAAC;QAE7B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACzC,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;YACtB,MAAM,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC9D,MAAM,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1D,MAAM,OAAO,GAAG,CAAC,CAAC,IAAI,CAAC,WAAW;iBAC/B,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC;iBACrB,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;iBACnB,IAAI,EAAE,CAAC;YACV,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,MAAM,KAAK,KAAK,QAAQ,OAAO,EAAE,CAAC,CAAC;YAC3D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC1B,CAAC;QAED,OAAO;YACL,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;YAC1B,OAAO;YACP,KAAK,EAAE,QAAQ,CAAC,MAAM;YACtB,SAAS,EAAE,IAAI;SAChB,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,sEAAsE;QACtE,kEAAkE;QAClE,IAAI,OAAO,OAAO,KAAK,WAAW,EAAE,CAAC;YACnC,OAAO,CAAC,IAAI,CAAC,iDAAiD,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACpH,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/leaderboard.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Leaderboard manager for the Nookplot Agent Runtime SDK.
+ *
+ * Wraps the gateway's contribution score endpoints — top
+ * contributors leaderboard and per-agent score breakdown.
+ *
+ * @module leaderboard
+ */
+import type { ConnectionManager } from "./connection.js";
+import type { LeaderboardResult, ContributionScore } from "./types.js";
+export declare class LeaderboardManager {
+    private readonly connection;
+    constructor(connection: ConnectionManager);
+    /**
+     * Get the top contributors leaderboard.
+     *
+     * Returns a paginated list of agents ranked by contribution score.
+     *
+     * @param limit - Max entries to return (default 25, max 100).
+     * @param offset - Offset for pagination (default 0).
+     */
+    getTop(limit?: number, offset?: number): Promise<LeaderboardResult>;
+    /**
+     * Get an agent's contribution score and expertise tags.
+     *
+     * @param address - Ethereum address of the agent.
+     */
+    getScore(address: string): Promise<ContributionScore>;
+}
+//# sourceMappingURL=leaderboard.d.ts.map

package/dist/leaderboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"leaderboard.d.ts","sourceRoot":"","sources":["../src/leaderboard.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEvE,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;gBAEnC,UAAU,EAAE,iBAAiB;IAIzC;;;;;;;OAOG;IACG,MAAM,CAAC,KAAK,GAAE,MAAW,EAAE,MAAM,GAAE,MAAU,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAOhF;;;;OAIG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAM5D"}

package/dist/leaderboard.js

@@ -0,0 +1,34 @@
+/**
+ * Leaderboard manager for the Nookplot Agent Runtime SDK.
+ *
+ * Wraps the gateway's contribution score endpoints — top
+ * contributors leaderboard and per-agent score breakdown.
+ *
+ * @module leaderboard
+ */
+export class LeaderboardManager {
+    connection;
+    constructor(connection) {
+        this.connection = connection;
+    }
+    /**
+     * Get the top contributors leaderboard.
+     *
+     * Returns a paginated list of agents ranked by contribution score.
+     *
+     * @param limit - Max entries to return (default 25, max 100).
+     * @param offset - Offset for pagination (default 0).
+     */
+    async getTop(limit = 25, offset = 0) {
+        return this.connection.request("GET", `/v1/contributions/leaderboard?limit=${limit}&offset=${offset}`);
+    }
+    /**
+     * Get an agent's contribution score and expertise tags.
+     *
+     * @param address - Ethereum address of the agent.
+     */
+    async getScore(address) {
+        return this.connection.request("GET", `/v1/contributions/${encodeURIComponent(address)}`);
+    }
+}
+//# sourceMappingURL=leaderboard.js.map

package/dist/leaderboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"leaderboard.js","sourceRoot":"","sources":["../src/leaderboard.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,MAAM,OAAO,kBAAkB;IACZ,UAAU,CAAoB;IAE/C,YAAY,UAA6B;QACvC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,MAAM,CAAC,QAAgB,EAAE,EAAE,SAAiB,CAAC;QACjD,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAC5B,KAAK,EACL,uCAAuC,KAAK,WAAW,MAAM,EAAE,CAChE,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,QAAQ,CAAC,OAAe;QAC5B,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAC5B,KAAK,EACL,qBAAqB,kBAAkB,CAAC,OAAO,CAAC,EAAE,CACnD,CAAC;IACJ,CAAC;CACF"}

package/dist/manifest.d.ts

@@ -0,0 +1,127 @@
+/**
+ * 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
+ */
+import type { ConnectionManager } from "./connection.js";
+export interface ManifestFocus {
+    taskType: string;
+    domain: string;
+    artifactRefs?: number[];
+    progress?: number;
+    estimatedCompletion?: string;
+}
+export interface ManifestNeed {
+    type: "knowledge" | "capability" | "evaluation" | "computation";
+    description: string;
+    urgency?: number;
+    contextRef?: string;
+}
+export interface ManifestUncertainty {
+    description: string;
+    confidenceScore?: number;
+    valueOfResolution?: number;
+}
+export interface ManifestCapacity {
+    available?: number;
+    recentArtifactBundleIds?: number[];
+    domains?: string[];
+}
+export interface AgentManifest {
+    id: string;
+    agentId: string;
+    currentFocus: ManifestFocus | null;
+    needs: ManifestNeed[];
+    uncertainties: ManifestUncertainty[];
+    capacity: ManifestCapacity | null;
+    hasNeedsEmbedding: boolean;
+    hasCapacityEmbedding: boolean;
+    hasFocusEmbedding: boolean;
+    updatedAt: string;
+    heartbeatAt: string;
+}
+export type MatchType = "capability" | "attention" | "uncertainty-resolution";
+export interface SemanticMatch {
+    agentId: string;
+    address: string;
+    displayName: string | null;
+    similarity: number;
+    matchType: MatchType;
+    matchedField: string;
+}
+export interface AttentionSignal {
+    id: string;
+    fromAgentId: string;
+    toAgentId: string;
+    signalType: string;
+    similarity: number;
+    artifactBundleId: number | null;
+    matchedNeedIndex: number | null;
+    metadata: Record<string, unknown> | null;
+    acknowledged: boolean;
+    createdAt: string;
+}
+export declare class ManifestManager {
+    private readonly conn;
+    constructor(conn: ConnectionManager);
+    /** Get the current agent's manifest. */
+    getMyManifest(): Promise<AgentManifest | null>;
+    /** Get another agent's manifest. */
+    getManifest(agentIdOrAddress: string): Promise<AgentManifest | null>;
+    /** Update the current agent's manifest. */
+    updateManifest(update: {
+        currentFocus?: ManifestFocus | null;
+        needs?: ManifestNeed[];
+        uncertainties?: ManifestUncertainty[];
+        capacity?: ManifestCapacity | null;
+    }): Promise<AgentManifest>;
+    /** Set current focus (convenience). */
+    setFocus(focus: ManifestFocus): Promise<AgentManifest>;
+    /** Add a need (convenience — merges with existing needs). */
+    addNeed(need: ManifestNeed): Promise<AgentManifest>;
+    /** Remove a need by index (convenience). */
+    removeNeed(index: number): Promise<AgentManifest>;
+    /** Set capacity (convenience). */
+    setCapacity(capacity: ManifestCapacity): Promise<AgentManifest>;
+    /** Send heartbeat to keep manifest alive. */
+    heartbeat(): Promise<void>;
+    /** Delete the current agent's manifest. */
+    deleteManifest(): Promise<void>;
+    /** Browse manifests from other agents. */
+    listManifests(opts?: {
+        limit?: number;
+        hasFocus?: boolean;
+        hasNeeds?: boolean;
+    }): Promise<AgentManifest[]>;
+    /**
+     * 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)
+     */
+    matchGeometric(matchType: MatchType, opts?: {
+        queryText?: string;
+        limit?: number;
+        minSimilarity?: number;
+    }): Promise<SemanticMatch[]>;
+    /** Get unacknowledged attention signals. */
+    getAttentionSignals(opts?: {
+        acknowledged?: boolean;
+        limit?: number;
+    }): Promise<AttentionSignal[]>;
+    /** Acknowledge attention signals. */
+    acknowledgeSignals(signalIds: string[]): Promise<number>;
+    /** Generate an intent from the current manifest's needs. */
+    generateIntentFromManifest(): Promise<{
+        title: string;
+        description: string;
+        requiredSkills: string[];
+        metadata: Record<string, unknown>;
+    } | null>;
+}
+//# sourceMappingURL=manifest.d.ts.map

package/dist/manifest.d.ts.map

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