@yolk-sdk/emulators 0.1.0-canary.96

package/src/notion.ts

@@ -0,0 +1,210 @@
+/**
+ * Stateful Notion emulator (the `/v1` routes on `https://api.notion.com` at API version
+ * 2025-09-03), built on the upstream `@emulators/core` custom runtime, with a request ledger,
+ * status faults, and an `/_emulate/*` control plane.
+ *
+ * It never imports SDK code: its wire shapes, error envelopes, and default seed are copied as data
+ * from the synthetic Notion conformance fixtures, and every route names the conformance cases it
+ * follows in `notionEmulatorRoutes`. Only the routes those eight cases (with their cleanup) send
+ * are emulated. Response behaviour comes only from the fixtures: anything they do not show answers
+ * one ledgered 400 not-emulated, writes nothing, and uses up no fault. That includes a search
+ * without matches or matching a trashed page, so the read-only leftover lookup fails on a clean
+ * workspace and after the write case (the live runner prints its lookup-failed WARN). Search
+ * considers only the pages whose content the state holds (an implied page never matches) and
+ * refuses a match shown only as a query row. Every route answers only on the recorded origin
+ * `https://api.notion.com` (`fetchOn(origin)` serves it behind a loopback rewrite).
+ *
+ * Request-shape latitude (`/notion`, the only accepted deviations): any bearer value (never
+ * checked or stored); extra request headers; JSON key order; `content-type` media-type
+ * parameters; the order of query parameters; Notion ids with or without dashes, in any case; any
+ * search `query` (looked up in the state); and any `page_size` from 1 to 100 whose page shows
+ * only recorded results (the data source query: 1). `Notion-Version` must be `2025-09-03`.
+ * Everything else (other keys, filters, booleans, sorts, query parameters, another origin,
+ * titles, repeated or missing `page_size`, and cursors not issued for the same list since the
+ * last reset or whose list changed) is not emulated.
+ *
+ * Node-only: `@emulators/core` imports Node builtins, so the core is loaded lazily by
+ * `makeNotionEmulator` (importing this module has no side effects).
+ *
+ * @experimental
+ */
+import { Data, Predicate } from 'effect'
+import {
+  notionApiRoutes,
+  notionEmulatorDrillKnobs,
+  notionEmulatorVersion,
+  type NotionApiEnv,
+  type NotionEmulatorDrills
+} from './notion/api.ts'
+import {
+  buildSeedState,
+  decodeState,
+  type NotionEmulatorSeed,
+  type NotionEmulatorState
+} from './notion/state.ts'
+import type { EmulatorRouteEvidence } from './route-evidence.ts'
+import {
+  StatefulFault,
+  StatefulFaultMatch,
+  checkBooleanDrills,
+  makeStatefulEmulator,
+  routeEvidence,
+  type StatefulCoverage,
+  type StatefulEmulatorApi,
+  type StatefulFaultState,
+  type StatefulInputKind,
+  type StatefulLedgerEntry
+} from './stateful-emulator.ts'
+import { statefulCoreRuntime } from './stateful-core.ts'
+
+export type { EmulatorEvidence, EmulatorRouteEvidence } from './route-evidence.ts'
+
+export { emulatorEvidenceHeader } from './route-evidence.ts'
+
+export {
+  notionEmulatorBasePath,
+  notionEmulatorOrigin,
+  notionEmulatorVersion,
+  type NotionEmulatorDrills
+} from './notion/api.ts'
+
+export {
+  NotionEmulatorBlock,
+  NotionEmulatorBotUser,
+  NotionEmulatorDataSource,
+  NotionEmulatorDatabase,
+  NotionEmulatorImpliedPage,
+  NotionEmulatorPage,
+  NotionEmulatorParent,
+  NotionEmulatorProfile,
+  NotionEmulatorPropertyItems,
+  NotionEmulatorSeed,
+  NotionEmulatorStateSchema,
+  type NotionEmulatorState
+} from './notion/state.ts'
+
+/**
+ * Route evidence manifest: every emulated route, whether it writes, and the conformance cases
+ * whose (currently synthetic, unverified) wire claims it follows. Kept in sync with the handlers
+ * by construction (both come from one route table).
+ */
+export const notionEmulatorRoutes: ReadonlyArray<EmulatorRouteEvidence> =
+  notionApiRoutes.map(routeEvidence)
+
+/**
+ * Optional fault filter; an omitted field matches every request. `method` is the HTTP method;
+ * `path` is the raw request path (ending in `*`, a prefix); `route` is a route template of the
+ * manifest (another value is rejected when the fault is added).
+ */
+export const NotionFaultMatch = StatefulFaultMatch
+
+export type NotionFaultMatch = typeof StatefulFaultMatch.Type
+
+/**
+ * A status fault (400-599): answer matching requests with this status, headers, and body instead
+ * of the route's write, so nothing is written. The body defaults to
+ * `{ error: { type: 'emulator_fault', message } }`; `count` limits how many requests it answers.
+ * Only a request the emulator would answer reaches a fault: a request that is not emulated, by
+ * its shape or by the state, never uses one up.
+ */
+export const NotionFault = StatefulFault
+
+export type NotionFault = StatefulFault
+
+export type NotionFaultState = StatefulFaultState
+
+export type NotionLedgerEntry = StatefulLedgerEntry
+
+export type NotionCoverage = StatefulCoverage
+
+/** Invalid emulator input from the JS API: a seed, a fault, or an option. A programmer error. */
+export class NotionEmulatorInputInvalid extends Data.TaggedError('NotionEmulatorInputInvalid')<{
+  readonly input: StatefulInputKind
+  readonly reason: string
+}> {
+  override get message(): string {
+    return `Invalid Notion emulator ${this.input}: ${this.reason}`
+  }
+}
+
+export type NotionEmulatorOptions = {
+  /** Typed seed; defaults to the fixture entities (`profile: 'default'`). */
+  readonly seed?: NotionEmulatorSeed
+  /** Clock in epoch milliseconds (created page timestamps). Defaults to `Date.now`. */
+  readonly now?: () => number
+  /** Drill knobs (tests only): make the emulator disagree with one conformance claim. */
+  readonly drills?: NotionEmulatorDrills
+}
+
+export type NotionEmulator = StatefulEmulatorApi<NotionEmulatorState, NotionEmulatorSeed>
+
+const inputInvalid = (input: StatefulInputKind, reason: string) =>
+  new NotionEmulatorInputInvalid({ input, reason })
+
+/**
+ * Create a stateful Notion emulator on the `@emulators/core` custom runtime. Each call has its
+ * own state, ledger, and faults. Rejects with `NotionEmulatorInputInvalid` for an invalid seed or
+ * option. Every request needs `Notion-Version: 2025-09-03` (else not emulated). See
+ * `src/stateful-emulator.ts` for the request precedence.
+ */
+export const makeNotionEmulator = async (
+  options: NotionEmulatorOptions = {}
+): Promise<NotionEmulator> => {
+  const initial = buildSeedState(options.seed ?? {})
+
+  if (Predicate.isString(initial)) {
+    throw inputInvalid('seed', initial)
+  }
+
+  checkBooleanDrills(options.drills, notionEmulatorDrillKnobs, inputInvalid)
+
+  const drills = options.drills ?? {}
+
+  const env: NotionApiEnv = {
+    now: options.now ?? (() => Date.now()),
+    drills: {
+      searchRepeatsResults: drills.searchRepeatsResults === true,
+      botUserAsPerson: drills.botUserAsPerson === true,
+      envelopeStatusMismatch: drills.envelopeStatusMismatch === true,
+      omitTitlePlainText: drills.omitTitlePlainText === true,
+      blockCursorRepeats: drills.blockCursorRepeats === true,
+      rejectDoubleEncodedPropertyId: drills.rejectDoubleEncodedPropertyId === true,
+      rowParentAsDatabase: drills.rowParentAsDatabase === true,
+      trashedPageNotFound: drills.trashedPageNotFound === true
+    },
+    cursors: new Map(),
+    propertyCursorCounter: { next: 1 },
+    generation: { current: 0 },
+    firstIssued: new Map()
+  }
+
+  const api = await makeStatefulEmulator<NotionEmulatorState, NotionApiEnv, NotionEmulatorSeed>(
+    {
+      routes: notionApiRoutes,
+      env,
+      initial,
+      buildSeed: buildSeedState,
+      requestProblem: header =>
+        header('notion-version') === notionEmulatorVersion
+          ? undefined
+          : `Notion-Version other than ${notionEmulatorVersion} (the version every fixture sends) is not emulated`,
+      recordHeaders: [{ name: 'notion-version', json: false }],
+      // Cursor values never cross a reset or seed: property cursor numbers keep advancing, and the
+      // generation makes later search and block cursors distinct from earlier ones.
+      clearRuntime: () => {
+        env.cursors.clear()
+        env.generation.current += 1
+      },
+      runtimeState: () => ({}),
+      seedSummary: state => ({
+        pages: state.pages.length,
+        blocks: state.blocks.length,
+        dataSources: state.dataSources.length
+      }),
+      inputInvalid
+    },
+    statefulCoreRuntime({ name: 'notion', initial, decodeState, inputInvalid })
+  )
+
+  return api
+}

