@assistant-ui/react-google-adk 0.0.1

package/dist/server/adkEventStream.js

@@ -0,0 +1,135 @@
+const convertSdkPart = (part) => {
+    const result = {};
+    if ("text" in part && typeof part.text === "string")
+        result.text = part.text;
+    if ("thought" in part && typeof part.thought === "boolean")
+        result.thought = part.thought;
+    if ("functionCall" in part && part.functionCall)
+        result.functionCall = part.functionCall;
+    if ("functionResponse" in part && part.functionResponse)
+        result.functionResponse = part.functionResponse;
+    if ("executableCode" in part && part.executableCode)
+        result.executableCode = part.executableCode;
+    if ("codeExecutionResult" in part && part.codeExecutionResult)
+        result.codeExecutionResult = part.codeExecutionResult;
+    if ("inlineData" in part && part.inlineData)
+        result.inlineData = part.inlineData;
+    if ("fileData" in part && part.fileData)
+        result.fileData = part.fileData;
+    return result;
+};
+const convertSdkActions = (actions) => {
+    const result = {};
+    if (actions.stateDelta != null)
+        result.stateDelta = actions.stateDelta;
+    if (actions.artifactDelta != null)
+        result.artifactDelta = actions.artifactDelta;
+    if (actions.transferToAgent != null)
+        result.transferToAgent = actions.transferToAgent;
+    if (actions.escalate != null)
+        result.escalate = actions.escalate;
+    if (actions.skipSummarization != null)
+        result.skipSummarization = actions.skipSummarization;
+    if (actions.requestedAuthConfigs != null)
+        result.requestedAuthConfigs = actions.requestedAuthConfigs;
+    if (actions.requestedToolConfirmations != null)
+        result.requestedToolConfirmations = actions.requestedToolConfirmations;
+    return result;
+};
+const convertSdkEvent = (event) => {
+    const result = { id: event.id ?? "" };
+    if (event.invocationId != null)
+        result.invocationId = event.invocationId;
+    if (event.author != null)
+        result.author = event.author;
+    if (event.branch != null)
+        result.branch = event.branch;
+    if (event.partial != null)
+        result.partial = event.partial;
+    if (event.turnComplete != null)
+        result.turnComplete = event.turnComplete;
+    if (event.interrupted != null)
+        result.interrupted = event.interrupted;
+    if (event.finishReason != null)
+        result.finishReason = event.finishReason;
+    if (event.timestamp != null)
+        result.timestamp = event.timestamp;
+    if (event.content) {
+        const content = {};
+        if (event.content.role != null)
+            content.role = event.content.role;
+        if (event.content.parts)
+            content.parts = event.content.parts.map(convertSdkPart);
+        result.content = content;
+    }
+    if (event.actions)
+        result.actions = convertSdkActions(event.actions);
+    if (event.longRunningToolIds)
+        result.longRunningToolIds = event.longRunningToolIds;
+    if (event.errorCode != null)
+        result.errorCode = event.errorCode;
+    if (event.errorMessage != null)
+        result.errorMessage = event.errorMessage;
+    if (event.groundingMetadata != null)
+        result.groundingMetadata = event.groundingMetadata;
+    if (event.citationMetadata != null)
+        result.citationMetadata = event.citationMetadata;
+    if (event.usageMetadata != null)
+        result.usageMetadata = event.usageMetadata;
+    if (event.customMetadata != null)
+        result.customMetadata = event.customMetadata;
+    return result;
+};
+/**
+ * Converts an AsyncGenerator of ADK SDK Events into an SSE Response.
+ *
+ * @example
+ * ```ts
+ * import { adkEventStream } from '@assistant-ui/react-google-adk/server';
+ * const events = runner.runAsync({ userId, sessionId, newMessage });
+ * return adkEventStream(events);
+ * ```
+ */
+export const adkEventStream = (events, options) => {
+    const encoder = new TextEncoder();
+    let cancelled = false;
+    const stream = new ReadableStream({
+        async start(controller) {
+            // Initial SSE comment to keep connection alive through proxies
+            controller.enqueue(encoder.encode(":ok\n\n"));
+            try {
+                for await (const event of events) {
+                    if (cancelled)
+                        break;
+                    const wireEvent = convertSdkEvent(event);
+                    controller.enqueue(encoder.encode(`data: ${JSON.stringify(wireEvent)}\n\n`));
+                }
+            }
+            catch (e) {
+                if (!cancelled) {
+                    options?.onError?.(e);
+                    const errorEvent = {
+                        id: "",
+                        errorCode: "STREAM_ERROR",
+                        errorMessage: e instanceof Error ? e.message : "Unknown stream error",
+                    };
+                    controller.enqueue(encoder.encode(`data: ${JSON.stringify(errorEvent)}\n\n`));
+                }
+            }
+            finally {
+                controller.close();
+            }
+        },
+        async cancel() {
+            cancelled = true;
+            await events.return?.(undefined);
+        },
+    });
+    return new Response(stream, {
+        headers: {
+            "Content-Type": "text/event-stream",
+            "Cache-Control": "no-cache",
+        },
+    });
+};
+//# sourceMappingURL=adkEventStream.js.map

