octoflow-core 1.0.0

package/dist/runtime/bridge/agui-gateway-converters.js

@@ -0,0 +1,155 @@
+import crypto from "node:crypto";
+function fmtJson(value) {
+  try {
+    return JSON.stringify(value);
+  } catch {
+    return String(value);
+  }
+}
+function inputContentToParts(content) {
+  const parts = [];
+  for (const item of content) {
+    if (item.type === "text") {
+      if (item.text) parts.push({ kind: "text", text: item.text });
+      continue;
+    }
+    if (item.type === "binary") {
+      parts.push({
+        kind: "file",
+        file: {
+          mimeType: item.mimeType,
+          uri: item.url ?? item.id,
+          bytes: item.data
+        },
+        metadata: { sourceType: "binary" }
+      });
+      continue;
+    }
+    parts.push({
+      kind: "file",
+      file: {
+        mimeType: item.source.mimeType ?? `${item.type}/*`,
+        uri: item.source.type === "url" ? item.source.value : void 0,
+        bytes: item.source.type === "data" ? item.source.value : void 0
+      },
+      metadata: { sourceType: item.type }
+    });
+  }
+  return parts;
+}
+function messageContentToParts(message) {
+  if (message.role === "activity") return [];
+  const content = message.content;
+  if (typeof content === "string") {
+    return content ? [{ kind: "text", text: content }] : [];
+  }
+  if (Array.isArray(content)) {
+    return inputContentToParts(content);
+  }
+  return [];
+}
+function messageToBridgeParts(message) {
+  const parts = messageContentToParts(message);
+  if (message.role === "assistant") {
+    const toolCalls = message.toolCalls;
+    if (toolCalls?.length) {
+      for (const call of toolCalls) {
+        let input = {};
+        try {
+          input = call.function.arguments ? JSON.parse(call.function.arguments) : {};
+        } catch {
+          input = call.function.arguments;
+        }
+        parts.push({
+          kind: "tool_call",
+          id: call.id,
+          name: call.function.name,
+          input
+        });
+      }
+    }
+  }
+  if (message.role === "tool") {
+    const toolMsg = message;
+    parts.push({
+      kind: "tool_result",
+      callId: toolMsg.toolCallId,
+      output: typeof toolMsg.content === "string" ? toolMsg.content : ""
+    });
+  }
+  return parts;
+}
+function toolsToPromptParts(tools) {
+  if (!tools.length) return [];
+  const lines = ["[agui_tools]"];
+  for (const tool of tools) {
+    lines.push(
+      `- ${tool.name}: ${tool.description}
+  parameters: ${fmtJson(tool.parameters)}`
+    );
+  }
+  return [{ kind: "text", text: lines.join("\n") }];
+}
+function contextToPromptParts(context) {
+  if (!context.length) return [];
+  const lines = ["[agui_context]"];
+  for (const entry of context) {
+    lines.push(`- ${entry.description}: ${entry.value}`);
+  }
+  return [{ kind: "text", text: lines.join("\n") }];
+}
+function stateToPromptParts(state) {
+  if (state == null) return [];
+  return [
+    {
+      kind: "text",
+      text: `[agui_state]
+${fmtJson(state)}`
+    }
+  ];
+}
+function agUiInputToBridgeMessage(input) {
+  const messages = input.messages;
+  if (!messages.length) return "";
+  const toolParts = toolsToPromptParts(input.tools);
+  const contextParts = contextToPromptParts(input.context);
+  const stateParts = stateToPromptParts(input.state);
+  const prefixParts = [...stateParts, ...contextParts, ...toolParts];
+  if (prefixParts.length === 0 && messages.length === 1 && messages[0]?.role === "user" && typeof messages[0].content === "string" && input.forwardedProps == null && !input.resume?.length) {
+    return messages[0].content;
+  }
+  const parts = [...prefixParts];
+  for (const message of messages) {
+    const bridgeParts = messageToBridgeParts(message);
+    if (message.role === "system" || message.role === "developer") {
+      const systemText = bridgeParts.filter((p) => p.kind === "text").map((p) => p.text).join("\n");
+      if (systemText) {
+        parts.push({
+          kind: "text",
+          text: `[${message.role}]
+${systemText}`
+        });
+      }
+      continue;
+    }
+    parts.push({ kind: "text", text: `[${message.role}]` });
+    parts.push(...bridgeParts);
+  }
+  return {
+    kind: "message",
+    messageId: `agui-${input.runId}-${crypto.randomUUID()}`,
+    role: "user",
+    parts,
+    metadata: {
+      threadId: input.threadId,
+      runId: input.runId,
+      ...input.parentRunId ? { parentRunId: input.parentRunId } : {},
+      ...input.forwardedProps != null ? { forwardedProps: input.forwardedProps } : {},
+      ...input.resume?.length ? { resume: input.resume } : {}
+    }
+  };
+}
+export {
+  agUiInputToBridgeMessage
+};
+//# sourceMappingURL=agui-gateway-converters.js.map

