@copilotkit/sdk-js 1.56.4 → 1.56.5

package/dist/langgraph/middleware.cjs

@@ -4,6 +4,94 @@ let zod = require("zod");
 zod = require_runtime.__toESM(zod);
 
 //#region src/langgraph/middleware.ts
+/**
+* Augment a Standard-Schema–compatible schema (e.g. Zod) with a
+* `~standard.jsonSchema.input` hook so LangGraph's
+* `getJsonSchemaFromSchema` (called from `StateSchema.getJsonSchema`)
+* can serialize the field.
+*
+* Without this, Zod v4 fields carry `~standard.validate` + `vendor` only,
+* and `isStandardJSONSchema()` returns false, so the field is silently
+* dropped from the graph's `output_schema`. That makes AG-UI
+* `STATE_SNAPSHOT` events filter the field out of the payload sent to
+* the frontend even though the underlying thread state has the value.
+*
+* Use this on any custom state field you want visible to the frontend
+* via `useAgent().state.*`.
+*
+* @example
+* ```ts
+* import { zodState } from "@copilotkit/sdk-js/langgraph";
+*
+* const stateSchema = z.object({
+*   todos: zodState(z.array(TodoSchema).default(() => [])),
+* });
+* ```
+*/
+function zodState(schema) {
+	const std = schema["~standard"];
+	if (std && typeof std === "object" && !("jsonSchema" in std)) {
+		let cached;
+		std.jsonSchema = { input: () => {
+			if (cached) return cached;
+			try {
+				const maybeV4ToJsonSchema = zod.toJSONSchema;
+				cached = typeof maybeV4ToJsonSchema === "function" ? maybeV4ToJsonSchema(schema) : {};
+			} catch {
+				cached = {};
+			}
+			return cached;
+		} };
+	}
+	return schema;
+}
+/**
+* Internal/framework state keys that should never be auto-surfaced to the
+* LLM as user-facing state. These are reducer-managed message buckets,
+* CopilotKit/AG-UI plumbing, or graph-internal scaffolding.
+*/
+const RESERVED_STATE_KEYS = new Set([
+	"messages",
+	"copilotkit",
+	"ag-ui",
+	"tools",
+	"structured_response",
+	"thread_id",
+	"remaining_steps"
+]);
+const buildStateNote = (state, expose) => {
+	if (expose === false) return null;
+	const allow = Array.isArray(expose) ? new Set(expose) : null;
+	const snapshot = {};
+	for (const key of Object.keys(state)) {
+		if (allow ? !allow.has(key) : RESERVED_STATE_KEYS.has(key) || key.startsWith("_")) continue;
+		const value = state[key];
+		if (value === void 0 || value === null || value === "" || Array.isArray(value) && value.length === 0 || typeof value === "object" && !Array.isArray(value) && Object.keys(value).length === 0) continue;
+		snapshot[key] = value;
+	}
+	if (Object.keys(snapshot).length === 0) return null;
+	let body;
+	try {
+		body = JSON.stringify(snapshot, null, 2);
+	} catch {
+		body = String(snapshot);
+	}
+	return `Current agent state:\n${body}`;
+};
+const applyStateNote = (request, expose) => {
+	const note = buildStateNote(request.state ?? {}, expose);
+	if (!note) return request;
+	const existing = request.systemPrompt;
+	if (existing == null) return {
+		...request,
+		systemPrompt: new langchain.SystemMessage({ content: note })
+	};
+	const baseText = typeof existing === "string" ? existing : typeof existing.content === "string" ? existing.content : String(existing.content);
+	return {
+		...request,
+		systemPrompt: new langchain.SystemMessage({ content: `${baseText}\n\n${note}` })
+	};
+};
 const createAppContextBeforeAgent = (state, runtime) => {
 	const messages = state.messages;
 	if (!messages || messages.length === 0) return;
@@ -55,15 +143,38 @@ const createAppContextBeforeAgent = (state, runtime) => {
 		messages: updatedMessages
 	};
 };
-const middlewareInput = {
+/**
+* CopilotKit Middleware for LangGraph agents.
+*
+* Enables:
+* - Dynamic frontend tools from state.tools
+* - Context provided from CopilotKit useCopilotReadable
+*
+* Works with any agent (prebuilt or custom).
+*
+* @example
+* ```typescript
+* import { createAgent } from "langchain";
+* import { copilotkitMiddleware } from "@copilotkit/sdk-js/langgraph";
+*
+* const agent = createAgent({
+*   model: "gpt-4o",
+*   tools: [backendTool],
+*   middleware: [copilotkitMiddleware],
+* });
+* ```
+*/
+const copilotKitStateSchema = zod.object({ copilotkit: zodState(zod.object({
+	actions: zod.array(zod.any()),
+	context: zod.any().optional(),
+	interceptedToolCalls: zod.array(zod.any()).optional(),
+	originalAIMessageId: zod.string().optional()
+}).optional()) });
+const buildMiddlewareInput = (exposeState) => ({
 	name: "CopilotKitMiddleware",
-	stateSchema: zod.object({ copilotkit: zod.object({
-		actions: zod.array(zod.any()),
-		context: zod.any().optional(),
-		interceptedToolCalls: zod.array(zod.any()).optional(),
-		originalAIMessageId: zod.string().optional()
-	}).optional() }),
+	stateSchema: copilotKitStateSchema,
 	wrapModelCall: async (request, handler) => {
+		request = applyStateNote(request, exposeState);
 		const frontendTools = request.state["copilotkit"]?.actions ?? [];
 		if (frontendTools.length === 0) return handler(request);
 		const mergedTools = [...request.tools || [], ...frontendTools];
@@ -128,12 +239,34 @@ const middlewareInput = {
 			}
 		};
 	}
+});
+/**
+* Build a CopilotKit middleware instance with custom options.
+*
+* Use this when you want to override the default state-exposure behavior
+* (for example to hide a sensitive key, or to use an explicit allowlist).
+*
+* @example
+* ```typescript
+* import { createCopilotkitMiddleware } from "@copilotkit/sdk-js/langgraph";
+*
+* const middleware = createCopilotkitMiddleware({
+*   exposeState: ["liked", "todos"],
+* });
+* ```
+*/
+const createCopilotkitMiddleware = (options = {}) => {
+	return (0, langchain.createMiddleware)(buildMiddlewareInput(options.exposeState ?? false));
 };
-const createCopilotKitMiddleware = () => {
-	return (0, langchain.createMiddleware)(middlewareInput);
-};
-const copilotkitMiddleware = createCopilotKitMiddleware();
+/**
+* Default CopilotKit middleware singleton — does NOT surface user state
+* to the LLM. Pass `exposeState: true` (or an allowlist) to
+* {@link createCopilotkitMiddleware} to opt in.
+*/
+const copilotkitMiddleware = createCopilotkitMiddleware();
 
 //#endregion
 exports.copilotkitMiddleware = copilotkitMiddleware;
+exports.createCopilotkitMiddleware = createCopilotkitMiddleware;
+exports.zodState = zodState;
 //# sourceMappingURL=middleware.cjs.map

