@nathapp/nax-ai 0.1.0

package/dist/protocols/errors.d.ts

@@ -0,0 +1,30 @@
+/**
+ * HTTP-shaped error classification.
+ *
+ * Kept as pure functions, separate from any call path, for the same reason
+ * `usage.ts` is: a hand-written backend classifies the same statuses from a
+ * different source and should not carry a second copy of this table.
+ */
+import type { ProtocolError, ProtocolErrorKind } from "./types.ts";
+export declare function classifyHttpError(status: number | undefined): ProtocolErrorKind;
+/**
+ * Reads `retry-after` as a delay in seconds.
+ *
+ * The header may also carry an HTTP-date. That form is deliberately not
+ * converted: the conversion depends on clock skew between us and the provider,
+ * and a wrong number here would be worse than an absent one, because the
+ * consumer owns the retry loop and would sleep on it.
+ */
+export declare function parseRetryAfter(headers: Readonly<Record<string, string>> | undefined): number | undefined;
+/**
+ * Normalises an arbitrary thrown value (connection reset, DNS failure, an
+ * immediate socket error) into a `ProtocolError`.
+ *
+ * Always classified as "transport": `classifyHttpError(undefined)` would
+ * return "unknown", but a throw with no HTTP response is exactly the class
+ * of fault §10.1 assigns to nax-ai's own bounded retry, not the consumer's
+ * rate-limit/overload policy. `cause` is preserved so the original value is
+ * never lost.
+ */
+export declare function classifyThrown(cause: unknown): ProtocolError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/protocols/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/protocols/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEnE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,iBAAiB,CAQ/E;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CASzG;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,CAM5D"}

package/dist/protocols/errors.js

@@ -0,0 +1,59 @@
+/**
+ * HTTP-shaped error classification.
+ *
+ * Kept as pure functions, separate from any call path, for the same reason
+ * `usage.ts` is: a hand-written backend classifies the same statuses from a
+ * different source and should not carry a second copy of this table.
+ */
+export function classifyHttpError(status) {
+    if (status === undefined)
+        return "unknown";
+    if (status === 401 || status === 403)
+        return "auth";
+    if (status === 429)
+        return "rate-limit";
+    if (status === 529 || status === 503)
+        return "overloaded";
+    if (status >= 400 && status < 500)
+        return "bad-request";
+    if (status >= 500)
+        return "transport";
+    return "unknown";
+}
+/**
+ * Reads `retry-after` as a delay in seconds.
+ *
+ * The header may also carry an HTTP-date. That form is deliberately not
+ * converted: the conversion depends on clock skew between us and the provider,
+ * and a wrong number here would be worse than an absent one, because the
+ * consumer owns the retry loop and would sleep on it.
+ */
+export function parseRetryAfter(headers) {
+    if (headers === undefined)
+        return undefined;
+    const entry = Object.entries(headers).find(([name]) => name.toLowerCase() === "retry-after");
+    if (entry === undefined)
+        return undefined;
+    const seconds = Number(entry[1]);
+    if (!Number.isFinite(seconds) || seconds < 0)
+        return undefined;
+    return seconds;
+}
+/**
+ * Normalises an arbitrary thrown value (connection reset, DNS failure, an
+ * immediate socket error) into a `ProtocolError`.
+ *
+ * Always classified as "transport": `classifyHttpError(undefined)` would
+ * return "unknown", but a throw with no HTTP response is exactly the class
+ * of fault §10.1 assigns to nax-ai's own bounded retry, not the consumer's
+ * rate-limit/overload policy. `cause` is preserved so the original value is
+ * never lost.
+ */
+export function classifyThrown(cause) {
+    return {
+        kind: "transport",
+        message: cause instanceof Error ? cause.message : String(cause),
+        cause,
+    };
+}
+//# sourceMappingURL=errors.js.map