package/src/openai.ts

@@ -0,0 +1,198 @@
+/**
+ * OpenAI Chat Completions emulator: a plain fetch handler for
+ * `POST /v1/chat/completions` (origin `https://api.openai.com`), with scripted
+ * turns, wire faults, a request ledger, and an `/_emulate/*` control plane.
+ *
+ * It never imports SDK code: its wire shapes follow the synthetic OpenAI chat
+ * conformance fixtures (`chat.completion.chunk` SSE, usage chunk,
+ * `data: [DONE]`, the `chat.completion` JSON body, and the
+ * `{ error: { message, type, param, code } }` envelope) and are linked to
+ * those conformance case ids in `openAiEmulatorRoutes`. The Chat Completions
+ * machinery is shared with the Gateway emulator (`chat-completions.ts`).
+ *
+ * Reasoning models are not emulated yet: no default model streams reasoning,
+ * and scripted turns cannot carry reasoning.
+ *
+ * Runtime-portable Web APIs only (`Request`, `Response`, `ReadableStream`,
+ * `TextEncoder`, `URL`); no Effect runtime is required to use it.
+ *
+ * @experimental
+ */
+import { Data } from 'effect'
+import * as Schema from 'effect/Schema'
+import {
+  ChatFault,
+  ChatFaultMatch,
+  ChatScriptedError,
+  ChatScriptedToolCall,
+  ChatScriptedUsage,
+  chatScriptedCompletionFields,
+  makeChatCompletionsEmulator,
+  type ChatCompletionsEmulator,
+  type ChatCoverage,
+  type ChatFaultKind,
+  type ChatFaultState,
+  type ChatLedgerEntry,
+  type ChatRouteCoverage,
+  type ChatWireError
+} from './chat-completions.ts'
+import type { EmulatorRouteEvidence } from './route-evidence.ts'
+
+export type { EmulatorEvidence, EmulatorRouteEvidence } from './route-evidence.ts'
+
+export { emulatorEvidenceHeader } from './route-evidence.ts'
+
+export const openAiChatCompletionsPath = '/v1/chat/completions'
+
+/** Synthetic-safe default model ids, including the OpenAI chat conformance defaults. */
+export const openAiEmulatorDefaultModels: ReadonlyArray<string> = ['gpt-4.1-nano', 'gpt-4.1-mini']
+
+/**
+ * Route evidence manifest: every emulated OpenAI route and the conformance
+ * cases whose (currently synthetic, unverified) wire shapes it follows.
+ */
+export const openAiEmulatorRoutes: ReadonlyArray<EmulatorRouteEvidence> = [
+  {
+    method: 'POST',
+    path: openAiChatCompletionsPath,
+    kind: 'provider',
+    write: false,
+    caseIds: [
+      'openai.chat.stream.plain-text',
+      'openai.chat.stream.tool-call-deltas',
+      'openai.chat.stream.error-envelope',
+      'openai.chat.json.plain-text'
+    ],
+    evidence: 'unverified',
+    observedAt: undefined
+  }
+]
+
+/** Optional fault filter; an omitted field matches every request. `path` ending in `*` is a prefix. */
+export const OpenAiFaultMatch = ChatFaultMatch
+
+export type OpenAiFaultMatch = ChatFaultMatch
+
+/**
+ * Wire faults for emulated routes, the same kinds as the Gateway emulator:
+ * `status` (the body defaults to an OpenAI error envelope),
+ * `error-after-chunks`, and `truncate-after-chunks`. Statuses that cannot
+ * carry a body and redirects are rejected, as are invalid headers and
+ * `location`. A chunk fault that cannot take effect answers 500 and is not
+ * consumed.
+ */
+export const OpenAiFault = ChatFault
+
+export type OpenAiFault = ChatFault
+
+export type OpenAiFaultKind = ChatFaultKind
+
+/** Usage for a scripted turn (sent as the wire `usage` object). */
+export const OpenAiScriptedUsage = ChatScriptedUsage
+
+export type OpenAiScriptedUsage = ChatScriptedUsage
+
+/** One scripted tool call; its JSON arguments stream as these fragments. */
+export const OpenAiScriptedToolCall = ChatScriptedToolCall
+
+export type OpenAiScriptedToolCall = ChatScriptedToolCall
+
+/**
+ * A scripted completion. Every field is exact (nothing is filled in) except:
+ * `usage` omitted is synthesized when the request asks for usage, and `null`
+ * drops it; `finishReason` omitted is `tool_calls` with tool calls, else
+ * `stop`. Reasoning is not emulated: reasoning fields are rejected.
+ */
+export const OpenAiScriptedCompletion = Schema.Struct(chatScriptedCompletionFields)
+
+export type OpenAiScriptedCompletion = typeof OpenAiScriptedCompletion.Type
+
+/** A scripted error response: status, body (a string is sent as is), and optional headers. */
+export const OpenAiScriptedError = ChatScriptedError
+
+export type OpenAiScriptedError = ChatScriptedError
+
+/** A turn queued for the next chat completion request. */
+export const OpenAiScriptedTurn = Schema.Union([OpenAiScriptedError, OpenAiScriptedCompletion])
+
+export type OpenAiScriptedTurn = typeof OpenAiScriptedTurn.Type
+
+/** Thrown by the JS API (`faults.add`, `script.enqueue`) for invalid input; a programmer error. */
+export class OpenAiEmulatorInputInvalid extends Data.TaggedError('OpenAiEmulatorInputInvalid')<{
+  readonly input: 'fault' | 'turn'
+  readonly reason: string
+}> {
+  override get message(): string {
+    return `Invalid OpenAI emulator ${this.input}: ${this.reason}`
+  }
+}
+
+export type OpenAiLedgerEntry = ChatLedgerEntry
+
+export type OpenAiFaultState = ChatFaultState
+
+export type OpenAiRouteCoverage = ChatRouteCoverage
+
+export type OpenAiCoverage = ChatCoverage
+
+export type OpenAiEmulatorOptions = {
+  /** Model ids that exist. Defaults to `openAiEmulatorDefaultModels`. */
+  readonly knownModels?: ReadonlyArray<string>
+}
+
+export type OpenAiEmulator = ChatCompletionsEmulator<OpenAiScriptedTurn>
+
+const openAiErrorEnvelope = (error: ChatWireError): Schema.Json => ({
+  error: { message: error.message, type: error.type, param: null, code: error.code }
+})
+
+/**
+ * Create an OpenAI Chat Completions emulator. Each call has independent
+ * ledger, fault, and script state.
+ *
+ * Without a script, `POST /v1/chat/completions` answers a known model with
+ * synthetic text deltas (`stream: true`: `chat.completion.chunk` SSE, a finish
+ * chunk, a usage chunk when `stream_options.include_usage` is set, and
+ * `data: [DONE]`; `stream: false`: one `chat.completion` JSON body). A request
+ * with `tools` gets one tool call whose arguments are synthesized from the
+ * tool's JSON Schema and streamed in fragments, finishing with `tool_calls`.
+ * Unknown models get the OpenAI error envelope (404, `model_not_found`); a
+ * missing bearer credential gets a 401 envelope (`invalid_api_key`); unknown
+ * routes get a 404 JSON error. The ledger records the
+ * `max_completion_tokens` limit as `maxCompletionTokens`.
+ *
+ * Precedence per chat request matches the Gateway emulator: authentication and
+ * JSON validation, then the first matching `status` fault, then the next
+ * scripted turn, then model validation and defaults; a first matching chunk
+ * fault then shapes the body. Credential headers are never recorded, and the
+ * bearer value is never checked or stored.
+ */
+export const makeOpenAiEmulator = (options: OpenAiEmulatorOptions = {}): OpenAiEmulator =>
+  makeChatCompletionsEmulator({
+    path: openAiChatCompletionsPath,
+    routes: openAiEmulatorRoutes,
+    knownModels: options.knownModels ?? openAiEmulatorDefaultModels,
+    reasoningModels: undefined,
+    errorEnvelope: openAiErrorEnvelope,
+    // Copied data shape of the synthetic OpenAI error-envelope fixture (unknown model id).
+    unknownModel: {
+      status: 404,
+      error: {
+        message: 'Synthetic placeholder: the requested model does not exist.',
+        type: 'invalid_request_error',
+        code: 'model_not_found'
+      }
+    },
+    auth: {
+      unauthorized: {
+        message: 'Synthetic: missing or invalid API key.',
+        type: 'invalid_request_error',
+        code: 'invalid_api_key'
+      }
+    },
+    completionTokenField: 'max_completion_tokens',
+    responseIdPrefix: 'chatcmpl-synthetic',
+    defaultText: ['Hello', ' from the', ' synthetic OpenAI emulator.'],
+    turnSchema: OpenAiScriptedTurn,
+    inputInvalid: (input, reason) => new OpenAiEmulatorInputInvalid({ input, reason })
+  })