package/dist/runtime/bridge/agui-gateway-converters.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/runtime/bridge/agui-gateway-converters.ts"],
+  "sourcesContent": ["/**\n * AG-UI request \u2192 bridge message conversion.\n *\n * Sister file to `agui-gateway.ts`. Lives separately so the server file stays\n * close to the HTTP routing surface and stays under the 400-line repo cap.\n *\n * Mapping rules:\n *\n *   - `messages[]`        \u2192 ordered prompt parts tagged `[role]` for non-system\n *                           roles, mirroring how `openai-gateway-converters.ts`\n *                           projects role-tagged turns into a single bridge\n *                           message. Outbound backends without native multi-turn\n *                           parsing still see the conversation context.\n *   - `tools[]`           \u2192 guidance prompt prefix listing every declared tool\n *                           by name, description, and JSON-schema parameters.\n *   - `context[]`         \u2192 guidance prompt prefix exposing each context entry's\n *                           `description` and `value`. Honors AG-UI semantics\n *                           where `context` is \"facts the agent must know\"\n *                           rather than instructions.\n *   - `state`             \u2192 JSON-stringified into the prompt under\n *                           `[agui_state]` so stateless backends still get the\n *                           caller's run-scoped state snapshot.\n */\nimport crypto from 'node:crypto';\n\nimport type { Message, Part, TextPart } from '../../domain/core-task.js';\nimport type {\n  AgUiContext,\n  AgUiExtendedInputContent,\n  AgUiMessage,\n  AgUiTool,\n  OctoFlowRunAgentInput,\n} from './agui-gateway-types.js';\n\nfunction fmtJson(value: unknown): string {\n  try {\n    return JSON.stringify(value);\n  } catch {\n    return String(value);\n  }\n}\n\nfunction inputContentToParts(content: AgUiExtendedInputContent[]): Part[] {\n  const parts: Part[] = [];\n  for (const item of content) {\n    if (item.type === 'text') {\n      if (item.text) parts.push({ kind: 'text', text: item.text });\n      continue;\n    }\n    if (item.type === 'binary') {\n      parts.push({\n        kind: 'file',\n        file: {\n          mimeType: item.mimeType,\n          uri: item.url ?? item.id,\n          bytes: item.data,\n        },\n        metadata: { sourceType: 'binary' },\n      });\n      continue;\n    }\n    parts.push({\n      kind: 'file',\n      file: {\n        mimeType: item.source.mimeType ?? `${item.type}/*`,\n        uri: item.source.type === 'url' ? item.source.value : undefined,\n        bytes: item.source.type === 'data' ? item.source.value : undefined,\n      },\n      metadata: { sourceType: item.type },\n    });\n  }\n  return parts;\n}\n\nfunction messageContentToParts(message: AgUiMessage): Part[] {\n  // ActivityMessage.content is Record<string,any>; all other roles use string | InputContent[]\n  if (message.role === 'activity') return [];\n  const content = (message as { content?: unknown }).content;\n  if (typeof content === 'string') {\n    return content ? [{ kind: 'text', text: content }] : [];\n  }\n  if (Array.isArray(content)) {\n    return inputContentToParts(content as AgUiExtendedInputContent[]);\n  }\n  return [];\n}\n\nfunction messageToBridgeParts(message: AgUiMessage): Part[] {\n  const parts = messageContentToParts(message);\n  // toolCalls only exists on AssistantMessage\n  if (message.role === 'assistant') {\n    const toolCalls = (message as { toolCalls?: AgUiMessage[] }).toolCalls;\n    if (toolCalls?.length) {\n      for (const call of toolCalls as unknown as Array<{\n        id: string;\n        function: { name: string; arguments: string };\n      }>) {\n        let input: unknown = {};\n        try {\n          input = call.function.arguments\n            ? JSON.parse(call.function.arguments)\n            : {};\n        } catch {\n          input = call.function.arguments;\n        }\n        parts.push({\n          kind: 'tool_call',\n          id: call.id,\n          name: call.function.name,\n          input,\n        });\n      }\n    }\n  }\n  // toolCallId only exists on ToolMessage\n  if (message.role === 'tool') {\n    const toolMsg = message as { toolCallId: string; content: string };\n    parts.push({\n      kind: 'tool_result',\n      callId: toolMsg.toolCallId,\n      output: typeof toolMsg.content === 'string' ? toolMsg.content : '',\n    });\n  }\n  return parts;\n}\n\nfunction toolsToPromptParts(tools: AgUiTool[]): Part[] {\n  if (!tools.length) return [];\n  const lines = ['[agui_tools]'];\n  for (const tool of tools) {\n    lines.push(\n      `- ${tool.name}: ${tool.description}\\n  parameters: ${fmtJson(tool.parameters)}`\n    );\n  }\n  return [{ kind: 'text', text: lines.join('\\n') }];\n}\n\nfunction contextToPromptParts(context: AgUiContext[]): Part[] {\n  if (!context.length) return [];\n  const lines = ['[agui_context]'];\n  for (const entry of context) {\n    lines.push(`- ${entry.description}: ${entry.value}`);\n  }\n  return [{ kind: 'text', text: lines.join('\\n') }];\n}\n\nfunction stateToPromptParts(state: unknown): Part[] {\n  if (state == null) return [];\n  return [\n    {\n      kind: 'text',\n      text: `[agui_state]\\n${fmtJson(state)}`,\n    },\n  ];\n}\n\n/**\n * Convert a canonical AG-UI `RunAgentInput` payload (extended with OctoFlow's\n * `resume[]`) to the input format used by `agent.sendMessage`. When the payload\n * is a single user-text turn with no tools / context / state, returns a plain\n * string for cheaper backend routing (mirroring the heuristic in\n * `requestToBridgeMessage`).\n */\nexport function agUiInputToBridgeMessage(\n  input: OctoFlowRunAgentInput\n): Message | string {\n  const messages = input.messages;\n  if (!messages.length) return '';\n  const toolParts = toolsToPromptParts(input.tools);\n  const contextParts = contextToPromptParts(input.context);\n  const stateParts = stateToPromptParts(input.state);\n  const prefixParts: Part[] = [...stateParts, ...contextParts, ...toolParts];\n  if (\n    prefixParts.length === 0 &&\n    messages.length === 1 &&\n    messages[0]?.role === 'user' &&\n    typeof messages[0].content === 'string' &&\n    input.forwardedProps == null &&\n    !input.resume?.length\n  ) {\n    return messages[0].content;\n  }\n  const parts: Part[] = [...prefixParts];\n  for (const message of messages) {\n    const bridgeParts = messageToBridgeParts(message);\n    if (message.role === 'system' || message.role === 'developer') {\n      const systemText = bridgeParts\n        .filter((p): p is TextPart => p.kind === 'text')\n        .map((p) => p.text)\n        .join('\\n');\n      if (systemText) {\n        parts.push({\n          kind: 'text',\n          text: `[${message.role}]\\n${systemText}`,\n        });\n      }\n      continue;\n    }\n    parts.push({ kind: 'text', text: `[${message.role}]` });\n    parts.push(...bridgeParts);\n  }\n  return {\n    kind: 'message',\n    messageId: `agui-${input.runId}-${crypto.randomUUID()}`,\n    role: 'user',\n    parts,\n    metadata: {\n      threadId: input.threadId,\n      runId: input.runId,\n      ...(input.parentRunId ? { parentRunId: input.parentRunId } : {}),\n      ...(input.forwardedProps != null\n        ? { forwardedProps: input.forwardedProps }\n        : {}),\n      ...(input.resume?.length ? { resume: input.resume } : {}),\n    },\n  };\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/runtime/bridge/agui-gateway-emitters.d.ts

@@ -0,0 +1,30 @@
+/**
+ * SSE event emitter helpers for the AG-UI gateway.
+ *
+ * Each function writes one or more typed SSE frames via `writeSseEvent`.
+ * Kept separate so `agui-gateway.ts` stays under the source-line budget.
+ */
+import type { ServerResponse } from 'node:http';
+import type { AgUiEvent } from './agui-gateway-types.js';
+export declare function writeSseEvent(res: ServerResponse, event: AgUiEvent): void;
+/** Emit START → CONTENT (full text) → END in one flush (non-streaming fallback). */
+export declare function emitMessageEvents(res: ServerResponse, text: string, messageId: string): void;
+export declare function emitToolCallEvents(res: ServerResponse, toolCalls: Array<{
+    id: string;
+    function: {
+        name: string;
+        arguments: string;
+    };
+}>, parentMessageId: string, toolResults: Array<{
+    callId: string;
+    output: unknown;
+    isError?: boolean;
+}>): void;
+export declare function emitStepStarted(res: ServerResponse, stepName: string, stepId: string): void;
+export declare function emitStepFinished(res: ServerResponse, stepName: string, stepId: string): void;
+export declare function emitStateSnapshot(res: ServerResponse, snapshot: unknown): void;
+export declare function emitStateDelta(res: ServerResponse, delta: Array<Record<string, unknown>>): void;
+export declare function emitActivitySnapshot(res: ServerResponse, messageId: string, activityType: string, content: Record<string, unknown>): void;
+export declare function emitActivityDelta(res: ServerResponse, messageId: string, activityType: string, patch: Array<Record<string, unknown>>): void;
+export declare function emitCustom(res: ServerResponse, name: string, value: unknown): void;
+//# sourceMappingURL=agui-gateway-emitters.d.ts.map

package/dist/runtime/bridge/agui-gateway-emitters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agui-gateway-emitters.d.ts","sourceRoot":"","sources":["../../../src/runtime/bridge/agui-gateway-emitters.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEhD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAGzD,wBAAgB,aAAa,CAAC,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI,CAGzE;AAED,oFAAoF;AACpF,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAChB,IAAI,CAKN;AAED,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,cAAc,EACnB,SAAS,EAAE,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC,EAC/E,eAAe,EAAE,MAAM,EACvB,WAAW,EAAE,KAAK,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,GACzE,IAAI,CAgCN;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAE3F;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAE5F;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,cAAc,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI,CAE9E;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,CAE/F;AAED,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,cAAc,EACnB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,IAAI,CAQN;AAED,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,cAAc,EACnB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACpC,IAAI,CAEN;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAElF"}

package/dist/runtime/bridge/agui-gateway-emitters.js

@@ -0,0 +1,87 @@
+import { AG_UI_EVENT } from "./agui-gateway-types.js";
+function writeSseEvent(res, event) {
+  const payload = { timestamp: Date.now(), ...event };
+  res.write(`data: ${JSON.stringify(payload)}
+
+`);
+}
+function emitMessageEvents(res, text, messageId) {
+  if (!text) return;
+  writeSseEvent(res, { type: AG_UI_EVENT.TEXT_MESSAGE_START, messageId, role: "assistant" });
+  writeSseEvent(res, { type: AG_UI_EVENT.TEXT_MESSAGE_CONTENT, messageId, delta: text });
+  writeSseEvent(res, { type: AG_UI_EVENT.TEXT_MESSAGE_END, messageId });
+}
+function emitToolCallEvents(res, toolCalls, parentMessageId, toolResults) {
+  const resultByCallId = new Map(toolResults.map((r) => [r.callId, r]));
+  for (const call of toolCalls) {
+    writeSseEvent(res, {
+      type: AG_UI_EVENT.TOOL_CALL_START,
+      toolCallId: call.id,
+      toolCallName: call.function.name,
+      parentMessageId
+    });
+    writeSseEvent(res, {
+      type: AG_UI_EVENT.TOOL_CALL_ARGS,
+      toolCallId: call.id,
+      delta: call.function.arguments
+    });
+    writeSseEvent(res, { type: AG_UI_EVENT.TOOL_CALL_END, toolCallId: call.id });
+    const toolResult = resultByCallId.get(call.id);
+    if (toolResult) {
+      const content = typeof toolResult.output === "string" ? toolResult.output : (() => {
+        try {
+          return JSON.stringify(toolResult.output);
+        } catch {
+          return String(toolResult.output);
+        }
+      })();
+      writeSseEvent(res, {
+        type: AG_UI_EVENT.TOOL_CALL_RESULT,
+        messageId: parentMessageId,
+        toolCallId: call.id,
+        role: "tool",
+        content
+      });
+    }
+  }
+}
+function emitStepStarted(res, stepName, stepId) {
+  writeSseEvent(res, { type: AG_UI_EVENT.STEP_STARTED, stepName, stepId });
+}
+function emitStepFinished(res, stepName, stepId) {
+  writeSseEvent(res, { type: AG_UI_EVENT.STEP_FINISHED, stepName, stepId });
+}
+function emitStateSnapshot(res, snapshot) {
+  writeSseEvent(res, { type: AG_UI_EVENT.STATE_SNAPSHOT, snapshot });
+}
+function emitStateDelta(res, delta) {
+  writeSseEvent(res, { type: AG_UI_EVENT.STATE_DELTA, delta });
+}
+function emitActivitySnapshot(res, messageId, activityType, content) {
+  writeSseEvent(res, {
+    type: AG_UI_EVENT.ACTIVITY_SNAPSHOT,
+    messageId,
+    activityType,
+    content,
+    replace: true
+  });
+}
+function emitActivityDelta(res, messageId, activityType, patch) {
+  writeSseEvent(res, { type: AG_UI_EVENT.ACTIVITY_DELTA, messageId, activityType, patch });
+}
+function emitCustom(res, name, value) {
+  writeSseEvent(res, { type: AG_UI_EVENT.CUSTOM, name, value });
+}
+export {
+  emitActivityDelta,
+  emitActivitySnapshot,
+  emitCustom,
+  emitMessageEvents,
+  emitStateDelta,
+  emitStateSnapshot,
+  emitStepFinished,
+  emitStepStarted,
+  emitToolCallEvents,
+  writeSseEvent
+};
+//# sourceMappingURL=agui-gateway-emitters.js.map

package/dist/runtime/bridge/agui-gateway-emitters.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/runtime/bridge/agui-gateway-emitters.ts"],
+  "sourcesContent": ["/**\n * SSE event emitter helpers for the AG-UI gateway.\n *\n * Each function writes one or more typed SSE frames via `writeSseEvent`.\n * Kept separate so `agui-gateway.ts` stays under the source-line budget.\n */\nimport type { ServerResponse } from 'node:http';\n\nimport type { AgUiEvent } from './agui-gateway-types.js';\nimport { AG_UI_EVENT } from './agui-gateway-types.js';\n\nexport function writeSseEvent(res: ServerResponse, event: AgUiEvent): void {\n  const payload = { timestamp: Date.now(), ...event };\n  res.write(`data: ${JSON.stringify(payload)}\\n\\n`);\n}\n\n/** Emit START \u2192 CONTENT (full text) \u2192 END in one flush (non-streaming fallback). */\nexport function emitMessageEvents(\n  res: ServerResponse,\n  text: string,\n  messageId: string\n): void {\n  if (!text) return;\n  writeSseEvent(res, { type: AG_UI_EVENT.TEXT_MESSAGE_START, messageId, role: 'assistant' });\n  writeSseEvent(res, { type: AG_UI_EVENT.TEXT_MESSAGE_CONTENT, messageId, delta: text });\n  writeSseEvent(res, { type: AG_UI_EVENT.TEXT_MESSAGE_END, messageId });\n}\n\nexport function emitToolCallEvents(\n  res: ServerResponse,\n  toolCalls: Array<{ id: string; function: { name: string; arguments: string } }>,\n  parentMessageId: string,\n  toolResults: Array<{ callId: string; output: unknown; isError?: boolean }>\n): void {\n  const resultByCallId = new Map(toolResults.map((r) => [r.callId, r]));\n  for (const call of toolCalls) {\n    writeSseEvent(res, {\n      type: AG_UI_EVENT.TOOL_CALL_START,\n      toolCallId: call.id,\n      toolCallName: call.function.name,\n      parentMessageId,\n    });\n    writeSseEvent(res, {\n      type: AG_UI_EVENT.TOOL_CALL_ARGS,\n      toolCallId: call.id,\n      delta: call.function.arguments,\n    });\n    writeSseEvent(res, { type: AG_UI_EVENT.TOOL_CALL_END, toolCallId: call.id });\n    const toolResult = resultByCallId.get(call.id);\n    if (toolResult) {\n      const content =\n        typeof toolResult.output === 'string'\n          ? toolResult.output\n          : (() => {\n              try { return JSON.stringify(toolResult.output); } catch { return String(toolResult.output); }\n            })();\n      writeSseEvent(res, {\n        type: AG_UI_EVENT.TOOL_CALL_RESULT,\n        messageId: parentMessageId,\n        toolCallId: call.id,\n        role: 'tool',\n        content,\n      });\n    }\n  }\n}\n\nexport function emitStepStarted(res: ServerResponse, stepName: string, stepId: string): void {\n  writeSseEvent(res, { type: AG_UI_EVENT.STEP_STARTED, stepName, stepId });\n}\n\nexport function emitStepFinished(res: ServerResponse, stepName: string, stepId: string): void {\n  writeSseEvent(res, { type: AG_UI_EVENT.STEP_FINISHED, stepName, stepId });\n}\n\nexport function emitStateSnapshot(res: ServerResponse, snapshot: unknown): void {\n  writeSseEvent(res, { type: AG_UI_EVENT.STATE_SNAPSHOT, snapshot });\n}\n\nexport function emitStateDelta(res: ServerResponse, delta: Array<Record<string, unknown>>): void {\n  writeSseEvent(res, { type: AG_UI_EVENT.STATE_DELTA, delta });\n}\n\nexport function emitActivitySnapshot(\n  res: ServerResponse,\n  messageId: string,\n  activityType: string,\n  content: Record<string, unknown>\n): void {\n  writeSseEvent(res, {\n    type: AG_UI_EVENT.ACTIVITY_SNAPSHOT,\n    messageId,\n    activityType,\n    content,\n    replace: true,\n  });\n}\n\nexport function emitActivityDelta(\n  res: ServerResponse,\n  messageId: string,\n  activityType: string,\n  patch: Array<Record<string, unknown>>\n): void {\n  writeSseEvent(res, { type: AG_UI_EVENT.ACTIVITY_DELTA, messageId, activityType, patch });\n}\n\nexport function emitCustom(res: ServerResponse, name: string, value: unknown): void {\n  writeSseEvent(res, { type: AG_UI_EVENT.CUSTOM, name, value });\n}\n"],
+  "mappings": "AASA,SAAS,mBAAmB;AAErB,SAAS,cAAc,KAAqB,OAAwB;AACzE,QAAM,UAAU,EAAE,WAAW,KAAK,IAAI,GAAG,GAAG,MAAM;AAClD,MAAI,MAAM,SAAS,KAAK,UAAU,OAAO,CAAC;AAAA;AAAA,CAAM;AAClD;AAGO,SAAS,kBACd,KACA,MACA,WACM;AACN,MAAI,CAAC,KAAM;AACX,gBAAc,KAAK,EAAE,MAAM,YAAY,oBAAoB,WAAW,MAAM,YAAY,CAAC;AACzF,gBAAc,KAAK,EAAE,MAAM,YAAY,sBAAsB,WAAW,OAAO,KAAK,CAAC;AACrF,gBAAc,KAAK,EAAE,MAAM,YAAY,kBAAkB,UAAU,CAAC;AACtE;AAEO,SAAS,mBACd,KACA,WACA,iBACA,aACM;AACN,QAAM,iBAAiB,IAAI,IAAI,YAAY,IAAI,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;AACpE,aAAW,QAAQ,WAAW;AAC5B,kBAAc,KAAK;AAAA,MACjB,MAAM,YAAY;AAAA,MAClB,YAAY,KAAK;AAAA,MACjB,cAAc,KAAK,SAAS;AAAA,MAC5B;AAAA,IACF,CAAC;AACD,kBAAc,KAAK;AAAA,MACjB,MAAM,YAAY;AAAA,MAClB,YAAY,KAAK;AAAA,MACjB,OAAO,KAAK,SAAS;AAAA,IACvB,CAAC;AACD,kBAAc,KAAK,EAAE,MAAM,YAAY,eAAe,YAAY,KAAK,GAAG,CAAC;AAC3E,UAAM,aAAa,eAAe,IAAI,KAAK,EAAE;AAC7C,QAAI,YAAY;AACd,YAAM,UACJ,OAAO,WAAW,WAAW,WACzB,WAAW,UACV,MAAM;AACL,YAAI;AAAE,iBAAO,KAAK,UAAU,WAAW,MAAM;AAAA,QAAG,QAAQ;AAAE,iBAAO,OAAO,WAAW,MAAM;AAAA,QAAG;AAAA,MAC9F,GAAG;AACT,oBAAc,KAAK;AAAA,QACjB,MAAM,YAAY;AAAA,QAClB,WAAW;AAAA,QACX,YAAY,KAAK;AAAA,QACjB,MAAM;AAAA,QACN;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF;AACF;AAEO,SAAS,gBAAgB,KAAqB,UAAkB,QAAsB;AAC3F,gBAAc,KAAK,EAAE,MAAM,YAAY,cAAc,UAAU,OAAO,CAAC;AACzE;AAEO,SAAS,iBAAiB,KAAqB,UAAkB,QAAsB;AAC5F,gBAAc,KAAK,EAAE,MAAM,YAAY,eAAe,UAAU,OAAO,CAAC;AAC1E;AAEO,SAAS,kBAAkB,KAAqB,UAAyB;AAC9E,gBAAc,KAAK,EAAE,MAAM,YAAY,gBAAgB,SAAS,CAAC;AACnE;AAEO,SAAS,eAAe,KAAqB,OAA6C;AAC/F,gBAAc,KAAK,EAAE,MAAM,YAAY,aAAa,MAAM,CAAC;AAC7D;AAEO,SAAS,qBACd,KACA,WACA,cACA,SACM;AACN,gBAAc,KAAK;AAAA,IACjB,MAAM,YAAY;AAAA,IAClB;AAAA,IACA;AAAA,IACA;AAAA,IACA,SAAS;AAAA,EACX,CAAC;AACH;AAEO,SAAS,kBACd,KACA,WACA,cACA,OACM;AACN,gBAAc,KAAK,EAAE,MAAM,YAAY,gBAAgB,WAAW,cAAc,MAAM,CAAC;AACzF;AAEO,SAAS,WAAW,KAAqB,MAAc,OAAsB;AAClF,gBAAc,KAAK,EAAE,MAAM,YAAY,QAAQ,MAAM,MAAM,CAAC;AAC9D;",
+  "names": []
+}

