@nola-lang/core 0.1.3 → 0.1.5

package/dist/inference-model.d.ts

@@ -0,0 +1,58 @@
+import type { ProviderOutput } from "./index.js";
+/** One infer-function argument as the model sees it — native type TEXT, live value. */
+export interface InferenceScopeArg {
+    name: string;
+    /** InferType.toNativeType(); absent when unannotated/underivable */
+    type?: string;
+    /** true ⇔ the param was `.`-prefixed (value available) */
+    contextual: boolean;
+    /** only when contextual */
+    value?: unknown;
+}
+/** The asking infer function's frame; `parent` is the caller frame's scope. */
+export interface InferenceScope {
+    fn: string;
+    /** display path of the defining .tsi; absent without a file root */
+    file?: string;
+    /** the marker text ("" when none) */
+    instruction: string;
+    args: InferenceScopeArg[];
+    /** rendered marker template — present only when the author wrote one */
+    text?: string;
+    /** true when the template read `.next`: `text` already contains the remainder */
+    coversRemainder?: boolean;
+    parent?: InferenceScope;
+}
+export interface InferenceCorrection {
+    /** the provider's rejected reply */
+    response: string;
+    /** the validation error it failed with */
+    error: string;
+}
+/**
+ * The canonical, pure-JSON description of one ask. Fingerprints, ledgers,
+ * receipts and hook payloads are defined over it; chat messages are a
+ * derived view (`renderClassic`). No closures, no InferType instances.
+ */
+export interface InferenceModel {
+    /** "extract" for an extractor, "call" for the slot-filling ask of a call intent */
+    intent: "extract" | "call";
+    input: {
+        /** the authored backtick text (or the call intent's synthesized request) */
+        instruction: string;
+        /** rendered `${.member}` template for this site — present only when the author wrote one */
+        text?: string;
+        /** call intents only: the callee's name */
+        callee?: string;
+        /** call intents only: the authored hint; absent when the author wrote none */
+        hint?: string;
+    };
+    /** innermost first; absent for a frame-less ask */
+    scope?: InferenceScope;
+    /** the user's config `system.message` — never the built-in preamble */
+    system?: string;
+    output: ProviderOutput;
+    /** present on the correction attempt only; never fingerprint input */
+    correction?: InferenceCorrection;
+}
+//# sourceMappingURL=inference-model.d.ts.map

package/dist/inference-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inference-model.d.ts","sourceRoot":"","sources":["../src/inference-model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,uFAAuF;AACvF,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,UAAU,EAAE,OAAO,CAAC;IACpB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,+EAA+E;AAC/E,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,oEAAoE;IACpE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,iBAAiB,EAAE,CAAC;IAC1B,wEAAwE;IACxE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iFAAiF;IACjF,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB;AAED,MAAM,WAAW,mBAAmB;IAClC,oCAAoC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,mFAAmF;IACnF,MAAM,EAAE,SAAS,GAAG,MAAM,CAAC;IAC3B,KAAK,EAAE;QACL,4EAA4E;QAC5E,WAAW,EAAE,MAAM,CAAC;QACpB,4FAA4F;QAC5F,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,2CAA2C;QAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,8EAA8E;QAC9E,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IACF,mDAAmD;IACnD,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,cAAc,CAAC;IACvB,sEAAsE;IACtE,UAAU,CAAC,EAAE,mBAAmB,CAAC;CAClC"}

package/dist/inference-model.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=inference-model.js.map

package/dist/inference-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inference-model.js","sourceRoot":"","sources":["../src/inference-model.ts"],"names":[],"mappings":""}

package/dist/ingest-line.d.ts

@@ -0,0 +1,27 @@
+import type { NolaIngestEnvelope } from "./nola-protocol.js";
+/** The role → style functions a line is rendered with. Colour never changes the text: strip the escapes and the plain line remains. */
+export interface LinePalette {
+    dim: (s: string) => string;
+    command: (s: string) => string;
+    path: (s: string) => string;
+    ok: (s: string) => string;
+    warn: (s: string) => string;
+    error: (s: string) => string;
+}
+export declare const plainPalette: LinePalette;
+/** The same roles in ANSI colour — what a TTY sees; strip the escapes and `plainPalette`'s line remains. */
+export declare const ansiPalette: LinePalette;
+/** What the console process prints one line for: an ingested envelope, or the UI's "cleared" notice. */
+export type IngestLineNotice = NolaIngestEnvelope | {
+    kind: "cleared";
+    at: number;
+};
+/**
+ * One ingested envelope → one log line, the way tracing tools show spans:
+ * time, kind, then what happened. Ask-level events (start, end, invocation
+ * end) sit at column 0; attempt-level events (request, reply, validation,
+ * retry) indent under their ask. Colour is by role and never changes the
+ * text: strip the escapes and the plain line is what remains.
+ */
+export declare function formatIngestLine(notice: IngestLineNotice, p?: LinePalette): string;
+//# sourceMappingURL=ingest-line.d.ts.map