package/dist/protocols/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/protocols/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,UAAU,iBAAiB,CAAC,MAA0B;IAC1D,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC3C,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,MAAM,CAAC;IACpD,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,YAAY,CAAC;IACxC,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,YAAY,CAAC;IAC1D,IAAI,MAAM,IAAI,GAAG,IAAI,MAAM,GAAG,GAAG;QAAE,OAAO,aAAa,CAAC;IACxD,IAAI,MAAM,IAAI,GAAG;QAAE,OAAO,WAAW,CAAC;IACtC,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,OAAqD;IACnF,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAE5C,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,aAAa,CAAC,CAAC;IAC7F,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAE1C,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACjC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAC/D,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;QAC/D,KAAK;KACN,CAAC;AACJ,CAAC"}

package/dist/protocols/pi-client.d.ts

@@ -0,0 +1,36 @@
+/**
+ * The pi-ai-backed protocol.
+ *
+ * This file and the two other files on the ALLOWED list in
+ * scripts/check-pi-ai-imports.ts are the only places pi-ai may be imported.
+ * Nothing exported here may expose a pi-ai type in a shape a consumer sees.
+ *
+ * One implementation serves all four protocols. They differ only in where a
+ * system prompt sits in the wire request, and pi-ai's Context carries it in a
+ * dedicated field, so on this path the difference does not exist. The protocol
+ * name is still a parameter because a per-api quirk would branch on it.
+ */
+import type { Api, AssistantMessageEvent, Context, Model, SimpleStreamOptions } from "@earendil-works/pi-ai";
+import type { PiProtocolOptions } from "./pi-protocols.ts";
+import type { Protocol, ProtocolRequest } from "./types.ts";
+export interface PiResponse {
+    readonly status: number;
+    readonly headers: Readonly<Record<string, string>>;
+}
+export type PiStreamFn = (model: Model<Api>, context: Context, options: SimpleStreamOptions, 
+/**
+ * Called once, before the body is consumed. pi-ai's error event carries no
+ * status and no retry-after, so without this the classifier would return
+ * "unknown" for every failure and the consumer's retry policy — which M1
+ * section 10.1 deliberately assigns to the consumer — would be blind.
+ */
+onResponse: (response: PiResponse) => void) => AsyncIterable<AssistantMessageEvent>;
+export interface PiDeps {
+    readonly resolveModel: (modelId: string, provider?: string) => Promise<Model<Api>>;
+    readonly stream: PiStreamFn;
+}
+export declare function toPiContext(req: ProtocolRequest, model: Model<Api>): Context;
+export declare function toPiOptions(req: ProtocolRequest): SimpleStreamOptions;
+export declare function createPiProtocol(name: string, deps: PiDeps): Protocol;
+export declare function createPiDeps(options?: PiProtocolOptions): PiDeps;
+//# sourceMappingURL=pi-client.d.ts.map

package/dist/protocols/pi-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi-client.d.ts","sourceRoot":"","sources":["../../src/protocols/pi-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EACV,GAAG,EACH,qBAAqB,EACrB,OAAO,EACP,KAAK,EAKL,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAM/B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,OAAO,KAAK,EAAuB,QAAQ,EAAiB,eAAe,EAAiB,MAAM,YAAY,CAAC;AAE/G,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACpD;AAED,MAAM,MAAM,UAAU,GAAG,CACvB,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,EACjB,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,mBAAmB;AAC5B;;;;;GAKG;AACH,UAAU,EAAE,CAAC,QAAQ,EAAE,UAAU,KAAK,IAAI,KACvC,aAAa,CAAC,qBAAqB,CAAC,CAAC;AAE1C,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,YAAY,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IACnF,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;CAC7B;AA6GD,wBAAgB,WAAW,CAAC,GAAG,EAAE,eAAe,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,OAAO,CAM5E;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,eAAe,GAAG,mBAAmB,CAWrE;AAkDD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,QAAQ,CA+HrE;AAYD,wBAAgB,YAAY,CAAC,OAAO,GAAE,iBAAsB,GAAG,MAAM,CA6CpE"}

package/dist/protocols/pi-client.js

