@assistant-ui/react-google-adk 0.0.17 → 0.0.18

package/dist/AdkClient.js

@@ -20,7 +20,9 @@ import { SSEEventDecoder } from "assistant-stream/utils";
 * ```
 */
 function createAdkStream(options) {
+	if (options.appName === "") throw new Error("createAdkStream direct mode requires a non-empty \"appName\".");
 	const isDirect = options.appName != null;
+	if (isDirect && (options.userId == null || options.userId === "")) throw new Error("createAdkStream direct mode requires \"userId\" when \"appName\" is provided.");
 	return async function* (messages, config) {
 		const headers = await resolveHeaders(options.headers);
 		let url;
@@ -50,9 +52,18 @@ function createAdkStream(options) {
 			signal: config.abortSignal
 		});
 		if (!response.ok) throw new Error(`ADK request failed: ${response.status} ${response.statusText}`);
+		validateEventStreamContentType(response);
 		yield* parseSSEResponse(response);
 	};
 }
+function validateEventStreamContentType(response) {
+	const contentType = response.headers.get("Content-Type");
+	if (contentType?.split(";", 1)[0]?.trim().toLowerCase() !== "text/event-stream") {
+		const received = contentType ? `"${contentType}"` : "no Content-Type header";
+		response.body?.cancel().catch(() => void 0);
+		throw new Error(`Expected ADK stream response Content-Type "text/event-stream", received ${received}`);
+	}
+}
 async function resolveHeaders(headers) {
 	if (!headers) return {};
 	if (typeof headers === "function") return await headers();

package/dist/AdkClient.js.map

@@ -1 +1 @@
-{"version":3,"file":"AdkClient.js","names":[],"sources":["../src/AdkClient.ts"],"sourcesContent":["import { SSEEventDecoder } from \"assistant-stream/utils\";\nimport { contentToParts } from \"./contentToParts\";\nimport { trimTrailingSlashes } from \"./trimTrailingSlashes\";\nimport type {\n  AdkEvent,\n  AdkEventPart,\n  AdkMessage,\n  AdkStreamCallback,\n} from \"./types\";\n\nexport type CreateAdkStreamOptions = {\n  /**\n   * URL to POST to. Either a proxy route (e.g. \"/api/adk\") or\n   * an ADK server base URL (e.g. \"http://localhost:8000\").\n   *\n   * When `appName` and `userId` are provided, POSTs to `${api}/run_sse`\n   * in ADK-native format. Otherwise POSTs directly to `api` in proxy format\n   * (compatible with `parseAdkRequest`).\n   */\n  api: string;\n\n  /**\n   * ADK application name. When provided along with `userId`,\n   * enables direct connection to an ADK server.\n   */\n  appName?: string | undefined;\n\n  /**\n   * ADK user ID. Required when `appName` is provided.\n   */\n  userId?: string | undefined;\n\n  /**\n   * Extra headers to send with every request.\n   * Can be a static object or an async function for dynamic auth tokens.\n   */\n  headers?:\n    | Record<string, string>\n    | (() => Record<string, string> | Promise<Record<string, string>>)\n    | undefined;\n};\n\n/**\n * Creates an `AdkStreamCallback` that connects to an ADK endpoint.\n *\n * @example Proxy mode (with a Next.js API route)\n * ```ts\n * const stream = createAdkStream({ api: \"/api/adk\" });\n * ```\n *\n * @example Direct mode (connecting to ADK server)\n * ```ts\n * const stream = createAdkStream({\n *   api: \"http://localhost:8000\",\n *   appName: \"my-app\",\n *   userId: \"user-1\",\n * });\n * ```\n */\nexport function createAdkStream(\n  options: CreateAdkStreamOptions,\n): AdkStreamCallback {\n  const isDirect = options.appName != null;\n\n  return async function* (messages, config) {\n    const headers = await resolveHeaders(options.headers);\n\n    let url: string;\n    let body: unknown;\n\n    if (isDirect) {\n      // Direct mode: POST to ADK server's /run_sse\n      url = `${trimTrailingSlashes(options.api)}/run_sse`;\n      const { externalId } = await config.initialize();\n      body = {\n        appName: options.appName,\n        userId: options.userId,\n        sessionId: externalId,\n        newMessage: messagesToContent(messages),\n        streaming: true,\n        ...(config.stateDelta != null && { stateDelta: config.stateDelta }),\n      };\n    } else {\n      // Proxy mode: POST in parseAdkRequest-compatible format\n      url = options.api;\n      body = messagesToProxyBody(messages, config);\n    }\n\n    const response = await fetch(url, {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/json\", ...headers },\n      body: JSON.stringify(body),\n      signal: config.abortSignal,\n    });\n\n    if (!response.ok) {\n      throw new Error(\n        `ADK request failed: ${response.status} ${response.statusText}`,\n      );\n    }\n\n    yield* parseSSEResponse(response);\n  };\n}\n\n// ── Internal helpers ──\n\nasync function resolveHeaders(\n  headers:\n    | Record<string, string>\n    | (() => Record<string, string> | Promise<Record<string, string>>)\n    | undefined,\n): Promise<Record<string, string>> {\n  if (!headers) return {};\n  if (typeof headers === \"function\") return await headers();\n  return headers;\n}\n\n/**\n * Converts AdkMessage[] (new messages) into ADK Content format\n * for the direct `/run_sse` endpoint.\n */\nfunction messagesToContent(messages: AdkMessage[]): {\n  role: string;\n  parts: AdkEventPart[];\n} {\n  const parts: AdkEventPart[] = [];\n\n  for (const msg of messages) {\n    if (msg.type === \"human\") {\n      for (const part of contentToParts(msg.content)) {\n        parts.push(part);\n      }\n    } else if (msg.type === \"tool\") {\n      let response: unknown;\n      try {\n        response = JSON.parse(msg.content);\n      } catch {\n        response = msg.content;\n      }\n      parts.push({\n        functionResponse: {\n          name: msg.name,\n          id: msg.tool_call_id,\n          response,\n        },\n      });\n    }\n  }\n\n  if (parts.length === 0) {\n    parts.push({ text: \"\" });\n  }\n\n  return { role: \"user\", parts };\n}\n\n/**\n * Converts AdkMessage[] into the proxy request body format\n * (compatible with `parseAdkRequest`).\n */\nfunction messagesToProxyBody(\n  messages: AdkMessage[],\n  config: {\n    runConfig?: unknown;\n    checkpointId?: string | undefined;\n    stateDelta?: Record<string, unknown> | undefined;\n  },\n): Record<string, unknown> {\n  const body: Record<string, unknown> = {};\n\n  if (config.runConfig != null) body.runConfig = config.runConfig;\n  if (config.checkpointId != null) body.checkpointId = config.checkpointId;\n  if (config.stateDelta != null) body.stateDelta = config.stateDelta;\n\n  // Check if there's a tool result\n  const toolMsg = messages.find((m) => m.type === \"tool\");\n  if (toolMsg && toolMsg.type === \"tool\") {\n    // If there are also other messages (e.g. cancellations), send as parts\n    if (messages.length > 1) {\n      body.parts = messagesToContent(messages).parts;\n      return body;\n    }\n\n    let result: unknown;\n    try {\n      result = JSON.parse(toolMsg.content);\n    } catch {\n      result = toolMsg.content;\n    }\n    body.type = \"tool-result\";\n    body.toolCallId = toolMsg.tool_call_id;\n    body.toolName = toolMsg.name;\n    body.result = result;\n    body.isError = toolMsg.status === \"error\";\n    return body;\n  }\n\n  // Human message(s) - possibly with cancellation tool results prepended\n  if (messages.length === 1 && messages[0]!.type === \"human\") {\n    const msg = messages[0]!;\n    if (typeof msg.content === \"string\") {\n      body.message = msg.content;\n    } else {\n      body.parts = contentToParts(msg.content);\n    }\n    return body;\n  }\n\n  // Multiple messages (e.g. cancellations + human): send as parts array\n  body.parts = messagesToContent(messages).parts;\n  return body;\n}\n\nasync function* parseSSEResponse(response: Response): AsyncGenerator<AdkEvent> {\n  const reader = response.body!.getReader();\n  const decoder = new TextDecoder();\n  const sseDecoder = new SSEEventDecoder({ trailing: \"dispatch\" });\n\n  try {\n    while (true) {\n      const { done, value } = await reader.read();\n      if (done) {\n        for (const event of sseDecoder.push(decoder.decode())) {\n          yield JSON.parse(event.data) as AdkEvent;\n        }\n        break;\n      }\n\n      for (const event of sseDecoder.push(\n        decoder.decode(value, { stream: true }),\n      )) {\n        yield JSON.parse(event.data) as AdkEvent;\n      }\n    }\n\n    const trailing = sseDecoder.flush();\n    if (trailing !== null) yield JSON.parse(trailing.data) as AdkEvent;\n  } finally {\n    reader.releaseLock();\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"AdkClient.js","names":[],"sources":["../src/AdkClient.ts"],"sourcesContent":["import { SSEEventDecoder } from \"assistant-stream/utils\";\nimport { contentToParts } from \"./contentToParts\";\nimport { trimTrailingSlashes } from \"./trimTrailingSlashes\";\nimport type {\n  AdkEvent,\n  AdkEventPart,\n  AdkMessage,\n  AdkStreamCallback,\n} from \"./types\";\n\nexport type CreateAdkStreamOptions = {\n  /**\n   * URL to POST to. Either a proxy route (e.g. \"/api/adk\") or\n   * an ADK server base URL (e.g. \"http://localhost:8000\").\n   *\n   * When `appName` and `userId` are provided, POSTs to `${api}/run_sse`\n   * in ADK-native format. Otherwise POSTs directly to `api` in proxy format\n   * (compatible with `parseAdkRequest`).\n   */\n  api: string;\n\n  /**\n   * ADK application name. When provided along with `userId`,\n   * enables direct connection to an ADK server.\n   */\n  appName?: string | undefined;\n\n  /**\n   * ADK user ID. Required when `appName` is provided.\n   */\n  userId?: string | undefined;\n\n  /**\n   * Extra headers to send with every request.\n   * Can be a static object or an async function for dynamic auth tokens.\n   */\n  headers?:\n    | Record<string, string>\n    | (() => Record<string, string> | Promise<Record<string, string>>)\n    | undefined;\n};\n\n/**\n * Creates an `AdkStreamCallback` that connects to an ADK endpoint.\n *\n * @example Proxy mode (with a Next.js API route)\n * ```ts\n * const stream = createAdkStream({ api: \"/api/adk\" });\n * ```\n *\n * @example Direct mode (connecting to ADK server)\n * ```ts\n * const stream = createAdkStream({\n *   api: \"http://localhost:8000\",\n *   appName: \"my-app\",\n *   userId: \"user-1\",\n * });\n * ```\n */\nexport function createAdkStream(\n  options: CreateAdkStreamOptions,\n): AdkStreamCallback {\n  if (options.appName === \"\") {\n    throw new Error(\n      'createAdkStream direct mode requires a non-empty \"appName\".',\n    );\n  }\n\n  const isDirect = options.appName != null;\n  if (isDirect && (options.userId == null || options.userId === \"\")) {\n    throw new Error(\n      'createAdkStream direct mode requires \"userId\" when \"appName\" is provided.',\n    );\n  }\n\n  return async function* (messages, config) {\n    const headers = await resolveHeaders(options.headers);\n\n    let url: string;\n    let body: unknown;\n\n    if (isDirect) {\n      // Direct mode: POST to ADK server's /run_sse\n      url = `${trimTrailingSlashes(options.api)}/run_sse`;\n      const { externalId } = await config.initialize();\n      body = {\n        appName: options.appName,\n        userId: options.userId,\n        sessionId: externalId,\n        newMessage: messagesToContent(messages),\n        streaming: true,\n        ...(config.stateDelta != null && { stateDelta: config.stateDelta }),\n      };\n    } else {\n      // Proxy mode: POST in parseAdkRequest-compatible format\n      url = options.api;\n      body = messagesToProxyBody(messages, config);\n    }\n\n    const response = await fetch(url, {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/json\", ...headers },\n      body: JSON.stringify(body),\n      signal: config.abortSignal,\n    });\n\n    if (!response.ok) {\n      throw new Error(\n        `ADK request failed: ${response.status} ${response.statusText}`,\n      );\n    }\n\n    validateEventStreamContentType(response);\n    yield* parseSSEResponse(response);\n  };\n}\n\n// ── Internal helpers ──\n\nfunction validateEventStreamContentType(response: Response): void {\n  const contentType = response.headers.get(\"Content-Type\");\n  const mediaType = contentType?.split(\";\", 1)[0]?.trim().toLowerCase();\n  if (mediaType !== \"text/event-stream\") {\n    const received = contentType\n      ? `\"${contentType}\"`\n      : \"no Content-Type header\";\n    void response.body?.cancel().catch(() => undefined);\n    throw new Error(\n      `Expected ADK stream response Content-Type \"text/event-stream\", received ${received}`,\n    );\n  }\n}\n\nasync function resolveHeaders(\n  headers:\n    | Record<string, string>\n    | (() => Record<string, string> | Promise<Record<string, string>>)\n    | undefined,\n): Promise<Record<string, string>> {\n  if (!headers) return {};\n  if (typeof headers === \"function\") return await headers();\n  return headers;\n}\n\n/**\n * Converts AdkMessage[] (new messages) into ADK Content format\n * for the direct `/run_sse` endpoint.\n */\nfunction messagesToContent(messages: AdkMessage[]): {\n  role: string;\n  parts: AdkEventPart[];\n} {\n  const parts: AdkEventPart[] = [];\n\n  for (const msg of messages) {\n    if (msg.type === \"human\") {\n      for (const part of contentToParts(msg.content)) {\n        parts.push(part);\n      }\n    } else if (msg.type === \"tool\") {\n      let response: unknown;\n      try {\n        response = JSON.parse(msg.content);\n      } catch {\n        response = msg.content;\n      }\n      parts.push({\n        functionResponse: {\n          name: msg.name,\n          id: msg.tool_call_id,\n          response,\n        },\n      });\n    }\n  }\n\n  if (parts.length === 0) {\n    parts.push({ text: \"\" });\n  }\n\n  return { role: \"user\", parts };\n}\n\n/**\n * Converts AdkMessage[] into the proxy request body format\n * (compatible with `parseAdkRequest`).\n */\nfunction messagesToProxyBody(\n  messages: AdkMessage[],\n  config: {\n    runConfig?: unknown;\n    checkpointId?: string | undefined;\n    stateDelta?: Record<string, unknown> | undefined;\n  },\n): Record<string, unknown> {\n  const body: Record<string, unknown> = {};\n\n  if (config.runConfig != null) body.runConfig = config.runConfig;\n  if (config.checkpointId != null) body.checkpointId = config.checkpointId;\n  if (config.stateDelta != null) body.stateDelta = config.stateDelta;\n\n  // Check if there's a tool result\n  const toolMsg = messages.find((m) => m.type === \"tool\");\n  if (toolMsg && toolMsg.type === \"tool\") {\n    // If there are also other messages (e.g. cancellations), send as parts\n    if (messages.length > 1) {\n      body.parts = messagesToContent(messages).parts;\n      return body;\n    }\n\n    let result: unknown;\n    try {\n      result = JSON.parse(toolMsg.content);\n    } catch {\n      result = toolMsg.content;\n    }\n    body.type = \"tool-result\";\n    body.toolCallId = toolMsg.tool_call_id;\n    body.toolName = toolMsg.name;\n    body.result = result;\n    body.isError = toolMsg.status === \"error\";\n    return body;\n  }\n\n  // Human message(s) - possibly with cancellation tool results prepended\n  if (messages.length === 1 && messages[0]!.type === \"human\") {\n    const msg = messages[0]!;\n    if (typeof msg.content === \"string\") {\n      body.message = msg.content;\n    } else {\n      body.parts = contentToParts(msg.content);\n    }\n    return body;\n  }\n\n  // Multiple messages (e.g. cancellations + human): send as parts array\n  body.parts = messagesToContent(messages).parts;\n  return body;\n}\n\nasync function* parseSSEResponse(response: Response): AsyncGenerator<AdkEvent> {\n  const reader = response.body!.getReader();\n  const decoder = new TextDecoder();\n  const sseDecoder = new SSEEventDecoder({ trailing: \"dispatch\" });\n\n  try {\n    while (true) {\n      const { done, value } = await reader.read();\n      if (done) {\n        for (const event of sseDecoder.push(decoder.decode())) {\n          yield JSON.parse(event.data) as AdkEvent;\n        }\n        break;\n      }\n\n      for (const event of sseDecoder.push(\n        decoder.decode(value, { stream: true }),\n      )) {\n        yield JSON.parse(event.data) as AdkEvent;\n      }\n    }\n\n    const trailing = sseDecoder.flush();\n    if (trailing !== null) yield JSON.parse(trailing.data) as AdkEvent;\n  } finally {\n    reader.releaseLock();\n  }\n}\n"],"mappings":"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"}

