@yolk-sdk/emulators 0.1.0-canary.96

package/dist/xai.mjs

@@ -0,0 +1,252 @@
+import { emulatorEvidenceHeader } from "./route-evidence.mjs";
+import { EmulatorFaultMatch, EmulatorScriptedError } from "./emulator-kernel.mjs";
+import { withSubscriptionUsage } from "./emulator-compose.mjs";
+import { SubscriptionUsageFault, makeSubscriptionUsageEmulator, recordedUsageBody } from "./subscription-usage.mjs";
+import { xAiGrokUsageRecording } from "./subscription-usage-recordings.mjs";
+import { ResponsesErrorEventFault, ResponsesFault, ResponsesScriptedFunctionCall, ResponsesScriptedResponse, ResponsesScriptedTurn, ResponsesScriptedUsage, ResponsesStreamError, makeResponsesEmulator } from "./responses.mjs";
+import { Data } from "effect";
+//#region src/xai.ts
+/**
+* xAI Grok CLI proxy Responses emulator: a plain fetch handler for `POST /v1/responses` (origin
+* `https://cli-chat-proxy.grok.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 Grok Responses conformance
+* fixtures (Responses SSE with typed `event:` names, the `response` JSON body, and the
+* `{ error: { message, type, param, code } }` envelope) and are linked to those conformance case
+* ids in `xAiGrokEmulatorRoutes`. The Responses machinery lives in the internal `responses.ts`
+* core and is shared with the Codex emulator.
+*
+* Requests authenticate with a non-empty `Authorization: Bearer` credential (a Grok OAuth access
+* token) and must also send, in this order, a non-empty `X-XAI-Token-Auth` (401 without it; never
+* recorded or checked), `x-grok-client-version` (426 without it: the proxy version-gates
+* requests), and `x-grok-model-override` (400 without it). The client version and model override
+* are recorded in the ledger; the version value itself is not checked.
+*
+* The same fetch handler also answers the Grok subscription-usage route
+* (`GET /v1/billing?format=credits`, `emulator.usage`) with its own manifest
+* (`xAiGrokSubscriptionUsageEmulatorRoutes`), ledger, faults, and turns; see
+* `makeXAiGrokEmulator`.
+*
+* Runtime-portable Web APIs only (`Request`, `Response`, `ReadableStream`, `TextEncoder`, `URL`);
+* no Effect runtime is required to use it.
+*
+* @experimental
+*/
+const xAiGrokResponsesPath = "/v1/responses";
+/**
+* The Grok subscription-usage path; the SDK fetcher (`xAiGrokSubscriptionUsageUrl`) adds
+* `?format=credits`, the recorded query.
+*/
+const xAiGrokSubscriptionUsagePath = "/v1/billing";
+/**
+* Route evidence manifest of the Grok subscription-usage route (served by the same fetch handler
+* as the Responses route, with its own ledger and coverage). Synthetic, unverified.
+*/
+const xAiGrokSubscriptionUsageEmulatorRoutes = [{
+	method: "GET",
+	path: xAiGrokSubscriptionUsagePath,
+	kind: "provider",
+	write: false,
+	caseIds: ["xai.grok.usage.snapshot"],
+	evidence: "unverified",
+	observedAt: void 0
+}];
+/**
+* The recorded Grok usage body (the synthetic `xai.grok.usage.snapshot` fixture, copied as data):
+* `config.creditUsagePercent` and `config.currentPeriod` `{ type, start, end }`.
+*/
+const xAiGrokSubscriptionUsageDefault = recordedUsageBody(xAiGrokUsageRecording);
+/** Synthetic-safe default model ids, including the Grok conformance defaults. */
+const xAiGrokEmulatorDefaultModels = ["grok-build", "grok-4.6"];
+/**
+* Route evidence manifest: every emulated Grok route and the conformance cases whose (currently
+* synthetic, unverified) wire shapes it follows.
+*/
+const xAiGrokEmulatorRoutes = [{
+	method: "POST",
+	path: xAiGrokResponsesPath,
+	kind: "provider",
+	write: false,
+	caseIds: [
+		"xai.grok.stream.plain-text",
+		"xai.grok.stream.function-call-arguments",
+		"xai.grok.stream.error-envelope",
+		"xai.grok.stream.terminal-event"
+	],
+	evidence: "unverified",
+	observedAt: void 0
+}];
+/** Optional fault filter; an omitted field matches every request. `path` ending in `*` is a prefix. */
+const XAiGrokFaultMatch = EmulatorFaultMatch;
+/** A mid-stream Responses error (`{ code, message }`). */
+const XAiGrokStreamError = ResponsesStreamError;
+/** A mid-stream `error` or `response.failed` event fault, streamed responses only. */
+const XAiGrokErrorEventFault = ResponsesErrorEventFault;
+/**
+* Wire faults: `status` (for example 429 with `retry-after`; the body defaults to the error
+* envelope for the status), `error-after-chunks` (a dropped connection),
+* `truncate-after-chunks` (a clean close, for example before `response.completed`), and
+* `error-event-after-chunks` (a mid-stream `error` or `response.failed` event). Statuses that
+* cannot carry a body and redirects are rejected, as are invalid headers and `location`. A fault
+* that cannot take effect answers 500 and is not consumed.
+*/
+const XAiGrokFault = ResponsesFault;
+/** Usage for a scripted turn (sent in `response.completed` or the JSON body). */
+const XAiGrokScriptedUsage = ResponsesScriptedUsage;
+/** One scripted `function_call` item; its arguments stream as these fragments. */
+const XAiGrokScriptedFunctionCall = ResponsesScriptedFunctionCall;
+/**
+* A scripted response: `reasoning` (summary fragments), `text`, `functionCalls`, `order`,
+* `usage` (`null` drops it), and `format` (`sse` or `json`, default: the request's `stream`).
+*/
+const XAiGrokScriptedResponse = ResponsesScriptedResponse;
+/** A scripted error response: status, body (a string is sent as is), and optional headers. */
+const XAiGrokScriptedError = EmulatorScriptedError;
+/** A turn queued for the next Grok request. */
+const XAiGrokScriptedTurn = ResponsesScriptedTurn;
+/** Thrown by the JS API (`faults.add`, `script.enqueue`) for invalid input; a programmer error. */
+var XAiGrokEmulatorInputInvalid = class extends Data.TaggedError("XAiGrokEmulatorInputInvalid") {
+	get message() {
+		return `Invalid xAI Grok emulator ${this.input}: ${this.reason}`;
+	}
+};
+/** A usage-route fault (`status`, `error-after-chunks`, `truncate-after-chunks`). */
+const XAiGrokUsageFault = SubscriptionUsageFault;
+const errorEnvelope = (error) => ({ error: {
+	message: error.message,
+	type: error.type,
+	param: error.param ?? null,
+	code: error.code
+} });
+/**
+* Create a Grok CLI proxy Responses emulator. Each call has independent ledger, fault, and script
+* state.
+*
+* Without a script, `POST /v1/responses` answers a known model with synthetic output: `stream:
+* true` streams `response.created`, `response.in_progress`, the output items
+* (`response.output_item.added`, their parts and deltas, `response.output_item.done`), and
+* `response.completed` with usage; `stream: false` returns one `response` JSON body. A request
+* whose `reasoning` asks for a `summary` gets a reasoning item first. A request with function
+* `tools` gets one `function_call` item whose arguments are synthesized from the tool's JSON
+* Schema and streamed as `response.function_call_arguments.delta` fragments. Unknown models get
+* 400 `model_not_found`; a request without a bearer credential gets 401 `invalid_api_key`,
+* without `X-XAI-Token-Auth` 401, without `x-grok-client-version` 426, and without
+* `x-grok-model-override` 400; a non-positive `max_output_tokens` gets 400; unknown routes get a
+* 404 envelope. Not enforced: that `x-grok-model-override` matches the body `model`, the client
+* version value, and the output limit itself (recorded as `maxOutputTokens`).
+*
+* `GET /v1/billing?format=credits` is fixture-only: a request with the headers the SDK fetcher
+* sends (a non-empty bearer, `X-XAI-Token-Auth: xai-grok-cli`, a non-empty `x-userid`, a
+* non-empty `x-grok-client-version`, and `x-grok-client-mode: headless`; the bearer, user id, and
+* client-version values are request-shape latitude, and the user id and token-auth are never
+* recorded),
+* `accept: application/json`, and exactly the recorded `format=credits` query gets the recorded
+* body (`xAiGrokSubscriptionUsageDefault`, or a same-shaped `options.subscriptionUsage` / scripted
+* `{ usage }`); anything else answers 400 not-emulated. The client version and mode are recorded.
+* Its ledger, faults, turns, and coverage are `emulator.usage`
+* (control plane `/_emulate/usage/*`); `reset()` and `POST /_emulate/reset` reset both routes.
+*/
+const makeXAiGrokEmulator = (options = {}) => withSubscriptionUsage(makeXAiGrokResponsesEmulator(options), makeXAiGrokUsageEmulator(options), xAiGrokSubscriptionUsagePath);
+const makeXAiGrokUsageEmulator = (options) => makeSubscriptionUsageEmulator({
+	path: xAiGrokSubscriptionUsagePath,
+	routes: xAiGrokSubscriptionUsageEmulatorRoutes,
+	recording: xAiGrokUsageRecording,
+	headers: [
+		{
+			name: "x-xai-token-auth",
+			record: false,
+			accepts: (value) => value === "xai-grok-cli"
+		},
+		{
+			name: "x-userid",
+			record: false
+		},
+		{
+			name: "x-grok-client-version",
+			record: true
+		},
+		{
+			name: "x-grok-client-mode",
+			record: true,
+			accepts: (value) => value === "headless"
+		}
+	],
+	subscriptionUsage: options.subscriptionUsage,
+	inputInvalid: (input, reason) => new XAiGrokEmulatorInputInvalid({
+		input,
+		reason
+	})
+});
+const makeXAiGrokResponsesEmulator = (options) => makeResponsesEmulator({
+	path: xAiGrokResponsesPath,
+	routes: xAiGrokEmulatorRoutes,
+	knownModels: options.knownModels ?? xAiGrokEmulatorDefaultModels,
+	errorEnvelope,
+	unknownModel: {
+		status: 400,
+		error: {
+			message: "Synthetic placeholder: the requested model does not exist.",
+			type: "invalid_request_error",
+			code: "model_not_found",
+			param: "model"
+		}
+	},
+	unauthorized: {
+		message: "Synthetic: missing or invalid bearer credential.",
+		type: "invalid_request_error",
+		code: "invalid_api_key"
+	},
+	headers: [
+		{
+			name: "x-xai-token-auth",
+			record: false,
+			required: {
+				status: 401,
+				error: {
+					message: "Synthetic: the X-XAI-Token-Auth header is required.",
+					type: "invalid_request_error",
+					code: "missing_token_auth"
+				}
+			}
+		},
+		{
+			name: "x-grok-client-version",
+			record: true,
+			required: {
+				status: 426,
+				error: {
+					message: "Synthetic: a supported x-grok-client-version header is required.",
+					type: "invalid_request_error",
+					code: "upgrade_required"
+				}
+			}
+		},
+		{
+			name: "x-grok-model-override",
+			record: true,
+			required: {
+				status: 400,
+				error: {
+					message: "Synthetic: the x-grok-model-override header is required.",
+					type: "invalid_request_error",
+					code: "missing_model_override"
+				}
+			}
+		}
+	],
+	outputTokenLimit: "optional",
+	defaultText: [
+		"Hello",
+		" from the",
+		" synthetic Grok emulator."
+	],
+	inputInvalid: (input, reason) => new XAiGrokEmulatorInputInvalid({
+		input,
+		reason
+	})
+});
+//#endregion
+export { XAiGrokEmulatorInputInvalid, XAiGrokErrorEventFault, XAiGrokFault, XAiGrokFaultMatch, XAiGrokScriptedError, XAiGrokScriptedFunctionCall, XAiGrokScriptedResponse, XAiGrokScriptedTurn, XAiGrokScriptedUsage, XAiGrokStreamError, XAiGrokUsageFault, emulatorEvidenceHeader, makeXAiGrokEmulator, xAiGrokEmulatorDefaultModels, xAiGrokEmulatorRoutes, xAiGrokResponsesPath, xAiGrokSubscriptionUsageDefault, xAiGrokSubscriptionUsageEmulatorRoutes, xAiGrokSubscriptionUsagePath };
+
+//# sourceMappingURL=xai.mjs.map