@@ -0,0 +1,348 @@
+/**
+ * The pi-ai-backed protocol.
+ *
+ * This file and the two other files on the ALLOWED list in
+ * scripts/check-pi-ai-imports.ts are the only places pi-ai may be imported.
+ * Nothing exported here may expose a pi-ai type in a shape a consumer sees.
+ *
+ * One implementation serves all four protocols. They differ only in where a
+ * system prompt sits in the wire request, and pi-ai's Context carries it in a
+ * dedicated field, so on this path the difference does not exist. The protocol
+ * name is still a parameter because a per-api quirk would branch on it.
+ */
+import { builtinModels } from "@earendil-works/pi-ai/providers/all";
+import { createPiAuthResolver, toPiCredentialStore } from "../auth/pi-auth.js";
+import { toTokenUsage, totalTokens } from "../usage.js";
+import { classifyHttpError, classifyThrown, parseRetryAfter } from "./errors.js";
+import { createToolArgAccumulator, parseToolArgs } from "./tool-args.js";
+/**
+ * pi-ai's Message requires a timestamp, but no wire module under its api/
+ * directory reads one. A constant keeps translation deterministic; Date.now()
+ * would make tests flap over a field that is never sent.
+ */
+const NO_TIMESTAMP = 0;
+/** Placeholder accounting for a replayed assistant turn. Never sent upstream. */
+const NO_USAGE = {
+    input: 0,
+    output: 0,
+    cacheRead: 0,
+    cacheWrite: 0,
+    totalTokens: 0,
+    cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },
+};
+function toPiTool(tool) {
+    return {
+        name: tool.name,
+        description: tool.description,
+        // pi-ai types this as a TypeBox TSchema, which is a JSON Schema object at
+        // runtime. nax-ai does not validate schemas; it forwards what it was given.
+        parameters: tool.inputSchema,
+    };
+}
+/**
+ * pi's ThinkingContent, from our ThinkingBlock. `thinkingSignature` is left
+ * unset rather than "" when absent, because pi's own request-side handling
+ * (dist/api/anthropic-messages.js:923-957) treats "no signature" and "empty
+ * signature" differently — a synthesised "" would pick the wrong branch.
+ */
+function toPiThinking(block) {
+    return {
+        type: "thinking",
+        thinking: block.text,
+        ...(block.signature !== undefined ? { thinkingSignature: block.signature } : {}),
+        ...(block.redacted !== undefined ? { redacted: block.redacted } : {}),
+    };
+}
+function toPiMessages(messages, model) {
+    const toolNames = new Map();
+    const out = [];
+    for (const message of messages) {
+        if (message.role === "user") {
+            out.push({ role: "user", content: message.content, timestamp: NO_TIMESTAMP });
+            continue;
+        }
+        if (message.role === "assistant") {
+            for (const call of message.toolCalls ?? [])
+                toolNames.set(call.id, call.name);
+            out.push({
+                role: "assistant",
+                content: [
+                    // Anthropic requires thinking blocks to lead the assistant
+                    // message when present — this is a wire ordering requirement, not
+                    // a style choice, so it goes first unconditionally.
+                    ...(message.thinking ?? []).map(toPiThinking),
+                    ...(message.content === "" ? [] : [{ type: "text", text: message.content }]),
+                    ...(message.toolCalls ?? []).map((call) => ({
+                        type: "toolCall",
+                        id: call.id,
+                        name: call.name,
+                        arguments: (call.input ?? {}),
+                    })),
+                ],
+                api: model.api,
+                provider: model.provider,
+                model: model.id,
+                usage: NO_USAGE,
+                stopReason: "stop",
+                timestamp: NO_TIMESTAMP,
+            });
+            continue;
+        }
+        // toolName is not on our ConversationMessage but is read on the wire by
+        // several providers, so it is recovered from the call that produced this
+        // result. No match means the caller assembled an impossible conversation.
+        const toolName = toolNames.get(message.toolCallId);
+        if (toolName === undefined) {
+            throw new Error(`Tool result references tool call "${message.toolCallId}", which no earlier assistant message made.`);
+        }
+        out.push({
+            role: "toolResult",
+            toolCallId: message.toolCallId,
+            toolName,
+            content: [{ type: "text", text: message.content }],
+            isError: message.isError ?? false,
+            timestamp: NO_TIMESTAMP,
+        });
+    }
+    return out;
+}
+export function toPiContext(req, model) {
+    return {
+        ...(req.system !== undefined ? { systemPrompt: req.system } : {}),
+        messages: toPiMessages(req.messages, model),
+        ...(req.tools !== undefined ? { tools: req.tools.map(toPiTool) } : {}),
+    };
+}
+export function toPiOptions(req) {
+    return {
+        ...(req.toolChoice !== undefined ? { toolChoice: req.toolChoice } : {}),
+        ...(req.maxTokens !== undefined ? { maxTokens: req.maxTokens } : {}),
+        ...(req.temperature !== undefined ? { temperature: req.temperature } : {}),
+        ...(req.cacheRetention !== undefined ? { cacheRetention: req.cacheRetention } : {}),
+        ...(req.signal !== undefined ? { signal: req.signal } : {}),
+        // pi-ai's scale has no "off": the absence of the field is how thinking is
+        // disabled, so mapping "off" to a value would silently enable it.
+        ...(req.thinking !== undefined && req.thinking !== "off" ? { reasoning: req.thinking } : {}),
+    };
+}
+/**
+ * pi-ai's terminal reasons, narrowed to ours.
+ *
+ * "deferred" is absent by design: we never request a deferred response, so
+ * receiving one means an assumption broke and it must surface rather than be
+ * folded into "stop". "content_filter" has no pi-ai equivalent and is
+ * unreachable here; it exists for a hand-written backend.
+ */
+const STOP_REASONS = {
+    stop: "stop",
+    length: "length",
+    toolUse: "tool_use",
+};
+/** The in-progress tool call at a content index, when there is one. */
+function toolCallAt(partial, index) {
+    const block = partial.content[index];
+    if (typeof block !== "object" || block === null)
+        return undefined;
+    const candidate = block;
+    if (candidate.type !== "toolCall" || typeof candidate.id !== "string" || typeof candidate.name !== "string") {
+        return undefined;
+    }
+    return { id: candidate.id, name: candidate.name };
+}
+/**
+ * The signature and redacted flag for the thinking block at a content index,
+ * when the block at that index has that shape. `thinking_end`'s own event
+ * carries no signature — pi accumulates it onto the block in `partial`
+ * during the stream (signature_delta, dist/api/anthropic-messages.js:501-502)
+ * so by the time the block ends it is complete there. Same trap as
+ * `toolCallAt` above: the terminal event is missing fields only the partial
+ * carries.
+ */
+function thinkingBlockAt(partial, index) {
+    const block = partial.content[index];
+    if (typeof block !== "object" || block === null)
+        return {};
+    const candidate = block;
+    if (candidate.type !== "thinking")
+        return {};
+    return {
+        ...(typeof candidate.thinkingSignature === "string" ? { signature: candidate.thinkingSignature } : {}),
+        ...(typeof candidate.redacted === "boolean" ? { redacted: candidate.redacted } : {}),
+    };
+}
+export function createPiProtocol(name, deps) {
+    return {
+        name,
+        async *stream(req) {
+            const model = await deps.resolveModel(req.model, req.provider);
+            let observed;
+            const events = deps.stream(model, toPiContext(req, model), toPiOptions(req), (response) => {
+                observed = response;
+            });
+            const toolArgs = createToolArgAccumulator();
+            try {
+                for await (const event of events) {
+                    switch (event.type) {
+                        case "text_delta":
+                            yield { type: "text-delta", text: event.delta };
+                            break;
+                        case "thinking_delta":
+                            yield { type: "thinking-delta", text: event.delta };
+                            break;
+                        case "thinking_end": {
+                            // Losing thinking text is worse than losing a signature: even
+                            // when the block at this content index is not the shape we
+                            // expect, still emit the text `thinking_end` itself carries.
+                            const { signature, redacted } = thinkingBlockAt(event.partial, event.contentIndex);
+                            yield {
+                                type: "thinking",
+                                block: {
+                                    text: event.content,
+                                    ...(signature !== undefined ? { signature } : {}),
+                                    ...(redacted !== undefined ? { redacted } : {}),
+                                },
+                            };
+                            break;
+                        }
+                        case "toolcall_delta": {
+                            // The delta carries neither id nor name; both are only on the
+                            // in-progress call block that partial.content holds at this index.
+                            const call = toolCallAt(event.partial, event.contentIndex);
+                            if (call === undefined)
+                                break;
+                            const rawInput = toolArgs.append(call.id, call.name, event.delta);
+                            yield { type: "tool-call-partial", id: call.id, name: call.name, rawInput };
+                            break;
+                        }
+                        case "toolcall_end": {
+                            const pending = toolArgs.take(event.toolCall.id);
+                            let input;
+                            try {
+                                input = parseToolArgs(pending?.raw ?? "");
+                            }
+                            catch (cause) {
+                                // An error event, not a throw: text and usage already yielded
+                                // must survive.
+                                yield {
+                                    type: "error",
+                                    error: {
+                                        kind: "bad-request",
+                                        message: `Tool "${event.toolCall.name}" returned unparseable arguments.`,
+                                        cause,
+                                    },
+                                };
+                                return;
+                            }
+                            yield { type: "tool-call", call: { id: event.toolCall.id, name: event.toolCall.name, input } };
+                            break;
+                        }
+                        case "done": {
+                            const stopReason = STOP_REASONS[event.reason];
+                            yield { type: "usage", usage: toTokenUsage(event.message.usage) };
+                            if (stopReason === undefined) {
+                                yield {
+                                    type: "error",
+                                    error: {
+                                        kind: "unknown",
+                                        message: `Upstream reported stop reason "${event.reason}", which nax-ai never requests.`,
+                                    },
+                                };
+                                return;
+                            }
+                            yield { type: "done", stopReason };
+                            return;
+                        }
+                        case "error": {
+                            const status = observed?.status;
+                            const retryAfter = parseRetryAfter(observed?.headers);
+                            const usage = toTokenUsage(event.error.usage);
+                            // A failed request that consumed tokens still bills for them.
+                            if (totalTokens(usage) > 0)
+                                yield { type: "usage", usage };
+                            yield {
+                                type: "error",
+                                error: {
+                                    kind: classifyHttpError(status),
+                                    message: event.error.errorMessage ?? `Upstream stream ended: ${event.reason}.`,
+                                    ...(status !== undefined ? { status } : {}),
+                                    ...(retryAfter !== undefined ? { retryAfter } : {}),
+                                },
+                            };
+                            return;
+                        }
+                        default:
+                            // start, text_start, text_end, thinking_start and toolcall_start
+                            // carry nothing our vocabulary expresses: content is already
+                            // delivered by the deltas (and, for thinking, by "thinking_end"
+                            // above).
+                            break;
+                    }
+                }
+            }
+            catch (cause) {
+                // A stream failure with no HTTP response (connection reset, DNS
+                // failure, an immediate socket error) propagates as a raw throw
+                // rather than pi-ai's own "error" event — there was never a response
+                // to build one from, which is why classifyHttpError(undefined) would
+                // otherwise return "unknown" here. The caller's own abort must not be
+                // relabelled as a transport fault: retryTransportFaults, and any
+                // consumer-level abort handling, both need to see abort as abort.
+                if (req.signal?.aborted)
+                    throw cause;
+                yield { type: "error", error: classifyThrown(cause) };
+            }
+        },
+    };
+}
+let shared;
+/**
+ * The credential-backed twin of `shared`, keyed by the store itself. Each of
+ * the four protocol entries resolves lazily through `createPiDeps`, so without
+ * this memo a consumer with credentials would construct one Models per entry
+ * instead of the single instance pi-protocols.ts promises.
+ */
+const credentialed = new WeakMap();
+export function createPiDeps(options = {}) {
+    const store = options.credentials;
+    let models;
+    if (store === undefined) {
+        models = shared ??= builtinModels();
+    }
+    else {
+        models = credentialed.get(store) ?? builtinModels({ credentials: toPiCredentialStore(store) });
+        credentialed.set(store, models);
+    }
+    const resolver = createPiAuthResolver(models);
+    return {
+        resolveModel: async (modelId, provider) => {
+            // pi-ai serves one model id from many providers (e.g. gpt-5.4 under
+            // azure-openai-responses, openai and openai-codex), so when the client
+            // supplies the owning provider the search is scoped to it. Without a
+            // provider — protocol-direct callers and existing tests — the global
+            // catalog's first match stays as the documented fallback.
+            const found = provider !== undefined
+                ? models.getModels(provider).find((candidate) => candidate.id === modelId)
+                : models.getModels().find((candidate) => candidate.id === modelId);
+            if (found === undefined) {
+                if (provider !== undefined) {
+                    throw new Error(`Unknown model "${modelId}" for provider "${provider}" in the pi-ai catalog.`);
+                }
+                throw new Error(`Unknown model "${modelId}" in the pi-ai catalog.`);
+            }
+            return found;
+        },
+        stream: async function* (model, context, options_, onResponse) {
+            // Resolve through nax-ai's own port, not through Models' internal path,
+            // so the seam a native backend will use is exercised in production
+            // rather than merely exported.
+            const auth = await resolver.resolve({ provider: model.provider, model: model.id });
+            yield* models.streamSimple(model, context, {
+                ...options_,
+                ...(auth.apiKey !== undefined ? { apiKey: auth.apiKey } : {}),
+                ...(auth.headers !== undefined ? { headers: { ...auth.headers } } : {}),
+                onResponse: (response) => onResponse({ status: response.status, headers: response.headers }),
+            });
+        },
+    };
+}
+//# sourceMappingURL=pi-client.js.map

