@copilotkit/channels-core 0.10.0 → 0.11.0

package/dist/index.d.ts

@@ -23,6 +23,8 @@ export { Transcripts } from "./transcripts.js";
 export type { TranscriptEntry, TranscriptsConfig } from "./transcripts.js";
 export { toAgentToolDescriptors, parseToolArgs, stringifyHandlerResult, defineChannelTool, } from "./tools.js";
 export type { ChannelTool, ObjectSchema, ChannelToolContext, ContextEntry, AgentToolDescriptor, } from "./tools.js";
+export { singleStringParameterSchema } from "./standard-schema.js";
+export type { SingleStringParameterSchema } from "./standard-schema.js";
 export { mintId, stableStringify } from "./mint-id.js";
 export { runAgentLoop } from "./run-loop.js";
 export type { RunLoopArgs } from "./run-loop.js";

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -30,6 +30,10 @@ export { createStateBackedConversationStore } from "./state/state-conversation-s
 export { Transcripts } from "./transcripts.js";
 // Tools & context
 export { toAgentToolDescriptors, parseToolArgs, stringifyHandlerResult, defineChannelTool, } from "./tools.js";
+// Parameter-schema builder for the `lookup_<platform>_user` tool every
+// adapter ships. Lets an adapter describe a one-string parameter without
+// declaring `zod` (PE-30) — see `standard-schema.ts` for why that matters.
+export { singleStringParameterSchema } from "./standard-schema.js";
 // Id / serialization helpers
 export { mintId, stableStringify } from "./mint-id.js";
 // Run loop

package/dist/single-string-parameter-schema.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=single-string-parameter-schema.test.d.ts.map

package/dist/single-string-parameter-schema.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"single-string-parameter-schema.test.d.ts","sourceRoot":"","sources":["../src/single-string-parameter-schema.test.ts"],"names":[],"mappings":""}

package/dist/single-string-parameter-schema.test.js