package/dist/runtime/bridge/agui-gateway-input.d.ts

@@ -0,0 +1,4 @@
+import type { OctoFlowRunAgentInput } from './agui-gateway-types.js';
+/** Validate and normalize a raw POST body into `OctoFlowRunAgentInput`. */
+export declare function validateRunAgentInput(body: unknown): body is OctoFlowRunAgentInput;
+//# sourceMappingURL=agui-gateway-input.d.ts.map

package/dist/runtime/bridge/agui-gateway-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agui-gateway-input.d.ts","sourceRoot":"","sources":["../../../src/runtime/bridge/agui-gateway-input.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAErE,2EAA2E;AAC3E,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,OAAO,GACZ,IAAI,IAAI,qBAAqB,CAU/B"}

package/dist/runtime/bridge/agui-gateway-input.js

@@ -0,0 +1,14 @@
+function validateRunAgentInput(body) {
+  if (!body || typeof body !== "object") return false;
+  const b = body;
+  if (!Array.isArray(b["messages"])) return false;
+  if (b["threadId"] != null && typeof b["threadId"] !== "string") return false;
+  if (b["runId"] != null && typeof b["runId"] !== "string") return false;
+  if (!Array.isArray(b["tools"])) b["tools"] = [];
+  if (!Array.isArray(b["context"])) b["context"] = [];
+  return true;
+}
+export {
+  validateRunAgentInput
+};
+//# sourceMappingURL=agui-gateway-input.js.map

