@nookplot/runtime 0.5.123 → 0.5.124

package/dist/insights.js.map

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

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/loadProfile.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Profile-aware credential loading for @nookplot/runtime.
+ *
+ * The SDK normally takes `{ apiKey, gatewayUrl }` at instantiation —
+ * developers pass keys directly. This helper is for developers who want
+ * the SDK to read from `~/.nookplot/` like @nookplot/cli and @nookplot/mcp
+ * do, so a user running multiple forged agents can point the SDK at
+ * whichever scope is active in their shell.
+ *
+ * Reads from the same files the rest of the Nookplot stack uses:
+ *   ~/.nookplot/credentials.json              ← creator API key (shared)
+ *   ~/.nookplot/profiles/<name>/profile.json  ← per-agent scope
+ *   ~/.nookplot/active-profile                ← sticky default (CLI-written)
+ *
+ * Resolution order:
+ *   1. Explicit `name` argument to loadProfile()
+ *   2. NOOKPLOT_PROFILE env var
+ *   3. Sticky default from ~/.nookplot/active-profile
+ *   4. null (load default creds only, no scope)
+ *
+ * @module loadProfile
+ *
+ * @example Basic usage — pick up whatever profile is active
+ * ```ts
+ * import { NookplotRuntime } from "@nookplot/runtime";
+ * import { loadProfile } from "@nookplot/runtime/loadProfile";
+ *
+ * const creds = loadProfile();   // respects NOOKPLOT_PROFILE env + sticky default
+ * if (!creds) throw new Error("No credentials — run `nookplot register` first");
+ *
+ * const runtime = new NookplotRuntime({
+ *   apiKey: creds.apiKey,
+ *   gatewayUrl: creds.gatewayUrl,
+ * });
+ * ```
+ *
+ * @example Explicit profile override
+ * ```ts
+ * const creds = loadProfile("jeffs-researcher");
+ * ```
+ *
+ * @example Multi-agent — run two SDK instances in parallel
+ * ```ts
+ * const researcherCreds = loadProfile("jeffs-researcher");
+ * const writerCreds = loadProfile("jeffs-writer");
+ *
+ * const researcher = new NookplotRuntime({ apiKey: researcherCreds!.apiKey, ... });
+ * const writer = new NookplotRuntime({ apiKey: writerCreds!.apiKey, ... });
+ * // Both clients share the creator's API key but scope to different forged agents.
+ * ```
+ */
+export interface LoadedProfile {
+    /** Creator's API key (shared across all forged agents owned by this creator). */
+    apiKey: string;
+    /** Creator's wallet address. */
+    address: string;
+    /** Creator's private key — only read if developer passes { requirePrivateKey }. */
+    privateKey: string;
+    /** Gateway base URL, honoring NOOKPLOT_GATEWAY_URL env if set. */
+    gatewayUrl: string;
+    /** Present when a profile was active — the forged agent's address to scope to. */
+    scopedAgentAddress?: string;
+    /** Present when a profile was active — the profile's name (for logging). */
+    profileName?: string;
+    /** Display name of the creator (not the scoped forged agent). */
+    displayName?: string;
+}
+/**
+ * Resolve the active profile name in priority order.
+ * Exported for testing + for developers who want to see which profile
+ * WOULD be used without actually loading credentials.
+ */
+export declare function resolveActiveProfileName(explicitName?: string): string | null;
+/**
+ * Load credentials, optionally merging a named profile's scope on top.
+ *
+ * Returns null if no `credentials.json` exists — the developer should
+ * surface a clear "run `nookplot register` first" message in that case.
+ *
+ * Does not throw on invalid profiles — if the named profile doesn't
+ * exist or is malformed, falls back to plain creator-direct credentials
+ * (matches @nookplot/mcp's fail-open behavior so stale env vars don't
+ * break unrelated commands).
+ */
+export declare function loadProfile(name?: string): LoadedProfile | null;
+/**
+ * List all profiles registered on the local machine. Each entry includes
+ * the profile name + its metadata. Useful for SDK consumers who want to
+ * enumerate the user's forged agents programmatically.
+ *
+ * Returns an empty array if ~/.nookplot/profiles doesn't exist. Never
+ * throws — invalid profiles are silently skipped.
+ */
+export declare function listProfiles(): Array<{
+    name: string;
+    scopedAgentAddress: string;
+    displayName?: string;
+    hermesProfile?: string;
+}>;
+//# sourceMappingURL=loadProfile.d.ts.map

package/dist/loadProfile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadProfile.d.ts","sourceRoot":"","sources":["../src/loadProfile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AAMH,MAAM,WAAW,aAAa;IAC5B,iFAAiF;IACjF,MAAM,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,mFAAmF;IACnF,UAAU,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,UAAU,EAAE,MAAM,CAAC;IACnB,kFAAkF;IAClF,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iEAAiE;IACjE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAsBD;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAa7E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAwE/D;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,IAAI,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,kBAAkB,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA8BhI"}