package/src/opencode-recordings.ts

@@ -0,0 +1,257 @@
+/**
+ * OpenCode Go recordings the `/opencode` emulator answers from: one per Go conformance fixture.
+ *
+ * Copied as data from the committed (synthetic, unverified) conformance fixtures; never imported.
+ * `test/fixture-recordings.test.ts` fails when a fixture changes and this copy does not. Internal;
+ * not a package export.
+ */
+import type { FixtureRecording } from './fixture-route.ts'
+
+export const openCodeGoRecordings: ReadonlyArray<FixtureRecording> = [
+  {
+    fixtureId: 'opencode.go.chat.stream.plain-text.synthetic',
+    caseId: 'opencode.go.chat.stream.plain-text',
+    request: {
+      method: 'POST',
+      path: '/zen/go/v1/chat/completions',
+      query: '',
+      headers: {
+        accept: 'text/event-stream',
+        'content-type': 'application/json'
+      },
+      body: {
+        model: 'synthetic-go-chat',
+        messages: [
+          {
+            role: 'system',
+            content: 'Reply in one short sentence.'
+          },
+          {
+            role: 'user',
+            content: 'Say hello.'
+          }
+        ],
+        max_tokens: 64,
+        stream: true,
+        stream_options: {
+          include_usage: true
+        }
+      }
+    },
+    response: {
+      status: 200,
+      headers: {
+        'content-type': 'text/event-stream'
+      },
+      streamed: true,
+      chunks: [
+        'data: {"id":"chatcmpl-synthetic-go-1","object":"chat.completion.chunk","created":1790000000,"model":"synthetic-go-chat","choices":[{"index":0,"delta":{"role":"assistant","content":""},"finish_reason":null}]}\n\n',
+        'data: {"id":"chatcmpl-synthetic-go-1","object":"chat.completion.chunk","created":1790000000,"model":"synthetic-go-chat","choices":[{"index":0,"delta":{"content":"Hello"},"finish_reason":null}]}\n\n',
+        'data: {"id":"chatcmpl-synthetic-go-1","object":"chat.completion.chunk","created":1790000000,"model":"synthetic-go-chat","choices":[{"index":0,',
+        '"delta":{"content":" from the"},"finish_reason":null}]}\n\n',
+        'data: {"id":"chatcmpl-synthetic-go-1","object":"chat.completion.chunk","created":1790000000,"model":"synthetic-go-chat","choices":[{"index":0,"delta":{"content":" synthetic model."},"finish_reason":null}]}\n\n',
+        'data: {"id":"chatcmpl-synthetic-go-1","object":"chat.completion.chunk","created":1790000000,"model":"synthetic-go-chat","choices":[{"index":0,"delta":{},"finish_reason":"stop"}]}\n\n',
+        'data: {"id":"chatcmpl-synthetic-go-1","object":"chat.completion.chunk","created":1790000000,"model":"synthetic-go-chat","choices":[],"usage":{"prompt_tokens":53,"completion_tokens":12,"total_tokens":65}}\n\n',
+        'data: [DONE]\n\n'
+      ]
+    }
+  },
+  {
+    fixtureId: 'opencode.go.messages.stream.plain-text.synthetic',
+    caseId: 'opencode.go.messages.stream.plain-text',
+    request: {
+      method: 'POST',
+      path: '/zen/go/v1/messages',
+      query: '',
+      headers: {
+        accept: 'text/event-stream',
+        'content-type': 'application/json'
+      },
+      body: {
+        model: 'synthetic-go-messages',
+        system: [
+          {
+            type: 'text',
+            text: 'Reply in one short sentence.'
+          }
+        ],
+        messages: [
+          {
+            role: 'user',
+            content: 'Say hello.'
+          }
+        ],
+        max_tokens: 64,
+        stream: true
+      }
+    },
+    response: {
+      status: 200,
+      headers: {
+        'content-type': 'text/event-stream'
+      },
+      streamed: true,
+      chunks: [
+        'event: message_start\ndata: {"type":"message_start","message":{"id":"msg_synthetic_1","type":"message","role":"assistant","model":"synthetic-go-messages","content":[],"stop_reason":null,"stop_sequence":null,"usage":{"input_tokens":45,"cache_creation_input_tokens":0,"cache_read_input_tokens":0,"output_tokens":1}}}\n\n',
+        'event: content_block_start\ndata: {"type":"content_block_start","index":0,"content_block":{"type":"text","text":""}}\n\n',
+        'event: ping\ndata: {"type":"ping"}\n\n',
+        'event: content_block_delta\ndata: {"type":"content_block_delta","index":0,"delta":{"type":"text_delta","text":"Hello"}}\n\n',
+        'event: content_block_delta\ndata: {"type":"content_block_delta","index":0,"delta":{"type":"text_delta",',
+        '"text":" from the"}}\n\n',
+        'event: content_block_delta\ndata: {"type":"content_block_delta","index":0,"delta":{"type":"text_delta","text":" synthetic Anthropic emulator."}}\n\n',
+        'event: content_block_stop\ndata: {"type":"content_block_stop","index":0}\n\n',
+        'event: message_delta\ndata: {"type":"message_delta","delta":{"stop_reason":"end_turn","stop_sequence":null},"usage":{"input_tokens":45,"cache_creation_input_tokens":0,"cache_read_input_tokens":0,"output_tokens":11}}\n\n',
+        'event: message_stop\ndata: {"type":"message_stop"}\n\n'
+      ]
+    }
+  },
+  {
+    fixtureId: 'opencode.go.responses.stream.plain-text.synthetic',
+    caseId: 'opencode.go.responses.stream.plain-text',
+    request: {
+      method: 'POST',
+      path: '/zen/go/v1/responses',
+      query: '',
+      headers: {
+        accept: 'text/event-stream',
+        'content-type': 'application/json'
+      },
+      body: {
+        model: 'synthetic-go-responses',
+        instructions: 'Reply in one short sentence.',
+        input: [
+          {
+            role: 'user',
+            content: 'Say hello.'
+          }
+        ],
+        store: false,
+        stream: true,
+        max_output_tokens: 64
+      }
+    },
+    response: {
+      status: 200,
+      headers: {
+        'content-type': 'text/event-stream'
+      },
+      streamed: true,
+      chunks: [
+        'event: response.created\ndata: {"type":"response.created","sequence_number":0,"response":{"id":"resp_synthetic_1","object":"response","created_at":1790000000,"status":"in_progress","error":null,"incomplete_details":null,"model":"synthetic-go-responses","output":[],"usage":null}}\n\n',
+        'event: response.in_progress\ndata: {"type":"response.in_progress","sequence_number":1,"response":{"id":"resp_synthetic_1","object":"response","created_at":1790000000,"status":"in_progress","error":null,"incomplete_details":null,"model":"synthetic-go-responses","output":[],"usage":null}}\n\n',
+        'event: response.output_item.added\ndata: {"type":"response.output_item.added","sequence_number":2,"output_index":0,"item":{"id":"msg_synthetic_1_0","type":"message","status":"in_progress","role":"assistant","content":[]}}\n\n',
+        'event: response.content_part.added\ndata: {"type":"response.content_part.added","sequence_number":3,"item_id":"msg_synthetic_1_0","output_index":0,"content_index":0,"part":{"type":"output_text","text":"","annotations":[]}}\n\n',
+        'event: response.output_text.delta\ndata: {"type":"response.output_text.delta","sequence_number":4,"item_id":"msg_synthetic_1_0","output_index":0,"content_index":0,"delta":"Hello"}\n\n',
+        'event: response.output_text.delta\ndata: {"type":"response.output_text.delta","sequence_number":5,"item_id":"msg_synthetic_1_0","output_index":0,"content_index":0,',
+        '"delta":" from the"}\n\n',
+        'event: response.output_text.delta\ndata: {"type":"response.output_text.delta","sequence_number":6,"item_id":"msg_synthetic_1_0","output_index":0,"content_index":0,"delta":" synthetic model."}\n\n',
+        'event: response.output_text.done\ndata: {"type":"response.output_text.done","sequence_number":7,"item_id":"msg_synthetic_1_0","output_index":0,"content_index":0,"text":"Hello from the synthetic model."}\n\n',
+        'event: response.content_part.done\ndata: {"type":"response.content_part.done","sequence_number":8,"item_id":"msg_synthetic_1_0","output_index":0,"content_index":0,"part":{"type":"output_text","text":"Hello from the synthetic model.","annotations":[]}}\n\n',
+        'event: response.output_item.done\ndata: {"type":"response.output_item.done","sequence_number":9,"output_index":0,"item":{"id":"msg_synthetic_1_0","type":"message","status":"completed","role":"assistant","content":[{"type":"output_text","text":"Hello from the synthetic model.","annotations":[]}]}}\n\n',
+        'event: response.completed\ndata: {"type":"response.completed","sequence_number":10,"response":{"id":"resp_synthetic_1","object":"response","created_at":1790000000,"status":"completed","error":null,"incomplete_details":null,"model":"synthetic-go-responses","output":[{"id":"msg_synthetic_1_0","type":"message","status":"completed","role":"assistant","content":[{"type":"output_text","text":"Hello from the synthetic model.","annotations":[]}]}],"usage":{"input_tokens":45,"input_tokens_details":{"cached_tokens":0},"output_tokens":12,"output_tokens_details":{"reasoning_tokens":0},"total_tokens":57}}}\n\n'
+      ]
+    }
+  },
+  {
+    fixtureId: 'opencode.go.responses.stream.commentary-replay.synthetic',
+    caseId: 'opencode.go.responses.stream.commentary-replay',
+    request: {
+      method: 'POST',
+      path: '/zen/go/v1/responses',
+      query: '',
+      headers: {
+        accept: 'text/event-stream',
+        'content-type': 'application/json'
+      },
+      body: {
+        model: 'synthetic-go-responses',
+        instructions: 'Reply in one short sentence.',
+        input: [
+          {
+            role: 'user',
+            content: 'What is the weather in Springfield?'
+          },
+          {
+            role: 'assistant',
+            content: 'I will look up the weather first.',
+            phase: 'commentary'
+          },
+          {
+            type: 'function_call',
+            call_id: 'call_synthetic_weather',
+            name: 'lookup_weather',
+            arguments: '{"city":"Springfield"}'
+          },
+          {
+            type: 'function_call_output',
+            call_id: 'call_synthetic_weather',
+            output: 'Sunny and mild.'
+          }
+        ],
+        store: false,
+        stream: true,
+        max_output_tokens: 64,
+        tools: [
+          {
+            type: 'function',
+            name: 'lookup_weather',
+            description: 'Look up the current weather for a city.',
+            parameters: {
+              type: 'object',
+              properties: {
+                city: {
+                  type: 'string'
+                }
+              },
+              required: ['city'],
+              additionalProperties: false
+            }
+          }
+        ],
+        parallel_tool_calls: true
+      }
+    },
+    response: {
+      status: 200,
+      headers: {
+        'content-type': 'text/event-stream'
+      },
+      streamed: true,
+      chunks: [
+        'event: response.created\ndata: {"type":"response.created","sequence_number":0,"response":{"id":"resp_synthetic_1","object":"response","created_at":1790000000,"status":"in_progress","error":null,"incomplete_details":null,"model":"synthetic-go-responses","output":[],"usage":null}}\n\n',
+        'event: response.in_progress\ndata: {"type":"response.in_progress","sequence_number":1,"response":{"id":"resp_synthetic_1","object":"response","created_at":1790000000,"status":"in_progress","error":null,"incomplete_details":null,"model":"synthetic-go-responses","output":[],"usage":null}}\n\n',
+        'event: response.output_item.added\ndata: {"type":"response.output_item.added","sequence_number":2,"output_index":0,"item":{"id":"msg_synthetic_1_0","type":"message","status":"in_progress","role":"assistant","content":[]}}\n\n',
+        'event: response.content_part.added\ndata: {"type":"response.content_part.added","sequence_number":3,"item_id":"msg_synthetic_1_0","output_index":0,"content_index":0,"part":{"type":"output_text","text":"","annotations":[]}}\n\n',
+        'event: response.output_text.delta\ndata: {"type":"response.output_text.delta","sequence_number":4,"item_id":"msg_synthetic_1_0","output_index":0,"content_index":0,"delta":"It is sunny"}\n\n',
+        'event: response.output_text.delta\ndata: {"type":"response.output_text.delta","sequence_number":5,"item_id":"msg_synthetic_1_0","output_index":0,"content_index":0,',
+        '"delta":" and mild in Springfield."}\n\n',
+        'event: response.output_text.done\ndata: {"type":"response.output_text.done","sequence_number":6,"item_id":"msg_synthetic_1_0","output_index":0,"content_index":0,"text":"It is sunny and mild in Springfield."}\n\n',
+        'event: response.content_part.done\ndata: {"type":"response.content_part.done","sequence_number":7,"item_id":"msg_synthetic_1_0","output_index":0,"content_index":0,"part":{"type":"output_text","text":"It is sunny and mild in Springfield.","annotations":[]}}\n\n',
+        'event: response.output_item.done\ndata: {"type":"response.output_item.done","sequence_number":8,"output_index":0,"item":{"id":"msg_synthetic_1_0","type":"message","status":"completed","role":"assistant","content":[{"type":"output_text","text":"It is sunny and mild in Springfield.","annotations":[]}]}}\n\n',
+        'event: response.completed\ndata: {"type":"response.completed","sequence_number":9,"response":{"id":"resp_synthetic_1","object":"response","created_at":1790000000,"status":"completed","error":null,"incomplete_details":null,"model":"synthetic-go-responses","output":[{"id":"msg_synthetic_1_0","type":"message","status":"completed","role":"assistant","content":[{"type":"output_text","text":"It is sunny and mild in Springfield.","annotations":[]}]}],"usage":{"input_tokens":193,"input_tokens_details":{"cached_tokens":0},"output_tokens":9,"output_tokens_details":{"reasoning_tokens":0},"total_tokens":202}}}\n\n'
+      ]
+    }
+  },
+  {
+    fixtureId: 'opencode.go.usage.snapshot.synthetic',
+    caseId: 'opencode.go.usage.snapshot',
+    request: {
+      method: 'GET',
+      path: '/zen/go/v1/usage',
+      query: '',
+      headers: {
+        accept: 'application/json'
+      }
+    },
+    response: {
+      status: 200,
+      headers: {
+        'content-type': 'application/json'
+      },
+      streamed: false,
+      chunks: [
+        '{"usage":{"rolling":{"percent":12.5,"resetsAt":"2026-10-01T03:00:00.000Z"},"weekly":{"percent":40,"resetsAt":"2026-10-05T00:00:00.000Z"},"monthly":{"percent":55,"resetsAt":"2026-10-31T00:00:00.000Z"}}}'
+      ]
+    }
+  }
+]