package/dist/ingest-line.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingest-line.d.ts","sourceRoot":"","sources":["../src/ingest-line.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE7D,uIAAuI;AACvI,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAC3B,OAAO,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAC/B,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAC5B,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAC1B,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAC5B,KAAK,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;CAC9B;AAGD,eAAO,MAAM,YAAY,EAAE,WAA4F,CAAC;AAGxH,4GAA4G;AAC5G,eAAO,MAAM,WAAW,EAAE,WAOxB,CAAC;AAEH,wGAAwG;AACxG,MAAM,MAAM,gBAAgB,GAAG,kBAAkB,GAAG;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAiCpF;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,EAAE,CAAC,GAAE,WAA0B,GAAG,MAAM,CAiDhG"}

package/dist/ingest-line.js

@@ -0,0 +1,85 @@
+const id = (s) => s;
+export const plainPalette = Object.freeze({ dim: id, command: id, path: id, ok: id, warn: id, error: id });
+const sgr = (open, close) => (s) => `\u001b[${open}m${s}\u001b[${close}m`;
+/** The same roles in ANSI colour — what a TTY sees; strip the escapes and `plainPalette`'s line remains. */
+export const ansiPalette = Object.freeze({
+    dim: sgr(2, 22),
+    command: sgr(36, 39),
+    path: sgr(1, 22),
+    ok: sgr(32, 39),
+    warn: sgr(33, 39),
+    error: sgr(31, 39),
+});
+const INSTRUCTION_MAX = 72;
+const KIND_WIDTH = 6;
+const siteText = (site) => (site?.file && site.loc ? `${site.file}:${site.loc}` : "<unknown>");
+const pad2 = (n) => String(n).padStart(2, "0");
+/** Local wall-clock time of the event, `HH:MM:SS.mmm` — the way every tracing tool opens a line. */
+function timeText(at) {
+    const d = new Date(at);
+    return `${pad2(d.getHours())}:${pad2(d.getMinutes())}:${pad2(d.getSeconds())}.${String(d.getMilliseconds()).padStart(3, "0")}`;
+}
+/** One line, whitespace collapsed, cut to INSTRUCTION_MAX characters. */
+function excerpt(text) {
+    const flat = text.replace(/\s+/g, " ").trim();
+    return flat.length > INSTRUCTION_MAX ? `${flat.slice(0, INSTRUCTION_MAX - 1)}…` : flat;
+}
+const attempts = (n) => (n !== undefined && n > 1 ? `, ${n} attempts` : "");
+/**
+ * One ingested envelope → one log line, the way tracing tools show spans:
+ * time, kind, then what happened. Ask-level events (start, end, invocation
+ * end) sit at column 0; attempt-level events (request, reply, validation,
+ * retry) indent under their ask. Colour is by role and never changes the
+ * text: strip the escapes and the plain line is what remains.
+ */
+export function formatIngestLine(notice, p = plainPalette) {
+    const kind = (label, color, nested = false) => nested ? `  ${color(label.padEnd(KIND_WIDTH - 2))}` : color(label.padEnd(KIND_WIDTH));
+    if (notice.kind === "cleared")
+        return `${p.dim(timeText(notice.at))} ${kind("clear", p.warn)} all traces removed`;
+    const envelope = notice;
+    const head = `${p.dim(timeText(envelope.at))}${envelope.project ? ` ${p.dim(envelope.project)}` : ""}`;
+    const event = envelope.event;
+    switch (envelope.kind) {
+        case "askStart": {
+            const e = event;
+            const instruction = e.instruction ? ` — ${excerpt(e.instruction)}` : "";
+            return `${head} ${kind("ask", p.command)} ${p.path(siteText(e.site))} via ${e.provider ?? "?"}${instruction}`;
+        }
+        case "providerRequest": {
+            const e = event;
+            const profile = e.profile ? ` (${e.profile})` : "";
+            return `${head} ${kind("req", p.dim, true)} #${e.attempt ?? "?"} → ${e.provider ?? "?"}${profile}`;
+        }
+        case "providerResponse": {
+            const e = event;
+            return `${head} ${kind("res", p.dim, true)} #${e.attempt ?? "?"} ← ${e.provider ?? "?"} ${e.durationMs ?? "?"}ms`;
+        }
+        case "validationFailed": {
+            const e = event;
+            return `${head} ${kind("warn", p.warn, true)} #${e.attempt ?? "?"} validation failed: ${e.error ?? ""}`;
+        }
+        case "retry": {
+            const e = event;
+            return `${head} ${kind("retry", p.warn, true)} after #${e.attempt ?? "?"}: ${e.reason ?? ""}`;
+        }
+        case "askEnd": {
+            const r = event.receipt;
+            const ok = r?.outcome?.ok !== false;
+            const summary = `${p.path(siteText(r?.site))} via ${r?.servedBy ?? "?"} ${r?.durationMs ?? "?"}ms${attempts(r?.attempts)}`;
+            return ok
+                ? `${head} ${kind("ok", p.ok)} ${summary}`
+                : `${head} ${kind("fail", p.error)} ${summary} — ${r?.outcome?.error ?? "unknown error"}`;
+        }
+        case "invocationStart": {
+            const e = event;
+            return `${head} ${kind("infer", p.command)} ${e.fn ?? "?"}() ${p.dim(e.file ?? "<unknown>")}`;
+        }
+        case "invocationEnd": {
+            const t = event.trace;
+            return `${head} ${kind("done", p.dim)} ${t?.fn ?? "?"}() ${p.dim(t?.file ?? "<unknown>")}`;
+        }
+        default:
+            return `${head} ${kind(envelope.kind, p.dim)}`;
+    }
+}
+//# sourceMappingURL=ingest-line.js.map