package/dist/langgraph/middleware.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"middleware.cjs","names":["SystemMessage","z","AIMessage"],"sources":["../../src/langgraph/middleware.ts"],"sourcesContent":["import { createMiddleware, AIMessage, SystemMessage } from \"langchain\";\nimport type { InteropZodObject } from \"@langchain/core/utils/types\";\nimport * as z from \"zod\";\n\nconst createAppContextBeforeAgent = (state, runtime) => {\n  const messages = state.messages;\n\n  if (!messages || messages.length === 0) {\n    return;\n  }\n\n  // Get app context from runtime\n  const appContext = state[\"copilotkit\"]?.context ?? runtime?.context;\n\n  // Check if appContext is missing or empty\n  const isEmptyContext =\n    !appContext ||\n    (typeof appContext === \"string\" && appContext.trim() === \"\") ||\n    (typeof appContext === \"object\" && Object.keys(appContext).length === 0);\n\n  if (isEmptyContext) {\n    return;\n  }\n\n  // Create the context content\n  const contextContent =\n    typeof appContext === \"string\"\n      ? appContext\n      : JSON.stringify(appContext, null, 2);\n  const contextMessageContent = `App Context:\\n${contextContent}`;\n  const contextMessagePrefix = \"App Context:\\n\";\n\n  // Helper to get message content as string\n  const getContentString = (msg: any): string | null => {\n    if (typeof msg.content === \"string\") return msg.content;\n    if (Array.isArray(msg.content) && msg.content[0]?.text)\n      return msg.content[0].text;\n    return null;\n  };\n\n  // Find the first system/developer message (not our context message) to determine\n  // where to insert our context message (right after it)\n  let firstSystemIndex = -1;\n\n  for (let i = 0; i < messages.length; i++) {\n    const msg = messages[i];\n    const type = msg._getType?.();\n    if (type === \"system\" || type === \"developer\") {\n      const content = getContentString(msg);\n      // Skip if this is our own context message\n      if (content?.startsWith(contextMessagePrefix)) {\n        continue;\n      }\n      firstSystemIndex = i;\n      break;\n    }\n  }\n\n  // Check if our context message already exists\n  let existingContextIndex = -1;\n  for (let i = 0; i < messages.length; i++) {\n    const msg = messages[i];\n    const type = msg._getType?.();\n    if (type === \"system\" || type === \"developer\") {\n      const content = getContentString(msg);\n      if (content?.startsWith(contextMessagePrefix)) {\n        existingContextIndex = i;\n        break;\n      }\n    }\n  }\n\n  // Create the context message\n  const contextMessage = new SystemMessage({ content: contextMessageContent });\n\n  let updatedMessages;\n\n  if (existingContextIndex !== -1) {\n    // Replace existing context message\n    updatedMessages = [...messages];\n    updatedMessages[existingContextIndex] = contextMessage;\n  } else {\n    // Insert after the first system message, or at position 0 if no system message\n    const insertIndex = firstSystemIndex !== -1 ? firstSystemIndex + 1 : 0;\n    updatedMessages = [\n      ...messages.slice(0, insertIndex),\n      contextMessage,\n      ...messages.slice(insertIndex),\n    ];\n  }\n\n  return {\n    ...state,\n    messages: updatedMessages,\n  };\n};\n\n/**\n * CopilotKit Middleware for LangGraph agents.\n *\n * Enables:\n * - Dynamic frontend tools from state.tools\n * - Context provided from CopilotKit useCopilotReadable\n *\n * Works with any agent (prebuilt or custom).\n *\n * @example\n * ```typescript\n * import { createAgent } from \"langchain\";\n * import { copilotkitMiddleware } from \"@copilotkit/sdk-js/langgraph\";\n *\n * const agent = createAgent({\n *   model: \"gpt-4o\",\n *   tools: [backendTool],\n *   middleware: [copilotkitMiddleware],\n * });\n * ```\n */\nconst copilotKitStateSchema = z.object({\n  copilotkit: z\n    .object({\n      actions: z.array(z.any()),\n      context: z.any().optional(),\n      interceptedToolCalls: z.array(z.any()).optional(),\n      originalAIMessageId: z.string().optional(),\n    })\n    .optional(),\n});\n\nconst middlewareInput = {\n  name: \"CopilotKitMiddleware\",\n\n  stateSchema: copilotKitStateSchema as unknown as InteropZodObject,\n\n  // Inject frontend tools before model call\n  wrapModelCall: async (request, handler) => {\n    const frontendTools = request.state[\"copilotkit\"]?.actions ?? [];\n\n    if (frontendTools.length === 0) {\n      return handler(request);\n    }\n\n    const existingTools = request.tools || [];\n    const mergedTools = [...existingTools, ...frontendTools];\n\n    return handler({\n      ...request,\n      tools: mergedTools,\n    });\n  },\n\n  beforeAgent: createAppContextBeforeAgent,\n\n  // Restore frontend tool calls to AIMessage before agent exits\n  afterAgent: (state) => {\n    const interceptedToolCalls = state[\"copilotkit\"]?.interceptedToolCalls;\n    const originalMessageId = state[\"copilotkit\"]?.originalAIMessageId;\n\n    if (!interceptedToolCalls?.length || !originalMessageId) {\n      return;\n    }\n\n    let messageFound = false;\n    const updatedMessages = state.messages.map((msg: any) => {\n      if (AIMessage.isInstance(msg) && msg.id === originalMessageId) {\n        messageFound = true;\n        const existingToolCalls = msg.tool_calls || [];\n        return new AIMessage({\n          content: msg.content,\n          tool_calls: [...existingToolCalls, ...interceptedToolCalls],\n          id: msg.id,\n        });\n      }\n      return msg;\n    });\n\n    // Only clear intercepted state if we successfully restored the tool calls\n    if (!messageFound) {\n      console.warn(\n        `CopilotKit: Could not find message with id ${originalMessageId} to restore tool calls`,\n      );\n      return;\n    }\n\n    return {\n      messages: updatedMessages,\n      copilotkit: {\n        ...state[\"copilotkit\"],\n        interceptedToolCalls: undefined,\n        originalAIMessageId: undefined,\n      },\n    };\n  },\n\n  // Intercept frontend tool calls after model returns, before ToolNode executes\n  afterModel: (state) => {\n    const frontendTools = state[\"copilotkit\"]?.actions ?? [];\n    if (frontendTools.length === 0) return;\n\n    const frontendToolNames = new Set(\n      frontendTools.map((t: any) => t.function?.name || t.name),\n    );\n\n    const lastMessage = state.messages[state.messages.length - 1];\n    if (!AIMessage.isInstance(lastMessage) || !lastMessage.tool_calls?.length) {\n      return;\n    }\n\n    const backendToolCalls: any[] = [];\n    const frontendToolCalls: any[] = [];\n\n    for (const call of lastMessage.tool_calls) {\n      if (frontendToolNames.has(call.name)) {\n        frontendToolCalls.push(call);\n      } else {\n        backendToolCalls.push(call);\n      }\n    }\n\n    if (frontendToolCalls.length === 0) return;\n\n    const updatedAIMessage = new AIMessage({\n      content: lastMessage.content,\n      tool_calls: backendToolCalls,\n      id: lastMessage.id,\n    });\n\n    return {\n      messages: [...state.messages.slice(0, -1), updatedAIMessage],\n      copilotkit: {\n        ...state[\"copilotkit\"],\n        interceptedToolCalls: frontendToolCalls,\n        originalAIMessageId: lastMessage.id,\n      },\n    };\n  },\n} as any;\nconst createCopilotKitMiddleware = () => {\n  return createMiddleware(middlewareInput);\n};\n\nexport const copilotkitMiddleware = createCopilotKitMiddleware();\n"],"mappings":"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"}
+{"version":3,"file":"middleware.cjs","names":["z","SystemMessage","AIMessage"],"sources":["../../src/langgraph/middleware.ts"],"sourcesContent":["import { createMiddleware, AIMessage, SystemMessage } from \"langchain\";\nimport type { InteropZodObject } from \"@langchain/core/utils/types\";\nimport type {\n  StandardJSONSchemaV1,\n  StandardSchemaV1,\n} from \"@standard-schema/spec\";\nimport * as z from \"zod\";\n\ntype WithJsonSchema<T> = T extends { \"~standard\": infer S }\n  ? Omit<T, \"~standard\"> & {\n      \"~standard\": S &\n        StandardJSONSchemaV1.Props<\n          S extends StandardSchemaV1.Props<infer I, any> ? I : unknown,\n          S extends StandardSchemaV1.Props<any, infer O> ? O : unknown\n        >;\n    }\n  : T;\n\n/**\n * Augment a Standard-Schema–compatible schema (e.g. Zod) with a\n * `~standard.jsonSchema.input` hook so LangGraph's\n * `getJsonSchemaFromSchema` (called from `StateSchema.getJsonSchema`)\n * can serialize the field.\n *\n * Without this, Zod v4 fields carry `~standard.validate` + `vendor` only,\n * and `isStandardJSONSchema()` returns false, so the field is silently\n * dropped from the graph's `output_schema`. That makes AG-UI\n * `STATE_SNAPSHOT` events filter the field out of the payload sent to\n * the frontend even though the underlying thread state has the value.\n *\n * Use this on any custom state field you want visible to the frontend\n * via `useAgent().state.*`.\n *\n * @example\n * ```ts\n * import { zodState } from \"@copilotkit/sdk-js/langgraph\";\n *\n * const stateSchema = z.object({\n *   todos: zodState(z.array(TodoSchema).default(() => [])),\n * });\n * ```\n */\nexport function zodState<T extends object>(schema: T): WithJsonSchema<T> {\n  const std = (schema as { \"~standard\"?: { jsonSchema?: unknown } })[\n    \"~standard\"\n  ];\n  if (std && typeof std === \"object\" && !(\"jsonSchema\" in std)) {\n    let cached: Record<string, unknown> | undefined;\n    std.jsonSchema = {\n      input: () => {\n        if (cached) return cached;\n        // Prefer zod-v4's native `toJSONSchema` when available. Falls back to\n        // an empty object, which is sufficient for the field to appear in the\n        // graph's output_schema (langgraph-api treats it as an opaque field).\n        try {\n          const maybeV4ToJsonSchema = (\n            z as unknown as {\n              toJSONSchema?: (s: unknown) => Record<string, unknown>;\n            }\n          ).toJSONSchema;\n          cached =\n            typeof maybeV4ToJsonSchema === \"function\"\n              ? maybeV4ToJsonSchema(schema)\n              : {};\n        } catch {\n          cached = {};\n        }\n        return cached;\n      },\n    };\n  }\n  return schema as WithJsonSchema<T>;\n}\n\n/**\n * Internal/framework state keys that should never be auto-surfaced to the\n * LLM as user-facing state. These are reducer-managed message buckets,\n * CopilotKit/AG-UI plumbing, or graph-internal scaffolding.\n */\nconst RESERVED_STATE_KEYS: ReadonlySet<string> = new Set([\n  \"messages\",\n  \"copilotkit\",\n  \"ag-ui\",\n  \"tools\",\n  \"structured_response\",\n  \"thread_id\",\n  \"remaining_steps\",\n]);\n\n/**\n * Controls how user-defined state keys are surfaced into the LLM prompt\n * on every model call. Off by default to avoid leaking arbitrary state\n * into prompts; opt in explicitly.\n *\n * - `false` (default) — never surface state.\n * - `true` — every state key not in the reserved internal set and not\n *   prefixed with `_` is JSON-serialized into a \"Current agent state:\"\n *   note appended to the system prompt.\n * - `string[]` — only surface the named keys (use this when you want\n *   explicit control over what the LLM sees, e.g. `[\"liked\", \"todos\"]`).\n */\nexport type ExposeStateOption = boolean | readonly string[];\n\nconst buildStateNote = (\n  state: Record<string, unknown>,\n  expose: ExposeStateOption,\n): string | null => {\n  if (expose === false) return null;\n\n  const allow: ReadonlySet<string> | null = Array.isArray(expose)\n    ? new Set(expose)\n    : null;\n\n  const snapshot: Record<string, unknown> = {};\n  for (const key of Object.keys(state)) {\n    if (\n      allow\n        ? !allow.has(key)\n        : RESERVED_STATE_KEYS.has(key) || key.startsWith(\"_\")\n    ) {\n      continue;\n    }\n    const value = state[key];\n    if (\n      value === undefined ||\n      value === null ||\n      value === \"\" ||\n      (Array.isArray(value) && value.length === 0) ||\n      (typeof value === \"object\" &&\n        !Array.isArray(value) &&\n        Object.keys(value as Record<string, unknown>).length === 0)\n    ) {\n      continue;\n    }\n    snapshot[key] = value;\n  }\n\n  if (Object.keys(snapshot).length === 0) return null;\n\n  let body: string;\n  try {\n    body = JSON.stringify(snapshot, null, 2);\n  } catch {\n    body = String(snapshot);\n  }\n  return `Current agent state:\\n${body}`;\n};\n\nconst applyStateNote = (request: any, expose: ExposeStateOption): any => {\n  const note = buildStateNote(\n    (request.state ?? {}) as Record<string, unknown>,\n    expose,\n  );\n  if (!note) return request;\n\n  const existing = request.systemPrompt;\n  if (existing == null) {\n    return { ...request, systemPrompt: new SystemMessage({ content: note }) };\n  }\n  // existing may be a string OR a SystemMessage\n  const baseText =\n    typeof existing === \"string\"\n      ? existing\n      : typeof existing.content === \"string\"\n        ? existing.content\n        : String(existing.content);\n  return {\n    ...request,\n    systemPrompt: new SystemMessage({ content: `${baseText}\\n\\n${note}` }),\n  };\n};\n\nconst createAppContextBeforeAgent = (state, runtime) => {\n  const messages = state.messages;\n\n  if (!messages || messages.length === 0) {\n    return;\n  }\n\n  // Get app context from runtime\n  const appContext = state[\"copilotkit\"]?.context ?? runtime?.context;\n\n  // Check if appContext is missing or empty\n  const isEmptyContext =\n    !appContext ||\n    (typeof appContext === \"string\" && appContext.trim() === \"\") ||\n    (typeof appContext === \"object\" && Object.keys(appContext).length === 0);\n\n  if (isEmptyContext) {\n    return;\n  }\n\n  // Create the context content\n  const contextContent =\n    typeof appContext === \"string\"\n      ? appContext\n      : JSON.stringify(appContext, null, 2);\n  const contextMessageContent = `App Context:\\n${contextContent}`;\n  const contextMessagePrefix = \"App Context:\\n\";\n\n  // Helper to get message content as string\n  const getContentString = (msg: any): string | null => {\n    if (typeof msg.content === \"string\") return msg.content;\n    if (Array.isArray(msg.content) && msg.content[0]?.text)\n      return msg.content[0].text;\n    return null;\n  };\n\n  // Find the first system/developer message (not our context message) to determine\n  // where to insert our context message (right after it)\n  let firstSystemIndex = -1;\n\n  for (let i = 0; i < messages.length; i++) {\n    const msg = messages[i];\n    const type = msg._getType?.();\n    if (type === \"system\" || type === \"developer\") {\n      const content = getContentString(msg);\n      // Skip if this is our own context message\n      if (content?.startsWith(contextMessagePrefix)) {\n        continue;\n      }\n      firstSystemIndex = i;\n      break;\n    }\n  }\n\n  // Check if our context message already exists\n  let existingContextIndex = -1;\n  for (let i = 0; i < messages.length; i++) {\n    const msg = messages[i];\n    const type = msg._getType?.();\n    if (type === \"system\" || type === \"developer\") {\n      const content = getContentString(msg);\n      if (content?.startsWith(contextMessagePrefix)) {\n        existingContextIndex = i;\n        break;\n      }\n    }\n  }\n\n  // Create the context message\n  const contextMessage = new SystemMessage({ content: contextMessageContent });\n\n  let updatedMessages;\n\n  if (existingContextIndex !== -1) {\n    // Replace existing context message\n    updatedMessages = [...messages];\n    updatedMessages[existingContextIndex] = contextMessage;\n  } else {\n    // Insert after the first system message, or at position 0 if no system message\n    const insertIndex = firstSystemIndex !== -1 ? firstSystemIndex + 1 : 0;\n    updatedMessages = [\n      ...messages.slice(0, insertIndex),\n      contextMessage,\n      ...messages.slice(insertIndex),\n    ];\n  }\n\n  return {\n    ...state,\n    messages: updatedMessages,\n  };\n};\n\n/**\n * CopilotKit Middleware for LangGraph agents.\n *\n * Enables:\n * - Dynamic frontend tools from state.tools\n * - Context provided from CopilotKit useCopilotReadable\n *\n * Works with any agent (prebuilt or custom).\n *\n * @example\n * ```typescript\n * import { createAgent } from \"langchain\";\n * import { copilotkitMiddleware } from \"@copilotkit/sdk-js/langgraph\";\n *\n * const agent = createAgent({\n *   model: \"gpt-4o\",\n *   tools: [backendTool],\n *   middleware: [copilotkitMiddleware],\n * });\n * ```\n */\nconst copilotKitStateSchema = z.object({\n  copilotkit: zodState(\n    z\n      .object({\n        actions: z.array(z.any()),\n        context: z.any().optional(),\n        interceptedToolCalls: z.array(z.any()).optional(),\n        originalAIMessageId: z.string().optional(),\n      })\n      .optional(),\n  ),\n});\n\nconst buildMiddlewareInput = (exposeState: ExposeStateOption) => ({\n  name: \"CopilotKitMiddleware\",\n\n  stateSchema: copilotKitStateSchema as unknown as InteropZodObject,\n\n  // Inject frontend tools and surface user state before model call\n  wrapModelCall: async (request: any, handler: (req: any) => Promise<any>) => {\n    request = applyStateNote(request, exposeState);\n    const frontendTools = request.state[\"copilotkit\"]?.actions ?? [];\n\n    if (frontendTools.length === 0) {\n      return handler(request);\n    }\n\n    const existingTools = request.tools || [];\n    const mergedTools = [...existingTools, ...frontendTools];\n\n    return handler({\n      ...request,\n      tools: mergedTools,\n    });\n  },\n\n  beforeAgent: createAppContextBeforeAgent,\n\n  // Restore frontend tool calls to AIMessage before agent exits\n  afterAgent: (state) => {\n    const interceptedToolCalls = state[\"copilotkit\"]?.interceptedToolCalls;\n    const originalMessageId = state[\"copilotkit\"]?.originalAIMessageId;\n\n    if (!interceptedToolCalls?.length || !originalMessageId) {\n      return;\n    }\n\n    let messageFound = false;\n    const updatedMessages = state.messages.map((msg: any) => {\n      if (AIMessage.isInstance(msg) && msg.id === originalMessageId) {\n        messageFound = true;\n        const existingToolCalls = msg.tool_calls || [];\n        return new AIMessage({\n          content: msg.content,\n          tool_calls: [...existingToolCalls, ...interceptedToolCalls],\n          id: msg.id,\n        });\n      }\n      return msg;\n    });\n\n    // Only clear intercepted state if we successfully restored the tool calls\n    if (!messageFound) {\n      console.warn(\n        `CopilotKit: Could not find message with id ${originalMessageId} to restore tool calls`,\n      );\n      return;\n    }\n\n    return {\n      messages: updatedMessages,\n      copilotkit: {\n        ...state[\"copilotkit\"],\n        interceptedToolCalls: undefined,\n        originalAIMessageId: undefined,\n      },\n    };\n  },\n\n  // Intercept frontend tool calls after model returns, before ToolNode executes\n  afterModel: (state) => {\n    const frontendTools = state[\"copilotkit\"]?.actions ?? [];\n    if (frontendTools.length === 0) return;\n\n    const frontendToolNames = new Set(\n      frontendTools.map((t: any) => t.function?.name || t.name),\n    );\n\n    const lastMessage = state.messages[state.messages.length - 1];\n    if (!AIMessage.isInstance(lastMessage) || !lastMessage.tool_calls?.length) {\n      return;\n    }\n\n    const backendToolCalls: any[] = [];\n    const frontendToolCalls: any[] = [];\n\n    for (const call of lastMessage.tool_calls) {\n      if (frontendToolNames.has(call.name)) {\n        frontendToolCalls.push(call);\n      } else {\n        backendToolCalls.push(call);\n      }\n    }\n\n    if (frontendToolCalls.length === 0) return;\n\n    const updatedAIMessage = new AIMessage({\n      content: lastMessage.content,\n      tool_calls: backendToolCalls,\n      id: lastMessage.id,\n    });\n\n    return {\n      messages: [...state.messages.slice(0, -1), updatedAIMessage],\n      copilotkit: {\n        ...state[\"copilotkit\"],\n        interceptedToolCalls: frontendToolCalls,\n        originalAIMessageId: lastMessage.id,\n      },\n    };\n  },\n});\n\n/**\n * Build a CopilotKit middleware instance with custom options.\n *\n * Use this when you want to override the default state-exposure behavior\n * (for example to hide a sensitive key, or to use an explicit allowlist).\n *\n * @example\n * ```typescript\n * import { createCopilotkitMiddleware } from \"@copilotkit/sdk-js/langgraph\";\n *\n * const middleware = createCopilotkitMiddleware({\n *   exposeState: [\"liked\", \"todos\"],\n * });\n * ```\n */\nexport const createCopilotkitMiddleware = (\n  options: { exposeState?: ExposeStateOption } = {},\n) => {\n  const exposeState = options.exposeState ?? false;\n  return createMiddleware(buildMiddlewareInput(exposeState) as any);\n};\n\n/**\n * Default CopilotKit middleware singleton — does NOT surface user state\n * to the LLM. Pass `exposeState: true` (or an allowlist) to\n * {@link createCopilotkitMiddleware} to opt in.\n */\nexport const copilotkitMiddleware = createCopilotkitMiddleware();\n"],"mappings":"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"}

