@copilotkit/aimock 1.7.0

package/dist/suite.cjs

@@ -0,0 +1,46 @@
+const require_a2a_mock = require('./a2a-mock.cjs');
+const require_llmock = require('./llmock.cjs');
+const require_mcp_mock = require('./mcp-mock.cjs');
+const require_vector_mock = require('./vector-mock.cjs');
+
+//#region src/suite.ts
+async function createMockSuite(options = {}) {
+	const llm = new require_llmock.LLMock(options.llm);
+	let mcp;
+	let a2a;
+	let vector;
+	if (options.mcp) {
+		mcp = new require_mcp_mock.MCPMock(options.mcp);
+		llm.mount("/mcp", mcp);
+	}
+	if (options.a2a) {
+		a2a = new require_a2a_mock.A2AMock(options.a2a);
+		llm.mount("/a2a", a2a);
+	}
+	if (options.vector) {
+		vector = new require_vector_mock.VectorMock(options.vector);
+		llm.mount("/vector", vector);
+	}
+	return {
+		llm,
+		mcp,
+		a2a,
+		vector,
+		async start() {
+			await llm.start();
+		},
+		async stop() {
+			await llm.stop();
+		},
+		reset() {
+			llm.reset();
+			if (mcp) mcp.reset();
+			if (a2a) a2a.reset();
+			if (vector) vector.reset();
+		}
+	};
+}
+
+//#endregion
+exports.createMockSuite = createMockSuite;
+//# sourceMappingURL=suite.cjs.map

package/dist/suite.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"suite.cjs","names":["LLMock","MCPMock","A2AMock","VectorMock"],"sources":["../src/suite.ts"],"sourcesContent":["import { LLMock } from \"./llmock.js\";\nimport { MCPMock } from \"./mcp-mock.js\";\nimport { A2AMock } from \"./a2a-mock.js\";\nimport { VectorMock } from \"./vector-mock.js\";\nimport type { MockServerOptions } from \"./types.js\";\nimport type { MCPMockOptions } from \"./mcp-types.js\";\nimport type { A2AMockOptions } from \"./a2a-types.js\";\nimport type { VectorMockOptions } from \"./vector-types.js\";\n\nexport interface MockSuiteOptions {\n  llm?: MockServerOptions;\n  mcp?: MCPMockOptions;\n  a2a?: A2AMockOptions;\n  vector?: VectorMockOptions;\n}\n\nexport interface MockSuite {\n  llm: LLMock;\n  mcp?: MCPMock;\n  a2a?: A2AMock;\n  vector?: VectorMock;\n  start(): Promise<void>;\n  stop(): Promise<void>;\n  reset(): void;\n}\n\nexport async function createMockSuite(options: MockSuiteOptions = {}): Promise<MockSuite> {\n  const llm = new LLMock(options.llm);\n  let mcp: MCPMock | undefined;\n  let a2a: A2AMock | undefined;\n  let vector: VectorMock | undefined;\n\n  if (options.mcp) {\n    mcp = new MCPMock(options.mcp);\n    llm.mount(\"/mcp\", mcp);\n  }\n\n  if (options.a2a) {\n    a2a = new A2AMock(options.a2a);\n    llm.mount(\"/a2a\", a2a);\n  }\n\n  if (options.vector) {\n    vector = new VectorMock(options.vector);\n    llm.mount(\"/vector\", vector);\n  }\n\n  return {\n    llm,\n    mcp,\n    a2a,\n    vector,\n    async start() {\n      await llm.start();\n    },\n    async stop() {\n      await llm.stop();\n    },\n    reset() {\n      llm.reset();\n      if (mcp) mcp.reset();\n      if (a2a) a2a.reset();\n      if (vector) vector.reset();\n    },\n  };\n}\n"],"mappings":";;;;;;AA0BA,eAAsB,gBAAgB,UAA4B,EAAE,EAAsB;CACxF,MAAM,MAAM,IAAIA,sBAAO,QAAQ,IAAI;CACnC,IAAI;CACJ,IAAI;CACJ,IAAI;AAEJ,KAAI,QAAQ,KAAK;AACf,QAAM,IAAIC,yBAAQ,QAAQ,IAAI;AAC9B,MAAI,MAAM,QAAQ,IAAI;;AAGxB,KAAI,QAAQ,KAAK;AACf,QAAM,IAAIC,yBAAQ,QAAQ,IAAI;AAC9B,MAAI,MAAM,QAAQ,IAAI;;AAGxB,KAAI,QAAQ,QAAQ;AAClB,WAAS,IAAIC,+BAAW,QAAQ,OAAO;AACvC,MAAI,MAAM,WAAW,OAAO;;AAG9B,QAAO;EACL;EACA;EACA;EACA;EACA,MAAM,QAAQ;AACZ,SAAM,IAAI,OAAO;;EAEnB,MAAM,OAAO;AACX,SAAM,IAAI,MAAM;;EAElB,QAAQ;AACN,OAAI,OAAO;AACX,OAAI,IAAK,KAAI,OAAO;AACpB,OAAI,IAAK,KAAI,OAAO;AACpB,OAAI,OAAQ,QAAO,OAAO;;EAE7B"}