package/dist/ingest-line.js.map

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

package/dist/nola-protocol.d.ts

@@ -0,0 +1,195 @@
+import type { ProviderParams } from "./index.js";
+import type { InferenceModel } from "./inference-model.js";
+/**
+ * The hosted API wire contract. Lives in core so the platform (server) side
+ * imports the very same shapes the `nola()` provider and the scaffolder
+ * send; nothing here depends on the runtime or the providers.
+ */
+/** Wire envelope version of POST /v1/infer. */
+export declare const NOLA_PROTOCOL = 1;
+/** Default base URL of the hosted API; `NOLA_API_URL` overrides it in every client. */
+export declare const NOLA_API_URL = "https://api.nola.sh";
+/**
+ * Reply headers on POST /v1/infer. The run counter is sent in every mode (credit is spent first, the
+ * free runs take over when it is gone); `balance` is present only while the account is in paid mode.
+ */
+export declare const NOLA_USAGE_HEADERS: {
+    readonly used: "x-nola-runs-used";
+    readonly limit: "x-nola-runs-limit";
+    readonly balance: "x-nola-balance-micro";
+};
+/** GET /v1/capabilities — every Nola-protocol server self-describes (console design §6). */
+export interface NolaCapabilitiesResponse {
+    protocol: typeof NOLA_PROTOCOL;
+    /** Whether this server serves POST /v1/infer. Absent (legacy servers) is read as true. */
+    infer?: boolean;
+    /** Whether this server accepts POST /v1/ingest trace ingestion. */
+    ingest: boolean;
+    /** Inference profiles this server resolves (defined in the console UI); absent when it resolves none. */
+    profiles?: readonly string[];
+    /** How a CLI signs in against this server; absent when sign-in is not offered (console API off, no CLI client). */
+    auth?: NolaAuthConfig;
+    /** The console origin (`https://platform.nola.sh`) — billing page, account; absent on servers without a console. */
+    consoleUrl?: string;
+}
+/** Envelope version of POST /v1/ingest. */
+export declare const NOLA_INGEST_VERSION = 1;
+/** The eight runtime hook events; kind names are the NolaTelemetry method names minus the `on` prefix. */
+export declare const NOLA_INGEST_KINDS: readonly ["askStart", "providerRequest", "providerResponse", "validationFailed", "retry", "askEnd", "invocationStart", "invocationEnd"];
+export type NolaIngestKind = (typeof NOLA_INGEST_KINDS)[number];
+/**
+ * One POST /v1/ingest body — one hook event, fire-and-forget (console design
+ * §11). `event` is the core hook event exactly as emitted, JSON-serialized
+ * (a `Site` serializes structurally to `{ file, loc }`); consumers narrow by
+ * `kind`. `seq` is a monotonic per-process counter — POSTs arrive out of
+ * order and consumers order by it. `runId` is one UUID minted per process.
+ */
+export interface NolaIngestEnvelope {
+    v: typeof NOLA_INGEST_VERSION;
+    runId: string;
+    pid: number;
+    /** The app's project name (config `project`, defaulting to the nearest package.json `name`). Additive since 2026-09-01. */
+    project?: string;
+    seq: number;
+    /** Date.now() at emit time. */
+    at: number;
+    kind: NolaIngestKind;
+    event: unknown;
+}
+export interface NolaInferRequest {
+    protocol: typeof NOLA_PROTOCOL;
+    /** the client's lockstep package version — the server renders with the matching classic template */
+    version: string;
+    /** ask identity for tracing — present together, exactly when the runtime supplied `ProviderRequest.trace` */
+    askId?: string;
+    invocationId?: string;
+    spanPath?: readonly string[];
+    /** the ask itself — the canonical InferenceModel */
+    intent: InferenceModel;
+    /** upstream model selector, "<provider>/<model>" — absent ⇒ the server chooses (trial keys are restricted server-side) */
+    model?: string;
+    /**
+     * Free-form inference profile — the `ask with <name>` name under managed
+     * mode (`model: nola.infer()`). The platform's smart routing resolves it to a
+     * model and params; unknown to the client by design. Additive since
+     * 2026-08-30.
+     */
+    profile?: string;
+    /** The app's project name — deployment metadata for per-project display/metering. Additive since 2026-09-01. */
+    project?: string;
+    params?: ProviderParams;
+}
+export interface NolaInferResponse {
+    /** the model's raw reply; the runtime parses, validates and corrects it like any provider's */
+    text: string;
+    durationMs?: number;
+}
+/** Every non-2xx body. `details` is a JSON object; `quota_exceeded` carries `{ runsUsed, runsLimit }`. */
+export interface NolaErrorResponse {
+    error: {
+        code: string;
+        message: string;
+        details?: Record<string, unknown>;
+    };
+}
+export type NolaAccountKind = "anonymous" | "user";
+/**
+ * POST /v1/trial — no auth, no body fields (the client sends `{}`; nothing
+ * on the machine identifies it to the server). 201 with a fresh anonymous
+ * account and its one key; the raw key appears here exactly once. One per
+ * machine as far as the CLI is concerned — every later key needs a signed-in
+ * user (spec 2026-09-04-cli-sign-in-design.md).
+ */
+export interface NolaTrialResponse {
+    apiKey: string;
+    account: {
+        id: string;
+        kind: NolaAccountKind;
+    };
+    trial: {
+        runs: number;
+    };
+}
+/** The `/authorize` query parameter the CLI uses to hand its recorded trial account id to the tenant's post-login Action. */
+export declare const NOLA_ACCOUNT_PARAM = "ext-nola_account";
+/** The access-token claim the Action writes from that parameter; the API claims the account from it (platform spec 2026-09-07). */
+export declare const NOLA_ACCOUNT_CLAIM = "nola:account_id";
+/** Where a CLI signs in (from GET /v1/capabilities): the Auth0 tenant as `https://<domain>`, the CLI's public client id, the API audience. */
+export interface NolaAuthConfig {
+    issuer: string;
+    clientId: string;
+    audience: string;
+    /**
+     * Loopback ports registered on the tenant as `http://127.0.0.1:<port>/callback` for the
+     * Authorization Code + PKCE flow; the CLI binds the first free one. Absent or empty means
+     * this server cannot sign a CLI in.
+     */
+    redirectPorts?: readonly number[];
+}
+/** POST /v1/console/keys — 201 (Auth0 bearer). The raw key appears here exactly once. */
+export interface NolaConsoleCreatedKeyResponse {
+    id: string;
+    name: string | null;
+    prefix: string;
+    suffix: string | null;
+    apiKey: string;
+}
+/** GET /v1/console/me — the signed-in user and their personal account (Auth0 bearer). */
+export interface NolaConsoleMeResponse {
+    user: {
+        id: string;
+        email: string | null;
+        name: string | null;
+        avatarUrl: string | null;
+    };
+    account: {
+        id: string;
+        kind: NolaAccountKind;
+        status: "active" | "suspended";
+        mode: "trial" | "paid";
+        trial: {
+            runsUsed: number;
+            runsLimit: number;
+        };
+        balanceMicro: number;
+        spendThisMonthMicro: number;
+        liveKeyCount: number;
+    };
+}
+/** POST /v1/console/sessions/:id/claim — links a project key's account (a `POST /v1/billing/session` session) to the signed-in user (Auth0 bearer). */
+export interface NolaClaimResponse {
+    outcome: "claimed" | "merged" | "already_owned";
+    accountId: string;
+}
+/** GET /v1/account — Bearer auth. */
+export interface NolaAccountResponse {
+    id: string;
+    kind: NolaAccountKind;
+    status: "active" | "suspended";
+    trial: {
+        runsUsed: number;
+        runsLimit: number;
+    };
+    /** prepaid credits, in millionths of a US dollar */
+    balance: {
+        microUsd: number;
+    };
+    /** The model hosted runs use and its retail price (micro-USD per million tokens) — what `nola account` prints. */
+    model: NolaHostedModel;
+}
+/** The single hosted model (phase 1): a short display name and its price, both decided by the server. */
+export interface NolaHostedModel {
+    /** e.g. "gpt-oss-120b" */
+    name: string;
+    pricing: {
+        inputMicroPerMTok: number;
+        outputMicroPerMTok: number;
+    };
+}
+/** POST /v1/billing/session — Bearer auth, empty JSON body. The URL carries only a session id, never the key. */
+export interface NolaBillingSessionResponse {
+    url: string;
+    /** ISO-8601 */
+    expiresAt: string;
+}
+//# sourceMappingURL=nola-protocol.d.ts.map