@@ -0,0 +1,183 @@
+/**
+ * `singleStringParameterSchema` replaces the `z.object({query: z.string()
+ * .min(1).describe(...)})` that every platform adapter used to build its
+ * `lookup_<platform>_user` parameter with, so that no adapter declares a
+ * `zod` range (PE-30).
+ *
+ * The contract it has to honor is "behaves like the Zod object it replaces",
+ * so these tests assert against Zod itself rather than against a transcribed
+ * expectation. `zod` is a devDependency of this package; nothing published
+ * imports it.
+ */
+import { describe, it, expect } from "vitest";
+import { z } from "zod";
+import { zodToJsonSchema } from "zod-to-json-schema";
+import { singleStringParameterSchema } from "./standard-schema.js";
+import { toJsonSchema, validateSchema } from "./standard-schema.js";
+const DESCRIPTION = "Handle, display name, or first name of the person.";
+const schema = singleStringParameterSchema({
+    name: "query",
+    description: DESCRIPTION,
+});
+/** The exact Zod object this helper is a drop-in replacement for. */
+const zodEquivalent = z.object({
+    query: z.string().min(1).describe(DESCRIPTION),
+});
+describe("singleStringParameterSchema", () => {
+    it("emits the JSON Schema document the Zod object emits", () => {
+        expect(toJsonSchema(schema)).toEqual(zodToJsonSchema(zodEquivalent, { $refStrategy: "none" }));
+    });
+    it("names the field the caller asked for", () => {
+        const renamed = singleStringParameterSchema({
+            name: "handle",
+            description: DESCRIPTION,
+        });
+        const doc = toJsonSchema(renamed);
+        expect(Object.keys(doc.properties)).toEqual(["handle"]);
+        expect(doc.required).toEqual(["handle"]);
+    });
+    it("names this package as the vendor, not zod and not the caller", () => {
+        // The Standard Schema `vendor` names the library that produced the
+        // schema, which is `channels-core` whichever adapter calls the helper.
+        // It also has to not be "zod": `schemaToJsonSchema` routes a
+        // `vendor: "zod"` schema through `zod-to-json-schema`, and anything else
+        // must carry its own document.
+        expect(schema["~standard"].vendor).toBe("@copilotkit/channels-core");
+        const renamed = singleStringParameterSchema({
+            name: "handle",
+            description: DESCRIPTION,
+        });
+        expect(renamed["~standard"].vendor).toBe("@copilotkit/channels-core");
+    });
+    it("accepts a valid value, exactly as the Zod object does", async () => {
+        expect(await validateSchema(schema, { query: "ada" })).toEqual({
+            ok: true,
+            value: { query: "ada" },
+        });
+        expect(zodEquivalent.safeParse({ query: "ada" }).data).toEqual({
+            query: "ada",
+        });
+    });
+    it("strips unknown keys rather than rejecting them, as z.object does", async () => {
+        const input = { query: "ada", extra: "ignored" };
+        expect(await validateSchema(schema, input)).toEqual({
+            ok: true,
+            value: { query: "ada" },
+        });
+        // Pin the Zod behavior this mirrors, so a Zod default change is visible.
+        expect(zodEquivalent.safeParse(input).data).toEqual({ query: "ada" });
+    });
+    it("rejects a missing field and names it", async () => {
+        const r = await validateSchema(schema, {});
+        expect(r.ok).toBe(false);
+        expect(r.ok === false && r.error).toContain("query");
+        expect(zodEquivalent.safeParse({}).success).toBe(false);
+    });
+    it("rejects an empty string, which is what .min(1) guarded", async () => {
+        const r = await validateSchema(schema, { query: "" });
+        expect(r.ok).toBe(false);
+        expect(zodEquivalent.safeParse({ query: "" }).success).toBe(false);
+    });
+    it.each([
+        ["a number", 42, "number"],
+        ["null", null, "null"],
+        ["an array", [], "array"],
+    ])("rejects %s field, naming the received type", async (_label, value, received) => {
+        const r = await validateSchema(schema, { query: value });
+        expect(r.ok).toBe(false);
+        expect(r.ok === false && r.error).toContain(received);
+    });
+    it.each([
+        ["null", null],
+        ["an array", []],
+        ["a string", "ada"],
+    ])("rejects %s as the whole argument payload", async (_label, value) => {
+        const r = await validateSchema(schema, value);
+        expect(r.ok).toBe(false);
+        expect(zodEquivalent.safeParse(value).success).toBe(false);
+    });
+    /**
+     * The error string is what the agent reads back on a bad tool call, so it
+     * is part of the contract, not an implementation detail. Asserting only
+     * "both reject" let a real divergence through: a missing field reported
+     * "Expected string, received undefined" where Zod reports "Required".
+     * Compare the rendered text, formatted the same way `validateSchema` does.
+     */
+    it.each([
+        ["a missing field", {}],
+        ["a number field", { query: 42 }],
+        ["a null field", { query: null }],
+        ["an array field", { query: [] }],
+        ["a boolean field", { query: true }],
+        ["an object field", { query: {} }],
+        ["an explicit undefined field", { query: undefined }],
+        ["an empty string", { query: "" }],
+        ["null as the payload", null],
+        ["an array as the payload", []],
+        ["a string as the payload", "ada"],
+        ["a number as the payload", 7],
+    ])("renders the same error text as zod for %s", async (_label, value) => {
+        const mine = await validateSchema(schema, value);
+        const theirs = zodEquivalent.safeParse(value);
+        expect(mine.ok).toBe(theirs.success);
+        expect(theirs.success).toBe(false);
+        const zodText = theirs.success
+            ? null
+            : theirs.error.issues
+                .map((i) => `${i.path.join(".") || "(root)"}: ${i.message}`)
+                .join("; ");
+        expect(mine.ok === false && mine.error).toBe(zodText);
+    });
+    /**
+     * `zodToJsonSchema` built a fresh document on every call and
+     * `toAgentToolDescriptors` hands its result straight to the caller, so a
+     * consumer that normalizes the schema in place (dropping `$schema` for a
+     * provider that rejects it, for instance) must not corrupt later turns.
+     */
+    it("returns a fresh JSON Schema document on every call", () => {
+        const first = toJsonSchema(schema);
+        const second = toJsonSchema(schema);
+        expect(first).not.toBe(second);
+        expect(first).toEqual(second);
+        first.properties.query.description = "mutated by a consumer";
+        const third = toJsonSchema(schema);
+        expect(third.properties.query.description).toBe(DESCRIPTION);
+    });
+});
+/**
+ * Type-level assertions. `check-types` runs `tsconfig.check.json`, which
+ * includes this file, so a `@ts-expect-error` here fails the build when the
+ * error it expects stops happening. Nothing below runs.
+ *
+ * The output type is built by mapping over `Name`. A union of names would
+ * claim every member is a present `string` while the function creates exactly
+ * one key, and a widened `string` would claim every possible key. Both promise
+ * a `string` where the value is `undefined`, so both have to be rejected at
+ * the call.
+ */
+describe("type-level contract", () => {
+    it("is enforced by check-types, not at runtime", () => {
+        const literal = singleStringParameterSchema({
+            name: "query",
+            description: DESCRIPTION,
+        });
+        // The literal key is inferred, and nothing else exists on the output.
+        const ok = { query: "ada" };
+        // @ts-expect-error `nope` is not a key of the inferred output
+        const bogus = { query: "ada", nope: 1 };
+        const unionName = (Math.random() > 0.5 ? "query" : "handle");
+        singleStringParameterSchema({
+            // @ts-expect-error a union of names would promise a key that is never created
+            name: unionName,
+            description: DESCRIPTION,
+        });
+        const dynamicName = "query";
+        singleStringParameterSchema({
+            // @ts-expect-error a widened `string` would promise every possible key
+            name: dynamicName,
+            description: DESCRIPTION,
+        });
+        expect(ok.query).toBe("ada");
+        expect(bogus).toBeDefined();
+    });
+});