package/dist/suite.d.cts

@@ -0,0 +1,31 @@
+import { MockServerOptions } from "./types.cjs";
+import { A2AMockOptions } from "./a2a-types.cjs";
+import { A2AMock } from "./a2a-mock.cjs";
+import { LLMock } from "./llmock.cjs";
+import { MCPMockOptions } from "./mcp-types.cjs";
+import { VectorMockOptions } from "./vector-types.cjs";
+import { MCPMock } from "./mcp-mock.cjs";
+import { VectorMock } from "./vector-mock.cjs";
+
+//#region src/suite.d.ts
+interface MockSuiteOptions {
+  llm?: MockServerOptions;
+  mcp?: MCPMockOptions;
+  a2a?: A2AMockOptions;
+  vector?: VectorMockOptions;
+}
+interface MockSuite {
+  llm: LLMock;
+  mcp?: MCPMock;
+  a2a?: A2AMock;
+  vector?: VectorMock;
+  start(): Promise<void>;
+  stop(): Promise<void>;
+  reset(): void;
+}
+declare function createMockSuite(options?: MockSuiteOptions): Promise<MockSuite>;
+//# sourceMappingURL=suite.d.ts.map
+
+//#endregion
+export { MockSuite, MockSuiteOptions, createMockSuite };
+//# sourceMappingURL=suite.d.cts.map

package/dist/suite.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suite.d.cts","names":[],"sources":["../src/suite.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;UASiB,gBAAA;QACT;EADS,GAAA,CAAA,EAET,cAFyB;EAAA,GAAA,CAAA,EAGzB,cAHyB;QACzB,CAAA,EAGG,iBAHH;;AAEA,UAIS,SAAA,CAJT;KACG,EAIJ,MAJI;EAAiB,GAAA,CAAA,EAKpB,OALoB;EAGX,GAAA,CAAA,EAGT,OAHkB;EAAA,MAAA,CAAA,EAIf,UAJe;OACnB,EAAA,EAII,OAJJ,CAAA,IAAA,CAAA;MACC,EAAA,EAIE,OAJF,CAAA,IAAA,CAAA;OACA,EAAA,EAAA,IAAA;;AAEG,iBAKW,eAAA,CALX,OAAA,CAAA,EAKoC,gBALpC,CAAA,EAK4D,OAL5D,CAKoE,SALpE,CAAA"}

package/dist/suite.d.ts

@@ -0,0 +1,31 @@
+import { MockServerOptions } from "./types.js";
+import { A2AMockOptions } from "./a2a-types.js";
+import { A2AMock } from "./a2a-mock.js";
+import { LLMock } from "./llmock.js";
+import { MCPMockOptions } from "./mcp-types.js";
+import { VectorMockOptions } from "./vector-types.js";
+import { MCPMock } from "./mcp-mock.js";
+import { VectorMock } from "./vector-mock.js";
+
+//#region src/suite.d.ts
+interface MockSuiteOptions {
+  llm?: MockServerOptions;
+  mcp?: MCPMockOptions;
+  a2a?: A2AMockOptions;
+  vector?: VectorMockOptions;
+}
+interface MockSuite {
+  llm: LLMock;
+  mcp?: MCPMock;
+  a2a?: A2AMock;
+  vector?: VectorMock;
+  start(): Promise<void>;
+  stop(): Promise<void>;
+  reset(): void;
+}
+declare function createMockSuite(options?: MockSuiteOptions): Promise<MockSuite>;
+//# sourceMappingURL=suite.d.ts.map
+
+//#endregion
+export { MockSuite, MockSuiteOptions, createMockSuite };
+//# sourceMappingURL=suite.d.ts.map

