@nookplot/runtime 0.5.138 → 0.5.140

package/dist/inference/surplusInference.js

@@ -0,0 +1,455 @@
+/**
+ * Surplus Intelligence inference via x402 (non-custodial USDC passthrough).
+ *
+ * Lets a self-hosted agent pay for inference per-request in USDC, signed and
+ * settled directly from its OWN wallet via the x402 protocol — the Nookplot
+ * gateway is bypassed entirely (no proxy, no metering, no custody).
+ *
+ * Scope: self-hosted runtime/CLI agents only. The agent MUST hold a local
+ * signing key (`connection.privateKey`). API-key-only / gasless-relay agents
+ * cannot sign x402 and are rejected with a {@link SurplusError}.
+ *
+ * The x402 + viem dependencies are OPTIONAL peers, lazily `import()`-ed only
+ * when this path actually runs (mirrors the optional-`ethers` pattern in
+ * `signing.ts`). Agents that never select Surplus never load them.
+ *
+ * @module inference/surplusInference
+ */
+import { readFileSync, writeFileSync } from "node:fs";
+// ── Constants (verified against the x402 directory listing + a live 402 probe, 2026-06-01) ──
+/** Canonical Surplus x402 OpenAI-compatible chat-completions endpoint. */
+export const SURPLUS_URL = "https://www.surplusintelligence.ai/x402/api/inference/v1/chat/completions";
+/** CAIP-2 network id for Base mainnet — the only network Surplus settles on. */
+export const SURPLUS_NETWORK = "eip155:8453";
+/** Canonical Base-mainnet USDC (6 decimals). Settlement asset is asserted against this. */
+export const BASE_USDC = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
+/**
+ * Canonical Surplus settlement recipient (the x402 `payTo`), from the live 402
+ * probe (2026-06-01). Asserted by DEFAULT as defense-in-depth against a spoofed
+ * payment recipient. x402 settles to the resource server's single address, so
+ * one value is correct for the marketplace (peers are paid off-band, not via
+ * this `payTo`). Override via {@link SurplusConfig.payTo} if Surplus rotates it.
+ */
+export const SURPLUS_PAYTO = "0x8581784D3E598cCa3482375CFF2409Ac9DD8c402";
+/** Default Surplus model when none is configured (cheap, broadly available). */
+export const DEFAULT_SURPLUS_MODEL = "llama-3.3-70b";
+/**
+ * Default per-call USDC ceiling. A safety backstop against a malicious or
+ * mispriced 402 quote — generous enough not to block normal frontier calls
+ * (starting price ≈ $0.0033/call), tight enough to bound a runaway/spoofed
+ * quote. Override via {@link SurplusConfig.maxUsdcPerCall}.
+ */
+export const DEFAULT_MAX_USDC_PER_CALL = 1.0;
+/**
+ * Default AGGREGATE USDC ceiling per rolling window, applied when no
+ * `maxUsdcPerSession` is configured. A long-running autonomous/mining daemon is
+ * otherwise bounded only by the per-call cap — this is the one control that
+ * bounds TOTAL spend. Generous (~3,000 calls at the ≈$0.0033 starting price) so
+ * it never halts normal use, tight enough to stop a runaway. Raise it via
+ * {@link SurplusConfig.maxUsdcPerSession} for heavier workloads.
+ */
+export const DEFAULT_MAX_USDC_PER_SESSION = 10.0;
+/**
+ * Rolling-window length for the per-session cap (24h). When the window elapses
+ * the accumulator resets, so the cap behaves as a per-day budget rather than a
+ * lifetime one — a persisted tracker won't permanently brick an agent. Mirrors
+ * the daily-cap idiom used elsewhere in the protocol.
+ */
+const SURPLUS_SESSION_WINDOW_MS = 24 * 60 * 60 * 1000;
+/** USDC has 6 decimals — multiplier from human units to atomic base units. */
+const USDC_DECIMALS = 6;
+const USDC_BASE = 10n ** BigInt(USDC_DECIMALS);
+/**
+ * Dynamically import an OPTIONAL peer via a NON-LITERAL specifier. The
+ * non-literal specifier makes `tsc` return `Promise<any>` and skip type
+ * resolution — `@x402/fetch` ships its types behind an `exports` map that the
+ * runtime's `moduleResolution: node` can't follow, and we cast against the
+ * hand-verified API anyway (mirrors the optional-`ethers` pattern in
+ * `signing.ts`).
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+async function importOptional(specifier) {
+    return import(specifier);
+}
+/** True if a thrown error is a "module not installed" failure (ESM or CJS code). */
+function isModuleNotFound(err) {
+    if (!err || typeof err !== "object" || !("code" in err))
+        return false;
+    const code = err.code;
+    return code === "ERR_MODULE_NOT_FOUND" || code === "MODULE_NOT_FOUND";
+}
+/**
+ * Walk an error's `cause` chain for a {@link SurplusError}. An x402 transport
+ * may re-wrap a selector throw (`over_cap` / `payto_mismatch` / …) in its own
+ * error type; this recovers the original typed code so it survives rather than
+ * degrading to a generic `request_failed` (mirrors the Python
+ * `_find_surplus_error`).
+ */
+function findSurplusError(err) {
+    let cur = err;
+    const seen = new Set();
+    for (let i = 0; i < 8; i++) {
+        if (cur == null || seen.has(cur))
+            break;
+        seen.add(cur);
+        if (cur instanceof SurplusError)
+            return cur;
+        cur = cur.cause;
+    }
+    return null;
+}
+/**
+ * Typed error for every Surplus failure mode. Thrown — never swallowed into a
+ * silent fallback (default-restrictive: an error must never become an
+ * unintended spend on another rail).
+ */
+export class SurplusError extends Error {
+    /** Stable machine code for programmatic handling / tests. */
+    code;
+    constructor(message, code = "surplus_error") {
+        super(message);
+        this.name = "SurplusError";
+        this.code = code;
+    }
+}
+/** Atomic USDC base units of a requirement (v2 `amount`, fallback v1 `maxAmountRequired`). */
+function requirementBaseUnits(req) {
+    const raw = req.amount ?? req.maxAmountRequired;
+    if (raw == null) {
+        throw new SurplusError("Surplus 402 quote is missing an amount field.", "bad_quote");
+    }
+    try {
+        return BigInt(raw);
+    }
+    catch {
+        throw new SurplusError(`Surplus 402 quote has a non-integer amount: ${String(raw)}`, "bad_quote");
+    }
+}
+/** Format atomic USDC base units as a human "$X.XXXXXX" string for error messages. */
+function formatUsdc(baseUnits) {
+    const whole = baseUnits / USDC_BASE;
+    const frac = (baseUnits % USDC_BASE).toString().padStart(USDC_DECIMALS, "0");
+    return `${whole}.${frac}`;
+}
+/** Convert a human USDC ceiling (e.g. 1.0) to atomic base units. */
+export function usdcToBaseUnits(usdc) {
+    if (!Number.isFinite(usdc) || usdc < 0) {
+        throw new SurplusError(`Invalid maxUsdcPerCall: ${String(usdc)}`, "bad_config");
+    }
+    // Round to the nearest atomic unit; avoids float drift on values like 0.1.
+    return BigInt(Math.round(usdc * Number(USDC_BASE)));
+}
+/** Read-only clock seam (kept tiny so the selector stays easy to reason about). */
+function nowMs() {
+    return Date.now();
+}
+/**
+ * Load a persisted spend state, rolling the window over if it has elapsed (a
+ * restart after the window means a fresh budget). Any read/parse failure starts
+ * fresh — persistence is best-effort and never blocks inference.
+ */
+function loadSpendState(statePath) {
+    const now = nowMs();
+    try {
+        const obj = JSON.parse(readFileSync(statePath, "utf8"));
+        const windowStartMs = typeof obj.windowStartMs === "number" ? obj.windowStartMs : now;
+        if (now - windowStartMs >= SURPLUS_SESSION_WINDOW_MS) {
+            return { spentBaseUnits: 0n, windowStartMs: now };
+        }
+        let spent = 0n;
+        try {
+            spent = BigInt(String(obj.spentBaseUnits));
+        }
+        catch {
+            spent = 0n;
+        }
+        return { spentBaseUnits: spent < 0n ? 0n : spent, windowStartMs };
+    }
+    catch {
+        return { spentBaseUnits: 0n, windowStartMs: now };
+    }
+}
+/** Persist the tracker (best-effort — a write failure never blocks inference). */
+function saveSpendState(statePath, tracker) {
+    try {
+        writeFileSync(statePath, JSON.stringify({
+            spentBaseUnits: tracker.spentBaseUnits.toString(),
+            windowStartMs: tracker.windowStartMs,
+        }), "utf8");
+    }
+    catch {
+        /* best-effort: never block a paid inference on a persistence failure */
+    }
+}
+/**
+ * Build a spend tracker for a runtime/session. With no `statePath` it is a fresh
+ * in-memory accumulator; with one it loads the prior cumulative spend and
+ * persists after each authorized spend so the cap survives restarts.
+ */
+export function createSurplusSpendTracker(statePath) {
+    if (!statePath) {
+        return { spentBaseUnits: 0n, windowStartMs: nowMs() };
+    }
+    const loaded = loadSpendState(statePath);
+    const tracker = {
+        spentBaseUnits: loaded.spentBaseUnits,
+        windowStartMs: loaded.windowStartMs,
+    };
+    tracker.persist = () => saveSpendState(statePath, tracker);
+    return tracker;
+}
+/**
+ * Resolve the effective `payTo` assertion target: an explicit config override,
+ * else the canonical {@link SURPLUS_PAYTO}. The recipient is asserted by default
+ * (defense-in-depth) — unlike {@link makeSurplusSelector}, which only asserts
+ * when given a `payTo` (so its unit-level "open selector" semantics are kept).
+ */
+export function resolveSurplusPayTo(config) {
+    return config?.payTo ?? SURPLUS_PAYTO;
+}
+/**
+ * Build the payment-requirements selector enforcing the spend controls:
+ * - scheme must be `exact`, on Base (`eip155:8453`), paying canonical USDC;
+ * - if `payTo` is configured, the quote's recipient must match it;
+ * - the cheapest eligible quote is chosen, and rejected if it exceeds the
+ *   per-call cap;
+ * - if a `tracker` + `maxSessionBaseUnits` are given, the AUTHORIZED amount is
+ *   accumulated and rejected once the running total would exceed the session
+ *   cap. Tracking the authorized (not settled) amount is deliberately
+ *   conservative: it can only stop spending earlier, never permit an overspend.
+ *
+ * Any violation throws a {@link SurplusError} (propagates out of the wrapped
+ * fetch) — the payment is never signed, and a rejected attempt is NOT counted.
+ */
+export function makeSurplusSelector(opts) {
+    const wantAsset = (opts.asset ?? BASE_USDC).toLowerCase();
+    const wantPayTo = opts.payTo?.toLowerCase();
+    return (_x402Version, requirements) => {
+        const eligible = requirements.filter((r) => r.scheme === "exact" &&
+            String(r.network) === SURPLUS_NETWORK &&
+            typeof r.asset === "string" &&
+            r.asset.toLowerCase() === wantAsset);
+        if (eligible.length === 0) {
+            throw new SurplusError("Surplus offered no `exact` USDC payment option on Base (eip155:8453).", "no_eligible_requirement");
+        }
+        // Cheapest first — defends against an inflated duplicate quote.
+        eligible.sort((a, b) => {
+            const av = requirementBaseUnits(a);
+            const bv = requirementBaseUnits(b);
+            return av < bv ? -1 : av > bv ? 1 : 0;
+        });
+        const chosen = eligible[0];
+        if (wantPayTo &&
+            typeof chosen.payTo === "string" &&
+            chosen.payTo.toLowerCase() !== wantPayTo) {
+            throw new SurplusError(`Surplus payTo ${chosen.payTo} does not match the configured expected address.`, "payto_mismatch");
+        }
+        const amount = requirementBaseUnits(chosen);
+        if (amount > opts.maxBaseUnits) {
+            throw new SurplusError(`Surplus quote ${formatUsdc(amount)} USDC exceeds the per-call cap of ` +
+                `${formatUsdc(opts.maxBaseUnits)} USDC.`, "over_cap");
+        }
+        // Aggregate session cap — the one control that bounds TOTAL spend across a
+        // long-running daemon / mining loop (the per-call cap does not). Record only
+        // on success, so a rejected attempt never inflates the total.
+        if (opts.tracker && opts.maxSessionBaseUnits != null) {
+            const now = nowMs();
+            // Roll the window over once it has elapsed (covers both a >24h continuous
+            // run and a restart that resumed a still-open window from disk). Seed the
+            // window start on first use for trackers created without one.
+            if (opts.tracker.windowStartMs &&
+                now - opts.tracker.windowStartMs >= SURPLUS_SESSION_WINDOW_MS) {
+                opts.tracker.windowStartMs = now;
+                opts.tracker.spentBaseUnits = 0n;
+            }
+            else if (!opts.tracker.windowStartMs) {
+                opts.tracker.windowStartMs = now;
+            }
+            const projected = opts.tracker.spentBaseUnits + amount;
+            if (projected > opts.maxSessionBaseUnits) {
+                throw new SurplusError(`Surplus session spend ${formatUsdc(projected)} USDC would exceed the ` +
+                    `per-session cap of ${formatUsdc(opts.maxSessionBaseUnits)} USDC.`, "over_session_cap");
+            }
+            opts.tracker.spentBaseUnits = projected;
+            opts.tracker.persist?.();
+        }
+        return chosen;
+    };
+}
+/**
+ * Map runtime messages + options to an OpenAI-compatible chat-completions body.
+ * `systemPrompt` is prepended as a `system` message (the runtime convention).
+ * Streaming is forced off — v1 is non-streaming.
+ */
+export function buildSurplusBody(messages, options, model) {
+    const out = [];
+    if (options?.systemPrompt) {
+        out.push({ role: "system", content: options.systemPrompt });
+    }
+    for (const m of messages) {
+        const om = { role: m.role, content: m.content };
+        // Pass through tool-call linkage when present; harmless for prose agents.
+        if (m.role === "tool" && m.toolCallId)
+            om.tool_call_id = m.toolCallId;
+        out.push(om);
+    }
+    const body = { model, messages: out, stream: false };
+    if (options?.maxTokens != null)
+        body.max_tokens = options.maxTokens;
+    if (options?.temperature != null)
+        body.temperature = options.temperature;
+    return body;
+}
+function toCount(v) {
+    return typeof v === "number" && Number.isFinite(v) ? v : 0;
+}
+/**
+ * Decode the `X-PAYMENT-RESPONSE` settlement header (x402 encodes it as
+ * base64(JSON); base64url is tolerated). Returns `null` on any failure — the
+ * settlement check is best-effort and never blocks a successful 2xx body.
+ */
+function decodeSettleHeader(header) {
+    try {
+        const normalized = header.replace(/-/g, "+").replace(/_/g, "/");
+        return JSON.parse(Buffer.from(normalized, "base64").toString("utf8"));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Parse a Surplus chat-completions Response into an {@link InferenceResult}.
+ *
+ * Also performs a defensive settlement check: if the `X-PAYMENT-RESPONSE`
+ * header decodes to an explicit failure, we surface it rather than returning a
+ * body that was not actually paid for. `creditsCost` is always 0 — these calls
+ * are paid in USDC, never in Nookplot credits.
+ */
+export async function parseSurplusResponse(res, requestedModel) {
+    if (!res.ok) {
+        let detail = "";
+        try {
+            detail = (await res.text()).slice(0, 500);
+        }
+        catch {
+            /* ignore body read failure */
+        }
+        throw new SurplusError(`Surplus returned HTTP ${res.status}${detail ? `: ${detail}` : ""}`, res.status === 402 ? "payment_required" : "http_error");
+    }
+    // Defensive settlement true-up (best-effort): if the settlement header
+    // decodes to an explicit failure, surface it rather than returning a body
+    // that was not actually paid for.
+    const settleHeader = res.headers.get("X-PAYMENT-RESPONSE");
+    if (settleHeader) {
+        const settle = decodeSettleHeader(settleHeader);
+        if (settle && settle.success === false) {
+            throw new SurplusError(`Surplus payment did not settle: ${settle.errorReason ?? settle.errorMessage ?? "unknown reason"}`, "settle_failed");
+        }
+    }
+    let json;
+    try {
+        json = await res.json();
+    }
+    catch {
+        throw new SurplusError("Surplus returned a non-JSON response body.", "bad_response");
+    }
+    const obj = (json ?? {});
+    const content = obj.choices?.[0]?.message?.content;
+    if (typeof content !== "string") {
+        throw new SurplusError("Surplus response is missing choices[0].message.content.", "bad_response");
+    }
+    const usage = obj.usage ?? {};
+    return {
+        content,
+        model: typeof obj.model === "string" ? obj.model : requestedModel,
+        provider: "surplus",
+        usage: {
+            promptTokens: toCount(usage.prompt_tokens),
+            completionTokens: toCount(usage.completion_tokens),
+            totalTokens: toCount(usage.total_tokens),
+            creditsCost: 0,
+        },
+    };
+}
+/** Normalize a raw private key to the `0x`-prefixed form viem expects. */
+function normalizePrivateKey(pk) {
+    const hex = pk.startsWith("0x") ? pk : `0x${pk}`;
+    return hex;
+}
+/**
+ * Lazily build the x402 payment-wrapped fetch from a raw private key. Imports
+ * the optional `@x402/*` + `viem` peers on first use; a missing peer yields a
+ * clear install hint. EIP-3009 (`exact`) signing is fully offline — no RPC URL.
+ */
+async function buildPaymentFetch(privateKey, selector) {
+    try {
+        const viemAccounts = await importOptional("viem/accounts");
+        const x402Fetch = await importOptional("@x402/fetch");
+        const x402Evm = await importOptional("@x402/evm");
+        const account = viemAccounts.privateKeyToAccount(normalizePrivateKey(privateKey));
+        // `selector` is structurally an x402 SelectPaymentRequirements; the dynamic
+        // imports are untyped (any), so the wiring stays contained to this function.
+        const client = new x402Fetch.x402Client(selector).register(SURPLUS_NETWORK, new x402Evm.ExactEvmScheme(account));
+        return x402Fetch.wrapFetchWithPayment(globalThis.fetch, client);
+    }
+    catch (err) {
+        if (isModuleNotFound(err)) {
+            throw new SurplusError("Surplus inference requires the optional peers '@x402/fetch', '@x402/evm', and 'viem'. " +
+                "Install them: npm install @x402/fetch @x402/evm viem", "missing_deps");
+        }
+        if (err instanceof SurplusError)
+            throw err;
+        throw new SurplusError(`Failed to initialize the Surplus x402 client: ${err instanceof Error ? err.message : String(err)}`, "client_init_failed");
+    }
+}
+/**
+ * Run a single non-streaming inference against Surplus, paying per-request in
+ * USDC via x402 from the agent's own wallet. Returns the same
+ * {@link InferenceResult} shape as the gateway path, so it slots transparently
+ * into every downstream consumer (chat, autonomous loop, mining, goal loop).
+ */
+export async function surplusInference(params) {
+    const { privateKey, messages, options, config } = params;
+    // Mandatory keyless gate (correctness, not an attack vector): never attempt
+    // an unsigned/partial payment. Throw before any network call.
+    if (!privateKey) {
+        throw new SurplusError("Surplus inference requires a local signing key (set `privateKey`). " +
+            "This agent is API-key-only and cannot sign x402 payments.", "keyless");
+    }
+    const model = options?.model ?? config?.model ?? DEFAULT_SURPLUS_MODEL;
+    const url = config?.baseUrl ?? SURPLUS_URL;
+    const maxBaseUnits = usdcToBaseUnits(config?.maxUsdcPerCall ?? DEFAULT_MAX_USDC_PER_CALL);
+    const selector = makeSurplusSelector({
+        maxBaseUnits,
+        asset: BASE_USDC,
+        payTo: resolveSurplusPayTo(config), // default-on payTo assertion
+        tracker: params.tracker,
+        // Default-on aggregate cap: a long-running daemon is otherwise bounded only
+        // by the per-call cap. Override (incl. a large value to effectively disable)
+        // via `maxUsdcPerSession`.
+        maxSessionBaseUnits: usdcToBaseUnits(config?.maxUsdcPerSession ?? DEFAULT_MAX_USDC_PER_SESSION),
+    });
+    const fetchWithPay = params.paymentFetch ?? (await buildPaymentFetch(privateKey, selector));
+    const body = buildSurplusBody(messages, options, model);
+    let res;
+    try {
+        res = await fetchWithPay(url, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify(body),
+        });
+    }
+    catch (err) {
+        if (err instanceof SurplusError)
+            throw err; // selector cap/asset/payTo rejection
+        // A wrapped selector throw (the transport re-raised it as its own error)
+        // still carries the typed code on its cause chain — recover it so the
+        // specific reason survives instead of a generic `request_failed`.
+        const wrapped = findSurplusError(err);
+        if (wrapped)
+            throw wrapped;
+        throw new SurplusError(`Surplus request failed: ${err instanceof Error ? err.message : String(err)}`, "request_failed");
+    }
+    return parseSurplusResponse(res, model);
+}
+//# sourceMappingURL=surplusInference.js.map

package/dist/inference/surplusInference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"surplusInference.js","sourceRoot":"","sources":["../../src/inference/surplusInference.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAStD,+FAA+F;AAE/F,0EAA0E;AAC1E,MAAM,CAAC,MAAM,WAAW,GACtB,2EAA2E,CAAC;AAE9E,gFAAgF;AAChF,MAAM,CAAC,MAAM,eAAe,GAAG,aAAa,CAAC;AAE7C,2FAA2F;AAC3F,MAAM,CAAC,MAAM,SAAS,GAAG,4CAA4C,CAAC;AAEtE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,4CAA4C,CAAC;AAE1E,gFAAgF;AAChF,MAAM,CAAC,MAAM,qBAAqB,GAAG,eAAe,CAAC;AAErD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,GAAG,CAAC;AAE7C;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,IAAI,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,yBAAyB,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAEtD,8EAA8E;AAC9E,MAAM,aAAa,GAAG,CAAC,CAAC;AACxB,MAAM,SAAS,GAAG,GAAG,IAAI,MAAM,CAAC,aAAa,CAAC,CAAC;AAE/C;;;;;;;GAOG;AACH,8DAA8D;AAC9D,KAAK,UAAU,cAAc,CAAC,SAAiB;IAC7C,OAAO,MAAM,CAAC,SAAS,CAAC,CAAC;AAC3B,CAAC;AAED,oFAAoF;AACpF,SAAS,gBAAgB,CAAC,GAAY;IACpC,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,IAAI,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IACtE,MAAM,IAAI,GAAI,GAAyB,CAAC,IAAI,CAAC;IAC7C,OAAO,IAAI,KAAK,sBAAsB,IAAI,IAAI,KAAK,kBAAkB,CAAC;AACxE,CAAC;AAED;;;;;;GAMG;AACH,SAAS,gBAAgB,CAAC,GAAY;IACpC,IAAI,GAAG,GAAY,GAAG,CAAC;IACvB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAW,CAAC;IAChC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,IAAI,GAAG,IAAI,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,MAAM;QACxC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,IAAI,GAAG,YAAY,YAAY;YAAE,OAAO,GAAG,CAAC;QAC5C,GAAG,GAAI,GAA2B,CAAC,KAAK,CAAC;IAC3C,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,OAAO,YAAa,SAAQ,KAAK;IACrC,6DAA6D;IACpD,IAAI,CAAS;IACtB,YAAY,OAAe,EAAE,IAAI,GAAG,eAAe;QACjD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAwBD,8FAA8F;AAC9F,SAAS,oBAAoB,CAAC,GAA8B;IAC1D,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,iBAAiB,CAAC;IAChD,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;QAChB,MAAM,IAAI,YAAY,CACpB,+CAA+C,EAC/C,WAAW,CACZ,CAAC;IACJ,CAAC;IACD,IAAI,CAAC;QACH,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,YAAY,CACpB,+CAA+C,MAAM,CAAC,GAAG,CAAC,EAAE,EAC5D,WAAW,CACZ,CAAC;IACJ,CAAC;AACH,CAAC;AAED,sFAAsF;AACtF,SAAS,UAAU,CAAC,SAAiB;IACnC,MAAM,KAAK,GAAG,SAAS,GAAG,SAAS,CAAC;IACpC,MAAM,IAAI,GAAG,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;IAC7E,OAAO,GAAG,KAAK,IAAI,IAAI,EAAE,CAAC;AAC5B,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,YAAY,CACpB,2BAA2B,MAAM,CAAC,IAAI,CAAC,EAAE,EACzC,YAAY,CACb,CAAC;IACJ,CAAC;IACD,2EAA2E;IAC3E,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;AACtD,CAAC;AAmBD,mFAAmF;AACnF,SAAS,KAAK;IACZ,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC;AACpB,CAAC;AAED;;;;GAIG;AACH,SAAS,cAAc,CAAC,SAAiB;IAIvC,MAAM,GAAG,GAAG,KAAK,EAAE,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAGrD,CAAC;QACF,MAAM,aAAa,GACjB,OAAO,GAAG,CAAC,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC;QAClE,IAAI,GAAG,GAAG,aAAa,IAAI,yBAAyB,EAAE,CAAC;YACrD,OAAO,EAAE,cAAc,EAAE,EAAE,EAAE,aAAa,EAAE,GAAG,EAAE,CAAC;QACpD,CAAC;QACD,IAAI,KAAK,GAAG,EAAE,CAAC;QACf,IAAI,CAAC;YACH,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC;QAC7C,CAAC;QAAC,MAAM,CAAC;YACP,KAAK,GAAG,EAAE,CAAC;QACb,CAAC;QACD,OAAO,EAAE,cAAc,EAAE,KAAK,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,aAAa,EAAE,CAAC;IACpE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,cAAc,EAAE,EAAE,EAAE,aAAa,EAAE,GAAG,EAAE,CAAC;IACpD,CAAC;AACH,CAAC;AAED,kFAAkF;AAClF,SAAS,cAAc,CAAC,SAAiB,EAAE,OAA4B;IACrE,IAAI,CAAC;QACH,aAAa,CACX,SAAS,EACT,IAAI,CAAC,SAAS,CAAC;YACb,cAAc,EAAE,OAAO,CAAC,cAAc,CAAC,QAAQ,EAAE;YACjD,aAAa,EAAE,OAAO,CAAC,aAAa;SACrC,CAAC,EACF,MAAM,CACP,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,wEAAwE;IAC1E,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CACvC,SAAkB;IAElB,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,EAAE,cAAc,EAAE,EAAE,EAAE,aAAa,EAAE,KAAK,EAAE,EAAE,CAAC;IACxD,CAAC;IACD,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;IACzC,MAAM,OAAO,GAAwB;QACnC,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,aAAa,EAAE,MAAM,CAAC,aAAa;KACpC,CAAC;IACF,OAAO,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC,cAAc,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC3D,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAsB;IACxD,OAAO,MAAM,EAAE,KAAK,IAAI,aAAa,CAAC;AACxC,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAMnC;IACC,MAAM,SAAS,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC;IAC1D,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,EAAE,WAAW,EAAE,CAAC;IAE5C,OAAO,CAAC,YAAY,EAAE,YAAY,EAAE,EAAE;QACpC,MAAM,QAAQ,GAAG,YAAY,CAAC,MAAM,CAClC,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,MAAM,KAAK,OAAO;YACpB,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,eAAe;YACrC,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ;YAC3B,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,SAAS,CACtC,CAAC;QACF,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,YAAY,CACpB,uEAAuE,EACvE,yBAAyB,CAC1B,CAAC;QACJ,CAAC;QAED,gEAAgE;QAChE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACrB,MAAM,EAAE,GAAG,oBAAoB,CAAC,CAAC,CAAC,CAAC;YACnC,MAAM,EAAE,GAAG,oBAAoB,CAAC,CAAC,CAAC,CAAC;YACnC,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QAE3B,IACE,SAAS;YACT,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ;YAChC,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,SAAS,EACxC,CAAC;YACD,MAAM,IAAI,YAAY,CACpB,iBAAiB,MAAM,CAAC,KAAK,kDAAkD,EAC/E,gBAAgB,CACjB,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAC5C,IAAI,MAAM,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;YAC/B,MAAM,IAAI,YAAY,CACpB,iBAAiB,UAAU,CAAC,MAAM,CAAC,oCAAoC;gBACrE,GAAG,UAAU,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,EAC1C,UAAU,CACX,CAAC;QACJ,CAAC;QAED,2EAA2E;QAC3E,6EAA6E;QAC7E,8DAA8D;QAC9D,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,mBAAmB,IAAI,IAAI,EAAE,CAAC;YACrD,MAAM,GAAG,GAAG,KAAK,EAAE,CAAC;YACpB,0EAA0E;YAC1E,0EAA0E;YAC1E,8DAA8D;YAC9D,IACE,IAAI,CAAC,OAAO,CAAC,aAAa;gBAC1B,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,IAAI,yBAAyB,EAC7D,CAAC;gBACD,IAAI,CAAC,OAAO,CAAC,aAAa,GAAG,GAAG,CAAC;gBACjC,IAAI,CAAC,OAAO,CAAC,cAAc,GAAG,EAAE,CAAC;YACnC,CAAC;iBAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;gBACvC,IAAI,CAAC,OAAO,CAAC,aAAa,GAAG,GAAG,CAAC;YACnC,CAAC;YACD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,cAAc,GAAG,MAAM,CAAC;YACvD,IAAI,SAAS,GAAG,IAAI,CAAC,mBAAmB,EAAE,CAAC;gBACzC,MAAM,IAAI,YAAY,CACpB,yBAAyB,UAAU,CAAC,SAAS,CAAC,yBAAyB;oBACrE,sBAAsB,UAAU,CAAC,IAAI,CAAC,mBAAmB,CAAC,QAAQ,EACpE,kBAAkB,CACnB,CAAC;YACJ,CAAC;YACD,IAAI,CAAC,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;YACxC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;QAC3B,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAC9B,QAA4B,EAC5B,OAAqC,EACrC,KAAa;IAEb,MAAM,GAAG,GAAmC,EAAE,CAAC;IAC/C,IAAI,OAAO,EAAE,YAAY,EAAE,CAAC;QAC1B,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAC9D,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,MAAM,EAAE,GAA4B,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;QACzE,0EAA0E;QAC1E,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,UAAU;YAAE,EAAE,CAAC,YAAY,GAAG,CAAC,CAAC,UAAU,CAAC;QACtE,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,CAAC;IAED,MAAM,IAAI,GAA4B,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAC9E,IAAI,OAAO,EAAE,SAAS,IAAI,IAAI;QAAE,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC;IACpE,IAAI,OAAO,EAAE,WAAW,IAAI,IAAI;QAAE,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IACzE,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,OAAO,CAAC,CAAU;IACzB,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC7D,CAAC;AAED;;;;GAIG;AACH,SAAS,kBAAkB,CACzB,MAAc;IAEd,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAChE,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IACxE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,GAAa,EACb,cAAsB;IAEtB,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,CAAC;YACH,MAAM,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAC5C,CAAC;QAAC,MAAM,CAAC;YACP,8BAA8B;QAChC,CAAC;QACD,MAAM,IAAI,YAAY,CACpB,yBAAyB,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EACnE,GAAG,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,YAAY,CACvD,CAAC;IACJ,CAAC;IAED,uEAAuE;IACvE,0EAA0E;IAC1E,kCAAkC;IAClC,MAAM,YAAY,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;IAC3D,IAAI,YAAY,EAAE,CAAC;QACjB,MAAM,MAAM,GAAG,kBAAkB,CAAC,YAAY,CAAC,CAAC;QAChD,IAAI,MAAM,IAAI,MAAM,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;YACvC,MAAM,IAAI,YAAY,CACpB,mCAAmC,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,YAAY,IAAI,gBAAgB,EAAE,EAClG,eAAe,CAChB,CAAC;QACJ,CAAC;IACH,CAAC;IAED,IAAI,IAAa,CAAC;IAClB,IAAI,CAAC;QACH,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,YAAY,CACpB,4CAA4C,EAC5C,cAAc,CACf,CAAC;IACJ,CAAC;IAED,MAAM,GAAG,GAAG,CAAC,IAAI,IAAI,EAAE,CAQtB,CAAC;IACF,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC;IACnD,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,MAAM,IAAI,YAAY,CACpB,yDAAyD,EACzD,cAAc,CACf,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC;IAC9B,OAAO;QACL,OAAO;QACP,KAAK,EAAE,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,cAAc;QACjE,QAAQ,EAAE,SAAS;QACnB,KAAK,EAAE;YACL,YAAY,EAAE,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC;YAC1C,gBAAgB,EAAE,OAAO,CAAC,KAAK,CAAC,iBAAiB,CAAC;YAClD,WAAW,EAAE,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC;YACxC,WAAW,EAAE,CAAC;SACf;KACF,CAAC;AACJ,CAAC;AAED,0EAA0E;AAC1E,SAAS,mBAAmB,CAAC,EAAU;IACrC,MAAM,GAAG,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC;IACjD,OAAO,GAAoB,CAAC;AAC9B,CAAC;AAED;;;;GAIG;AACH,KAAK,UAAU,iBAAiB,CAC9B,UAAkB,EAClB,QAAyB;IAEzB,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,MAAM,cAAc,CAAC,eAAe,CAAC,CAAC;QAC3D,MAAM,SAAS,GAAG,MAAM,cAAc,CAAC,aAAa,CAAC,CAAC;QACtD,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,WAAW,CAAC,CAAC;QAElD,MAAM,OAAO,GAAG,YAAY,CAAC,mBAAmB,CAC9C,mBAAmB,CAAC,UAAU,CAAC,CAChC,CAAC;QACF,4EAA4E;QAC5E,6EAA6E;QAC7E,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,QAAQ,CACxD,eAAe,EACf,IAAI,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CACpC,CAAC;QACF,OAAO,SAAS,CAAC,oBAAoB,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAClE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,YAAY,CACpB,wFAAwF;gBACtF,sDAAsD,EACxD,cAAc,CACf,CAAC;QACJ,CAAC;QACD,IAAI,GAAG,YAAY,YAAY;YAAE,MAAM,GAAG,CAAC;QAC3C,MAAM,IAAI,YAAY,CACpB,iDAAiD,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EACnG,oBAAoB,CACrB,CAAC;IACJ,CAAC;AACH,CAAC;AAsBD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAA8B;IAE9B,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAEzD,4EAA4E;IAC5E,8DAA8D;IAC9D,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,YAAY,CACpB,qEAAqE;YACnE,2DAA2D,EAC7D,SAAS,CACV,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,MAAM,EAAE,KAAK,IAAI,qBAAqB,CAAC;IACvE,MAAM,GAAG,GAAG,MAAM,EAAE,OAAO,IAAI,WAAW,CAAC;IAC3C,MAAM,YAAY,GAAG,eAAe,CAClC,MAAM,EAAE,cAAc,IAAI,yBAAyB,CACpD,CAAC;IACF,MAAM,QAAQ,GAAG,mBAAmB,CAAC;QACnC,YAAY;QACZ,KAAK,EAAE,SAAS;QAChB,KAAK,EAAE,mBAAmB,CAAC,MAAM,CAAC,EAAE,6BAA6B;QACjE,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,4EAA4E;QAC5E,6EAA6E;QAC7E,2BAA2B;QAC3B,mBAAmB,EAAE,eAAe,CAClC,MAAM,EAAE,iBAAiB,IAAI,4BAA4B,CAC1D;KACF,CAAC,CAAC;IAEH,MAAM,YAAY,GAChB,MAAM,CAAC,YAAY,IAAI,CAAC,MAAM,iBAAiB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC;IACzE,MAAM,IAAI,GAAG,gBAAgB,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IAExD,IAAI,GAAa,CAAC;IAClB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,YAAY,CAAC,GAAG,EAAE;YAC5B,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;SAC3B,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,YAAY;YAAE,MAAM,GAAG,CAAC,CAAC,qCAAqC;QACjF,yEAAyE;QACzE,sEAAsE;QACtE,kEAAkE;QAClE,MAAM,OAAO,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;QACtC,IAAI,OAAO;YAAE,MAAM,OAAO,CAAC;QAC3B,MAAM,IAAI,YAAY,CACpB,2BAA2B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAC7E,gBAAgB,CACjB,CAAC;IACJ,CAAC;IAED,OAAO,oBAAoB,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;AAC1C,CAAC"}

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"}