package/dist/protocols/pi-client.js.map

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

package/dist/protocols/pi-protocols.d.ts

@@ -0,0 +1,21 @@
+/**
+ * The registration surface for the pi-backed protocols.
+ *
+ * A consumer cannot assemble these entries itself: the four protocols must
+ * share one pi-ai Models instance, and therefore one credential store and one
+ * catalog, rather than constructing four. That is why this is exported rather
+ * than documented.
+ *
+ * pi-ai is not imported here. The factory is lazy, so the import cost is paid
+ * on first resolve of a protocol and not before.
+ */
+import type { CredentialStore } from "../types.ts";
+import type { ProtocolEntries } from "./registry.ts";
+export declare const PI_PROTOCOL_NAMES: readonly ["anthropic-messages", "openai-completions", "openai-responses", "openai-codex-responses"];
+export type PiProtocolName = (typeof PI_PROTOCOL_NAMES)[number];
+export interface PiProtocolOptions {
+    /** Where OAuth and api-key credentials live. Omitted means ambient only. */
+    readonly credentials?: CredentialStore;
+}
+export declare function piProtocols(options?: PiProtocolOptions): ProtocolEntries;
+//# sourceMappingURL=pi-protocols.d.ts.map

package/dist/protocols/pi-protocols.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi-protocols.d.ts","sourceRoot":"","sources":["../../src/protocols/pi-protocols.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD,eAAO,MAAM,iBAAiB,YAC5B,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,wBAAwB,CAChB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhE,MAAM,WAAW,iBAAiB;IAChC,4EAA4E;IAC5E,QAAQ,CAAC,WAAW,CAAC,EAAE,eAAe,CAAC;CACxC;AAED,wBAAgB,WAAW,CAAC,OAAO,GAAE,iBAAsB,GAAG,eAAe,CAY5E"}

