@copilotkit/sdk-js 2.0.0-rc.2 → 2.0.0-rc.20

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,87 @@
1
+ const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
2
+ let zod = require("zod");
3
+
4
+ //#region src/langgraph/json-schema-to-zod.ts
5
+ /**
6
+ * Convert a JSON Schema to a Zod schema. Resolves `$ref` against `$defs` /
7
+ * `definitions`, maps `anyOf` / `oneOf` to unions, and falls back to
8
+ * `z.any()` for circular refs and unsupported types.
9
+ *
10
+ * Moved here from `@copilotkit/shared` in 2.0 so that shared does not depend
11
+ * on zod.
12
+ */
13
+ function convertJsonSchemaToZodSchema(jsonSchema, required, definitions, visitedRefs) {
14
+ if (jsonSchema.$ref && definitions) {
15
+ const refPath = jsonSchema.$ref.replace(/^#\/\$defs\/|^#\/definitions\//, "");
16
+ const refs = visitedRefs ?? /* @__PURE__ */ new Set();
17
+ if (refs.has(refPath)) {
18
+ console.warn(`[CopilotKit] Circular $ref detected for "${refPath}" — falling back to z.any()`);
19
+ let schema = zod.z.any();
20
+ if (jsonSchema.description) schema = schema.describe(jsonSchema.description);
21
+ return required ? schema : schema.optional();
22
+ }
23
+ const resolved = definitions[refPath];
24
+ if (resolved) {
25
+ const nextRefs = new Set(refs);
26
+ nextRefs.add(refPath);
27
+ return convertJsonSchemaToZodSchema(resolved, required, definitions, nextRefs);
28
+ }
29
+ }
30
+ const defs = definitions ?? jsonSchema.$defs ?? jsonSchema.definitions;
31
+ if (Array.isArray(jsonSchema.type)) {
32
+ const types = jsonSchema.type;
33
+ const hasNull = types.includes("null");
34
+ const nonNullTypes = types.filter((t) => t !== "null");
35
+ const resolvedType = nonNullTypes.length > 0 ? nonNullTypes[0] : "string";
36
+ const innerSchema = convertJsonSchemaToZodSchema({
37
+ ...jsonSchema,
38
+ type: resolvedType
39
+ }, true, defs, visitedRefs);
40
+ let schema = hasNull ? zod.z.union([innerSchema, zod.z.null()]) : innerSchema;
41
+ if (jsonSchema.description) schema = schema.describe(jsonSchema.description);
42
+ return required ? schema : schema.optional();
43
+ }
44
+ const unionVariants = jsonSchema.anyOf ?? jsonSchema.oneOf;
45
+ if (Array.isArray(unionVariants) && unionVariants.length > 0) {
46
+ if (unionVariants.length === 1) return convertJsonSchemaToZodSchema(unionVariants[0], required, defs, visitedRefs);
47
+ const schemas = unionVariants.map((v) => convertJsonSchemaToZodSchema(v, true, defs, visitedRefs));
48
+ let schema = zod.z.union(schemas);
49
+ if (jsonSchema.description) schema = schema.describe(jsonSchema.description);
50
+ return required ? schema : schema.optional();
51
+ }
52
+ if (jsonSchema.type === "object") {
53
+ const spec = {};
54
+ if (!jsonSchema.properties || !Object.keys(jsonSchema.properties).length) return !required ? zod.z.object(spec).optional() : zod.z.object(spec);
55
+ for (const [key, value] of Object.entries(jsonSchema.properties)) spec[key] = convertJsonSchemaToZodSchema(value, jsonSchema.required ? jsonSchema.required.includes(key) : false, defs, visitedRefs);
56
+ let schema = zod.z.object(spec).describe(jsonSchema.description);
57
+ return required ? schema : schema.optional();
58
+ } else if (jsonSchema.type === "string") {
59
+ if (jsonSchema.enum && jsonSchema.enum.length > 0) {
60
+ let schema = zod.z.enum(jsonSchema.enum).describe(jsonSchema.description);
61
+ return required ? schema : schema.optional();
62
+ }
63
+ let schema = zod.z.string().describe(jsonSchema.description);
64
+ return required ? schema : schema.optional();
65
+ } else if (jsonSchema.type === "number" || jsonSchema.type === "integer") {
66
+ let schema = zod.z.number().describe(jsonSchema.description);
67
+ return required ? schema : schema.optional();
68
+ } else if (jsonSchema.type === "boolean") {
69
+ let schema = zod.z.boolean().describe(jsonSchema.description);
70
+ return required ? schema : schema.optional();
71
+ } else if (jsonSchema.type === "array") {
72
+ let itemSchema = convertJsonSchemaToZodSchema(jsonSchema.items, true, defs, visitedRefs);
73
+ let schema = zod.z.array(itemSchema).describe(jsonSchema.description);
74
+ return required ? schema : schema.optional();
75
+ } else if (jsonSchema.type === "null") {
76
+ let schema = zod.z.null().describe(jsonSchema.description);
77
+ return required ? schema : schema.optional();
78
+ }
79
+ console.warn(`[CopilotKit] Unsupported JSON schema type "${jsonSchema.type ?? "unknown"}" — falling back to z.any()`);
80
+ let schema = zod.z.any();
81
+ if (jsonSchema.description) schema = schema.describe(jsonSchema.description);
82
+ return required ? schema : schema.optional();
83
+ }
84
+
85
+ //#endregion
86
+ exports.convertJsonSchemaToZodSchema = convertJsonSchemaToZodSchema;
87
+ //# sourceMappingURL=json-schema-to-zod.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"json-schema-to-zod.cjs","names":["z"],"sources":["../../src/langgraph/json-schema-to-zod.ts"],"sourcesContent":["import { z } from \"zod\";\n\n/**\n * Convert a JSON Schema to a Zod schema. Resolves `$ref` against `$defs` /\n * `definitions`, maps `anyOf` / `oneOf` to unions, and falls back to\n * `z.any()` for circular refs and unsupported types.\n *\n * Moved here from `@copilotkit/shared` in 2.0 so that shared does not depend\n * on zod.\n */\nexport function convertJsonSchemaToZodSchema(\n jsonSchema: any,\n required: boolean,\n definitions?: Record<string, any>,\n visitedRefs?: Set<string>,\n): z.ZodSchema {\n // Resolve $ref references\n if (jsonSchema.$ref && definitions) {\n const refPath = jsonSchema.$ref.replace(\n /^#\\/\\$defs\\/|^#\\/definitions\\//,\n \"\",\n );\n\n // Detect circular $ref cycles\n const refs = visitedRefs ?? new Set<string>();\n if (refs.has(refPath)) {\n console.warn(\n `[CopilotKit] Circular $ref detected for \"${refPath}\" — falling back to z.any()`,\n );\n let schema = z.any();\n if (jsonSchema.description) {\n schema = schema.describe(jsonSchema.description);\n }\n return required ? schema : schema.optional();\n }\n\n const resolved = definitions[refPath];\n if (resolved) {\n // Clone the set so sibling branches don't see each other's visited refs\n const nextRefs = new Set(refs);\n nextRefs.add(refPath);\n return convertJsonSchemaToZodSchema(\n resolved,\n required,\n definitions,\n nextRefs,\n );\n }\n }\n\n // Collect top-level definitions for $ref resolution\n const defs = definitions ?? jsonSchema.$defs ?? jsonSchema.definitions;\n\n // Handle null-union types like [\"string\", \"null\"]\n if (Array.isArray(jsonSchema.type)) {\n const types = jsonSchema.type as string[];\n const hasNull = types.includes(\"null\");\n const nonNullTypes = types.filter((t: string) => t !== \"null\");\n const resolvedType = nonNullTypes.length > 0 ? nonNullTypes[0] : \"string\";\n const innerSchema = convertJsonSchemaToZodSchema(\n { ...jsonSchema, type: resolvedType },\n true,\n defs,\n visitedRefs,\n );\n let schema = hasNull ? z.union([innerSchema, z.null()]) : innerSchema;\n if (jsonSchema.description) {\n schema = schema.describe(jsonSchema.description);\n }\n return required ? schema : schema.optional();\n }\n\n // Handle anyOf / oneOf as z.union\n const unionVariants = jsonSchema.anyOf ?? jsonSchema.oneOf;\n if (Array.isArray(unionVariants) && unionVariants.length > 0) {\n if (unionVariants.length === 1) {\n return convertJsonSchemaToZodSchema(\n unionVariants[0],\n required,\n defs,\n visitedRefs,\n );\n }\n const schemas = unionVariants.map((v: any) =>\n convertJsonSchemaToZodSchema(v, true, defs, visitedRefs),\n );\n let schema = z.union(\n schemas as [z.ZodSchema, z.ZodSchema, ...z.ZodSchema[]],\n );\n if (jsonSchema.description) {\n schema = schema.describe(jsonSchema.description);\n }\n return required ? schema : schema.optional();\n }\n\n if (jsonSchema.type === \"object\") {\n const spec: { [key: string]: z.ZodSchema } = {};\n\n if (!jsonSchema.properties || !Object.keys(jsonSchema.properties).length) {\n return !required ? z.object(spec).optional() : z.object(spec);\n }\n\n for (const [key, value] of Object.entries(jsonSchema.properties)) {\n spec[key] = convertJsonSchemaToZodSchema(\n value,\n jsonSchema.required ? jsonSchema.required.includes(key) : false,\n defs,\n visitedRefs,\n );\n }\n let schema = z.object(spec).describe(jsonSchema.description);\n return required ? schema : schema.optional();\n } else if (jsonSchema.type === \"string\") {\n if (jsonSchema.enum && jsonSchema.enum.length > 0) {\n let schema = z\n .enum(jsonSchema.enum as [string, ...string[]])\n .describe(jsonSchema.description);\n return required ? schema : schema.optional();\n }\n let schema = z.string().describe(jsonSchema.description);\n return required ? schema : schema.optional();\n } else if (jsonSchema.type === \"number\" || jsonSchema.type === \"integer\") {\n let schema = z.number().describe(jsonSchema.description);\n return required ? schema : schema.optional();\n } else if (jsonSchema.type === \"boolean\") {\n let schema = z.boolean().describe(jsonSchema.description);\n return required ? schema : schema.optional();\n } else if (jsonSchema.type === \"array\") {\n let itemSchema = convertJsonSchemaToZodSchema(\n jsonSchema.items,\n true,\n defs,\n visitedRefs,\n );\n let schema = z.array(itemSchema).describe(jsonSchema.description);\n return required ? schema : schema.optional();\n } else if (jsonSchema.type === \"null\") {\n let schema = z.null().describe(jsonSchema.description);\n return required ? schema : schema.optional();\n }\n\n // Fallback: accept any value rather than throwing\n console.warn(\n `[CopilotKit] Unsupported JSON schema type \"${jsonSchema.type ?? \"unknown\"}\" — falling back to z.any()`,\n );\n let schema = z.any();\n if (jsonSchema.description) {\n schema = schema.describe(jsonSchema.description);\n }\n return required ? schema : schema.optional();\n}\n"],"mappings":"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"}
@@ -0,0 +1,86 @@
1
+ import { z } from "zod";
2
+
3
+ //#region src/langgraph/json-schema-to-zod.ts
4
+ /**
5
+ * Convert a JSON Schema to a Zod schema. Resolves `$ref` against `$defs` /
6
+ * `definitions`, maps `anyOf` / `oneOf` to unions, and falls back to
7
+ * `z.any()` for circular refs and unsupported types.
8
+ *
9
+ * Moved here from `@copilotkit/shared` in 2.0 so that shared does not depend
10
+ * on zod.
11
+ */
12
+ function convertJsonSchemaToZodSchema(jsonSchema, required, definitions, visitedRefs) {
13
+ if (jsonSchema.$ref && definitions) {
14
+ const refPath = jsonSchema.$ref.replace(/^#\/\$defs\/|^#\/definitions\//, "");
15
+ const refs = visitedRefs ?? /* @__PURE__ */ new Set();
16
+ if (refs.has(refPath)) {
17
+ console.warn(`[CopilotKit] Circular $ref detected for "${refPath}" — falling back to z.any()`);
18
+ let schema = z.any();
19
+ if (jsonSchema.description) schema = schema.describe(jsonSchema.description);
20
+ return required ? schema : schema.optional();
21
+ }
22
+ const resolved = definitions[refPath];
23
+ if (resolved) {
24
+ const nextRefs = new Set(refs);
25
+ nextRefs.add(refPath);
26
+ return convertJsonSchemaToZodSchema(resolved, required, definitions, nextRefs);
27
+ }
28
+ }
29
+ const defs = definitions ?? jsonSchema.$defs ?? jsonSchema.definitions;
30
+ if (Array.isArray(jsonSchema.type)) {
31
+ const types = jsonSchema.type;
32
+ const hasNull = types.includes("null");
33
+ const nonNullTypes = types.filter((t) => t !== "null");
34
+ const resolvedType = nonNullTypes.length > 0 ? nonNullTypes[0] : "string";
35
+ const innerSchema = convertJsonSchemaToZodSchema({
36
+ ...jsonSchema,
37
+ type: resolvedType
38
+ }, true, defs, visitedRefs);
39
+ let schema = hasNull ? z.union([innerSchema, z.null()]) : innerSchema;
40
+ if (jsonSchema.description) schema = schema.describe(jsonSchema.description);
41
+ return required ? schema : schema.optional();
42
+ }
43
+ const unionVariants = jsonSchema.anyOf ?? jsonSchema.oneOf;
44
+ if (Array.isArray(unionVariants) && unionVariants.length > 0) {
45
+ if (unionVariants.length === 1) return convertJsonSchemaToZodSchema(unionVariants[0], required, defs, visitedRefs);
46
+ const schemas = unionVariants.map((v) => convertJsonSchemaToZodSchema(v, true, defs, visitedRefs));
47
+ let schema = z.union(schemas);
48
+ if (jsonSchema.description) schema = schema.describe(jsonSchema.description);
49
+ return required ? schema : schema.optional();
50
+ }
51
+ if (jsonSchema.type === "object") {
52
+ const spec = {};
53
+ if (!jsonSchema.properties || !Object.keys(jsonSchema.properties).length) return !required ? z.object(spec).optional() : z.object(spec);
54
+ for (const [key, value] of Object.entries(jsonSchema.properties)) spec[key] = convertJsonSchemaToZodSchema(value, jsonSchema.required ? jsonSchema.required.includes(key) : false, defs, visitedRefs);
55
+ let schema = z.object(spec).describe(jsonSchema.description);
56
+ return required ? schema : schema.optional();
57
+ } else if (jsonSchema.type === "string") {
58
+ if (jsonSchema.enum && jsonSchema.enum.length > 0) {
59
+ let schema = z.enum(jsonSchema.enum).describe(jsonSchema.description);
60
+ return required ? schema : schema.optional();
61
+ }
62
+ let schema = z.string().describe(jsonSchema.description);
63
+ return required ? schema : schema.optional();
64
+ } else if (jsonSchema.type === "number" || jsonSchema.type === "integer") {
65
+ let schema = z.number().describe(jsonSchema.description);
66
+ return required ? schema : schema.optional();
67
+ } else if (jsonSchema.type === "boolean") {
68
+ let schema = z.boolean().describe(jsonSchema.description);
69
+ return required ? schema : schema.optional();
70
+ } else if (jsonSchema.type === "array") {
71
+ let itemSchema = convertJsonSchemaToZodSchema(jsonSchema.items, true, defs, visitedRefs);
72
+ let schema = z.array(itemSchema).describe(jsonSchema.description);
73
+ return required ? schema : schema.optional();
74
+ } else if (jsonSchema.type === "null") {
75
+ let schema = z.null().describe(jsonSchema.description);
76
+ return required ? schema : schema.optional();
77
+ }
78
+ console.warn(`[CopilotKit] Unsupported JSON schema type "${jsonSchema.type ?? "unknown"}" — falling back to z.any()`);
79
+ let schema = z.any();
80
+ if (jsonSchema.description) schema = schema.describe(jsonSchema.description);
81
+ return required ? schema : schema.optional();
82
+ }
83
+
84
+ //#endregion
85
+ export { convertJsonSchemaToZodSchema };
86
+ //# sourceMappingURL=json-schema-to-zod.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"json-schema-to-zod.mjs","names":[],"sources":["../../src/langgraph/json-schema-to-zod.ts"],"sourcesContent":["import { z } from \"zod\";\n\n/**\n * Convert a JSON Schema to a Zod schema. Resolves `$ref` against `$defs` /\n * `definitions`, maps `anyOf` / `oneOf` to unions, and falls back to\n * `z.any()` for circular refs and unsupported types.\n *\n * Moved here from `@copilotkit/shared` in 2.0 so that shared does not depend\n * on zod.\n */\nexport function convertJsonSchemaToZodSchema(\n jsonSchema: any,\n required: boolean,\n definitions?: Record<string, any>,\n visitedRefs?: Set<string>,\n): z.ZodSchema {\n // Resolve $ref references\n if (jsonSchema.$ref && definitions) {\n const refPath = jsonSchema.$ref.replace(\n /^#\\/\\$defs\\/|^#\\/definitions\\//,\n \"\",\n );\n\n // Detect circular $ref cycles\n const refs = visitedRefs ?? new Set<string>();\n if (refs.has(refPath)) {\n console.warn(\n `[CopilotKit] Circular $ref detected for \"${refPath}\" — falling back to z.any()`,\n );\n let schema = z.any();\n if (jsonSchema.description) {\n schema = schema.describe(jsonSchema.description);\n }\n return required ? schema : schema.optional();\n }\n\n const resolved = definitions[refPath];\n if (resolved) {\n // Clone the set so sibling branches don't see each other's visited refs\n const nextRefs = new Set(refs);\n nextRefs.add(refPath);\n return convertJsonSchemaToZodSchema(\n resolved,\n required,\n definitions,\n nextRefs,\n );\n }\n }\n\n // Collect top-level definitions for $ref resolution\n const defs = definitions ?? jsonSchema.$defs ?? jsonSchema.definitions;\n\n // Handle null-union types like [\"string\", \"null\"]\n if (Array.isArray(jsonSchema.type)) {\n const types = jsonSchema.type as string[];\n const hasNull = types.includes(\"null\");\n const nonNullTypes = types.filter((t: string) => t !== \"null\");\n const resolvedType = nonNullTypes.length > 0 ? nonNullTypes[0] : \"string\";\n const innerSchema = convertJsonSchemaToZodSchema(\n { ...jsonSchema, type: resolvedType },\n true,\n defs,\n visitedRefs,\n );\n let schema = hasNull ? z.union([innerSchema, z.null()]) : innerSchema;\n if (jsonSchema.description) {\n schema = schema.describe(jsonSchema.description);\n }\n return required ? schema : schema.optional();\n }\n\n // Handle anyOf / oneOf as z.union\n const unionVariants = jsonSchema.anyOf ?? jsonSchema.oneOf;\n if (Array.isArray(unionVariants) && unionVariants.length > 0) {\n if (unionVariants.length === 1) {\n return convertJsonSchemaToZodSchema(\n unionVariants[0],\n required,\n defs,\n visitedRefs,\n );\n }\n const schemas = unionVariants.map((v: any) =>\n convertJsonSchemaToZodSchema(v, true, defs, visitedRefs),\n );\n let schema = z.union(\n schemas as [z.ZodSchema, z.ZodSchema, ...z.ZodSchema[]],\n );\n if (jsonSchema.description) {\n schema = schema.describe(jsonSchema.description);\n }\n return required ? schema : schema.optional();\n }\n\n if (jsonSchema.type === \"object\") {\n const spec: { [key: string]: z.ZodSchema } = {};\n\n if (!jsonSchema.properties || !Object.keys(jsonSchema.properties).length) {\n return !required ? z.object(spec).optional() : z.object(spec);\n }\n\n for (const [key, value] of Object.entries(jsonSchema.properties)) {\n spec[key] = convertJsonSchemaToZodSchema(\n value,\n jsonSchema.required ? jsonSchema.required.includes(key) : false,\n defs,\n visitedRefs,\n );\n }\n let schema = z.object(spec).describe(jsonSchema.description);\n return required ? schema : schema.optional();\n } else if (jsonSchema.type === \"string\") {\n if (jsonSchema.enum && jsonSchema.enum.length > 0) {\n let schema = z\n .enum(jsonSchema.enum as [string, ...string[]])\n .describe(jsonSchema.description);\n return required ? schema : schema.optional();\n }\n let schema = z.string().describe(jsonSchema.description);\n return required ? schema : schema.optional();\n } else if (jsonSchema.type === \"number\" || jsonSchema.type === \"integer\") {\n let schema = z.number().describe(jsonSchema.description);\n return required ? schema : schema.optional();\n } else if (jsonSchema.type === \"boolean\") {\n let schema = z.boolean().describe(jsonSchema.description);\n return required ? schema : schema.optional();\n } else if (jsonSchema.type === \"array\") {\n let itemSchema = convertJsonSchemaToZodSchema(\n jsonSchema.items,\n true,\n defs,\n visitedRefs,\n );\n let schema = z.array(itemSchema).describe(jsonSchema.description);\n return required ? schema : schema.optional();\n } else if (jsonSchema.type === \"null\") {\n let schema = z.null().describe(jsonSchema.description);\n return required ? schema : schema.optional();\n }\n\n // Fallback: accept any value rather than throwing\n console.warn(\n `[CopilotKit] Unsupported JSON schema type \"${jsonSchema.type ?? \"unknown\"}\" — falling back to z.any()`,\n );\n let schema = z.any();\n if (jsonSchema.description) {\n schema = schema.describe(jsonSchema.description);\n }\n return required ? schema : schema.optional();\n}\n"],"mappings":";;;;;;;;;;;AAUA,SAAgB,6BACd,YACA,UACA,aACA,aACa;AAEb,KAAI,WAAW,QAAQ,aAAa;EAClC,MAAM,UAAU,WAAW,KAAK,QAC9B,kCACA,GACD;EAGD,MAAM,OAAO,+BAAe,IAAI,KAAa;AAC7C,MAAI,KAAK,IAAI,QAAQ,EAAE;AACrB,WAAQ,KACN,4CAA4C,QAAQ,6BACrD;GACD,IAAI,SAAS,EAAE,KAAK;AACpB,OAAI,WAAW,YACb,UAAS,OAAO,SAAS,WAAW,YAAY;AAElD,UAAO,WAAW,SAAS,OAAO,UAAU;;EAG9C,MAAM,WAAW,YAAY;AAC7B,MAAI,UAAU;GAEZ,MAAM,WAAW,IAAI,IAAI,KAAK;AAC9B,YAAS,IAAI,QAAQ;AACrB,UAAO,6BACL,UACA,UACA,aACA,SACD;;;CAKL,MAAM,OAAO,eAAe,WAAW,SAAS,WAAW;AAG3D,KAAI,MAAM,QAAQ,WAAW,KAAK,EAAE;EAClC,MAAM,QAAQ,WAAW;EACzB,MAAM,UAAU,MAAM,SAAS,OAAO;EACtC,MAAM,eAAe,MAAM,QAAQ,MAAc,MAAM,OAAO;EAC9D,MAAM,eAAe,aAAa,SAAS,IAAI,aAAa,KAAK;EACjE,MAAM,cAAc,6BAClB;GAAE,GAAG;GAAY,MAAM;GAAc,EACrC,MACA,MACA,YACD;EACD,IAAI,SAAS,UAAU,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,GAAG;AAC1D,MAAI,WAAW,YACb,UAAS,OAAO,SAAS,WAAW,YAAY;AAElD,SAAO,WAAW,SAAS,OAAO,UAAU;;CAI9C,MAAM,gBAAgB,WAAW,SAAS,WAAW;AACrD,KAAI,MAAM,QAAQ,cAAc,IAAI,cAAc,SAAS,GAAG;AAC5D,MAAI,cAAc,WAAW,EAC3B,QAAO,6BACL,cAAc,IACd,UACA,MACA,YACD;EAEH,MAAM,UAAU,cAAc,KAAK,MACjC,6BAA6B,GAAG,MAAM,MAAM,YAAY,CACzD;EACD,IAAI,SAAS,EAAE,MACb,QACD;AACD,MAAI,WAAW,YACb,UAAS,OAAO,SAAS,WAAW,YAAY;AAElD,SAAO,WAAW,SAAS,OAAO,UAAU;;AAG9C,KAAI,WAAW,SAAS,UAAU;EAChC,MAAM,OAAuC,EAAE;AAE/C,MAAI,CAAC,WAAW,cAAc,CAAC,OAAO,KAAK,WAAW,WAAW,CAAC,OAChE,QAAO,CAAC,WAAW,EAAE,OAAO,KAAK,CAAC,UAAU,GAAG,EAAE,OAAO,KAAK;AAG/D,OAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,WAAW,WAAW,CAC9D,MAAK,OAAO,6BACV,OACA,WAAW,WAAW,WAAW,SAAS,SAAS,IAAI,GAAG,OAC1D,MACA,YACD;EAEH,IAAI,SAAS,EAAE,OAAO,KAAK,CAAC,SAAS,WAAW,YAAY;AAC5D,SAAO,WAAW,SAAS,OAAO,UAAU;YACnC,WAAW,SAAS,UAAU;AACvC,MAAI,WAAW,QAAQ,WAAW,KAAK,SAAS,GAAG;GACjD,IAAI,SAAS,EACV,KAAK,WAAW,KAA8B,CAC9C,SAAS,WAAW,YAAY;AACnC,UAAO,WAAW,SAAS,OAAO,UAAU;;EAE9C,IAAI,SAAS,EAAE,QAAQ,CAAC,SAAS,WAAW,YAAY;AACxD,SAAO,WAAW,SAAS,OAAO,UAAU;YACnC,WAAW,SAAS,YAAY,WAAW,SAAS,WAAW;EACxE,IAAI,SAAS,EAAE,QAAQ,CAAC,SAAS,WAAW,YAAY;AACxD,SAAO,WAAW,SAAS,OAAO,UAAU;YACnC,WAAW,SAAS,WAAW;EACxC,IAAI,SAAS,EAAE,SAAS,CAAC,SAAS,WAAW,YAAY;AACzD,SAAO,WAAW,SAAS,OAAO,UAAU;YACnC,WAAW,SAAS,SAAS;EACtC,IAAI,aAAa,6BACf,WAAW,OACX,MACA,MACA,YACD;EACD,IAAI,SAAS,EAAE,MAAM,WAAW,CAAC,SAAS,WAAW,YAAY;AACjE,SAAO,WAAW,SAAS,OAAO,UAAU;YACnC,WAAW,SAAS,QAAQ;EACrC,IAAI,SAAS,EAAE,MAAM,CAAC,SAAS,WAAW,YAAY;AACtD,SAAO,WAAW,SAAS,OAAO,UAAU;;AAI9C,SAAQ,KACN,8CAA8C,WAAW,QAAQ,UAAU,6BAC5E;CACD,IAAI,SAAS,EAAE,KAAK;AACpB,KAAI,WAAW,YACb,UAAS,OAAO,SAAS,WAAW,YAAY;AAElD,QAAO,WAAW,SAAS,OAAO,UAAU"}
@@ -1,8 +1,8 @@
1
1
  const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
2
2
  const require_header_propagation = require('../header-propagation.cjs');
3
- let langchain = require("langchain");
4
3
  let zod = require("zod");
5
4
  zod = require_runtime.__toESM(zod);
5
+ let langchain = require("langchain");
6
6
  let _ag_ui_langgraph = require("@ag-ui/langgraph");
7
7
 
8
8
  //#region src/langgraph/middleware.ts
@@ -79,11 +79,13 @@ const a2uiInjectDecision = (state) => effectiveProperties(state).inject_a2ui_too
79
79
  * `getJsonSchemaFromSchema` (called from `StateSchema.getJsonSchema`)
80
80
  * can serialize the field.
81
81
  *
82
- * Without this, Zod v4 fields carry `~standard.validate` + `vendor` only,
83
- * and `isStandardJSONSchema()` returns false, so the field is silently
84
- * dropped from the graph's `output_schema`. That makes AG-UI
85
- * `STATE_SNAPSHOT` events filter the field out of the payload sent to
86
- * the frontend even though the underlying thread state has the value.
82
+ * Zod 4.2+ schemas already implement `~standard.jsonSchema` and are
83
+ * returned unchanged. A Standard Schema without that hook carries
84
+ * `~standard.validate` + `vendor` only, so `isStandardJSONSchema()` returns
85
+ * false and the field is silently dropped from the graph's `output_schema`.
86
+ * That makes AG-UI `STATE_SNAPSHOT` events filter the field out of the
87
+ * payload sent to the frontend even though the underlying thread state has
88
+ * the value.
87
89
  *
88
90
  * Use this on any custom state field you want visible to the frontend
89
91
  * via `useAgent().state.*`.
@@ -235,8 +237,8 @@ const copilotKitStateSchema = zod.object({
235
237
  context: zod.any().optional(),
236
238
  interceptedToolCalls: zod.array(zod.any()).optional(),
237
239
  originalAIMessageId: zod.string().optional()
238
- }).passthrough().optional())
239
- }).passthrough();
240
+ }).loose().optional())
241
+ }).loose();
240
242
  const isToolCallContentBlock = (block) => typeof block === "object" && block !== null && "type" in block && (block.type === "tool_call" || block.type === "tool_call_chunk");