package/dist/nola-protocol.d.ts.map

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

package/dist/nola-protocol.js

@@ -0,0 +1,32 @@
+/**
+ * The hosted API wire contract. Lives in core so the platform (server) side
+ * imports the very same shapes the `nola()` provider and the scaffolder
+ * send; nothing here depends on the runtime or the providers.
+ */
+/** Wire envelope version of POST /v1/infer. */
+export const NOLA_PROTOCOL = 1;
+/** Default base URL of the hosted API; `NOLA_API_URL` overrides it in every client. */
+export const NOLA_API_URL = "https://api.nola.sh";
+/**
+ * Reply headers on POST /v1/infer. The run counter is sent in every mode (credit is spent first, the
+ * free runs take over when it is gone); `balance` is present only while the account is in paid mode.
+ */
+export const NOLA_USAGE_HEADERS = { used: "x-nola-runs-used", limit: "x-nola-runs-limit", balance: "x-nola-balance-micro" };
+/** Envelope version of POST /v1/ingest. */
+export const NOLA_INGEST_VERSION = 1;
+/** The eight runtime hook events; kind names are the NolaTelemetry method names minus the `on` prefix. */
+export const NOLA_INGEST_KINDS = [
+    "askStart",
+    "providerRequest",
+    "providerResponse",
+    "validationFailed",
+    "retry",
+    "askEnd",
+    "invocationStart",
+    "invocationEnd",
+];
+/** The `/authorize` query parameter the CLI uses to hand its recorded trial account id to the tenant's post-login Action. */
+export const NOLA_ACCOUNT_PARAM = "ext-nola_account";
+/** The access-token claim the Action writes from that parameter; the API claims the account from it (platform spec 2026-09-07). */
+export const NOLA_ACCOUNT_CLAIM = "nola:account_id";
+//# sourceMappingURL=nola-protocol.js.map