package/dist/server/adkEventStream.js.map

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

package/dist/server/createAdkApiRoute.d.ts

@@ -0,0 +1,47 @@
+import { type AdkEventStreamOptions } from "./adkEventStream.js";
+/**
+ * Loose runner type matching the ADK SDK's Runner interface.
+ * Avoids requiring `@google/adk` as a dependency.
+ */
+type AdkRunner = {
+    runAsync(options: Record<string, unknown>): AsyncGenerator<any, void, undefined>;
+};
+export type CreateAdkApiRouteOptions = {
+    /**
+     * ADK Runner instance.
+     */
+    runner: AdkRunner;
+    /**
+     * User ID to use for the ADK session. Can be a static string
+     * or a function that extracts it from the request.
+     */
+    userId: string | ((req: Request) => string | Promise<string>);
+    /**
+     * Session ID to use. Can be a static string or a function
+     * that extracts it from the request (e.g. from query params or headers).
+     */
+    sessionId: string | ((req: Request) => string | Promise<string>);
+    /**
+     * Error handler for stream errors.
+     */
+    onError?: AdkEventStreamOptions["onError"];
+};
+/**
+ * Creates a request handler that combines `parseAdkRequest`, `toAdkContent`,
+ * and `adkEventStream` into a single function.
+ *
+ * @example Next.js App Router
+ * ```ts
+ * import { createAdkApiRoute } from '@assistant-ui/react-google-adk/server';
+ * import { runner } from './agent';
+ *
+ * export const POST = createAdkApiRoute({
+ *   runner,
+ *   userId: "default-user",
+ *   sessionId: (req) => new URL(req.url).searchParams.get("sessionId") ?? "default",
+ * });
+ * ```
+ */
+export declare function createAdkApiRoute(options: CreateAdkApiRouteOptions): (req: Request) => Promise<Response>;
+export {};
+//# sourceMappingURL=createAdkApiRoute.d.ts.map

package/dist/server/createAdkApiRoute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createAdkApiRoute.d.ts","sourceRoot":"","sources":["../../src/server/createAdkApiRoute.ts"],"names":[],"mappings":"AACA,OAAO,EAAkB,KAAK,qBAAqB,EAAE,4BAAyB;AAE9E;;;GAGG;AACH,KAAK,SAAS,GAAG;IACf,QAAQ,CACN,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,cAAc,CAAC,GAAG,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;CACzC,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC;;OAEG;IACH,MAAM,EAAE,SAAS,CAAC;IAElB;;;OAGG;IACH,MAAM,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,OAAO,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAE9D;;;OAGG;IACH,SAAS,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,OAAO,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAEjE;;OAEG;IACH,OAAO,CAAC,EAAE,qBAAqB,CAAC,SAAS,CAAC,CAAC;CAC5C,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,wBAAwB,GAChC,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CA8BrC"}