package/dist/langgraph/middleware.d.cts

@@ -1,8 +1,75 @@
 import * as langchain from "langchain";
 import * as _langchain_core_tools0 from "@langchain/core/tools";
+import { StandardJSONSchemaV1, StandardSchemaV1 } from "@standard-schema/spec";
 
 //#region src/langgraph/middleware.d.ts
+type WithJsonSchema<T> = T extends {
+  "~standard": infer S;
+} ? Omit<T, "~standard"> & {
+  "~standard": S & StandardJSONSchemaV1.Props<S extends StandardSchemaV1.Props<infer I, any> ? I : unknown, S extends StandardSchemaV1.Props<any, infer O> ? O : unknown>;
+} : T;
+/**
+ * Augment a Standard-Schema–compatible schema (e.g. Zod) with a
+ * `~standard.jsonSchema.input` hook so LangGraph's
+ * `getJsonSchemaFromSchema` (called from `StateSchema.getJsonSchema`)
+ * can serialize the field.
+ *
+ * Without this, Zod v4 fields carry `~standard.validate` + `vendor` only,
+ * and `isStandardJSONSchema()` returns false, so the field is silently
+ * dropped from the graph's `output_schema`. That makes AG-UI
+ * `STATE_SNAPSHOT` events filter the field out of the payload sent to
+ * the frontend even though the underlying thread state has the value.
+ *
+ * Use this on any custom state field you want visible to the frontend
+ * via `useAgent().state.*`.
+ *
+ * @example
+ * ```ts
+ * import { zodState } from "@copilotkit/sdk-js/langgraph";
+ *
+ * const stateSchema = z.object({
+ *   todos: zodState(z.array(TodoSchema).default(() => [])),
+ * });
+ * ```
+ */
+declare function zodState<T extends object>(schema: T): WithJsonSchema<T>;
+/**
+ * Controls how user-defined state keys are surfaced into the LLM prompt
+ * on every model call. Off by default to avoid leaking arbitrary state
+ * into prompts; opt in explicitly.
+ *
+ * - `false` (default) — never surface state.
+ * - `true` — every state key not in the reserved internal set and not
+ *   prefixed with `_` is JSON-serialized into a "Current agent state:"
+ *   note appended to the system prompt.
+ * - `string[]` — only surface the named keys (use this when you want
+ *   explicit control over what the LLM sees, e.g. `["liked", "todos"]`).
+ */
+type ExposeStateOption = boolean | readonly string[];
+/**
+ * Build a CopilotKit middleware instance with custom options.
+ *
+ * Use this when you want to override the default state-exposure behavior
+ * (for example to hide a sensitive key, or to use an explicit allowlist).
+ *
+ * @example
+ * ```typescript
+ * import { createCopilotkitMiddleware } from "@copilotkit/sdk-js/langgraph";
+ *
+ * const middleware = createCopilotkitMiddleware({
+ *   exposeState: ["liked", "todos"],
+ * });
+ * ```
+ */
+declare const createCopilotkitMiddleware: (options?: {
+  exposeState?: ExposeStateOption;
+}) => langchain.AgentMiddleware<undefined, undefined, unknown, readonly (_langchain_core_tools0.ClientTool | _langchain_core_tools0.ServerTool)[]>;
+/**
+ * Default CopilotKit middleware singleton — does NOT surface user state
+ * to the LLM. Pass `exposeState: true` (or an allowlist) to
+ * {@link createCopilotkitMiddleware} to opt in.
+ */
 declare const copilotkitMiddleware: langchain.AgentMiddleware<undefined, undefined, unknown, readonly (_langchain_core_tools0.ClientTool | _langchain_core_tools0.ServerTool)[]>;
 //#endregion
