@nookplot/runtime 0.5.118 → 0.5.120

package/dist/goal/types.d.ts

@@ -1,98 +0,0 @@
-/**
- * Goal loop types — shared interfaces for the L3 autonomous goal execution loop.
- *
- * @module goal/types
- */
-import type { NookplotRuntime } from "../index.js";
-/**
- * One action the LLM can return each turn of the goal loop.
- * Parsed from the model's JSON response.
- */
-export type GoalAction = {
-    type: "action";
-    actionName: string;
-    actionParams: Record<string, unknown>;
-    description: string;
-} | {
-    type: "complete";
-    title: string;
-    body: string;
-    domain: string;
-    description: string;
-} | {
-    type: "noop";
-    description: string;
-} | {
-    type: "needs_capability";
-    description: string;
-    suggestedPreset?: string;
-};
-/**
- * Terminal state of a GoalLoop.run() invocation. Always one of the four
- * outcomes — the loop never throws for normal termination conditions.
- */
-export type GoalResult = {
-    outcome: "complete";
-    artifact: {
-        title: string;
-        body: string;
-        domain: string;
-    };
-    stepsExecuted: number;
-    spentNook: bigint;
-} | {
-    outcome: "blocked_budget";
-    spentNook: bigint;
-} | {
-    outcome: "blocked_stuck";
-    stuckReason: string;
-    spentNook: bigint;
-} | {
-    outcome: "blocked_capability";
-    capabilityNeeded: string;
-    suggestedPreset?: string;
-    spentNook: bigint;
-};
-/**
- * Configuration for a single run of the GoalLoop.
- */
-export interface GoalLoopOptions {
-    runtime: NookplotRuntime;
-    goal: string;
-    /** Soft cap — loop continues past this but emits a warning. */
-    budgetNook: bigint;
-    parentSwarmId?: string | null;
-    /** Hard stop on step count. Default 20. */
-    maxSteps?: number;
-    /** Hard stop on consecutive no-op responses. Default 3. */
-    maxConsecutiveNoops?: number;
-    /** Hard stop on consecutive identical step descriptions. Default 3. */
-    maxReformulations?: number;
-    /** Optional verbose logging. */
-    verbose?: boolean;
-    /**
-     * Optional LLM caller — defaults to runtime.economy.inference or a runtime
-     * provided by the consumer. The caller is abstracted because different
-     * environments wire inference differently (platform / BYOK / Ollama).
-     */
-    inferenceCall?: (input: {
-        systemPrompt: string;
-        userPrompt: string;
-        maxTokens: number;
-        temperature: number;
-    }) => Promise<{
-        content: string;
-        costNook?: number;
-    }>;
-}
-/**
- * Result of executing a single step within the goal loop.
- * costNook is optional because many actions are free (off-chain tools).
- */
-export interface StepExecutionResult {
-    ok: boolean;
-    output: string;
-    costNook: number;
-    error?: string;
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/goal/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/goal/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD;;;GAGG;AACH,MAAM,MAAM,UAAU,GAClB;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,WAAW,EAAE,MAAM,CAAC;CACrB,GACD;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB,GACD;IACE,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB,GACD;IACE,IAAI,EAAE,kBAAkB,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEN;;;GAGG;AACH,MAAM,MAAM,UAAU,GAClB;IACE,OAAO,EAAE,UAAU,CAAC;IACpB,QAAQ,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1D,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB,GACD;IACE,OAAO,EAAE,gBAAgB,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;CACnB,GACD;IACE,OAAO,EAAE,eAAe,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB,GACD;IACE,OAAO,EAAE,oBAAoB,CAAC;IAC9B,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEN;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,eAAe,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,uEAAuE;IACvE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gCAAgC;IAChC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE;QACtB,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;KACrB,KAAK,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACvD;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/goal/types.js

@@ -1,7 +0,0 @@
-/**
- * Goal loop types — shared interfaces for the L3 autonomous goal execution loop.
- *
- * @module goal/types
- */
-export {};
-//# sourceMappingURL=types.js.map

package/dist/goal/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/goal/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/loadProfile.d.ts

@@ -1,100 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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"}

package/dist/loadProfile.js

@@ -1,221 +0,0 @@
-/**
- * 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.
- * ```
- */
-import { existsSync, readFileSync } from "node:fs";
-import { homedir } from "node:os";
-import { join } from "node:path";
-function nookplotDir() {
-    return join(homedir(), ".nookplot");
-}
-function credentialsPath() {
-    return join(nookplotDir(), "credentials.json");
-}
-function profilePath(name) {
-    return join(nookplotDir(), "profiles", name, "profile.json");
-}
-function activeProfilePath() {
-    return join(nookplotDir(), "active-profile");
-}
-/**
- * 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 function resolveActiveProfileName(explicitName) {
-    if (explicitName)
-        return explicitName;
-    const env = process.env.NOOKPLOT_PROFILE;
-    if (env)
-        return env;
-    try {
-        if (existsSync(activeProfilePath())) {
-            const content = readFileSync(activeProfilePath(), "utf-8").trim();
-            if (content)
-                return content;
-        }
-    }
-    catch {
-        // Permissions error or disk issue — fall through
-    }
-    return 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 function loadProfile(name) {
-    // 1. Load base credentials — the shared creator API key.
-    if (!existsSync(credentialsPath()))
-        return null;
-    let creds;
-    try {
-        creds = JSON.parse(readFileSync(credentialsPath(), "utf-8"));
-    }
-    catch {
-        return null;
-    }
-    if (!creds.apiKey || !creds.address || !creds.privateKey || !creds.gatewayUrl) {
-        return null;
-    }
-    // 2. Honor NOOKPLOT_GATEWAY_URL env if set (matches SDK + MCP convention).
-    const gatewayUrl = process.env.NOOKPLOT_GATEWAY_URL ?? creds.gatewayUrl;
-    // 3. Resolve profile (if any) and read its scope.
-    const profileName = resolveActiveProfileName(name);
-    if (!profileName) {
-        return {
-            apiKey: creds.apiKey,
-            address: creds.address,
-            privateKey: creds.privateKey,
-            gatewayUrl,
-            displayName: creds.displayName,
-        };
-    }
-    const pPath = profilePath(profileName);
-    if (!existsSync(pPath)) {
-        // Stale profile reference — fall back to creator-direct. Matches
-        // @nookplot/mcp's fail-open pattern.
-        return {
-            apiKey: creds.apiKey,
-            address: creds.address,
-            privateKey: creds.privateKey,
-            gatewayUrl,
-            displayName: creds.displayName,
-        };
-    }
-    try {
-        const p = JSON.parse(readFileSync(pPath, "utf-8"));
-        if (typeof p.scopedAgentAddress !== "string" || p.scopedAgentAddress.length === 0) {
-            // Malformed profile — fall back.
-            return {
-                apiKey: creds.apiKey,
-                address: creds.address,
-                privateKey: creds.privateKey,
-                gatewayUrl,
-                displayName: creds.displayName,
-            };
-        }
-        return {
-            apiKey: creds.apiKey,
-            address: creds.address,
-            privateKey: creds.privateKey,
-            gatewayUrl,
-            scopedAgentAddress: p.scopedAgentAddress,
-            profileName,
-            displayName: creds.displayName,
-        };
-    }
-    catch {
-        // JSON parse error on profile — fall back to creator-direct.
-        return {
-            apiKey: creds.apiKey,
-            address: creds.address,
-            privateKey: creds.privateKey,
-            gatewayUrl,
-            displayName: creds.displayName,
-        };
-    }
-}
-/**
- * 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 function listProfiles() {
-    const dir = join(nookplotDir(), "profiles");
-    if (!existsSync(dir))
-        return [];
-    const out = [];
-    try {
-        const { readdirSync, statSync } = require("node:fs");
-        for (const name of readdirSync(dir).sort()) {
-            const full = join(dir, name);
-            try {
-                if (!statSync(full).isDirectory())
-                    continue;
-            }
-            catch {
-                continue;
-            }
-            const pPath = join(full, "profile.json");
-            if (!existsSync(pPath))
-                continue;
-            try {
-                const p = JSON.parse(readFileSync(pPath, "utf-8"));
-                if (typeof p.scopedAgentAddress !== "string")
-                    continue;
-                out.push({
-                    name,
-                    scopedAgentAddress: p.scopedAgentAddress,
-                    displayName: p.displayName,
-                    hermesProfile: p.hermesProfile,
-                });
-            }
-            catch {
-                // Skip invalid profiles
-            }
-        }
-    }
-    catch {
-        // Missing dir or perms — return empty
-    }
-    return out;
-}
-//# sourceMappingURL=loadProfile.js.map

package/dist/loadProfile.js.map

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

package/dist/mining.d.ts

@@ -1,155 +0,0 @@
-/**
- * Unified mining loop for the Nookplot Agent Runtime SDK.
- *
- * Surfaces a single `np.mining.start()` API that handles the full
- * "discover → rank → solve → submit" cycle across all enabled tracks
- * (knowledge, embedding, RLM). Per-track solver dispatch is private
- * here — solver implementations call out to the gateway via
- * `connection.request()` and the user's existing inference setup
- * (BYOK / local Ollama / gateway-credit-based inference).
- *
- * Usage from the CLI's `nookplot mine` command:
- *   const session = await runtime.mining.start({
- *     tracks: ["knowledge", "embedding", "rlm"],
- *     maxCredits: 5000,
- *     once: false,
- *   });
- *   await session.until(() => process.signals.interrupted);
- *   await session.stop();
- *
- * Same surface from the `mining_opportunity` autonomous handler:
- *   await runtime.mining.runOnce({ tracks: ["knowledge"] });
- *
- * @module mining
- */
-import type { ConnectionManager } from "./connection.js";
-import type { EconomyManager } from "./economy.js";
-export type MiningTrack = "knowledge" | "embedding" | "rlm" | "gradient";
-/**
- * Options shared by every mining entry point — the per-tick concerns that
- * apply to both single-shot (`runOnce`) and long-running (`start`) modes.
- */
-export interface MiningTickOptions {
-    /** Tracks to mine. `'auto'` queries the gateway for tracks with open challenges. */
-    tracks?: MiningTrack[] | "auto";
-    /** Optional guild to attribute submissions to (for guild-tier reward boost). */
-    guildId?: string;
-    /** Log decisions but don't submit. Default false. */
-    dryRun?: boolean;
-    /** Print scoring math for each ranked challenge. Default false. */
-    explain?: boolean;
-    /**
-     * User-supplied embedding generator. Required for the embedding track —
-     * the runtime intentionally does not bundle an Ollama client because that
-     * is a CLI concern. If absent, the embedding track is skipped with a clear
-     * "no embedding generator provided" status.
-     */
-    generateEmbeddings?: (prompts: string[], dimensions: number) => Promise<number[][]>;
-    /**
-     * Override the default knowledge solver. Receives the challenge object,
-     * returns the trace text. Defaults to a single inference call seeded with
-     * the challenge title + description.
-     */
-    solveKnowledge?: (challenge: ChallengeSummary, economy: EconomyManager) => Promise<string>;
-    /**
-     * Override the default RLM solver. Default is a no-op stub that records
-     * "deferred" — full RLM autosolve is gated on a future phase. Custom
-     * solvers can drive the REPL via `runtime.connection.request()`.
-     */
-    solveRlm?: (challenge: ChallengeSummary, economy: EconomyManager) => Promise<TrackResult>;
-    /** Optional verbose logger. Defaults to no-op. */
-    log?: (msg: string) => void;
-}
-/**
- * Options for the long-running loop mode (`start`). Adds budget caps and
- * tick scheduling that don't apply to single-shot dispatch.
- */
-export interface MiningStartOptions extends MiningTickOptions {
-    /** Total credit budget for this session across all RLM sub-calls. Defaults to 5000. */
-    maxCredits?: number;
-    /** Solve all currently-open challenges, then exit. Default false. */
-    once?: boolean;
-    /** Tick interval in milliseconds. Default 60_000. */
-    tickIntervalMs?: number;
-}
-export interface ChallengeSummary {
-    id: string;
-    track: MiningTrack;
-    title: string;
-    description?: string;
-    difficulty: "easy" | "medium" | "hard" | "expert";
-    estimatedRewardNook: number;
-    domainTags: string[];
-    sourceType: string;
-    closesAt: string;
-    /** Filled after rank() with the challenge's composite score. */
-    rankScore?: number;
-}
-export interface TrackResult {
-    track: MiningTrack;
-    challengeId: string;
-    status: "submitted" | "skipped" | "error";
-    reason?: string;
-    submissionId?: string;
-    estimatedRewardNook?: number;
-}
-export interface MiningStats {
-    ticks: number;
-    attempted: number;
-    submitted: number;
-    /** Solver chose not to submit (no prompts, trace too short, no callback, etc.). */
-    skipped: number;
-    /** Suppressed submissions because of `dryRun: true`. Counted separately so
-     * the end-of-session banner can distinguish a dry-run from real skips. */
-    dryRun: number;
-    errors: number;
-    creditsSpent: number;
-    byTrack: Record<MiningTrack, {
-        attempted: number;
-        submitted: number;
-        errors: number;
-    }>;
-}
-export interface MiningSession {
-    /** Resolves when the session has stopped (either via `stop()` or `once: true` completion). */
-    done: Promise<void>;
-    /** Request graceful shutdown. Idempotent. */
-    stop(): Promise<void>;
-    /** Snapshot of running stats. */
-    stats(): MiningStats;
-}
-export declare function trackOf(sourceType: string): MiningTrack;
-export declare class MiningManager {
-    private readonly connection;
-    private readonly economy;
-    private activeSession;
-    constructor(connection: ConnectionManager, economy: EconomyManager);
-    /**
-     * Start a long-running mining session. Returns immediately; the loop runs
-     * in the background until `session.stop()` or `once: true` completion.
-     */
-    start(opts?: MiningStartOptions): Promise<MiningSession>;
-    /**
-     * Run one tick (discover → rank → solve top → submit) and return the
-     * results. Suitable for `mining_opportunity` autonomous-handler dispatch.
-     * Loop-only options (`maxCredits`, `tickIntervalMs`, `once`) are not
-     * accepted here — they're meaningless for a single-shot call.
-     */
-    runOnce(opts?: MiningTickOptions): Promise<TrackResult[]>;
-    /** Snapshot stats from the active session, if any. */
-    stats(): MiningStats | null;
-    private makeSession;
-    private tick;
-    private resolveTracks;
-    private discoverAcross;
-    private discoverKnowledge;
-    private discoverEmbedding;
-    private discoverRlm;
-    private toSummary;
-    private solveOne;
-    private solveKnowledgeChallenge;
-    private defaultKnowledgeSolver;
-    private solveEmbeddingChallenge;
-    private solveRlmChallenge;
-}
-//# sourceMappingURL=mining.d.ts.map

package/dist/mining.d.ts.map

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