package/dist/runtime/bridge/agui-gateway-input.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/runtime/bridge/agui-gateway-input.ts"],
+  "sourcesContent": ["import type { OctoFlowRunAgentInput } from './agui-gateway-types.js';\n\n/** Validate and normalize a raw POST body into `OctoFlowRunAgentInput`. */\nexport function validateRunAgentInput(\n  body: unknown\n): body is OctoFlowRunAgentInput {\n  if (!body || typeof body !== 'object') return false;\n  const b = body as Record<string, unknown>;\n  if (!Array.isArray(b['messages'])) return false;\n  if (b['threadId'] != null && typeof b['threadId'] !== 'string') return false;\n  if (b['runId'] != null && typeof b['runId'] !== 'string') return false;\n  // Coerce missing arrays so downstream code never needs null checks.\n  if (!Array.isArray(b['tools'])) b['tools'] = [];\n  if (!Array.isArray(b['context'])) b['context'] = [];\n  return true;\n}\n"],
+  "mappings": "AAGO,SAAS,sBACd,MAC+B;AAC/B,MAAI,CAAC,QAAQ,OAAO,SAAS,SAAU,QAAO;AAC9C,QAAM,IAAI;AACV,MAAI,CAAC,MAAM,QAAQ,EAAE,UAAU,CAAC,EAAG,QAAO;AAC1C,MAAI,EAAE,UAAU,KAAK,QAAQ,OAAO,EAAE,UAAU,MAAM,SAAU,QAAO;AACvE,MAAI,EAAE,OAAO,KAAK,QAAQ,OAAO,EAAE,OAAO,MAAM,SAAU,QAAO;AAEjE,MAAI,CAAC,MAAM,QAAQ,EAAE,OAAO,CAAC,EAAG,GAAE,OAAO,IAAI,CAAC;AAC9C,MAAI,CAAC,MAAM,QAAQ,EAAE,SAAS,CAAC,EAAG,GAAE,SAAS,IAAI,CAAC;AAClD,SAAO;AACT;",
+  "names": []
+}

