@copilotkit/aimock 1.10.0 → 1.12.0

package/.claude-plugin/marketplace.json

@@ -9,7 +9,7 @@
       "source": {
         "source": "npm",
         "package": "@copilotkit/aimock",
-        "version": "^1.10.0"
+        "version": "^1.11.0"
       },
       "description": "Fixture authoring skill for @copilotkit/aimock — match fields, response types, embeddings, structured output, sequential responses, streaming physics, agent loop patterns, gotchas, and debugging"
     }

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "llmock",
-  "version": "1.10.0",
+  "version": "1.11.0",
   "description": "Fixture authoring guidance for @copilotkit/aimock",
   "author": {
     "name": "CopilotKit"

package/README.md

@@ -2,7 +2,7 @@
 
 https://github.com/user-attachments/assets/646bf106-0320-41f2-a9b1-5090454830f3
 
-Mock infrastructure for AI application testing — LLM APIs, MCP tools, A2A agents, vector databases, search, rerank, and moderation. One package, one port, zero dependencies.
+Mock infrastructure for AI application testing — LLM APIs, image generation, text-to-speech, transcription, video generation, MCP tools, A2A agents, AG-UI event streams, vector databases, search, rerank, and moderation. One package, one port, zero dependencies.
 
 ## Quick Start
 
@@ -33,6 +33,7 @@ aimock mocks everything your AI app talks to:
 | **LLMock**     | OpenAI, Claude, Gemini, Bedrock, Azure, Vertex AI, Ollama, Cohere | [Providers](https://aimock.copilotkit.dev/docs)     |
 | **MCPMock**    | MCP tools, resources, prompts with session management             | [MCP](https://aimock.copilotkit.dev/mcp-mock)       |
 | **A2AMock**    | Agent-to-agent protocol with SSE streaming                        | [A2A](https://aimock.copilotkit.dev/a2a-mock)       |
+| **AGUIMock**   | AG-UI agent-to-UI event streams for frontend testing              | [AG-UI](https://aimock.copilotkit.dev/agui-mock)    |
 | **VectorMock** | Pinecone, Qdrant, ChromaDB compatible endpoints                   | [Vector](https://aimock.copilotkit.dev/vector-mock) |
 | **Services**   | Tavily search, Cohere rerank, OpenAI moderation                   | [Services](https://aimock.copilotkit.dev/services)  |
 
@@ -42,7 +43,8 @@ Run them all on one port with `npx aimock --config aimock.json`, or use the prog
 
 - **[Record & Replay](https://aimock.copilotkit.dev/record-replay)** — Proxy real APIs, save as fixtures, replay deterministically forever
 - **[11 LLM Providers](https://aimock.copilotkit.dev/docs)** — OpenAI, Claude, Gemini, Bedrock, Azure, Vertex AI, Ollama, Cohere — full streaming support
-- **[MCP / A2A / Vector](https://aimock.copilotkit.dev/mcp-mock)** — Mock every protocol your AI agents use
+- **[Multimedia APIs](https://aimock.copilotkit.dev/images)** — Image generation (DALL-E, Imagen), text-to-speech, audio transcription, video generation
+- **[MCP / A2A / AG-UI / Vector](https://aimock.copilotkit.dev/mcp-mock)** — Mock every protocol your AI agents use
 - **[Chaos Testing](https://aimock.copilotkit.dev/chaos-testing)** — 500 errors, malformed JSON, mid-stream disconnects at any probability
 - **[Drift Detection](https://aimock.copilotkit.dev/drift-detection)** — Daily CI validation against real APIs
 - **[Streaming Physics](https://aimock.copilotkit.dev/streaming-physics)** — Configurable `ttft`, `tps`, and `jitter`

package/dist/a2a-types.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"a2a-types.d.cts","names":[],"sources":["../src/a2a-types.ts"],"sourcesContent":[],"mappings":";UAAiB,cAAA;EAAA,IAAA,CAAA,EAAA,MAAA;EAKA,IAAA,CAAA,EAAA,MAAA;AAQjB;AAKiB,UAbA,kBAAA,CAiBR;EAGQ,IAAA,EAAA,MAAA;EAIL,WAAA,CAAA,EAAA,MAAc;EAAA,OAAA,CAAA,EAAA,MAAA;QACG,CAAA,EArBlB,KAqBkB,CAAA;IACE,EAAA,EAAA,MAAA;IAAO,IAAA,EAAA,MAAA;IAErB,WAAO,CAAA,EAAA,MAAA;IAAA,IAAA,CAAA,EAAA,MAAA,EAAA;;cAIX,CAAA,EAAA;IACF,SAAA,CAAA,EAAA,OAAA;EAAU,CAAA;AAGrB;AAEiB,KA9BL,OAAA,GA8Be;EAAA,IAAA,EAAA,MAAA;;MAGlB,EAAA,OAAA;EAAO,SAAA,CAAA,EAAA,MAAA;AAGhB,CAAA,GAAY;;;;UA/BK,WAAA;;;;SAIR;;UAGQ,eAAA;cACH;;KAGF,cAAA;;SACiB;;;SACE;;;;;UAEd,OAAA;;;;WAGE;;;aACN;WACF;;KAGC,OAAA;UAEK,UAAA;;QAET;SACC;;KAGG,YAAA"}
+{"version":3,"file":"a2a-types.d.cts","names":[],"sources":["../src/a2a-types.ts"],"sourcesContent":[],"mappings":";UAAiB,cAAA;EAAA,IAAA,CAAA,EAAA,MAAA;EAKA,IAAA,CAAA,EAAA,MAAA;AAQjB;AAKiB,UAbA,kBAAA,CAiBD;EAGC,IAAA,EAAA,MAAA;EAIL,WAAA,CAAA,EAAA,MAAc;EAAA,OAAA,CAAA,EAAA,MAAA;QACG,CAAA,EArBlB,KAqBkB,CAAA;IACE,EAAA,EAAA,MAAA;IAAO,IAAA,EAAA,MAAA;IAErB,WAAO,CAAA,EAAA,MAAA;IAAA,IAAA,CAAA,EAAA,MAAA,EAAA;;cAIX,CAAA,EAAA;IACF,SAAA,CAAA,EAAA,OAAA;EAAU,CAAA;AAGrB;AAEiB,KA9BL,OAAA,GA8Be;EAAA,IAAA,EAAA,MAAA;;MAGlB,EAAA,OAAA;EAAO,SAAA,CAAA,EAAA,MAAA;AAGhB,CAAA,GAAY;;;;UA/BK,WAAA;;;;SAIR;;UAGQ,eAAA;cACH;;KAGF,cAAA;;SACiB;;;SACE;;;;;UAEd,OAAA;;;;WAGE;;;aACN;WACF;;KAGC,OAAA;UAEK,UAAA;;QAET;SACC;;KAGG,YAAA"}

package/dist/a2a-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"a2a-types.d.ts","names":[],"sources":["../src/a2a-types.ts"],"sourcesContent":[],"mappings":";UAAiB,cAAA;EAAA,IAAA,CAAA,EAAA,MAAA;EAKA,IAAA,CAAA,EAAA,MAAA;AAQjB;AAKiB,UAbA,kBAAA,CAiBR;EAGQ,IAAA,EAAA,MAAA;EAIL,WAAA,CAAA,EAAA,MAAc;EAAA,OAAA,CAAA,EAAA,MAAA;QACG,CAAA,EArBlB,KAqBkB,CAAA;IACE,EAAA,EAAA,MAAA;IAAO,IAAA,EAAA,MAAA;IAErB,WAAO,CAAA,EAAA,MAAA;IAAA,IAAA,CAAA,EAAA,MAAA,EAAA;;cAIX,CAAA,EAAA;IACF,SAAA,CAAA,EAAA,OAAA;EAAU,CAAA;AAGrB;AAEiB,KA9BL,OAAA,GA8Be;EAAA,IAAA,EAAA,MAAA;;MAGlB,EAAA,OAAA;EAAO,SAAA,CAAA,EAAA,MAAA;AAGhB,CAAA,GAAY;;;;UA/BK,WAAA;;;;SAIR;;UAGQ,eAAA;cACH;;KAGF,cAAA;;SACiB;;;SACE;;;;;UAEd,OAAA;;;;WAGE;;;aACN;WACF;;KAGC,OAAA;UAEK,UAAA;;QAET;SACC;;KAGG,YAAA"}
+{"version":3,"file":"a2a-types.d.ts","names":[],"sources":["../src/a2a-types.ts"],"sourcesContent":[],"mappings":";UAAiB,cAAA;EAAA,IAAA,CAAA,EAAA,MAAA;EAKA,IAAA,CAAA,EAAA,MAAA;AAQjB;AAKiB,UAbA,kBAAA,CAiBD;EAGC,IAAA,EAAA,MAAA;EAIL,WAAA,CAAA,EAAA,MAAc;EAAA,OAAA,CAAA,EAAA,MAAA;QACG,CAAA,EArBlB,KAqBkB,CAAA;IACE,EAAA,EAAA,MAAA;IAAO,IAAA,EAAA,MAAA;IAErB,WAAO,CAAA,EAAA,MAAA;IAAA,IAAA,CAAA,EAAA,MAAA,EAAA;;cAIX,CAAA,EAAA;IACF,SAAA,CAAA,EAAA,OAAA;EAAU,CAAA;AAGrB;AAEiB,KA9BL,OAAA,GA8Be;EAAA,IAAA,EAAA,MAAA;;MAGlB,EAAA,OAAA;EAAO,SAAA,CAAA,EAAA,MAAA;AAGhB,CAAA,GAAY;;;;UA/BK,WAAA;;;;SAIR;;UAGQ,eAAA;cACH;;KAGF,cAAA;;SACiB;;;SACE;;;;;UAEd,OAAA;;;;WAGE;;;aACN;WACF;;KAGC,OAAA;UAEK,UAAA;;QAET;SACC;;KAGG,YAAA"}

package/dist/agui-handler.cjs

@@ -0,0 +1,340 @@
+const require_runtime = require('./_virtual/_rolldown/runtime.cjs');
+let node_crypto = require("node:crypto");
+
+//#region src/agui-handler.ts
+/**
+* Extract the content of the last message with role "user" from the input.
+*/
+function extractLastUserMessage(input) {
+	if (!input.messages || input.messages.length === 0) return "";
+	for (let i = input.messages.length - 1; i >= 0; i--) {
+		const msg = input.messages[i];
+		if (msg.role === "user" && typeof msg.content === "string") return msg.content;
+	}
+	return "";
+}
+/**
+* Check whether an input matches a fixture's match criteria.
+* All specified criteria must pass (AND logic).
+*/
+function matchesFixture(input, match) {
+	if (match.message !== void 0) {
+		const text = extractLastUserMessage(input);
+		if (typeof match.message === "string") {
+			if (!text.includes(match.message)) return false;
+		} else if (!match.message.test(text)) return false;
+	}
+	if (match.toolName !== void 0) {
+		if (!(input.tools ?? []).some((t) => t.name === match.toolName)) return false;
+	}
+	if (match.stateKey !== void 0) {
+		if (input.state === null || input.state === void 0 || typeof input.state !== "object" || !(match.stateKey in input.state)) return false;
+	}
+	if (match.predicate !== void 0) {
+		if (!match.predicate(input)) return false;
+	}
+	return true;
+}
+/**
+* Find the first fixture whose match criteria pass for the given input.
+*/
+function findFixture(input, fixtures) {
+	for (const fixture of fixtures) if (matchesFixture(input, fixture.match)) return fixture;
+	return null;
+}
+function makeRunStarted(opts) {
+	return {
+		type: "RUN_STARTED",
+		threadId: opts?.threadId ?? (0, node_crypto.randomUUID)(),
+		runId: opts?.runId ?? (0, node_crypto.randomUUID)(),
+		...opts?.parentRunId ? { parentRunId: opts.parentRunId } : {}
+	};
+}
+function makeRunFinished(started) {
+	return {
+		type: "RUN_FINISHED",
+		threadId: started.threadId,
+		runId: started.runId
+	};
+}
+/**
+* Build a complete text message response sequence.
+* [RUN_STARTED, TEXT_MESSAGE_START, TEXT_MESSAGE_CONTENT, TEXT_MESSAGE_END, RUN_FINISHED]
+*/
+function buildTextResponse(text, opts) {
+	const started = makeRunStarted(opts);
+	const messageId = (0, node_crypto.randomUUID)();
+	return [
+		started,
+		{
+			type: "TEXT_MESSAGE_START",
+			messageId,
+			role: "assistant"
+		},
+		{
+			type: "TEXT_MESSAGE_CONTENT",
+			messageId,
+			delta: text
+		},
+		{
+			type: "TEXT_MESSAGE_END",
+			messageId
+		},
+		makeRunFinished(started)
+	];
+}
+/**
+* Build a text chunk response (single chunk, no start/end envelope).
+* [RUN_STARTED, TEXT_MESSAGE_CHUNK, RUN_FINISHED]
+*/
+function buildTextChunkResponse(text, opts) {
+	const started = makeRunStarted(opts);
+	return [
+		started,
+		{
+			type: "TEXT_MESSAGE_CHUNK",
+			messageId: (0, node_crypto.randomUUID)(),
+			role: "assistant",
+			delta: text
+		},
+		makeRunFinished(started)
+	];
+}
+/**
+* Build a tool call response sequence.
+* [RUN_STARTED, TOOL_CALL_START, TOOL_CALL_ARGS, TOOL_CALL_END, (TOOL_CALL_RESULT)?, RUN_FINISHED]
+*/
+function buildToolCallResponse(toolName, args, opts) {
+	const started = makeRunStarted(opts);
+	const toolCallId = (0, node_crypto.randomUUID)();
+	const events = [
+		started,
+		{
+			type: "TOOL_CALL_START",
+			toolCallId,
+			toolCallName: toolName
+		},
+		{
+			type: "TOOL_CALL_ARGS",
+			toolCallId,
+			delta: args
+		},
+		{
+			type: "TOOL_CALL_END",
+			toolCallId
+		}
+	];
+	if (opts?.result !== void 0) events.push({
+		type: "TOOL_CALL_RESULT",
+		messageId: (0, node_crypto.randomUUID)(),
+		toolCallId,
+		content: opts.result,
+		role: "tool"
+	});
+	events.push(makeRunFinished(started));
+	return events;
+}
+/**
+* Build a state snapshot response.
+* [RUN_STARTED, STATE_SNAPSHOT, RUN_FINISHED]
+*/
+function buildStateUpdate(snapshot, opts) {
+	const started = makeRunStarted(opts);
+	return [
+		started,
+		{
+			type: "STATE_SNAPSHOT",
+			snapshot
+		},
+		makeRunFinished(started)
+	];
+}
+/**
+* Build a state delta response (JSON Patch).
+* [RUN_STARTED, STATE_DELTA, RUN_FINISHED]
+*/
+function buildStateDelta(patches, opts) {
+	const started = makeRunStarted(opts);
+	return [
+		started,
+		{
+			type: "STATE_DELTA",
+			delta: patches
+		},
+		makeRunFinished(started)
+	];
+}
+/**
+* Build a messages snapshot response.
+* [RUN_STARTED, MESSAGES_SNAPSHOT, RUN_FINISHED]
+*/
+function buildMessagesSnapshot(messages, opts) {
+	const started = makeRunStarted(opts);
+	return [
+		started,
+		{
+			type: "MESSAGES_SNAPSHOT",
+			messages
+		},
+		makeRunFinished(started)
+	];
+}
+/**
+* Build a reasoning response sequence.
+* [RUN_STARTED, REASONING_START, REASONING_MESSAGE_START, REASONING_MESSAGE_CONTENT,
+*  REASONING_MESSAGE_END, REASONING_END, RUN_FINISHED]
+*/
+function buildReasoningResponse(text, opts) {
+	const started = makeRunStarted(opts);
+	const messageId = (0, node_crypto.randomUUID)();
+	return [
+		started,
+		{
+			type: "REASONING_START",
+			messageId
+		},
+		{
+			type: "REASONING_MESSAGE_START",
+			messageId,
+			role: "reasoning"
+		},
+		{
+			type: "REASONING_MESSAGE_CONTENT",
+			messageId,
+			delta: text
+		},
+		{
+			type: "REASONING_MESSAGE_END",
+			messageId
+		},
+		{
+			type: "REASONING_END",
+			messageId
+		},
+		makeRunFinished(started)
+	];
+}
+/**
+* Build an activity snapshot response.
+* [RUN_STARTED, ACTIVITY_SNAPSHOT, RUN_FINISHED]
+*/
+function buildActivityResponse(messageId, activityType, content, opts) {
+	const started = makeRunStarted(opts);
+	return [
+		started,
+		{
+			type: "ACTIVITY_SNAPSHOT",
+			messageId,
+			activityType,
+			content,
+			replace: true
+		},
+		makeRunFinished(started)
+	];
+}
+/**
+* Build an error response.
+* [RUN_STARTED, RUN_ERROR] (no RUN_FINISHED — the run errored)
+*/
+function buildErrorResponse(message, code, opts) {
+	return [makeRunStarted(opts), {
+		type: "RUN_ERROR",
+		message,
+		...code !== void 0 ? { code } : {}
+	}];
+}
+/**
+* Build a step-wrapped text response.
+* [RUN_STARTED, STEP_STARTED, TEXT_MESSAGE_START, TEXT_MESSAGE_CONTENT,
+*  TEXT_MESSAGE_END, STEP_FINISHED, RUN_FINISHED]
+*/
+function buildStepWithText(stepName, text, opts) {
+	const started = makeRunStarted(opts);
+	const messageId = (0, node_crypto.randomUUID)();
+	return [
+		started,
+		{
+			type: "STEP_STARTED",
+			stepName
+		},
+		{
+			type: "TEXT_MESSAGE_START",
+			messageId,
+			role: "assistant"
+		},
+		{
+			type: "TEXT_MESSAGE_CONTENT",
+			messageId,
+			delta: text
+		},
+		{
+			type: "TEXT_MESSAGE_END",
+			messageId
+		},
+		{
+			type: "STEP_FINISHED",
+			stepName
+		},
+		makeRunFinished(started)
+	];
+}
+/**
+* Combine multiple builder outputs into a single run.
+* Strips RUN_STARTED/RUN_FINISHED from each input, wraps all inner events
+* in one RUN_STARTED...RUN_FINISHED pair.
+*/
+function buildCompositeResponse(builderOutputs, opts) {
+	const started = makeRunStarted(opts);
+	const inner = [];
+	for (const events of builderOutputs) for (const event of events) if (event.type !== "RUN_STARTED" && event.type !== "RUN_FINISHED") inner.push(event);
+	return [
+		started,
+		...inner,
+		makeRunFinished(started)
+	];
+}
+/**
+* Write AG-UI events as an SSE stream to an HTTP response.
+* Sets appropriate headers, serializes each event as `data: {...}\n\n`,
+* and optionally delays between events.
+*/
+async function writeAGUIEventStream(res, events, opts) {
+	const delayMs = opts?.delayMs ?? 0;
+	res.writeHead(200, {
+		"Content-Type": "text/event-stream",
+		"Cache-Control": "no-cache",
+		Connection: "keep-alive"
+	});
+	for (const event of events) {
+		if (opts?.signal?.aborted) break;
+		if (res.socket?.destroyed) break;
+		const stamped = {
+			...event,
+			timestamp: Date.now()
+		};
+		try {
+			res.write(`data: ${JSON.stringify(stamped)}\n\n`);
+		} catch {
+			break;
+		}
+		if (delayMs > 0) await new Promise((resolve) => setTimeout(resolve, delayMs));
+	}
+	if (!res.writableEnded) res.end();
+}
+
+//#endregion
+exports.buildActivityResponse = buildActivityResponse;
+exports.buildCompositeResponse = buildCompositeResponse;
+exports.buildErrorResponse = buildErrorResponse;
+exports.buildMessagesSnapshot = buildMessagesSnapshot;
+exports.buildReasoningResponse = buildReasoningResponse;
+exports.buildStateDelta = buildStateDelta;
+exports.buildStateUpdate = buildStateUpdate;
+exports.buildStepWithText = buildStepWithText;
+exports.buildTextChunkResponse = buildTextChunkResponse;
+exports.buildTextResponse = buildTextResponse;
+exports.buildToolCallResponse = buildToolCallResponse;
+exports.extractLastUserMessage = extractLastUserMessage;
+exports.findFixture = findFixture;
+exports.writeAGUIEventStream = writeAGUIEventStream;
+//# sourceMappingURL=agui-handler.cjs.map

package/dist/agui-handler.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"agui-handler.cjs","names":[],"sources":["../src/agui-handler.ts"],"sourcesContent":["// ─── AG-UI Handler ───────────────────────────────────────────────────────────\n//\n// Matching functions, event builders, and SSE writer for AG-UI protocol.\n\nimport * as http from \"node:http\";\nimport { randomUUID } from \"node:crypto\";\n\nimport type {\n  AGUIRunAgentInput,\n  AGUIFixtureMatch,\n  AGUIFixture,\n  AGUIEvent,\n  AGUIMessage,\n  AGUIRunStartedEvent,\n  AGUIRunFinishedEvent,\n  AGUIRunErrorEvent,\n  AGUITextMessageStartEvent,\n  AGUITextMessageContentEvent,\n  AGUITextMessageEndEvent,\n  AGUITextMessageChunkEvent,\n  AGUIToolCallStartEvent,\n  AGUIToolCallArgsEvent,\n  AGUIToolCallEndEvent,\n  AGUIToolCallResultEvent,\n  AGUIStateSnapshotEvent,\n  AGUIStateDeltaEvent,\n  AGUIMessagesSnapshotEvent,\n  AGUIStepStartedEvent,\n  AGUIStepFinishedEvent,\n  AGUIReasoningStartEvent,\n  AGUIReasoningMessageStartEvent,\n  AGUIReasoningMessageContentEvent,\n  AGUIReasoningMessageEndEvent,\n  AGUIReasoningEndEvent,\n  AGUIActivitySnapshotEvent,\n} from \"./agui-types.js\";\n\n// ─── Matching functions ──────────────────────────────────────────────────────\n\n/**\n * Extract the content of the last message with role \"user\" from the input.\n */\nexport function extractLastUserMessage(input: AGUIRunAgentInput): string {\n  if (!input.messages || input.messages.length === 0) return \"\";\n  for (let i = input.messages.length - 1; i >= 0; i--) {\n    const msg = input.messages[i];\n    if (msg.role === \"user\" && typeof msg.content === \"string\") {\n      return msg.content;\n    }\n  }\n  return \"\";\n}\n\n/**\n * Check whether an input matches a fixture's match criteria.\n * All specified criteria must pass (AND logic).\n */\nexport function matchesFixture(input: AGUIRunAgentInput, match: AGUIFixtureMatch): boolean {\n  if (match.message !== undefined) {\n    const text = extractLastUserMessage(input);\n    if (typeof match.message === \"string\") {\n      if (!text.includes(match.message)) return false;\n    } else {\n      if (!match.message.test(text)) return false;\n    }\n  }\n\n  if (match.toolName !== undefined) {\n    const tools = input.tools ?? [];\n    if (!tools.some((t) => t.name === match.toolName)) return false;\n  }\n\n  if (match.stateKey !== undefined) {\n    if (\n      input.state === null ||\n      input.state === undefined ||\n      typeof input.state !== \"object\" ||\n      !(match.stateKey in (input.state as Record<string, unknown>))\n    ) {\n      return false;\n    }\n  }\n\n  if (match.predicate !== undefined) {\n    if (!match.predicate(input)) return false;\n  }\n\n  return true;\n}\n\n/**\n * Find the first fixture whose match criteria pass for the given input.\n */\nexport function findFixture(input: AGUIRunAgentInput, fixtures: AGUIFixture[]): AGUIFixture | null {\n  for (const fixture of fixtures) {\n    if (matchesFixture(input, fixture.match)) {\n      return fixture;\n    }\n  }\n  return null;\n}\n\n// ─── Builder options ─────────────────────────────────────────────────────────\n\nexport interface AGUIBuildOpts {\n  threadId?: string;\n  runId?: string;\n  parentRunId?: string;\n  /** For tool call builder: include a result event */\n  result?: string;\n}\n\n// ─── Event builders ──────────────────────────────────────────────────────────\n\nfunction makeRunStarted(opts?: AGUIBuildOpts): AGUIRunStartedEvent {\n  return {\n    type: \"RUN_STARTED\",\n    threadId: opts?.threadId ?? randomUUID(),\n    runId: opts?.runId ?? randomUUID(),\n    ...(opts?.parentRunId ? { parentRunId: opts.parentRunId } : {}),\n  };\n}\n\nfunction makeRunFinished(started: AGUIRunStartedEvent): AGUIRunFinishedEvent {\n  return {\n    type: \"RUN_FINISHED\",\n    threadId: started.threadId,\n    runId: started.runId,\n  };\n}\n\n/**\n * Build a complete text message response sequence.\n * [RUN_STARTED, TEXT_MESSAGE_START, TEXT_MESSAGE_CONTENT, TEXT_MESSAGE_END, RUN_FINISHED]\n */\nexport function buildTextResponse(text: string, opts?: AGUIBuildOpts): AGUIEvent[] {\n  const started = makeRunStarted(opts);\n  const messageId = randomUUID();\n  return [\n    started,\n    {\n      type: \"TEXT_MESSAGE_START\",\n      messageId,\n      role: \"assistant\",\n    } as AGUITextMessageStartEvent,\n    {\n      type: \"TEXT_MESSAGE_CONTENT\",\n      messageId,\n      delta: text,\n    } as AGUITextMessageContentEvent,\n    {\n      type: \"TEXT_MESSAGE_END\",\n      messageId,\n    } as AGUITextMessageEndEvent,\n    makeRunFinished(started),\n  ];\n}\n\n/**\n * Build a text chunk response (single chunk, no start/end envelope).\n * [RUN_STARTED, TEXT_MESSAGE_CHUNK, RUN_FINISHED]\n */\nexport function buildTextChunkResponse(text: string, opts?: AGUIBuildOpts): AGUIEvent[] {\n  const started = makeRunStarted(opts);\n  return [\n    started,\n    {\n      type: \"TEXT_MESSAGE_CHUNK\",\n      messageId: randomUUID(),\n      role: \"assistant\",\n      delta: text,\n    } as AGUITextMessageChunkEvent,\n    makeRunFinished(started),\n  ];\n}\n\n/**\n * Build a tool call response sequence.\n * [RUN_STARTED, TOOL_CALL_START, TOOL_CALL_ARGS, TOOL_CALL_END, (TOOL_CALL_RESULT)?, RUN_FINISHED]\n */\nexport function buildToolCallResponse(\n  toolName: string,\n  args: string,\n  opts?: AGUIBuildOpts,\n): AGUIEvent[] {\n  const started = makeRunStarted(opts);\n  const toolCallId = randomUUID();\n  const events: AGUIEvent[] = [\n    started,\n    {\n      type: \"TOOL_CALL_START\",\n      toolCallId,\n      toolCallName: toolName,\n    } as AGUIToolCallStartEvent,\n    {\n      type: \"TOOL_CALL_ARGS\",\n      toolCallId,\n      delta: args,\n    } as AGUIToolCallArgsEvent,\n    {\n      type: \"TOOL_CALL_END\",\n      toolCallId,\n    } as AGUIToolCallEndEvent,\n  ];\n\n  if (opts?.result !== undefined) {\n    events.push({\n      type: \"TOOL_CALL_RESULT\",\n      messageId: randomUUID(),\n      toolCallId,\n      content: opts.result,\n      role: \"tool\",\n    } as AGUIToolCallResultEvent);\n  }\n\n  events.push(makeRunFinished(started));\n  return events;\n}\n\n/**\n * Build a state snapshot response.\n * [RUN_STARTED, STATE_SNAPSHOT, RUN_FINISHED]\n */\nexport function buildStateUpdate(snapshot: unknown, opts?: AGUIBuildOpts): AGUIEvent[] {\n  const started = makeRunStarted(opts);\n  return [\n    started,\n    {\n      type: \"STATE_SNAPSHOT\",\n      snapshot,\n    } as AGUIStateSnapshotEvent,\n    makeRunFinished(started),\n  ];\n}\n\n/**\n * Build a state delta response (JSON Patch).\n * [RUN_STARTED, STATE_DELTA, RUN_FINISHED]\n */\nexport function buildStateDelta(patches: unknown[], opts?: AGUIBuildOpts): AGUIEvent[] {\n  const started = makeRunStarted(opts);\n  return [\n    started,\n    {\n      type: \"STATE_DELTA\",\n      delta: patches,\n    } as AGUIStateDeltaEvent,\n    makeRunFinished(started),\n  ];\n}\n\n/**\n * Build a messages snapshot response.\n * [RUN_STARTED, MESSAGES_SNAPSHOT, RUN_FINISHED]\n */\nexport function buildMessagesSnapshot(messages: AGUIMessage[], opts?: AGUIBuildOpts): AGUIEvent[] {\n  const started = makeRunStarted(opts);\n  return [\n    started,\n    {\n      type: \"MESSAGES_SNAPSHOT\",\n      messages,\n    } as AGUIMessagesSnapshotEvent,\n    makeRunFinished(started),\n  ];\n}\n\n/**\n * Build a reasoning response sequence.\n * [RUN_STARTED, REASONING_START, REASONING_MESSAGE_START, REASONING_MESSAGE_CONTENT,\n *  REASONING_MESSAGE_END, REASONING_END, RUN_FINISHED]\n */\nexport function buildReasoningResponse(text: string, opts?: AGUIBuildOpts): AGUIEvent[] {\n  const started = makeRunStarted(opts);\n  const messageId = randomUUID();\n  return [\n    started,\n    {\n      type: \"REASONING_START\",\n      messageId,\n    } as AGUIReasoningStartEvent,\n    {\n      type: \"REASONING_MESSAGE_START\",\n      messageId,\n      role: \"reasoning\",\n    } as AGUIReasoningMessageStartEvent,\n    {\n      type: \"REASONING_MESSAGE_CONTENT\",\n      messageId,\n      delta: text,\n    } as AGUIReasoningMessageContentEvent,\n    {\n      type: \"REASONING_MESSAGE_END\",\n      messageId,\n    } as AGUIReasoningMessageEndEvent,\n    {\n      type: \"REASONING_END\",\n      messageId,\n    } as AGUIReasoningEndEvent,\n    makeRunFinished(started),\n  ];\n}\n\n/**\n * Build an activity snapshot response.\n * [RUN_STARTED, ACTIVITY_SNAPSHOT, RUN_FINISHED]\n */\nexport function buildActivityResponse(\n  messageId: string,\n  activityType: string,\n  content: Record<string, unknown>,\n  opts?: AGUIBuildOpts,\n): AGUIEvent[] {\n  const started = makeRunStarted(opts);\n  return [\n    started,\n    {\n      type: \"ACTIVITY_SNAPSHOT\",\n      messageId,\n      activityType,\n      content,\n      replace: true,\n    } as AGUIActivitySnapshotEvent,\n    makeRunFinished(started),\n  ];\n}\n\n/**\n * Build an error response.\n * [RUN_STARTED, RUN_ERROR] (no RUN_FINISHED — the run errored)\n */\nexport function buildErrorResponse(\n  message: string,\n  code?: string,\n  opts?: AGUIBuildOpts,\n): AGUIEvent[] {\n  const started = makeRunStarted(opts);\n  return [\n    started,\n    {\n      type: \"RUN_ERROR\",\n      message,\n      ...(code !== undefined ? { code } : {}),\n    } as AGUIRunErrorEvent,\n  ];\n}\n\n/**\n * Build a step-wrapped text response.\n * [RUN_STARTED, STEP_STARTED, TEXT_MESSAGE_START, TEXT_MESSAGE_CONTENT,\n *  TEXT_MESSAGE_END, STEP_FINISHED, RUN_FINISHED]\n */\nexport function buildStepWithText(\n  stepName: string,\n  text: string,\n  opts?: AGUIBuildOpts,\n): AGUIEvent[] {\n  const started = makeRunStarted(opts);\n  const messageId = randomUUID();\n  return [\n    started,\n    {\n      type: \"STEP_STARTED\",\n      stepName,\n    } as AGUIStepStartedEvent,\n    {\n      type: \"TEXT_MESSAGE_START\",\n      messageId,\n      role: \"assistant\",\n    } as AGUITextMessageStartEvent,\n    {\n      type: \"TEXT_MESSAGE_CONTENT\",\n      messageId,\n      delta: text,\n    } as AGUITextMessageContentEvent,\n    {\n      type: \"TEXT_MESSAGE_END\",\n      messageId,\n    } as AGUITextMessageEndEvent,\n    {\n      type: \"STEP_FINISHED\",\n      stepName,\n    } as AGUIStepFinishedEvent,\n    makeRunFinished(started),\n  ];\n}\n\n/**\n * Combine multiple builder outputs into a single run.\n * Strips RUN_STARTED/RUN_FINISHED from each input, wraps all inner events\n * in one RUN_STARTED...RUN_FINISHED pair.\n */\nexport function buildCompositeResponse(\n  builderOutputs: AGUIEvent[][],\n  opts?: AGUIBuildOpts,\n): AGUIEvent[] {\n  const started = makeRunStarted(opts);\n  const inner: AGUIEvent[] = [];\n\n  for (const events of builderOutputs) {\n    for (const event of events) {\n      if (event.type !== \"RUN_STARTED\" && event.type !== \"RUN_FINISHED\") {\n        inner.push(event);\n      }\n    }\n  }\n\n  return [started, ...inner, makeRunFinished(started)];\n}\n\n// ─── SSE writer ──────────────────────────────────────────────────────────────\n\n/**\n * Write AG-UI events as an SSE stream to an HTTP response.\n * Sets appropriate headers, serializes each event as `data: {...}\\n\\n`,\n * and optionally delays between events.\n */\nexport async function writeAGUIEventStream(\n  res: http.ServerResponse,\n  events: AGUIEvent[],\n  opts?: { delayMs?: number; signal?: AbortSignal },\n): Promise<void> {\n  const delayMs = opts?.delayMs ?? 0;\n\n  res.writeHead(200, {\n    \"Content-Type\": \"text/event-stream\",\n    \"Cache-Control\": \"no-cache\",\n    Connection: \"keep-alive\",\n  });\n\n  for (const event of events) {\n    if (opts?.signal?.aborted) break;\n    if (res.socket?.destroyed) break;\n\n    const stamped = { ...event, timestamp: Date.now() };\n    try {\n      res.write(`data: ${JSON.stringify(stamped)}\\n\\n`);\n    } catch {\n      break; // client disconnected or stream error — stop writing\n    }\n\n    if (delayMs > 0) {\n      await new Promise<void>((resolve) => setTimeout(resolve, delayMs));\n    }\n  }\n\n  if (!res.writableEnded) res.end();\n}\n"],"mappings":"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"}

package/dist/agui-handler.d.cts

@@ -0,0 +1,96 @@
+import { AGUIEvent, AGUIFixture, AGUIMessage, AGUIRunAgentInput } from "./agui-types.cjs";
+import * as http from "node:http";
+
+//#region src/agui-handler.d.ts
+
+/**
+ * Extract the content of the last message with role "user" from the input.
+ */
+declare function extractLastUserMessage(input: AGUIRunAgentInput): string;
+/**
+ * Check whether an input matches a fixture's match criteria.
+ * All specified criteria must pass (AND logic).
+ */
+
+/**
+ * Find the first fixture whose match criteria pass for the given input.
+ */
+declare function findFixture(input: AGUIRunAgentInput, fixtures: AGUIFixture[]): AGUIFixture | null;
+interface AGUIBuildOpts {
+  threadId?: string;
+  runId?: string;
+  parentRunId?: string;
+  /** For tool call builder: include a result event */
+  result?: string;
+}
+/**
+ * Build a complete text message response sequence.
+ * [RUN_STARTED, TEXT_MESSAGE_START, TEXT_MESSAGE_CONTENT, TEXT_MESSAGE_END, RUN_FINISHED]
+ */
+declare function buildTextResponse(text: string, opts?: AGUIBuildOpts): AGUIEvent[];
+/**
+ * Build a text chunk response (single chunk, no start/end envelope).
+ * [RUN_STARTED, TEXT_MESSAGE_CHUNK, RUN_FINISHED]
+ */
+declare function buildTextChunkResponse(text: string, opts?: AGUIBuildOpts): AGUIEvent[];
+/**
+ * Build a tool call response sequence.
+ * [RUN_STARTED, TOOL_CALL_START, TOOL_CALL_ARGS, TOOL_CALL_END, (TOOL_CALL_RESULT)?, RUN_FINISHED]
+ */
+declare function buildToolCallResponse(toolName: string, args: string, opts?: AGUIBuildOpts): AGUIEvent[];
+/**
+ * Build a state snapshot response.
+ * [RUN_STARTED, STATE_SNAPSHOT, RUN_FINISHED]
+ */
+declare function buildStateUpdate(snapshot: unknown, opts?: AGUIBuildOpts): AGUIEvent[];
+/**
+ * Build a state delta response (JSON Patch).
+ * [RUN_STARTED, STATE_DELTA, RUN_FINISHED]
+ */
+declare function buildStateDelta(patches: unknown[], opts?: AGUIBuildOpts): AGUIEvent[];
+/**
+ * Build a messages snapshot response.
+ * [RUN_STARTED, MESSAGES_SNAPSHOT, RUN_FINISHED]
+ */
+declare function buildMessagesSnapshot(messages: AGUIMessage[], opts?: AGUIBuildOpts): AGUIEvent[];
+/**
+ * Build a reasoning response sequence.
+ * [RUN_STARTED, REASONING_START, REASONING_MESSAGE_START, REASONING_MESSAGE_CONTENT,
+ *  REASONING_MESSAGE_END, REASONING_END, RUN_FINISHED]
+ */
+declare function buildReasoningResponse(text: string, opts?: AGUIBuildOpts): AGUIEvent[];
+/**
+ * Build an activity snapshot response.
+ * [RUN_STARTED, ACTIVITY_SNAPSHOT, RUN_FINISHED]
+ */
+declare function buildActivityResponse(messageId: string, activityType: string, content: Record<string, unknown>, opts?: AGUIBuildOpts): AGUIEvent[];
+/**
+ * Build an error response.
+ * [RUN_STARTED, RUN_ERROR] (no RUN_FINISHED — the run errored)
+ */
+declare function buildErrorResponse(message: string, code?: string, opts?: AGUIBuildOpts): AGUIEvent[];
+/**
+ * Build a step-wrapped text response.
+ * [RUN_STARTED, STEP_STARTED, TEXT_MESSAGE_START, TEXT_MESSAGE_CONTENT,
+ *  TEXT_MESSAGE_END, STEP_FINISHED, RUN_FINISHED]
+ */
+declare function buildStepWithText(stepName: string, text: string, opts?: AGUIBuildOpts): AGUIEvent[];
+/**
+ * Combine multiple builder outputs into a single run.
+ * Strips RUN_STARTED/RUN_FINISHED from each input, wraps all inner events
+ * in one RUN_STARTED...RUN_FINISHED pair.
+ */
+declare function buildCompositeResponse(builderOutputs: AGUIEvent[][], opts?: AGUIBuildOpts): AGUIEvent[];
+/**
+ * Write AG-UI events as an SSE stream to an HTTP response.
+ * Sets appropriate headers, serializes each event as `data: {...}\n\n`,
+ * and optionally delays between events.
+ */
+declare function writeAGUIEventStream(res: http.ServerResponse, events: AGUIEvent[], opts?: {
+  delayMs?: number;
+  signal?: AbortSignal;
+}): Promise<void>;
+//# sourceMappingURL=agui-handler.d.ts.map
+//#endregion
+export { buildActivityResponse, buildCompositeResponse, buildErrorResponse, buildMessagesSnapshot, buildReasoningResponse, buildStateDelta, buildStateUpdate, buildStepWithText, buildTextChunkResponse, buildTextResponse, buildToolCallResponse, extractLastUserMessage, findFixture, writeAGUIEventStream };
+//# sourceMappingURL=agui-handler.d.cts.map

package/dist/agui-handler.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agui-handler.d.cts","names":[],"sources":["../src/agui-handler.ts"],"sourcesContent":[],"mappings":";;;;;;;AA0CA;AAmDgB,iBAnDA,sBAAA,CAmDW,KAAA,EAnDmB,iBAmDnB,CAAA,EAAA,MAAA;;;;;;AAW3B;AA+BA;;AAAuD,iBA1CvC,WAAA,CA0CuC,KAAA,EA1CpB,iBA0CoB,EAAA,QAAA,EA1CS,WA0CT,EAAA,CAAA,EA1CyB,WA0CzB,GAAA,IAAA;AAAgB,UA/BtD,aAAA,CA+BsD;EAAS,QAAA,CAAA,EAAA,MAAA;EA2BhE,KAAA,CAAA,EAAA,MAAA;EAAsB,WAAA,CAAA,EAAA,MAAA;;QAAsC,CAAA,EAAA,MAAA;;AAkB5E;;;;AAIY,iBAjDI,iBAAA,CAiDJ,IAAA,EAAA,MAAA,EAAA,IAAA,CAAA,EAjD2C,aAiD3C,CAAA,EAjD2D,SAiD3D,EAAA;AAuCZ;;;;AAAoF,iBA7DpE,sBAAA,CA6DoE,IAAA,EAAA,MAAA,EAAA,IAAA,CAAA,EA7DxB,aA6DwB,CAAA,EA7DR,SA6DQ,EAAA;AAgBpF;;;;AAAoF,iBA3DpE,qBAAA,CA2DoE,QAAA,EAAA,MAAA,EAAA,IAAA,EAAA,MAAA,EAAA,IAAA,CAAA,EAxD3E,aAwD2E,CAAA,EAvDjF,SAuDiF,EAAA;AAgBpF;;;;AAAsF,iBAhCtE,gBAAA,CAgCsE,QAAA,EAAA,OAAA,EAAA,IAAA,CAAA,EAhC3B,aAgC2B,CAAA,EAhCX,SAgCW,EAAA;;AAiBtF;;;AAA4E,iBAjC5D,eAAA,CAiC4D,OAAA,EAAA,OAAA,EAAA,EAAA,IAAA,CAAA,EAjCjB,aAiCiB,CAAA,EAjCD,SAiCC,EAAA;;AAmC5E;;;AAIS,iBAxDO,qBAAA,CAwDP,QAAA,EAxDuC,WAwDvC,EAAA,EAAA,IAAA,CAAA,EAxD6D,aAwD7D,CAAA,EAxD6E,SAwD7E,EAAA;;;AAoBT;;;AAIG,iBA/Da,sBAAA,CA+Db,IAAA,EAAA,MAAA,EAAA,IAAA,CAAA,EA/DyD,aA+DzD,CAAA,EA/DyE,SA+DzE,EAAA;;AAiBH;;;AAIG,iBAjDa,qBAAA,CAiDb,SAAA,EAAA,MAAA,EAAA,YAAA,EAAA,MAAA,EAAA,OAAA,EA9CQ,MA8CR,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA,IAAA,CAAA,EA7CM,aA6CN,CAAA,EA5CA,SA4CA,EAAA;;AAoCH;;;AAES,iBA/DO,kBAAA,CA+DP,OAAA,EAAA,MAAA,EAAA,IAAA,CAAA,EAAA,MAAA,EAAA,IAAA,CAAA,EA5DA,aA4DA,CAAA,EA3DN,SA2DM,EAAA;;;AAuBT;;;AAEU,iBAnEM,iBAAA,CAmEN,QAAA,EAAA,MAAA,EAAA,IAAA,EAAA,MAAA,EAAA,IAAA,CAAA,EAhED,aAgEC,CAAA,EA/DP,SA+DO,EAAA;;;;;;iBA3BM,sBAAA,iBACE,sBACT,gBACN;;;;;;iBAsBmB,oBAAA,MACf,IAAA,CAAK,wBACF;;WAC4B;IACnC"}

package/dist/agui-handler.d.ts

@@ -0,0 +1,96 @@
+import { AGUIEvent, AGUIFixture, AGUIMessage, AGUIRunAgentInput } from "./agui-types.js";
+import * as http from "node:http";
+
+//#region src/agui-handler.d.ts
+
+/**
+ * Extract the content of the last message with role "user" from the input.
+ */
+declare function extractLastUserMessage(input: AGUIRunAgentInput): string;
+/**
+ * Check whether an input matches a fixture's match criteria.
+ * All specified criteria must pass (AND logic).
+ */
+
+/**
+ * Find the first fixture whose match criteria pass for the given input.
+ */
+declare function findFixture(input: AGUIRunAgentInput, fixtures: AGUIFixture[]): AGUIFixture | null;
+interface AGUIBuildOpts {
+  threadId?: string;
+  runId?: string;
+  parentRunId?: string;
+  /** For tool call builder: include a result event */
+  result?: string;
+}
+/**
+ * Build a complete text message response sequence.
+ * [RUN_STARTED, TEXT_MESSAGE_START, TEXT_MESSAGE_CONTENT, TEXT_MESSAGE_END, RUN_FINISHED]
+ */
+declare function buildTextResponse(text: string, opts?: AGUIBuildOpts): AGUIEvent[];
+/**
+ * Build a text chunk response (single chunk, no start/end envelope).
+ * [RUN_STARTED, TEXT_MESSAGE_CHUNK, RUN_FINISHED]
+ */
+declare function buildTextChunkResponse(text: string, opts?: AGUIBuildOpts): AGUIEvent[];
+/**
+ * Build a tool call response sequence.
+ * [RUN_STARTED, TOOL_CALL_START, TOOL_CALL_ARGS, TOOL_CALL_END, (TOOL_CALL_RESULT)?, RUN_FINISHED]
+ */
+declare function buildToolCallResponse(toolName: string, args: string, opts?: AGUIBuildOpts): AGUIEvent[];
+/**
+ * Build a state snapshot response.
+ * [RUN_STARTED, STATE_SNAPSHOT, RUN_FINISHED]
+ */
+declare function buildStateUpdate(snapshot: unknown, opts?: AGUIBuildOpts): AGUIEvent[];
+/**
+ * Build a state delta response (JSON Patch).
+ * [RUN_STARTED, STATE_DELTA, RUN_FINISHED]
+ */
+declare function buildStateDelta(patches: unknown[], opts?: AGUIBuildOpts): AGUIEvent[];
+/**
+ * Build a messages snapshot response.
+ * [RUN_STARTED, MESSAGES_SNAPSHOT, RUN_FINISHED]
+ */
+declare function buildMessagesSnapshot(messages: AGUIMessage[], opts?: AGUIBuildOpts): AGUIEvent[];
+/**
+ * Build a reasoning response sequence.
+ * [RUN_STARTED, REASONING_START, REASONING_MESSAGE_START, REASONING_MESSAGE_CONTENT,
+ *  REASONING_MESSAGE_END, REASONING_END, RUN_FINISHED]
+ */
+declare function buildReasoningResponse(text: string, opts?: AGUIBuildOpts): AGUIEvent[];
+/**
+ * Build an activity snapshot response.
+ * [RUN_STARTED, ACTIVITY_SNAPSHOT, RUN_FINISHED]
+ */
+declare function buildActivityResponse(messageId: string, activityType: string, content: Record<string, unknown>, opts?: AGUIBuildOpts): AGUIEvent[];
+/**
+ * Build an error response.
+ * [RUN_STARTED, RUN_ERROR] (no RUN_FINISHED — the run errored)
+ */
+declare function buildErrorResponse(message: string, code?: string, opts?: AGUIBuildOpts): AGUIEvent[];
+/**
+ * Build a step-wrapped text response.
+ * [RUN_STARTED, STEP_STARTED, TEXT_MESSAGE_START, TEXT_MESSAGE_CONTENT,
+ *  TEXT_MESSAGE_END, STEP_FINISHED, RUN_FINISHED]
+ */
+declare function buildStepWithText(stepName: string, text: string, opts?: AGUIBuildOpts): AGUIEvent[];
+/**
+ * Combine multiple builder outputs into a single run.
+ * Strips RUN_STARTED/RUN_FINISHED from each input, wraps all inner events
+ * in one RUN_STARTED...RUN_FINISHED pair.
+ */
+declare function buildCompositeResponse(builderOutputs: AGUIEvent[][], opts?: AGUIBuildOpts): AGUIEvent[];
+/**
+ * Write AG-UI events as an SSE stream to an HTTP response.
+ * Sets appropriate headers, serializes each event as `data: {...}\n\n`,
+ * and optionally delays between events.
+ */
+declare function writeAGUIEventStream(res: http.ServerResponse, events: AGUIEvent[], opts?: {
+  delayMs?: number;
+  signal?: AbortSignal;
+}): Promise<void>;
+//# sourceMappingURL=agui-handler.d.ts.map
+//#endregion
+export { buildActivityResponse, buildCompositeResponse, buildErrorResponse, buildMessagesSnapshot, buildReasoningResponse, buildStateDelta, buildStateUpdate, buildStepWithText, buildTextChunkResponse, buildTextResponse, buildToolCallResponse, extractLastUserMessage, findFixture, writeAGUIEventStream };
+//# sourceMappingURL=agui-handler.d.ts.map

package/dist/agui-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agui-handler.d.ts","names":[],"sources":["../src/agui-handler.ts"],"sourcesContent":[],"mappings":";;;;;;;AA0CA;AAmDgB,iBAnDA,sBAAA,CAmDW,KAAA,EAnDmB,iBAmDnB,CAAA,EAAA,MAAA;;;;;;AAW3B;AA+BA;;AAAuD,iBA1CvC,WAAA,CA0CuC,KAAA,EA1CpB,iBA0CoB,EAAA,QAAA,EA1CS,WA0CT,EAAA,CAAA,EA1CyB,WA0CzB,GAAA,IAAA;AAAgB,UA/BtD,aAAA,CA+BsD;EAAS,QAAA,CAAA,EAAA,MAAA;EA2BhE,KAAA,CAAA,EAAA,MAAA;EAAsB,WAAA,CAAA,EAAA,MAAA;;QAAsC,CAAA,EAAA,MAAA;;AAkB5E;;;;AAIY,iBAjDI,iBAAA,CAiDJ,IAAA,EAAA,MAAA,EAAA,IAAA,CAAA,EAjD2C,aAiD3C,CAAA,EAjD2D,SAiD3D,EAAA;AAuCZ;;;;AAAoF,iBA7DpE,sBAAA,CA6DoE,IAAA,EAAA,MAAA,EAAA,IAAA,CAAA,EA7DxB,aA6DwB,CAAA,EA7DR,SA6DQ,EAAA;AAgBpF;;;;AAAoF,iBA3DpE,qBAAA,CA2DoE,QAAA,EAAA,MAAA,EAAA,IAAA,EAAA,MAAA,EAAA,IAAA,CAAA,EAxD3E,aAwD2E,CAAA,EAvDjF,SAuDiF,EAAA;AAgBpF;;;;AAAsF,iBAhCtE,gBAAA,CAgCsE,QAAA,EAAA,OAAA,EAAA,IAAA,CAAA,EAhC3B,aAgC2B,CAAA,EAhCX,SAgCW,EAAA;;AAiBtF;;;AAA4E,iBAjC5D,eAAA,CAiC4D,OAAA,EAAA,OAAA,EAAA,EAAA,IAAA,CAAA,EAjCjB,aAiCiB,CAAA,EAjCD,SAiCC,EAAA;;AAmC5E;;;AAIS,iBAxDO,qBAAA,CAwDP,QAAA,EAxDuC,WAwDvC,EAAA,EAAA,IAAA,CAAA,EAxD6D,aAwD7D,CAAA,EAxD6E,SAwD7E,EAAA;;;AAoBT;;;AAIG,iBA/Da,sBAAA,CA+Db,IAAA,EAAA,MAAA,EAAA,IAAA,CAAA,EA/DyD,aA+DzD,CAAA,EA/DyE,SA+DzE,EAAA;;AAiBH;;;AAIG,iBAjDa,qBAAA,CAiDb,SAAA,EAAA,MAAA,EAAA,YAAA,EAAA,MAAA,EAAA,OAAA,EA9CQ,MA8CR,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA,IAAA,CAAA,EA7CM,aA6CN,CAAA,EA5CA,SA4CA,EAAA;;AAoCH;;;AAES,iBA/DO,kBAAA,CA+DP,OAAA,EAAA,MAAA,EAAA,IAAA,CAAA,EAAA,MAAA,EAAA,IAAA,CAAA,EA5DA,aA4DA,CAAA,EA3DN,SA2DM,EAAA;;;AAuBT;;;AAEU,iBAnEM,iBAAA,CAmEN,QAAA,EAAA,MAAA,EAAA,IAAA,EAAA,MAAA,EAAA,IAAA,CAAA,EAhED,aAgEC,CAAA,EA/DP,SA+DO,EAAA;;;;;;iBA3BM,sBAAA,iBACE,sBACT,gBACN;;;;;;iBAsBmB,oBAAA,MACf,IAAA,CAAK,wBACF;;WAC4B;IACnC"}