package/dist/nola-protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nola-protocol.js","sourceRoot":"","sources":["../src/nola-protocol.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AAEH,+CAA+C;AAC/C,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC;AAE/B,uFAAuF;AACvF,MAAM,CAAC,MAAM,YAAY,GAAG,qBAAqB,CAAC;AAElD;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,IAAI,EAAE,kBAAkB,EAAE,KAAK,EAAE,mBAAmB,EAAE,OAAO,EAAE,sBAAsB,EAAW,CAAC;AAiBrI,2CAA2C;AAC3C,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAErC,0GAA0G;AAC1G,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,UAAU;IACV,iBAAiB;IACjB,kBAAkB;IAClB,kBAAkB;IAClB,OAAO;IACP,QAAQ;IACR,iBAAiB;IACjB,eAAe;CACP,CAAC;AA0EX,6HAA6H;AAC7H,MAAM,CAAC,MAAM,kBAAkB,GAAG,kBAAkB,CAAC;AACrD,mIAAmI;AACnI,MAAM,CAAC,MAAM,kBAAkB,GAAG,iBAAiB,CAAC"}

package/dist/platform-model.d.ts

@@ -0,0 +1,28 @@
+import type { AskTrace, ProviderParams, ProviderResponse } from "./index.js";
+import type { InferenceModel } from "./inference-model.js";
+/**
+ * The platform-served model (platform-config design 2026-09-03). It is the
+ * ONLY `infer`-dialect model: the runtime hands it the canonical
+ * InferenceModel, every other model receives the classic rendering through
+ * `complete`. The brand (not the method) is the detection gate, so a user
+ * object that happens to have an `infer` method is still a config error.
+ */
+export declare const PLATFORM_MODEL: unique symbol;
+/** The request a platform model consumes: the canonical model, never a rendering. */
+export interface InferRequest {
+    model: InferenceModel;
+    params?: ProviderParams;
+    signal?: AbortSignal;
+    trace?: AskTrace;
+    /** Free-form inference profile (`ask with <name>` under a platform default). Part of the ask fingerprint. */
+    profile?: string;
+    /** The app's project name — deployment metadata for the server, NEVER part of the ask fingerprint. */
+    project?: string;
+}
+export interface PlatformModel {
+    readonly name: string;
+    infer(req: InferRequest): Promise<ProviderResponse>;
+    readonly [PLATFORM_MODEL]: true;
+}
+export declare function isPlatformModel(value: unknown): value is PlatformModel;
+//# sourceMappingURL=platform-model.d.ts.map