package/dist/protocols/pi-protocols.js

@@ -0,0 +1,29 @@
+/**
+ * The registration surface for the pi-backed protocols.
+ *
+ * A consumer cannot assemble these entries itself: the four protocols must
+ * share one pi-ai Models instance, and therefore one credential store and one
+ * catalog, rather than constructing four. That is why this is exported rather
+ * than documented.
+ *
+ * pi-ai is not imported here. The factory is lazy, so the import cost is paid
+ * on first resolve of a protocol and not before.
+ */
+export const PI_PROTOCOL_NAMES = [
+    "anthropic-messages",
+    "openai-completions",
+    "openai-responses",
+    "openai-codex-responses",
+];
+export function piProtocols(options = {}) {
+    return Object.fromEntries(PI_PROTOCOL_NAMES.map((name) => [
+        name,
+        {
+            pi: async () => {
+                const { createPiDeps, createPiProtocol } = await import("./pi-client.js");
+                return createPiProtocol(name, createPiDeps(options));
+            },
+        },
+    ]));
+}
+//# sourceMappingURL=pi-protocols.js.map

package/dist/protocols/pi-protocols.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi-protocols.js","sourceRoot":"","sources":["../../src/protocols/pi-protocols.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,oBAAoB;IACpB,oBAAoB;IACpB,kBAAkB;IAClB,wBAAwB;CAChB,CAAC;AASX,MAAM,UAAU,WAAW,CAAC,OAAO,GAAsB,EAAE;IACzD,OAAO,MAAM,CAAC,WAAW,CACvB,iBAAiB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QAC9B,IAAI;QACJ;YACE,EAAE,EAAE,KAAK,IAAI,EAAE;gBACb,MAAM,EAAE,YAAY,EAAE,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;gBAC1E,OAAO,gBAAgB,CAAC,IAAI,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;YACvD,CAAC;SACF;KACF,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/protocols/registry.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Protocol backend registration and selection.
+ *
+ * A protocol may have more than one backend — `pi` today, `native` when a wire
+ * format is hand-written later. Both can be registered at once so a native
+ * implementation can be run against the pi-backed one on real traffic before
+ * becoming the default. That comparison is the reason selection happens at
+ * runtime rather than by swapping a module at build time.
+ */
+import type { Protocol } from "./types.ts";
+export type BackendId = "pi" | "native";
+/** Lazy factories keyed by backend id. Laziness preserves pi-ai's deferred SDK loading. */
+export type ProtocolBackends = Partial<Record<BackendId, () => Promise<Protocol>>>;
+export type ProtocolEntries = Readonly<Record<string, ProtocolBackends>>;
+export interface BackendSelection {
+    /** Applied to protocols not named in `byProtocol`. Defaults to "pi". */
+    readonly default?: BackendId;
+    readonly byProtocol?: Readonly<Record<string, BackendId>>;
+}
+export declare class UnknownProtocolError extends Error {
+    readonly protocolName: string;
+    constructor(protocolName: string);
+}
+export declare class UnregisteredBackendError extends Error {
+    readonly protocolName: string;
+    readonly backendId: BackendId;
+    constructor(protocolName: string, backendId: BackendId, available: readonly BackendId[]);
+}
+export interface ProtocolRegistry {
+    available(): ReadonlyMap<string, readonly BackendId[]>;
+    resolve(protocolName: string): Promise<Protocol>;
+    /** Throws if any configured selection names an unknown protocol or unregistered backend. */
+    validate(): void;
+}
+export declare function createRegistry(entries: ProtocolEntries, selection?: BackendSelection): ProtocolRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/protocols/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/protocols/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,QAAQ,CAAC;AAExC,2FAA2F;AAC3F,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;AAEnF,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC;AAEzE,MAAM,WAAW,gBAAgB;IAC/B,wEAAwE;IACxE,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;CAC3D;AAED,qBAAa,oBAAqB,SAAQ,KAAK;IACjC,QAAQ,CAAC,YAAY,EAAE,MAAM;IAAzC,YAAqB,YAAY,EAAE,MAAM,EAGxC;CACF;AAED,qBAAa,wBAAyB,SAAQ,KAAK;IAE/C,QAAQ,CAAC,YAAY,EAAE,MAAM;IAC7B,QAAQ,CAAC,SAAS,EAAE,SAAS;IAF/B,YACW,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,SAAS,EAC7B,SAAS,EAAE,SAAS,SAAS,EAAE,EAQhC;CACF;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,IAAI,WAAW,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,CAAC,CAAC;IACvD,OAAO,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACjD,4FAA4F;IAC5F,QAAQ,IAAI,IAAI,CAAC;CAClB;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe,EAAE,SAAS,GAAE,gBAAqB,GAAG,gBAAgB,CA8D3G"}