package/dist/suite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suite.d.ts","names":[],"sources":["../src/suite.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;UASiB,gBAAA;QACT;EADS,GAAA,CAAA,EAET,cAFyB;EAAA,GAAA,CAAA,EAGzB,cAHyB;QACzB,CAAA,EAGG,iBAHH;;AAEA,UAIS,SAAA,CAJT;KACG,EAIJ,MAJI;EAAiB,GAAA,CAAA,EAKpB,OALoB;EAGX,GAAA,CAAA,EAGT,OAHkB;EAAA,MAAA,CAAA,EAIf,UAJe;OACnB,EAAA,EAII,OAJJ,CAAA,IAAA,CAAA;MACC,EAAA,EAIE,OAJF,CAAA,IAAA,CAAA;OACA,EAAA,EAAA,IAAA;;AAEG,iBAKW,eAAA,CALX,OAAA,CAAA,EAKoC,gBALpC,CAAA,EAK4D,OAL5D,CAKoE,SALpE,CAAA"}

package/dist/suite.js

@@ -0,0 +1,46 @@
+import { A2AMock } from "./a2a-mock.js";
+import { LLMock } from "./llmock.js";
+import { MCPMock } from "./mcp-mock.js";
+import { VectorMock } from "./vector-mock.js";
+
+//#region src/suite.ts
+async function createMockSuite(options = {}) {
+	const llm = new LLMock(options.llm);
+	let mcp;
+	let a2a;
+	let vector;
+	if (options.mcp) {
+		mcp = new MCPMock(options.mcp);
+		llm.mount("/mcp", mcp);
+	}
+	if (options.a2a) {
+		a2a = new A2AMock(options.a2a);
+		llm.mount("/a2a", a2a);
+	}
+	if (options.vector) {
+		vector = new VectorMock(options.vector);
+		llm.mount("/vector", vector);
+	}
+	return {
+		llm,
+		mcp,
+		a2a,
+		vector,
+		async start() {
+			await llm.start();
+		},
+		async stop() {
+			await llm.stop();
+		},
+		reset() {
+			llm.reset();
+			if (mcp) mcp.reset();
+			if (a2a) a2a.reset();
+			if (vector) vector.reset();
+		}
+	};
+}
+
+//#endregion
+export { createMockSuite };
+//# sourceMappingURL=suite.js.map

package/dist/suite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"suite.js","names":[],"sources":["../src/suite.ts"],"sourcesContent":["import { LLMock } from \"./llmock.js\";\nimport { MCPMock } from \"./mcp-mock.js\";\nimport { A2AMock } from \"./a2a-mock.js\";\nimport { VectorMock } from \"./vector-mock.js\";\nimport type { MockServerOptions } from \"./types.js\";\nimport type { MCPMockOptions } from \"./mcp-types.js\";\nimport type { A2AMockOptions } from \"./a2a-types.js\";\nimport type { VectorMockOptions } from \"./vector-types.js\";\n\nexport interface MockSuiteOptions {\n  llm?: MockServerOptions;\n  mcp?: MCPMockOptions;\n  a2a?: A2AMockOptions;\n  vector?: VectorMockOptions;\n}\n\nexport interface MockSuite {\n  llm: LLMock;\n  mcp?: MCPMock;\n  a2a?: A2AMock;\n  vector?: VectorMock;\n  start(): Promise<void>;\n  stop(): Promise<void>;\n  reset(): void;\n}\n\nexport async function createMockSuite(options: MockSuiteOptions = {}): Promise<MockSuite> {\n  const llm = new LLMock(options.llm);\n  let mcp: MCPMock | undefined;\n  let a2a: A2AMock | undefined;\n  let vector: VectorMock | undefined;\n\n  if (options.mcp) {\n    mcp = new MCPMock(options.mcp);\n    llm.mount(\"/mcp\", mcp);\n  }\n\n  if (options.a2a) {\n    a2a = new A2AMock(options.a2a);\n    llm.mount(\"/a2a\", a2a);\n  }\n\n  if (options.vector) {\n    vector = new VectorMock(options.vector);\n    llm.mount(\"/vector\", vector);\n  }\n\n  return {\n    llm,\n    mcp,\n    a2a,\n    vector,\n    async start() {\n      await llm.start();\n    },\n    async stop() {\n      await llm.stop();\n    },\n    reset() {\n      llm.reset();\n      if (mcp) mcp.reset();\n      if (a2a) a2a.reset();\n      if (vector) vector.reset();\n    },\n  };\n}\n"],"mappings":";;;;;;AA0BA,eAAsB,gBAAgB,UAA4B,EAAE,EAAsB;CACxF,MAAM,MAAM,IAAI,OAAO,QAAQ,IAAI;CACnC,IAAI;CACJ,IAAI;CACJ,IAAI;AAEJ,KAAI,QAAQ,KAAK;AACf,QAAM,IAAI,QAAQ,QAAQ,IAAI;AAC9B,MAAI,MAAM,QAAQ,IAAI;;AAGxB,KAAI,QAAQ,KAAK;AACf,QAAM,IAAI,QAAQ,QAAQ,IAAI;AAC9B,MAAI,MAAM,QAAQ,IAAI;;AAGxB,KAAI,QAAQ,QAAQ;AAClB,WAAS,IAAI,WAAW,QAAQ,OAAO;AACvC,MAAI,MAAM,WAAW,OAAO;;AAG9B,QAAO;EACL;EACA;EACA;EACA;EACA,MAAM,QAAQ;AACZ,SAAM,IAAI,OAAO;;EAEnB,MAAM,OAAO;AACX,SAAM,IAAI,MAAM;;EAElB,QAAQ;AACN,OAAI,OAAO;AACX,OAAI,IAAK,KAAI,OAAO;AACpB,OAAI,IAAK,KAAI,OAAO;AACpB,OAAI,OAAQ,QAAO,OAAO;;EAE7B"}