package/dist/platform-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-model.d.ts","sourceRoot":"","sources":["../src/platform-model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC7E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,EAAE,OAAO,MAAyC,CAAC;AAE9E,qFAAqF;AACrF,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,cAAc,CAAC;IACtB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,6GAA6G;IAC7G,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sGAAsG;IACtG,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACpD,QAAQ,CAAC,CAAC,cAAc,CAAC,EAAE,IAAI,CAAC;CACjC;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAOtE"}

package/dist/platform-model.js

@@ -0,0 +1,15 @@
+/**
+ * The platform-served model (platform-config design 2026-09-03). It is the
+ * ONLY `infer`-dialect model: the runtime hands it the canonical
+ * InferenceModel, every other model receives the classic rendering through
+ * `complete`. The brand (not the method) is the detection gate, so a user
+ * object that happens to have an `infer` method is still a config error.
+ */
+export const PLATFORM_MODEL = Symbol.for("nola.platformModel");
+export function isPlatformModel(value) {
+    return (!!value &&
+        typeof value === "object" &&
+        value[PLATFORM_MODEL] === true &&
+        typeof value.infer === "function");
+}
+//# sourceMappingURL=platform-model.js.map

package/dist/platform-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-model.js","sourceRoot":"","sources":["../src/platform-model.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,cAAc,GAAkB,MAAM,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;AAoB9E,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,CACL,CAAC,CAAC,KAAK;QACP,OAAO,KAAK,KAAK,QAAQ;QACxB,KAAwC,CAAC,cAAc,CAAC,KAAK,IAAI;QAClE,OAAQ,KAA6B,CAAC,KAAK,KAAK,UAAU,CAC3D,CAAC;AACJ,CAAC"}

package/dist/provider-dialect.d.ts

@@ -0,0 +1,13 @@
+import type { InferenceModel } from "./inference-model.js";
+import type { ClassicPrompt } from "./render-classic.js";
+/**
+ * Payload union for hook events and the fingerprint: the canonical model
+ * for a managed ask, its classic rendering for everyone else. Requests no
+ * longer carry the union (reshape design 2026-09-01) — the method name is
+ * the dialect: `infer` takes `InferRequest { model }`, `complete` takes
+ * `ProviderRequest { payload: ClassicPrompt }`.
+ */
+export type ProviderPayload = ClassicPrompt | InferenceModel;
+/** Structural discriminator between the two payload shapes (a ClassicPrompt has no `intent`). */
+export declare function isInferenceModel(payload: ProviderPayload): payload is InferenceModel;
+//# sourceMappingURL=provider-dialect.d.ts.map

package/dist/provider-dialect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-dialect.d.ts","sourceRoot":"","sources":["../src/provider-dialect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GAAG,aAAa,GAAG,cAAc,CAAC;AAE7D,iGAAiG;AACjG,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,IAAI,cAAc,CAEpF"}

package/dist/provider-dialect.js