-export { copilotkitMiddleware };
+export { ExposeStateOption, copilotkitMiddleware, createCopilotkitMiddleware, zodState };
 //# sourceMappingURL=middleware.d.cts.map

package/dist/langgraph/middleware.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"middleware.d.cts","names":[],"sources":["../../src/langgraph/middleware.ts"],"mappings":";;;;cAiPa,oBAAA,EAAoB,SAAA,CAAA,eAAA,0CAA+B,sBAAA,CAA/B,UAAA,GAAA,sBAAA,CAAA,UAAA"}
+{"version":3,"file":"middleware.d.cts","names":[],"sources":["../../src/langgraph/middleware.ts"],"mappings":";;;;;KAQK,cAAA,MAAoB,CAAA;EAAY,WAAA;AAAA,IACjC,IAAA,CAAK,CAAA;EACH,WAAA,EAAa,CAAA,GACX,oBAAA,CAAqB,KAAA,CACnB,CAAA,SAAU,gBAAA,CAAiB,KAAA,iBAAsB,CAAA,YACjD,CAAA,SAAU,gBAAA,CAAiB,KAAA,iBAAsB,CAAA;AAAA,IAGvD,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;iBA0BY,QAAA,kBAAA,CAA2B,MAAA,EAAQ,CAAA,GAAI,cAAA,CAAe,CAAA;;;;;;;;;;;AAAtE;;KA2DY,iBAAA;;;;;;;;;;;;;AAAZ;;;cAmUa,0BAAA,GACX,OAAA;EAAW,WAAA,GAAc,iBAAA;AAAA,MAAwB,SAAA,CAAA,eAAA,0CAAP,sBAAA,CAAO,UAAA,GAAA,sBAAA,CAAA,UAAA;;;;;;cAWtC,oBAAA,EAAoB,SAAA,CAAA,eAAA,0CAA+B,sBAAA,CAA/B,UAAA,GAAA,sBAAA,CAAA,UAAA"}

