@elytracms/studio 0.0.55 → 0.0.57

package/dist/lib/ai/fake-provider.d.ts

@@ -3,13 +3,91 @@
  * implements the same interface as the Anthropic provider, so playground / demo /
  * tests run the WHOLE loop (config gate → shape → generate → validate → repair →
  * patch) without a key. Determinism is a project principle: the same fixtures always
- * yield the same result. Imports no AI SDK.
+ * yield the same result. Imports no AI SDK at runtime — the `LanguageModelV4` spec
+ * below is implemented STRUCTURALLY from type-only imports (erased at compile;
+ * pinned in `bundle.test.ts`).
  *
  * For the repair loop, pass `objects: [invalidDoc, validDoc]` — the provider returns
  * them in call order (the last is reused once the script is exhausted). Or pass
  * `respond` to compute the object from the request.
+ *
+ * EC-334 adds {@link createFakeChatModel}: a scripted fake `LanguageModel` served by
+ * the ROUTE's native chat branch, so the keyless playground / CI drive the FULL
+ * `streamText` → SSE wire → client-tool loop. It is a STATELESS prompt-inspecting
+ * responder (state read from the prompt, the FakeProvider trick): a prompt without a
+ * tool result emits a tool call; a prompt carrying one streams a text answer.
+ */
+import type { LanguageModel } from 'ai';
+import type { AiProvider, AiProviderCapabilities, GenerateStructuredRequest } from './types.js';
+/** The SDK's v4 language-model spec, extracted structurally from the type-only union. */
+export type FakeLanguageModelV4 = Extract<LanguageModel, {
+    specificationVersion: 'v4';
+}>;
+/** The call options a fake chat model receives (`LanguageModelV4CallOptions`). */
+export type FakeChatModelCallOptions = Parameters<FakeLanguageModelV4['doGenerate']>[0];
+/** One provider-spec stream part the fake emits (`LanguageModelV4StreamPart`). */
+export type FakeChatModelStreamPart = Awaited<ReturnType<FakeLanguageModelV4['doStream']>>['stream'] extends ReadableStream<infer PART> ? PART : never;
+/** Default preamble streamed before the scripted tool call. */
+export declare const FAKE_CHAT_PREAMBLE = "Let me look that up. ";
+/** Default final answer streamed once the prompt carries a tool result. */
+export declare const FAKE_CHAT_ANSWER = "Found it \u2014 the tool result is in, and this is the answer.";
+export interface FakeChatModelOptions {
+    /** Model id reported to the SDK (default `fake-chat-model`). */
+    modelId?: string;
+    /** Text streamed before the tool call on the first (tool-result-free) turn. */
+    preambleText?: string;
+    /** The tool the first turn requests (default `searchDocuments`). */
+    toolName?: string;
+    /** The tool-call input (default `{ collection: 'post' }`). */
+    toolInput?: Record<string, unknown>;
+    /** The answer streamed word-by-word once the prompt carries a tool result. */
+    answerText?: string;
+    /**
+     * Full override: script the exact provider-spec stream parts for a call
+     * (zero-based call index). The default prompt-inspecting behavior is skipped.
+     */
+    script?: (options: FakeChatModelCallOptions, callIndex: number) => FakeChatModelStreamPart[];
+}
+/** A fake chat model that also records the calls it received, for assertions. */
+export type FakeChatModel = FakeLanguageModelV4 & {
+    /** Every `doStream` / `doGenerate` call options received, in order. */
+    readonly calls: FakeChatModelCallOptions[];
+};
+/**
+ * Build a scripted, stateless fake `LanguageModel` (the `LanguageModelV4` spec,
+ * implemented structurally — zero SDK runtime import). Default behavior:
+ *   - prompt WITHOUT a tool result → preamble text, then a `tool-call` for
+ *     {@link FakeChatModelOptions.toolName} (finish reason `tool-calls`);
+ *   - prompt WITH a tool result → the answer text streamed word-by-word (`stop`).
+ * Chunk shapes follow the v4 spec: `finishReason` is `{ unified, raw }`, tool chunks
+ * are `tool-input-start/delta/end` + `tool-call`.
+ */
+export declare function createFakeChatModel(options?: FakeChatModelOptions): FakeChatModel;
+export interface FakeCreateFlowChatModelOptions {
+    /** Model id reported to the SDK (default `fake-create-flow-model`). */
+    modelId?: string;
+    /** The collection the first stage searches (a relation target; default `author`). */
+    searchCollection?: string;
+    /** The collection the terminal stage creates in (default `post`). */
+    createCollection?: string;
+    /** The final answer streamed word-by-word after the proposal lands. */
+    answerText?: string;
+}
+/** Default final answer of the scripted create flow. */
+export declare const FAKE_CREATE_FLOW_ANSWER = "Done \u2014 review the proposal below and apply it as a draft.";
+/**
+ * A scripted, STATELESS fake chat model that drives the FULL create flow over the
+ * native loop (EC-334): keyless playground / CI exercise user message → search
+ * tool → `createDocument` terminal tool (the client runs `applyContentWithShape`)
+ * → streamed final answer. Stage is read from the CURRENT user turn's tool
+ * results (prompt suffix after the last user message), so every follow-up turn
+ * starts a fresh flow — multi-turn works without model state:
+ *
+ *  1. no tool result yet          → `searchDocuments({ collection: searchCollection })`
+ *  2. search result, no create    → `createDocument({ collection, instruction: <last user text> })`
+ *  3. create result present       → the answer text, word by word.
  */