package/dist/xai.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"xai.mjs","names":[],"sources":["../src/xai.ts"],"sourcesContent":["/**\n * xAI Grok CLI proxy Responses emulator: a plain fetch handler for `POST /v1/responses` (origin\n * `https://cli-chat-proxy.grok.com`), with scripted turns, wire faults, a request ledger, and an\n * `/_emulate/*` control plane.\n *\n * It never imports SDK code: its wire shapes follow the synthetic Grok Responses conformance\n * fixtures (Responses SSE with typed `event:` names, the `response` JSON body, and the\n * `{ error: { message, type, param, code } }` envelope) and are linked to those conformance case\n * ids in `xAiGrokEmulatorRoutes`. The Responses machinery lives in the internal `responses.ts`\n * core and is shared with the Codex emulator.\n *\n * Requests authenticate with a non-empty `Authorization: Bearer` credential (a Grok OAuth access\n * token) and must also send, in this order, a non-empty `X-XAI-Token-Auth` (401 without it; never\n * recorded or checked), `x-grok-client-version` (426 without it: the proxy version-gates\n * requests), and `x-grok-model-override` (400 without it). The client version and model override\n * are recorded in the ledger; the version value itself is not checked.\n *\n * The same fetch handler also answers the Grok subscription-usage route\n * (`GET /v1/billing?format=credits`, `emulator.usage`) with its own manifest\n * (`xAiGrokSubscriptionUsageEmulatorRoutes`), ledger, faults, and turns; see\n * `makeXAiGrokEmulator`.\n *\n * Runtime-portable Web APIs only (`Request`, `Response`, `ReadableStream`, `TextEncoder`, `URL`);\n * no Effect runtime is required to use it.\n *\n * @experimental\n */\nimport { Data } from 'effect'\nimport type * as Schema from 'effect/Schema'\nimport { withSubscriptionUsage } from './emulator-compose.ts'\nimport type {\n  EmulatorCoverage,\n  EmulatorFaultState,\n  EmulatorRouteCoverage\n} from './emulator-kernel.ts'\nimport { EmulatorFaultMatch, EmulatorScriptedError } from './emulator-kernel.ts'\nimport {\n  makeResponsesEmulator,\n  ResponsesErrorEventFault,\n  ResponsesFault,\n  ResponsesScriptedFunctionCall,\n  ResponsesScriptedResponse,\n  ResponsesScriptedTurn,\n  ResponsesScriptedUsage,\n  ResponsesStreamError,\n  type ResponsesEmulator,\n  type ResponsesFaultKind,\n  type ResponsesLedgerEntry,\n  type ResponsesWireError\n} from './responses.ts'\nimport type { EmulatorRouteEvidence } from './route-evidence.ts'\nimport {\n  makeSubscriptionUsageEmulator,\n  recordedUsageBody,\n  SubscriptionUsageFault,\n  type SubscriptionUsageEmulator,\n  type SubscriptionUsageLedgerEntry,\n  type SubscriptionUsageScriptedTurn\n} from './subscription-usage.ts'\nimport { xAiGrokUsageRecording } from './subscription-usage-recordings.ts'\n\nexport type { EmulatorEvidence, EmulatorRouteEvidence } from './route-evidence.ts'\n\nexport { emulatorEvidenceHeader } from './route-evidence.ts'\n\nexport const xAiGrokResponsesPath = '/v1/responses'\n\n/**\n * The Grok subscription-usage path; the SDK fetcher (`xAiGrokSubscriptionUsageUrl`) adds\n * `?format=credits`, the recorded query.\n */\nexport const xAiGrokSubscriptionUsagePath = '/v1/billing'\n\n/**\n * Route evidence manifest of the Grok subscription-usage route (served by the same fetch handler\n * as the Responses route, with its own ledger and coverage). Synthetic, unverified.\n */\nexport const xAiGrokSubscriptionUsageEmulatorRoutes: ReadonlyArray<EmulatorRouteEvidence> = [\n  {\n    method: 'GET',\n    path: xAiGrokSubscriptionUsagePath,\n    kind: 'provider',\n    write: false,\n    caseIds: ['xai.grok.usage.snapshot'],\n    evidence: 'unverified',\n    observedAt: undefined\n  }\n]\n\n/**\n * The recorded Grok usage body (the synthetic `xai.grok.usage.snapshot` fixture, copied as data):\n * `config.creditUsagePercent` and `config.currentPeriod` `{ type, start, end }`.\n */\nexport const xAiGrokSubscriptionUsageDefault: Schema.Json = recordedUsageBody(xAiGrokUsageRecording)\n\n/** Synthetic-safe default model ids, including the Grok conformance defaults. */\nexport const xAiGrokEmulatorDefaultModels: ReadonlyArray<string> = ['grok-build', 'grok-4.6']\n\n/**\n * Route evidence manifest: every emulated Grok route and the conformance cases whose (currently\n * synthetic, unverified) wire shapes it follows.\n */\nexport const xAiGrokEmulatorRoutes: ReadonlyArray<EmulatorRouteEvidence> = [\n  {\n    method: 'POST',\n    path: xAiGrokResponsesPath,\n    kind: 'provider',\n    write: false,\n    caseIds: [\n      'xai.grok.stream.plain-text',\n      'xai.grok.stream.function-call-arguments',\n      'xai.grok.stream.error-envelope',\n      'xai.grok.stream.terminal-event'\n    ],\n    evidence: 'unverified',\n    observedAt: undefined\n  }\n]\n\n/** Optional fault filter; an omitted field matches every request. `path` ending in `*` is a prefix. */\nexport const XAiGrokFaultMatch = EmulatorFaultMatch\n\nexport type XAiGrokFaultMatch = typeof EmulatorFaultMatch.Type\n\n/** A mid-stream Responses error (`{ code, message }`). */\nexport const XAiGrokStreamError = ResponsesStreamError\n\nexport type XAiGrokStreamError = ResponsesStreamError\n\n/** A mid-stream `error` or `response.failed` event fault, streamed responses only. */\nexport const XAiGrokErrorEventFault = ResponsesErrorEventFault\n\nexport type XAiGrokErrorEventFault = typeof ResponsesErrorEventFault.Type\n\n/**\n * Wire faults: `status` (for example 429 with `retry-after`; the body defaults to the error\n * envelope for the status), `error-after-chunks` (a dropped connection),\n * `truncate-after-chunks` (a clean close, for example before `response.completed`), and\n * `error-event-after-chunks` (a mid-stream `error` or `response.failed` event). Statuses that\n * cannot carry a body and redirects are rejected, as are invalid headers and `location`. A fault\n * that cannot take effect answers 500 and is not consumed.\n */\nexport const XAiGrokFault = ResponsesFault\n\nexport type XAiGrokFault = ResponsesFault\n\nexport type XAiGrokFaultKind = ResponsesFaultKind\n\n/** Usage for a scripted turn (sent in `response.completed` or the JSON body). */\nexport const XAiGrokScriptedUsage = ResponsesScriptedUsage\n\nexport type XAiGrokScriptedUsage = ResponsesScriptedUsage\n\n/** One scripted `function_call` item; its arguments stream as these fragments. */\nexport const XAiGrokScriptedFunctionCall = ResponsesScriptedFunctionCall\n\nexport type XAiGrokScriptedFunctionCall = ResponsesScriptedFunctionCall\n\n/**\n * A scripted response: `reasoning` (summary fragments), `text`, `functionCalls`, `order`,\n * `usage` (`null` drops it), and `format` (`sse` or `json`, default: the request's `stream`).\n */\nexport const XAiGrokScriptedResponse = ResponsesScriptedResponse\n\nexport type XAiGrokScriptedResponse = ResponsesScriptedResponse\n\n/** A scripted error response: status, body (a string is sent as is), and optional headers. */\nexport const XAiGrokScriptedError = EmulatorScriptedError\n\nexport type XAiGrokScriptedError = typeof EmulatorScriptedError.Type\n\n/** A turn queued for the next Grok request. */\nexport const XAiGrokScriptedTurn = ResponsesScriptedTurn\n\nexport type XAiGrokScriptedTurn = ResponsesScriptedTurn\n\n/** Thrown by the JS API (`faults.add`, `script.enqueue`) for invalid input; a programmer error. */\nexport class XAiGrokEmulatorInputInvalid extends Data.TaggedError('XAiGrokEmulatorInputInvalid')<{\n  readonly input: 'fault' | 'turn'\n  readonly reason: string\n}> {\n  override get message(): string {\n    return `Invalid xAI Grok emulator ${this.input}: ${this.reason}`\n  }\n}\n\nexport type XAiGrokLedgerEntry = ResponsesLedgerEntry\n\nexport type XAiGrokFaultState = EmulatorFaultState<XAiGrokFault>\n\nexport type XAiGrokRouteCoverage = EmulatorRouteCoverage\n\nexport type XAiGrokCoverage = EmulatorCoverage\n\n/** A usage-route fault (`status`, `error-after-chunks`, `truncate-after-chunks`). */\nexport const XAiGrokUsageFault = SubscriptionUsageFault\n\nexport type XAiGrokUsageFault = SubscriptionUsageFault\n\n/** A usage turn: `{ usage }` (a body with the recorded JSON shape) or `{ error }`. */\nexport type XAiGrokUsageScriptedTurn = SubscriptionUsageScriptedTurn\n\nexport type XAiGrokUsageLedgerEntry = SubscriptionUsageLedgerEntry\n\nexport type XAiGrokUsageEmulator = SubscriptionUsageEmulator\n\nexport type XAiGrokEmulatorOptions = {\n  /** Model ids that exist. Defaults to `xAiGrokEmulatorDefaultModels`. */\n  readonly knownModels?: ReadonlyArray<string>\n  /**\n   * Replacement usage-route body; must have the recorded JSON shape (same keys and value kinds).\n   * Defaults to the recorded body (`xAiGrokSubscriptionUsageDefault`).\n   */\n  readonly subscriptionUsage?: Schema.Json\n}\n\n/** The Responses emulator, plus `usage`: the subscription-usage route's own emulator API. */\nexport type XAiGrokEmulator = ResponsesEmulator & { readonly usage: XAiGrokUsageEmulator }\n\nconst errorEnvelope = (error: ResponsesWireError): Schema.Json => ({\n  error: {\n    message: error.message,\n    type: error.type,\n    param: error.param ?? null,\n    code: error.code\n  }\n})\n\n/**\n * Create a Grok CLI proxy Responses emulator. Each call has independent ledger, fault, and script\n * state.\n *\n * Without a script, `POST /v1/responses` answers a known model with synthetic output: `stream:\n * true` streams `response.created`, `response.in_progress`, the output items\n * (`response.output_item.added`, their parts and deltas, `response.output_item.done`), and\n * `response.completed` with usage; `stream: false` returns one `response` JSON body. A request\n * whose `reasoning` asks for a `summary` gets a reasoning item first. A request with function\n * `tools` gets one `function_call` item whose arguments are synthesized from the tool's JSON\n * Schema and streamed as `response.function_call_arguments.delta` fragments. Unknown models get\n * 400 `model_not_found`; a request without a bearer credential gets 401 `invalid_api_key`,\n * without `X-XAI-Token-Auth` 401, without `x-grok-client-version` 426, and without\n * `x-grok-model-override` 400; a non-positive `max_output_tokens` gets 400; unknown routes get a\n * 404 envelope. Not enforced: that `x-grok-model-override` matches the body `model`, the client\n * version value, and the output limit itself (recorded as `maxOutputTokens`).\n *\n * `GET /v1/billing?format=credits` is fixture-only: a request with the headers the SDK fetcher\n * sends (a non-empty bearer, `X-XAI-Token-Auth: xai-grok-cli`, a non-empty `x-userid`, a\n * non-empty `x-grok-client-version`, and `x-grok-client-mode: headless`; the bearer, user id, and\n * client-version values are request-shape latitude, and the user id and token-auth are never\n * recorded),\n * `accept: application/json`, and exactly the recorded `format=credits` query gets the recorded\n * body (`xAiGrokSubscriptionUsageDefault`, or a same-shaped `options.subscriptionUsage` / scripted\n * `{ usage }`); anything else answers 400 not-emulated. The client version and mode are recorded.\n * Its ledger, faults, turns, and coverage are `emulator.usage`\n * (control plane `/_emulate/usage/*`); `reset()` and `POST /_emulate/reset` reset both routes.\n */\nexport const makeXAiGrokEmulator = (options: XAiGrokEmulatorOptions = {}): XAiGrokEmulator =>\n  withSubscriptionUsage(\n    makeXAiGrokResponsesEmulator(options),\n    makeXAiGrokUsageEmulator(options),\n    xAiGrokSubscriptionUsagePath\n  )\n\nconst makeXAiGrokUsageEmulator = (options: XAiGrokEmulatorOptions): XAiGrokUsageEmulator =>\n  makeSubscriptionUsageEmulator({\n    path: xAiGrokSubscriptionUsagePath,\n    routes: xAiGrokSubscriptionUsageEmulatorRoutes,\n    recording: xAiGrokUsageRecording,\n    headers: [\n      { name: 'x-xai-token-auth', record: false, accepts: value => value === 'xai-grok-cli' },\n      { name: 'x-userid', record: false },\n      { name: 'x-grok-client-version', record: true },\n      { name: 'x-grok-client-mode', record: true, accepts: value => value === 'headless' }\n    ],\n    subscriptionUsage: options.subscriptionUsage,\n    inputInvalid: (input, reason) => new XAiGrokEmulatorInputInvalid({ input, reason })\n  })\n\nconst makeXAiGrokResponsesEmulator = (options: XAiGrokEmulatorOptions): ResponsesEmulator =>\n  makeResponsesEmulator({\n    path: xAiGrokResponsesPath,\n    routes: xAiGrokEmulatorRoutes,\n    knownModels: options.knownModels ?? xAiGrokEmulatorDefaultModels,\n    errorEnvelope,\n    // Copied data shape of the synthetic Grok error-envelope fixture (unknown model id).\n    unknownModel: {\n      status: 400,\n      error: {\n        message: 'Synthetic placeholder: the requested model does not exist.',\n        type: 'invalid_request_error',\n        code: 'model_not_found',\n        param: 'model'\n      }\n    },\n    unauthorized: {\n      message: 'Synthetic: missing or invalid bearer credential.',\n      type: 'invalid_request_error',\n      code: 'invalid_api_key'\n    },\n    headers: [\n      {\n        name: 'x-xai-token-auth',\n        record: false,\n        required: {\n          status: 401,\n          error: {\n            message: 'Synthetic: the X-XAI-Token-Auth header is required.',\n            type: 'invalid_request_error',\n            code: 'missing_token_auth'\n          }\n        }\n      },\n      {\n        name: 'x-grok-client-version',\n        record: true,\n        required: {\n          status: 426,\n          error: {\n            message: 'Synthetic: a supported x-grok-client-version header is required.',\n            type: 'invalid_request_error',\n            code: 'upgrade_required'\n          }\n        }\n      },\n      {\n        name: 'x-grok-model-override',\n        record: true,\n        required: {\n          status: 400,\n          error: {\n            message: 'Synthetic: the x-grok-model-override header is required.',\n            type: 'invalid_request_error',\n            code: 'missing_model_override'\n          }\n        }\n      }\n    ],\n    outputTokenLimit: 'optional',\n    defaultText: ['Hello', ' from the', ' synthetic Grok emulator.'],\n    inputInvalid: (input, reason) => new XAiGrokEmulatorInputInvalid({ input, reason })\n  })\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiEA,MAAa,uBAAuB;;;;;AAMpC,MAAa,+BAA+B;;;;;AAM5C,MAAa,yCAA+E,CAC1F;CACE,QAAQ;CACR,MAAM;CACN,MAAM;CACN,OAAO;CACP,SAAS,CAAC,yBAAyB;CACnC,UAAU;CACV,YAAY,KAAA;AACd,CACF;;;;;AAMA,MAAa,kCAA+C,kBAAkB,qBAAqB;;AAGnG,MAAa,+BAAsD,CAAC,cAAc,UAAU;;;;;AAM5F,MAAa,wBAA8D,CACzE;CACE,QAAQ;CACR,MAAM;CACN,MAAM;CACN,OAAO;CACP,SAAS;EACP;EACA;EACA;EACA;CACF;CACA,UAAU;CACV,YAAY,KAAA;AACd,CACF;;AAGA,MAAa,oBAAoB;;AAKjC,MAAa,qBAAqB;;AAKlC,MAAa,yBAAyB;;;;;;;;;AAYtC,MAAa,eAAe;;AAO5B,MAAa,uBAAuB;;AAKpC,MAAa,8BAA8B;;;;;AAQ3C,MAAa,0BAA0B;;AAKvC,MAAa,uBAAuB;;AAKpC,MAAa,sBAAsB;;AAKnC,IAAa,8BAAb,cAAiD,KAAK,YAAY,6BAA6B,EAG5F;CACD,IAAa,UAAkB;EAC7B,OAAO,6BAA6B,KAAK,MAAM,IAAI,KAAK;CAC1D;AACF;;AAWA,MAAa,oBAAoB;AAwBjC,MAAM,iBAAiB,WAA4C,EACjE,OAAO;CACL,SAAS,MAAM;CACf,MAAM,MAAM;CACZ,OAAO,MAAM,SAAS;CACtB,MAAM,MAAM;AACd,EACF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8BA,MAAa,uBAAuB,UAAkC,CAAC,MACrE,sBACE,6BAA6B,OAAO,GACpC,yBAAyB,OAAO,GAChC,4BACF;AAEF,MAAM,4BAA4B,YAChC,8BAA8B;CAC5B,MAAM;CACN,QAAQ;CACR,WAAW;CACX,SAAS;EACP;GAAE,MAAM;GAAoB,QAAQ;GAAO,UAAS,UAAS,UAAU;EAAe;EACtF;GAAE,MAAM;GAAY,QAAQ;EAAM;EAClC;GAAE,MAAM;GAAyB,QAAQ;EAAK;EAC9C;GAAE,MAAM;GAAsB,QAAQ;GAAM,UAAS,UAAS,UAAU;EAAW;CACrF;CACA,mBAAmB,QAAQ;CAC3B,eAAe,OAAO,WAAW,IAAI,4BAA4B;EAAE;EAAO;CAAO,CAAC;AACpF,CAAC;AAEH,MAAM,gCAAgC,YACpC,sBAAsB;CACpB,MAAM;CACN,QAAQ;CACR,aAAa,QAAQ,eAAe;CACpC;CAEA,cAAc;EACZ,QAAQ;EACR,OAAO;GACL,SAAS;GACT,MAAM;GACN,MAAM;GACN,OAAO;EACT;CACF;CACA,cAAc;EACZ,SAAS;EACT,MAAM;EACN,MAAM;CACR;CACA,SAAS;EACP;GACE,MAAM;GACN,QAAQ;GACR,UAAU;IACR,QAAQ;IACR,OAAO;KACL,SAAS;KACT,MAAM;KACN,MAAM;IACR;GACF;EACF;EACA;GACE,MAAM;GACN,QAAQ;GACR,UAAU;IACR,QAAQ;IACR,OAAO;KACL,SAAS;KACT,MAAM;KACN,MAAM;IACR;GACF;EACF;EACA;GACE,MAAM;GACN,QAAQ;GACR,UAAU;IACR,QAAQ;IACR,OAAO;KACL,SAAS;KACT,MAAM;KACN,MAAM;IACR;GACF;EACF;CACF;CACA,kBAAkB;CAClB,aAAa;EAAC;EAAS;EAAa;CAA2B;CAC/D,eAAe,OAAO,WAAW,IAAI,4BAA4B;EAAE;EAAO;CAAO,CAAC;AACpF,CAAC"}