241
243
  const usesV1ContentBlocks = (responseMetadata) => typeof responseMetadata === "object" && responseMetadata !== null && "output_version" in responseMetadata && responseMetadata.output_version === "v1";
242
244
  /**
@@ -1 +1 @@
1
- {"version":3,"file":"middleware.cjs","names":["z","AIMessage","getForwardedHeaders","getA2UITools"],"sources":["../../src/langgraph/middleware.ts"],"sourcesContent":["import { createMiddleware, AIMessage } 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\";\nimport { getA2UITools } from \"@ag-ui/langgraph\";\nimport type { A2UIToolParams } from \"@ag-ui/langgraph\";\nimport { getForwardedHeaders } from \"../header-propagation\";\n\n// ---------------------------------------------------------------------------\n// Auto-A2UI: bridge the inferred model's generate_a2ui tool from wrapModelCall\n// (the only hook that exposes the bound model) to wrapToolCall (where the tool\n// actually executes but the model is absent). Keyed by the run's thread id so\n// concurrent runs don't clobber each other.\n// ---------------------------------------------------------------------------\nconst a2uiToolsByThread = new Map<string, any>();\nconst A2UI_DEFAULT_THREAD_KEY = \"__copilotkit_a2ui_default__\";\nconst a2uiThreadKey = (state: any): string =>\n (state?.thread_id as string) || A2UI_DEFAULT_THREAD_KEY;\n\n/**\n * Merge AG-UI defaults with CopilotKit overrides. Dictionaries recurse; every\n * conflicting leaf uses CopilotKit, including false, null and empty values.\n * Arrays and serialized strings are atomic: no positional pairing or decoding.\n */\nconst isPropertyBag = (value: unknown): value is Record<string, unknown> =>\n value !== null && typeof value === \"object\" && !Array.isArray(value);\n\nconst mergeProperties = (\n base: Record<string, unknown>,\n overrides: Record<string, unknown>,\n): Record<string, unknown> =>\n Object.fromEntries(\n Array.from(new Set([...Object.keys(base), ...Object.keys(overrides)])).map(\n (key) => {\n const value = Object.prototype.hasOwnProperty.call(overrides, key)\n ? isPropertyBag(base[key]) && isPropertyBag(overrides[key])\n ? mergeProperties(base[key], overrides[key])\n : overrides[key]\n : base[key];\n return [key, value];\n },\n ),\n );\n\nconst effectiveProperties = (state: unknown): Record<string, unknown> => {\n const source = isPropertyBag(state) ? state : {};\n return mergeProperties(\n isPropertyBag(source[\"ag-ui\"]) ? source[\"ag-ui\"] : {},\n isPropertyBag(source.copilotkit) ? source.copilotkit : {},\n );\n};\n\nconst decodeCatalogValue = (value: unknown): unknown => {\n if (typeof value !== \"string\") return value;\n try {\n return JSON.parse(value);\n } catch {\n return value;\n }\n};\n\n/**\n * Find the frontend-registered A2UI catalog wherever it was passed. Returns\n * `{ compositionGuide?, catalogId? }` when a catalog is present, else `null`\n * independently of the explicit tool-injection decision. Two\n * delivery paths, depending on how the agent is served:\n * - AG-UI native endpoint → `state[\"ag-ui\"].a2ui_schema` (JSON\n * `{ catalogId, components }`); the toolkit reads it from state itself.\n * - Runtime proxy → an effective `context` entry describing\n * the A2UI catalog (catalog id + component schemas as text), passed to the\n * subagent via `compositionGuide`.\n * `catalogId` binds generated surfaces to the frontend's catalog so BYOC\n * custom catalogs render their own components (not the basic one).\n */\nconst resolveA2uiCatalog = (\n state: any,\n): { compositionGuide?: string; catalogId?: string } | null => {\n const properties = effectiveProperties(state);\n const a2uiSchema = properties.a2ui_schema;\n if (a2uiSchema) {\n let catalogId: string | undefined;\n try {\n const parsed =\n typeof a2uiSchema === \"string\" ? JSON.parse(a2uiSchema) : a2uiSchema;\n catalogId = parsed?.catalogId;\n } catch {\n // non-JSON schema — fall back to the toolkit's basic catalog\n }\n return { catalogId };\n }\n const context = decodeCatalogValue(properties.context);\n for (const entry of Array.isArray(context) ? context : []) {\n const description = entry?.description;\n const value = decodeCatalogValue(entry?.value);\n if (\n typeof description !== \"string\" ||\n typeof value !== \"string\" ||\n !description.includes(\"A2UI catalog\") ||\n !value\n )\n continue;\n const match = /^\\s*-\\s+(\\S+)/m.exec(value);\n return { compositionGuide: value, catalogId: match?.[1] };\n }\n return null;\n};\n\n/**\n * The A2UI `injectA2UITool` decision. The `@ag-ui/a2ui-middleware` forwards it on\n * `forwardedProps`, which `ag-ui-langgraph` surfaces into agent state at\n * `state[\"ag-ui\"].inject_a2ui_tool` — present only when the host turned the\n * runtime A2UI tool on (truthy or a custom tool-name string). `undefined` means\n * no signal (off, or no A2UI middleware in the pipeline) → no auto-injection.\n */\nconst a2uiInjectDecision = (state: any): boolean | string | undefined =>\n effectiveProperties(state).inject_a2ui_tool as boolean | string | undefined;\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 appendSystemNote = (request: any, note: string): any => {\n const existingMessage = request.systemMessage;\n if (existingMessage != null) {\n const separator = existingMessage.text === \"\" ? \"\" : \"\\n\\n\";\n return {\n ...request,\n systemMessage: existingMessage.concat(`${separator}${note}`),\n };\n }\n\n const existing = request.systemPrompt;\n if (existing == null) {\n return { ...request, systemPrompt: 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: `${baseText}\\n\\n${note}`,\n };\n};\n\nconst applyStateNote = (request: any, expose: ExposeStateOption): any => {\n const note = buildStateNote(\n (request.state ?? {}) as Record<string, unknown>,\n expose,\n );\n return note ? appendSystemNote(request, note) : request;\n};\n\nconst APP_CONTEXT_PREFIX = \"App Context:\\n\";\n\n// LangGraph runtime context carries trusted run configuration (thread, tenant\n// and user ids) that must never reach the model, so only a CopilotKit carrier\n// inside it counts: an \"ag-ui\" or \"copilotkit\" namespace, or a legacy\n// unnamespaced carrier with an actions or context key. See #7077.\nconst runtimeCarrierProperties = (\n carrier: unknown,\n namespace: \"ag-ui\" | \"copilotkit\",\n): Record<string, unknown> => {\n if (!isPropertyBag(carrier)) return {};\n const nested = carrier[namespace];\n if (isPropertyBag(nested) && Object.keys(nested).length > 0) return nested;\n if (\n namespace === \"copilotkit\" &&\n (\"actions\" in carrier || \"context\" in carrier)\n )\n return carrier;\n return {};\n};\n\n// Interception bookkeeping alone does not make a state namespace present.\nconst BOOKKEEPING_KEYS = new Set([\n \"interceptedToolCalls\",\n \"originalAIMessageId\",\n]);\n\nconst definedProperties = (value: unknown): Record<string, unknown> =>\n isPropertyBag(value)\n ? Object.fromEntries(\n Object.entries(value).filter(([, entry]) => entry !== undefined),\n )\n : {};\n\n// Each namespace comes from state, or from its runtime carrier when state has\n// none of it. CopilotKit then merges over AG-UI, as in the Python middleware.\nconst contextNamespace = (\n state: unknown,\n runtimeContext: unknown,\n namespace: \"ag-ui\" | \"copilotkit\",\n): Record<string, unknown> => {\n const fromState = definedProperties(\n isPropertyBag(state) ? state[namespace] : undefined,\n );\n return Object.keys(fromState).some((key) => !BOOKKEEPING_KEYS.has(key))\n ? fromState\n : definedProperties(runtimeCarrierProperties(runtimeContext, namespace));\n};\n\nconst buildAppContextNote = (\n state: unknown,\n runtimeContext: unknown,\n): string | null => {\n const properties = mergeProperties(\n contextNamespace(state, runtimeContext, \"ag-ui\"),\n contextNamespace(state, runtimeContext, \"copilotkit\"),\n );\n // Forwarded request headers are transport data, never model context.\n const appContext = isPropertyBag(properties.context)\n ? Object.fromEntries(\n Object.entries(properties.context).filter(\n ([key]) => key !== \"copilotkit_forwarded_headers\",\n ),\n )\n : properties.context;\n\n const isEmptyContext =\n !appContext ||\n (typeof appContext === \"string\" && appContext.trim() === \"\") ||\n (typeof appContext === \"object\" && Object.keys(appContext).length === 0);\n if (isEmptyContext) return null;\n\n const contextContent =\n typeof appContext === \"string\"\n ? appContext\n : JSON.stringify(appContext, null, 2);\n return `${APP_CONTEXT_PREFIX}${contextContent}`;\n};\n\nconst isAppContextMessage = (msg: any): boolean => {\n const type = msg?._getType?.();\n if (type !== \"system\" && type !== \"developer\") return false;\n const content =\n typeof msg.content === \"string\" ? msg.content : msg.content?.[0]?.text;\n return typeof content === \"string\" && content.startsWith(APP_CONTEXT_PREFIX);\n};\n\n// App context goes into the one leading system message, never a message of its\n// own: Anthropic and Gemini reject a second system message. Older releases\n// wrote an \"App Context:\" SystemMessage into the thread, so drop any such\n// message from the model's input too.\nconst applyAppContextNote = (request: any): any => {\n const messages = request.messages ?? [];\n const keptMessages = messages.filter((msg: any) => !isAppContextMessage(msg));\n if (keptMessages.length !== messages.length) {\n request = { ...request, messages: keptMessages };\n }\n\n const note = buildAppContextNote(request.state, request.runtime?.context);\n return note ? appendSystemNote(request, note) : request;\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\n .object({\n \"ag-ui\": zodState(z.record(z.string(), z.unknown()).optional()),\n copilotkit: zodState(\n z\n .object({\n actions: z\n .union([z.array(z.any()), z.literal(false)])\n .nullable()\n .optional(),\n context: z.any().optional(),\n interceptedToolCalls: z.array(z.any()).optional(),\n originalAIMessageId: z.string().optional(),\n })\n .passthrough()\n .optional(),\n ),\n })\n .passthrough();\n\nconst isToolCallContentBlock = (block: unknown) =>\n typeof block === \"object\" &&\n block !== null &&\n \"type\" in block &&\n (block.type === \"tool_call\" || block.type === \"tool_call_chunk\");\n\nconst usesV1ContentBlocks = (responseMetadata: unknown) =>\n typeof responseMetadata === \"object\" &&\n responseMetadata !== null &&\n \"output_version\" in responseMetadata &&\n responseMetadata.output_version === \"v1\";\n\n/**\n * Rebuilds an AIMessage with `toolCalls` as the source of truth while\n * preserving its non-tool content and metadata. For v1 content blocks, old\n * tool blocks must be removed before construction so they cannot duplicate or\n * override the supplied tool calls when AIMessage synchronizes both fields.\n */\nconst rebuildAIMessageWithToolCalls = (\n message: AIMessage,\n toolCalls: AIMessage[\"tool_calls\"],\n) => {\n let content = message.content;\n if (\n usesV1ContentBlocks(message.response_metadata) &&\n Array.isArray(content)\n ) {\n content = content.filter((block) => !isToolCallContentBlock(block));\n }\n\n return new AIMessage({\n content,\n additional_kwargs: message.additional_kwargs,\n response_metadata: message.response_metadata,\n tool_calls: toolCalls,\n invalid_tool_calls: message.invalid_tool_calls,\n usage_metadata: message.usage_metadata,\n id: message.id,\n name: message.name,\n });\n};\n\nconst buildMiddlewareInput = (\n exposeState: ExposeStateOption,\n a2uiParams?: Omit<A2UIToolParams, \"model\">,\n) => ({\n name: \"CopilotKitMiddleware\",\n\n stateSchema: copilotKitStateSchema as unknown as InteropZodObject,\n\n // Inject frontend tools, surface user state and app context, and forward\n // x-aimock-* headers\n wrapModelCall: async (request: any, handler: (req: any) => Promise<any>) => {\n request = applyStateNote(request, exposeState);\n request = applyAppContextNote(request);\n\n // Forward x-aimock-* headers from the incoming AG-UI request\n const forwardedHeaders = getForwardedHeaders();\n if (Object.keys(forwardedHeaders).length > 0) {\n const existingSettings = request.modelSettings ?? {};\n const existingHeaders =\n (existingSettings.headers as Record<string, string>) ?? {};\n request = {\n ...request,\n modelSettings: {\n ...existingSettings,\n headers: { ...existingHeaders, ...forwardedHeaders },\n },\n };\n }\n\n // Opt-in auto-injection of generate_a2ui:\n // (1) only inject when the A2UI injectA2UITool flag is truthy (forwarded by\n // @ag-ui/a2ui-middleware and surfaced at state[\"ag-ui\"].inject_a2ui_tool);\n // (2) don't double-inject if the agent already defines this tool.\n // The catalog (when present) only binds surfaces to the FE's catalog; it is\n // not the gate. The model is inferred from request.model; the built tool is\n // stashed for wrapToolCall to execute.\n let a2uiTool: any = null;\n const decision = a2uiInjectDecision(request.state);\n if (typeof getA2UITools === \"function\" && decision) {\n const catalog = resolveA2uiCatalog(request.state);\n // Shared A2UIToolParams: a single params object owned by the toolkit.\n // Start from the host overrides (guidelines / catalog id / tool name /\n // recovery) so a host can steer the subagent, then layer in only what the\n // host cannot know — the bound model, and the registered catalog id +\n // compositionGuide — without clobbering any host-set value.\n const params: A2UIToolParams = {\n ...a2uiParams,\n model: request.model,\n };\n if (catalog?.catalogId && params.defaultCatalogId == null)\n params.defaultCatalogId = catalog.catalogId;\n // Merge the registered catalog schema into any host `guidelines` bag; a\n // host-set compositionGuide wins, host generation/design overrides stay.\n if (catalog?.compositionGuide) {\n const guidelines = { ...params.guidelines };\n if (guidelines.compositionGuide == null)\n guidelines.compositionGuide = catalog.compositionGuide;\n params.guidelines = guidelines;\n }\n const candidate = getA2UITools(params);\n const existingNames = new Set(\n (request.tools || []).map((t: any) => t?.name),\n );\n if (!existingNames.has(candidate.name)) {\n // ToolNode derives tool runtime state from its config, ignoring an\n // overridden middleware request.state. Adapt the tool's invocation\n // config so the toolkit sees the same effective properties.\n const invoke = candidate.invoke.bind(candidate);\n candidate.invoke = (input, config) => {\n const state =\n config && \"state\" in config && isPropertyBag(config.state)\n ? config.state\n : request.state;\n const properties = effectiveProperties(state);\n const schema = properties.a2ui_schema;\n const context = decodeCatalogValue(properties.context);\n return invoke(input, {\n ...config,\n state: {\n ...state,\n \"ag-ui\": {\n ...properties,\n context: Array.isArray(context) ? context : [],\n // The toolkit interpolates the native schema into its prompt.\n a2ui_schema: isPropertyBag(schema)\n ? JSON.stringify(schema)\n : schema,\n },\n },\n });\n };\n a2uiTool = candidate;\n a2uiToolsByThread.set(a2uiThreadKey(request.state), a2uiTool);\n }\n }\n\n const actions = effectiveProperties(request.state).actions;\n let frontendTools = Array.isArray(actions) ? actions : [];\n if (a2uiTool) {\n // Our generate_a2ui replaces the runtime's render tool — don't advertise\n // both. Drop the render tool the A2UI middleware injected.\n const drop = typeof decision === \"string\" ? decision : \"render_a2ui\";\n frontendTools = frontendTools.filter(\n (t: any) => (t?.function?.name ?? t?.name) !== drop,\n );\n }\n\n if (frontendTools.length === 0 && !a2uiTool) {\n return handler(request);\n }\n\n const existingTools = request.tools || [];\n const mergedTools = [\n ...existingTools,\n ...(a2uiTool ? [a2uiTool] : []),\n ...frontendTools,\n ];\n\n return handler({\n ...request,\n tools: mergedTools,\n });\n },\n\n // Execute the dynamically-advertised generate_a2ui tool. It is not in the\n // agent's static tool registry, so the tool node cannot run it on its own;\n // we supply the implementation (built with the inferred model) for that one\n // tool. This hook's presence also disables createAgent's \"unknown tool\"\n // guard for dynamically-advertised tools.\n wrapToolCall: async (request: any, handler: (req: any) => Promise<any>) => {\n const tool = a2uiToolsByThread.get(a2uiThreadKey(request.state));\n if (tool && !request.tool && request.toolCall?.name === tool.name) {\n return handler({ ...request, tool });\n }\n return handler(request);\n },\n\n // Restore frontend tool calls to AIMessage before agent exits\n afterAgent: (state) => {\n // Drop the bridged A2UI tool for this run — all tool calls for the turn\n // have executed by now; the next model call re-stashes if needed.\n a2uiToolsByThread.delete(a2uiThreadKey(state));\n\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 rebuildAIMessageWithToolCalls(msg, [\n ...existingToolCalls,\n ...interceptedToolCalls,\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 actions = effectiveProperties(state).actions;\n const frontendTools = Array.isArray(actions) ? 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 = rebuildAIMessageWithToolCalls(\n lastMessage,\n backendToolCalls,\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), or\n * to steer the auto-injected `generate_a2ui` subagent via `a2uiParams`.\n *\n * `a2uiParams` is an `A2UIToolParams` without `model` (the middleware always\n * injects the bound model). Use it to override the subagent guidelines\n * (`generationGuidelines` / `designGuidelines` / `compositionGuide`),\n * `defaultCatalogId`, `toolName`, `recovery`, etc. on the auto-inject path —\n * which otherwise only ever uses the toolkit defaults. The registered catalog\n * is still folded in, but host-set values win.\n *\n * @example\n * ```typescript\n * import { createCopilotkitMiddleware } from \"@copilotkit/sdk-js/langgraph\";\n *\n * const middleware = createCopilotkitMiddleware({\n * exposeState: [\"liked\", \"todos\"],\n * a2uiParams: { guidelines: { designGuidelines: \"...repeating-card layout...\" } },\n * });\n * ```\n */\nexport const createCopilotkitMiddleware = (\n options: {\n exposeState?: ExposeStateOption;\n a2uiParams?: Omit<A2UIToolParams, \"model\">;\n } = {},\n) => {\n const exposeState = options.exposeState ?? false;\n return createMiddleware(\n buildMiddlewareInput(exposeState, options.a2uiParams) as any,\n );\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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"}
1
+ {"version":3,"file":"middleware.cjs","names":["z","AIMessage","getForwardedHeaders","getA2UITools"],"sources":["../../src/langgraph/middleware.ts"],"sourcesContent":["import { createMiddleware, AIMessage } 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\";\nimport { getA2UITools } from \"@ag-ui/langgraph\";\nimport type { A2UIToolParams } from \"@ag-ui/langgraph\";\nimport { getForwardedHeaders } from \"../header-propagation\";\n\n// ---------------------------------------------------------------------------\n// Auto-A2UI: bridge the inferred model's generate_a2ui tool from wrapModelCall\n// (the only hook that exposes the bound model) to wrapToolCall (where the tool\n// actually executes but the model is absent). Keyed by the run's thread id so\n// concurrent runs don't clobber each other.\n// ---------------------------------------------------------------------------\nconst a2uiToolsByThread = new Map<string, any>();\nconst A2UI_DEFAULT_THREAD_KEY = \"__copilotkit_a2ui_default__\";\nconst a2uiThreadKey = (state: any): string =>\n (state?.thread_id as string) || A2UI_DEFAULT_THREAD_KEY;\n\n/**\n * Merge AG-UI defaults with CopilotKit overrides. Dictionaries recurse; every\n * conflicting leaf uses CopilotKit, including false, null and empty values.\n * Arrays and serialized strings are atomic: no positional pairing or decoding.\n */\nconst isPropertyBag = (value: unknown): value is Record<string, unknown> =>\n value !== null && typeof value === \"object\" && !Array.isArray(value);\n\nconst mergeProperties = (\n base: Record<string, unknown>,\n overrides: Record<string, unknown>,\n): Record<string, unknown> =>\n Object.fromEntries(\n Array.from(new Set([...Object.keys(base), ...Object.keys(overrides)])).map(\n (key) => {\n const value = Object.prototype.hasOwnProperty.call(overrides, key)\n ? isPropertyBag(base[key]) && isPropertyBag(overrides[key])\n ? mergeProperties(base[key], overrides[key])\n : overrides[key]\n : base[key];\n return [key, value];\n },\n ),\n );\n\nconst effectiveProperties = (state: unknown): Record<string, unknown> => {\n const source = isPropertyBag(state) ? state : {};\n return mergeProperties(\n isPropertyBag(source[\"ag-ui\"]) ? source[\"ag-ui\"] : {},\n isPropertyBag(source.copilotkit) ? source.copilotkit : {},\n );\n};\n\nconst decodeCatalogValue = (value: unknown): unknown => {\n if (typeof value !== \"string\") return value;\n try {\n return JSON.parse(value);\n } catch {\n return value;\n }\n};\n\n/**\n * Find the frontend-registered A2UI catalog wherever it was passed. Returns\n * `{ compositionGuide?, catalogId? }` when a catalog is present, else `null`\n * independently of the explicit tool-injection decision. Two\n * delivery paths, depending on how the agent is served:\n * - AG-UI native endpoint → `state[\"ag-ui\"].a2ui_schema` (JSON\n * `{ catalogId, components }`); the toolkit reads it from state itself.\n * - Runtime proxy → an effective `context` entry describing\n * the A2UI catalog (catalog id + component schemas as text), passed to the\n * subagent via `compositionGuide`.\n * `catalogId` binds generated surfaces to the frontend's catalog so BYOC\n * custom catalogs render their own components (not the basic one).\n */\nconst resolveA2uiCatalog = (\n state: any,\n): { compositionGuide?: string; catalogId?: string } | null => {\n const properties = effectiveProperties(state);\n const a2uiSchema = properties.a2ui_schema;\n if (a2uiSchema) {\n let catalogId: string | undefined;\n try {\n const parsed =\n typeof a2uiSchema === \"string\" ? JSON.parse(a2uiSchema) : a2uiSchema;\n catalogId = parsed?.catalogId;\n } catch {\n // non-JSON schema — fall back to the toolkit's basic catalog\n }\n return { catalogId };\n }\n const context = decodeCatalogValue(properties.context);\n for (const entry of Array.isArray(context) ? context : []) {\n const description = entry?.description;\n const value = decodeCatalogValue(entry?.value);\n if (\n typeof description !== \"string\" ||\n typeof value !== \"string\" ||\n !description.includes(\"A2UI catalog\") ||\n !value\n )\n continue;\n const match = /^\\s*-\\s+(\\S+)/m.exec(value);\n return { compositionGuide: value, catalogId: match?.[1] };\n }\n return null;\n};\n\n/**\n * The A2UI `injectA2UITool` decision. The `@ag-ui/a2ui-middleware` forwards it on\n * `forwardedProps`, which `ag-ui-langgraph` surfaces into agent state at\n * `state[\"ag-ui\"].inject_a2ui_tool` — present only when the host turned the\n * runtime A2UI tool on (truthy or a custom tool-name string). `undefined` means\n * no signal (off, or no A2UI middleware in the pipeline) → no auto-injection.\n */\nconst a2uiInjectDecision = (state: any): boolean | string | undefined =>\n effectiveProperties(state).inject_a2ui_tool as boolean | string | undefined;\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 * Zod 4.2+ schemas already implement `~standard.jsonSchema` and are\n * returned unchanged. A Standard Schema without that hook carries\n * `~standard.validate` + `vendor` only, so `isStandardJSONSchema()` returns\n * false and the field is silently dropped from the graph's `output_schema`.\n * That makes AG-UI `STATE_SNAPSHOT` events filter the field out of the\n * payload sent to the frontend even though the underlying thread state has\n * 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 appendSystemNote = (request: any, note: string): any => {\n const existingMessage = request.systemMessage;\n if (existingMessage != null) {\n const separator = existingMessage.text === \"\" ? \"\" : \"\\n\\n\";\n return {\n ...request,\n systemMessage: existingMessage.concat(`${separator}${note}`),\n };\n }\n\n const existing = request.systemPrompt;\n if (existing == null) {\n return { ...request, systemPrompt: 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: `${baseText}\\n\\n${note}`,\n };\n};\n\nconst applyStateNote = (request: any, expose: ExposeStateOption): any => {\n const note = buildStateNote(\n (request.state ?? {}) as Record<string, unknown>,\n expose,\n );\n return note ? appendSystemNote(request, note) : request;\n};\n\nconst APP_CONTEXT_PREFIX = \"App Context:\\n\";\n\n// LangGraph runtime context carries trusted run configuration (thread, tenant\n// and user ids) that must never reach the model, so only a CopilotKit carrier\n// inside it counts: an \"ag-ui\" or \"copilotkit\" namespace, or a legacy\n// unnamespaced carrier with an actions or context key. See #7077.\nconst runtimeCarrierProperties = (\n carrier: unknown,\n namespace: \"ag-ui\" | \"copilotkit\",\n): Record<string, unknown> => {\n if (!isPropertyBag(carrier)) return {};\n const nested = carrier[namespace];\n if (isPropertyBag(nested) && Object.keys(nested).length > 0) return nested;\n if (\n namespace === \"copilotkit\" &&\n (\"actions\" in carrier || \"context\" in carrier)\n )\n return carrier;\n return {};\n};\n\n// Interception bookkeeping alone does not make a state namespace present.\nconst BOOKKEEPING_KEYS = new Set([\n \"interceptedToolCalls\",\n \"originalAIMessageId\",\n]);\n\nconst definedProperties = (value: unknown): Record<string, unknown> =>\n isPropertyBag(value)\n ? Object.fromEntries(\n Object.entries(value).filter(([, entry]) => entry !== undefined),\n )\n : {};\n\n// Each namespace comes from state, or from its runtime carrier when state has\n// none of it. CopilotKit then merges over AG-UI, as in the Python middleware.\nconst contextNamespace = (\n state: unknown,\n runtimeContext: unknown,\n namespace: \"ag-ui\" | \"copilotkit\",\n): Record<string, unknown> => {\n const fromState = definedProperties(\n isPropertyBag(state) ? state[namespace] : undefined,\n );\n return Object.keys(fromState).some((key) => !BOOKKEEPING_KEYS.has(key))\n ? fromState\n : definedProperties(runtimeCarrierProperties(runtimeContext, namespace));\n};\n\nconst buildAppContextNote = (\n state: unknown,\n runtimeContext: unknown,\n): string | null => {\n const properties = mergeProperties(\n contextNamespace(state, runtimeContext, \"ag-ui\"),\n contextNamespace(state, runtimeContext, \"copilotkit\"),\n );\n // Forwarded request headers are transport data, never model context.\n const appContext = isPropertyBag(properties.context)\n ? Object.fromEntries(\n Object.entries(properties.context).filter(\n ([key]) => key !== \"copilotkit_forwarded_headers\",\n ),\n )\n : properties.context;\n\n const isEmptyContext =\n !appContext ||\n (typeof appContext === \"string\" && appContext.trim() === \"\") ||\n (typeof appContext === \"object\" && Object.keys(appContext).length === 0);\n if (isEmptyContext) return null;\n\n const contextContent =\n typeof appContext === \"string\"\n ? appContext\n : JSON.stringify(appContext, null, 2);\n return `${APP_CONTEXT_PREFIX}${contextContent}`;\n};\n\nconst isAppContextMessage = (msg: any): boolean => {\n const type = msg?._getType?.();\n if (type !== \"system\" && type !== \"developer\") return false;\n const content =\n typeof msg.content === \"string\" ? msg.content : msg.content?.[0]?.text;\n return typeof content === \"string\" && content.startsWith(APP_CONTEXT_PREFIX);\n};\n\n// App context goes into the one leading system message, never a message of its\n// own: Anthropic and Gemini reject a second system message. Older releases\n// wrote an \"App Context:\" SystemMessage into the thread, so drop any such\n// message from the model's input too.\nconst applyAppContextNote = (request: any): any => {\n const messages = request.messages ?? [];\n const keptMessages = messages.filter((msg: any) => !isAppContextMessage(msg));\n if (keptMessages.length !== messages.length) {\n request = { ...request, messages: keptMessages };\n }\n\n const note = buildAppContextNote(request.state, request.runtime?.context);\n return note ? appendSystemNote(request, note) : request;\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\n .object({\n \"ag-ui\": zodState(z.record(z.string(), z.unknown()).optional()),\n copilotkit: zodState(\n z\n .object({\n actions: z\n .union([z.array(z.any()), z.literal(false)])\n .nullable()\n .optional(),\n context: z.any().optional(),\n interceptedToolCalls: z.array(z.any()).optional(),\n originalAIMessageId: z.string().optional(),\n })\n .loose()\n .optional(),\n ),\n })\n .loose();\n\nconst isToolCallContentBlock = (block: unknown) =>\n typeof block === \"object\" &&\n block !== null &&\n \"type\" in block &&\n (block.type === \"tool_call\" || block.type === \"tool_call_chunk\");\n\nconst usesV1ContentBlocks = (responseMetadata: unknown) =>\n typeof responseMetadata === \"object\" &&\n responseMetadata !== null &&\n \"output_version\" in responseMetadata &&\n responseMetadata.output_version === \"v1\";\n\n/**\n * Rebuilds an AIMessage with `toolCalls` as the source of truth while\n * preserving its non-tool content and metadata. For v1 content blocks, old\n * tool blocks must be removed before construction so they cannot duplicate or\n * override the supplied tool calls when AIMessage synchronizes both fields.\n */\nconst rebuildAIMessageWithToolCalls = (\n message: AIMessage,\n toolCalls: AIMessage[\"tool_calls\"],\n) => {\n let content = message.content;\n if (\n usesV1ContentBlocks(message.response_metadata) &&\n Array.isArray(content)\n ) {\n content = content.filter((block) => !isToolCallContentBlock(block));\n }\n\n return new AIMessage({\n content,\n additional_kwargs: message.additional_kwargs,\n response_metadata: message.response_metadata,\n tool_calls: toolCalls,\n invalid_tool_calls: message.invalid_tool_calls,\n usage_metadata: message.usage_metadata,\n id: message.id,\n name: message.name,\n });\n};\n\nconst buildMiddlewareInput = (\n exposeState: ExposeStateOption,\n a2uiParams?: Omit<A2UIToolParams, \"model\">,\n) => ({\n name: \"CopilotKitMiddleware\",\n\n stateSchema: copilotKitStateSchema as unknown as InteropZodObject,\n\n // Inject frontend tools, surface user state and app context, and forward\n // x-aimock-* headers\n wrapModelCall: async (request: any, handler: (req: any) => Promise<any>) => {\n request = applyStateNote(request, exposeState);\n request = applyAppContextNote(request);\n\n // Forward x-aimock-* headers from the incoming AG-UI request\n const forwardedHeaders = getForwardedHeaders();\n if (Object.keys(forwardedHeaders).length > 0) {\n const existingSettings = request.modelSettings ?? {};\n const existingHeaders =\n (existingSettings.headers as Record<string, string>) ?? {};\n request = {\n ...request,\n modelSettings: {\n ...existingSettings,\n headers: { ...existingHeaders, ...forwardedHeaders },\n },\n };\n }\n\n // Opt-in auto-injection of generate_a2ui:\n // (1) only inject when the A2UI injectA2UITool flag is truthy (forwarded by\n // @ag-ui/a2ui-middleware and surfaced at state[\"ag-ui\"].inject_a2ui_tool);\n // (2) don't double-inject if the agent already defines this tool.\n // The catalog (when present) only binds surfaces to the FE's catalog; it is\n // not the gate. The model is inferred from request.model; the built tool is\n // stashed for wrapToolCall to execute.\n let a2uiTool: any = null;\n const decision = a2uiInjectDecision(request.state);\n if (typeof getA2UITools === \"function\" && decision) {\n const catalog = resolveA2uiCatalog(request.state);\n // Shared A2UIToolParams: a single params object owned by the toolkit.\n // Start from the host overrides (guidelines / catalog id / tool name /\n // recovery) so a host can steer the subagent, then layer in only what the\n // host cannot know — the bound model, and the registered catalog id +\n // compositionGuide — without clobbering any host-set value.\n const params: A2UIToolParams = {\n ...a2uiParams,\n model: request.model,\n };\n if (catalog?.catalogId && params.defaultCatalogId == null)\n params.defaultCatalogId = catalog.catalogId;\n // Merge the registered catalog schema into any host `guidelines` bag; a\n // host-set compositionGuide wins, host generation/design overrides stay.\n if (catalog?.compositionGuide) {\n const guidelines = { ...params.guidelines };\n if (guidelines.compositionGuide == null)\n guidelines.compositionGuide = catalog.compositionGuide;\n params.guidelines = guidelines;\n }\n const candidate = getA2UITools(params);\n const existingNames = new Set(\n (request.tools || []).map((t: any) => t?.name),\n );\n if (!existingNames.has(candidate.name)) {\n // ToolNode derives tool runtime state from its config, ignoring an\n // overridden middleware request.state. Adapt the tool's invocation\n // config so the toolkit sees the same effective properties.\n const invoke = candidate.invoke.bind(candidate);\n candidate.invoke = (input, config) => {\n const state =\n config && \"state\" in config && isPropertyBag(config.state)\n ? config.state\n : request.state;\n const properties = effectiveProperties(state);\n const schema = properties.a2ui_schema;\n const context = decodeCatalogValue(properties.context);\n return invoke(input, {\n ...config,\n state: {\n ...state,\n \"ag-ui\": {\n ...properties,\n context: Array.isArray(context) ? context : [],\n // The toolkit interpolates the native schema into its prompt.\n a2ui_schema: isPropertyBag(schema)\n ? JSON.stringify(schema)\n : schema,\n },\n },\n });\n };\n a2uiTool = candidate;\n a2uiToolsByThread.set(a2uiThreadKey(request.state), a2uiTool);\n }\n }\n\n const actions = effectiveProperties(request.state).actions;\n let frontendTools = Array.isArray(actions) ? actions : [];\n if (a2uiTool) {\n // Our generate_a2ui replaces the runtime's render tool — don't advertise\n // both. Drop the render tool the A2UI middleware injected.\n const drop = typeof decision === \"string\" ? decision : \"render_a2ui\";\n frontendTools = frontendTools.filter(\n (t: any) => (t?.function?.name ?? t?.name) !== drop,\n );\n }\n\n if (frontendTools.length === 0 && !a2uiTool) {\n return handler(request);\n }\n\n const existingTools = request.tools || [];\n const mergedTools = [\n ...existingTools,\n ...(a2uiTool ? [a2uiTool] : []),\n ...frontendTools,\n ];\n\n return handler({\n ...request,\n tools: mergedTools,\n });\n },\n\n // Execute the dynamically-advertised generate_a2ui tool. It is not in the\n // agent's static tool registry, so the tool node cannot run it on its own;\n // we supply the implementation (built with the inferred model) for that one\n // tool. This hook's presence also disables createAgent's \"unknown tool\"\n // guard for dynamically-advertised tools.\n wrapToolCall: async (request: any, handler: (req: any) => Promise<any>) => {\n const tool = a2uiToolsByThread.get(a2uiThreadKey(request.state));\n if (tool && !request.tool && request.toolCall?.name === tool.name) {\n return handler({ ...request, tool });\n }\n return handler(request);\n },\n\n // Restore frontend tool calls to AIMessage before agent exits\n afterAgent: (state) => {\n // Drop the bridged A2UI tool for this run — all tool calls for the turn\n // have executed by now; the next model call re-stashes if needed.\n a2uiToolsByThread.delete(a2uiThreadKey(state));\n\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 rebuildAIMessageWithToolCalls(msg, [\n ...existingToolCalls,\n ...interceptedToolCalls,\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 actions = effectiveProperties(state).actions;\n const frontendTools = Array.isArray(actions) ? 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 = rebuildAIMessageWithToolCalls(\n lastMessage,\n backendToolCalls,\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), or\n * to steer the auto-injected `generate_a2ui` subagent via `a2uiParams`.\n *\n * `a2uiParams` is an `A2UIToolParams` without `model` (the middleware always\n * injects the bound model). Use it to override the subagent guidelines\n * (`generationGuidelines` / `designGuidelines` / `compositionGuide`),\n * `defaultCatalogId`, `toolName`, `recovery`, etc. on the auto-inject path —\n * which otherwise only ever uses the toolkit defaults. The registered catalog\n * is still folded in, but host-set values win.\n *\n * @example\n * ```typescript\n * import { createCopilotkitMiddleware } from \"@copilotkit/sdk-js/langgraph\";\n *\n * const middleware = createCopilotkitMiddleware({\n * exposeState: [\"liked\", \"todos\"],\n * a2uiParams: { guidelines: { designGuidelines: \"...repeating-card layout...\" } },\n * });\n * ```\n */\nexport const createCopilotkitMiddleware = (\n options: {\n exposeState?: ExposeStateOption;\n a2uiParams?: Omit<A2UIToolParams, \"model\">;\n } = {},\n) => {\n const exposeState = options.exposeState ?? false;\n return createMiddleware(\n buildMiddlewareInput(exposeState, options.a2uiParams) as any,\n );\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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"}
@@ -15,11 +15,13 @@ type WithJsonSchema<T> = T extends {
15
15
  * `getJsonSchemaFromSchema` (called from `StateSchema.getJsonSchema`)
16
16
  * can serialize the field.
17
17
  *
18
- * Without this, Zod v4 fields carry `~standard.validate` + `vendor` only,
19
- * and `isStandardJSONSchema()` returns false, so the field is silently
20
- * dropped from the graph's `output_schema`. That makes AG-UI
21
- * `STATE_SNAPSHOT` events filter the field out of the payload sent to
22
- * the frontend even though the underlying thread state has the value.
18
+ * Zod 4.2+ schemas already implement `~standard.jsonSchema` and are
19
+ * returned unchanged. A Standard Schema without that hook carries
20
+ * `~standard.validate` + `vendor` only, so `isStandardJSONSchema()` returns
21
+ * false and the field is silently dropped from the graph's `output_schema`.
22
+ * That makes AG-UI `STATE_SNAPSHOT` events filter the field out of the
23
+ * payload sent to the frontend even though the underlying thread state has
24
+ * the value.
23
25
  *
24
26
  * Use this on any custom state field you want visible to the frontend
25
27
  * via `useAgent().state.*`.
@@ -1 +1 @@
1
- {"version":3,"file":"middleware.d.cts","names":[],"sources":["../../src/langgraph/middleware.ts"],"mappings":";;;;;;KAwHK,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;;;;;AAogBA;;;;;;;cAAa,0BAAA,GACX,OAAA;EACE,WAAA,GAAc,iBAAA;EACd,UAAA,GAAa,IAAA,CAAK,cAAA;AAAA,MACd,SAAA,CAAA,eAAA,0CADa,sBAAA,CACb,UAAA,GAAA,sBAAA,CAAA,UAAA;;;;;;cAaK,oBAAA,EAAoB,SAAA,CAAA,eAAA,0CAA+B,sBAAA,CAA/B,UAAA,GAAA,sBAAA,CAAA,UAAA"}
1
+ {"version":3,"file":"middleware.d.cts","names":[],"sources":["../../src/langgraph/middleware.ts"],"mappings":";;;;;;KAwHK,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;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA4BY,QAAA,kBAAA,CAA2B,MAAA,EAAQ,CAAA,GAAI,cAAA,CAAe,CAAA;;;;;;;;;AAAtE;;;;KA2DY,iBAAA;;;;;;;;;;;AAAZ;;;;;AAogBA;;;;;;;;;cAAa,0BAAA,GACX,OAAA;EACE,WAAA,GAAc,iBAAA;EACd,UAAA,GAAa,IAAA,CAAK,cAAA;AAAA,MACd,SAAA,CAAA,eAAA,0CADa,sBAAA,CACb,UAAA,GAAA,sBAAA,CAAA,UAAA;;;;;;cAaK,oBAAA,EAAoB,SAAA,CAAA,eAAA,0CAA+B,sBAAA,CAA/B,UAAA,GAAA,sBAAA,CAAA,UAAA"}
@@ -15,11 +15,13 @@ type WithJsonSchema<T> = T extends {
15
15
  * `getJsonSchemaFromSchema` (called from `StateSchema.getJsonSchema`)
16
16
  * can serialize the field.
17
17
  *
18
- * Without this, Zod v4 fields carry `~standard.validate` + `vendor` only,
19
- * and `isStandardJSONSchema()` returns false, so the field is silently
20
- * dropped from the graph's `output_schema`. That makes AG-UI
21
- * `STATE_SNAPSHOT` events filter the field out of the payload sent to
22
- * the frontend even though the underlying thread state has the value.
18
+ * Zod 4.2+ schemas already implement `~standard.jsonSchema` and are
19
+ * returned unchanged. A Standard Schema without that hook carries
20
+ * `~standard.validate` + `vendor` only, so `isStandardJSONSchema()` returns
21
+ * false and the field is silently dropped from the graph's `output_schema`.
22
+ * That makes AG-UI `STATE_SNAPSHOT` events filter the field out of the
23
+ * payload sent to the frontend even though the underlying thread state has
24
+ * the value.
23
25
  *
24
26
  * Use this on any custom state field you want visible to the frontend
25
27
  * via `useAgent().state.*`.
@@ -1 +1 @@
1
- {"version":3,"file":"middleware.d.mts","names":[],"sources":["../../src/langgraph/middleware.ts"],"mappings":";;;;;;KAwHK,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;;;;;AAogBA;;;;;;;cAAa,0BAAA,GACX,OAAA;EACE,WAAA,GAAc,iBAAA;EACd,UAAA,GAAa,IAAA,CAAK,cAAA;AAAA,MACd,SAAA,CAAA,eAAA,0CADa,sBAAA,CACb,UAAA,GAAA,sBAAA,CAAA,UAAA;;;;;;cAaK,oBAAA,EAAoB,SAAA,CAAA,eAAA,0CAA+B,sBAAA,CAA/B,UAAA,GAAA,sBAAA,CAAA,UAAA"}
1
+ {"version":3,"file":"middleware.d.mts","names":[],"sources":["../../src/langgraph/middleware.ts"],"mappings":";;;;;;KAwHK,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;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA4BY,QAAA,kBAAA,CAA2B,MAAA,EAAQ,CAAA,GAAI,cAAA,CAAe,CAAA;;;;;;;;;AAAtE;;;;KA2DY,iBAAA;;;;;;;;;;;AAAZ;;;;;AAogBA;;;;;;;;;cAAa,0BAAA,GACX,OAAA;EACE,WAAA,GAAc,iBAAA;EACd,UAAA,GAAa,IAAA,CAAK,cAAA;AAAA,MACd,SAAA,CAAA,eAAA,0CADa,sBAAA,CACb,UAAA,GAAA,sBAAA,CAAA,UAAA;;;;;;cAaK,oBAAA,EAAoB,SAAA,CAAA,eAAA,0CAA+B,sBAAA,CAA/B,UAAA,GAAA,sBAAA,CAAA,UAAA"}
@@ -1,6 +1,6 @@
1
1
  import { getForwardedHeaders } from "../header-propagation.mjs";
2
+ import * as z$1 from "zod";
2
3
  import { AIMessage, createMiddleware } from "langchain";
3
- import * as z from "zod";
4
4
  import { getA2UITools } from "@ag-ui/langgraph";
5
5
 
6
6
  //#region src/langgraph/middleware.ts
@@ -77,11 +77,13 @@ const a2uiInjectDecision = (state) => effectiveProperties(state).inject_a2ui_too
77
77
  * `getJsonSchemaFromSchema` (called from `StateSchema.getJsonSchema`)
78
78
  * can serialize the field.
79
79
  *
80
- * Without this, Zod v4 fields carry `~standard.validate` + `vendor` only,
81
- * and `isStandardJSONSchema()` returns false, so the field is silently
82
- * dropped from the graph's `output_schema`. That makes AG-UI
83
- * `STATE_SNAPSHOT` events filter the field out of the payload sent to
84
- * the frontend even though the underlying thread state has the value.
80
+ * Zod 4.2+ schemas already implement `~standard.jsonSchema` and are
81
+ * returned unchanged. A Standard Schema without that hook carries
82
+ * `~standard.validate` + `vendor` only, so `isStandardJSONSchema()` returns
83
+ * false and the field is silently dropped from the graph's `output_schema`.
84
+ * That makes AG-UI `STATE_SNAPSHOT` events filter the field out of the
85
+ * payload sent to the frontend even though the underlying thread state has
86
+ * the value.
85
87
  *
86
88
  * Use this on any custom state field you want visible to the frontend
87
89
  * via `useAgent().state.*`.
@@ -102,7 +104,7 @@ function zodState(schema) {
102
104
  std.jsonSchema = { input: () => {
103
105
  if (cached) return cached;
104
106
  try {
105
- const maybeV4ToJsonSchema = z.toJSONSchema;
107
+ const maybeV4ToJsonSchema = z$1.toJSONSchema;
106
108
  cached = typeof maybeV4ToJsonSchema === "function" ? maybeV4ToJsonSchema(schema) : {};
107
109
  } catch {
108
110
  cached = {};
@@ -226,15 +228,15 @@ const applyAppContextNote = (request) => {
226
228
  * });
227
229
  * ```
228
230
  */
229
- const copilotKitStateSchema = z.object({
230
- "ag-ui": zodState(z.record(z.string(), z.unknown()).optional()),
231
- copilotkit: zodState(z.object({
232
- actions: z.union([z.array(z.any()), z.literal(false)]).nullable().optional(),
233
- context: z.any().optional(),
234
- interceptedToolCalls: z.array(z.any()).optional(),
235
- originalAIMessageId: z.string().optional()
236
- }).passthrough().optional())
237
- }).passthrough();
231
+ const copilotKitStateSchema = z$1.object({
232
+ "ag-ui": zodState(z$1.record(z$1.string(), z$1.unknown()).optional()),
233
+ copilotkit: zodState(z$1.object({
234
+ actions: z$1.union([z$1.array(z$1.any()), z$1.literal(false)]).nullable().optional(),
235
+ context: z$1.any().optional(),
236
+ interceptedToolCalls: z$1.array(z$1.any()).optional(),
237
+ originalAIMessageId: z$1.string().optional()
238
+ }).loose().optional())
239
+ }).loose();
238
240
  const isToolCallContentBlock = (block) => typeof block === "object" && block !== null && "type" in block && (block.type === "tool_call" || block.type === "tool_call_chunk");
239
241
  const usesV1ContentBlocks = (responseMetadata) => typeof responseMetadata === "object" && responseMetadata !== null && "output_version" in responseMetadata && responseMetadata.output_version === "v1";
240
242
  /**