@@ -0,0 +1,5 @@
+/** Structural discriminator between the two payload shapes (a ClassicPrompt has no `intent`). */
+export function isInferenceModel(payload) {
+    return "intent" in payload;
+}
+//# sourceMappingURL=provider-dialect.js.map

package/dist/provider-dialect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-dialect.js","sourceRoot":"","sources":["../src/provider-dialect.ts"],"names":[],"mappings":"AAYA,iGAAiG;AACjG,MAAM,UAAU,gBAAgB,CAAC,OAAwB;IACvD,OAAO,QAAQ,IAAI,OAAO,CAAC;AAC7B,CAAC"}

package/dist/redact.d.ts

@@ -2,4 +2,6 @@
 export declare function redactSecrets(text: string): string;
 /** Render any thrown value as a redacted single-line string. */
 export declare function redactError(error: unknown): string;
+/** redactSecrets over every string inside a JSON-shaped value; structure and non-strings untouched. */
+export declare function redactDeep<T>(value: T): T;
 //# sourceMappingURL=redact.d.ts.map

package/dist/redact.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"redact.d.ts","sourceRoot":"","sources":["../src/redact.ts"],"names":[],"mappings":"AAUA,uEAAuE;AACvE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAUlD;AAED,gEAAgE;AAChE,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAElD"}
+{"version":3,"file":"redact.d.ts","sourceRoot":"","sources":["../src/redact.ts"],"names":[],"mappings":"AAWA,uEAAuE;AACvE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAUlD;AAED,gEAAgE;AAChE,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAElD;AAED,uGAAuG;AACvG,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CASzC"}

package/dist/redact.js