package/dist/standard-schema.d.ts

@@ -1,5 +1,5 @@
-import type { StandardSchemaV1, InferSchemaOutput } from "@copilotkit/shared";
-export type { StandardSchemaV1, InferSchemaOutput };
+import type { StandardSchemaV1, StandardJSONSchemaV1, InferSchemaOutput } from "@copilotkit/shared";
+export type { StandardSchemaV1, StandardJSONSchemaV1, InferSchemaOutput };
 /**
  * A Standard Schema whose validated output is an object record.
  *
@@ -35,4 +35,79 @@ export type SchemaParseResult<T> = {
  * a JSON tool result so the agent can recover from a bad tool call.
  */
 export declare function validateSchema<S extends StandardSchemaV1>(schema: S, value: unknown): Promise<SchemaParseResult<InferSchemaOutput<S>>>;
+/** True when `T` is a union of more than one member. */
+type IsUnion<T, U = T> = T extends unknown ? [U] extends [T] ? false : true : never;
+/**
+ * `Name` unless it is a union or the widened `string`, in which case `never`.
+ *
+ * The output type is built by mapping over `Name`, so a union claims every
+ * member is present while the function creates exactly one key, and a widened
+ * `string` claims every possible key. Either way the type promises a `string`
+ * where the value is `undefined`. Restricting the parameter to one literal is
+ * what makes `SingleStringParameterSchema` honest.
+ */
+type SingleLiteral<Name extends string> = string extends Name ? never : true extends IsUnion<Name> ? never : Name;
+/**
+ * A parameter schema for a tool that takes exactly one required string.
+ *
+ * The output type is keyed by the literal `Name` passed in, so a handler
+ * written against it destructures the real field name and not a widened
+ * `Record`.
+ */
+export type SingleStringParameterSchema<Name extends string> = StandardSchemaV1<unknown, {
+    [K in Name]: string;
+}> & StandardJSONSchemaV1<unknown, {
+    [K in Name]: string;
+}>;
+/**
+ * Build a tool parameter schema for a single required, non-empty string,
+ * written directly against the [Standard Schema](https://standardschema.dev)
+ * protocol.
+ *
+ * WHY THIS EXISTS (PE-30, OSS-1173)
+ * ---------------------------------
+ * Every platform adapter ships one `lookup_<platform>_user` tool, and each
+ * one took the same parameter: a single string to resolve to a user. Each
+ * built that parameter with `z.object({query: z.string().min(1)})`, and a
+ * `zod` range in the adapter's `package.json` was the price.
+ *
+ * That price was not local. The `@copilotkit/channels` umbrella depends on
+ * every adapter, and `@microsoft/agents-hosting` and
+ * `@microsoft/agents-activity` pin `zod` at exactly `3.25.75`. An adapter
+ * asking for `^3.25.76` is a range that excludes that pin, so installing the
+ * umbrella alongside the Microsoft packages left a tree no application could
+ * repair from its own `package.json` — the conflict came from two packages we
+ * publish. One dependency for one object literal was not a trade worth
+ * keeping, three times over.
+ *
+ * `defineChannelTool` accepts any Standard Schema, and `toJsonSchema()` reads
+ * `~standard.jsonSchema.input()` in preference to every other path, so this
+ * one small object is all a tool ever needed.
+ *
+ * Behavior mirrors the `z.object({[name]: z.string().min(1).describe(...)})`
+ * it replaces: the field is required, must be a string of at least one
+ * character, and unknown keys are stripped rather than rejected (Zod's
+ * default `strip` mode for `z.object`). The emitted document is what
+ * `zod-to-json-schema` emitted for that object, so the descriptor the model
+ * is shown does not change. Its body is target-agnostic — `type`,
+ * `properties`, `required`, `minLength` and `additionalProperties` mean the
+ * same thing in draft-07 and draft-2020-12 — so one document serves every
+ * target a caller asks for, and `$schema` keeps the draft-07 value the
+ * previous output carried.
+ *
+ * The one-character floor is fixed rather than configurable because all three
+ * call sites want it and a knob nobody turns is a knob nobody tests.
+ */
+export declare function singleStringParameterSchema<const Name extends string>(options: {
+    /**
+     * Field name, e.g. `"query"`. Becomes the sole key of the output object.
+     *
+     * Must be a single string literal. A union or a widened `string` is a
+     * compile error, because the output type would then promise keys this
+     * function never creates. See `SingleLiteral`.
+     */
+    name: SingleLiteral<Name>;
+    /** Field description handed to the model. Was `z.string().describe(...)`. */
+    description: string;
+}): SingleStringParameterSchema<Name>;
 //# sourceMappingURL=standard-schema.d.ts.map