package/dist/types.d.cts

@@ -0,0 +1,243 @@
+import { Journal } from "./journal.cjs";
+import { Logger } from "./logger.cjs";
+import { MetricsRegistry } from "./metrics.cjs";
+import * as http from "node:http";
+import * as net from "node:net";
+
+//#region src/types.d.ts
+interface Mountable {
+  handleRequest(req: http.IncomingMessage, res: http.ServerResponse, pathname: string): Promise<boolean>;
+  handleUpgrade?(socket: net.Socket, head: Buffer, pathname: string): Promise<boolean>;
+  health?(): {
+    status: string;
+    [key: string]: unknown;
+  };
+  setJournal?(journal: Journal): void;
+  setBaseUrl?(url: string): void;
+  setRegistry?(registry: MetricsRegistry): void;
+}
+interface ContentPart {
+  type: string;
+  text?: string;
+  [key: string]: unknown;
+}
+interface ChatMessage {
+  role: "system" | "user" | "assistant" | "tool";
+  content: string | ContentPart[] | null;
+  name?: string;
+  tool_calls?: ToolCallMessage[];
+  tool_call_id?: string;
+}
+interface ToolCallMessage {
+  id: string;
+  type: "function";
+  function: {
+    name: string;
+    arguments: string;
+  };
+}
+interface ChatCompletionRequest {
+  model: string;
+  messages: ChatMessage[];
+  stream?: boolean;
+  temperature?: number;
+  max_tokens?: number;
+  tools?: ToolDefinition[];
+  tool_choice?: string | object;
+  response_format?: {
+    type: string;
+    [key: string]: unknown;
+  };
+  /** Embedding input text, set by the embeddings handler for fixture matching. */
+  embeddingInput?: string;
+  [key: string]: unknown;
+}
+interface ToolDefinition {
+  type: "function";
+  function: {
+    name: string;
+    description?: string;
+    parameters?: object;
+  };
+}
+interface FixtureMatch {
+  userMessage?: string | RegExp;
+  inputText?: string | RegExp;
+  toolCallId?: string;
+  toolName?: string;
+  model?: string | RegExp;
+  responseFormat?: string;
+  predicate?: (req: ChatCompletionRequest) => boolean;
+  /** Which occurrence of this match to respond to (0-indexed). Undefined means match any. */
+  sequenceIndex?: number;
+}
+interface TextResponse {
+  content: string;
+  reasoning?: string;
+  webSearches?: string[];
+  role?: string;
+  finishReason?: string;
+}
+interface ToolCall {
+  name: string;
+  arguments: string;
+  id?: string;
+}
+interface ToolCallResponse {
+  toolCalls: ToolCall[];
+  finishReason?: string;
+}
+interface ErrorResponse {
+  error: {
+    message: string;
+    type?: string;
+    code?: string;
+  };
+  status?: number;
+}
+interface EmbeddingResponse {
+  embedding: number[];
+}
+type FixtureResponse = TextResponse | ToolCallResponse | ErrorResponse | EmbeddingResponse;
+interface StreamingProfile {
+  ttft?: number;
+  tps?: number;
+  jitter?: number;
+}
+interface ChaosConfig {
+  dropRate?: number;
+  malformedRate?: number;
+  disconnectRate?: number;
+}
+type ChaosAction = "drop" | "malformed" | "disconnect";
+interface Fixture {
+  match: FixtureMatch;
+  response: FixtureResponse;
+  latency?: number;
+  chunkSize?: number;
+  truncateAfterChunks?: number;
+  disconnectAfterMs?: number;
+  streamingProfile?: StreamingProfile;
+  chaos?: ChaosConfig;
+}
+type FixtureOpts = Omit<Fixture, "match" | "response">;
+type EmbeddingFixtureOpts = Pick<FixtureOpts, "latency" | "chaos">;
+interface FixtureFile {
+  fixtures: FixtureFileEntry[];
+}
+interface FixtureFileEntry {
+  match: {
+    userMessage?: string;
+    inputText?: string;
+    toolCallId?: string;
+    toolName?: string;
+    model?: string;
+    responseFormat?: string;
+    sequenceIndex?: number;
+  };
+  response: FixtureResponse;
+  latency?: number;
+  chunkSize?: number;
+  truncateAfterChunks?: number;
+  disconnectAfterMs?: number;
+  streamingProfile?: StreamingProfile;
+  chaos?: ChaosConfig;
+}
+interface JournalEntry {
+  id: string;
+  timestamp: number;
+  method: string;
+  path: string;
+  headers: Record<string, string>;
+  body: ChatCompletionRequest | null;
+  service?: string;
+  response: {
+    status: number;
+    fixture: Fixture | null;
+    interrupted?: boolean;
+    interruptReason?: string;
+    chaosAction?: ChaosAction;
+  };
+}
+interface SSEChunk {
+  id: string;
+  object: "chat.completion.chunk";
+  created: number;
+  model: string;
+  choices: SSEChoice[];
+}
+interface SSEChoice {
+  index: number;
+  delta: SSEDelta;
+  finish_reason: string | null;
+}
+interface SSEDelta {
+  role?: string;
+  content?: string | null;
+  tool_calls?: SSEToolCallDelta[];
+}
+interface SSEToolCallDelta {
+  index: number;
+  id?: string;
+  type?: "function";
+  function?: {
+    name?: string;
+    arguments?: string;
+  };
+}
+interface ChatCompletion {
+  id: string;
+  object: "chat.completion";
+  created: number;
+  model: string;
+  choices: ChatCompletionChoice[];
+  usage: {
+    prompt_tokens: number;
+    completion_tokens: number;
+    total_tokens: number;
+  };
+}
+interface ChatCompletionChoice {
+  index: number;
+  message: ChatCompletionMessage;
+  finish_reason: string;
+}
+interface ChatCompletionMessage {
+  role: "assistant";
+  content: string | null;
+  refusal: string | null;
+  tool_calls?: ToolCallMessage[];
+}
+type RecordProviderKey = "openai" | "anthropic" | "gemini" | "vertexai" | "bedrock" | "azure" | "ollama" | "cohere";
+interface RecordConfig {
+  providers: Partial<Record<RecordProviderKey, string>>;
+  fixturePath?: string;
+}
+interface MockServerOptions {
+  port?: number;
+  host?: string;
+  latency?: number;
+  chunkSize?: number;
+  /** Log verbosity. CLI default is "info"; programmatic default (when omitted) is "silent". */
+  logLevel?: "silent" | "info" | "debug";
+  chaos?: ChaosConfig;
+  /** Enable Prometheus-compatible /metrics endpoint. */
+  metrics?: boolean;
+  /** Strict mode: return 503 instead of 404 when no fixture matches. */
+  strict?: boolean;
+  /** Record-and-replay: proxy unmatched requests to upstream and save fixtures. */
+  record?: RecordConfig;
+}
+interface HandlerDefaults {
+  latency: number;
+  chunkSize: number;
+  logger: Logger;
+  chaos?: ChaosConfig;
+  registry?: MetricsRegistry;
+  record?: RecordConfig;
+  strict?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map
+//#endregion
+export { ChaosAction, ChaosConfig, ChatCompletion, ChatCompletionChoice, ChatCompletionMessage, ChatCompletionRequest, ChatMessage, ContentPart, EmbeddingFixtureOpts, EmbeddingResponse, ErrorResponse, Fixture, FixtureFile, FixtureFileEntry, FixtureMatch, FixtureOpts, FixtureResponse, HandlerDefaults, JournalEntry, MockServerOptions, Mountable, RecordConfig, RecordProviderKey, SSEChoice, SSEChunk, SSEDelta, SSEToolCallDelta, StreamingProfile, TextResponse, ToolCall, ToolCallMessage, ToolCallResponse, ToolDefinition };
+//# sourceMappingURL=types.d.cts.map

package/dist/types.d.cts.map

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

package/dist/types.d.ts

@@ -0,0 +1,243 @@
+import { Journal } from "./journal.js";
+import { Logger } from "./logger.js";
+import { MetricsRegistry } from "./metrics.js";
+import * as http from "node:http";
+import * as net from "node:net";
+
+//#region src/types.d.ts
+interface Mountable {
+  handleRequest(req: http.IncomingMessage, res: http.ServerResponse, pathname: string): Promise<boolean>;
+  handleUpgrade?(socket: net.Socket, head: Buffer, pathname: string): Promise<boolean>;
+  health?(): {
+    status: string;
+    [key: string]: unknown;
+  };
+  setJournal?(journal: Journal): void;
+  setBaseUrl?(url: string): void;
+  setRegistry?(registry: MetricsRegistry): void;
+}
+interface ContentPart {
+  type: string;
+  text?: string;
+  [key: string]: unknown;
+}
+interface ChatMessage {
+  role: "system" | "user" | "assistant" | "tool";
+  content: string | ContentPart[] | null;
+  name?: string;
+  tool_calls?: ToolCallMessage[];
+  tool_call_id?: string;
+}
+interface ToolCallMessage {
+  id: string;
+  type: "function";
+  function: {
+    name: string;
+    arguments: string;
+  };
+}
+interface ChatCompletionRequest {
+  model: string;
+  messages: ChatMessage[];
+  stream?: boolean;
+  temperature?: number;
+  max_tokens?: number;
+  tools?: ToolDefinition[];
+  tool_choice?: string | object;
+  response_format?: {
+    type: string;
+    [key: string]: unknown;
+  };
+  /** Embedding input text, set by the embeddings handler for fixture matching. */
+  embeddingInput?: string;
+  [key: string]: unknown;
+}
+interface ToolDefinition {
+  type: "function";
+  function: {
+    name: string;
+    description?: string;
+    parameters?: object;
+  };
+}
+interface FixtureMatch {
+  userMessage?: string | RegExp;
+  inputText?: string | RegExp;
+  toolCallId?: string;
+  toolName?: string;
+  model?: string | RegExp;
+  responseFormat?: string;
+  predicate?: (req: ChatCompletionRequest) => boolean;
+  /** Which occurrence of this match to respond to (0-indexed). Undefined means match any. */
+  sequenceIndex?: number;
+}
+interface TextResponse {
+  content: string;
+  reasoning?: string;
+  webSearches?: string[];
+  role?: string;
+  finishReason?: string;
+}
+interface ToolCall {
+  name: string;
+  arguments: string;
+  id?: string;
+}
+interface ToolCallResponse {
+  toolCalls: ToolCall[];
+  finishReason?: string;
+}
+interface ErrorResponse {
+  error: {
+    message: string;
+    type?: string;
+    code?: string;
+  };
+  status?: number;
+}
+interface EmbeddingResponse {
+  embedding: number[];
+}
+type FixtureResponse = TextResponse | ToolCallResponse | ErrorResponse | EmbeddingResponse;
+interface StreamingProfile {
+  ttft?: number;
+  tps?: number;
+  jitter?: number;
+}
+interface ChaosConfig {
+  dropRate?: number;
+  malformedRate?: number;
+  disconnectRate?: number;
+}
+type ChaosAction = "drop" | "malformed" | "disconnect";
+interface Fixture {
+  match: FixtureMatch;
+  response: FixtureResponse;
+  latency?: number;
+  chunkSize?: number;
+  truncateAfterChunks?: number;
+  disconnectAfterMs?: number;
+  streamingProfile?: StreamingProfile;
+  chaos?: ChaosConfig;
+}
+type FixtureOpts = Omit<Fixture, "match" | "response">;
+type EmbeddingFixtureOpts = Pick<FixtureOpts, "latency" | "chaos">;
+interface FixtureFile {
+  fixtures: FixtureFileEntry[];
+}
+interface FixtureFileEntry {
+  match: {
+    userMessage?: string;
+    inputText?: string;
+    toolCallId?: string;
+    toolName?: string;
+    model?: string;
+    responseFormat?: string;
+    sequenceIndex?: number;
+  };
+  response: FixtureResponse;
+  latency?: number;
+  chunkSize?: number;
+  truncateAfterChunks?: number;
+  disconnectAfterMs?: number;
+  streamingProfile?: StreamingProfile;
+  chaos?: ChaosConfig;
+}
+interface JournalEntry {
+  id: string;
+  timestamp: number;
+  method: string;
+  path: string;
+  headers: Record<string, string>;
+  body: ChatCompletionRequest | null;
+  service?: string;
+  response: {
+    status: number;
+    fixture: Fixture | null;
+    interrupted?: boolean;
+    interruptReason?: string;
+    chaosAction?: ChaosAction;
+  };
+}
+interface SSEChunk {
+  id: string;
+  object: "chat.completion.chunk";
+  created: number;
+  model: string;
+  choices: SSEChoice[];
+}
+interface SSEChoice {
+  index: number;
+  delta: SSEDelta;
+  finish_reason: string | null;
+}
+interface SSEDelta {
+  role?: string;
+  content?: string | null;
+  tool_calls?: SSEToolCallDelta[];
+}
+interface SSEToolCallDelta {
+  index: number;
+  id?: string;
+  type?: "function";
+  function?: {
+    name?: string;
+    arguments?: string;
+  };
+}
+interface ChatCompletion {
+  id: string;
+  object: "chat.completion";
+  created: number;
+  model: string;
+  choices: ChatCompletionChoice[];
+  usage: {
+    prompt_tokens: number;
+    completion_tokens: number;
+    total_tokens: number;
+  };
+}
+interface ChatCompletionChoice {
+  index: number;
+  message: ChatCompletionMessage;
+  finish_reason: string;
+}
+interface ChatCompletionMessage {
+  role: "assistant";
+  content: string | null;
+  refusal: string | null;
+  tool_calls?: ToolCallMessage[];
+}
+type RecordProviderKey = "openai" | "anthropic" | "gemini" | "vertexai" | "bedrock" | "azure" | "ollama" | "cohere";
+interface RecordConfig {
+  providers: Partial<Record<RecordProviderKey, string>>;
+  fixturePath?: string;
+}
+interface MockServerOptions {
+  port?: number;
+  host?: string;
+  latency?: number;
+  chunkSize?: number;
+  /** Log verbosity. CLI default is "info"; programmatic default (when omitted) is "silent". */
+  logLevel?: "silent" | "info" | "debug";
+  chaos?: ChaosConfig;
+  /** Enable Prometheus-compatible /metrics endpoint. */
+  metrics?: boolean;
+  /** Strict mode: return 503 instead of 404 when no fixture matches. */
+  strict?: boolean;
+  /** Record-and-replay: proxy unmatched requests to upstream and save fixtures. */
+  record?: RecordConfig;
+}
+interface HandlerDefaults {
+  latency: number;
+  chunkSize: number;
+  logger: Logger;
+  chaos?: ChaosConfig;
+  registry?: MetricsRegistry;
+  record?: RecordConfig;
+  strict?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map
+//#endregion
+export { ChaosAction, ChaosConfig, ChatCompletion, ChatCompletionChoice, ChatCompletionMessage, ChatCompletionRequest, ChatMessage, ContentPart, EmbeddingFixtureOpts, EmbeddingResponse, ErrorResponse, Fixture, FixtureFile, FixtureFileEntry, FixtureMatch, FixtureOpts, FixtureResponse, HandlerDefaults, JournalEntry, MockServerOptions, Mountable, RecordConfig, RecordProviderKey, SSEChoice, SSEChunk, SSEDelta, SSEToolCallDelta, StreamingProfile, TextResponse, ToolCall, ToolCallMessage, ToolCallResponse, ToolDefinition };
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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