@@ -2,6 +2,7 @@
 // runtime re-throws them into user stacks and persists them into receipts.
 const PATTERNS = [
     /\b(?:sk|rk|pk)-[A-Za-z0-9_-]{8,}/g, // OpenAI-family keys
+    /\bnola_sk_[A-Za-z0-9]{8,}/g, // Nola API keys
     /\bAIza[0-9A-Za-z_-]{10,}/g, // Google API keys
     /\b(?:Bearer|Basic)\s+[A-Za-z0-9._~+/=-]{8,}/gi, // Authorization values
     /\b[0-9a-f]{32,}\b/gi, // long hex blobs (key fingerprints)
@@ -22,4 +23,18 @@ export function redactSecrets(text) {
 export function redactError(error) {
     return redactSecrets(error instanceof Error ? error.message : String(error));
 }
+/** redactSecrets over every string inside a JSON-shaped value; structure and non-strings untouched. */
+export function redactDeep(value) {
+    if (typeof value === "string")
+        return redactSecrets(value);
+    if (Array.isArray(value))
+        return value.map(redactDeep);
+    if (value !== null && typeof value === "object") {
+        const out = {};
+        for (const [k, v] of Object.entries(value))
+            out[k] = redactDeep(v);
+        return out;
+    }
+    return value;
+}
 //# sourceMappingURL=redact.js.map

package/dist/redact.js.map

@@ -1 +1 @@
-{"version":3,"file":"redact.js","sourceRoot":"","sources":["../src/redact.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,2EAA2E;AAE3E,MAAM,QAAQ,GAAsB;IAClC,mCAAmC,EAAE,qBAAqB;IAC1D,2BAA2B,EAAE,kBAAkB;IAC/C,+CAA+C,EAAE,uBAAuB;IACxE,qBAAqB,EAAE,oCAAoC;CAC5D,CAAC;AAEF,uEAAuE;AACvE,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,IAAI,GAAG,GAAG,IAAI,CAAC;IACf,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YACnC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACjC,iEAAiE;YACjE,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;QAC7E,CAAC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,OAAO,aAAa,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;AAC/E,CAAC"}
+{"version":3,"file":"redact.js","sourceRoot":"","sources":["../src/redact.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,2EAA2E;AAE3E,MAAM,QAAQ,GAAsB;IAClC,mCAAmC,EAAE,qBAAqB;IAC1D,4BAA4B,EAAE,gBAAgB;IAC9C,2BAA2B,EAAE,kBAAkB;IAC/C,+CAA+C,EAAE,uBAAuB;IACxE,qBAAqB,EAAE,oCAAoC;CAC5D,CAAC;AAEF,uEAAuE;AACvE,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,IAAI,GAAG,GAAG,IAAI,CAAC;IACf,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YACnC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACjC,iEAAiE;YACjE,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;QAC7E,CAAC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,OAAO,aAAa,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;AAC/E,CAAC;AAED,uGAAuG;AACvG,MAAM,UAAU,UAAU,CAAI,KAAQ;IACpC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,aAAa,CAAC,KAAK,CAAM,CAAC;IAChE,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,UAAU,CAAM,CAAC;IAC5D,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,MAAM,GAAG,GAA4B,EAAE,CAAC;QACxC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC;YAAE,GAAG,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;QAC9F,OAAO,GAAQ,CAAC;IAClB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/render-classic.d.ts

@@ -0,0 +1,40 @@
+import type { JsonSchema, Message, ProviderOutput } from "./index.js";
+import type { InferenceModel, InferenceScope } from "./inference-model.js";
+export declare const SYSTEM_PREAMBLE: string;
+/** What a classic (chat-dialect) provider sends: system text, conversation, output contract. */
+export interface ClassicPrompt {
+    system: string;
+    messages: Message[];
+    output: ProviderOutput;
+}
+/** The correction turn's user message after a failed attempt. */
+export declare function CORRECTION_PROMPT(error: string): string;
+/** Whether a wire schema is a bare string with no hints worth showing the model. */
+export declare function isTrivialStringSchema(schema: JsonSchema): boolean;
+/** Joins prompt blocks with the blank-line separator, skipping empty ones. */
+export declare function joinBlocks(...parts: string[]): string;
+/** The schema the reply must satisfy — free text and non-JSON syntaxes read as a bare string. */
+export declare function outputSchema(output: ProviderOutput): JsonSchema;
+/** Outer→inner list of the model's scopes (root caller first, asking frame last). */
+export declare function scopeChain(model: Pick<InferenceModel, "scope">): InferenceScope[];
+/**
+ * One CONTEXT block: signature + source file, the authored instruction as
+ * Purpose, and the argument list — plain (non-contextual) params appear by
+ * name with an explicit unknown marker so the model never invents a value;
+ * contextual values stay JSON-quoted except long/multiline strings, which
+ * read as real text in a tagged block.
+ */
+export declare function renderScopeBlock(scope: Pick<InferenceScope, "fn" | "file" | "instruction" | "args">, nested: boolean): string;
+/** The response-discipline tail of the TASK block — the lines the JSON parser contract relies on. */
+export declare function renderTaskFormat(schema: JsonSchema): string;
+/** The built-in TASK block: the instruction verbatim inside <request>, then the format lines. */
+export declare function renderTaskBlock(model: Pick<InferenceModel, "input" | "output">, hasContext: boolean): string;
+/**
+ * The user-message text from scope depth `from` (outer→inner) to the TASK:
+ * a node's `text` override replaces its block, a scope whose override covers
+ * the remainder ends the walk.
+ */
+export declare function renderClassicText(model: InferenceModel, from?: number): string;
+/** The classic chat rendering of a model — deterministic; what every chat-dialect provider sends. */
+export declare function renderClassic(model: InferenceModel): ClassicPrompt;
+//# sourceMappingURL=render-classic.d.ts.map

package/dist/render-classic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-classic.d.ts","sourceRoot":"","sources":["../src/render-classic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3E,eAAO,MAAM,eAAe,QAGkE,CAAC;AAE/F,gGAAgG;AAChG,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,MAAM,EAAE,cAAc,CAAC;CACxB;AAED,iEAAiE;AACjE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,oFAAoF;AACpF,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAEjE;AAED,8EAA8E;AAC9E,wBAAgB,UAAU,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAErD;AAED,iGAAiG;AACjG,wBAAgB,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,UAAU,CAE/D;AAED,qFAAqF;AACrF,wBAAgB,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,cAAc,EAAE,OAAO,CAAC,GAAG,cAAc,EAAE,CAIjF;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,IAAI,CAAC,cAAc,EAAE,IAAI,GAAG,MAAM,GAAG,aAAa,GAAG,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,CAwB7H;AAED,qGAAqG;AACrG,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAM3D;AAED,iGAAiG;AACjG,wBAAgB,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC,cAAc,EAAE,OAAO,GAAG,QAAQ,CAAC,EAAE,UAAU,EAAE,OAAO,GAAG,MAAM,CAS5G;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,cAAc,EAAE,IAAI,SAAI,GAAG,MAAM,CAczE;AAED,qGAAqG;AACrG,wBAAgB,aAAa,CAAC,KAAK,EAAE,cAAc,GAAG,aAAa,CAWlE"}