package/dist/standard-schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"standard-schema.d.ts","sourceRoot":"","sources":["../src/standard-schema.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAG9E,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,CAAC;AAEpD;;;;;;;;;GASG;AACH,MAAM,MAAM,YAAY,GAAG,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAE9E;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,gBAAgB,GACvB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAWzB;AAED,4EAA4E;AAC5E,MAAM,MAAM,iBAAiB,CAAC,CAAC,IAC3B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GACtB;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjC;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,CAAC,SAAS,gBAAgB,EAC7D,MAAM,EAAE,CAAC,EACT,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,iBAAiB,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,CAWlD"}
+{"version":3,"file":"standard-schema.d.ts","sourceRoot":"","sources":["../src/standard-schema.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EACV,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EAClB,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,CAAC;AAE1E;;;;;;;;;GASG;AACH,MAAM,MAAM,YAAY,GAAG,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAE9E;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,gBAAgB,GACvB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAWzB;AAED,4EAA4E;AAC5E,MAAM,MAAM,iBAAiB,CAAC,CAAC,IAC3B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GACtB;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjC;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,CAAC,SAAS,gBAAgB,EAC7D,MAAM,EAAE,CAAC,EACT,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,iBAAiB,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,CAWlD;AAwBD,wDAAwD;AACxD,KAAK,OAAO,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,OAAO,GACtC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GACb,KAAK,GACL,IAAI,GACN,KAAK,CAAC;AAEV;;;;;;;;GAQG;AACH,KAAK,aAAa,CAAC,IAAI,SAAS,MAAM,IAAI,MAAM,SAAS,IAAI,GACzD,KAAK,GACL,IAAI,SAAS,OAAO,CAAC,IAAI,CAAC,GACxB,KAAK,GACL,IAAI,CAAC;AAEX;;;;;;GAMG;AACH,MAAM,MAAM,2BAA2B,CAAC,IAAI,SAAS,MAAM,IAAI,gBAAgB,CAC7E,OAAO,EACP;KAAG,CAAC,IAAI,IAAI,GAAG,MAAM;CAAE,CACxB,GACC,oBAAoB,CAAC,OAAO,EAAE;KAAG,CAAC,IAAI,IAAI,GAAG,MAAM;CAAE,CAAC,CAAC;AAazD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,CAAC,IAAI,SAAS,MAAM,EACzB,OAAO,EAAE;IACT;;;;;;OAMG;IACH,IAAI,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC;IAC1B,6EAA6E;IAC7E,WAAW,EAAE,MAAM,CAAC;CACrB,GAAG,2BAA2B,CAAC,IAAI,CAAC,CA6EpC"}

package/dist/standard-schema.js

@@ -1,5 +1,5 @@
 /**
- * Schema-library-agnostic helpers for the Slack SDK.
+ * Schema-library-agnostic helpers for the Channels SDK.
  *
  * The public API accepts any [Standard Schema](https://standardschema.dev)
  * validator — Zod 3.24+, Valibot v1+, ArkType v2+, and anything else that
@@ -10,7 +10,7 @@
  *
  * These wrap the canonical primitives from `@copilotkit/shared` (the same
  * ones `@copilotkit/core` uses for its `FrontendTool` parameters) plus a
- * couple of Slack-local conveniences.
+ * couple of Channels-local conveniences.
  */
 import { schemaToJsonSchema as sharedSchemaToJsonSchema } from "@copilotkit/shared";
 import { zodToJsonSchema } from "zod-to-json-schema";
@@ -64,3 +64,128 @@ function formatIssues(issues) {
     })
         .join("; ");
 }