package/dist/server/createAdkApiRoute.js

@@ -0,0 +1,41 @@
+import { parseAdkRequest, toAdkContent } from "./parseAdkRequest.js";
+import { adkEventStream } from "./adkEventStream.js";
+/**
+ * Creates a request handler that combines `parseAdkRequest`, `toAdkContent`,
+ * and `adkEventStream` into a single function.
+ *
+ * @example Next.js App Router
+ * ```ts
+ * import { createAdkApiRoute } from '@assistant-ui/react-google-adk/server';
+ * import { runner } from './agent';
+ *
+ * export const POST = createAdkApiRoute({
+ *   runner,
+ *   userId: "default-user",
+ *   sessionId: (req) => new URL(req.url).searchParams.get("sessionId") ?? "default",
+ * });
+ * ```
+ */
+export function createAdkApiRoute(options) {
+    return async (req) => {
+        const parsed = await parseAdkRequest(req);
+        const newMessage = toAdkContent(parsed);
+        const userId = typeof options.userId === "function"
+            ? await options.userId(req)
+            : options.userId;
+        const sessionId = typeof options.sessionId === "function"
+            ? await options.sessionId(req)
+            : options.sessionId;
+        const events = options.runner.runAsync({
+            userId,
+            sessionId,
+            newMessage,
+            ...(parsed.stateDelta != null && { stateDelta: parsed.stateDelta }),
+            ...(parsed.config.runConfig != null && {
+                runConfig: parsed.config.runConfig,
+            }),
+        });
+        return adkEventStream(events, options.onError ? { onError: options.onError } : undefined);
+    };
+}
+//# sourceMappingURL=createAdkApiRoute.js.map

package/dist/server/createAdkApiRoute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createAdkApiRoute.js","sourceRoot":"","sources":["../../src/server/createAdkApiRoute.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,6BAA0B;AAClE,OAAO,EAAE,cAAc,EAA8B,4BAAyB;AAoC9E;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAiC;IAEjC,OAAO,KAAK,EAAE,GAAY,EAAqB,EAAE;QAC/C,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,GAAG,CAAC,CAAC;QAC1C,MAAM,UAAU,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;QAExC,MAAM,MAAM,GACV,OAAO,OAAO,CAAC,MAAM,KAAK,UAAU;YAClC,CAAC,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC;YAC3B,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;QAErB,MAAM,SAAS,GACb,OAAO,OAAO,CAAC,SAAS,KAAK,UAAU;YACrC,CAAC,CAAC,MAAM,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC;YAC9B,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;QAExB,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC;YACrC,MAAM;YACN,SAAS;YACT,UAAU;YACV,GAAG,CAAC,MAAM,CAAC,UAAU,IAAI,IAAI,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC;YACnE,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,IAAI,IAAI,IAAI;gBACrC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS;aACnC,CAAC;SACH,CAAC,CAAC;QAEH,OAAO,cAAc,CACnB,MAAM,EACN,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,SAAS,CAC3D,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/dist/server/index.d.ts

@@ -0,0 +1,4 @@
+export { adkEventStream, type AdkEventStreamOptions } from "./adkEventStream.js";
+export { parseAdkRequest, toAdkContent } from "./parseAdkRequest.js";
+export { createAdkApiRoute, type CreateAdkApiRouteOptions, } from "./createAdkApiRoute.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/server/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,4BAAyB;AAC9E,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,6BAA0B;AAClE,OAAO,EACL,iBAAiB,EACjB,KAAK,wBAAwB,GAC9B,+BAA4B"}

package/dist/server/index.js

@@ -0,0 +1,4 @@
+export { adkEventStream } from "./adkEventStream.js";
+export { parseAdkRequest, toAdkContent } from "./parseAdkRequest.js";
+export { createAdkApiRoute, } from "./createAdkApiRoute.js";
+//# sourceMappingURL=index.js.map

