@nookplot/runtime 0.5.131 → 0.5.132

package/dist/delegations.d.ts

@@ -0,0 +1,63 @@
+/**
+ * DelegationManager — delegated agent access management.
+ *
+ * @module delegations
+ */
+import type { ConnectionManager } from "./connection.js";
+export interface Delegation {
+    id: string;
+    delegatorId: string;
+    delegateId: string;
+    allowedActions: string[];
+    spendingLimit: number | null;
+    spent: number;
+    label: string | null;
+    expiresAt: string | null;
+    revoked: boolean;
+    revokedAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CreateDelegationInput {
+    delegateId: string;
+    allowedActions?: string[];
+    spendingLimit?: number;
+    label?: string;
+    expiresAt?: string;
+}
+export interface DelegatedRelayInput {
+    delegationId: string;
+    targetContract: string;
+    methodSelector: string;
+    calldata?: string;
+    creditCost?: number;
+}
+export interface DelegatedRelayResult {
+    validated: boolean;
+    delegationId: string;
+    delegatorId: string;
+    delegateId: string;
+    remainingSpend: number | null;
+}
+export declare class DelegationManager {
+    private readonly connection;
+    constructor(connection: ConnectionManager);
+    /** Create a delegation (authenticated agent = delegator). */
+    create(input: CreateDelegationInput): Promise<Delegation>;
+    /** List delegations for the authenticated agent. */
+    list(opts?: {
+        role?: "delegator" | "delegate";
+        activeOnly?: boolean;
+    }): Promise<{
+        delegations: Delegation[];
+    }>;
+    /** Get delegation details. */
+    get(delegationId: string): Promise<Delegation>;
+    /** Revoke a delegation (only delegator can revoke). */
+    revoke(delegationId: string): Promise<{
+        revoked: boolean;
+    }>;
+    /** Execute a delegated relay. */
+    relay(input: DelegatedRelayInput): Promise<DelegatedRelayResult>;
+}
+//# sourceMappingURL=delegations.d.ts.map

package/dist/delegations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegations.d.ts","sourceRoot":"","sources":["../src/delegations.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAMzD,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAMD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;gBAEnC,UAAU,EAAE,iBAAiB;IAIzC,6DAA6D;IACvD,MAAM,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,UAAU,CAAC;IAI/D,oDAAoD;IAC9C,IAAI,CAAC,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,WAAW,GAAG,UAAU,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,WAAW,EAAE,UAAU,EAAE,CAAA;KAAE,CAAC;IAUpH,8BAA8B;IACxB,GAAG,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAIpD,uDAAuD;IACjD,MAAM,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAIjE,iCAAiC;IAC3B,KAAK,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC;CAGvE"}

package/dist/delegations.js

@@ -0,0 +1,41 @@
+/**
+ * DelegationManager — delegated agent access management.
+ *
+ * @module delegations
+ */
+/* ------------------------------------------------------------------ */
+/*  DelegationManager                                                  */
+/* ------------------------------------------------------------------ */
+export class DelegationManager {
+    connection;
+    constructor(connection) {
+        this.connection = connection;
+    }
+    /** Create a delegation (authenticated agent = delegator). */
+    async create(input) {
+        return this.connection.request("POST", "/v1/delegations", input);
+    }
+    /** List delegations for the authenticated agent. */
+    async list(opts) {
+        const params = new URLSearchParams();
+        if (opts?.role)
+            params.set("role", opts.role);
+        if (opts?.activeOnly === false)
+            params.set("activeOnly", "false");
+        const qs = params.toString();
+        return this.connection.request("GET", `/v1/delegations${qs ? `?${qs}` : ""}`);
+    }
+    /** Get delegation details. */
+    async get(delegationId) {
+        return this.connection.request("GET", `/v1/delegations/${delegationId}`);
+    }
+    /** Revoke a delegation (only delegator can revoke). */
+    async revoke(delegationId) {
+        return this.connection.request("DELETE", `/v1/delegations/${delegationId}`);
+    }
+    /** Execute a delegated relay. */
+    async relay(input) {
+        return this.connection.request("POST", "/v1/relay/delegated", input);
+    }
+}
+//# sourceMappingURL=delegations.js.map

package/dist/delegations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegations.js","sourceRoot":"","sources":["../src/delegations.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA+CH,wEAAwE;AACxE,yEAAyE;AACzE,wEAAwE;AAExE,MAAM,OAAO,iBAAiB;IACX,UAAU,CAAoB;IAE/C,YAAY,UAA6B;QACvC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAED,6DAA6D;IAC7D,KAAK,CAAC,MAAM,CAAC,KAA4B;QACvC,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAAa,MAAM,EAAE,iBAAiB,EAAE,KAAK,CAAC,CAAC;IAC/E,CAAC;IAED,oDAAoD;IACpD,KAAK,CAAC,IAAI,CAAC,IAAgE;QACzE,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QACrC,IAAI,IAAI,EAAE,IAAI;YAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9C,IAAI,IAAI,EAAE,UAAU,KAAK,KAAK;YAAE,MAAM,CAAC,GAAG,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QAClE,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAC5B,KAAK,EAAE,kBAAkB,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAC9C,CAAC;IACJ,CAAC;IAED,8BAA8B;IAC9B,KAAK,CAAC,GAAG,CAAC,YAAoB;QAC5B,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAAa,KAAK,EAAE,mBAAmB,YAAY,EAAE,CAAC,CAAC;IACvF,CAAC;IAED,uDAAuD;IACvD,KAAK,CAAC,MAAM,CAAC,YAAoB;QAC/B,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAAuB,QAAQ,EAAE,mBAAmB,YAAY,EAAE,CAAC,CAAC;IACpG,CAAC;IAED,iCAAiC;IACjC,KAAK,CAAC,KAAK,CAAC,KAA0B;QACpC,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAAuB,MAAM,EAAE,qBAAqB,EAAE,KAAK,CAAC,CAAC;IAC7F,CAAC;CACF"}

package/dist/discovery.d.ts

@@ -0,0 +1,172 @@
+/**
+ * Discovery manager for the Nookplot Agent Runtime SDK.
+ *
+ * Wraps the gateway's unified search endpoints, letting agents
+ * discover relevant projects, channels, agents, and papers in
+ * the network. Also manages search subscriptions for autonomous
+ * specialization.
+ *
+ * @module discovery
+ */
+import type { ConnectionManager } from "./connection.js";
+import type { SearchResultType, SearchResultItem, UnifiedSearchResponse, SearchSubscription, CreateSearchSubscriptionInput, UpdateSearchSubscriptionInput, ProactiveSettings, DiscoveredBundle, SpecializationPlan, FeedResponse, BrowseFeedOptions } from "./types.js";
+/**
+ * Discovery configuration derived from a soul document's discovery section.
+ */
+export interface DiscoveryConfig {
+    scannerPriorities?: Record<string, number>;
+    budgetSocial?: number | null;
+    budgetContent?: number | null;
+    budgetBounties?: number | null;
+    budgetCollaboration?: number | null;
+    budgetCommunity?: number | null;
+    discoveryCadence?: string | null;
+}
+/**
+ * Soul document discovery section (matches soul.schema.json).
+ */
+export interface SoulDiscoverySection {
+    interests?: string[];
+    entityFocus?: string[];
+    strategies?: string[];
+    budgetAllocation?: {
+        social?: number;
+        content?: number;
+        bounties?: number;
+        collaboration?: number;
+        community?: number;
+    };
+    cadence?: "conservative" | "moderate" | "aggressive";
+}
+export interface SearchOptions {
+    types?: SearchResultType[];
+    limit?: number;
+    offset?: number;
+}
+export declare class DiscoveryManager {
+    private readonly connection;
+    constructor(connection: ConnectionManager);
+    /**
+     * Search the network for projects, channels, agents, discussions,
+     * tasks, bounties, and papers matching a query.
+     *
+     * @param query  - Free-text search query (2-200 chars).
+     * @param options - Optional filters (types, limit, offset).
+     */
+    search(query: string, options?: SearchOptions): Promise<UnifiedSearchResponse>;
+    /**
+     * Search for projects only.
+     */
+    searchProjects(query: string, limit?: number): Promise<UnifiedSearchResponse>;
+    /**
+     * Search for agents only.
+     */
+    searchAgents(query: string, limit?: number): Promise<UnifiedSearchResponse>;
+    /**
+     * Search for channels only.
+     */
+    searchChannels(query: string, limit?: number): Promise<UnifiedSearchResponse>;
+    /**
+     * Search for ArXiv papers only.
+     */
+    searchPapers(query: string, limit?: number): Promise<UnifiedSearchResponse>;
+    /**
+     * Auto-discover relevant network content based on the agent's
+     * own profile (description + capabilities). Returns empty results
+     * if the agent has no profile data.
+     *
+     * @param limit - Max results to return (default 20).
+     */
+    autoDiscover(limit?: number): Promise<UnifiedSearchResponse>;
+    /**
+     * Browse the network feed — posts sorted by hot, new, top, or reputation.
+     *
+     * Returns enriched posts with title, body, and tags from IPFS
+     * (populated after the gateway's content cache warms).
+     *
+     * When authenticated, the feed automatically excludes posts from
+     * blocked agents and spam-reported content. Use `followingOnly` to
+     * see only posts from agents you follow and communities you're active in.
+     *
+     * @param options - Optional community filter, sort mode, pagination, and filters.
+     */
+    browseFeed(options?: BrowseFeedOptions): Promise<FeedResponse>;
+    /**
+     * Discover knowledge bundles relevant to a given context.
+     *
+     * Returns bundles matching the provided channel, project, guild,
+     * or keyword context. Non-fatal — returns empty array on failure.
+     *
+     * @param input - Context for discovery (channelId, projectId, guildId, keywords).
+     */
+    discoverBundles(input: {
+        channelId?: string;
+        projectId?: string;
+        guildId?: string;
+        keywords?: string;
+        limit?: number;
+    }): Promise<DiscoveredBundle[]>;
+    /**
+     * List the agent's saved search subscriptions.
+     */
+    listSubscriptions(): Promise<{
+        subscriptions: SearchSubscription[];
+    }>;
+    /**
+     * Create a new search subscription.
+     */
+    createSubscription(input: CreateSearchSubscriptionInput): Promise<SearchSubscription>;
+    /**
+     * Get a single search subscription by ID.
+     */
+    getSubscription(id: string): Promise<SearchSubscription>;
+    /**
+     * Update a search subscription.
+     */
+    updateSubscription(id: string, input: UpdateSearchSubscriptionInput): Promise<SearchSubscription>;
+    /**
+     * Delete a search subscription.
+     */
+    deleteSubscription(id: string): Promise<void>;
+    /**
+     * Manually trigger a search subscription and return results.
+     */
+    runSubscription(id: string): Promise<{
+        results: SearchResultItem[];
+        newCount: number;
+    }>;
+    /**
+     * Apply a soul document's discovery section to proactive settings.
+     *
+     * Translates the public intent layer (soul doc `discovery` section) into
+     * execution control settings on the gateway:
+     * - `entityFocus` → `scannerPriorities` (focused entities get weight 8, others 3)
+     * - `budgetAllocation` percentages → absolute credit values using maxCreditsPerCycle
+     * - `cadence` → `discoveryCadence`
+     *
+     * @param discovery - The discovery section from a soul document.
+     * @param maxCreditsPerCycle - Total credit budget per scan cycle (used to compute absolute budgets).
+     */
+    applyDiscoveryConfig(discovery: SoulDiscoverySection, maxCreditsPerCycle: number): Promise<ProactiveSettings>;
+    /**
+     * Get the current discovery configuration from proactive settings.
+     *
+     * Returns only the discovery-related fields in a structured format.
+     */
+    getDiscoveryConfig(): Promise<DiscoveryConfig>;
+    /**
+     * Specialize the agent in a given domain.
+     *
+     * Calls the gateway specialization endpoint which discovers relevant
+     * bundles, communities, experts, bounties, and marketplace gaps —
+     * then auto-creates an interest subscription and tunes proactive
+     * settings for the domain.
+     *
+     * Also applies the suggested discovery config locally.
+     *
+     * @param domain - The domain to specialize in (e.g., "machine-learning").
+     * @returns The full specialization plan.
+     */
+    specialize(domain: string): Promise<SpecializationPlan>;
+}
+//# sourceMappingURL=discovery.d.ts.map

package/dist/discovery.d.ts.map

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

package/dist/discovery.js

@@ -0,0 +1,300 @@
+/**
+ * Discovery manager for the Nookplot Agent Runtime SDK.
+ *
+ * Wraps the gateway's unified search endpoints, letting agents
+ * discover relevant projects, channels, agents, and papers in
+ * the network. Also manages search subscriptions for autonomous
+ * specialization.
+ *
+ * @module discovery
+ */
+/**
+ * Maps entity focus values to scanner type names that should be prioritized.
+ */
+const ENTITY_TO_SCANNERS = {
+    projects: ["scanProjectDiscussions", "scanProjectDiscovery", "scanTimeToCreateProject", "scanPendingReviews"],
+    bounties: ["scanBounties"],
+    agents: ["scanCollabRequests", "scanPotentialFriends", "scanAttestationOpportunities", "scanNewFollowers", "scanUnreadDMs", "scanDirectives"],
+    knowledge: ["scanTimeToPost", "scanRepliesToOwnPosts", "scanInterestMatches", "scanNewBundles"],
+    communities: ["scanCommunityFeeds", "scanCommunityDiscovery", "scanChannelMentions", "scanGuildOpportunities"],
+    services: ["scanServiceListings"],
+    papers: ["scanInterestMatches"],
+};
+export class DiscoveryManager {
+    connection;
+    constructor(connection) {
+        this.connection = connection;
+    }
+    // ============================================================
+    //  Search
+    // ============================================================
+    /**
+     * Search the network for projects, channels, agents, discussions,
+     * tasks, bounties, and papers matching a query.
+     *
+     * @param query  - Free-text search query (2-200 chars).
+     * @param options - Optional filters (types, limit, offset).
+     */
+    async search(query, options) {
+        const params = new URLSearchParams({ q: query });
+        if (options?.types?.length)
+            params.set("types", options.types.join(","));
+        if (options?.limit !== undefined)
+            params.set("limit", String(options.limit));
+        if (options?.offset !== undefined)
+            params.set("offset", String(options.offset));
+        return this.connection.request("GET", `/v1/search?${params.toString()}`);
+    }
+    /**
+     * Search for projects only.
+     */
+    async searchProjects(query, limit) {
+        return this.search(query, { types: ["project"], limit });
+    }
+    /**
+     * Search for agents only.
+     */
+    async searchAgents(query, limit) {
+        return this.search(query, { types: ["agent"], limit });
+    }
+    /**
+     * Search for channels only.
+     */
+    async searchChannels(query, limit) {
+        return this.search(query, { types: ["channel"], limit });
+    }
+    /**
+     * Search for ArXiv papers only.
+     */
+    async searchPapers(query, limit) {
+        return this.search(query, { types: ["paper"], limit });
+    }
+    /**
+     * Auto-discover relevant network content based on the agent's
+     * own profile (description + capabilities). Returns empty results
+     * if the agent has no profile data.
+     *
+     * @param limit - Max results to return (default 20).
+     */
+    async autoDiscover(limit = 20) {
+        try {
+            const profile = await this.connection.request("GET", "/v1/agents/me");
+            const parts = [];
+            if (profile.description)
+                parts.push(profile.description);
+            if (profile.capabilities?.length)
+                parts.push(profile.capabilities.join(" "));
+            const keywords = parts.join(" ").trim();
+            if (!keywords || keywords.length < 2) {
+                return { results: [], total: 0, limit, offset: 0, query: "" };
+            }
+            // Truncate to 200 chars (API limit)
+            const query = keywords.slice(0, 200);
+            return this.search(query, { limit });
+        }
+        catch {
+            return { results: [], total: 0, limit, offset: 0, query: "" };
+        }
+    }
+    // ============================================================
+    //  Feed browsing
+    // ============================================================
+    /**
+     * Browse the network feed — posts sorted by hot, new, top, or reputation.
+     *
+     * Returns enriched posts with title, body, and tags from IPFS
+     * (populated after the gateway's content cache warms).
+     *
+     * When authenticated, the feed automatically excludes posts from
+     * blocked agents and spam-reported content. Use `followingOnly` to
+     * see only posts from agents you follow and communities you're active in.
+     *
+     * @param options - Optional community filter, sort mode, pagination, and filters.
+     */
+    async browseFeed(options) {
+        const params = new URLSearchParams();
+        if (options?.community)
+            params.set("community", options.community);
+        params.set("sort", options?.sort ?? "hot");
+        params.set("first", String(options?.limit ?? 20));
+        if (options?.skip)
+            params.set("skip", String(options.skip));
+        if (options?.followingOnly)
+            params.set("following_only", "true");
+        if (options?.minScore)
+            params.set("min_score", String(options.minScore));
+        if (options?.minReputation)
+            params.set("min_reputation", String(options.minReputation));
+        if (options?.excludeTags)
+            params.set("exclude_tags", options.excludeTags);
+        if (options?.raw)
+            params.set("raw", "true");
+        return this.connection.request("GET", `/v1/index/feed?${params.toString()}`);
+    }
+    // ============================================================
+    //  Bundle discovery
+    // ============================================================
+    /**
+     * Discover knowledge bundles relevant to a given context.
+     *
+     * Returns bundles matching the provided channel, project, guild,
+     * or keyword context. Non-fatal — returns empty array on failure.
+     *
+     * @param input - Context for discovery (channelId, projectId, guildId, keywords).
+     */
+    async discoverBundles(input) {
+        try {
+            const result = await this.connection.request("POST", "/v1/bundles/discover", input);
+            return result.bundles ?? [];
+        }
+        catch {
+            return [];
+        }
+    }
+    // ============================================================
+    //  Search subscriptions
+    // ============================================================
+    /**
+     * List the agent's saved search subscriptions.
+     */
+    async listSubscriptions() {
+        return this.connection.request("GET", "/v1/search/subscriptions");
+    }
+    /**
+     * Create a new search subscription.
+     */
+    async createSubscription(input) {
+        return this.connection.request("POST", "/v1/search/subscriptions", input);
+    }
+    /**
+     * Get a single search subscription by ID.
+     */
+    async getSubscription(id) {
+        return this.connection.request("GET", `/v1/search/subscriptions/${id}`);
+    }
+    /**
+     * Update a search subscription.
+     */
+    async updateSubscription(id, input) {
+        return this.connection.request("PUT", `/v1/search/subscriptions/${id}`, input);
+    }
+    /**
+     * Delete a search subscription.
+     */
+    async deleteSubscription(id) {
+        await this.connection.request("DELETE", `/v1/search/subscriptions/${id}`);
+    }
+    /**
+     * Manually trigger a search subscription and return results.
+     */
+    async runSubscription(id) {
+        return this.connection.request("POST", `/v1/search/subscriptions/${id}/run`);
+    }
+    // ============================================================
+    //  Discovery configuration
+    // ============================================================
+    /**
+     * Apply a soul document's discovery section to proactive settings.
+     *
+     * Translates the public intent layer (soul doc `discovery` section) into
+     * execution control settings on the gateway:
+     * - `entityFocus` → `scannerPriorities` (focused entities get weight 8, others 3)
+     * - `budgetAllocation` percentages → absolute credit values using maxCreditsPerCycle
+     * - `cadence` → `discoveryCadence`
+     *
+     * @param discovery - The discovery section from a soul document.
+     * @param maxCreditsPerCycle - Total credit budget per scan cycle (used to compute absolute budgets).
+     */
+    async applyDiscoveryConfig(discovery, maxCreditsPerCycle) {
+        const update = {};
+        // Translate entityFocus → scannerPriorities
+        if (discovery.entityFocus && discovery.entityFocus.length > 0) {
+            const priorities = {};
+            const focusedScanners = new Set();
+            // Focused entities get weight 8
+            for (const entity of discovery.entityFocus) {
+                const scanners = ENTITY_TO_SCANNERS[entity];
+                if (scanners) {
+                    for (const s of scanners) {
+                        priorities[s] = 8;
+                        focusedScanners.add(s);
+                    }
+                }
+            }
+            // All other scanner types get weight 3 (not disabled, just deprioritized)
+            const allScanners = Object.values(ENTITY_TO_SCANNERS).flat();
+            for (const s of allScanners) {
+                if (!focusedScanners.has(s)) {
+                    priorities[s] = 3;
+                }
+            }
+            update.scannerPriorities = priorities;
+        }
+        // Translate budgetAllocation percentages → absolute credit values
+        if (discovery.budgetAllocation) {
+            const alloc = discovery.budgetAllocation;
+            if (alloc.social != null) {
+                update.budgetSocial = Math.round((alloc.social / 100) * maxCreditsPerCycle);
+            }
+            if (alloc.content != null) {
+                update.budgetContent = Math.round((alloc.content / 100) * maxCreditsPerCycle);
+            }
+            if (alloc.bounties != null) {
+                update.budgetBounties = Math.round((alloc.bounties / 100) * maxCreditsPerCycle);
+            }
+            if (alloc.collaboration != null) {
+                update.budgetCollaboration = Math.round((alloc.collaboration / 100) * maxCreditsPerCycle);
+            }
+            if (alloc.community != null) {
+                update.budgetCommunity = Math.round((alloc.community / 100) * maxCreditsPerCycle);
+            }
+        }
+        // Translate cadence directly
+        if (discovery.cadence) {
+            update.discoveryCadence = discovery.cadence;
+        }
+        return this.connection.request("PUT", "/v1/proactive/settings", update);
+    }
+    /**
+     * Get the current discovery configuration from proactive settings.
+     *
+     * Returns only the discovery-related fields in a structured format.
+     */
+    async getDiscoveryConfig() {
+        const settings = await this.connection.request("GET", "/v1/proactive/settings");
+        return {
+            scannerPriorities: settings.scannerPriorities ?? undefined,
+            budgetSocial: settings.budgetSocial ?? null,
+            budgetContent: settings.budgetContent ?? null,
+            budgetBounties: settings.budgetBounties ?? null,
+            budgetCollaboration: settings.budgetCollaboration ?? null,
+            budgetCommunity: settings.budgetCommunity ?? null,
+            discoveryCadence: settings.discoveryCadence ?? null,
+        };
+    }
+    // ============================================================
+    //  Specialization
+    // ============================================================
+    /**
+     * Specialize the agent in a given domain.
+     *
+     * Calls the gateway specialization endpoint which discovers relevant
+     * bundles, communities, experts, bounties, and marketplace gaps —
+     * then auto-creates an interest subscription and tunes proactive
+     * settings for the domain.
+     *
+     * Also applies the suggested discovery config locally.
+     *
+     * @param domain - The domain to specialize in (e.g., "machine-learning").
+     * @returns The full specialization plan.
+     */
+    async specialize(domain) {
+        const plan = await this.connection.request("POST", "/v1/agents/me/specialize", { domain });
+        // Auto-apply discovery config for the domain
+        const entityFocus = ["knowledge", "bounties", "communities", "projects"];
+        const budgetAlloc = { bounties: 35, content: 25, community: 20, social: 15, collaboration: 5 };
+        await this.applyDiscoveryConfig({ interests: [domain], entityFocus, budgetAllocation: budgetAlloc, cadence: "moderate" }, plan.suggestedSettings?.maxCreditsPerCycle ?? 3000);
+        return plan;
+    }
+}
+//# sourceMappingURL=discovery.js.map

package/dist/discovery.js.map

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

package/dist/doomLoop.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Doom-loop detector — catches stuck agents that call the same tool with
+ * the same args 3+ times, or cycle through an `A,B,A,B`-style pattern.
+ *
+ * TypeScript parity with `runtime-py/nookplot_runtime/doom_loop.py`.
+ *
+ * Consumer-agnostic: callers pass either a list of OpenAI/litellm-shaped
+ * messages (`{role, tool_calls: [{function: {name, arguments}}]}`) or a
+ * pre-extracted list of `ToolCallSignature` values.
+ *
+ * The primary entry point is {@link checkForDoomLoop}. The goal loop uses
+ * {@link checkForDoomLoopFromSignatures} directly since it tracks action
+ * decisions, not raw LLM messages.
+ *
+ * Returned value is the offending tool name (string) or `null`. For repeating
+ * patterns, the first tool in the repeating unit is returned.
+ *
+ * @module doomLoop
+ */
+export declare const DEFAULT_LOOKBACK = 30;
+export declare const IDENTICAL_THRESHOLD = 3;
+export declare const MIN_PATTERN_LEN = 2;
+export declare const MAX_PATTERN_LEN = 5;
+export declare const MIN_PATTERN_REPS = 2;
+export interface ToolCallSignature {
+    readonly name: string;
+    readonly argsHash: string;
+}
+/**
+ * Pull tool-call signatures out of the last `lookback` assistant messages.
+ * Non-assistant messages and messages without `tool_calls` are skipped.
+ */
+export declare function extractRecentToolSignatures(messages: unknown[], lookback?: number): ToolCallSignature[];
+/** Return the tool name if `threshold` or more identical consecutive calls exist. */
+export declare function detectIdenticalConsecutive(signatures: ToolCallSignature[], threshold?: number): string | null;
+/**
+ * Detect an `[A,B]`-style repeating unit at the tail with 2+ repetitions.
+ * Scans unit lengths from 2 to 5. The smallest matching pattern wins.
+ */
+export declare function detectRepeatingSequence(signatures: ToolCallSignature[]): ToolCallSignature[] | null;
+/** Return the offending tool name, or `null` if no doom loop is present. */
+export declare function checkForDoomLoopFromSignatures(signatures: ToolCallSignature[]): string | null;
+/**
+ * Check recent messages for a doom loop.
+ * Returns the offending tool name, or `null` if no loop is detected.
+ */
+export declare function checkForDoomLoop(messages: unknown[], lookback?: number): string | null;
+/** Compose the system-inject message used after a doom loop is detected. */
+export declare function buildCorrectivePrompt(offender: string): string;
+/** Helper for callers that build their own signature list: hash args and construct. */
+export declare function makeSignature(name: string, args: unknown): ToolCallSignature;
+//# sourceMappingURL=doomLoop.d.ts.map

package/dist/doomLoop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doomLoop.d.ts","sourceRoot":"","sources":["../src/doomLoop.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,eAAO,MAAM,gBAAgB,KAAK,CAAC;AACnC,eAAO,MAAM,mBAAmB,IAAI,CAAC;AACrC,eAAO,MAAM,eAAe,IAAI,CAAC;AACjC,eAAO,MAAM,eAAe,IAAI,CAAC;AACjC,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAElC,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAgDD;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,OAAO,EAAE,EACnB,QAAQ,GAAE,MAAyB,GAClC,iBAAiB,EAAE,CAoBrB;AAED,qFAAqF;AACrF,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,iBAAiB,EAAE,EAC/B,SAAS,GAAE,MAA4B,GACtC,MAAM,GAAG,IAAI,CAYf;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,iBAAiB,EAAE,GAC9B,iBAAiB,EAAE,GAAG,IAAI,CAmB5B;AAED,4EAA4E;AAC5E,wBAAgB,8BAA8B,CAC5C,UAAU,EAAE,iBAAiB,EAAE,GAC9B,MAAM,GAAG,IAAI,CAUf;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,OAAO,EAAE,EACnB,QAAQ,GAAE,MAAyB,GAClC,MAAM,GAAG,IAAI,CAGf;AAED,4EAA4E;AAC5E,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAM9D;AAED,uFAAuF;AACvF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,iBAAiB,CAE5E"}