package/dist/langgraph/middleware.d.mts

@@ -1,8 +1,75 @@
 import * as _langchain_core_tools0 from "@langchain/core/tools";
 import * as langchain from "langchain";
+import { StandardJSONSchemaV1, StandardSchemaV1 } from "@standard-schema/spec";
 
 //#region src/langgraph/middleware.d.ts
+type WithJsonSchema<T> = T extends {
+  "~standard": infer S;
+} ? Omit<T, "~standard"> & {
+  "~standard": S & StandardJSONSchemaV1.Props<S extends StandardSchemaV1.Props<infer I, any> ? I : unknown, S extends StandardSchemaV1.Props<any, infer O> ? O : unknown>;
+} : T;
+/**
+ * Augment a Standard-Schema–compatible schema (e.g. Zod) with a
+ * `~standard.jsonSchema.input` hook so LangGraph's
+ * `getJsonSchemaFromSchema` (called from `StateSchema.getJsonSchema`)
+ * can serialize the field.
+ *
+ * Without this, Zod v4 fields carry `~standard.validate` + `vendor` only,
+ * and `isStandardJSONSchema()` returns false, so the field is silently
+ * dropped from the graph's `output_schema`. That makes AG-UI
+ * `STATE_SNAPSHOT` events filter the field out of the payload sent to
+ * the frontend even though the underlying thread state has the value.
+ *
+ * Use this on any custom state field you want visible to the frontend
+ * via `useAgent().state.*`.
+ *
+ * @example
+ * ```ts
+ * import { zodState } from "@copilotkit/sdk-js/langgraph";
+ *
+ * const stateSchema = z.object({
+ *   todos: zodState(z.array(TodoSchema).default(() => [])),
+ * });
+ * ```
+ */
+declare function zodState<T extends object>(schema: T): WithJsonSchema<T>;
+/**
+ * Controls how user-defined state keys are surfaced into the LLM prompt
+ * on every model call. Off by default to avoid leaking arbitrary state
+ * into prompts; opt in explicitly.
+ *
+ * - `false` (default) — never surface state.
+ * - `true` — every state key not in the reserved internal set and not
+ *   prefixed with `_` is JSON-serialized into a "Current agent state:"
+ *   note appended to the system prompt.
+ * - `string[]` — only surface the named keys (use this when you want
+ *   explicit control over what the LLM sees, e.g. `["liked", "todos"]`).
+ */
+type ExposeStateOption = boolean | readonly string[];
+/**
+ * Build a CopilotKit middleware instance with custom options.
+ *
+ * Use this when you want to override the default state-exposure behavior
+ * (for example to hide a sensitive key, or to use an explicit allowlist).
+ *
+ * @example
+ * ```typescript
+ * import { createCopilotkitMiddleware } from "@copilotkit/sdk-js/langgraph";
+ *
+ * const middleware = createCopilotkitMiddleware({
+ *   exposeState: ["liked", "todos"],
+ * });
+ * ```
+ */
+declare const createCopilotkitMiddleware: (options?: {
+  exposeState?: ExposeStateOption;
+}) => langchain.AgentMiddleware<undefined, undefined, unknown, readonly (_langchain_core_tools0.ClientTool | _langchain_core_tools0.ServerTool)[]>;
+/**
+ * Default CopilotKit middleware singleton — does NOT surface user state
+ * to the LLM. Pass `exposeState: true` (or an allowlist) to
+ * {@link createCopilotkitMiddleware} to opt in.
+ */
 declare const copilotkitMiddleware: langchain.AgentMiddleware<undefined, undefined, unknown, readonly (_langchain_core_tools0.ClientTool | _langchain_core_tools0.ServerTool)[]>;
 //#endregion
-export { copilotkitMiddleware };
+export { ExposeStateOption, copilotkitMiddleware, createCopilotkitMiddleware, zodState };
 //# sourceMappingURL=middleware.d.mts.map

package/dist/langgraph/middleware.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"middleware.d.mts","names":[],"sources":["../../src/langgraph/middleware.ts"],"mappings":";;;;cAiPa,oBAAA,EAAoB,SAAA,CAAA,eAAA,0CAA+B,sBAAA,CAA/B,UAAA,GAAA,sBAAA,CAAA,UAAA"}
+{"version":3,"file":"middleware.d.mts","names":[],"sources":["../../src/langgraph/middleware.ts"],"mappings":";;;;;KAQK,cAAA,MAAoB,CAAA;EAAY,WAAA;AAAA,IACjC,IAAA,CAAK,CAAA;EACH,WAAA,EAAa,CAAA,GACX,oBAAA,CAAqB,KAAA,CACnB,CAAA,SAAU,gBAAA,CAAiB,KAAA,iBAAsB,CAAA,YACjD,CAAA,SAAU,gBAAA,CAAiB,KAAA,iBAAsB,CAAA;AAAA,IAGvD,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;iBA0BY,QAAA,kBAAA,CAA2B,MAAA,EAAQ,CAAA,GAAI,cAAA,CAAe,CAAA;;;;;;;;;;;AAAtE;;KA2DY,iBAAA;;;;;;;;;;;;;AAAZ;;;cAmUa,0BAAA,GACX,OAAA;EAAW,WAAA,GAAc,iBAAA;AAAA,MAAwB,SAAA,CAAA,eAAA,0CAAP,sBAAA,CAAO,UAAA,GAAA,sBAAA,CAAA,UAAA;;;;;;cAWtC,oBAAA,EAAoB,SAAA,CAAA,eAAA,0CAA+B,sBAAA,CAA/B,UAAA,GAAA,sBAAA,CAAA,UAAA"}

package/dist/langgraph/middleware.mjs

@@ -2,6 +2,94 @@ import { AIMessage, SystemMessage, createMiddleware } from "langchain";
 import * as z from "zod";
 
 //#region src/langgraph/middleware.ts
+/**
+* Augment a Standard-Schema–compatible schema (e.g. Zod) with a
+* `~standard.jsonSchema.input` hook so LangGraph's
+* `getJsonSchemaFromSchema` (called from `StateSchema.getJsonSchema`)
+* can serialize the field.
+*
+* Without this, Zod v4 fields carry `~standard.validate` + `vendor` only,
+* and `isStandardJSONSchema()` returns false, so the field is silently
+* dropped from the graph's `output_schema`. That makes AG-UI
+* `STATE_SNAPSHOT` events filter the field out of the payload sent to
+* the frontend even though the underlying thread state has the value.
+*
+* Use this on any custom state field you want visible to the frontend
+* via `useAgent().state.*`.
+*
+* @example
+* ```ts
+* import { zodState } from "@copilotkit/sdk-js/langgraph";
+*
+* const stateSchema = z.object({
+*   todos: zodState(z.array(TodoSchema).default(() => [])),
+* });
+* ```
+*/
+function zodState(schema) {
+	const std = schema["~standard"];
+	if (std && typeof std === "object" && !("jsonSchema" in std)) {
+		let cached;
+		std.jsonSchema = { input: () => {
+			if (cached) return cached;
+			try {
+				const maybeV4ToJsonSchema = z.toJSONSchema;
+				cached = typeof maybeV4ToJsonSchema === "function" ? maybeV4ToJsonSchema(schema) : {};
+			} catch {
+				cached = {};
+			}
+			return cached;
+		} };
+	}
+	return schema;
+}
+/**
+* Internal/framework state keys that should never be auto-surfaced to the
+* LLM as user-facing state. These are reducer-managed message buckets,
+* CopilotKit/AG-UI plumbing, or graph-internal scaffolding.
+*/
+const RESERVED_STATE_KEYS = new Set([
+	"messages",
+	"copilotkit",
+	"ag-ui",
+	"tools",
+	"structured_response",
+	"thread_id",
+	"remaining_steps"
+]);
+const buildStateNote = (state, expose) => {
+	if (expose === false) return null;
+	const allow = Array.isArray(expose) ? new Set(expose) : null;
+	const snapshot = {};
+	for (const key of Object.keys(state)) {
+		if (allow ? !allow.has(key) : RESERVED_STATE_KEYS.has(key) || key.startsWith("_")) continue;
+		const value = state[key];
+		if (value === void 0 || value === null || value === "" || Array.isArray(value) && value.length === 0 || typeof value === "object" && !Array.isArray(value) && Object.keys(value).length === 0) continue;
+		snapshot[key] = value;
+	}
+	if (Object.keys(snapshot).length === 0) return null;
+	let body;
+	try {
+		body = JSON.stringify(snapshot, null, 2);
+	} catch {
+		body = String(snapshot);
+	}
+	return `Current agent state:\n${body}`;
+};
+const applyStateNote = (request, expose) => {
+	const note = buildStateNote(request.state ?? {}, expose);
+	if (!note) return request;
+	const existing = request.systemPrompt;
+	if (existing == null) return {
+		...request,
+		systemPrompt: new SystemMessage({ content: note })
+	};
+	const baseText = typeof existing === "string" ? existing : typeof existing.content === "string" ? existing.content : String(existing.content);
+	return {
+		...request,
+		systemPrompt: new SystemMessage({ content: `${baseText}\n\n${note}` })
+	};
+};
 const createAppContextBeforeAgent = (state, runtime) => {
 	const messages = state.messages;
 	if (!messages || messages.length === 0) return;
@@ -53,15 +141,38 @@ const createAppContextBeforeAgent = (state, runtime) => {
 		messages: updatedMessages
 	};
 };