package/dist/AdkEventAccumulator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AdkEventAccumulator.d.ts","names":[],"sources":["../src/AdkEventAccumulator.ts"],"mappings":";;;;;;cAuBa,kBAAmB,OAAO;cAqJ1B;UACH;UACA;UACA;UACA;UACA;UACA;UACA;UAIA;UACA;UACA;UACA;UACA;UACA;cACI,kBAAkB;EAQ9B,aAAa,UAAU,WAAW;UAwL1B;UAmJA;UAmBA;UAMA;UAuBA;UASA;UAYA;UAeA;EAMR,eAAe;EAIf,iBAAiB;EAIjB,oBAAoB;EAIpB;IAAkB;IAA2B;;EAI7C;EAIA;EAIA,wBAAwB;EAIxB,mBAAmB;EAInB;EAIA,sBAAsB,YAAY"}
+{"version":3,"file":"AdkEventAccumulator.d.ts","names":[],"sources":["../src/AdkEventAccumulator.ts"],"mappings":";;;;;;cAuBa,kBAAmB,OAAO;cAqJ1B;UACH;UACA;UACA;UACA;UACA;UACA;UACA;UAIA;UACA;UACA;UACA;UACA;UACA;EACI,YAAA,kBAAkB;EAQ9B,aAAa,UAAU,WAAW;UAwL1B;UAmJA;UAmBA;UAMA;UAuBA;UASA;UAYA;UAeA;EAMR,eAAe;EAIf,iBAAiB;EAIjB,oBAAoB;EAIpB;IAAkB;IAA2B;;EAI7C;EAIA;EAIA,wBAAwB;EAIxB,mBAAmB;EAInB;EAIA,sBAAsB,YAAY"}

package/dist/AdkSessionAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AdkSessionAdapter.d.ts","names":[],"sources":["../src/AdkSessionAdapter.ts"],"mappings":";;;KAWY;;;;EAIV;;;;EAKA;;;;EAKA;;;;EAKA,UACI,gCACO,yBAAyB,QAAQ;;KAIlC;EACV;IAAe;IAAkB;;EACjC;;KAGG;EACH,SAAS;EACT,OAAO,sBAAsB;IAAU,UAAU;;EACjD;IACE,OAAO,sBAAsB;IAC7B,OACE,mBACA,sBACA,qBACG,QAAQ;IACb,eACE,mBACA,yBACG;IACL,SAAS,mBAAmB,yBAAyB;;;;;;;;;;;;;;;;;;;;;;iBAuBzC,wBACd,SAAS,2BACR"}
+{"version":3,"file":"AdkSessionAdapter.d.ts","names":[],"sources":["../src/AdkSessionAdapter.ts"],"mappings":";;;KAWY;;;;EAIV;;;;EAKA;;;;EAKA;;;;EAKA,UACI,gCACO,yBAAyB,QAAQ;;KAIlC;EACV;IAAe;IAAkB;;EACjC;;KAGG;EACH,SAAS;EACT,OAAO,sBAAsB;IAAU,UAAU;;EACjD;IACE,OAAO,sBAAsB;IAC7B,OACE,mBACA,sBACA,qBACG,QAAQ;IACb,eACE,mBACA,yBACG;IACL,SAAS,mBAAmB,yBAAyB;;;;;;;;;;;;;;;;;;;;;;iBAmJzC,wBACd,SAAS,2BACR"}

package/dist/AdkSessionAdapter.js