package/package.json

@@ -0,0 +1,157 @@
+{
+  "name": "@yolk-sdk/emulators",
+  "version": "0.1.0-canary.96",
+  "description": "Experimental emulators for outside services: an Effect HttpClient router, Vercel AI Gateway, OpenAI Chat Completions, Anthropic Messages, OpenAI Responses (Codex, xAI Grok), and OpenCode Go fetch-handler emulators with subscription-usage routes, fixture-driven fake EmailClient and R2 (R2Presigner, R2ObjectClient) backends, stateful Fortnox, Microsoft Graph, Dropbox, Notion, Todoist, Telegram, GitHub, Google (Gmail, Calendar, Drive), LinkedIn search (Exa, Enrich Layer), and synthetic MCP emulators, and a loopback Node server.",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/magoz/yolk-sdk.git",
+    "directory": "packages/emulators"
+  },
+  "bugs": {
+    "url": "https://github.com/magoz/yolk-sdk/issues"
+  },
+  "homepage": "https://github.com/magoz/yolk-sdk#readme",
+  "keywords": [
+    "emulators",
+    "conformance",
+    "testing",
+    "http",
+    "effect"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "exports": {
+    "./package.json": "./package.json",
+    "./router": {
+      "types": "./dist/router.d.mts",
+      "import": "./dist/router.mjs",
+      "default": "./dist/router.mjs"
+    },
+    "./gateway": {
+      "types": "./dist/gateway.d.mts",
+      "import": "./dist/gateway.mjs",
+      "default": "./dist/gateway.mjs"
+    },
+    "./openai": {
+      "types": "./dist/openai.d.mts",
+      "import": "./dist/openai.mjs",
+      "default": "./dist/openai.mjs"
+    },
+    "./anthropic": {
+      "types": "./dist/anthropic.d.mts",
+      "import": "./dist/anthropic.mjs",
+      "default": "./dist/anthropic.mjs"
+    },
+    "./codex": {
+      "types": "./dist/codex.d.mts",
+      "import": "./dist/codex.mjs",
+      "default": "./dist/codex.mjs"
+    },
+    "./xai": {
+      "types": "./dist/xai.d.mts",
+      "import": "./dist/xai.mjs",
+      "default": "./dist/xai.mjs"
+    },
+    "./opencode": {
+      "types": "./dist/opencode.d.mts",
+      "import": "./dist/opencode.mjs",
+      "default": "./dist/opencode.mjs"
+    },
+    "./email": {
+      "types": "./dist/email.d.mts",
+      "import": "./dist/email.mjs",
+      "default": "./dist/email.mjs"
+    },
+    "./r2": {
+      "types": "./dist/r2.d.mts",
+      "import": "./dist/r2.mjs",
+      "default": "./dist/r2.mjs"
+    },
+    "./node": {
+      "types": "./dist/node.d.mts",
+      "import": "./dist/node.mjs",
+      "default": "./dist/node.mjs"
+    },
+    "./fortnox": {
+      "types": "./dist/fortnox.d.mts",
+      "import": "./dist/fortnox.mjs",
+      "default": "./dist/fortnox.mjs"
+    },
+    "./microsoft": {
+      "types": "./dist/microsoft.d.mts",
+      "import": "./dist/microsoft.mjs",
+      "default": "./dist/microsoft.mjs"
+    },
+    "./dropbox": {
+      "types": "./dist/dropbox.d.mts",
+      "import": "./dist/dropbox.mjs",
+      "default": "./dist/dropbox.mjs"
+    },
+    "./notion": {
+      "types": "./dist/notion.d.mts",
+      "import": "./dist/notion.mjs",
+      "default": "./dist/notion.mjs"
+    },
+    "./todoist": {
+      "types": "./dist/todoist.d.mts",
+      "import": "./dist/todoist.mjs",
+      "default": "./dist/todoist.mjs"
+    },
+    "./telegram": {
+      "types": "./dist/telegram.d.mts",
+      "import": "./dist/telegram.mjs",
+      "default": "./dist/telegram.mjs"
+    },
+    "./github": {
+      "types": "./dist/github.d.mts",
+      "import": "./dist/github.mjs",
+      "default": "./dist/github.mjs"
+    },
+    "./google": {
+      "types": "./dist/google.d.mts",
+      "import": "./dist/google.mjs",
+      "default": "./dist/google.mjs"
+    },
+    "./linkedin-search": {
+      "types": "./dist/linkedin-search.d.mts",
+      "import": "./dist/linkedin-search.mjs",
+      "default": "./dist/linkedin-search.mjs"
+    },
+    "./mcp": {
+      "types": "./dist/mcp.d.mts",
+      "import": "./dist/mcp.mjs",
+      "default": "./dist/mcp.mjs"
+    }
+  },
+  "files": [
+    "src/**/*.ts",
+    "!src/**/*.test.ts",
+    "!src/**/*.test.tsx",
+    "dist/**/*",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "dependencies": {
+    "@emulators/core": "0.12.0",
+    "effect": "4.0.0-rc.115"
+  },
+  "devDependencies": {
+    "@yolk-sdk/agent": "^0.1.0-canary.96",
+    "@yolk-sdk/connectors": "^0.1.0-canary.96",
+    "@yolk-sdk/conformance": "^0.1.0-canary.96",
+    "@yolk-sdk/mcp": "^0.1.0-canary.96"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "check": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "test:run": "vitest run --passWithNoTests"
+  }
+}