package/dist/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAA8B,4BAAyB;AAC9E,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,6BAA0B;AAClE,OAAO,EACL,iBAAiB,GAElB,+BAA4B"}

package/dist/server/parseAdkRequest.d.ts

@@ -0,0 +1,56 @@
+import type { AdkSendMessageConfig } from "../types.js";
+type ParsedAdkRequest = {
+    type: "message";
+    text: string;
+    parts?: Array<Record<string, unknown>> | undefined;
+    config: AdkSendMessageConfig;
+    stateDelta?: Record<string, unknown> | undefined;
+} | {
+    type: "tool-result";
+    toolCallId: string;
+    toolName: string;
+    result: unknown;
+    isError: boolean;
+    config: AdkSendMessageConfig;
+    stateDelta?: Record<string, unknown> | undefined;
+};
+/**
+ * Parses an incoming HTTP request into a structured ADK request.
+ *
+ * Supports two request shapes:
+ *
+ * 1. User message:
+ * ```json
+ * { "message": "Hello", "runConfig": {}, "stateDelta": {} }
+ * ```
+ *
+ * 2. Tool result:
+ * ```json
+ * {
+ *   "type": "tool-result",
+ *   "toolCallId": "call_123",
+ *   "toolName": "search",
+ *   "result": { ... },
+ *   "isError": false
+ * }
+ * ```
+ */
+export declare const parseAdkRequest: (request: Request) => Promise<ParsedAdkRequest>;
+/**
+ * Converts a parsed ADK request into a Google GenAI Content object
+ * suitable for `Runner.runAsync({ newMessage })`.
+ *
+ * @example
+ * ```ts
+ * const parsed = await parseAdkRequest(req);
+ * const newMessage = toAdkContent(parsed);
+ * const events = runner.runAsync({ userId, sessionId, newMessage, stateDelta: parsed.stateDelta });
+ * return adkEventStream(events);
+ * ```
+ */
+export declare const toAdkContent: (parsed: ParsedAdkRequest) => {
+    role: string;
+    parts: Array<Record<string, unknown>>;
+};
+export {};
+//# sourceMappingURL=parseAdkRequest.d.ts.map

package/dist/server/parseAdkRequest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseAdkRequest.d.ts","sourceRoot":"","sources":["../../src/server/parseAdkRequest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,oBAAiB;AAErD,KAAK,gBAAgB,GACjB;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IACnD,MAAM,EAAE,oBAAoB,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;CAClD,GACD;IACE,IAAI,EAAE,aAAa,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,oBAAoB,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;CAClD,CAAC;AAEN;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,eAAe,GAC1B,SAAS,OAAO,KACf,OAAO,CAAC,gBAAgB,CAwC1B,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,YAAY,GACvB,QAAQ,gBAAgB,KACvB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;CAsBvD,CAAC"}

package/dist/server/parseAdkRequest.js