@@ -1,6 +1,49 @@
 import { trimTrailingSlashes } from "./trimTrailingSlashes.js";
 import { AdkEventAccumulator } from "./AdkEventAccumulator.js";
 //#region src/AdkSessionAdapter.ts
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const isAdkSessionResponse = (value) => {
+	if (!isRecord(value)) return false;
+	const id = value.id;
+	return typeof id === "string" && id.length > 0;
+};
+const parseAdkSessionResponse = (value, operation) => {
+	if (!isAdkSessionResponse(value)) throw new Error(`Invalid ADK session ${operation} response: expected an object with a non-empty string "id".`);
+	return value;
+};
+const parseAdkSessionListResponse = (value) => {
+	if (!Array.isArray(value)) throw new Error("Invalid ADK session list response: expected an array of sessions.");
+	return value.map((session, index) => {
+		if (!isAdkSessionResponse(session)) throw new Error(`Invalid ADK session list response: session at index ${index} must have a non-empty string "id".`);
+		return session;
+	});
+};
+const parseAdkArtifactListResponse = (value) => {
+	if (!Array.isArray(value)) throw new Error("Invalid ADK artifact list response: expected an array of artifact names.");
+	return value.map((artifact, index) => {
+		if (typeof artifact === "string" && artifact.length > 0) return artifact;
+		if (isRecord(artifact)) {
+			const filename = artifact.filename;
+			if (typeof filename === "string" && filename.length > 0) return filename;
+		}
+		throw new Error(`Invalid ADK artifact list response: artifact at index ${index} must be a non-empty string or an object with a non-empty string "filename".`);
+	});
+};
+const parseAdkArtifactResponse = (value) => {
+	if (!isRecord(value)) throw new Error("Invalid ADK artifact load response: expected an object containing \"text\" or \"inlineData\".");
+	const { text, inlineData } = value;
+	if (text === void 0 && inlineData === void 0) throw new Error("Invalid ADK artifact load response: expected an object containing \"text\" or \"inlineData\".");
+	if (text !== void 0 && typeof text !== "string") throw new Error("Invalid ADK artifact load response: \"text\" must be a string when present.");
+	if (inlineData !== void 0 && (!isRecord(inlineData) || typeof inlineData.mimeType !== "string" || typeof inlineData.data !== "string")) throw new Error("Invalid ADK artifact load response: \"inlineData\" must contain string \"mimeType\" and \"data\" fields.");
+	return value;
+};
+const parseAdkArtifactVersionsResponse = (value) => {
+	if (!Array.isArray(value)) throw new Error("Invalid ADK artifact versions response: expected an array of version numbers.");
+	return value.map((version, index) => {
+		if (typeof version !== "number" || !Number.isInteger(version) || version < 0) throw new Error(`Invalid ADK artifact versions response: version at index ${index} must be a non-negative integer.`);
+		return version;
+	});
+};
 /**
 * Creates a `RemoteThreadListAdapter` backed by ADK's session REST API,
 * plus a `load` function that reconstructs messages from session events.
@@ -33,7 +76,7 @@ function createAdkSessionAdapter(options) {
 			const headers = await getHeaders();
 			const res = await fetch(baseUrl, { headers });
 			if (!res.ok) throw new Error(`Failed to list sessions: ${res.status}`);
-			return { threads: (await res.json()).map((session) => ({
+			return { threads: parseAdkSessionListResponse(await res.json()).map((session) => ({
 				status: "regular",
 				remoteId: session.id,
 				externalId: session.id,
@@ -51,7 +94,7 @@ function createAdkSessionAdapter(options) {
 				body: JSON.stringify({})
 			});
 			if (!res.ok) throw new Error(`Failed to create session: ${res.status}`);
-			const session = await res.json();
+			const session = parseAdkSessionResponse(await res.json(), "create");
 			return {
 				remoteId: session.id,
 				externalId: session.id
@@ -77,7 +120,7 @@ function createAdkSessionAdapter(options) {
 			const headers = await getHeaders();
 			const res = await fetch(`${baseUrl}/${encodeURIComponent(threadId)}`, { headers });
 			if (!res.ok) throw new Error(`Session not found: ${res.status}`);
-			const session = await res.json();
+			const session = parseAdkSessionResponse(await res.json(), "fetch");
 			return {
 				status: "regular",
 				remoteId: session.id,
@@ -90,11 +133,13 @@ function createAdkSessionAdapter(options) {
 		const headers = await getHeaders();
 		const res = await fetch(`${baseUrl}/${encodeURIComponent(sessionId)}`, { headers });
 		if (!res.ok) throw new Error(`Failed to load session: ${res.status}`);
-		const session = await res.json();
-		if (!session.events?.length) return { messages: [] };
+		const session = parseAdkSessionResponse(await res.json(), "load");
+		if (session.events !== void 0 && !Array.isArray(session.events)) throw new Error("Invalid ADK session load response: expected \"events\" to be an array when present.");
+		const events = session.events;
+		if (!events?.length) return { messages: [] };
 		const accumulator = new AdkEventAccumulator();
 		let messages = [];
-		for (const event of session.events) messages = accumulator.processEvent(event);
+		for (const event of events) messages = accumulator.processEvent(event);
 		return { messages };
 	};
 	const artifactBaseUrl = (sessionId) => `${baseUrl}/${encodeURIComponent(sessionId)}/artifacts`;
@@ -106,7 +151,7 @@ function createAdkSessionAdapter(options) {
 				const headers = await getHeaders();
 				const res = await fetch(artifactBaseUrl(sessionId), { headers });
 				if (!res.ok) throw new Error(`Failed to list artifacts: ${res.status}`);
-				return (await res.json()).map((a) => a.filename);
+				return parseAdkArtifactListResponse(await res.json());
 			},
 			async load(sessionId, artifactName, version) {
 				const headers = await getHeaders();
@@ -114,14 +159,14 @@ function createAdkSessionAdapter(options) {
 				if (version != null) url += `/versions/${version}`;
 				const res = await fetch(url, { headers });
 				if (!res.ok) throw new Error(`Failed to load artifact: ${res.status}`);
-				return await res.json();
+				return parseAdkArtifactResponse(await res.json());
 			},
 			async listVersions(sessionId, artifactName) {
 				const headers = await getHeaders();
 				const url = `${artifactBaseUrl(sessionId)}/${encodeURIComponent(artifactName)}/versions`;
 				const res = await fetch(url, { headers });
 				if (!res.ok) throw new Error(`Failed to list artifact versions: ${res.status}`);
-				return await res.json();
+				return parseAdkArtifactVersionsResponse(await res.json());
 			},
 			async delete(sessionId, artifactName) {
 				const headers = await getHeaders();

package/dist/AdkSessionAdapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"AdkSessionAdapter.js","names":[],"sources":["../src/AdkSessionAdapter.ts"],"sourcesContent":["import type { AssistantStream, AssistantStreamChunk } from \"assistant-stream\";\nimport type {\n  RemoteThreadInitializeResponse,\n  RemoteThreadListAdapter,\n  RemoteThreadListResponse,\n  RemoteThreadMetadata,\n} from \"@assistant-ui/core\";\nimport { AdkEventAccumulator } from \"./AdkEventAccumulator\";\nimport type { AdkEvent, AdkMessage } from \"./types\";\nimport { trimTrailingSlashes } from \"./trimTrailingSlashes\";\n\nexport type AdkSessionAdapterOptions = {\n  /**\n   * ADK server base URL (e.g. \"http://localhost:8000\").\n   */\n  apiUrl: string;\n\n  /**\n   * ADK application name.\n   */\n  appName: string;\n\n  /**\n   * ADK user ID.\n   */\n  userId: string;\n\n  /**\n   * Extra headers for API requests.\n   */\n  headers?:\n    | Record<string, string>\n    | (() => Record<string, string> | Promise<Record<string, string>>)\n    | undefined;\n};\n\nexport type AdkArtifactData = {\n  inlineData?: { mimeType: string; data: string } | undefined;\n  text?: string | undefined;\n};\n\ntype AdkSessionAdapterResult = {\n  adapter: RemoteThreadListAdapter;\n  load: (sessionId: string) => Promise<{ messages: AdkMessage[] }>;\n  artifacts: {\n    list: (sessionId: string) => Promise<string[]>;\n    load: (\n      sessionId: string,\n      artifactName: string,\n      version?: number,\n    ) => Promise<AdkArtifactData>;\n    listVersions: (\n      sessionId: string,\n      artifactName: string,\n    ) => Promise<number[]>;\n    delete: (sessionId: string, artifactName: string) => Promise<void>;\n  };\n};\n\n/**\n * Creates a `RemoteThreadListAdapter` backed by ADK's session REST API,\n * plus a `load` function that reconstructs messages from session events.\n *\n * @example\n * ```ts\n * const { adapter, load } = createAdkSessionAdapter({\n *   apiUrl: \"http://localhost:8000\",\n *   appName: \"my-app\",\n *   userId: \"user-1\",\n * });\n *\n * const runtime = useAdkRuntime({\n *   stream: createAdkStream({ ... }),\n *   sessionAdapter: adapter,\n *   load,\n * });\n * ```\n */\nexport function createAdkSessionAdapter(\n  options: AdkSessionAdapterOptions,\n): AdkSessionAdapterResult {\n  const { apiUrl, appName, userId } = options;\n  const normalizedApiUrl = trimTrailingSlashes(apiUrl);\n  const baseUrl = `${normalizedApiUrl}/apps/${encodeURIComponent(appName)}/users/${encodeURIComponent(userId)}/sessions`;\n\n  const getHeaders = async (): Promise<Record<string, string>> => {\n    if (!options.headers) return {};\n    if (typeof options.headers === \"function\") return await options.headers();\n    return options.headers;\n  };\n\n  const adapter: RemoteThreadListAdapter = {\n    async list(): Promise<RemoteThreadListResponse> {\n      const headers = await getHeaders();\n      const res = await fetch(baseUrl, { headers });\n      if (!res.ok) {\n        throw new Error(`Failed to list sessions: ${res.status}`);\n      }\n      const data = (await res.json()) as Array<{\n        id: string;\n        app_name?: string;\n        user_id?: string;\n        last_update_time?: number;\n      }>;\n\n      const threads: RemoteThreadMetadata[] = data.map((session) => ({\n        status: \"regular\" as const,\n        remoteId: session.id,\n        externalId: session.id,\n        title: undefined,\n      }));\n\n      return { threads };\n    },\n\n    async initialize(\n      _threadId: string,\n    ): Promise<RemoteThreadInitializeResponse> {\n      const headers = await getHeaders();\n      const res = await fetch(baseUrl, {\n        method: \"POST\",\n        headers: { \"Content-Type\": \"application/json\", ...headers },\n        body: JSON.stringify({}),\n      });\n      if (!res.ok) {\n        throw new Error(`Failed to create session: ${res.status}`);\n      }\n      const session = (await res.json()) as { id: string };\n      return { remoteId: session.id, externalId: session.id };\n    },\n\n    async delete(remoteId: string): Promise<void> {\n      const headers = await getHeaders();\n      const res = await fetch(`${baseUrl}/${encodeURIComponent(remoteId)}`, {\n        method: \"DELETE\",\n        headers,\n      });\n      if (!res.ok && res.status !== 404) {\n        throw new Error(`Failed to delete session: ${res.status}`);\n      }\n    },\n\n    async rename(): Promise<void> {\n      // ADK sessions don't support titles\n    },\n\n    async archive(): Promise<void> {\n      // ADK sessions don't support archiving\n    },\n\n    async unarchive(): Promise<void> {\n      // ADK sessions don't support archiving\n    },\n\n    generateTitle(): Promise<AssistantStream> {\n      // Title generation not supported without assistant-cloud\n      return Promise.resolve(\n        new ReadableStream<AssistantStreamChunk>({\n          start(controller) {\n            controller.close();\n          },\n        }),\n      );\n    },\n\n    async fetch(threadId: string): Promise<RemoteThreadMetadata> {\n      const headers = await getHeaders();\n      const res = await fetch(`${baseUrl}/${encodeURIComponent(threadId)}`, {\n        headers,\n      });\n      if (!res.ok) {\n        throw new Error(`Session not found: ${res.status}`);\n      }\n      const session = (await res.json()) as { id: string };\n      return {\n        status: \"regular\",\n        remoteId: session.id,\n        externalId: session.id,\n        title: undefined,\n      };\n    },\n  };\n\n  const load = async (\n    sessionId: string,\n  ): Promise<{ messages: AdkMessage[] }> => {\n    const headers = await getHeaders();\n    const res = await fetch(`${baseUrl}/${encodeURIComponent(sessionId)}`, {\n      headers,\n    });\n    if (!res.ok) {\n      throw new Error(`Failed to load session: ${res.status}`);\n    }\n    const session = (await res.json()) as {\n      id: string;\n      events?: AdkEvent[];\n    };\n\n    if (!session.events?.length) {\n      return { messages: [] };\n    }\n\n    const accumulator = new AdkEventAccumulator();\n    let messages: AdkMessage[] = [];\n    for (const event of session.events) {\n      messages = accumulator.processEvent(event);\n    }\n    return { messages };\n  };\n\n  const artifactBaseUrl = (sessionId: string) =>\n    `${baseUrl}/${encodeURIComponent(sessionId)}/artifacts`;\n\n  const artifacts: AdkSessionAdapterResult[\"artifacts\"] = {\n    async list(sessionId) {\n      const headers = await getHeaders();\n      const res = await fetch(artifactBaseUrl(sessionId), { headers });\n      if (!res.ok) throw new Error(`Failed to list artifacts: ${res.status}`);\n      const data = (await res.json()) as Array<{ filename: string }>;\n      return data.map((a) => a.filename);\n    },\n\n    async load(sessionId, artifactName, version?) {\n      const headers = await getHeaders();\n      let url = `${artifactBaseUrl(sessionId)}/${encodeURIComponent(artifactName)}`;\n      if (version != null) url += `/versions/${version}`;\n      const res = await fetch(url, { headers });\n      if (!res.ok) throw new Error(`Failed to load artifact: ${res.status}`);\n      return (await res.json()) as AdkArtifactData;\n    },\n\n    async listVersions(sessionId, artifactName) {\n      const headers = await getHeaders();\n      const url = `${artifactBaseUrl(sessionId)}/${encodeURIComponent(artifactName)}/versions`;\n      const res = await fetch(url, { headers });\n      if (!res.ok) {\n        throw new Error(`Failed to list artifact versions: ${res.status}`);\n      }\n      return (await res.json()) as number[];\n    },\n\n    async delete(sessionId, artifactName) {\n      const headers = await getHeaders();\n      const url = `${artifactBaseUrl(sessionId)}/${encodeURIComponent(artifactName)}`;\n      const res = await fetch(url, { method: \"DELETE\", headers });\n      if (!res.ok && res.status !== 404) {\n        throw new Error(`Failed to delete artifact: ${res.status}`);\n      }\n    },\n  };\n\n  return { adapter, load, artifacts };\n}\n"],"mappings":"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"}
+{"version":3,"file":"AdkSessionAdapter.js","names":[],"sources":["../src/AdkSessionAdapter.ts"],"sourcesContent":["import type { AssistantStream, AssistantStreamChunk } from \"assistant-stream\";\nimport type {\n  RemoteThreadInitializeResponse,\n  RemoteThreadListAdapter,\n  RemoteThreadListResponse,\n  RemoteThreadMetadata,\n} from \"@assistant-ui/core\";\nimport { AdkEventAccumulator } from \"./AdkEventAccumulator\";\nimport type { AdkEvent, AdkMessage } from \"./types\";\nimport { trimTrailingSlashes } from \"./trimTrailingSlashes\";\n\nexport type AdkSessionAdapterOptions = {\n  /**\n   * ADK server base URL (e.g. \"http://localhost:8000\").\n   */\n  apiUrl: string;\n\n  /**\n   * ADK application name.\n   */\n  appName: string;\n\n  /**\n   * ADK user ID.\n   */\n  userId: string;\n\n  /**\n   * Extra headers for API requests.\n   */\n  headers?:\n    | Record<string, string>\n    | (() => Record<string, string> | Promise<Record<string, string>>)\n    | undefined;\n};\n\nexport type AdkArtifactData = {\n  inlineData?: { mimeType: string; data: string } | undefined;\n  text?: string | undefined;\n};\n\ntype AdkSessionAdapterResult = {\n  adapter: RemoteThreadListAdapter;\n  load: (sessionId: string) => Promise<{ messages: AdkMessage[] }>;\n  artifacts: {\n    list: (sessionId: string) => Promise<string[]>;\n    load: (\n      sessionId: string,\n      artifactName: string,\n      version?: number,\n    ) => Promise<AdkArtifactData>;\n    listVersions: (\n      sessionId: string,\n      artifactName: string,\n    ) => Promise<number[]>;\n    delete: (sessionId: string, artifactName: string) => Promise<void>;\n  };\n};\n\ntype AdkSessionResponse = {\n  id: string;\n  events?: unknown;\n};\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === \"object\" && value !== null && !Array.isArray(value);\n\nconst isAdkSessionResponse = (value: unknown): value is AdkSessionResponse => {\n  if (!isRecord(value)) return false;\n\n  const id = value.id;\n  return typeof id === \"string\" && id.length > 0;\n};\n\nconst parseAdkSessionResponse = (\n  value: unknown,\n  operation: \"create\" | \"fetch\" | \"load\",\n): AdkSessionResponse => {\n  if (!isAdkSessionResponse(value)) {\n    throw new Error(\n      `Invalid ADK session ${operation} response: expected an object with a non-empty string \"id\".`,\n    );\n  }\n  return value;\n};\n\nconst parseAdkSessionListResponse = (value: unknown): AdkSessionResponse[] => {\n  if (!Array.isArray(value)) {\n    throw new Error(\n      \"Invalid ADK session list response: expected an array of sessions.\",\n    );\n  }\n\n  return value.map((session, index) => {\n    if (!isAdkSessionResponse(session)) {\n      throw new Error(\n        `Invalid ADK session list response: session at index ${index} must have a non-empty string \"id\".`,\n      );\n    }\n    return session;\n  });\n};\n\nconst parseAdkArtifactListResponse = (value: unknown): string[] => {\n  if (!Array.isArray(value)) {\n    throw new Error(\n      \"Invalid ADK artifact list response: expected an array of artifact names.\",\n    );\n  }\n\n  return value.map((artifact, index) => {\n    if (typeof artifact === \"string\" && artifact.length > 0) {\n      return artifact;\n    }\n\n    if (isRecord(artifact)) {\n      const filename = artifact.filename;\n      if (typeof filename === \"string\" && filename.length > 0) {\n        return filename;\n      }\n    }\n\n    throw new Error(\n      `Invalid ADK artifact list response: artifact at index ${index} must be a non-empty string or an object with a non-empty string \"filename\".`,\n    );\n  });\n};\n\nconst parseAdkArtifactResponse = (value: unknown): AdkArtifactData => {\n  if (!isRecord(value)) {\n    throw new Error(\n      'Invalid ADK artifact load response: expected an object containing \"text\" or \"inlineData\".',\n    );\n  }\n\n  const { text, inlineData } = value;\n  if (text === undefined && inlineData === undefined) {\n    throw new Error(\n      'Invalid ADK artifact load response: expected an object containing \"text\" or \"inlineData\".',\n    );\n  }\n\n  if (text !== undefined && typeof text !== \"string\") {\n    throw new Error(\n      'Invalid ADK artifact load response: \"text\" must be a string when present.',\n    );\n  }\n\n  if (\n    inlineData !== undefined &&\n    (!isRecord(inlineData) ||\n      typeof inlineData.mimeType !== \"string\" ||\n      typeof inlineData.data !== \"string\")\n  ) {\n    throw new Error(\n      'Invalid ADK artifact load response: \"inlineData\" must contain string \"mimeType\" and \"data\" fields.',\n    );\n  }\n\n  return value as AdkArtifactData;\n};\n\nconst parseAdkArtifactVersionsResponse = (value: unknown): number[] => {\n  if (!Array.isArray(value)) {\n    throw new Error(\n      \"Invalid ADK artifact versions response: expected an array of version numbers.\",\n    );\n  }\n\n  return value.map((version, index) => {\n    if (\n      typeof version !== \"number\" ||\n      !Number.isInteger(version) ||\n      version < 0\n    ) {\n      throw new Error(\n        `Invalid ADK artifact versions response: version at index ${index} must be a non-negative integer.`,\n      );\n    }\n    return version;\n  });\n};\n\n/**\n * Creates a `RemoteThreadListAdapter` backed by ADK's session REST API,\n * plus a `load` function that reconstructs messages from session events.\n *\n * @example\n * ```ts\n * const { adapter, load } = createAdkSessionAdapter({\n *   apiUrl: \"http://localhost:8000\",\n *   appName: \"my-app\",\n *   userId: \"user-1\",\n * });\n *\n * const runtime = useAdkRuntime({\n *   stream: createAdkStream({ ... }),\n *   sessionAdapter: adapter,\n *   load,\n * });\n * ```\n */\nexport function createAdkSessionAdapter(\n  options: AdkSessionAdapterOptions,\n): AdkSessionAdapterResult {\n  const { apiUrl, appName, userId } = options;\n  const normalizedApiUrl = trimTrailingSlashes(apiUrl);\n  const baseUrl = `${normalizedApiUrl}/apps/${encodeURIComponent(appName)}/users/${encodeURIComponent(userId)}/sessions`;\n\n  const getHeaders = async (): Promise<Record<string, string>> => {\n    if (!options.headers) return {};\n    if (typeof options.headers === \"function\") return await options.headers();\n    return options.headers;\n  };\n\n  const adapter: RemoteThreadListAdapter = {\n    async list(): Promise<RemoteThreadListResponse> {\n      const headers = await getHeaders();\n      const res = await fetch(baseUrl, { headers });\n      if (!res.ok) {\n        throw new Error(`Failed to list sessions: ${res.status}`);\n      }\n      const data = parseAdkSessionListResponse(await res.json());\n\n      const threads: RemoteThreadMetadata[] = data.map((session) => ({\n        status: \"regular\" as const,\n        remoteId: session.id,\n        externalId: session.id,\n        title: undefined,\n      }));\n\n      return { threads };\n    },\n\n    async initialize(\n      _threadId: string,\n    ): Promise<RemoteThreadInitializeResponse> {\n      const headers = await getHeaders();\n      const res = await fetch(baseUrl, {\n        method: \"POST\",\n        headers: { \"Content-Type\": \"application/json\", ...headers },\n        body: JSON.stringify({}),\n      });\n      if (!res.ok) {\n        throw new Error(`Failed to create session: ${res.status}`);\n      }\n      const session = parseAdkSessionResponse(await res.json(), \"create\");\n      return { remoteId: session.id, externalId: session.id };\n    },\n\n    async delete(remoteId: string): Promise<void> {\n      const headers = await getHeaders();\n      const res = await fetch(`${baseUrl}/${encodeURIComponent(remoteId)}`, {\n        method: \"DELETE\",\n        headers,\n      });\n      if (!res.ok && res.status !== 404) {\n        throw new Error(`Failed to delete session: ${res.status}`);\n      }\n    },\n\n    async rename(): Promise<void> {\n      // ADK sessions don't support titles\n    },\n\n    async archive(): Promise<void> {\n      // ADK sessions don't support archiving\n    },\n\n    async unarchive(): Promise<void> {\n      // ADK sessions don't support archiving\n    },\n\n    generateTitle(): Promise<AssistantStream> {\n      // Title generation not supported without assistant-cloud\n      return Promise.resolve(\n        new ReadableStream<AssistantStreamChunk>({\n          start(controller) {\n            controller.close();\n          },\n        }),\n      );\n    },\n\n    async fetch(threadId: string): Promise<RemoteThreadMetadata> {\n      const headers = await getHeaders();\n      const res = await fetch(`${baseUrl}/${encodeURIComponent(threadId)}`, {\n        headers,\n      });\n      if (!res.ok) {\n        throw new Error(`Session not found: ${res.status}`);\n      }\n      const session = parseAdkSessionResponse(await res.json(), \"fetch\");\n      return {\n        status: \"regular\",\n        remoteId: session.id,\n        externalId: session.id,\n        title: undefined,\n      };\n    },\n  };\n\n  const load = async (\n    sessionId: string,\n  ): Promise<{ messages: AdkMessage[] }> => {\n    const headers = await getHeaders();\n    const res = await fetch(`${baseUrl}/${encodeURIComponent(sessionId)}`, {\n      headers,\n    });\n    if (!res.ok) {\n      throw new Error(`Failed to load session: ${res.status}`);\n    }\n    const session = parseAdkSessionResponse(await res.json(), \"load\");\n\n    if (session.events !== undefined && !Array.isArray(session.events)) {\n      throw new Error(\n        'Invalid ADK session load response: expected \"events\" to be an array when present.',\n      );\n    }\n\n    const events = session.events as AdkEvent[] | undefined;\n\n    if (!events?.length) {\n      return { messages: [] };\n    }\n\n    const accumulator = new AdkEventAccumulator();\n    let messages: AdkMessage[] = [];\n    for (const event of events) {\n      messages = accumulator.processEvent(event);\n    }\n    return { messages };\n  };\n\n  const artifactBaseUrl = (sessionId: string) =>\n    `${baseUrl}/${encodeURIComponent(sessionId)}/artifacts`;\n\n  const artifacts: AdkSessionAdapterResult[\"artifacts\"] = {\n    async list(sessionId) {\n      const headers = await getHeaders();\n      const res = await fetch(artifactBaseUrl(sessionId), { headers });\n      if (!res.ok) throw new Error(`Failed to list artifacts: ${res.status}`);\n      return parseAdkArtifactListResponse(await res.json());\n    },\n\n    async load(sessionId, artifactName, version?) {\n      const headers = await getHeaders();\n      let url = `${artifactBaseUrl(sessionId)}/${encodeURIComponent(artifactName)}`;\n      if (version != null) url += `/versions/${version}`;\n      const res = await fetch(url, { headers });\n      if (!res.ok) throw new Error(`Failed to load artifact: ${res.status}`);\n      return parseAdkArtifactResponse(await res.json());\n    },\n\n    async listVersions(sessionId, artifactName) {\n      const headers = await getHeaders();\n      const url = `${artifactBaseUrl(sessionId)}/${encodeURIComponent(artifactName)}/versions`;\n      const res = await fetch(url, { headers });\n      if (!res.ok) {\n        throw new Error(`Failed to list artifact versions: ${res.status}`);\n      }\n      return parseAdkArtifactVersionsResponse(await res.json());\n    },\n\n    async delete(sessionId, artifactName) {\n      const headers = await getHeaders();\n      const url = `${artifactBaseUrl(sessionId)}/${encodeURIComponent(artifactName)}`;\n      const res = await fetch(url, { method: \"DELETE\", headers });\n      if (!res.ok && res.status !== 404) {\n        throw new Error(`Failed to delete artifact: ${res.status}`);\n      }\n    },\n  };\n\n  return { adapter, load, artifacts };\n}\n"],"mappings":"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"}

package/dist/useAdkMessages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useAdkMessages.d.ts","names":[],"sources":["../src/useAdkMessages.ts"],"mappings":";;KAkBY;EACV,QAAQ;EACR;IACE,UAAU;IACV,gBAAgB;IAChB,kBAAkB;;;cAIT,mBAAkB,QAAA,iBAG5B;;;;;;;;;;;;;6BA2DqB,cAAY,QAAU,yBAAoB;;sBA9BhB;0BAUvC"}
+{"version":3,"file":"useAdkMessages.d.ts","names":[],"sources":["../src/useAdkMessages.ts"],"mappings":";;KAkBY;EACV,QAAQ;EACR;IACE,UAAU;IACV,gBAAgB;IAChB,kBAAkB;;;cAIT,mBAAkB,QAAA,iBAG5B;;;;IAIQ;IACE;;;;;;;;EAsDW,cAAA,aAAA,cAAY,QAAU,yBAAoB;;EA9BhB,cAAA,MAAA;EAUvC,kBAAA,MAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@assistant-ui/react-google-adk",
-  "version": "0.0.17",
+  "version": "0.0.18",
   "description": "Google ADK adapter for assistant-ui",
   "keywords": [
     "google-adk",
@@ -34,10 +34,10 @@
   ],
   "sideEffects": false,
   "dependencies": {
-    "@assistant-ui/core": "^0.2.21",
-    "@assistant-ui/store": "^0.2.20",
+    "@assistant-ui/core": "^0.2.22",
+    "@assistant-ui/store": "^0.2.21",
     "assistant-cloud": "*",
-    "assistant-stream": "^0.3.26",
+    "assistant-stream": "^0.3.27",
     "uuid": "^14.0.1"
   },
   "peerDependencies": {
@@ -56,9 +56,9 @@
   "devDependencies": {
     "@types/react": "^19.2.17",
     "@types/uuid": "^11.0.0",
-    "react": "^19.2.7",
+    "react": "^19.2.8",
     "vitest": "^4.1.10",
-    "@assistant-ui/x-buildutils": "0.0.18"
+    "@assistant-ui/x-buildutils": "0.0.19"
   },
   "publishConfig": {
     "access": "public",

package/src/AdkClient.test.ts

@@ -34,6 +34,17 @@ const sseBody = (text: string): ReadableStream<Uint8Array> => {
   });
 };
 
+const sseResponse = (
+  body: BodyInit | null,
+  contentType: string | null = "text/event-stream",
+): Response =>
+  new Response(body, {
+    status: 200,
+    ...(contentType === null
+      ? {}
+      : { headers: { "Content-Type": contentType } }),
+  });
+
 const nextWithTimeout = async <T>(
   promise: Promise<IteratorResult<T>>,
 ): Promise<IteratorResult<T> | "timeout"> => {
@@ -57,7 +68,7 @@ beforeEach(() => {
 
 describe("createAdkStream - proxy mode", () => {
   it("POSTs to the api URL directly", async () => {
-    mockFetch.mockResolvedValueOnce(new Response(sseBody(""), { status: 200 }));
+    mockFetch.mockResolvedValueOnce(sseResponse(sseBody("")));
 
     const stream = createAdkStream({ api: "/api/adk" });
     const messages: AdkMessage[] = [
@@ -78,7 +89,7 @@ describe("createAdkStream - proxy mode", () => {
   });
 
   it("sends runConfig and checkpointId in proxy body", async () => {
-    mockFetch.mockResolvedValueOnce(new Response(sseBody(""), { status: 200 }));
+    mockFetch.mockResolvedValueOnce(sseResponse(sseBody("")));
 
     const stream = createAdkStream({ api: "/api/adk" });
     const gen = await stream(
@@ -95,7 +106,7 @@ describe("createAdkStream - proxy mode", () => {
   });
 
   it("sends a tool-result body when message type is tool", async () => {
-    mockFetch.mockResolvedValueOnce(new Response(sseBody(""), { status: 200 }));
+    mockFetch.mockResolvedValueOnce(sseResponse(sseBody("")));
 
     const stream = createAdkStream({ api: "/api/adk" });
     const messages: AdkMessage[] = [
@@ -122,7 +133,7 @@ describe("createAdkStream - proxy mode", () => {
   });
 
   it("sends parts when message has multimodal content", async () => {
-    mockFetch.mockResolvedValueOnce(new Response(sseBody(""), { status: 200 }));
+    mockFetch.mockResolvedValueOnce(sseResponse(sseBody("")));
 
     const stream = createAdkStream({ api: "/api/adk" });
     const messages: AdkMessage[] = [
@@ -149,7 +160,7 @@ describe("createAdkStream - proxy mode", () => {
   });
 
   it("sends file parts as inlineData in proxy mode", async () => {
-    mockFetch.mockResolvedValueOnce(new Response(sseBody(""), { status: 200 }));
+    mockFetch.mockResolvedValueOnce(sseResponse(sseBody("")));
 
     const stream = createAdkStream({ api: "/api/adk" });
     const messages: AdkMessage[] = [
@@ -180,7 +191,7 @@ describe("createAdkStream - proxy mode", () => {
   });
 
   it("sends parts array when multiple messages are provided", async () => {
-    mockFetch.mockResolvedValueOnce(new Response(sseBody(""), { status: 200 }));
+    mockFetch.mockResolvedValueOnce(sseResponse(sseBody("")));
 
     const stream = createAdkStream({ api: "/api/adk" });
     const messages: AdkMessage[] = [
@@ -205,7 +216,7 @@ describe("createAdkStream - proxy mode", () => {
   });
 
   it("marks isError=true when tool status is error", async () => {
-    mockFetch.mockResolvedValueOnce(new Response(sseBody(""), { status: 200 }));
+    mockFetch.mockResolvedValueOnce(sseResponse(sseBody("")));
 
     const stream = createAdkStream({ api: "/api/adk" });
     const messages: AdkMessage[] = [
@@ -231,8 +242,35 @@ describe("createAdkStream - proxy mode", () => {
 // ── Direct mode ──
 
 describe("createAdkStream - direct mode", () => {
+  it("rejects direct mode with an empty appName", () => {
+    expect(() =>
+      createAdkStream({
+        api: "http://localhost:8000",
+        appName: "",
+        userId: "user-1",
+      }),
+    ).toThrow('createAdkStream direct mode requires a non-empty "appName".');
+    expect(mockFetch).not.toHaveBeenCalled();
+  });
+
+  it.each([
+    ["missing", undefined],
+    ["empty", ""],
+  ])("rejects direct mode with a %s userId", (_label, userId) => {
+    expect(() =>
+      createAdkStream({
+        api: "http://localhost:8000",
+        appName: "my-app",
+        userId,
+      }),
+    ).toThrow(
+      'createAdkStream direct mode requires "userId" when "appName" is provided.',
+    );
+    expect(mockFetch).not.toHaveBeenCalled();
+  });
+
   it("POSTs to /run_sse with ADK-native body", async () => {
-    mockFetch.mockResolvedValueOnce(new Response(sseBody(""), { status: 200 }));
+    mockFetch.mockResolvedValueOnce(sseResponse(sseBody("")));
 
     const stream = createAdkStream({
       api: "http://localhost:8000",
@@ -264,9 +302,7 @@ describe("createAdkStream - direct mode", () => {
   it.each(["http://localhost:8000/", "http://localhost:8000//"])(
     "normalizes trailing slashes in the api URL: %s",
     async (api) => {
-      mockFetch.mockResolvedValueOnce(
-        new Response(sseBody(""), { status: 200 }),
-      );
+      mockFetch.mockResolvedValueOnce(sseResponse(sseBody("")));
 
       const stream = createAdkStream({
         api,
@@ -289,7 +325,7 @@ describe("createAdkStream - direct mode", () => {
     const initialize = vi
       .fn()
       .mockResolvedValue({ remoteId: "r1", externalId: "s-42" });
-    mockFetch.mockResolvedValueOnce(new Response(sseBody(""), { status: 200 }));
+    mockFetch.mockResolvedValueOnce(sseResponse(sseBody("")));
 
     const stream = createAdkStream({
       api: "http://localhost:8000",
@@ -310,7 +346,7 @@ describe("createAdkStream - direct mode", () => {
   });
 
   it("converts tool messages to functionResponse parts", async () => {
-    mockFetch.mockResolvedValueOnce(new Response(sseBody(""), { status: 200 }));
+    mockFetch.mockResolvedValueOnce(sseResponse(sseBody("")));
 
     const stream = createAdkStream({
       api: "http://localhost:8000",
@@ -342,7 +378,7 @@ describe("createAdkStream - direct mode", () => {
   });
 
   it("falls back to raw string when tool content is not valid JSON", async () => {
-    mockFetch.mockResolvedValueOnce(new Response(sseBody(""), { status: 200 }));
+    mockFetch.mockResolvedValueOnce(sseResponse(sseBody("")));
 
     const stream = createAdkStream({
       api: "http://localhost:8000",
@@ -368,7 +404,7 @@ describe("createAdkStream - direct mode", () => {
   });
 
   it("sends empty text part when no messages provided", async () => {
-    mockFetch.mockResolvedValueOnce(new Response(sseBody(""), { status: 200 }));
+    mockFetch.mockResolvedValueOnce(sseResponse(sseBody("")));
 
     const stream = createAdkStream({
       api: "http://localhost:8000",
@@ -394,9 +430,7 @@ describe("createAdkStream - SSE parsing", () => {
       { id: "e2", content: { parts: [{ text: "world" }] } },
     ];
     const text = events.map((e) => `data: ${JSON.stringify(e)}\n\n`).join("");
-    mockFetch.mockResolvedValueOnce(
-      new Response(sseBody(text), { status: 200 }),
-    );
+    mockFetch.mockResolvedValueOnce(sseResponse(sseBody(text)));
 
     const stream = createAdkStream({ api: "/api/adk" });
     const gen = await stream(
@@ -413,12 +447,30 @@ describe("createAdkStream - SSE parsing", () => {
     expect(collected[1]!.id).toBe("e2");
   });
 
-  it("skips :ok SSE comments", async () => {
-    const text = `:ok\n\ndata: ${JSON.stringify({ id: "e1" })}\n\n`;
+  it("accepts parameterized event-stream content types", async () => {
+    const event: AdkEvent = { id: "e1" };
     mockFetch.mockResolvedValueOnce(
-      new Response(sseBody(text), { status: 200 }),
+      sseResponse(
+        sseBody(`data: ${JSON.stringify(event)}\n\n`),
+        "Text/Event-Stream; charset=utf-8",
+      ),
     );
 
+    const stream = createAdkStream({ api: "/api/adk" });
+    const gen = await stream(
+      [{ id: "m1", type: "human", content: "Hi" }],
+      makeConfig(),
+    );
+    const collected: AdkEvent[] = [];
+    for await (const value of gen) collected.push(value);
+
+    expect(collected).toEqual([event]);
+  });
+
+  it("skips :ok SSE comments", async () => {
+    const text = `:ok\n\ndata: ${JSON.stringify({ id: "e1" })}\n\n`;
+    mockFetch.mockResolvedValueOnce(sseResponse(sseBody(text)));
+
     const stream = createAdkStream({ api: "/api/adk" });
     const gen = await stream(
       [{ id: "m1", type: "human", content: "Hi" }],
@@ -435,9 +487,7 @@ describe("createAdkStream - SSE parsing", () => {
 
   it("parses data fields without a space after the colon", async () => {
     const text = `data:${JSON.stringify({ id: "e1" })}\n\n`;
-    mockFetch.mockResolvedValueOnce(
-      new Response(sseBody(text), { status: 200 }),
-    );
+    mockFetch.mockResolvedValueOnce(sseResponse(sseBody(text)));
 
     const stream = createAdkStream({ api: "/api/adk" });
     const gen = await stream(
@@ -456,9 +506,7 @@ describe("createAdkStream - SSE parsing", () => {
   it("parses CR-delimited SSE events", async () => {
     const events: AdkEvent[] = [{ id: "e1" }, { id: "e2" }];
     const text = events.map((e) => `data: ${JSON.stringify(e)}\r\r`).join("");
-    mockFetch.mockResolvedValueOnce(
-      new Response(sseBody(text), { status: 200 }),
-    );
+    mockFetch.mockResolvedValueOnce(sseResponse(sseBody(text)));
 
     const stream = createAdkStream({ api: "/api/adk" });
     const gen = await stream(
@@ -483,7 +531,7 @@ describe("createAdkStream - SSE parsing", () => {
         controller = nextController;
       },
     });
-    mockFetch.mockResolvedValueOnce(new Response(body, { status: 200 }));
+    mockFetch.mockResolvedValueOnce(sseResponse(body));
 
     const stream = createAdkStream({ api: "/api/adk" });
     const gen = await stream(
@@ -520,7 +568,7 @@ describe("createAdkStream - SSE parsing", () => {
         controller.close();
       },
     });
-    mockFetch.mockResolvedValueOnce(new Response(body, { status: 200 }));
+    mockFetch.mockResolvedValueOnce(sseResponse(body));
 
     const stream = createAdkStream({ api: "/api/adk" });
     const gen = await stream(
@@ -547,7 +595,7 @@ describe("createAdkStream - SSE parsing", () => {
         controller.close();
       },
     });
-    mockFetch.mockResolvedValueOnce(new Response(body, { status: 200 }));
+    mockFetch.mockResolvedValueOnce(sseResponse(body));
 
     const stream = createAdkStream({ api: "/api/adk" });
     const gen = await stream(
@@ -567,9 +615,7 @@ describe("createAdkStream - SSE parsing", () => {
     // No trailing \n\n
     const event = { id: "e1" };
     const text = `data: ${JSON.stringify(event)}\n`;
-    mockFetch.mockResolvedValueOnce(
-      new Response(sseBody(text), { status: 200 }),
-    );
+    mockFetch.mockResolvedValueOnce(sseResponse(sseBody(text)));
 
     const stream = createAdkStream({ api: "/api/adk" });
     const gen = await stream(
@@ -605,13 +651,57 @@ describe("createAdkStream - error handling", () => {
       }
     }).rejects.toThrow("ADK request failed: 404 Not Found");
   });
+
+  it("rejects successful HTML responses and cancels their body", async () => {
+    const cancelBody = vi.fn();
+    const body = new ReadableStream<Uint8Array>({
+      start(controller) {
+        controller.enqueue(new TextEncoder().encode("<html>Sign in</html>"));
+      },
+      cancel: cancelBody,
+    });
+    mockFetch.mockResolvedValueOnce(
+      sseResponse(body, "text/html; charset=utf-8"),
+    );
+
+    const stream = createAdkStream({ api: "/api/adk" });
+    await expect(async () => {
+      const gen = await stream(
+        [{ id: "m1", type: "human", content: "Hi" }],
+        makeConfig(),
+      );
+      for await (const _ of gen) {
+        /* noop */
+      }
+    }).rejects.toThrow(
+      'Expected ADK stream response Content-Type "text/event-stream", received "text/html; charset=utf-8"',
+    );
+    expect(cancelBody).toHaveBeenCalledOnce();
+  });
+
+  it("rejects successful responses without a content type", async () => {
+    mockFetch.mockResolvedValueOnce(sseResponse(sseBody(""), null));
+
+    const stream = createAdkStream({ api: "/api/adk" });
+    await expect(async () => {
+      const gen = await stream(
+        [{ id: "m1", type: "human", content: "Hi" }],
+        makeConfig(),
+      );
+      for await (const _ of gen) {
+        /* noop */
+      }
+    }).rejects.toThrow(
+      'Expected ADK stream response Content-Type "text/event-stream", received no Content-Type header',
+    );
+  });
 });
 
 // ── Headers ──
 
 describe("createAdkStream - headers", () => {
   it("sends static headers", async () => {
-    mockFetch.mockResolvedValueOnce(new Response(sseBody(""), { status: 200 }));
+    mockFetch.mockResolvedValueOnce(sseResponse(sseBody("")));
 
     const stream = createAdkStream({
       api: "/api/adk",
@@ -634,7 +724,7 @@ describe("createAdkStream - headers", () => {
   });
 
   it("resolves dynamic headers from a function", async () => {
-    mockFetch.mockResolvedValueOnce(new Response(sseBody(""), { status: 200 }));
+    mockFetch.mockResolvedValueOnce(sseResponse(sseBody("")));
 
     const stream = createAdkStream({
       api: "/api/adk",
@@ -656,7 +746,7 @@ describe("createAdkStream - headers", () => {
   });
 
   it("resolves async dynamic headers", async () => {
-    mockFetch.mockResolvedValueOnce(new Response(sseBody(""), { status: 200 }));
+    mockFetch.mockResolvedValueOnce(sseResponse(sseBody("")));
 
     const stream = createAdkStream({
       api: "/api/adk",
@@ -678,7 +768,7 @@ describe("createAdkStream - headers", () => {
   });
 
   it("sends no extra headers when headers option is undefined", async () => {
-    mockFetch.mockResolvedValueOnce(new Response(sseBody(""), { status: 200 }));
+    mockFetch.mockResolvedValueOnce(sseResponse(sseBody("")));
 
     const stream = createAdkStream({ api: "/api/adk" });
     const gen = await stream(
@@ -701,7 +791,7 @@ describe("createAdkStream - headers", () => {
 
 describe("createAdkStream - AbortSignal", () => {
   it("forwards the AbortSignal to fetch", async () => {
-    mockFetch.mockResolvedValueOnce(new Response(sseBody(""), { status: 200 }));
+    mockFetch.mockResolvedValueOnce(sseResponse(sseBody("")));
 
     const controller = new AbortController();
     const stream = createAdkStream({ api: "/api/adk" });
@@ -721,7 +811,7 @@ describe("createAdkStream - AbortSignal", () => {
 
 describe("createAdkStream - content conversion", () => {
   it("converts reasoning content parts to thought parts in direct mode", async () => {
-    mockFetch.mockResolvedValueOnce(new Response(sseBody(""), { status: 200 }));
+    mockFetch.mockResolvedValueOnce(sseResponse(sseBody("")));
 
     const stream = createAdkStream({
       api: "http://localhost:8000",
@@ -748,7 +838,7 @@ describe("createAdkStream - content conversion", () => {
   });
 
   it("converts image_url content parts to fileData in direct mode", async () => {
-    mockFetch.mockResolvedValueOnce(new Response(sseBody(""), { status: 200 }));
+    mockFetch.mockResolvedValueOnce(sseResponse(sseBody("")));
 
     const stream = createAdkStream({
       api: "http://localhost:8000",
@@ -774,7 +864,7 @@ describe("createAdkStream - content conversion", () => {
   });
 
   it("converts file content parts to inlineData in direct mode", async () => {
-    mockFetch.mockResolvedValueOnce(new Response(sseBody(""), { status: 200 }));
+    mockFetch.mockResolvedValueOnce(sseResponse(sseBody("")));
 
     const stream = createAdkStream({
       api: "http://localhost:8000",
@@ -807,7 +897,7 @@ describe("createAdkStream - content conversion", () => {
   });
 
   it("converts file_url content parts to fileData with mimeType in direct mode", async () => {
-    mockFetch.mockResolvedValueOnce(new Response(sseBody(""), { status: 200 }));
+    mockFetch.mockResolvedValueOnce(sseResponse(sseBody("")));
 
     const stream = createAdkStream({
       api: "http://localhost:8000",
@@ -842,7 +932,7 @@ describe("createAdkStream - content conversion", () => {
   });
 
   it("converts code content parts to executableCode", async () => {
-    mockFetch.mockResolvedValueOnce(new Response(sseBody(""), { status: 200 }));
+    mockFetch.mockResolvedValueOnce(sseResponse(sseBody("")));
 
     const stream = createAdkStream({
       api: "http://localhost:8000",
@@ -868,7 +958,7 @@ describe("createAdkStream - content conversion", () => {
   });
 
   it("converts code_result content parts to codeExecutionResult", async () => {
-    mockFetch.mockResolvedValueOnce(new Response(sseBody(""), { status: 200 }));
+    mockFetch.mockResolvedValueOnce(sseResponse(sseBody("")));
 
     const stream = createAdkStream({
       api: "http://localhost:8000",

package/src/AdkClient.ts

@@ -60,7 +60,18 @@ export type CreateAdkStreamOptions = {
 export function createAdkStream(
   options: CreateAdkStreamOptions,
 ): AdkStreamCallback {
+  if (options.appName === "") {
+    throw new Error(
+      'createAdkStream direct mode requires a non-empty "appName".',
+    );
+  }
+
   const isDirect = options.appName != null;
+  if (isDirect && (options.userId == null || options.userId === "")) {
+    throw new Error(
+      'createAdkStream direct mode requires "userId" when "appName" is provided.',
+    );
+  }
 
   return async function* (messages, config) {
     const headers = await resolveHeaders(options.headers);
@@ -99,12 +110,27 @@ export function createAdkStream(
       );
     }
 
+    validateEventStreamContentType(response);
     yield* parseSSEResponse(response);
   };
 }
 
 // ── Internal helpers ──
 
+function validateEventStreamContentType(response: Response): void {
+  const contentType = response.headers.get("Content-Type");
+  const mediaType = contentType?.split(";", 1)[0]?.trim().toLowerCase();
+  if (mediaType !== "text/event-stream") {
+    const received = contentType
+      ? `"${contentType}"`
+      : "no Content-Type header";
+    void response.body?.cancel().catch(() => undefined);
+    throw new Error(
+      `Expected ADK stream response Content-Type "text/event-stream", received ${received}`,
+    );
+  }
+}
+
 async function resolveHeaders(
   headers:
     | Record<string, string>

package/src/AdkSessionAdapter.test.ts

@@ -62,6 +62,30 @@ describe("createAdkSessionAdapter - list", () => {
     expect(result.threads).toHaveLength(0);
   });
 
+  it("rejects a successful response that is not a session array", async () => {
+    mockFetch.mockResolvedValueOnce(
+      new Response(JSON.stringify({}), { status: 200 }),
+    );
+
+    const { adapter } = createAdkSessionAdapter(baseOptions);
+
+    await expect(adapter.list()).rejects.toThrow(
+      "Invalid ADK session list response: expected an array of sessions.",
+    );
+  });
+
+  it("rejects session list entries without a valid id", async () => {
+    mockFetch.mockResolvedValueOnce(
+      new Response(JSON.stringify([{ id: "s1" }, {}]), { status: 200 }),
+    );
+
+    const { adapter } = createAdkSessionAdapter(baseOptions);
+
+    await expect(adapter.list()).rejects.toThrow(
+      'Invalid ADK session list response: session at index 1 must have a non-empty string "id".',
+    );
+  });
+
   it("throws when response is not ok", async () => {
     mockFetch.mockResolvedValueOnce(
       new Response("Server error", { status: 500 }),
@@ -139,6 +163,18 @@ describe("createAdkSessionAdapter - initialize", () => {
       "Failed to create session: 403",
     );
   });
+
+  it("rejects a successful response without a session id", async () => {
+    mockFetch.mockResolvedValueOnce(
+      new Response(JSON.stringify({}), { status: 200 }),
+    );
+
+    const { adapter } = createAdkSessionAdapter(baseOptions);
+
+    await expect(adapter.initialize("thread-1")).rejects.toThrow(
+      'Invalid ADK session create response: expected an object with a non-empty string "id".',
+    );
+  });
 });
 
 // ── adapter.delete() ──
@@ -250,6 +286,18 @@ describe("createAdkSessionAdapter - fetch", () => {
       "Session not found: 404",
     );
   });
+
+  it("rejects a successful response without a session id", async () => {
+    mockFetch.mockResolvedValueOnce(
+      new Response(JSON.stringify({}), { status: 200 }),
+    );
+
+    const { adapter } = createAdkSessionAdapter(baseOptions);
+
+    await expect(adapter.fetch("s1")).rejects.toThrow(
+      'Invalid ADK session fetch response: expected an object with a non-empty string "id".',
+    );
+  });
 });
 
 // ── load() ──
@@ -305,6 +353,30 @@ describe("createAdkSessionAdapter - load", () => {
     expect(result.messages).toEqual([]);
   });
 
+  it("rejects a successful response without a session id", async () => {
+    mockFetch.mockResolvedValueOnce(
+      new Response(JSON.stringify({}), { status: 200 }),
+    );
+
+    const { load } = createAdkSessionAdapter(baseOptions);
+
+    await expect(load("s1")).rejects.toThrow(
+      'Invalid ADK session load response: expected an object with a non-empty string "id".',
+    );
+  });
+
+  it("rejects a session with a malformed events field", async () => {
+    mockFetch.mockResolvedValueOnce(
+      new Response(JSON.stringify({ id: "s1", events: {} }), { status: 200 }),
+    );
+
+    const { load } = createAdkSessionAdapter(baseOptions);
+
+    await expect(load("s1")).rejects.toThrow(
+      'Invalid ADK session load response: expected "events" to be an array when present.',
+    );
+  });
+
   it("throws when session fetch fails", async () => {
     mockFetch.mockResolvedValueOnce(
       new Response("Server error", { status: 500 }),
@@ -343,6 +415,133 @@ describe("createAdkSessionAdapter - load", () => {
   });
 });
 
+describe("createAdkSessionAdapter - artifacts", () => {
+  it("lists names from current and legacy artifact responses", async () => {
+    mockFetch.mockResolvedValueOnce(
+      new Response(JSON.stringify(["report.pdf", { filename: "chart.png" }]), {
+        status: 200,
+      }),
+    );
+
+    const { artifacts } = createAdkSessionAdapter(baseOptions);
+
+    await expect(artifacts.list("s1")).resolves.toEqual([
+      "report.pdf",
+      "chart.png",
+    ]);
+    expect(mockFetch.mock.calls[0]![0]).toBe(`${expectedBaseUrl}/s1/artifacts`);
+  });
+
+  it("rejects an artifact list that is not an array", async () => {
+    mockFetch.mockResolvedValueOnce(
+      new Response(JSON.stringify({}), { status: 200 }),
+    );
+
+    const { artifacts } = createAdkSessionAdapter(baseOptions);
+
+    await expect(artifacts.list("s1")).rejects.toThrow(
+      "Invalid ADK artifact list response: expected an array of artifact names.",
+    );
+  });
+
+  it("rejects malformed artifact list entries", async () => {
+    mockFetch.mockResolvedValueOnce(
+      new Response(JSON.stringify(["report.pdf", {}]), { status: 200 }),
+    );
+
+    const { artifacts } = createAdkSessionAdapter(baseOptions);
+
+    await expect(artifacts.list("s1")).rejects.toThrow(
+      'Invalid ADK artifact list response: artifact at index 1 must be a non-empty string or an object with a non-empty string "filename".',
+    );
+  });
+
+  it.each([
+    ["text", { text: "artifact contents" }],
+    [
+      "inline data",
+      { inlineData: { mimeType: "image/png", data: "aGVsbG8=" } },
+    ],
+  ])("loads valid %s artifacts", async (_label, artifact) => {
+    mockFetch.mockResolvedValueOnce(
+      new Response(JSON.stringify(artifact), { status: 200 }),
+    );
+
+    const { artifacts } = createAdkSessionAdapter(baseOptions);
+
+    await expect(artifacts.load("s1", "report.pdf")).resolves.toEqual(artifact);
+  });
+
+  it("rejects an artifact without supported content", async () => {
+    mockFetch.mockResolvedValueOnce(
+      new Response(JSON.stringify({}), { status: 200 }),
+    );
+
+    const { artifacts } = createAdkSessionAdapter(baseOptions);
+
+    await expect(artifacts.load("s1", "report.pdf")).rejects.toThrow(
+      'Invalid ADK artifact load response: expected an object containing "text" or "inlineData".',
+    );
+  });
+
+  it.each([
+    [
+      "text",
+      { text: 42 },
+      'Invalid ADK artifact load response: "text" must be a string when present.',
+    ],
+    [
+      "inline data",
+      { inlineData: { mimeType: "image/png" } },
+      'Invalid ADK artifact load response: "inlineData" must contain string "mimeType" and "data" fields.',
+    ],
+  ])("rejects malformed %s artifact content", async (_label, value, error) => {
+    mockFetch.mockResolvedValueOnce(
+      new Response(JSON.stringify(value), { status: 200 }),
+    );
+
+    const { artifacts } = createAdkSessionAdapter(baseOptions);
+
+    await expect(artifacts.load("s1", "report.pdf")).rejects.toThrow(error);
+  });
+
+  it("lists artifact versions", async () => {
+    mockFetch.mockResolvedValueOnce(
+      new Response(JSON.stringify([0, 1, 2]), { status: 200 }),
+    );
+
+    const { artifacts } = createAdkSessionAdapter(baseOptions);
+
+    await expect(artifacts.listVersions("s1", "report.pdf")).resolves.toEqual([
+      0, 1, 2,
+    ]);
+  });
+
+  it("rejects an artifact version list that is not an array", async () => {
+    mockFetch.mockResolvedValueOnce(
+      new Response(JSON.stringify({}), { status: 200 }),
+    );
+
+    const { artifacts } = createAdkSessionAdapter(baseOptions);
+
+    await expect(artifacts.listVersions("s1", "report.pdf")).rejects.toThrow(
+      "Invalid ADK artifact versions response: expected an array of version numbers.",
+    );
+  });
+
+  it("rejects malformed artifact version entries", async () => {
+    mockFetch.mockResolvedValueOnce(
+      new Response(JSON.stringify([0, "1"]), { status: 200 }),
+    );
+
+    const { artifacts } = createAdkSessionAdapter(baseOptions);
+
+    await expect(artifacts.listVersions("s1", "report.pdf")).rejects.toThrow(
+      "Invalid ADK artifact versions response: version at index 1 must be a non-negative integer.",
+    );
+  });
+});
+
 // ── URL construction ──
 
 describe("createAdkSessionAdapter - URL construction", () => {

package/src/AdkSessionAdapter.ts

@@ -57,6 +57,130 @@ type AdkSessionAdapterResult = {
   };
 };
 
+type AdkSessionResponse = {
+  id: string;
+  events?: unknown;
+};
+
+const isRecord = (value: unknown): value is Record<string, unknown> =>
+  typeof value === "object" && value !== null && !Array.isArray(value);
+
+const isAdkSessionResponse = (value: unknown): value is AdkSessionResponse => {
+  if (!isRecord(value)) return false;
+
+  const id = value.id;
+  return typeof id === "string" && id.length > 0;
+};
+
+const parseAdkSessionResponse = (
+  value: unknown,
+  operation: "create" | "fetch" | "load",
+): AdkSessionResponse => {
+  if (!isAdkSessionResponse(value)) {
+    throw new Error(
+      `Invalid ADK session ${operation} response: expected an object with a non-empty string "id".`,
+    );
+  }
+  return value;
+};
+
+const parseAdkSessionListResponse = (value: unknown): AdkSessionResponse[] => {
+  if (!Array.isArray(value)) {
+    throw new Error(
+      "Invalid ADK session list response: expected an array of sessions.",
+    );
+  }
+
+  return value.map((session, index) => {
+    if (!isAdkSessionResponse(session)) {
+      throw new Error(
+        `Invalid ADK session list response: session at index ${index} must have a non-empty string "id".`,
+      );
+    }
+    return session;
+  });
+};
+
+const parseAdkArtifactListResponse = (value: unknown): string[] => {
+  if (!Array.isArray(value)) {
+    throw new Error(
+      "Invalid ADK artifact list response: expected an array of artifact names.",
+    );
+  }
+
+  return value.map((artifact, index) => {
+    if (typeof artifact === "string" && artifact.length > 0) {
+      return artifact;
+    }
+
+    if (isRecord(artifact)) {
+      const filename = artifact.filename;
+      if (typeof filename === "string" && filename.length > 0) {
+        return filename;
+      }
+    }
+
+    throw new Error(
+      `Invalid ADK artifact list response: artifact at index ${index} must be a non-empty string or an object with a non-empty string "filename".`,
+    );
+  });
+};
+
+const parseAdkArtifactResponse = (value: unknown): AdkArtifactData => {
+  if (!isRecord(value)) {
+    throw new Error(
+      'Invalid ADK artifact load response: expected an object containing "text" or "inlineData".',
+    );
+  }
+
+  const { text, inlineData } = value;
+  if (text === undefined && inlineData === undefined) {
+    throw new Error(
+      'Invalid ADK artifact load response: expected an object containing "text" or "inlineData".',
+    );
+  }
+
+  if (text !== undefined && typeof text !== "string") {
+    throw new Error(
+      'Invalid ADK artifact load response: "text" must be a string when present.',
+    );
+  }
+
+  if (
+    inlineData !== undefined &&
+    (!isRecord(inlineData) ||
+      typeof inlineData.mimeType !== "string" ||
+      typeof inlineData.data !== "string")
+  ) {
+    throw new Error(
+      'Invalid ADK artifact load response: "inlineData" must contain string "mimeType" and "data" fields.',
+    );
+  }
+
+  return value as AdkArtifactData;
+};
+
+const parseAdkArtifactVersionsResponse = (value: unknown): number[] => {
+  if (!Array.isArray(value)) {
+    throw new Error(
+      "Invalid ADK artifact versions response: expected an array of version numbers.",
+    );
+  }
+
+  return value.map((version, index) => {
+    if (
+      typeof version !== "number" ||
+      !Number.isInteger(version) ||
+      version < 0
+    ) {
+      throw new Error(
+        `Invalid ADK artifact versions response: version at index ${index} must be a non-negative integer.`,
+      );
+    }
+    return version;
+  });
+};
+
 /**
  * Creates a `RemoteThreadListAdapter` backed by ADK's session REST API,
  * plus a `load` function that reconstructs messages from session events.
@@ -96,12 +220,7 @@ export function createAdkSessionAdapter(
       if (!res.ok) {
         throw new Error(`Failed to list sessions: ${res.status}`);
       }
-      const data = (await res.json()) as Array<{
-        id: string;
-        app_name?: string;
-        user_id?: string;
-        last_update_time?: number;
-      }>;
+      const data = parseAdkSessionListResponse(await res.json());
 
       const threads: RemoteThreadMetadata[] = data.map((session) => ({
         status: "regular" as const,
@@ -125,7 +244,7 @@ export function createAdkSessionAdapter(
       if (!res.ok) {
         throw new Error(`Failed to create session: ${res.status}`);
       }
-      const session = (await res.json()) as { id: string };
+      const session = parseAdkSessionResponse(await res.json(), "create");
       return { remoteId: session.id, externalId: session.id };
     },
 
@@ -171,7 +290,7 @@ export function createAdkSessionAdapter(
       if (!res.ok) {
         throw new Error(`Session not found: ${res.status}`);
       }
-      const session = (await res.json()) as { id: string };
+      const session = parseAdkSessionResponse(await res.json(), "fetch");
       return {
         status: "regular",
         remoteId: session.id,
@@ -191,18 +310,23 @@ export function createAdkSessionAdapter(
     if (!res.ok) {
       throw new Error(`Failed to load session: ${res.status}`);
     }
-    const session = (await res.json()) as {
-      id: string;
-      events?: AdkEvent[];
-    };
+    const session = parseAdkSessionResponse(await res.json(), "load");
+
+    if (session.events !== undefined && !Array.isArray(session.events)) {
+      throw new Error(
+        'Invalid ADK session load response: expected "events" to be an array when present.',
+      );
+    }
+
+    const events = session.events as AdkEvent[] | undefined;
 
-    if (!session.events?.length) {
+    if (!events?.length) {
       return { messages: [] };
     }
 
     const accumulator = new AdkEventAccumulator();
     let messages: AdkMessage[] = [];
-    for (const event of session.events) {
+    for (const event of events) {
       messages = accumulator.processEvent(event);
     }
     return { messages };
@@ -216,8 +340,7 @@ export function createAdkSessionAdapter(
       const headers = await getHeaders();
       const res = await fetch(artifactBaseUrl(sessionId), { headers });
       if (!res.ok) throw new Error(`Failed to list artifacts: ${res.status}`);
-      const data = (await res.json()) as Array<{ filename: string }>;
-      return data.map((a) => a.filename);
+      return parseAdkArtifactListResponse(await res.json());
     },
 
     async load(sessionId, artifactName, version?) {
@@ -226,7 +349,7 @@ export function createAdkSessionAdapter(
       if (version != null) url += `/versions/${version}`;
       const res = await fetch(url, { headers });
       if (!res.ok) throw new Error(`Failed to load artifact: ${res.status}`);
-      return (await res.json()) as AdkArtifactData;
+      return parseAdkArtifactResponse(await res.json());
     },
 
     async listVersions(sessionId, artifactName) {
@@ -236,7 +359,7 @@ export function createAdkSessionAdapter(
       if (!res.ok) {
         throw new Error(`Failed to list artifact versions: ${res.status}`);
       }
-      return (await res.json()) as number[];
+      return parseAdkArtifactVersionsResponse(await res.json());
     },
 
     async delete(sessionId, artifactName) {