package/dist/runtime/bridge/agui-gateway-types.d.ts

@@ -0,0 +1,123 @@
+/**
+ * AG-UI (Agent-User Interaction Protocol) types for the OctoFlow gateway.
+ *
+ * All event interfaces, RunAgentInput, Message, Tool, Context, and
+ * AgentCapabilities are imported directly from `@ag-ui/core` so OctoFlow
+ * stays in sync with the upstream SDK without manual mirroring.
+ *
+ * OctoFlow adds:
+ *   - `AG_UI_EVENT` — const-object mirror of `EventType` enum (pattern-matches
+ *     better in switch/narrowing than TypeScript enums in some configurations).
+ *   - `AgUiResumeEntry` — OctoFlow extension for `resume[]` continuation entries
+ *     (not yet in the upstream spec; tracked in RFC-ag-ui-core-compliance).
+ *   - `AgUiEvent` — type alias for `AGUIEvent` with the open-escape union.
+ *   - SSE/JSON content-type constants.
+ *
+ * References:
+ *   - Event taxonomy: https://docs.ag-ui.com/sdk/js/core/events
+ *   - Core types: https://docs.ag-ui.com/sdk/js/core/types
+ */
+import type { ActivityDeltaEvent, ActivitySnapshotEvent, AgentCapabilities, AssistantMessage, BaseEvent, BinaryInputContent, Context, CustomEvent, InputContent, Message, MessagesSnapshotEvent, RawEvent, ReasoningEncryptedValueEvent, ReasoningEndEvent, ReasoningMessageChunkEvent, ReasoningMessageContentEvent, ReasoningMessageEndEvent, ReasoningMessageStartEvent, ReasoningStartEvent, RunAgentInput, RunErrorEvent, RunFinishedEvent, RunStartedEvent, State, StateDeltaEvent, StateSnapshotEvent, StepFinishedEvent, StepStartedEvent, TextMessageChunkEvent, TextMessageContentEvent, TextMessageEndEvent, TextMessageStartEvent, Tool, ToolCall, ToolCallArgsEvent, ToolCallChunkEvent, ToolCallEndEvent, ToolCallResultEvent, ToolCallStartEvent } from '@ag-ui/core';
+import { EventType } from '@ag-ui/core';
+export type { ActivityDeltaEvent, ActivitySnapshotEvent, AgentCapabilities, Context as AgUiContext, InputContent as AgUiInputContent, Message as AgUiMessage, State as AgUiState, Tool as AgUiTool, ToolCall as AgUiToolCall, ToolCall as AgUiToolCallMessage, AssistantMessage, BaseEvent, CustomEvent, MessagesSnapshotEvent, RawEvent, ReasoningEncryptedValueEvent, ReasoningEndEvent, ReasoningMessageChunkEvent, ReasoningMessageContentEvent, ReasoningMessageEndEvent, ReasoningMessageStartEvent, ReasoningStartEvent, RunAgentInput, RunErrorEvent, RunFinishedEvent, RunStartedEvent, StateDeltaEvent, StateSnapshotEvent, StepFinishedEvent, StepStartedEvent, TextMessageChunkEvent, TextMessageContentEvent, TextMessageEndEvent, TextMessageStartEvent, ToolCallArgsEvent, ToolCallChunkEvent, ToolCallEndEvent, ToolCallResultEvent, ToolCallStartEvent, };
+/**
+ * OctoFlow extension for multimodal binary payloads. Superset of
+ * `@ag-ui/core`'s `InputContent` — adds the `binary` variant that `@ag-ui/core`
+ * exports separately as `BinaryInputContent`.
+ */
+export type AgUiExtendedInputContent = InputContent | BinaryInputContent;
+export { EventType };
+/**
+ * Const-object mirror of `EventType` enum. Enables direct string narrowing
+ * without TypeScript enum quirks and matches what `@ag-ui/encoder` expects
+ * on the wire.
+ *
+ * Complete taxonomy as of `@ag-ui/core@0.0.53`.
+ */
+export declare const AG_UI_EVENT: {
+    readonly RUN_STARTED: EventType.RUN_STARTED;
+    readonly RUN_FINISHED: EventType.RUN_FINISHED;
+    readonly RUN_ERROR: EventType.RUN_ERROR;
+    readonly STEP_STARTED: EventType.STEP_STARTED;
+    readonly STEP_FINISHED: EventType.STEP_FINISHED;
+    readonly TEXT_MESSAGE_START: EventType.TEXT_MESSAGE_START;
+    readonly TEXT_MESSAGE_CONTENT: EventType.TEXT_MESSAGE_CONTENT;
+    readonly TEXT_MESSAGE_END: EventType.TEXT_MESSAGE_END;
+    readonly TEXT_MESSAGE_CHUNK: EventType.TEXT_MESSAGE_CHUNK;
+    readonly TOOL_CALL_START: EventType.TOOL_CALL_START;
+    readonly TOOL_CALL_ARGS: EventType.TOOL_CALL_ARGS;
+    readonly TOOL_CALL_END: EventType.TOOL_CALL_END;
+    readonly TOOL_CALL_CHUNK: EventType.TOOL_CALL_CHUNK;
+    readonly TOOL_CALL_RESULT: EventType.TOOL_CALL_RESULT;
+    readonly STATE_SNAPSHOT: EventType.STATE_SNAPSHOT;
+    readonly STATE_DELTA: EventType.STATE_DELTA;
+    readonly MESSAGES_SNAPSHOT: EventType.MESSAGES_SNAPSHOT;
+    readonly ACTIVITY_SNAPSHOT: EventType.ACTIVITY_SNAPSHOT;
+    readonly ACTIVITY_DELTA: EventType.ACTIVITY_DELTA;
+    readonly REASONING_START: EventType.REASONING_START;
+    readonly REASONING_END: EventType.REASONING_END;
+    readonly REASONING_MESSAGE_START: EventType.REASONING_MESSAGE_START;
+    readonly REASONING_MESSAGE_CONTENT: EventType.REASONING_MESSAGE_CONTENT;
+    readonly REASONING_MESSAGE_END: EventType.REASONING_MESSAGE_END;
+    readonly REASONING_MESSAGE_CHUNK: EventType.REASONING_MESSAGE_CHUNK;
+    readonly REASONING_ENCRYPTED_VALUE: EventType.REASONING_ENCRYPTED_VALUE;
+    readonly RAW: EventType.RAW;
+    readonly CUSTOM: EventType.CUSTOM;
+};
+export type AgUiEventType = (typeof AG_UI_EVENT)[keyof typeof AG_UI_EVENT];
+/**
+ * Strict union of all AG-UI events from `@ag-ui/core`. Use this when
+ * constructing or narrowing events with full type safety (e.g. when calling
+ * `writeSseEvent`). All `type` fields are `EventType` enum values.
+ */
+export type AgUiStrictEvent = RunStartedEvent | RunFinishedEvent | RunErrorEvent | StepStartedEvent | StepFinishedEvent | TextMessageStartEvent | TextMessageContentEvent | TextMessageEndEvent | TextMessageChunkEvent | ToolCallStartEvent | ToolCallArgsEvent | ToolCallEndEvent | ToolCallChunkEvent | ToolCallResultEvent | StateSnapshotEvent | StateDeltaEvent | MessagesSnapshotEvent | ActivitySnapshotEvent | ActivityDeltaEvent | ReasoningStartEvent | ReasoningMessageStartEvent | ReasoningMessageContentEvent | ReasoningMessageEndEvent | ReasoningMessageChunkEvent | ReasoningEndEvent | ReasoningEncryptedValueEvent | CustomEvent | RawEvent | (BaseEvent & Record<string, unknown>);
+/**
+ * Loose AG-UI event type used by the verifier and test fixtures. The `type`
+ * field is `string` instead of `EventType` so string literals like
+ * `'RUN_STARTED'` (which equal the enum values at runtime) can be assigned
+ * without explicit casting.
+ *
+ * For emit-time type safety, prefer `AgUiStrictEvent`.
+ */
+export interface AgUiEvent {
+    type: string;
+    timestamp?: number;
+    rawEvent?: unknown;
+    [key: string]: unknown;
+}
+/**
+ * A single entry in the AG-UI `resume[]` continuation list.
+ *
+ * When a run is paused by an interrupt/approval gate, the client resumes by
+ * sending `RunAgentInput` with one or more entries that resolve each outstanding
+ * interrupt by its `id`. OctoFlow extension — not yet in the upstream spec.
+ * Tracked in RFC-ag-ui-core-compliance, phase 8.
+ */
+export interface AgUiResumeEntry {
+    /** ID matching the interrupt that is being resolved. */
+    id: string;
+    /** Resolution payload — accepted, rejected, or modified input. */
+    value: unknown;
+}
+/**
+ * Extended `RunAgentInput` that includes the OctoFlow `resume[]` extension.
+ * All other fields come directly from `@ag-ui/core`.
+ */
+export interface OctoFlowRunAgentInput extends RunAgentInput {
+    /**
+     * Continuation entries for runs previously paused by an interrupt.
+     * Each entry resolves one outstanding interrupt by its `id`.
+     * Tracked in RFC-ag-ui-core-compliance, phase 8.
+     */
+    resume?: AgUiResumeEntry[];
+}
+/**
+ * Canonical SSE Content-Type for AG-UI events. Protobuf-encoded streams use
+ * `application/vnd.ag-ui.event+proto`; the gateway only emits SSE today.
+ */
+export declare const AG_UI_SSE_CONTENT_TYPE = "text/event-stream";
+/**
+ * Canonical JSON Content-Type for AG-UI non-streaming responses.
+ */
+export declare const AG_UI_JSON_CONTENT_TYPE = "application/json";
+//# sourceMappingURL=agui-gateway-types.d.ts.map