@@ -0,0 +1,93 @@
+/**
+ * Parses an incoming HTTP request into a structured ADK request.
+ *
+ * Supports two request shapes:
+ *
+ * 1. User message:
+ * ```json
+ * { "message": "Hello", "runConfig": {}, "stateDelta": {} }
+ * ```
+ *
+ * 2. Tool result:
+ * ```json
+ * {
+ *   "type": "tool-result",
+ *   "toolCallId": "call_123",
+ *   "toolName": "search",
+ *   "result": { ... },
+ *   "isError": false
+ * }
+ * ```
+ */
+export const parseAdkRequest = async (request) => {
+    let body;
+    try {
+        body = (await request.json());
+    }
+    catch {
+        throw new Error("Invalid JSON in request body");
+    }
+    if (!body || typeof body !== "object" || Array.isArray(body)) {
+        throw new Error("Request body must be a JSON object");
+    }
+    const config = {};
+    if (body.runConfig !== undefined)
+        config.runConfig = body.runConfig;
+    if (body.checkpointId !== undefined)
+        config.checkpointId = body.checkpointId;
+    const stateDelta = body.stateDelta;
+    if (body.type === "tool-result") {
+        return {
+            type: "tool-result",
+            toolCallId: body.toolCallId ?? "",
+            toolName: body.toolName ?? "",
+            result: body.result,
+            isError: body.isError ?? false,
+            config,
+            ...(stateDelta != null && { stateDelta }),
+        };
+    }
+    return {
+        type: "message",
+        text: body.message ?? "",
+        ...(body.parts != null && {
+            parts: body.parts,
+        }),
+        config,
+        ...(stateDelta != null && { stateDelta }),
+    };
+};
+/**
+ * Converts a parsed ADK request into a Google GenAI Content object
+ * suitable for `Runner.runAsync({ newMessage })`.
+ *
+ * @example
+ * ```ts
+ * const parsed = await parseAdkRequest(req);
+ * const newMessage = toAdkContent(parsed);
+ * const events = runner.runAsync({ userId, sessionId, newMessage, stateDelta: parsed.stateDelta });
+ * return adkEventStream(events);
+ * ```
+ */
+export const toAdkContent = (parsed) => {
+    if (parsed.type === "tool-result") {
+        return {
+            role: "user",
+            parts: [
+                {
+                    functionResponse: {
+                        name: parsed.toolName,
+                        id: parsed.toolCallId,
+                        response: parsed.result,
+                    },
+                },
+            ],
+        };
+    }
+    // If raw parts are provided (multimodal), use them directly
+    if (parsed.parts?.length) {
+        return { role: "user", parts: parsed.parts };
+    }
+    return { role: "user", parts: [{ text: parsed.text }] };
+};
+//# sourceMappingURL=parseAdkRequest.js.map

package/dist/server/parseAdkRequest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseAdkRequest.js","sourceRoot":"","sources":["../../src/server/parseAdkRequest.ts"],"names":[],"mappings":"AAoBA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,EAClC,OAAgB,EACW,EAAE;IAC7B,IAAI,IAA6B,CAAC;IAClC,IAAI,CAAC;QACH,IAAI,GAAG,CAAC,MAAM,OAAO,CAAC,IAAI,EAAE,CAA4B,CAAC;IAC3D,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAClD,CAAC;IAED,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7D,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACxD,CAAC;IAED,MAAM,MAAM,GAAyB,EAAE,CAAC;IACxC,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS;QAAE,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;IACpE,IAAI,IAAI,CAAC,YAAY,KAAK,SAAS;QACjC,MAAM,CAAC,YAAY,GAAG,IAAI,CAAC,YAAsB,CAAC;IAEpD,MAAM,UAAU,GAAG,IAAI,CAAC,UAAiD,CAAC;IAE1E,IAAI,IAAI,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;QAChC,OAAO;YACL,IAAI,EAAE,aAAa;YACnB,UAAU,EAAG,IAAI,CAAC,UAAqB,IAAI,EAAE;YAC7C,QAAQ,EAAG,IAAI,CAAC,QAAmB,IAAI,EAAE;YACzC,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,OAAO,EAAG,IAAI,CAAC,OAAmB,IAAI,KAAK;YAC3C,MAAM;YACN,GAAG,CAAC,UAAU,IAAI,IAAI,IAAI,EAAE,UAAU,EAAE,CAAC;SAC1C,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI,EAAE,SAAS;QACf,IAAI,EAAG,IAAI,CAAC,OAAkB,IAAI,EAAE;QACpC,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,IAAI;YACxB,KAAK,EAAE,IAAI,CAAC,KAAuC;SACpD,CAAC;QACF,MAAM;QACN,GAAG,CAAC,UAAU,IAAI,IAAI,IAAI,EAAE,UAAU,EAAE,CAAC;KAC1C,CAAC;AACJ,CAAC,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,MAAwB,EACiC,EAAE;IAC3D,IAAI,MAAM,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;QAClC,OAAO;YACL,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE;gBACL;oBACE,gBAAgB,EAAE;wBAChB,IAAI,EAAE,MAAM,CAAC,QAAQ;wBACrB,EAAE,EAAE,MAAM,CAAC,UAAU;wBACrB,QAAQ,EAAE,MAAM,CAAC,MAAM;qBACxB;iBACF;aACF;SACF,CAAC;IACJ,CAAC;IAED,4DAA4D;IAC5D,IAAI,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;QACzB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;IAC/C,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;AAC1D,CAAC,CAAC"}