-const middlewareInput = {
+/**
+* CopilotKit Middleware for LangGraph agents.
+*
+* Enables:
+* - Dynamic frontend tools from state.tools
+* - Context provided from CopilotKit useCopilotReadable
+*
+* Works with any agent (prebuilt or custom).
+*
+* @example
+* ```typescript
+* import { createAgent } from "langchain";
+* import { copilotkitMiddleware } from "@copilotkit/sdk-js/langgraph";
+*
+* const agent = createAgent({
+*   model: "gpt-4o",
+*   tools: [backendTool],
+*   middleware: [copilotkitMiddleware],
+* });
+* ```
+*/
+const copilotKitStateSchema = z.object({ copilotkit: zodState(z.object({
+	actions: z.array(z.any()),
+	context: z.any().optional(),
+	interceptedToolCalls: z.array(z.any()).optional(),
+	originalAIMessageId: z.string().optional()
+}).optional()) });
+const buildMiddlewareInput = (exposeState) => ({
 	name: "CopilotKitMiddleware",
-	stateSchema: z.object({ copilotkit: z.object({
-		actions: z.array(z.any()),
-		context: z.any().optional(),
-		interceptedToolCalls: z.array(z.any()).optional(),
-		originalAIMessageId: z.string().optional()
-	}).optional() }),
+	stateSchema: copilotKitStateSchema,
 	wrapModelCall: async (request, handler) => {
+		request = applyStateNote(request, exposeState);
 		const frontendTools = request.state["copilotkit"]?.actions ?? [];
 		if (frontendTools.length === 0) return handler(request);
 		const mergedTools = [...request.tools || [], ...frontendTools];
@@ -126,12 +237,32 @@ const middlewareInput = {
 			}
 		};
 	}
+});
+/**
+* Build a CopilotKit middleware instance with custom options.
+*
+* Use this when you want to override the default state-exposure behavior
+* (for example to hide a sensitive key, or to use an explicit allowlist).
+*
+* @example
+* ```typescript
+* import { createCopilotkitMiddleware } from "@copilotkit/sdk-js/langgraph";
+*
+* const middleware = createCopilotkitMiddleware({
+*   exposeState: ["liked", "todos"],
+* });
+* ```
+*/
+const createCopilotkitMiddleware = (options = {}) => {
+	return createMiddleware(buildMiddlewareInput(options.exposeState ?? false));
 };
-const createCopilotKitMiddleware = () => {
-	return createMiddleware(middlewareInput);
-};
-const copilotkitMiddleware = createCopilotKitMiddleware();
+/**
+* Default CopilotKit middleware singleton — does NOT surface user state
+* to the LLM. Pass `exposeState: true` (or an allowlist) to
+* {@link createCopilotkitMiddleware} to opt in.
+*/
+const copilotkitMiddleware = createCopilotkitMiddleware();
 
 //#endregion
-export { copilotkitMiddleware };
+export { copilotkitMiddleware, createCopilotkitMiddleware, zodState };
 //# sourceMappingURL=middleware.mjs.map