package/dist/runtime/bridge/agui-gateway-types.d.ts.map

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

package/dist/runtime/bridge/agui-gateway-types.js

@@ -0,0 +1,47 @@
+import { EventType } from "@ag-ui/core";
+const AG_UI_EVENT = {
+  // Lifecycle
+  RUN_STARTED: EventType.RUN_STARTED,
+  RUN_FINISHED: EventType.RUN_FINISHED,
+  RUN_ERROR: EventType.RUN_ERROR,
+  STEP_STARTED: EventType.STEP_STARTED,
+  STEP_FINISHED: EventType.STEP_FINISHED,
+  // Text message streaming
+  TEXT_MESSAGE_START: EventType.TEXT_MESSAGE_START,
+  TEXT_MESSAGE_CONTENT: EventType.TEXT_MESSAGE_CONTENT,
+  TEXT_MESSAGE_END: EventType.TEXT_MESSAGE_END,
+  TEXT_MESSAGE_CHUNK: EventType.TEXT_MESSAGE_CHUNK,
+  // Tool call streaming
+  TOOL_CALL_START: EventType.TOOL_CALL_START,
+  TOOL_CALL_ARGS: EventType.TOOL_CALL_ARGS,
+  TOOL_CALL_END: EventType.TOOL_CALL_END,
+  TOOL_CALL_CHUNK: EventType.TOOL_CALL_CHUNK,
+  TOOL_CALL_RESULT: EventType.TOOL_CALL_RESULT,
+  // State management
+  STATE_SNAPSHOT: EventType.STATE_SNAPSHOT,
+  STATE_DELTA: EventType.STATE_DELTA,
+  MESSAGES_SNAPSHOT: EventType.MESSAGES_SNAPSHOT,
+  // Activity
+  ACTIVITY_SNAPSHOT: EventType.ACTIVITY_SNAPSHOT,
+  ACTIVITY_DELTA: EventType.ACTIVITY_DELTA,
+  // Reasoning (chain-of-thought; requires LLM extended-thinking output)
+  REASONING_START: EventType.REASONING_START,
+  REASONING_END: EventType.REASONING_END,
+  REASONING_MESSAGE_START: EventType.REASONING_MESSAGE_START,
+  REASONING_MESSAGE_CONTENT: EventType.REASONING_MESSAGE_CONTENT,
+  REASONING_MESSAGE_END: EventType.REASONING_MESSAGE_END,
+  REASONING_MESSAGE_CHUNK: EventType.REASONING_MESSAGE_CHUNK,
+  REASONING_ENCRYPTED_VALUE: EventType.REASONING_ENCRYPTED_VALUE,
+  // Special / extension
+  RAW: EventType.RAW,
+  CUSTOM: EventType.CUSTOM
+};
+const AG_UI_SSE_CONTENT_TYPE = "text/event-stream";
+const AG_UI_JSON_CONTENT_TYPE = "application/json";
+export {
+  AG_UI_EVENT,
+  AG_UI_JSON_CONTENT_TYPE,
+  AG_UI_SSE_CONTENT_TYPE,
+  EventType
+};
+//# sourceMappingURL=agui-gateway-types.js.map