+/**
+ * `typeof` reports "object" for both `null` and arrays. Zod names them
+ * separately, and this message is what the agent reads back on a bad call,
+ * so it is worth the three lines to keep the wording it used to get.
+ */
+function parsedTypeOf(value) {
+    if (value === null)
+        return "null";
+    if (Array.isArray(value))
+        return "array";
+    return typeof value;
+}
+/**
+ * Build a tool parameter schema for a single required, non-empty string,
+ * written directly against the [Standard Schema](https://standardschema.dev)
+ * protocol.
+ *
+ * WHY THIS EXISTS (PE-30, OSS-1173)
+ * ---------------------------------
+ * Every platform adapter ships one `lookup_<platform>_user` tool, and each
+ * one took the same parameter: a single string to resolve to a user. Each
+ * built that parameter with `z.object({query: z.string().min(1)})`, and a
+ * `zod` range in the adapter's `package.json` was the price.
+ *
+ * That price was not local. The `@copilotkit/channels` umbrella depends on
+ * every adapter, and `@microsoft/agents-hosting` and
+ * `@microsoft/agents-activity` pin `zod` at exactly `3.25.75`. An adapter
+ * asking for `^3.25.76` is a range that excludes that pin, so installing the
+ * umbrella alongside the Microsoft packages left a tree no application could
+ * repair from its own `package.json` — the conflict came from two packages we
+ * publish. One dependency for one object literal was not a trade worth
+ * keeping, three times over.
+ *
+ * `defineChannelTool` accepts any Standard Schema, and `toJsonSchema()` reads
+ * `~standard.jsonSchema.input()` in preference to every other path, so this
+ * one small object is all a tool ever needed.
+ *
+ * Behavior mirrors the `z.object({[name]: z.string().min(1).describe(...)})`
+ * it replaces: the field is required, must be a string of at least one
+ * character, and unknown keys are stripped rather than rejected (Zod's
+ * default `strip` mode for `z.object`). The emitted document is what
+ * `zod-to-json-schema` emitted for that object, so the descriptor the model
+ * is shown does not change. Its body is target-agnostic — `type`,
+ * `properties`, `required`, `minLength` and `additionalProperties` mean the
+ * same thing in draft-07 and draft-2020-12 — so one document serves every
+ * target a caller asks for, and `$schema` keeps the draft-07 value the
+ * previous output carried.
+ *
+ * The one-character floor is fixed rather than configurable because all three
+ * call sites want it and a knob nobody turns is a knob nobody tests.
+ */
+export function singleStringParameterSchema(options) {
+    // `SingleLiteral<Name>` is a deferred conditional type, so TypeScript cannot
+    // prove it reduces to `Name` inside the body. It does for every value that
+    // reaches here, because any other value is a compile error at the call.
+    const { name, description } = options;
+    // Built per call, never shared. `zodToJsonSchema` returned a fresh document
+    // every time, and `toAgentToolDescriptors` hands its result straight to the
+    // caller. A single shared object would let one consumer's in-place edit —
+    // stripping `$schema` for a provider that rejects it, say — silently change
+    // what every later turn in the process is shown.
+    const buildJsonSchema = () => ({
+        type: "object",
+        properties: {
+            [name]: { type: "string", minLength: 1, description },
+        },
+        required: [name],
+        additionalProperties: false,
+        $schema: "http://json-schema.org/draft-07/schema#",
+    });
+    function validate(value) {
+        if (typeof value !== "object" || value === null || Array.isArray(value)) {
+            return {
+                issues: [
+                    { message: "Expected object, received " + parsedTypeOf(value) },
+                ],
+            };
+        }
+        const field = value[name];
+        // Zod reports a missing required key as "Required", not as a type
+        // mismatch against `undefined`. The agent reads this back when it calls
+        // the tool with no argument, which is the most common bad call there is.
+        if (field === undefined) {
+            return { issues: [{ message: "Required", path: [name] }] };
+        }
+        if (typeof field !== "string") {
+            return {
+                issues: [
+                    {
+                        message: "Expected string, received " + parsedTypeOf(field),
+                        path: [name],
+                    },
+                ],
+            };
+        }
+        if (field.length < 1) {
+            return {
+                issues: [
+                    {
+                        message: "String must contain at least 1 character(s)",
+                        path: [name],
+                    },
+                ],
+            };
+        }
+        // Rebuilt rather than returned as-is: this is what strips unknown keys.
+        return { value: { [name]: field } };
+    }
+    return {
+        "~standard": {
+            version: 1,
+            // The Standard Schema `vendor` names the library that produced the
+            // schema, and that library is this one whichever adapter calls it.
+            // Consumers branch on this tag — `isZodSchema` in `@copilotkit/runtime`
+            // is one — so three different tags for one implementation would be three
+            // things to teach such a branch about.
+            vendor: "@copilotkit/channels-core",
+            validate,
+            jsonSchema: {
+                input: buildJsonSchema,
+                output: buildJsonSchema,
+            },
+        },
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@copilotkit/channels-core",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "Platform-agnostic JSX channel engine for CopilotKit (createChannel, Thread, PlatformAdapter, ActionStore).",
   "license": "MIT",
   "repository": {
@@ -51,9 +51,9 @@
     "@ag-ui/client": "0.0.59",
     "@ag-ui/core": "0.0.59",
     "zod-to-json-schema": "^3.24.1",
-    "@copilotkit/channels-ui": "~0.10.0",
-    "@copilotkit/core": "^1.71.2",
-    "@copilotkit/shared": "^1.71.2"
+    "@copilotkit/core": "^1.73.1",
+    "@copilotkit/channels-ui": "~0.11.0",
+    "@copilotkit/shared": "^1.73.1"
   },
   "devDependencies": {
     "@types/node": "^22.10.0",