-import type { AiProvider, AiProviderCapabilities, GenerateStructuredRequest, StreamChatRequest } from './types.js';
+export declare function createFakeCreateFlowChatModel(options?: FakeCreateFlowChatModelOptions): FakeChatModel;
 export interface FakeProviderOptions {
     /** Provider id (default `fake`). */
     id?: string;
@@ -21,14 +99,14 @@ export interface FakeProviderOptions {
     objects?: unknown[];
     /** Compute the object from the request + zero-based call index (overrides `objects`). */
     respond?: (request: GenerateStructuredRequest, callIndex: number) => unknown;
-    /** Fixed text `streamChat` streams back (default: echoes the last user message). */
-    streamText?: string;
+    /** The scripted chat model `languageModel()` serves (default {@link createFakeChatModel}). */
+    chatModel?: FakeChatModel;
 }
 /** A FakeProvider that also records the requests it received, for assertions. */
 export interface FakeProvider extends AiProvider {
     /** Every `generateStructured` request received, in order. */
     readonly calls: GenerateStructuredRequest[];
-    /** Every `streamChat` request received, in order. */
-    readonly streamCalls: StreamChatRequest[];
+    /** The scripted fake chat model behind `languageModel()` (records its calls). */
+    readonly chatModel: FakeChatModel;
 }
 export declare function createFakeProvider(options?: FakeProviderOptions): FakeProvider;

package/dist/lib/ai/fake-provider.js

@@ -1,14 +1,205 @@
+/** Zero-usage report (the fake spends nothing). Shape = `LanguageModelV4Usage`. */
+const FAKE_USAGE = {
+    inputTokens: { total: 0, noCache: 0, cacheRead: 0, cacheWrite: 0 },
+    outputTokens: { total: 0, text: 0, reasoning: 0 },
+};
+/** Default preamble streamed before the scripted tool call. */
+export const FAKE_CHAT_PREAMBLE = 'Let me look that up. ';
+/** Default final answer streamed once the prompt carries a tool result. */
+export const FAKE_CHAT_ANSWER = 'Found it — the tool result is in, and this is the answer.';
+/** Does any prompt message carry a tool RESULT part? (The fake's only "state".) */
+function promptHasToolResult(prompt) {
+    return prompt.some((message) => Array.isArray(message.content) &&
+        message.content.some((part) => part.type === 'tool-result'));
+}
+/** Index of the LAST user message in the prompt (`-1` when none). */
+function lastUserIndex(prompt) {
+    for (let i = prompt.length - 1; i >= 0; i -= 1) {
+        if (prompt[i]?.role === 'user')
+            return i;
+    }
+    return -1;
+}
+/** The last user message's text (the fake's "instruction" source). */
+function lastUserText(prompt) {
+    const index = lastUserIndex(prompt);
+    const message = prompt[index];
+    if (!message || !Array.isArray(message.content))
+        return '';
+    return message.content
+        .filter((part) => part.type === 'text')
+        .map((part) => part.text)
+        .join(' ')
+        .trim();
+}
+/**
+ * Tool names with a RESULT in the CURRENT user turn (prompt suffix after the
+ * last user message) — the stateless stage detector for scripted flows.
+ */
+function toolResultNamesInCurrentTurn(prompt) {
+    const names = new Set();
+    for (const message of prompt.slice(lastUserIndex(prompt) + 1)) {
+        if (!Array.isArray(message.content))
+            continue;
+        for (const part of message.content) {
+            const candidate = part;
+            if (candidate.type === 'tool-result' && typeof candidate.toolName === 'string') {
+                names.add(candidate.toolName);
+            }
+        }
+    }
+    return names;
+}
+/** Provider-spec parts for one text-preamble + tool-call turn (finish `tool-calls`). */
+function toolTurnParts(preamble, toolName, input, callId) {
+    const encoded = JSON.stringify(input);
+    return [
+        { type: 'stream-start', warnings: [] },
+        { type: 'text-start', id: 'text-1' },
+        { type: 'text-delta', id: 'text-1', delta: preamble },
+        { type: 'text-end', id: 'text-1' },
+        { type: 'tool-input-start', id: callId, toolName },
+        { type: 'tool-input-delta', id: callId, delta: encoded },
+        { type: 'tool-input-end', id: callId },
+        { type: 'tool-call', toolCallId: callId, toolName, input: encoded },
+        {
+            type: 'finish',
+            usage: FAKE_USAGE,
+            finishReason: { unified: 'tool-calls', raw: 'fake-tool-calls' },
+        },
+    ];
+}
+/** Provider-spec parts for a word-by-word streamed text answer (finish `stop`). */
+function answerTurnParts(answer) {
+    return [
+        { type: 'stream-start', warnings: [] },
+        { type: 'text-start', id: 'text-1' },
+        ...wordDeltas(answer).map((delta) => ({ type: 'text-delta', id: 'text-1', delta })),
+        { type: 'text-end', id: 'text-1' },
+        { type: 'finish', usage: FAKE_USAGE, finishReason: { unified: 'stop', raw: 'fake-stop' } },
+    ];
+}
+/** Split text into word deltas (trailing spaces preserved) for visible streaming. */
+function wordDeltas(text) {
+    const words = text.split(' ');
+    return words.map((word, index) => (index < words.length - 1 ? `${word} ` : word));
+}
+/**
+ * Build a scripted, stateless fake `LanguageModel` (the `LanguageModelV4` spec,
+ * implemented structurally — zero SDK runtime import). Default behavior:
+ *   - prompt WITHOUT a tool result → preamble text, then a `tool-call` for
+ *     {@link FakeChatModelOptions.toolName} (finish reason `tool-calls`);
+ *   - prompt WITH a tool result → the answer text streamed word-by-word (`stop`).
+ * Chunk shapes follow the v4 spec: `finishReason` is `{ unified, raw }`, tool chunks
+ * are `tool-input-start/delta/end` + `tool-call`.
+ */
+export function createFakeChatModel(options = {}) {
+    const preamble = options.preambleText ?? FAKE_CHAT_PREAMBLE;
+    const toolName = options.toolName ?? 'searchDocuments';
+    const toolInput = options.toolInput ?? { collection: 'post' };
+    const answer = options.answerText ?? FAKE_CHAT_ANSWER;
+    const calls = [];
+    let callIndex = 0;
+    function partsFor(callOptions) {
+        if (options.script)
+            return options.script(callOptions, callIndex);
+        if (!promptHasToolResult(callOptions.prompt)) {
+            return toolTurnParts(preamble, toolName, toolInput, 'call-1');
+        }
+        return answerTurnParts(answer);
+    }
+    /** Fold the scripted stream parts into a non-streaming `doGenerate` result. */
+    function materialize(parts) {
+        const content = [];
+        const textById = new Map();
+        let finishReason = { unified: 'stop', raw: 'fake-stop' };
+        for (const part of parts) {
+            if (part.type === 'text-delta') {
+                textById.set(part.id, (textById.get(part.id) ?? '') + part.delta);
+            }
+            else if (part.type === 'tool-call') {
+                content.push(part);
+            }
+            else if (part.type === 'finish') {
+                finishReason = part.finishReason;
+            }
+        }
+        for (const text of textById.values())
+            content.unshift({ type: 'text', text });
+        return { content, finishReason, usage: FAKE_USAGE, warnings: [] };
+    }
+    return {
+        specificationVersion: 'v4',
+        provider: 'fake',
+        modelId: options.modelId ?? 'fake-chat-model',
+        supportedUrls: {},
+        calls,
+        doGenerate(callOptions) {
+            calls.push(callOptions);
+            const parts = partsFor(callOptions);
+            callIndex += 1;
+            return Promise.resolve(materialize(parts));
+        },
+        doStream(callOptions) {
+            calls.push(callOptions);
+            const parts = partsFor(callOptions);
+            callIndex += 1;
+            return Promise.resolve({
+                stream: new ReadableStream({
+                    start(controller) {
+                        for (const part of parts)
+                            controller.enqueue(part);
+                        controller.close();
+                    },
+                }),
+            });
+        },
+    };
+}
+/** Default final answer of the scripted create flow. */
+export const FAKE_CREATE_FLOW_ANSWER = 'Done — review the proposal below and apply it as a draft.';
+/**
+ * A scripted, STATELESS fake chat model that drives the FULL create flow over the
+ * native loop (EC-334): keyless playground / CI exercise user message → search
+ * tool → `createDocument` terminal tool (the client runs `applyContentWithShape`)
+ * → streamed final answer. Stage is read from the CURRENT user turn's tool
+ * results (prompt suffix after the last user message), so every follow-up turn
+ * starts a fresh flow — multi-turn works without model state:
+ *
+ *  1. no tool result yet          → `searchDocuments({ collection: searchCollection })`
+ *  2. search result, no create    → `createDocument({ collection, instruction: <last user text> })`
+ *  3. create result present       → the answer text, word by word.
+ */
+export function createFakeCreateFlowChatModel(options = {}) {
+    const searchCollection = options.searchCollection ?? 'author';
+    const createCollection = options.createCollection ?? 'post';
+    const answer = options.answerText ?? FAKE_CREATE_FLOW_ANSWER;
+    return createFakeChatModel({
+        modelId: options.modelId ?? 'fake-create-flow-model',
+        script: (callOptions) => {
+            const done = toolResultNamesInCurrentTurn(callOptions.prompt);
+            if (done.has('createDocument'))
+                return answerTurnParts(answer);
+            if (done.has('searchDocuments')) {
+                const instruction = lastUserText(callOptions.prompt) || 'Write a short document.';
+                return toolTurnParts('Drafting a proposal. ', 'createDocument', { collection: createCollection, instruction }, 'call-create-1');
+            }
+            return toolTurnParts(FAKE_CHAT_PREAMBLE, 'searchDocuments', { collection: searchCollection }, 'call-search-1');
+        },
+    });
+}
 export function createFakeProvider(options = {}) {
     const calls = [];
-    const streamCalls = [];
     const objects = options.objects ?? [];
+    const chatModel = options.chatModel ?? createFakeChatModel();
     let index = 0;
     return {
         id: options.id ?? 'fake',
         model: options.model ?? 'fake-model',
         calls,
-        streamCalls,
+        chatModel,
         capabilities: () => options.capabilities ?? { toolCalling: true, structuredOutput: true },
+        languageModel: () => Promise.resolve(chatModel),
         generateStructured(request) {
             calls.push(request);
             const callIndex = index;
@@ -20,12 +211,6 @@ export function createFakeProvider(options = {}) {
                     : {};
             return Promise.resolve({ object, usage: { inputTokens: 0, outputTokens: 0 } });
         },
-        streamChat(request) {
-            streamCalls.push(request);
-            const last = request.messages.filter((m) => m.role === 'user').at(-1);
-            const text = options.streamText ?? last?.content ?? '';
-            return Promise.resolve(new Response(text, { headers: { 'content-type': 'text/plain; charset=utf-8' } }));
-        },
     };
 }
 //# sourceMappingURL=fake-provider.js.map

package/dist/lib/ai/fake-provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"fake-provider.js","sourceRoot":"","sources":["../../../src/lib/ai/fake-provider.ts"],"names":[],"mappings":"AAyCA,MAAM,UAAU,kBAAkB,CAAC,UAA+B,EAAE;IAClE,MAAM,KAAK,GAAgC,EAAE,CAAA;IAC7C,MAAM,WAAW,GAAwB,EAAE,CAAA;IAC3C,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,EAAE,CAAA;IACrC,IAAI,KAAK,GAAG,CAAC,CAAA;IAEb,OAAO;QACL,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,MAAM;QACxB,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,YAAY;QACpC,KAAK;QACL,WAAW;QACX,YAAY,EAAE,GAA2B,EAAE,CACzC,OAAO,CAAC,YAAY,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE;QAEvE,kBAAkB,CAAC,OAAO;YACxB,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;YACnB,MAAM,SAAS,GAAG,KAAK,CAAA;YACvB,KAAK,IAAI,CAAC,CAAA;YACV,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO;gBAC5B,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC;gBACrC,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;oBAClB,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;oBAClD,CAAC,CAAC,EAAE,CAAA;YACR,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,EAAE,CAAC,CAAA;QAChF,CAAC;QAED,UAAU,CAAC,OAAO;YAChB,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;YACzB,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;YACrE,MAAM,IAAI,GAAG,OAAO,CAAC,UAAU,IAAI,IAAI,EAAE,OAAO,IAAI,EAAE,CAAA;YACtD,OAAO,OAAO,CAAC,OAAO,CACpB,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,EAAE,cAAc,EAAE,2BAA2B,EAAE,EAAE,CAAC,CACjF,CAAA;QACH,CAAC;KACF,CAAA;AACH,CAAC","sourcesContent":["/**\n * FakeProvider (EC-331): a deterministic, fixture-driven {@link AiProvider} that\n * implements the same interface as the Anthropic provider, so playground / demo /\n * tests run the WHOLE loop (config gate → shape → generate → validate → repair →\n * patch) without a key. Determinism is a project principle: the same fixtures always\n * yield the same result. Imports no AI SDK.\n *\n * For the repair loop, pass `objects: [invalidDoc, validDoc]` — the provider returns\n * them in call order (the last is reused once the script is exhausted). Or pass\n * `respond` to compute the object from the request.\n */\nimport type {\n  AiProvider,\n  AiProviderCapabilities,\n  GenerateStructuredRequest,\n  StreamChatRequest,\n} from './types'\n\nexport interface FakeProviderOptions {\n  /** Provider id (default `fake`). */\n  id?: string\n  /** Model id recorded in provenance (default `fake-model`). */\n  model?: string\n  /** Reported capabilities (default: both true). Set to test the capability gate. */\n  capabilities?: AiProviderCapabilities\n  /** Scripted objects returned in call order; the last entry is reused when exhausted. */\n  objects?: unknown[]\n  /** Compute the object from the request + zero-based call index (overrides `objects`). */\n  respond?: (request: GenerateStructuredRequest, callIndex: number) => unknown\n  /** Fixed text `streamChat` streams back (default: echoes the last user message). */\n  streamText?: string\n}\n\n/** A FakeProvider that also records the requests it received, for assertions. */\nexport interface FakeProvider extends AiProvider {\n  /** Every `generateStructured` request received, in order. */\n  readonly calls: GenerateStructuredRequest[]\n  /** Every `streamChat` request received, in order. */\n  readonly streamCalls: StreamChatRequest[]\n}\n\nexport function createFakeProvider(options: FakeProviderOptions = {}): FakeProvider {\n  const calls: GenerateStructuredRequest[] = []\n  const streamCalls: StreamChatRequest[] = []\n  const objects = options.objects ?? []\n  let index = 0\n\n  return {\n    id: options.id ?? 'fake',\n    model: options.model ?? 'fake-model',\n    calls,\n    streamCalls,\n    capabilities: (): AiProviderCapabilities =>\n      options.capabilities ?? { toolCalling: true, structuredOutput: true },\n\n    generateStructured(request) {\n      calls.push(request)\n      const callIndex = index\n      index += 1\n      const object = options.respond\n        ? options.respond(request, callIndex)\n        : objects.length > 0\n          ? objects[Math.min(callIndex, objects.length - 1)]\n          : {}\n      return Promise.resolve({ object, usage: { inputTokens: 0, outputTokens: 0 } })\n    },\n\n    streamChat(request) {\n      streamCalls.push(request)\n      const last = request.messages.filter((m) => m.role === 'user').at(-1)\n      const text = options.streamText ?? last?.content ?? ''\n      return Promise.resolve(\n        new Response(text, { headers: { 'content-type': 'text/plain; charset=utf-8' } }),\n      )\n    },\n  }\n}\n"]}
+{"version":3,"file":"fake-provider.js","sourceRoot":"","sources":["../../../src/lib/ai/fake-provider.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * FakeProvider (EC-331): a deterministic, fixture-driven {@link AiProvider} that\n * implements the same interface as the Anthropic provider, so playground / demo /\n * tests run the WHOLE loop (config gate → shape → generate → validate → repair →\n * patch) without a key. Determinism is a project principle: the same fixtures always\n * yield the same result. Imports no AI SDK at runtime — the `LanguageModelV4` spec\n * below is implemented STRUCTURALLY from type-only imports (erased at compile;\n * pinned in `bundle.test.ts`).\n *\n * For the repair loop, pass `objects: [invalidDoc, validDoc]` — the provider returns\n * them in call order (the last is reused once the script is exhausted). Or pass\n * `respond` to compute the object from the request.\n *\n * EC-334 adds {@link createFakeChatModel}: a scripted fake `LanguageModel` served by\n * the ROUTE's native chat branch, so the keyless playground / CI drive the FULL\n * `streamText` → SSE wire → client-tool loop. It is a STATELESS prompt-inspecting\n * responder (state read from the prompt, the FakeProvider trick): a prompt without a\n * tool result emits a tool call; a prompt carrying one streams a text answer.\n */\n// Type-only (erased): the fake implements the SDK's v4 model spec structurally.\nimport type { LanguageModel } from 'ai'\nimport type { AiProvider, AiProviderCapabilities, GenerateStructuredRequest } from './types'\n\n// --- Fake chat model (EC-334) -------------------------------------------------------\n\n/** The SDK's v4 language-model spec, extracted structurally from the type-only union. */\nexport type FakeLanguageModelV4 = Extract<LanguageModel, { specificationVersion: 'v4' }>\n\n/** The call options a fake chat model receives (`LanguageModelV4CallOptions`). */\nexport type FakeChatModelCallOptions = Parameters<FakeLanguageModelV4['doGenerate']>[0]\n\n/** One provider-spec stream part the fake emits (`LanguageModelV4StreamPart`). */\nexport type FakeChatModelStreamPart =\n  Awaited<ReturnType<FakeLanguageModelV4['doStream']>>['stream'] extends ReadableStream<infer PART>\n    ? PART\n    : never\n\ntype FakeFinishPart = Extract<FakeChatModelStreamPart, { type: 'finish' }>\ntype FakeGenerateResult = Awaited<ReturnType<FakeLanguageModelV4['doGenerate']>>\n\n/** Zero-usage report (the fake spends nothing). Shape = `LanguageModelV4Usage`. */\nconst FAKE_USAGE: FakeFinishPart['usage'] = {\n  inputTokens: { total: 0, noCache: 0, cacheRead: 0, cacheWrite: 0 },\n  outputTokens: { total: 0, text: 0, reasoning: 0 },\n}\n\n/** Default preamble streamed before the scripted tool call. */\nexport const FAKE_CHAT_PREAMBLE = 'Let me look that up. '\n/** Default final answer streamed once the prompt carries a tool result. */\nexport const FAKE_CHAT_ANSWER = 'Found it — the tool result is in, and this is the answer.'\n\nexport interface FakeChatModelOptions {\n  /** Model id reported to the SDK (default `fake-chat-model`). */\n  modelId?: string\n  /** Text streamed before the tool call on the first (tool-result-free) turn. */\n  preambleText?: string\n  /** The tool the first turn requests (default `searchDocuments`). */\n  toolName?: string\n  /** The tool-call input (default `{ collection: 'post' }`). */\n  toolInput?: Record<string, unknown>\n  /** The answer streamed word-by-word once the prompt carries a tool result. */\n  answerText?: string\n  /**\n   * Full override: script the exact provider-spec stream parts for a call\n   * (zero-based call index). The default prompt-inspecting behavior is skipped.\n   */\n  script?: (options: FakeChatModelCallOptions, callIndex: number) => FakeChatModelStreamPart[]\n}\n\n/** A fake chat model that also records the calls it received, for assertions. */\nexport type FakeChatModel = FakeLanguageModelV4 & {\n  /** Every `doStream` / `doGenerate` call options received, in order. */\n  readonly calls: FakeChatModelCallOptions[]\n}\n\n/** Does any prompt message carry a tool RESULT part? (The fake's only \"state\".) */\nfunction promptHasToolResult(prompt: FakeChatModelCallOptions['prompt']): boolean {\n  return prompt.some(\n    (message) =>\n      Array.isArray(message.content) &&\n      message.content.some(\n        (part) => (part as { type?: unknown }).type === 'tool-result',\n      ),\n  )\n}\n\n/** Index of the LAST user message in the prompt (`-1` when none). */\nfunction lastUserIndex(prompt: FakeChatModelCallOptions['prompt']): number {\n  for (let i = prompt.length - 1; i >= 0; i -= 1) {\n    if (prompt[i]?.role === 'user') return i\n  }\n  return -1\n}\n\n/** The last user message's text (the fake's \"instruction\" source). */\nfunction lastUserText(prompt: FakeChatModelCallOptions['prompt']): string {\n  const index = lastUserIndex(prompt)\n  const message = prompt[index]\n  if (!message || !Array.isArray(message.content)) return ''\n  return message.content\n    .filter((part): part is { type: 'text'; text: string } => (part as { type?: unknown }).type === 'text')\n    .map((part) => part.text)\n    .join(' ')\n    .trim()\n}\n\n/**\n * Tool names with a RESULT in the CURRENT user turn (prompt suffix after the\n * last user message) — the stateless stage detector for scripted flows.\n */\nfunction toolResultNamesInCurrentTurn(prompt: FakeChatModelCallOptions['prompt']): Set<string> {\n  const names = new Set<string>()\n  for (const message of prompt.slice(lastUserIndex(prompt) + 1)) {\n    if (!Array.isArray(message.content)) continue\n    for (const part of message.content) {\n      const candidate = part as { type?: unknown; toolName?: unknown }\n      if (candidate.type === 'tool-result' && typeof candidate.toolName === 'string') {\n        names.add(candidate.toolName)\n      }\n    }\n  }\n  return names\n}\n\n/** Provider-spec parts for one text-preamble + tool-call turn (finish `tool-calls`). */\nfunction toolTurnParts(\n  preamble: string,\n  toolName: string,\n  input: Record<string, unknown>,\n  callId: string,\n): FakeChatModelStreamPart[] {\n  const encoded = JSON.stringify(input)\n  return [\n    { type: 'stream-start', warnings: [] },\n    { type: 'text-start', id: 'text-1' },\n    { type: 'text-delta', id: 'text-1', delta: preamble },\n    { type: 'text-end', id: 'text-1' },\n    { type: 'tool-input-start', id: callId, toolName },\n    { type: 'tool-input-delta', id: callId, delta: encoded },\n    { type: 'tool-input-end', id: callId },\n    { type: 'tool-call', toolCallId: callId, toolName, input: encoded },\n    {\n      type: 'finish',\n      usage: FAKE_USAGE,\n      finishReason: { unified: 'tool-calls', raw: 'fake-tool-calls' },\n    },\n  ]\n}\n\n/** Provider-spec parts for a word-by-word streamed text answer (finish `stop`). */\nfunction answerTurnParts(answer: string): FakeChatModelStreamPart[] {\n  return [\n    { type: 'stream-start', warnings: [] },\n    { type: 'text-start', id: 'text-1' },\n    ...wordDeltas(answer).map(\n      (delta): FakeChatModelStreamPart => ({ type: 'text-delta', id: 'text-1', delta }),\n    ),\n    { type: 'text-end', id: 'text-1' },\n    { type: 'finish', usage: FAKE_USAGE, finishReason: { unified: 'stop', raw: 'fake-stop' } },\n  ]\n}\n\n/** Split text into word deltas (trailing spaces preserved) for visible streaming. */\nfunction wordDeltas(text: string): string[] {\n  const words = text.split(' ')\n  return words.map((word, index) => (index < words.length - 1 ? `${word} ` : word))\n}\n\n/**\n * Build a scripted, stateless fake `LanguageModel` (the `LanguageModelV4` spec,\n * implemented structurally — zero SDK runtime import). Default behavior:\n *   - prompt WITHOUT a tool result → preamble text, then a `tool-call` for\n *     {@link FakeChatModelOptions.toolName} (finish reason `tool-calls`);\n *   - prompt WITH a tool result → the answer text streamed word-by-word (`stop`).\n * Chunk shapes follow the v4 spec: `finishReason` is `{ unified, raw }`, tool chunks\n * are `tool-input-start/delta/end` + `tool-call`.\n */\nexport function createFakeChatModel(options: FakeChatModelOptions = {}): FakeChatModel {\n  const preamble = options.preambleText ?? FAKE_CHAT_PREAMBLE\n  const toolName = options.toolName ?? 'searchDocuments'\n  const toolInput = options.toolInput ?? { collection: 'post' }\n  const answer = options.answerText ?? FAKE_CHAT_ANSWER\n  const calls: FakeChatModelCallOptions[] = []\n  let callIndex = 0\n\n  function partsFor(callOptions: FakeChatModelCallOptions): FakeChatModelStreamPart[] {\n    if (options.script) return options.script(callOptions, callIndex)\n    if (!promptHasToolResult(callOptions.prompt)) {\n      return toolTurnParts(preamble, toolName, toolInput, 'call-1')\n    }\n    return answerTurnParts(answer)\n  }\n\n  /** Fold the scripted stream parts into a non-streaming `doGenerate` result. */\n  function materialize(parts: FakeChatModelStreamPart[]): FakeGenerateResult {\n    const content: FakeGenerateResult['content'] = []\n    const textById = new Map<string, string>()\n    let finishReason: FakeFinishPart['finishReason'] = { unified: 'stop', raw: 'fake-stop' }\n    for (const part of parts) {\n      if (part.type === 'text-delta') {\n        textById.set(part.id, (textById.get(part.id) ?? '') + part.delta)\n      } else if (part.type === 'tool-call') {\n        content.push(part)\n      } else if (part.type === 'finish') {\n        finishReason = part.finishReason\n      }\n    }\n    for (const text of textById.values()) content.unshift({ type: 'text', text })\n    return { content, finishReason, usage: FAKE_USAGE, warnings: [] }\n  }\n\n  return {\n    specificationVersion: 'v4',\n    provider: 'fake',\n    modelId: options.modelId ?? 'fake-chat-model',\n    supportedUrls: {},\n    calls,\n    doGenerate(callOptions) {\n      calls.push(callOptions)\n      const parts = partsFor(callOptions)\n      callIndex += 1\n      return Promise.resolve(materialize(parts))\n    },\n    doStream(callOptions) {\n      calls.push(callOptions)\n      const parts = partsFor(callOptions)\n      callIndex += 1\n      return Promise.resolve({\n        stream: new ReadableStream<FakeChatModelStreamPart>({\n          start(controller) {\n            for (const part of parts) controller.enqueue(part)\n            controller.close()\n          },\n        }),\n      })\n    },\n  }\n}\n\n// --- Fake create-flow chat model (EC-334 slice 2) -------------------------------------\n\nexport interface FakeCreateFlowChatModelOptions {\n  /** Model id reported to the SDK (default `fake-create-flow-model`). */\n  modelId?: string\n  /** The collection the first stage searches (a relation target; default `author`). */\n  searchCollection?: string\n  /** The collection the terminal stage creates in (default `post`). */\n  createCollection?: string\n  /** The final answer streamed word-by-word after the proposal lands. */\n  answerText?: string\n}\n\n/** Default final answer of the scripted create flow. */\nexport const FAKE_CREATE_FLOW_ANSWER =\n  'Done — review the proposal below and apply it as a draft.'\n\n/**\n * A scripted, STATELESS fake chat model that drives the FULL create flow over the\n * native loop (EC-334): keyless playground / CI exercise user message → search\n * tool → `createDocument` terminal tool (the client runs `applyContentWithShape`)\n * → streamed final answer. Stage is read from the CURRENT user turn's tool\n * results (prompt suffix after the last user message), so every follow-up turn\n * starts a fresh flow — multi-turn works without model state:\n *\n *  1. no tool result yet          → `searchDocuments({ collection: searchCollection })`\n *  2. search result, no create    → `createDocument({ collection, instruction: <last user text> })`\n *  3. create result present       → the answer text, word by word.\n */\nexport function createFakeCreateFlowChatModel(\n  options: FakeCreateFlowChatModelOptions = {},\n): FakeChatModel {\n  const searchCollection = options.searchCollection ?? 'author'\n  const createCollection = options.createCollection ?? 'post'\n  const answer = options.answerText ?? FAKE_CREATE_FLOW_ANSWER\n  return createFakeChatModel({\n    modelId: options.modelId ?? 'fake-create-flow-model',\n    script: (callOptions) => {\n      const done = toolResultNamesInCurrentTurn(callOptions.prompt)\n      if (done.has('createDocument')) return answerTurnParts(answer)\n      if (done.has('searchDocuments')) {\n        const instruction = lastUserText(callOptions.prompt) || 'Write a short document.'\n        return toolTurnParts(\n          'Drafting a proposal. ',\n          'createDocument',\n          { collection: createCollection, instruction },\n          'call-create-1',\n        )\n      }\n      return toolTurnParts(\n        FAKE_CHAT_PREAMBLE,\n        'searchDocuments',\n        { collection: searchCollection },\n        'call-search-1',\n      )\n    },\n  })\n}\n\n// --- Fake provider ------------------------------------------------------------------\n\nexport interface FakeProviderOptions {\n  /** Provider id (default `fake`). */\n  id?: string\n  /** Model id recorded in provenance (default `fake-model`). */\n  model?: string\n  /** Reported capabilities (default: both true). Set to test the capability gate. */\n  capabilities?: AiProviderCapabilities\n  /** Scripted objects returned in call order; the last entry is reused when exhausted. */\n  objects?: unknown[]\n  /** Compute the object from the request + zero-based call index (overrides `objects`). */\n  respond?: (request: GenerateStructuredRequest, callIndex: number) => unknown\n  /** The scripted chat model `languageModel()` serves (default {@link createFakeChatModel}). */\n  chatModel?: FakeChatModel\n}\n\n/** A FakeProvider that also records the requests it received, for assertions. */\nexport interface FakeProvider extends AiProvider {\n  /** Every `generateStructured` request received, in order. */\n  readonly calls: GenerateStructuredRequest[]\n  /** The scripted fake chat model behind `languageModel()` (records its calls). */\n  readonly chatModel: FakeChatModel\n}\n\nexport function createFakeProvider(options: FakeProviderOptions = {}): FakeProvider {\n  const calls: GenerateStructuredRequest[] = []\n  const objects = options.objects ?? []\n  const chatModel = options.chatModel ?? createFakeChatModel()\n  let index = 0\n\n  return {\n    id: options.id ?? 'fake',\n    model: options.model ?? 'fake-model',\n    calls,\n    chatModel,\n    capabilities: (): AiProviderCapabilities =>\n      options.capabilities ?? { toolCalling: true, structuredOutput: true },\n\n    languageModel: () => Promise.resolve(chatModel),\n\n    generateStructured(request) {\n      calls.push(request)\n      const callIndex = index\n      index += 1\n      const object = options.respond\n        ? options.respond(request, callIndex)\n        : objects.length > 0\n          ? objects[Math.min(callIndex, objects.length - 1)]\n          : {}\n      return Promise.resolve({ object, usage: { inputTokens: 0, outputTokens: 0 } })\n    },\n  }\n}\n"]}

package/dist/lib/ai/gateway-provider.d.ts

@@ -0,0 +1,30 @@
+import type { AiProvider } from './types.js';
+export interface GatewayProviderOptions {
+    /**
+     * Gateway API key (`AI_GATEWAY_API_KEY` / Vercel access token). Omit on Vercel
+     * deployments to use automatic OIDC. A set key always beats OIDC — see the
+     * module doc for the blank-key guard.
+     */
+    apiKey?: string;
+    /** Gateway model string, `<provider>/<model>` (default {@link DEFAULT_GATEWAY_MODEL}). */
+    model?: string;
+    /** Optional base URL override (defaults to the SDK's gateway endpoint). */
+    baseURL?: string;
+}
+/** Default gateway model — the direct-Anthropic default, addressed through the gateway. */
+export declare const DEFAULT_GATEWAY_MODEL = "anthropic/claude-opus-4-8";
+/**
+ * Resolve the effective gateway `apiKey` with the apiKey-beats-OIDC foot-gun guards
+ * (pure core; env + warn injected for tests):
+ *   - `undefined` passes through (OIDC / env-var auth applies downstream);
+ *   - blank/whitespace → treated as ABSENT + loud warning (a set key, even an
+ *     empty one, would otherwise silently beat OIDC);
+ *   - a real key while OIDC is also available → kept, with a warning that it wins.
+ */
+export declare function resolveGatewayApiKey(apiKey: string | undefined, env?: Record<string, string | undefined>, warn?: (message: string) => void): string | undefined;
+/**
+ * Build a Vercel-AI-Gateway-backed {@link AiProvider}. Tool calling + structured
+ * output are supported (the gateway fronts tool-calling models), so it satisfies
+ * the capability gate. The AI SDK is loaded lazily on first call.
+ */
+export declare function createGatewayProvider(options?: GatewayProviderOptions): AiProvider;

package/dist/lib/ai/gateway-provider.js

@@ -0,0 +1,73 @@
+import { DEFAULT_ANTHROPIC_MODEL } from './anthropic-provider.js';
+/** Default gateway model — the direct-Anthropic default, addressed through the gateway. */
+export const DEFAULT_GATEWAY_MODEL = `anthropic/${DEFAULT_ANTHROPIC_MODEL}`;
+/**
+ * Resolve the effective gateway `apiKey` with the apiKey-beats-OIDC foot-gun guards
+ * (pure core; env + warn injected for tests):
+ *   - `undefined` passes through (OIDC / env-var auth applies downstream);
+ *   - blank/whitespace → treated as ABSENT + loud warning (a set key, even an
+ *     empty one, would otherwise silently beat OIDC);
+ *   - a real key while OIDC is also available → kept, with a warning that it wins.
+ */
+export function resolveGatewayApiKey(apiKey, env = typeof process !== 'undefined' ? process.env : {}, warn = (message) => console.warn(message)) {
+    if (apiKey === undefined)
+        return undefined;
+    const trimmed = apiKey.trim();
+    if (trimmed === '') {
+        warn('[elytra-ai] gateway apiKey is blank — ignoring it so AI_GATEWAY_API_KEY/OIDC can apply. ' +
+            'A set apiKey always beats OIDC, even an invalid one.');
+        return undefined;
+    }
+    if (env.VERCEL_OIDC_TOKEN) {
+        warn('[elytra-ai] gateway apiKey is set while Vercel OIDC is also available — the explicit ' +
+            'apiKey wins (even if invalid). Remove it to authenticate via OIDC.');
+    }
+    return trimmed;
+}
+/**
+ * Build a Vercel-AI-Gateway-backed {@link AiProvider}. Tool calling + structured
+ * output are supported (the gateway fronts tool-calling models), so it satisfies
+ * the capability gate. The AI SDK is loaded lazily on first call.
+ */
+export function createGatewayProvider(options = {}) {
+    const model = options.model ?? DEFAULT_GATEWAY_MODEL;
+    const apiKey = resolveGatewayApiKey(options.apiKey);
+    // Lazily construct the SDK language model — no eager import of the AI SDK.
+    async function languageModel() {
+        const { createGateway } = await import('ai');
+        const gateway = createGateway({
+            ...(apiKey !== undefined ? { apiKey } : {}),
+            ...(options.baseURL !== undefined ? { baseURL: options.baseURL } : {}),
+        });
+        return gateway(model);
+    }
+    return {
+        id: 'gateway',
+        model,
+        capabilities: () => ({ toolCalling: true, structuredOutput: true }),
+        languageModel,
+        async generateStructured(request) {
+            const { generateObject, jsonSchema } = await import('ai');
+            const languageModelInstance = await languageModel();
+            const result = await generateObject({
+                model: languageModelInstance,
+                schema: jsonSchema(request.schema),
+                ...(request.schemaName !== undefined ? { schemaName: request.schemaName } : {}),
+                ...(request.schemaDescription !== undefined
+                    ? { schemaDescription: request.schemaDescription }
+                    : {}),
+                ...(request.system !== undefined ? { system: request.system } : {}),
+                prompt: request.prompt,
+            });
+            const usage = result.usage;
+            return {
+                object: result.object,
+                usage: {
+                    ...(usage?.inputTokens !== undefined ? { inputTokens: usage.inputTokens } : {}),
+                    ...(usage?.outputTokens !== undefined ? { outputTokens: usage.outputTokens } : {}),
+                },
+            };
+        },
+    };
+}
+//# sourceMappingURL=gateway-provider.js.map

package/dist/lib/ai/gateway-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-provider.js","sourceRoot":"","sources":["../../../src/lib/ai/gateway-provider.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Vercel AI Gateway provider adapter (EC-334).\n *\n * First-class gateway support so a Vercel-hosted studio runs key-less through the\n * gateway (`AI_GATEWAY_API_KEY` env, or automatic OIDC on Vercel deployments) —\n * covering key-less OIDC, gateway-billed, and BYOK (gateway-dashboard config, no\n * code change) in one integration. Direct `ANTHROPIC_API_KEY` via\n * `createAnthropicProvider` remains the non-Vercel fallback; ratified mount pick\n * order: explicit config wins, then `ANTHROPIC_API_KEY` (direct) →\n * `AI_GATEWAY_API_KEY`/OIDC (gateway) → FakeProvider.\n *\n * Same dependency discipline as the Anthropic provider: `createGateway` is\n * re-exported by `ai` itself (backed by `@ai-sdk/gateway`, already in the\n * dependency graph — zero new install) and loads via dynamic `import()` only, so\n * importing this module (or the barrel) never eagerly loads the SDK.\n *\n * Foot-gun guarded at construction (config validation, fail-loud culture): a SET\n * `apiKey` ALWAYS wins over OIDC, even an invalid one — so a blank/whitespace key\n * (the classic `apiKey: process.env.AI_GATEWAY_API_KEY` with an empty var) is\n * treated as ABSENT with a loud warning instead of silently disabling OIDC, and a\n * real key alongside an available OIDC token warns that the key wins.\n *\n * NOTE: desk-verified only as of EC-334 slice 1 (no gateway key was available) —\n * the model-string availability and OIDC behavior await the consumer proving pass.\n */\n// Type-only (erased at compile) — the runtime SDK loads via dynamic `import()` below.\nimport type { LanguageModel } from 'ai'\nimport type { AiProvider, GenerateStructuredRequest, GenerateStructuredResult } from './types'\nimport { DEFAULT_ANTHROPIC_MODEL } from './anthropic-provider'\n\nexport interface GatewayProviderOptions {\n  /**\n   * Gateway API key (`AI_GATEWAY_API_KEY` / Vercel access token). Omit on Vercel\n   * deployments to use automatic OIDC. A set key always beats OIDC — see the\n   * module doc for the blank-key guard.\n   */\n  apiKey?: string\n  /** Gateway model string, `<provider>/<model>` (default {@link DEFAULT_GATEWAY_MODEL}). */\n  model?: string\n  /** Optional base URL override (defaults to the SDK's gateway endpoint). */\n  baseURL?: string\n}\n\n/** Default gateway model — the direct-Anthropic default, addressed through the gateway. */\nexport const DEFAULT_GATEWAY_MODEL = `anthropic/${DEFAULT_ANTHROPIC_MODEL}`\n\n/**\n * Resolve the effective gateway `apiKey` with the apiKey-beats-OIDC foot-gun guards\n * (pure core; env + warn injected for tests):\n *   - `undefined` passes through (OIDC / env-var auth applies downstream);\n *   - blank/whitespace → treated as ABSENT + loud warning (a set key, even an\n *     empty one, would otherwise silently beat OIDC);\n *   - a real key while OIDC is also available → kept, with a warning that it wins.\n */\nexport function resolveGatewayApiKey(\n  apiKey: string | undefined,\n  env: Record<string, string | undefined> = typeof process !== 'undefined' ? process.env : {},\n  warn: (message: string) => void = (message) => console.warn(message),\n): string | undefined {\n  if (apiKey === undefined) return undefined\n  const trimmed = apiKey.trim()\n  if (trimmed === '') {\n    warn(\n      '[elytra-ai] gateway apiKey is blank — ignoring it so AI_GATEWAY_API_KEY/OIDC can apply. ' +\n        'A set apiKey always beats OIDC, even an invalid one.',\n    )\n    return undefined\n  }\n  if (env.VERCEL_OIDC_TOKEN) {\n    warn(\n      '[elytra-ai] gateway apiKey is set while Vercel OIDC is also available — the explicit ' +\n        'apiKey wins (even if invalid). Remove it to authenticate via OIDC.',\n    )\n  }\n  return trimmed\n}\n\n/** A minimal view of the AI SDK usage object (field names read best-effort). */\ninterface SdkUsage {\n  inputTokens?: number\n  outputTokens?: number\n}\n\n/**\n * Build a Vercel-AI-Gateway-backed {@link AiProvider}. Tool calling + structured\n * output are supported (the gateway fronts tool-calling models), so it satisfies\n * the capability gate. The AI SDK is loaded lazily on first call.\n */\nexport function createGatewayProvider(options: GatewayProviderOptions = {}): AiProvider {\n  const model = options.model ?? DEFAULT_GATEWAY_MODEL\n  const apiKey = resolveGatewayApiKey(options.apiKey)\n\n  // Lazily construct the SDK language model — no eager import of the AI SDK.\n  async function languageModel(): Promise<LanguageModel> {\n    const { createGateway } = await import('ai')\n    const gateway = createGateway({\n      ...(apiKey !== undefined ? { apiKey } : {}),\n      ...(options.baseURL !== undefined ? { baseURL: options.baseURL } : {}),\n    })\n    return gateway(model)\n  }\n\n  return {\n    id: 'gateway',\n    model,\n    capabilities: () => ({ toolCalling: true, structuredOutput: true }),\n    languageModel,\n\n    async generateStructured(\n      request: GenerateStructuredRequest,\n    ): Promise<GenerateStructuredResult> {\n      const { generateObject, jsonSchema } = await import('ai')\n      const languageModelInstance = await languageModel()\n      const result = await generateObject({\n        model: languageModelInstance,\n        schema: jsonSchema(request.schema as Parameters<typeof jsonSchema>[0]),\n        ...(request.schemaName !== undefined ? { schemaName: request.schemaName } : {}),\n        ...(request.schemaDescription !== undefined\n          ? { schemaDescription: request.schemaDescription }\n          : {}),\n        ...(request.system !== undefined ? { system: request.system } : {}),\n        prompt: request.prompt,\n      })\n      const usage = result.usage as SdkUsage | undefined\n      return {\n        object: result.object,\n        usage: {\n          ...(usage?.inputTokens !== undefined ? { inputTokens: usage.inputTokens } : {}),\n          ...(usage?.outputTokens !== undefined ? { outputTokens: usage.outputTokens } : {}),\n        },\n      }\n    },\n  }\n}\n"]}

package/dist/lib/ai/index.d.ts

@@ -26,6 +26,7 @@ export * from './knowledge.js';
 export * from './shape.js';
 export * from './apply-content.js';
 export * from './anthropic-provider.js';
+export * from './gateway-provider.js';
 export * from './fake-provider.js';
 export * from './route.js';
 export * from './route-provider.js';
@@ -33,7 +34,8 @@ export * from './convex-session.js';
 export * from './convex-session-headers.js';
 export * from './node-handler.js';
 export * from './tools.js';
-export * from './create-flow.js';
+export * from './chat-context.js';
+export * from './chat-loop.js';
 export * from './chat-state.js';
 export * from './rich-text-translate.js';
 export * from './translate-document.js';

package/dist/lib/ai/index.js

@@ -26,6 +26,7 @@ export * from './knowledge.js';
 export * from './shape.js';
 export * from './apply-content.js';
 export * from './anthropic-provider.js';
+export * from './gateway-provider.js';
 export * from './fake-provider.js';
 export * from './route.js';
 export * from './route-provider.js';
@@ -33,7 +34,8 @@ export * from './convex-session.js';
 export * from './convex-session-headers.js';
 export * from './node-handler.js';
 export * from './tools.js';
-export * from './create-flow.js';
+export * from './chat-context.js';
+export * from './chat-loop.js';
 export * from './chat-state.js';
 export * from './rich-text-translate.js';
 export * from './translate-document.js';

package/dist/lib/ai/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/ai/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,0BAA0B,CAAA;AAEjD,cAAc,SAAS,CAAA;AACvB,cAAc,UAAU,CAAA;AACxB,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,SAAS,CAAA;AACvB,cAAc,iBAAiB,CAAA;AAC/B,cAAc,sBAAsB,CAAA;AACpC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,SAAS,CAAA;AACvB,cAAc,kBAAkB,CAAA;AAChC,cAAc,kBAAkB,CAAA;AAChC,cAAc,0BAA0B,CAAA;AACxC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,SAAS,CAAA;AACvB,cAAc,eAAe,CAAA;AAC7B,cAAc,cAAc,CAAA;AAC5B,cAAc,uBAAuB,CAAA;AACrC,cAAc,sBAAsB,CAAA","sourcesContent":["/**\n * `@elytracms/studio/lib/ai` — the headless AI platform seam (EC-331, phase 1).\n *\n * Public surface: the config gate, the provider adapters (Anthropic + Fake), the\n * knowledge mechanism, the target-shape derivation, the `applyContentWithShape`\n * engine, the server-route factory, and the provenance seam. No chat UI here.\n *\n * Bundle discipline: nothing exported here statically imports `ai` / `@ai-sdk/*` —\n * only `anthropic-provider` touches them, via dynamic `import()`. So importing this\n * barrel never eagerly loads the AI SDK, and a studio without an `ai` config block\n * (which only references `StudioAiConfig` as a type) reaches none of it. The same\n * discipline keeps `jose` (the session resolver's JWT library) behind a dynamic\n * `import()` in `convex-session`.\n *\n * EC-371 adds the engine-default session gate + mounting kit: the Convex JWT\n * session resolver (server), the matching client header provider, and the Node\n * `(req, res)` bridge. The Vite DEV mount lives in its own entry —\n * `@elytracms/studio/lib/ai/vite` (`createAiDevPlugin`) — because it imports `vite`,\n * a dev-only tool that must stay out of this barrel's dependency edge.\n */\nexport const PACKAGE = '@elytracms/studio/lib/ai'\n\nexport * from './types'\nexport * from './config'\nexport * from './provenance'\nexport * from './knowledge'\nexport * from './shape'\nexport * from './apply-content'\nexport * from './anthropic-provider'\nexport * from './fake-provider'\nexport * from './route'\nexport * from './route-provider'\nexport * from './convex-session'\nexport * from './convex-session-headers'\nexport * from './node-handler'\nexport * from './tools'\nexport * from './create-flow'\nexport * from './chat-state'\nexport * from './rich-text-translate'\nexport * from './translate-document'\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/ai/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,0BAA0B,CAAA;AAEjD,cAAc,SAAS,CAAA;AACvB,cAAc,UAAU,CAAA;AACxB,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,SAAS,CAAA;AACvB,cAAc,iBAAiB,CAAA;AAC/B,cAAc,sBAAsB,CAAA;AACpC,cAAc,oBAAoB,CAAA;AAClC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,SAAS,CAAA;AACvB,cAAc,kBAAkB,CAAA;AAChC,cAAc,kBAAkB,CAAA;AAChC,cAAc,0BAA0B,CAAA;AACxC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,SAAS,CAAA;AACvB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,uBAAuB,CAAA;AACrC,cAAc,sBAAsB,CAAA","sourcesContent":["/**\n * `@elytracms/studio/lib/ai` — the headless AI platform seam (EC-331, phase 1).\n *\n * Public surface: the config gate, the provider adapters (Anthropic + Fake), the\n * knowledge mechanism, the target-shape derivation, the `applyContentWithShape`\n * engine, the server-route factory, and the provenance seam. No chat UI here.\n *\n * Bundle discipline: nothing exported here statically imports `ai` / `@ai-sdk/*` —\n * only `anthropic-provider` touches them, via dynamic `import()`. So importing this\n * barrel never eagerly loads the AI SDK, and a studio without an `ai` config block\n * (which only references `StudioAiConfig` as a type) reaches none of it. The same\n * discipline keeps `jose` (the session resolver's JWT library) behind a dynamic\n * `import()` in `convex-session`.\n *\n * EC-371 adds the engine-default session gate + mounting kit: the Convex JWT\n * session resolver (server), the matching client header provider, and the Node\n * `(req, res)` bridge. The Vite DEV mount lives in its own entry —\n * `@elytracms/studio/lib/ai/vite` (`createAiDevPlugin`) — because it imports `vite`,\n * a dev-only tool that must stay out of this barrel's dependency edge.\n */\nexport const PACKAGE = '@elytracms/studio/lib/ai'\n\nexport * from './types'\nexport * from './config'\nexport * from './provenance'\nexport * from './knowledge'\nexport * from './shape'\nexport * from './apply-content'\nexport * from './anthropic-provider'\nexport * from './gateway-provider'\nexport * from './fake-provider'\nexport * from './route'\nexport * from './route-provider'\nexport * from './convex-session'\nexport * from './convex-session-headers'\nexport * from './node-handler'\nexport * from './tools'\nexport * from './chat-context'\nexport * from './chat-loop'\nexport * from './chat-state'\nexport * from './rich-text-translate'\nexport * from './translate-document'\n"]}

package/dist/lib/ai/node-handler.d.ts

@@ -15,15 +15,24 @@
  * The DEV half (`createAiDevPlugin`, Vite middleware + `ssrLoadModule`) reuses this
  * same bridge — one implementation, both mounts. No platform dependency: the classic
  * `(IncomingMessage, ServerResponse)` signature works on every @vercel/node version
- * and on plain `node:http`. Note it buffers the response body (including the chat
- * stream) — the proven Konditorei behavior; native streaming is EC-334's scope.
+ * and on plain `node:http`.
+ *
+ * EC-334: the RESPONSE side STREAMS — `response.body` reader chunks are piped to
+ * `res.write` as they arrive, so the route's native SSE chat protocol delivers
+ * token-by-token through every mount (the previous `arrayBuffer()` buffering would
+ * have erased token streaming). The REQUEST side stays buffered (the route only
+ * ever reads JSON bodies). Ships to every consumer mount — streaming through
+ * Vercel Node functions goes on the post-release live-verify checklist.
  */
 import type { IncomingMessage, ServerResponse } from 'node:http';
 import type { AiRouteHandler } from './types.js';
 /** A Node-mountable request handler (Vercel Node function / `node:http` compatible). */
 export type NodeAiRouteHandler = (req: IncomingMessage, res: ServerResponse) => Promise<void>;
 /**
- * Wrap an {@link AiRouteHandler} as a Node `(req, res)` handler: buffer the body,
- * bridge headers both directions, copy status + payload back.
+ * Wrap an {@link AiRouteHandler} as a Node `(req, res)` handler: buffer the request
+ * body, bridge headers both directions, copy the status back, and STREAM the
+ * response body — each chunk is written as it arrives (EC-334), so SSE token
+ * streaming survives the bridge. A client disconnect cancels the reader so the
+ * handler's stream stops being pulled.
  */
 export declare function toNodeHandler(handler: AiRouteHandler): NodeAiRouteHandler;