package/dist/runtime/bridge/agui-gateway-types.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/runtime/bridge/agui-gateway-types.ts"],
+  "sourcesContent": ["/**\n * AG-UI (Agent-User Interaction Protocol) types for the OctoFlow gateway.\n *\n * All event interfaces, RunAgentInput, Message, Tool, Context, and\n * AgentCapabilities are imported directly from `@ag-ui/core` so OctoFlow\n * stays in sync with the upstream SDK without manual mirroring.\n *\n * OctoFlow adds:\n *   - `AG_UI_EVENT` \u2014 const-object mirror of `EventType` enum (pattern-matches\n *     better in switch/narrowing than TypeScript enums in some configurations).\n *   - `AgUiResumeEntry` \u2014 OctoFlow extension for `resume[]` continuation entries\n *     (not yet in the upstream spec; tracked in RFC-ag-ui-core-compliance).\n *   - `AgUiEvent` \u2014 type alias for `AGUIEvent` with the open-escape union.\n *   - SSE/JSON content-type constants.\n *\n * References:\n *   - Event taxonomy: https://docs.ag-ui.com/sdk/js/core/events\n *   - Core types: https://docs.ag-ui.com/sdk/js/core/types\n */\n\nimport type {\n  ActivityDeltaEvent,\n  ActivitySnapshotEvent,\n  AgentCapabilities,\n  AssistantMessage,\n  BaseEvent,\n  BinaryInputContent,\n  Context,\n  CustomEvent,\n  InputContent,\n  Message,\n  MessagesSnapshotEvent,\n  RawEvent,\n  ReasoningEncryptedValueEvent,\n  ReasoningEndEvent,\n  ReasoningMessageChunkEvent,\n  ReasoningMessageContentEvent,\n  ReasoningMessageEndEvent,\n  ReasoningMessageStartEvent,\n  ReasoningStartEvent,\n  RunAgentInput,\n  RunErrorEvent,\n  RunFinishedEvent,\n  RunStartedEvent,\n  State,\n  StateDeltaEvent,\n  StateSnapshotEvent,\n  StepFinishedEvent,\n  StepStartedEvent,\n  TextMessageChunkEvent,\n  TextMessageContentEvent,\n  TextMessageEndEvent,\n  TextMessageStartEvent,\n  Tool,\n  ToolCall,\n  ToolCallArgsEvent,\n  ToolCallChunkEvent,\n  ToolCallEndEvent,\n  ToolCallResultEvent,\n  ToolCallStartEvent,\n} from '@ag-ui/core';\nimport { EventType } from '@ag-ui/core';\n\n// \u2500\u2500\u2500 Re-export canonical types from @ag-ui/core \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n// Consumers can import these from octoflow-core instead of taking a direct\n// @ag-ui/core dependency. When @ag-ui/core bumps, OctoFlow re-exports update\n// automatically after a version pin update and build.\n\nexport type {\n  ActivityDeltaEvent,\n  ActivitySnapshotEvent,\n  AgentCapabilities,\n  Context as AgUiContext,\n  InputContent as AgUiInputContent,\n  Message as AgUiMessage,\n  State as AgUiState,\n  Tool as AgUiTool,\n  ToolCall as AgUiToolCall,\n  // Backwards compat alias (was AgUiToolCallMessage in pre-@ag-ui/core era)\n  ToolCall as AgUiToolCallMessage,\n  AssistantMessage,\n  BaseEvent,\n  CustomEvent,\n  MessagesSnapshotEvent,\n  RawEvent,\n  ReasoningEncryptedValueEvent,\n  ReasoningEndEvent,\n  ReasoningMessageChunkEvent,\n  ReasoningMessageContentEvent,\n  ReasoningMessageEndEvent,\n  ReasoningMessageStartEvent,\n  ReasoningStartEvent,\n  RunAgentInput,\n  RunErrorEvent,\n  RunFinishedEvent,\n  RunStartedEvent,\n  StateDeltaEvent,\n  StateSnapshotEvent,\n  StepFinishedEvent,\n  StepStartedEvent,\n  TextMessageChunkEvent,\n  TextMessageContentEvent,\n  TextMessageEndEvent,\n  TextMessageStartEvent,\n  ToolCallArgsEvent,\n  ToolCallChunkEvent,\n  ToolCallEndEvent,\n  ToolCallResultEvent,\n  ToolCallStartEvent,\n};\n\n/**\n * OctoFlow extension for multimodal binary payloads. Superset of\n * `@ag-ui/core`'s `InputContent` \u2014 adds the `binary` variant that `@ag-ui/core`\n * exports separately as `BinaryInputContent`.\n */\nexport type AgUiExtendedInputContent = InputContent | BinaryInputContent;\n\n// Re-export the enum itself so callers can use both AG_UI_EVENT.X (const) and\n// EventType.X (enum) patterns interchangeably.\nexport { EventType };\n\n/**\n * Const-object mirror of `EventType` enum. Enables direct string narrowing\n * without TypeScript enum quirks and matches what `@ag-ui/encoder` expects\n * on the wire.\n *\n * Complete taxonomy as of `@ag-ui/core@0.0.53`.\n */\nexport const AG_UI_EVENT = {\n  // Lifecycle\n  RUN_STARTED: EventType.RUN_STARTED,\n  RUN_FINISHED: EventType.RUN_FINISHED,\n  RUN_ERROR: EventType.RUN_ERROR,\n  STEP_STARTED: EventType.STEP_STARTED,\n  STEP_FINISHED: EventType.STEP_FINISHED,\n  // Text message streaming\n  TEXT_MESSAGE_START: EventType.TEXT_MESSAGE_START,\n  TEXT_MESSAGE_CONTENT: EventType.TEXT_MESSAGE_CONTENT,\n  TEXT_MESSAGE_END: EventType.TEXT_MESSAGE_END,\n  TEXT_MESSAGE_CHUNK: EventType.TEXT_MESSAGE_CHUNK,\n  // Tool call streaming\n  TOOL_CALL_START: EventType.TOOL_CALL_START,\n  TOOL_CALL_ARGS: EventType.TOOL_CALL_ARGS,\n  TOOL_CALL_END: EventType.TOOL_CALL_END,\n  TOOL_CALL_CHUNK: EventType.TOOL_CALL_CHUNK,\n  TOOL_CALL_RESULT: EventType.TOOL_CALL_RESULT,\n  // State management\n  STATE_SNAPSHOT: EventType.STATE_SNAPSHOT,\n  STATE_DELTA: EventType.STATE_DELTA,\n  MESSAGES_SNAPSHOT: EventType.MESSAGES_SNAPSHOT,\n  // Activity\n  ACTIVITY_SNAPSHOT: EventType.ACTIVITY_SNAPSHOT,\n  ACTIVITY_DELTA: EventType.ACTIVITY_DELTA,\n  // Reasoning (chain-of-thought; requires LLM extended-thinking output)\n  REASONING_START: EventType.REASONING_START,\n  REASONING_END: EventType.REASONING_END,\n  REASONING_MESSAGE_START: EventType.REASONING_MESSAGE_START,\n  REASONING_MESSAGE_CONTENT: EventType.REASONING_MESSAGE_CONTENT,\n  REASONING_MESSAGE_END: EventType.REASONING_MESSAGE_END,\n  REASONING_MESSAGE_CHUNK: EventType.REASONING_MESSAGE_CHUNK,\n  REASONING_ENCRYPTED_VALUE: EventType.REASONING_ENCRYPTED_VALUE,\n  // Special / extension\n  RAW: EventType.RAW,\n  CUSTOM: EventType.CUSTOM,\n} as const;\n\nexport type AgUiEventType = (typeof AG_UI_EVENT)[keyof typeof AG_UI_EVENT];\n\n/**\n * Strict union of all AG-UI events from `@ag-ui/core`. Use this when\n * constructing or narrowing events with full type safety (e.g. when calling\n * `writeSseEvent`). All `type` fields are `EventType` enum values.\n */\nexport type AgUiStrictEvent =\n  | RunStartedEvent\n  | RunFinishedEvent\n  | RunErrorEvent\n  | StepStartedEvent\n  | StepFinishedEvent\n  | TextMessageStartEvent\n  | TextMessageContentEvent\n  | TextMessageEndEvent\n  | TextMessageChunkEvent\n  | ToolCallStartEvent\n  | ToolCallArgsEvent\n  | ToolCallEndEvent\n  | ToolCallChunkEvent\n  | ToolCallResultEvent\n  | StateSnapshotEvent\n  | StateDeltaEvent\n  | MessagesSnapshotEvent\n  | ActivitySnapshotEvent\n  | ActivityDeltaEvent\n  | ReasoningStartEvent\n  | ReasoningMessageStartEvent\n  | ReasoningMessageContentEvent\n  | ReasoningMessageEndEvent\n  | ReasoningMessageChunkEvent\n  | ReasoningEndEvent\n  | ReasoningEncryptedValueEvent\n  | CustomEvent\n  | RawEvent\n  | (BaseEvent & Record<string, unknown>);\n\n/**\n * Loose AG-UI event type used by the verifier and test fixtures. The `type`\n * field is `string` instead of `EventType` so string literals like\n * `'RUN_STARTED'` (which equal the enum values at runtime) can be assigned\n * without explicit casting.\n *\n * For emit-time type safety, prefer `AgUiStrictEvent`.\n */\nexport interface AgUiEvent {\n  type: string;\n  timestamp?: number;\n  rawEvent?: unknown;\n  [key: string]: unknown;\n}\n\n// \u2500\u2500\u2500 OctoFlow-specific extensions \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n/**\n * A single entry in the AG-UI `resume[]` continuation list.\n *\n * When a run is paused by an interrupt/approval gate, the client resumes by\n * sending `RunAgentInput` with one or more entries that resolve each outstanding\n * interrupt by its `id`. OctoFlow extension \u2014 not yet in the upstream spec.\n * Tracked in RFC-ag-ui-core-compliance, phase 8.\n */\nexport interface AgUiResumeEntry {\n  /** ID matching the interrupt that is being resolved. */\n  id: string;\n  /** Resolution payload \u2014 accepted, rejected, or modified input. */\n  value: unknown;\n}\n\n/**\n * Extended `RunAgentInput` that includes the OctoFlow `resume[]` extension.\n * All other fields come directly from `@ag-ui/core`.\n */\nexport interface OctoFlowRunAgentInput extends RunAgentInput {\n  /**\n   * Continuation entries for runs previously paused by an interrupt.\n   * Each entry resolves one outstanding interrupt by its `id`.\n   * Tracked in RFC-ag-ui-core-compliance, phase 8.\n   */\n  resume?: AgUiResumeEntry[];\n}\n\n/**\n * Canonical SSE Content-Type for AG-UI events. Protobuf-encoded streams use\n * `application/vnd.ag-ui.event+proto`; the gateway only emits SSE today.\n */\nexport const AG_UI_SSE_CONTENT_TYPE = 'text/event-stream';\n\n/**\n * Canonical JSON Content-Type for AG-UI non-streaming responses.\n */\nexport const AG_UI_JSON_CONTENT_TYPE = 'application/json';\n"],
+  "mappings": "AA6DA,SAAS,iBAAiB;AAoEnB,MAAM,cAAc;AAAA;AAAA,EAEzB,aAAa,UAAU;AAAA,EACvB,cAAc,UAAU;AAAA,EACxB,WAAW,UAAU;AAAA,EACrB,cAAc,UAAU;AAAA,EACxB,eAAe,UAAU;AAAA;AAAA,EAEzB,oBAAoB,UAAU;AAAA,EAC9B,sBAAsB,UAAU;AAAA,EAChC,kBAAkB,UAAU;AAAA,EAC5B,oBAAoB,UAAU;AAAA;AAAA,EAE9B,iBAAiB,UAAU;AAAA,EAC3B,gBAAgB,UAAU;AAAA,EAC1B,eAAe,UAAU;AAAA,EACzB,iBAAiB,UAAU;AAAA,EAC3B,kBAAkB,UAAU;AAAA;AAAA,EAE5B,gBAAgB,UAAU;AAAA,EAC1B,aAAa,UAAU;AAAA,EACvB,mBAAmB,UAAU;AAAA;AAAA,EAE7B,mBAAmB,UAAU;AAAA,EAC7B,gBAAgB,UAAU;AAAA;AAAA,EAE1B,iBAAiB,UAAU;AAAA,EAC3B,eAAe,UAAU;AAAA,EACzB,yBAAyB,UAAU;AAAA,EACnC,2BAA2B,UAAU;AAAA,EACrC,uBAAuB,UAAU;AAAA,EACjC,yBAAyB,UAAU;AAAA,EACnC,2BAA2B,UAAU;AAAA;AAAA,EAErC,KAAK,UAAU;AAAA,EACf,QAAQ,UAAU;AACpB;AAyFO,MAAM,yBAAyB;AAK/B,MAAM,0BAA0B;",
+  "names": []
+}