package/dist/langgraph/middleware.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"middleware.mjs","names":[],"sources":["../../src/langgraph/middleware.ts"],"sourcesContent":["import { createMiddleware, AIMessage, SystemMessage } from \"langchain\";\nimport type { InteropZodObject } from \"@langchain/core/utils/types\";\nimport * as z from \"zod\";\n\nconst createAppContextBeforeAgent = (state, runtime) => {\n  const messages = state.messages;\n\n  if (!messages || messages.length === 0) {\n    return;\n  }\n\n  // Get app context from runtime\n  const appContext = state[\"copilotkit\"]?.context ?? runtime?.context;\n\n  // Check if appContext is missing or empty\n  const isEmptyContext =\n    !appContext ||\n    (typeof appContext === \"string\" && appContext.trim() === \"\") ||\n    (typeof appContext === \"object\" && Object.keys(appContext).length === 0);\n\n  if (isEmptyContext) {\n    return;\n  }\n\n  // Create the context content\n  const contextContent =\n    typeof appContext === \"string\"\n      ? appContext\n      : JSON.stringify(appContext, null, 2);\n  const contextMessageContent = `App Context:\\n${contextContent}`;\n  const contextMessagePrefix = \"App Context:\\n\";\n\n  // Helper to get message content as string\n  const getContentString = (msg: any): string | null => {\n    if (typeof msg.content === \"string\") return msg.content;\n    if (Array.isArray(msg.content) && msg.content[0]?.text)\n      return msg.content[0].text;\n    return null;\n  };\n\n  // Find the first system/developer message (not our context message) to determine\n  // where to insert our context message (right after it)\n  let firstSystemIndex = -1;\n\n  for (let i = 0; i < messages.length; i++) {\n    const msg = messages[i];\n    const type = msg._getType?.();\n    if (type === \"system\" || type === \"developer\") {\n      const content = getContentString(msg);\n      // Skip if this is our own context message\n      if (content?.startsWith(contextMessagePrefix)) {\n        continue;\n      }\n      firstSystemIndex = i;\n      break;\n    }\n  }\n\n  // Check if our context message already exists\n  let existingContextIndex = -1;\n  for (let i = 0; i < messages.length; i++) {\n    const msg = messages[i];\n    const type = msg._getType?.();\n    if (type === \"system\" || type === \"developer\") {\n      const content = getContentString(msg);\n      if (content?.startsWith(contextMessagePrefix)) {\n        existingContextIndex = i;\n        break;\n      }\n    }\n  }\n\n  // Create the context message\n  const contextMessage = new SystemMessage({ content: contextMessageContent });\n\n  let updatedMessages;\n\n  if (existingContextIndex !== -1) {\n    // Replace existing context message\n    updatedMessages = [...messages];\n    updatedMessages[existingContextIndex] = contextMessage;\n  } else {\n    // Insert after the first system message, or at position 0 if no system message\n    const insertIndex = firstSystemIndex !== -1 ? firstSystemIndex + 1 : 0;\n    updatedMessages = [\n      ...messages.slice(0, insertIndex),\n      contextMessage,\n      ...messages.slice(insertIndex),\n    ];\n  }\n\n  return {\n    ...state,\n    messages: updatedMessages,\n  };\n};\n\n/**\n * CopilotKit Middleware for LangGraph agents.\n *\n * Enables:\n * - Dynamic frontend tools from state.tools\n * - Context provided from CopilotKit useCopilotReadable\n *\n * Works with any agent (prebuilt or custom).\n *\n * @example\n * ```typescript\n * import { createAgent } from \"langchain\";\n * import { copilotkitMiddleware } from \"@copilotkit/sdk-js/langgraph\";\n *\n * const agent = createAgent({\n *   model: \"gpt-4o\",\n *   tools: [backendTool],\n *   middleware: [copilotkitMiddleware],\n * });\n * ```\n */\nconst copilotKitStateSchema = z.object({\n  copilotkit: z\n    .object({\n      actions: z.array(z.any()),\n      context: z.any().optional(),\n      interceptedToolCalls: z.array(z.any()).optional(),\n      originalAIMessageId: z.string().optional(),\n    })\n    .optional(),\n});\n\nconst middlewareInput = {\n  name: \"CopilotKitMiddleware\",\n\n  stateSchema: copilotKitStateSchema as unknown as InteropZodObject,\n\n  // Inject frontend tools before model call\n  wrapModelCall: async (request, handler) => {\n    const frontendTools = request.state[\"copilotkit\"]?.actions ?? [];\n\n    if (frontendTools.length === 0) {\n      return handler(request);\n    }\n\n    const existingTools = request.tools || [];\n    const mergedTools = [...existingTools, ...frontendTools];\n\n    return handler({\n      ...request,\n      tools: mergedTools,\n    });\n  },\n\n  beforeAgent: createAppContextBeforeAgent,\n\n  // Restore frontend tool calls to AIMessage before agent exits\n  afterAgent: (state) => {\n    const interceptedToolCalls = state[\"copilotkit\"]?.interceptedToolCalls;\n    const originalMessageId = state[\"copilotkit\"]?.originalAIMessageId;\n\n    if (!interceptedToolCalls?.length || !originalMessageId) {\n      return;\n    }\n\n    let messageFound = false;\n    const updatedMessages = state.messages.map((msg: any) => {\n      if (AIMessage.isInstance(msg) && msg.id === originalMessageId) {\n        messageFound = true;\n        const existingToolCalls = msg.tool_calls || [];\n        return new AIMessage({\n          content: msg.content,\n          tool_calls: [...existingToolCalls, ...interceptedToolCalls],\n          id: msg.id,\n        });\n      }\n      return msg;\n    });\n\n    // Only clear intercepted state if we successfully restored the tool calls\n    if (!messageFound) {\n      console.warn(\n        `CopilotKit: Could not find message with id ${originalMessageId} to restore tool calls`,\n      );\n      return;\n    }\n\n    return {\n      messages: updatedMessages,\n      copilotkit: {\n        ...state[\"copilotkit\"],\n        interceptedToolCalls: undefined,\n        originalAIMessageId: undefined,\n      },\n    };\n  },\n\n  // Intercept frontend tool calls after model returns, before ToolNode executes\n  afterModel: (state) => {\n    const frontendTools = state[\"copilotkit\"]?.actions ?? [];\n    if (frontendTools.length === 0) return;\n\n    const frontendToolNames = new Set(\n      frontendTools.map((t: any) => t.function?.name || t.name),\n    );\n\n    const lastMessage = state.messages[state.messages.length - 1];\n    if (!AIMessage.isInstance(lastMessage) || !lastMessage.tool_calls?.length) {\n      return;\n    }\n\n    const backendToolCalls: any[] = [];\n    const frontendToolCalls: any[] = [];\n\n    for (const call of lastMessage.tool_calls) {\n      if (frontendToolNames.has(call.name)) {\n        frontendToolCalls.push(call);\n      } else {\n        backendToolCalls.push(call);\n      }\n    }\n\n    if (frontendToolCalls.length === 0) return;\n\n    const updatedAIMessage = new AIMessage({\n      content: lastMessage.content,\n      tool_calls: backendToolCalls,\n      id: lastMessage.id,\n    });\n\n    return {\n      messages: [...state.messages.slice(0, -1), updatedAIMessage],\n      copilotkit: {\n        ...state[\"copilotkit\"],\n        interceptedToolCalls: frontendToolCalls,\n        originalAIMessageId: lastMessage.id,\n      },\n    };\n  },\n} as any;\nconst createCopilotKitMiddleware = () => {\n  return createMiddleware(middlewareInput);\n};\n\nexport const copilotkitMiddleware = createCopilotKitMiddleware();\n"],"mappings":"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"}
+{"version":3,"file":"middleware.mjs","names":[],"sources":["../../src/langgraph/middleware.ts"],"sourcesContent":["import { createMiddleware, AIMessage, SystemMessage } from \"langchain\";\nimport type { InteropZodObject } from \"@langchain/core/utils/types\";\nimport type {\n  StandardJSONSchemaV1,\n  StandardSchemaV1,\n} from \"@standard-schema/spec\";\nimport * as z from \"zod\";\n\ntype WithJsonSchema<T> = T extends { \"~standard\": infer S }\n  ? Omit<T, \"~standard\"> & {\n      \"~standard\": S &\n        StandardJSONSchemaV1.Props<\n          S extends StandardSchemaV1.Props<infer I, any> ? I : unknown,\n          S extends StandardSchemaV1.Props<any, infer O> ? O : unknown\n        >;\n    }\n  : T;\n\n/**\n * Augment a Standard-Schema–compatible schema (e.g. Zod) with a\n * `~standard.jsonSchema.input` hook so LangGraph's\n * `getJsonSchemaFromSchema` (called from `StateSchema.getJsonSchema`)\n * can serialize the field.\n *\n * Without this, Zod v4 fields carry `~standard.validate` + `vendor` only,\n * and `isStandardJSONSchema()` returns false, so the field is silently\n * dropped from the graph's `output_schema`. That makes AG-UI\n * `STATE_SNAPSHOT` events filter the field out of the payload sent to\n * the frontend even though the underlying thread state has the value.\n *\n * Use this on any custom state field you want visible to the frontend\n * via `useAgent().state.*`.\n *\n * @example\n * ```ts\n * import { zodState } from \"@copilotkit/sdk-js/langgraph\";\n *\n * const stateSchema = z.object({\n *   todos: zodState(z.array(TodoSchema).default(() => [])),\n * });\n * ```\n */\nexport function zodState<T extends object>(schema: T): WithJsonSchema<T> {\n  const std = (schema as { \"~standard\"?: { jsonSchema?: unknown } })[\n    \"~standard\"\n  ];\n  if (std && typeof std === \"object\" && !(\"jsonSchema\" in std)) {\n    let cached: Record<string, unknown> | undefined;\n    std.jsonSchema = {\n      input: () => {\n        if (cached) return cached;\n        // Prefer zod-v4's native `toJSONSchema` when available. Falls back to\n        // an empty object, which is sufficient for the field to appear in the\n        // graph's output_schema (langgraph-api treats it as an opaque field).\n        try {\n          const maybeV4ToJsonSchema = (\n            z as unknown as {\n              toJSONSchema?: (s: unknown) => Record<string, unknown>;\n            }\n          ).toJSONSchema;\n          cached =\n            typeof maybeV4ToJsonSchema === \"function\"\n              ? maybeV4ToJsonSchema(schema)\n              : {};\n        } catch {\n          cached = {};\n        }\n        return cached;\n      },\n    };\n  }\n  return schema as WithJsonSchema<T>;\n}\n\n/**\n * Internal/framework state keys that should never be auto-surfaced to the\n * LLM as user-facing state. These are reducer-managed message buckets,\n * CopilotKit/AG-UI plumbing, or graph-internal scaffolding.\n */\nconst RESERVED_STATE_KEYS: ReadonlySet<string> = new Set([\n  \"messages\",\n  \"copilotkit\",\n  \"ag-ui\",\n  \"tools\",\n  \"structured_response\",\n  \"thread_id\",\n  \"remaining_steps\",\n]);\n\n/**\n * Controls how user-defined state keys are surfaced into the LLM prompt\n * on every model call. Off by default to avoid leaking arbitrary state\n * into prompts; opt in explicitly.\n *\n * - `false` (default) — never surface state.\n * - `true` — every state key not in the reserved internal set and not\n *   prefixed with `_` is JSON-serialized into a \"Current agent state:\"\n *   note appended to the system prompt.\n * - `string[]` — only surface the named keys (use this when you want\n *   explicit control over what the LLM sees, e.g. `[\"liked\", \"todos\"]`).\n */\nexport type ExposeStateOption = boolean | readonly string[];\n\nconst buildStateNote = (\n  state: Record<string, unknown>,\n  expose: ExposeStateOption,\n): string | null => {\n  if (expose === false) return null;\n\n  const allow: ReadonlySet<string> | null = Array.isArray(expose)\n    ? new Set(expose)\n    : null;\n\n  const snapshot: Record<string, unknown> = {};\n  for (const key of Object.keys(state)) {\n    if (\n      allow\n        ? !allow.has(key)\n        : RESERVED_STATE_KEYS.has(key) || key.startsWith(\"_\")\n    ) {\n      continue;\n    }\n    const value = state[key];\n    if (\n      value === undefined ||\n      value === null ||\n      value === \"\" ||\n      (Array.isArray(value) && value.length === 0) ||\n      (typeof value === \"object\" &&\n        !Array.isArray(value) &&\n        Object.keys(value as Record<string, unknown>).length === 0)\n    ) {\n      continue;\n    }\n    snapshot[key] = value;\n  }\n\n  if (Object.keys(snapshot).length === 0) return null;\n\n  let body: string;\n  try {\n    body = JSON.stringify(snapshot, null, 2);\n  } catch {\n    body = String(snapshot);\n  }\n  return `Current agent state:\\n${body}`;\n};\n\nconst applyStateNote = (request: any, expose: ExposeStateOption): any => {\n  const note = buildStateNote(\n    (request.state ?? {}) as Record<string, unknown>,\n    expose,\n  );\n  if (!note) return request;\n\n  const existing = request.systemPrompt;\n  if (existing == null) {\n    return { ...request, systemPrompt: new SystemMessage({ content: note }) };\n  }\n  // existing may be a string OR a SystemMessage\n  const baseText =\n    typeof existing === \"string\"\n      ? existing\n      : typeof existing.content === \"string\"\n        ? existing.content\n        : String(existing.content);\n  return {\n    ...request,\n    systemPrompt: new SystemMessage({ content: `${baseText}\\n\\n${note}` }),\n  };\n};\n\nconst createAppContextBeforeAgent = (state, runtime) => {\n  const messages = state.messages;\n\n  if (!messages || messages.length === 0) {\n    return;\n  }\n\n  // Get app context from runtime\n  const appContext = state[\"copilotkit\"]?.context ?? runtime?.context;\n\n  // Check if appContext is missing or empty\n  const isEmptyContext =\n    !appContext ||\n    (typeof appContext === \"string\" && appContext.trim() === \"\") ||\n    (typeof appContext === \"object\" && Object.keys(appContext).length === 0);\n\n  if (isEmptyContext) {\n    return;\n  }\n\n  // Create the context content\n  const contextContent =\n    typeof appContext === \"string\"\n      ? appContext\n      : JSON.stringify(appContext, null, 2);\n  const contextMessageContent = `App Context:\\n${contextContent}`;\n  const contextMessagePrefix = \"App Context:\\n\";\n\n  // Helper to get message content as string\n  const getContentString = (msg: any): string | null => {\n    if (typeof msg.content === \"string\") return msg.content;\n    if (Array.isArray(msg.content) && msg.content[0]?.text)\n      return msg.content[0].text;\n    return null;\n  };\n\n  // Find the first system/developer message (not our context message) to determine\n  // where to insert our context message (right after it)\n  let firstSystemIndex = -1;\n\n  for (let i = 0; i < messages.length; i++) {\n    const msg = messages[i];\n    const type = msg._getType?.();\n    if (type === \"system\" || type === \"developer\") {\n      const content = getContentString(msg);\n      // Skip if this is our own context message\n      if (content?.startsWith(contextMessagePrefix)) {\n        continue;\n      }\n      firstSystemIndex = i;\n      break;\n    }\n  }\n\n  // Check if our context message already exists\n  let existingContextIndex = -1;\n  for (let i = 0; i < messages.length; i++) {\n    const msg = messages[i];\n    const type = msg._getType?.();\n    if (type === \"system\" || type === \"developer\") {\n      const content = getContentString(msg);\n      if (content?.startsWith(contextMessagePrefix)) {\n        existingContextIndex = i;\n        break;\n      }\n    }\n  }\n\n  // Create the context message\n  const contextMessage = new SystemMessage({ content: contextMessageContent });\n\n  let updatedMessages;\n\n  if (existingContextIndex !== -1) {\n    // Replace existing context message\n    updatedMessages = [...messages];\n    updatedMessages[existingContextIndex] = contextMessage;\n  } else {\n    // Insert after the first system message, or at position 0 if no system message\n    const insertIndex = firstSystemIndex !== -1 ? firstSystemIndex + 1 : 0;\n    updatedMessages = [\n      ...messages.slice(0, insertIndex),\n      contextMessage,\n      ...messages.slice(insertIndex),\n    ];\n  }\n\n  return {\n    ...state,\n    messages: updatedMessages,\n  };\n};\n\n/**\n * CopilotKit Middleware for LangGraph agents.\n *\n * Enables:\n * - Dynamic frontend tools from state.tools\n * - Context provided from CopilotKit useCopilotReadable\n *\n * Works with any agent (prebuilt or custom).\n *\n * @example\n * ```typescript\n * import { createAgent } from \"langchain\";\n * import { copilotkitMiddleware } from \"@copilotkit/sdk-js/langgraph\";\n *\n * const agent = createAgent({\n *   model: \"gpt-4o\",\n *   tools: [backendTool],\n *   middleware: [copilotkitMiddleware],\n * });\n * ```\n */\nconst copilotKitStateSchema = z.object({\n  copilotkit: zodState(\n    z\n      .object({\n        actions: z.array(z.any()),\n        context: z.any().optional(),\n        interceptedToolCalls: z.array(z.any()).optional(),\n        originalAIMessageId: z.string().optional(),\n      })\n      .optional(),\n  ),\n});\n\nconst buildMiddlewareInput = (exposeState: ExposeStateOption) => ({\n  name: \"CopilotKitMiddleware\",\n\n  stateSchema: copilotKitStateSchema as unknown as InteropZodObject,\n\n  // Inject frontend tools and surface user state before model call\n  wrapModelCall: async (request: any, handler: (req: any) => Promise<any>) => {\n    request = applyStateNote(request, exposeState);\n    const frontendTools = request.state[\"copilotkit\"]?.actions ?? [];\n\n    if (frontendTools.length === 0) {\n      return handler(request);\n    }\n\n    const existingTools = request.tools || [];\n    const mergedTools = [...existingTools, ...frontendTools];\n\n    return handler({\n      ...request,\n      tools: mergedTools,\n    });\n  },\n\n  beforeAgent: createAppContextBeforeAgent,\n\n  // Restore frontend tool calls to AIMessage before agent exits\n  afterAgent: (state) => {\n    const interceptedToolCalls = state[\"copilotkit\"]?.interceptedToolCalls;\n    const originalMessageId = state[\"copilotkit\"]?.originalAIMessageId;\n\n    if (!interceptedToolCalls?.length || !originalMessageId) {\n      return;\n    }\n\n    let messageFound = false;\n    const updatedMessages = state.messages.map((msg: any) => {\n      if (AIMessage.isInstance(msg) && msg.id === originalMessageId) {\n        messageFound = true;\n        const existingToolCalls = msg.tool_calls || [];\n        return new AIMessage({\n          content: msg.content,\n          tool_calls: [...existingToolCalls, ...interceptedToolCalls],\n          id: msg.id,\n        });\n      }\n      return msg;\n    });\n\n    // Only clear intercepted state if we successfully restored the tool calls\n    if (!messageFound) {\n      console.warn(\n        `CopilotKit: Could not find message with id ${originalMessageId} to restore tool calls`,\n      );\n      return;\n    }\n\n    return {\n      messages: updatedMessages,\n      copilotkit: {\n        ...state[\"copilotkit\"],\n        interceptedToolCalls: undefined,\n        originalAIMessageId: undefined,\n      },\n    };\n  },\n\n  // Intercept frontend tool calls after model returns, before ToolNode executes\n  afterModel: (state) => {\n    const frontendTools = state[\"copilotkit\"]?.actions ?? [];\n    if (frontendTools.length === 0) return;\n\n    const frontendToolNames = new Set(\n      frontendTools.map((t: any) => t.function?.name || t.name),\n    );\n\n    const lastMessage = state.messages[state.messages.length - 1];\n    if (!AIMessage.isInstance(lastMessage) || !lastMessage.tool_calls?.length) {\n      return;\n    }\n\n    const backendToolCalls: any[] = [];\n    const frontendToolCalls: any[] = [];\n\n    for (const call of lastMessage.tool_calls) {\n      if (frontendToolNames.has(call.name)) {\n        frontendToolCalls.push(call);\n      } else {\n        backendToolCalls.push(call);\n      }\n    }\n\n    if (frontendToolCalls.length === 0) return;\n\n    const updatedAIMessage = new AIMessage({\n      content: lastMessage.content,\n      tool_calls: backendToolCalls,\n      id: lastMessage.id,\n    });\n\n    return {\n      messages: [...state.messages.slice(0, -1), updatedAIMessage],\n      copilotkit: {\n        ...state[\"copilotkit\"],\n        interceptedToolCalls: frontendToolCalls,\n        originalAIMessageId: lastMessage.id,\n      },\n    };\n  },\n});\n\n/**\n * Build a CopilotKit middleware instance with custom options.\n *\n * Use this when you want to override the default state-exposure behavior\n * (for example to hide a sensitive key, or to use an explicit allowlist).\n *\n * @example\n * ```typescript\n * import { createCopilotkitMiddleware } from \"@copilotkit/sdk-js/langgraph\";\n *\n * const middleware = createCopilotkitMiddleware({\n *   exposeState: [\"liked\", \"todos\"],\n * });\n * ```\n */\nexport const createCopilotkitMiddleware = (\n  options: { exposeState?: ExposeStateOption } = {},\n) => {\n  const exposeState = options.exposeState ?? false;\n  return createMiddleware(buildMiddlewareInput(exposeState) as any);\n};\n\n/**\n * Default CopilotKit middleware singleton — does NOT surface user state\n * to the LLM. Pass `exposeState: true` (or an allowlist) to\n * {@link createCopilotkitMiddleware} to opt in.\n */\nexport const copilotkitMiddleware = createCopilotkitMiddleware();\n"],"mappings":"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"}