package/dist/structuredEvents.d.ts

@@ -0,0 +1,7 @@
+import type { AdkEvent, AdkStructuredEvent } from "./types.js";
+/**
+ * Converts a raw `AdkEvent` into an array of structured, typed events.
+ * Useful for building custom event renderers.
+ */
+export declare function toAdkStructuredEvents(event: AdkEvent): AdkStructuredEvent[];
+//# sourceMappingURL=structuredEvents.d.ts.map

package/dist/structuredEvents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structuredEvents.d.ts","sourceRoot":"","sources":["../src/structuredEvents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,kBAAkB,EAAE,mBAAgB;AAG5D;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,QAAQ,GAAG,kBAAkB,EAAE,CAyE3E"}

package/dist/structuredEvents.js

@@ -0,0 +1,79 @@
+import { isFinalResponse } from "./AdkEventAccumulator.js";
+/**
+ * Converts a raw `AdkEvent` into an array of structured, typed events.
+ * Useful for building custom event renderers.
+ */
+export function toAdkStructuredEvents(event) {
+    const result = [];
+    if (event.errorCode || event.errorMessage) {
+        const err = { type: "error" };
+        if (event.errorCode != null)
+            err.errorCode = event.errorCode;
+        if (event.errorMessage != null)
+            err.errorMessage = event.errorMessage;
+        result.push(err);
+    }
+    const parts = event.content?.parts;
+    if (parts) {
+        for (const part of parts) {
+            if (part.text != null) {
+                if (part.thought) {
+                    result.push({ type: "thought", content: part.text });
+                }
+                else {
+                    result.push({ type: "content", content: part.text });
+                }
+            }
+            if (part.functionCall) {
+                const call = {
+                    type: "tool_call",
+                    call: { name: part.functionCall.name, args: part.functionCall.args },
+                };
+                if (part.functionCall.id != null)
+                    call.call.id = part.functionCall.id;
+                result.push(call);
+            }
+            if (part.functionResponse) {
+                const tr = {
+                    type: "tool_result",
+                    result: {
+                        name: part.functionResponse.name,
+                        response: part.functionResponse.response,
+                    },
+                };
+                if (part.functionResponse.id != null)
+                    tr.result.id = part.functionResponse.id;
+                result.push(tr);
+            }
+            if (part.executableCode) {
+                const ce = {
+                    type: "call_code",
+                    code: { code: part.executableCode.code },
+                };
+                if (part.executableCode.language != null)
+                    ce.code.language = part.executableCode.language;
+                result.push(ce);
+            }
+            if (part.codeExecutionResult) {
+                const cr = {
+                    type: "code_result",
+                    result: { output: part.codeExecutionResult.output },
+                };
+                if (part.codeExecutionResult.outcome != null)
+                    cr.result.outcome = part.codeExecutionResult.outcome;
+                result.push(cr);
+            }
+        }
+    }
+    if (event.actions?.requestedToolConfirmations) {
+        result.push({
+            type: "tool_confirmation",
+            confirmations: event.actions.requestedToolConfirmations,
+        });
+    }
+    if (isFinalResponse(event) && result.length === 0) {
+        result.push({ type: "finished" });
+    }
+    return result;
+}
+//# sourceMappingURL=structuredEvents.js.map

package/dist/structuredEvents.js.map

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