package/dist/runtime/bridge/agui-gateway-verifier.d.ts

@@ -0,0 +1,31 @@
+/**
+ * AG-UI event sequence lifecycle verifier.
+ *
+ * Validates that a sequence of AG-UI events satisfies the invariants required
+ * by `@ag-ui/client` and downstream runtimes. Mirrors the upstream verifier at:
+ *   https://github.com/ag-ui-protocol/ag-ui/blob/main/sdks/typescript/packages/client/src/verify/verify.ts
+ *
+ * This module is pure — no side effects, no I/O. Use it in tests and
+ * optionally in development gateway mode to catch malformed event streams
+ * before they reach client SDKs.
+ *
+ * Invariants enforced:
+ *   1. First event must be RUN_STARTED or RUN_ERROR.
+ *   2. TEXT_MESSAGE_CONTENT must carry the same messageId as the open TEXT_MESSAGE_START.
+ *   3. TEXT_MESSAGE_END must close the currently open message (matching messageId).
+ *   4. TOOL_CALL_ARGS / TOOL_CALL_END require an active TOOL_CALL_START for that callId.
+ *   5. TOOL_CALL_RESULT is only valid for a callId that has been started and ended
+ *      (i.e. after TOOL_CALL_END, not while the call is still open).
+ *   6. RUN_FINISHED cannot fire while a text message, tool call, or step is open.
+ *   7. No event may follow RUN_FINISHED or RUN_ERROR in the same run.
+ *   8. STEP_FINISHED requires an active STEP_STARTED with the same stepName.
+ */
+import type { AgUiVerifierViolation } from 'octoflow-protocols';
+import type { AgUiEvent } from './agui-gateway-types.js';
+/**
+ * Verify an ordered sequence of AG-UI events against the protocol lifecycle
+ * invariants. Returns an array of violations; an empty array means the
+ * sequence is conformant.
+ */
+export declare function verifyAgUiEventSequence(events: AgUiEvent[]): AgUiVerifierViolation[];
+//# sourceMappingURL=agui-gateway-verifier.d.ts.map

package/dist/runtime/bridge/agui-gateway-verifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agui-gateway-verifier.d.ts","sourceRoot":"","sources":["../../../src/runtime/bridge/agui-gateway-verifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAEhE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AA4BzD;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,SAAS,EAAE,GAClB,qBAAqB,EAAE,CAwLzB"}