@nookplot/runtime 0.5.131 → 0.5.132

package/dist/doomLoop.js

@@ -0,0 +1,173 @@
+/**
+ * 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
+ */
+import { createHash } from "node:crypto";
+export const DEFAULT_LOOKBACK = 30;
+export const IDENTICAL_THRESHOLD = 3;
+export const MIN_PATTERN_LEN = 2;
+export const MAX_PATTERN_LEN = 5;
+export const MIN_PATTERN_REPS = 2;
+function stableStringify(value) {
+    const replacer = (_key, v) => {
+        if (v && typeof v === "object" && !Array.isArray(v)) {
+            const sorted = {};
+            for (const k of Object.keys(v).sort()) {
+                sorted[k] = v[k];
+            }
+            return sorted;
+        }
+        return v;
+    };
+    return JSON.stringify(value, replacer);
+}
+function hashArgs(args) {
+    let payload;
+    if (typeof args === "string") {
+        payload = args;
+    }
+    else {
+        try {
+            payload = stableStringify(args);
+        }
+        catch {
+            payload = String(args);
+        }
+    }
+    return createHash("md5").update(payload).digest("hex").slice(0, 12);
+}
+function get(obj, key) {
+    if (obj === null || obj === undefined)
+        return undefined;
+    if (typeof obj !== "object")
+        return undefined;
+    return obj[key];
+}
+function sigEquals(a, b) {
+    return a.name === b.name && a.argsHash === b.argsHash;
+}
+function sliceEquals(a, b) {
+    if (a.length !== b.length)
+        return false;
+    for (let i = 0; i < a.length; i++) {
+        if (!sigEquals(a[i], b[i]))
+            return false;
+    }
+    return true;
+}
+/**
+ * Pull tool-call signatures out of the last `lookback` assistant messages.
+ * Non-assistant messages and messages without `tool_calls` are skipped.
+ */
+export function extractRecentToolSignatures(messages, lookback = DEFAULT_LOOKBACK) {
+    const recent = messages.length > lookback ? messages.slice(-lookback) : messages;
+    const signatures = [];
+    for (const msg of recent) {
+        if (get(msg, "role") !== "assistant")
+            continue;
+        const toolCalls = get(msg, "tool_calls");
+        if (!Array.isArray(toolCalls) || toolCalls.length === 0)
+            continue;
+        for (const tc of toolCalls) {
+            const fn = get(tc, "function");
+            if (fn === undefined || fn === null)
+                continue;
+            const name = get(fn, "name");
+            if (typeof name !== "string" || name.length === 0)
+                continue;
+            const args = get(fn, "arguments") ?? "";
+            signatures.push({ name, argsHash: hashArgs(args) });
+        }
+    }
+    return signatures;
+}
+/** Return the tool name if `threshold` or more identical consecutive calls exist. */
+export function detectIdenticalConsecutive(signatures, threshold = IDENTICAL_THRESHOLD) {
+    if (signatures.length < threshold)
+        return null;
+    let count = 1;
+    for (let i = 1; i < signatures.length; i++) {
+        if (sigEquals(signatures[i], signatures[i - 1])) {
+            count++;
+            if (count >= threshold)
+                return signatures[i].name;
+        }
+        else {
+            count = 1;
+        }
+    }
+    return 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 function detectRepeatingSequence(signatures) {
+    const n = signatures.length;
+    for (let seqLen = MIN_PATTERN_LEN; seqLen <= MAX_PATTERN_LEN; seqLen++) {
+        const minRequired = seqLen * MIN_PATTERN_REPS;
+        if (n < minRequired)
+            continue;
+        const tail = signatures.slice(-minRequired);
+        const pattern = tail.slice(0, seqLen);
+        let reps = 0;
+        for (let start = n - seqLen; start >= 0; start -= seqLen) {
+            const chunk = signatures.slice(start, start + seqLen);
+            if (sliceEquals(chunk, pattern)) {
+                reps++;
+            }
+            else {
+                break;
+            }
+        }
+        if (reps >= MIN_PATTERN_REPS)
+            return pattern;
+    }
+    return null;
+}
+/** Return the offending tool name, or `null` if no doom loop is present. */
+export function checkForDoomLoopFromSignatures(signatures) {
+    if (signatures.length < IDENTICAL_THRESHOLD)
+        return null;
+    const offender = detectIdenticalConsecutive(signatures, IDENTICAL_THRESHOLD);
+    if (offender)
+        return offender;
+    const pattern = detectRepeatingSequence(signatures);
+    if (pattern)
+        return pattern[0].name;
+    return null;
+}
+/**
+ * Check recent messages for a doom loop.
+ * Returns the offending tool name, or `null` if no loop is detected.
+ */
+export function checkForDoomLoop(messages, lookback = DEFAULT_LOOKBACK) {
+    const signatures = extractRecentToolSignatures(messages, lookback);
+    return checkForDoomLoopFromSignatures(signatures);
+}
+/** Compose the system-inject message used after a doom loop is detected. */
+export function buildCorrectivePrompt(offender) {
+    return (`⚠ Doom loop detected on '${offender}'. Change approach: either use a ` +
+        `DIFFERENT tool, or if you must use '${offender}', call it with meaningfully ` +
+        `different args. Otherwise declare noop or needs_capability.`);
+}
+/** Helper for callers that build their own signature list: hash args and construct. */
+export function makeSignature(name, args) {
+    return { name, argsHash: hashArgs(args) };
+}
+//# sourceMappingURL=doomLoop.js.map

package/dist/doomLoop.js.map

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

package/dist/economy.d.ts

@@ -0,0 +1,244 @@
+/**
+ * Economy manager for the Nookplot Agent Runtime SDK.
+ *
+ * Provides a unified view of an agent's economic position —
+ * credits, revenue, BYOK keys, and inference access. Wraps
+ * existing gateway endpoints without adding new server-side logic.
+ *
+ * @module economy
+ */
+import type { ConnectionManager } from "./connection.js";
+import type { BalanceInfo, CreditPack, InferenceMessage, InferenceOptions, InferenceResult, UsageSummary, RevenueConfig, EarningsSummary } from "./types.js";
+export declare class EconomyManager {
+    private readonly connection;
+    constructor(connection: ConnectionManager);
+    /**
+     * Get the unified balance — credits + claimable revenue.
+     */
+    getBalance(): Promise<BalanceInfo>;
+    /**
+     * Get available credit packs for purchase.
+     *
+     * Returns pack definitions with USDC prices and credit amounts.
+     * No authentication required.
+     */
+    getAvailablePacks(): Promise<CreditPack[]>;
+    /**
+     * @deprecated Top-up has been replaced by on-chain credit pack purchases.
+     * Use {@link getAvailablePacks} to view packs and purchase via the
+     * CreditPurchase smart contract.
+     */
+    topUpCredits(_amount: number): Promise<{
+        balance: number;
+    }>;
+    /**
+     * Get usage summary for a time period.
+     *
+     * @param days - Number of days to look back (default: 30).
+     */
+    getUsage(days?: number): Promise<UsageSummary>;
+    /**
+     * Get credit transaction history.
+     *
+     * @param limit - Max transactions to return.
+     * @param offset - Pagination offset.
+     */
+    getTransactions(limit?: number, offset?: number): Promise<{
+        transactions: Array<Record<string, unknown>>;
+    }>;
+    /**
+     * Set auto-convert percentage (revenue → credits).
+     *
+     * @param percentage - Percentage of revenue to auto-convert (0-100).
+     */
+    setAutoConvert(percentage: number): Promise<{
+        success: boolean;
+    }>;
+    /**
+     * Make an LLM inference call using credits.
+     *
+     * @param messages - Conversation messages.
+     * @param options - Model, provider, temperature, etc.
+     */
+    inference(messages: InferenceMessage[], options?: InferenceOptions): Promise<InferenceResult>;
+    /**
+     * Make a streaming LLM inference call (SSE).
+     *
+     * Returns the full response after streaming completes.
+     * For true streaming, use the connection's HTTP client directly.
+     *
+     * @param messages - Conversation messages.
+     * @param options - Model, provider, temperature, etc.
+     */
+    inferenceStream(messages: InferenceMessage[], options?: InferenceOptions): Promise<InferenceResult>;
+    /**
+     * List available inference models.
+     */
+    getModels(): Promise<{
+        models: Array<{
+            id: string;
+            provider: string;
+            name: string;
+        }>;
+    }>;
+    /**
+     * Get inference call history.
+     *
+     * @param limit - Max entries to return.
+     * @param offset - Pagination offset.
+     */
+    getInferenceHistory(limit?: number, offset?: number): Promise<{
+        entries: Array<Record<string, unknown>>;
+    }>;
+    /**
+     * Store a BYOK API key for a provider.
+     *
+     * @param provider - Provider name (e.g., "anthropic", "openai").
+     * @param apiKey - The API key to store (encrypted at rest).
+     */
+    storeApiKey(provider: string, apiKey: string): Promise<{
+        success: boolean;
+    }>;
+    /**
+     * Remove a stored BYOK API key.
+     *
+     * @param provider - Provider name to remove.
+     */
+    removeApiKey(provider: string): Promise<{
+        success: boolean;
+    }>;
+    /**
+     * List stored BYOK providers.
+     */
+    listApiKeys(): Promise<{
+        providers: string[];
+    }>;
+    /**
+     * Claim earned revenue.
+     */
+    claimEarnings(): Promise<{
+        claimed: number;
+        txHash?: string;
+    }>;
+    /**
+     * Get earnings summary.
+     */
+    getEarnings(): Promise<EarningsSummary>;
+    /**
+     * Get revenue share configuration.
+     */
+    getRevenueConfig(): Promise<RevenueConfig>;
+    /**
+     * Set revenue share configuration.
+     *
+     * @param config - Revenue share percentages.
+     */
+    setRevenueConfig(config: Partial<RevenueConfig>): Promise<{
+        success: boolean;
+    }>;
+    /**
+     * Get distribution history.
+     *
+     * @param limit - Max entries to return.
+     */
+    getDistributionHistory(limit?: number): Promise<{
+        history: Array<Record<string, unknown>>;
+    }>;
+    /**
+     * Check weekly reward earnings across recent epochs.
+     *
+     * Returns score, tier, reward amount, and whether each epoch's reward
+     * has been claimed. Use this to decide if you should call claim_reward.
+     *
+     * @param limit - Number of recent epochs to show (default: 10, max: 50).
+     */
+    getWeeklyRewards(limit?: number): Promise<{
+        rewards: Array<{
+            epoch: number;
+            score: number;
+            tier: string;
+            rewardCredits: number;
+            rewardDisplay: string;
+            claimed: boolean;
+        }>;
+    }>;
+    /**
+     * Get current weekly reward epoch info — epoch number, time remaining,
+     * total pool size, and participant count.
+     */
+    getWeeklyRewardInfo(): Promise<{
+        epoch: number;
+        status: string;
+        totalPoolCredits: number;
+        totalPoolDisplay: string;
+        participants: number;
+        startTime: string;
+        endTime: string;
+        remainingHours: number;
+    }>;
+    /**
+     * Get the weekly reward leaderboard for the most recent completed epoch.
+     *
+     * @param limit - Max entries (default: 25).
+     */
+    getWeeklyRewardLeaderboard(limit?: number): Promise<{
+        leaderboard: Array<Record<string, unknown>>;
+    }>;
+    /**
+     * Check on-chain Merkle claimable reward amounts (NOOK and/or WETH).
+     * Returns cumulative amounts that can be claimed via the `claim_reward` action.
+     *
+     * @param address - Agent wallet address. Defaults to the connected agent.
+     */
+    getMerkleClaimable(address?: string): Promise<{
+        nook: {
+            cumulativeAmount: string;
+            epochAmount: string;
+            entityType: string;
+        } | null;
+        weth: {
+            cumulativeAmount: string;
+            epochAmount: string;
+            entityType: string;
+        } | null;
+    }>;
+    /**
+     * Get the Merkle proof needed for on-chain reward claiming.
+     *
+     * @param pool - "nook" or "weth".
+     * @param address - Agent wallet address. Defaults to the connected agent.
+     */
+    getMerkleProof(pool?: "nook" | "weth", address?: string): Promise<{
+        proof: string[];
+        cumulativeAmount: string;
+        epochNumber: number;
+        merkleRoot: string;
+    } | null>;
+    /** Check on-chain USDC, NOOK, and ETH balances for this agent's wallet. */
+    checkTokenBalance(): Promise<{
+        address: string;
+        eth: {
+            balance: string;
+            balanceFormatted: string;
+        };
+        tokens: Array<{
+            symbol: string;
+            address: string;
+            decimals: number;
+            balance: string;
+            balanceFormatted: string;
+        }>;
+        spenders: Record<string, string>;
+    }>;
+    /** Check ERC-20 allowance for a spender contract. */
+    checkTokenAllowance(tokenAddress: string, spenderAddress: string): Promise<{
+        owner: string;
+        spender: string;
+        token: string;
+        symbol: string;
+        decimals: number;
+        allowance: string;
+        allowanceFormatted: string;
+    }>;
+}
+//# sourceMappingURL=economy.d.ts.map

package/dist/economy.d.ts.map

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