@copilotkit/channels-core 0.6.0 → 0.6.2-canary.1785779327

package/README.md

@@ -189,6 +189,43 @@ methods (e.g. `thread.getMessages()`, `thread.lookupUser(query)`,
 A `ContextEntry` is `{ description: string; value: string }` — knowledge
 folded into the agent's system context on each `runAgent`.
 
+## Agent-rendered components
+
+`defineChannelComponent` turns a server-rendered JSX function into an agent
+tool. Its Standard Schema validates tool args before `render` runs. The render
+context supplies the source `platform` and the run's `AbortSignal`.
+
+```tsx
+import { createChannel, defineChannelComponent } from "@copilotkit/channels";
+import { z } from "zod";
+
+const Approval = defineChannelComponent({
+  name: "show_approval",
+  description: "Post an approval request.",
+  parameters: z.object({ title: z.string() }),
+  render: ({ title }, { platform, signal }) => (
+    <Card title={`${title} (${platform})`}>
+      <Button key="approve" value="approve" onClick={approve}>
+        Approve
+      </Button>
+    </Card>
+  ),
+});
+
+const channel = createChannel({
+  name: "approvals",
+  components: [Approval],
+});
+```
+
+When the agent calls `show_approval`, Channels posts the rendered message as a
+separate provider message and returns a short tool acknowledgement. The agent
+run then continues. Interactive nodes in a component definition need stable,
+unique JSX keys. Channels stores those keys with the source platform and action
+value, so a click or reaction can recover the same handler after a restart.
+Legacy `components: { Name: Component }` registrations still use positional
+recovery for old snapshots.
+
 ## ActionStore
 
 Inline JSX handlers are bound by content. Each interactive node gets a

package/dist/action-registry.d.ts

@@ -1,4 +1,5 @@
-import type { ChannelNode, InteractionContext, ComponentFn, Renderable, MessageReactionHandler } from "@copilotkit/channels-ui";
+import type { ChannelNode, InteractionContext, Renderable, MessageReactionHandler } from "@copilotkit/channels-ui";
+import type { ChannelComponentRenderContext } from "./channel-component.js";
 import type { ActionContinuationContext, ActionContinuationBinding, ActionContinuationSnapshot, ActionStore } from "./action-store.js";
 export declare class ActionExpiredError extends Error {
     readonly code = "channel_action_expired";
@@ -31,6 +32,7 @@ export declare class ActionRegistry {
         component: string;
         props: Record<string, unknown>;
         conversationKey: string;
+        platform?: string;
     }): Promise<void>;
     /**
      * Resolve the `onReaction` handler for `messageId`: the hot cache first, then
@@ -39,10 +41,22 @@ export declare class ActionRegistry {
      * handler whose closure can't be re-derived after a restart.
      */
     resolveMessageReaction(messageId: string): Promise<MessageReactionHandler | undefined>;
-    registerComponent(name: string, fn: ComponentFn): void;
+    registerComponent(name: string, fn: (props: Record<string, unknown>, context: ChannelComponentRenderContext) => Renderable | Promise<Renderable>, options?: {
+        requireKeys?: boolean;
+    }): void;
     clearHotCache(): void;
-    bindTree(componentName: string, props: Record<string, unknown>, conversationKey: string, continuation?: ActionContinuationContext): Promise<ChannelNode[]>;
-    bindRenderable(ui: Renderable, conversationKey: string, continuation?: ActionContinuationContext): Promise<{
+    bindTree(componentName: string, props: Record<string, unknown>, conversationKey: string, continuation?: ActionContinuationContext, renderContext?: ChannelComponentRenderContext): Promise<ChannelNode[]>;
+    /** Bind a named component and detach its root reaction for message routing. */
+    bindRegisteredRenderable(componentName: string, props: Record<string, unknown>, conversationKey: string, continuation: ActionContinuationContext | undefined, renderContext: ChannelComponentRenderContext): Promise<{
+        root: ChannelNode[];
+        onReaction?: MessageReactionHandler;
+        reactionComponent?: {
+            component: string;
+            props: Record<string, unknown>;
+            platform: string;
+        };
+    }>;
+    bindRenderable(ui: Renderable, conversationKey: string, continuation?: ActionContinuationContext, renderContext?: ChannelComponentRenderContext): Promise<{
         root: ChannelNode[];
         onReaction?: MessageReactionHandler;
         /**
@@ -53,9 +67,14 @@ export declare class ActionRegistry {
         reactionComponent?: {
             component: string;
             props: Record<string, unknown>;
+            platform: string;
         };
     }>;
     private walk;
+    /** Traverse children and provider-native named slots through one path model. */
+    private walkValue;
+    /** Bind one node reached through a singular provider-native slot. */
+    private walkNode;
     /**
      * Run the click handler for `id` and return the clicked element's `value`
      * (so callers can resolve a HITL `awaitChoice` waiter even when the platform

package/dist/action-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"action-registry.d.ts","sourceRoot":"","sources":["../src/action-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EAEX,kBAAkB,EAClB,WAAW,EACX,UAAU,EACV,sBAAsB,EACvB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,KAAK,EACV,yBAAyB,EACzB,yBAAyB,EACzB,0BAA0B,EAC1B,WAAW,EACZ,MAAM,mBAAmB,CAAC;AAE3B,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,4BAA4B;gBAE7B,EAAE,EAAE,MAAM;CAIvB;AAED,mFAAmF;AACnF,qBAAa,+BAAgC,SAAQ,KAAK;IACxD,QAAQ,CAAC,IAAI,mCAAmC;;CAMjD;AAcD,qBAAa,cAAc;IACzB,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,UAAU,CAAkC;IAKpD,OAAO,CAAC,GAAG,CAGP;IAIJ,OAAO,CAAC,gBAAgB,CAA6C;IAErE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAS;gBAE1B,IAAI,EAAE;QAAE,KAAK,EAAE,WAAW,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE;IAK9D,oFAAoF;IACpF,uBAAuB,CACrB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,sBAAsB,GAC9B,IAAI;IAIP;;;;;OAKG;IACG,sBAAsB,CAC1B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE;QACJ,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC/B,eAAe,EAAE,MAAM,CAAC;KACzB,GACA,OAAO,CAAC,IAAI,CAAC;IAShB;;;;;OAKG;IACG,sBAAsB,CAC1B,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,sBAAsB,GAAG,SAAS,CAAC;IAa9C,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,WAAW,GAAG,IAAI;IAItD,aAAa,IAAI,IAAI;IAMf,QAAQ,CACZ,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,eAAe,EAAE,MAAM,EACvB,YAAY,CAAC,EAAE,yBAAyB,GACvC,OAAO,CAAC,WAAW,EAAE,CAAC;IAqBnB,cAAc,CAClB,EAAE,EAAE,UAAU,EACd,eAAe,EAAE,MAAM,EACvB,YAAY,CAAC,EAAE,yBAAyB,GACvC,OAAO,CAAC;QACT,IAAI,EAAE,WAAW,EAAE,CAAC;QACpB,UAAU,CAAC,EAAE,sBAAsB,CAAC;QACpC;;;;WAIG;QACH,iBAAiB,CAAC,EAAE;YAAE,SAAS,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;SAAE,CAAC;KAC3E,CAAC;YA4BY,IAAI;IAsDlB;;;;;OAKG;IACG,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC;IA2BrE,0EAA0E;IACpE,eAAe,CACnB,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,yBAAyB,GAClC,OAAO,CAAC,0BAA0B,CAAC;IAOtC,mEAAmE;IAC7D,iBAAiB,CACrB,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,yBAAyB,GAClC,OAAO,CAAC,0BAA0B,CAAC;CASvC"}
+{"version":3,"file":"action-registry.d.ts","sourceRoot":"","sources":["../src/action-registry.ts"],"names":[],"mappings":"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"}

package/dist/action-registry.js

@@ -54,6 +54,7 @@ export class ActionRegistry {
             props: snap.props,
             path: [],
             conversationKey: snap.conversationKey,
+            platform: snap.platform,
         });
     }
     /**
@@ -69,26 +70,52 @@ export class ActionRegistry {
         const snap = await this.store.get(reactionKey(messageId));
         if (!snap?.component)
             return undefined;
-        const fn = this.components.get(snap.component);
-        if (!fn)
+        const registered = this.components.get(snap.component);
+        if (!registered)
             return undefined;
-        const root = renderToIR(fn(snap.props));
+        const root = renderToIR(await registered.render(snap.props, {
+            platform: (snap.platform ??
+                "slack"),
+            signal: new AbortController().signal,
+        }));
         return takeMessageReaction(root);
     }
-    registerComponent(name, fn) {
-        this.components.set(name, fn);
+    registerComponent(name, fn, options = {}) {
+        this.components.set(name, {
+            render: fn,
+            requireKeys: options.requireKeys ?? false,
+        });
     }
     clearHotCache() {
         this.hot.clear();
     }
     // Renders the named component, binds all event-prop handlers in the tree
     // (mint id, hot-cache + ActionStore snapshot, rewrite prop to { id }), returns the bound IR.
-    async bindTree(componentName, props, conversationKey, continuation) {
-        const fn = this.components.get(componentName);
-        const root = renderToIR((fn ? fn(props) : props));
-        await this.walk(root, [], componentName, props, conversationKey, continuation);
+    async bindTree(componentName, props, conversationKey, continuation, renderContext = {
+        platform: "slack",
+        signal: new AbortController().signal,
+    }) {
+        const registered = this.components.get(componentName);
+        const rendered = registered
+            ? await registered.render(props, renderContext)
+            : props;
+        const root = renderToIR(rendered);
+        const interactiveKeys = new Set();
+        await this.walk(root, [], componentName, props, conversationKey, continuation, registered?.requireKeys ?? false, renderContext.platform, interactiveKeys);
         return root;
     }
+    /** Bind a named component and detach its root reaction for message routing. */
+    async bindRegisteredRenderable(componentName, props, conversationKey, continuation, renderContext) {
+        const root = await this.bindTree(componentName, props, conversationKey, continuation, renderContext);
+        const onReaction = takeMessageReaction(root);
+        return {
+            root,
+            onReaction,
+            reactionComponent: onReaction
+                ? { component: componentName, props, platform: renderContext.platform }
+                : undefined,
+        };
+    }
     // Binds an arbitrary Renderable for posting. If `ui` is a component element
     // (`{ type: fn, props }`), it is registered + bound by name (cold-path
     // re-render supported). Otherwise the IR is bound inline with `component:""`,
@@ -96,7 +123,10 @@ export class ActionRegistry {
     // degradation for inline handlers that can't be re-derived). A top-level
     // `<Message onReaction>` handler is pulled off the IR (so it never reaches the
     // adapter) and returned for the caller to associate with the posted message.
-    async bindRenderable(ui, conversationKey, continuation) {
+    async bindRenderable(ui, conversationKey, continuation, renderContext = {
+        platform: "slack",
+        signal: new AbortController().signal,
+    }) {
         let root;
         let component;
         let props;
@@ -104,31 +134,50 @@ export class ActionRegistry {
             const fn = ui.type;
             component = fn.name || "anonymous";
             props = (ui.props ?? {});
-            this.registerComponent(component, fn);
-            root = await this.bindTree(component, props, conversationKey, continuation);
+            this.registerComponent(component, (componentProps) => fn(componentProps));
+            root = await this.bindTree(component, props, conversationKey, continuation, {
+                platform: renderContext.platform,
+                signal: renderContext.signal,
+            });
         }
         else {
             root = renderToIR(ui);
-            await this.walk(root, [], "", undefined, conversationKey, continuation);
+            await this.walk(root, [], "", undefined, conversationKey, continuation, false, renderContext.platform, new Set());
         }
         const onReaction = takeMessageReaction(root);
         return {
             root,
             onReaction,
-            reactionComponent: onReaction && component && props ? { component, props } : undefined,
+            reactionComponent: onReaction && component && props
+                ? { component, props, platform: renderContext.platform }
+                : undefined,
         };
     }
-    async walk(nodes, base, comp, props, conv, continuation) {
+    async walk(nodes, base, comp, props, conv, continuation, requireKeys, platform, interactiveKeys, exactPath) {
         for (let i = 0; i < nodes.length; i++) {
             const node = nodes[i];
-            const path = [...base, i];
+            const path = exactPath ?? [...base, i];
+            const eventProps = EVENT_PROPS.filter((eventProp) => typeof node.props[eventProp] === "function");
+            if (requireKeys && eventProps.length > 0) {
+                if (node.key === undefined ||
+                    (typeof node.key === "string" && node.key.trim().length === 0)) {
+                    throw new Error(`${formatComponentPath(comp, path)}.${eventProps[0]} requires a non-empty JSX key`);
+                }
+                if (interactiveKeys.has(node.key)) {
+                    throw new Error(`duplicate interactive JSX key "${node.key}"`);
+                }
+                interactiveKeys.add(node.key);
+            }
             for (const ep of EVENT_PROPS) {
                 const handler = node.props[ep];
                 if (typeof handler === "function") {
                     const fullPath = [...path, ep];
+                    const locator = requireKeys && node.key !== undefined
+                        ? { key: node.key, eventProp: ep }
+                        : undefined;
                     const id = continuation
                         ? `ck:${globalThis.crypto.randomUUID()}`
-                        : mintId(comp, fullPath, props);
+                        : mintId(comp, locator ? [locator.key, locator.eventProp] : fullPath, props);
                     this.hot.set(id, {
                         handler: handler,
                         value: node.props.value,
@@ -138,6 +187,9 @@ export class ActionRegistry {
                         component: comp,
                         props,
                         path: fullPath,
+                        ...(locator ? { locator } : {}),
+                        platform,
+                        actionValue: node.props.value,
                         conversationKey: conv,
                         boundArgs: isBound(handler) ? getBoundArgs(handler) : undefined,
                         ...(continuation
@@ -147,12 +199,29 @@ export class ActionRegistry {
                     node.props[ep] = { id };
                 }
             }
-            const children = node.props.children;
-            if (Array.isArray(children)) {
-                await this.walk(children, [...path, "children"], comp, props, conv, continuation);
+            for (const [propName, propValue] of Object.entries(node.props)) {
+                if (EVENT_PROPS.includes(propName))
+                    continue;
+                await this.walkValue(propValue, [...path, propName], comp, props, conv, continuation, requireKeys, platform, interactiveKeys);
             }
         }
     }
+    /** Traverse children and provider-native named slots through one path model. */
+    async walkValue(value, path, comp, props, conv, continuation, requireKeys, platform, interactiveKeys) {
+        if (isChannelNode(value)) {
+            await this.walkNode(value, path, comp, props, conv, continuation, requireKeys, platform, interactiveKeys);
+            return;
+        }
+        if (!Array.isArray(value))
+            return;
+        for (let index = 0; index < value.length; index++) {
+            await this.walkValue(value[index], [...path, index], comp, props, conv, continuation, requireKeys, platform, interactiveKeys);
+        }
+    }
+    /** Bind one node reached through a singular provider-native slot. */
+    async walkNode(node, path, comp, props, conv, continuation, requireKeys, platform, interactiveKeys) {
+        await this.walk([node], [], comp, props, conv, continuation, requireKeys, platform, interactiveKeys, path);
+    }
     /**
      * Run the click handler for `id` and return the clicked element's `value`
      * (so callers can resolve a HITL `awaitChoice` waiter even when the platform
@@ -175,16 +244,26 @@ export class ActionRegistry {
             const snap = await this.store.get(id);
             if (!snap || !snap.component)
                 throw new ActionExpiredError(id);
-            const fn = this.components.get(snap.component);
-            if (!fn)
+            const registered = this.components.get(snap.component);
+            if (!registered)
                 throw new ActionExpiredError(id);
-            const tree = renderToIR(fn(snap.props));
-            handler = pluck(tree, snap.path);
-            value = pluckValue(tree, snap.path);
+            const tree = renderToIR(await registered.render(snap.props, {
+                platform: (snap.platform ??
+                    ctx.platform),
+                signal: new AbortController().signal,
+            }));
+            handler = snap.locator
+                ? findHandlerByLocator(tree, snap.locator)
+                : pluck(tree, snap.path);
+            value = snap.locator ? snap.actionValue : pluckValue(tree, snap.path);
             if (!handler)
                 throw new ActionExpiredError(id);
         }
-        await handler({ ...ctx, action: { ...ctx.action, id } });
+        const actionValue = value === undefined ? ctx.action.value : value;
+        await handler({
+            ...ctx,
+            action: { ...ctx.action, id, value: actionValue },
+        });
         return value;
     }
     /** Read and validate one continuation capability without consuming it. */
@@ -219,6 +298,40 @@ function assertContinuationBinding(actual, actionId, expected) {
         throw new ActionContinuationMismatchError();
     }
 }
+function isChannelNode(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "type" in value &&
+        "props" in value &&
+        typeof value.props === "object" &&
+        value.props !== null);
+}
+function formatComponentPath(component, path) {
+    return path.reduce((result, segment) => typeof segment === "number"
+        ? `${result}[${segment}]`
+        : `${result}.${segment}`, component);
+}
+function findHandlerByLocator(tree, locator) {
+    const matches = [];
+    const visit = (value) => {
+        if (Array.isArray(value)) {
+            for (const item of value)
+                visit(item);
+            return;
+        }
+        if (!isChannelNode(value))
+            return;
+        if (value.key === locator.key) {
+            const handler = value.props[locator.eventProp];
+            if (typeof handler === "function")
+                matches.push(handler);
+        }
+        for (const propValue of Object.values(value.props))
+            visit(propValue);
+    };
+    visit(tree);
+    return matches.length === 1 ? matches[0] : undefined;
+}
 /** Store key for a message's durable reaction snapshot (distinct from minted action ids). */
 function reactionKey(messageId) {
     return `reaction:${messageId}`;

package/dist/action-store.d.ts

@@ -22,6 +22,12 @@ export interface ActionSnapshot {
     component?: string;
     props?: unknown;
     path: (string | number)[];
+    locator?: {
+        key: string | number;
+        eventProp: "onClick" | "onSelect" | "onSubmit";
+    };
+    platform?: string;
+    actionValue?: unknown;
     boundArgs?: unknown;
     conversationKey: string;
     continuation?: ActionContinuationSnapshot;

package/dist/action-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"action-store.d.ts","sourceRoot":"","sources":["../src/action-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE9E,iEAAiE;AACjE,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,eAAe,GAAG,IAAI,CAAC;IAC7B,KAAK,EAAE,aAAa,CAAC;CACtB;AAED,gFAAgF;AAChF,MAAM,WAAW,yBAAyB;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,2BAA2B,CAAC;CACxC;AAED,+EAA+E;AAC/E,MAAM,MAAM,yBAAyB,GAAG,IAAI,CAC1C,yBAAyB,EACzB,aAAa,GAAG,iBAAiB,GAAG,UAAU,CAC/C,CAAC;AAEF,8EAA8E;AAC9E,MAAM,WAAW,0BAA2B,SAAQ,yBAAyB;IAC3E,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,0BAA0B,CAAC;CAC3C;AACD,iHAAiH;AACjH,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrE,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAAC;IACrD,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAAC;IACzD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC;AACD,iHAAiH;AACjH,qBAAa,mBAAoB,YAAW,WAAW;IACrD,OAAO,CAAC,GAAG,CAAmE;IACxE,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMpE,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;IASpD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAGjC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;CAU/D"}
+{"version":3,"file":"action-store.d.ts","sourceRoot":"","sources":["../src/action-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE9E,iEAAiE;AACjE,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,eAAe,GAAG,IAAI,CAAC;IAC7B,KAAK,EAAE,aAAa,CAAC;CACtB;AAED,gFAAgF;AAChF,MAAM,WAAW,yBAAyB;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,2BAA2B,CAAC;CACxC;AAED,+EAA+E;AAC/E,MAAM,MAAM,yBAAyB,GAAG,IAAI,CAC1C,yBAAyB,EACzB,aAAa,GAAG,iBAAiB,GAAG,UAAU,CAC/C,CAAC;AAEF,8EAA8E;AAC9E,MAAM,WAAW,0BAA2B,SAAQ,yBAAyB;IAC3E,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IAC1B,OAAO,CAAC,EAAE;QACR,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;QACrB,SAAS,EAAE,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC;KAChD,CAAC;IACF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,0BAA0B,CAAC;CAC3C;AACD,iHAAiH;AACjH,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrE,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAAC;IACrD,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAAC;IACzD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC;AACD,iHAAiH;AACjH,qBAAa,mBAAoB,YAAW,WAAW;IACrD,OAAO,CAAC,GAAG,CAAmE;IACxE,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMpE,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;IASpD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAGjC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;CAU/D"}

package/dist/channel-component.d.ts

@@ -0,0 +1,18 @@
+import type { Renderable } from "@copilotkit/channels-ui";
+import type { InferSchemaOutput, ObjectSchema } from "./standard-schema.js";
+export type ChannelComponentPlatform = "slack" | "teams" | "discord" | "telegram" | "whatsapp";
+export interface ChannelComponentRenderContext {
+    platform: ChannelComponentPlatform;
+    signal: AbortSignal;
+}
+export interface ChannelComponentDefinition<Schema extends ObjectSchema = ObjectSchema> {
+    name: string;
+    description: string;
+    parameters: Schema;
+    render(props: InferSchemaOutput<Schema>, context: ChannelComponentRenderContext): Renderable | Promise<Renderable>;
+}
+/** Define an agent-rendered Channel component with schema-inferred props. */
+export declare function defineChannelComponent<Schema extends ObjectSchema>(component: ChannelComponentDefinition<Schema>): ChannelComponentDefinition<Schema>;
+/** Distinguish component-tool descriptors from legacy JSX component functions. */
+export declare function isChannelComponentDefinition(value: unknown): value is ChannelComponentDefinition;
+//# sourceMappingURL=channel-component.d.ts.map

package/dist/channel-component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-component.d.ts","sourceRoot":"","sources":["../src/channel-component.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAE5E,MAAM,MAAM,wBAAwB,GAChC,OAAO,GACP,OAAO,GACP,SAAS,GACT,UAAU,GACV,UAAU,CAAC;AAEf,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,EAAE,wBAAwB,CAAC;IACnC,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,MAAM,WAAW,0BAA0B,CACzC,MAAM,SAAS,YAAY,GAAG,YAAY;IAE1C,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CACJ,KAAK,EAAE,iBAAiB,CAAC,MAAM,CAAC,EAChC,OAAO,EAAE,6BAA6B,GACrC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CACrC;AAED,6EAA6E;AAC7E,wBAAgB,sBAAsB,CAAC,MAAM,SAAS,YAAY,EAChE,SAAS,EAAE,0BAA0B,CAAC,MAAM,CAAC,GAC5C,0BAA0B,CAAC,MAAM,CAAC,CAEpC;AAED,kFAAkF;AAClF,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,0BAA0B,CAWrC"}

package/dist/channel-component.js

@@ -0,0 +1,13 @@
+/** Define an agent-rendered Channel component with schema-inferred props. */
+export function defineChannelComponent(component) {
+    return component;
+}
+/** Distinguish component-tool descriptors from legacy JSX component functions. */
+export function isChannelComponentDefinition(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        typeof value.name === "string" &&
+        typeof value.description === "string" &&
+        typeof value.render === "function" &&
+        typeof value.parameters?.["~standard"] === "object");
+}

package/dist/channel-component.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=channel-component.test.d.ts.map

package/dist/channel-component.test.d.ts.map

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

package/dist/channel-component.test.js

@@ -0,0 +1,120 @@
+import { Section } from "@copilotkit/channels-ui";
+import { z } from "zod";
+import { expect, test, vi } from "vitest";
+import { createChannel } from "./create-channel.js";
+import { defineChannelComponent } from "./channel-component.js";
+import { FakeAdapter } from "./testing/fake-adapter.js";
+import { FakeAgent } from "./testing/fake-agent.js";
+function setup(args) {
+    const adapter = new FakeAdapter({ platform: "intelligence" });
+    let iterations = 0;
+    const agent = new FakeAgent([
+        (subscriber) => {
+            iterations += 1;
+            subscriber.onToolCallEndEvent?.({
+                event: { toolCallId: "component-call-1" },
+                toolCallName: args.component.name,
+                toolCallArgs: args.toolArgs ?? {},
+            });
+        },
+        () => {
+            iterations += 1;
+        },
+    ]);
+    const channel = createChannel({
+        identifyUser: "platform",
+        adapters: [adapter],
+        agent: () => agent,
+        components: [args.component],
+    });
+    channel.onMessage(async ({ thread }) => {
+        await thread.runAgent();
+    });
+    return {
+        adapter,
+        channel,
+        iterations: () => iterations,
+        async run() {
+            await channel.ɵruntime.start();
+            await adapter.getSink().onTurn({
+                conversationKey: "conversation-1",
+                replyTarget: {},
+                userText: "show the order",
+                platform: args.platform ?? "slack",
+            });
+        },
+    };
+}
+test("a channel component validates args, renders asynchronously, and posts through the thread", async () => {
+    const render = vi.fn(async (props, context) => {
+        await Promise.resolve();
+        return Section({
+            children: `${context.platform}:${props.orderId}:${context.signal.aborted}`,
+        });
+    });
+    const component = defineChannelComponent({
+        name: "show_order",
+        description: "Show one order",
+        parameters: z.object({ orderId: z.string() }),
+        render,
+    });
+    const harness = setup({
+        component,
+        platform: "teams",
+        toolArgs: { orderId: "order-42" },
+    });
+    await harness.run();
+    expect(render).toHaveBeenCalledWith({ orderId: "order-42" }, { platform: "teams", signal: expect.any(AbortSignal) });
+    expect(harness.adapter.posted).toEqual([
+        [
+            {
+                type: "section",
+                props: {
+                    children: [
+                        {
+                            type: "text",
+                            props: { value: "teams:order-42:false" },
+                        },
+                    ],
+                },
+            },
+        ],
+    ]);
+    expect(harness.iterations()).toBe(2);
+});
+test("invalid component arguments do not render or post", async () => {
+    const render = vi.fn(() => Section({ children: "should not render" }));
+    const component = defineChannelComponent({
+        name: "show_order",
+        description: "Show one order",
+        parameters: z.object({ orderId: z.string() }),
+        render,
+    });
+    const harness = setup({ component, toolArgs: { orderId: 42 } });
+    await harness.run();
+    expect(render).not.toHaveBeenCalled();
+    expect(harness.adapter.posted).toEqual([]);
+    expect(harness.iterations()).toBe(2);
+});
+test("channel start rejects component and tool name collisions", async () => {
+    const component = defineChannelComponent({
+        name: "show_order",
+        description: "Show one order",
+        parameters: z.object({}),
+        render: () => Section({ children: "order" }),
+    });
+    const channel = createChannel({
+        identifyUser: "platform",
+        adapters: [new FakeAdapter()],
+        components: [component],
+        tools: [
+            {
+                name: "show_order",
+                description: "Conflicting tool",
+                parameters: z.object({}),
+                handler: () => "conflict",
+            },
+        ],
+    });
+    await expect(channel.ɵruntime.start()).rejects.toThrow('duplicate channel tool or component name "show_order"');
+});

package/dist/component-reaction-recovery.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=component-reaction-recovery.test.d.ts.map

package/dist/component-reaction-recovery.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-reaction-recovery.test.d.ts","sourceRoot":"","sources":["../src/component-reaction-recovery.test.ts"],"names":[],"mappings":""}

package/dist/component-reaction-recovery.test.js

@@ -0,0 +1,29 @@
+import { expect, test } from "vitest";
+import { Message } from "@copilotkit/channels-ui";
+import { ActionRegistry } from "./action-registry.js";
+import { InMemoryActionStore } from "./action-store.js";
+const reactionHandler = () => undefined;
+test("registered component reactions recover with their source platform", async () => {
+    const store = new InMemoryActionStore();
+    const renderPlatforms = [];
+    const register = (registry) => {
+        registry.registerComponent("deployment", (_props, context) => {
+            renderPlatforms.push(context.platform);
+            return Message({ children: "done", onReaction: reactionHandler });
+        });
+    };
+    const first = new ActionRegistry({ store });
+    register(first);
+    const bound = await first.bindRegisteredRenderable("deployment", {}, "conversation-1", undefined, { platform: "teams", signal: new AbortController().signal });
+    expect(bound.onReaction).toBe(reactionHandler);
+    await first.persistMessageReaction("message-1", {
+        component: "deployment",
+        props: {},
+        conversationKey: "conversation-1",
+        platform: "teams",
+    });
+    const restarted = new ActionRegistry({ store });
+    register(restarted);
+    expect(await restarted.resolveMessageReaction("message-1")).toBe(reactionHandler);
+    expect(renderPlatforms).toEqual(["teams", "teams"]);
+});

package/dist/create-channel.d.ts

@@ -10,6 +10,7 @@ import { Transcripts } from "./transcripts.js";
 import type { TranscriptsConfig } from "./transcripts.js";
 import type { ChannelIdentifyUser } from "./identity.js";
 import type { StandardSchemaV1, InferSchemaOutput } from "./standard-schema.js";
+import type { ChannelComponentDefinition } from "./channel-component.js";
 export type LockConflictDecision = "drop" | "force";
 /**
  * How overlapping turns on the same `conversationKey` are handled.
@@ -43,7 +44,8 @@ export type ChannelConcurrency = "parallel" | "serial" | "drop";
  *
  * Fails loud on all three ways cloning can fail to isolate: a missing `clone()`,
  * a `clone()` that hands back the same object, and a `clone()` that silently
- * drops subclass state (see {@link assertCloneKeptOwnFields}).
+ * drops subclass state (see {@link warnOnCloneDroppedOwnFields}, which reports
+ * rather than refuses).
  */
 export declare function isolateAgentInstance(prototype: AbstractAgent, threadId: string): AbstractAgent;
 /**
@@ -62,6 +64,7 @@ export declare function resolveChannelConcurrency(cfg: {
  * with the props persisted in the store, so the specific shape isn't needed here.
  */
 export type ChannelComponent = (props: never) => ReturnType<ComponentFn>;
+export type ChannelComponentRegistration = ChannelComponent | ChannelComponentDefinition;
 export type ChannelHandler<TState = unknown> = (ctx: {
     thread: StatefulThread<TState>;
     message: ChannelMessage;
@@ -237,12 +240,11 @@ export interface CreateChannelOptions<TStateSchema extends StandardSchemaV1 | un
     tools?: ChannelTool[];
     context?: ContextEntry[];
     /**
-     * Named JSX components used in interactive messages. Registering them here
-     * lets the channel re-render and re-fire their handlers after a restart (durable
-     * actions); without registration, a click on a message posted before the
-     * restart degrades to "action expired".
+     * Agent-rendered component definitions or legacy named JSX components.
+     * Definitions become tools. Both forms let the channel recover keyed handlers
+     * after a restart when the configured store is durable.
      */
-    components?: ChannelComponent[];
+    components?: ChannelComponentRegistration[] | Record<string, ChannelComponent>;
     /** Slash commands. Forwarded to adapters that support them; ignored elsewhere. */
     commands?: ChannelCommand[];
     /** Persistence, per-thread state schema, transcripts, and lock/dedup tuning. */

package/dist/create-channel.d.ts.map

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

package/dist/create-channel.js

@@ -8,6 +8,7 @@ import { sanitizeAgentEventStream } from "./sanitize-agent-events.js";
 import { normalizeEmoji, toCanonicalEmoji, renderToIR, } from "@copilotkit/channels-ui";
 import { Transcripts } from "./transcripts.js";
 import { resolveChannelUser } from "./identity.js";
+import { isChannelComponentDefinition } from "./channel-component.js";
 import { ChannelTelemetry } from "./telemetry/channel-telemetry.js";
 import { errorClass, normalizePlatform } from "./telemetry/sanitize-error.js";
 import { createRequire } from "node:module";
@@ -58,7 +59,8 @@ function isEmojiPlatform(platform) {
  *
  * Fails loud on all three ways cloning can fail to isolate: a missing `clone()`,
  * a `clone()` that hands back the same object, and a `clone()` that silently
- * drops subclass state (see {@link assertCloneKeptOwnFields}).
+ * drops subclass state (see {@link warnOnCloneDroppedOwnFields}, which reports
+ * rather than refuses).
  */
 export function isolateAgentInstance(prototype, threadId) {
     if (typeof prototype.clone !== "function") {
@@ -70,7 +72,7 @@ export function isolateAgentInstance(prototype, threadId) {
     if (cloned == null || cloned === prototype) {
         throw new Error("createChannel: agent.clone() must return a distinct instance for concurrent turns");
     }
-    assertCloneKeptOwnFields(prototype, cloned);
+    warnOnCloneDroppedOwnFields(prototype, cloned);
     cloned.threadId = threadId;
     // `clone()` copies `isRunning` from the source, and a source that has already
     // run can be mid-run at the moment it is cloned. A fresh turn is not.
@@ -90,7 +92,7 @@ export function isolateAgentInstance(prototype, threadId) {
     return cloned;
 }
 /**
- * Fail loud when `clone()` silently drops subclass state.
+ * Report — but do not refuse — a `clone()` that drops subclass state.
  *
  * `AbstractAgent.prototype.clone()` copies a fixed field list, so a subclass
  * that declares its own fields (an auth client, config, a cache) gets them back
@@ -98,27 +100,49 @@ export function isolateAgentInstance(prototype, threadId) {
  * exists and returns a correctly-typed instance, nothing else surfaces it. The
  * agent just runs gutted.
  *
- * Comparing own enumerable keys catches exactly that and stays quiet for the
- * agents that do override `clone()` (`HttpAgent`, `LangGraphAgent`,
- * `BuiltInAgent`, `IntelligenceAgent`). Symbol-keyed and non-enumerable fields
- * are not covered.
+ * This used to throw. It no longer does, because whether a dropped field matters
+ * depends on what the field HOLDS, and from here the two cases are
+ * indistinguishable:
+ *
+ * - **Config** (`orchestrationAgentUrl`, an auth client) is read during the run
+ *   and never rewritten, so losing it does gut the agent.
+ * - **Per-run scratch state** is re-initialized at the start of every run, so
+ *   losing it changes nothing. `LangGraphAgent`'s `emittedToolCallStartIds` and
+ *   `eventsStreamActive` are exactly this: both are reset when a run binds its
+ *   subscriber, before anything reads them.
+ *
+ * Throwing on the second case took a Channel that works and refused every turn
+ * — while the identical clone happens on every ordinary runtime request
+ * (`agent-utils.ts` clones per request) with no ill effect at all, which is why
+ * it had never been noticed outside Channels. A warning keeps the signal for the
+ * config case without failing the harmless one.
+ *
+ * Deliberately NOT done: copying the dropped fields onto the clone. That would
+ * share one mutable object across concurrent turns, which is the exact hazard
+ * this isolation exists to prevent.
+ *
+ * Comparing own enumerable keys stays quiet for the agents that override
+ * `clone()` fully (`HttpAgent`, `BuiltInAgent`, `IntelligenceAgent`).
+ * Symbol-keyed and non-enumerable fields are not covered.
  *
  * Own *functions* are deliberately exempt. Assigning a method on the instance is
  * how spies and instrumentation wrap an agent, and losing that wrapper leaves
  * the class's prototype method intact — the clone still behaves correctly, it
  * just isn't wrapped. Only dropped state leaves an agent genuinely gutted.
  */
-function assertCloneKeptOwnFields(prototype, cloned) {
+function warnOnCloneDroppedOwnFields(prototype, cloned) {
     const source = prototype;
     const dropped = Object.keys(prototype).filter((key) => typeof source[key] !== "function" &&
         !Object.prototype.hasOwnProperty.call(cloned, key));
     if (dropped.length === 0)
         return;
     const name = prototype.constructor?.name ?? "the configured agent";
-    throw new Error(`createChannel: ${name}.clone() dropped ${dropped.join(", ")}. ` +
+    console.warn(`createChannel: ${name}.clone() dropped ${dropped.join(", ")}. ` +
         "Every turn runs on a clone, and AbstractAgent's clone() only copies its " +
-        `own fixed field list, so those fields would read as undefined. Override ` +
-        `clone() on ${name} to copy them (HttpAgent.clone() is the reference).`);
+        "own fixed field list, so those fields read as undefined on the clone. " +
+        "That is harmless for state a run re-initializes, and gutting for anything " +
+        `read as configuration — override clone() on ${name} to carry them if it is ` +
+        "the latter (HttpAgent.clone() is the reference).");
 }
 /**
  * Resolve effective turn concurrency from `store.concurrency` and legacy
@@ -256,8 +280,59 @@ export function createChannel(opts) {
         return run;
     }
     const toolMap = new Map();
-    for (const t of opts.tools ?? [])
-        toolMap.set(t.name, t);
+    let componentConfigurationError;
+    for (const tool of opts.tools ?? []) {
+        if (toolMap.has(tool.name)) {
+            componentConfigurationError = new Error(`duplicate channel tool or component name "${tool.name}"`);
+            continue;
+        }
+        toolMap.set(tool.name, tool);
+    }
+    const componentEntries = [];
+    const configuredComponents = Array.isArray(opts.components)
+        ? opts.components.map((component) => ({
+            name: component.name,
+            component,
+        }))
+        : Object.entries(opts.components ?? {}).map(([name, component]) => ({
+            name,
+            component,
+        }));
+    const componentNames = new Set();
+    for (const { name, component } of configuredComponents) {
+        if (!name)
+            continue;
+        if (componentNames.has(name) || toolMap.has(name)) {
+            componentConfigurationError = new Error(`duplicate channel tool or component name "${name}"`);
+            continue;
+        }
+        componentNames.add(name);
+        if (isChannelComponentDefinition(component)) {
+            componentEntries.push({
+                name,
+                requireKeys: true,
+                render: (props, renderContext) => component.render(props, renderContext),
+            });
+            toolMap.set(name, {
+                name,
+                description: component.description,
+                parameters: component.parameters,
+                async handler(args, toolContext) {
+                    await toolContext.thread.postRegisteredComponent(name, args, {
+                        platform: toolContext.platform,
+                        signal: toolContext.signal ?? new AbortController().signal,
+                    });
+                    return `Rendered component "${name}".`;
+                },
+            });
+            continue;
+        }
+        componentEntries.push({
+            name,
+            requireKeys: false,
+            render: (props) => component(props),
+        });
+    }
     const context = opts.context ?? [];
     const mentionHandlers = [];
     const messageHandlers = [];
@@ -681,6 +756,8 @@ export function createChannel(opts) {
                 // and real adapters would connect/port-bind twice.
                 if (started)
                     return;
+                if (componentConfigurationError)
+                    throw componentConfigurationError;
                 if (adapters.some((adapter) => adapter.capabilities.supportsMessageEvents) &&
                     mentionHandlers.length === 0 &&
                     messageHandlers.length === 0) {
@@ -706,20 +783,22 @@ export function createChannel(opts) {
                     retentionMs: cfg.actionRetentionMs ?? 7 * 24 * 60 * 60 * 1000,
                 });
                 registry = registryInstance;
-                for (const c of opts.components ?? []) {
-                    if (!c.name) {
+                for (const component of componentEntries) {
+                    if (!component.name) {
                         console.warn("[channel] createChannel: skipping anonymous component — give it a name to enable durable actions after restart.");
                         continue;
                     }
-                    registryInstance.registerComponent(c.name, c);
+                    registryInstance.registerComponent(component.name, component.render, {
+                        requireKeys: component.requireKeys,
+                    });
                 }
                 toolDescriptors = toAgentToolDescriptors([...toolMap.values()]);
                 tel.capture("oss.channel.configured", {
                     platforms: adapters.map((a) => normalizePlatform(a.platform)),
                     adapterCount: adapters.length,
                     store: storeKind(backend),
-                    hasComponents: (opts.components?.length ?? 0) > 0,
-                    componentsCount: opts.components?.length ?? 0,
+                    hasComponents: componentEntries.length > 0,
+                    componentsCount: componentEntries.length,
                     toolsCount: toolMap.size,
                     commandsCount: commandHandlers.size,
                     contextCount: context.length,

package/dist/create-channel.test.js

@@ -985,8 +985,9 @@ describe("createChannel", () => {
         // Nothing ever runs on the configured object, so it stays pristine.
         expect(shared.messages).toEqual([]);
     });
-    it("agent whose clone() drops subclass state fails loud", async () => {
+    it("agent whose clone() drops subclass state warns and still runs the turn", async () => {
         const state = new MemoryStore();
+        const warn = vi.spyOn(console, "warn").mockImplementation(() => undefined);
         // Inherits `FakeAgent.clone()`, which builds a plain `FakeAgent` and so
         // cannot carry this field — the same shape as a subclass inheriting
         // `AbstractAgent.prototype.clone()`, which copies a fixed field list.
@@ -1006,13 +1007,46 @@ describe("createChannel", () => {
         });
         await channel.ɵruntime.start();
         const sink = fake.getSink();
+        // Reports it, and does not refuse the turn: whether a dropped field matters
+        // depends on what it holds, and this cannot tell config from per-run state.
         await expect(sink.onTurn({
             conversationKey: "c1",
             replyTarget: {},
             userText: "hi",
             platform: "fake",
             eventId: "E1",
-        })).rejects.toThrow(/StatefulAgent\.clone\(\) dropped authClient/);
+        })).resolves.not.toThrow();
+        expect(warn).toHaveBeenCalledWith(expect.stringMatching(/StatefulAgent\.clone\(\) dropped authClient/));
+        warn.mockRestore();
+    });
+    it("the dropped-state warning names every field, once per turn", async () => {
+        const state = new MemoryStore();
+        const warn = vi.spyOn(console, "warn").mockImplementation(() => undefined);
+        class TwoFieldAgent extends FakeAgent {
+            authClient = { token: "secret" };
+            cache = new Map();
+        }
+        const fake = new FakeAdapter();
+        const channel = createChannel({
+            identifyUser: "platform",
+            adapters: [fake],
+            agent: () => new TwoFieldAgent(),
+            store: { adapter: state },
+        });
+        channel.onMention(async ({ thread }) => {
+            await thread.runAgent({ prompt: "hi" });
+        });
+        await channel.ɵruntime.start();
+        await fake.getSink().onTurn({
+            conversationKey: "c1",
+            replyTarget: {},
+            userText: "hi",
+            platform: "fake",
+            eventId: "E1",
+        });
+        expect(warn).toHaveBeenCalledTimes(1);
+        expect(warn).toHaveBeenCalledWith(expect.stringContaining("authClient, cache"));
+        warn.mockRestore();
     });
     it("does not fail loud when clone() drops an instance-patched method", async () => {
         const state = new MemoryStore();

package/dist/index.d.ts

@@ -2,7 +2,9 @@ export { createChannel } from "./create-channel.js";
 export { isolateAgentInstance, resolveChannelConcurrency, } from "./create-channel.js";
 export { sanitizeAgentEventStream } from "./sanitize-agent-events.js";
 export { HttpAgent } from "@ag-ui/client";
-export type { Channel, CreateChannelOptions, ReplyContinuationOptions, ChannelHandler, WelcomeHandler, ThreadStartHandler, ReactionEvent, ReactionHandler, ModalSubmitEvent, ModalSubmitHandler, ModalCloseEvent, ModalCloseHandler, StoreConfig, LockConflictDecision, ChannelConcurrency, StatefulThread, ChannelComponent, } from "./create-channel.js";
+export type { Channel, CreateChannelOptions, ReplyContinuationOptions, ChannelHandler, WelcomeHandler, ThreadStartHandler, ReactionEvent, ReactionHandler, ModalSubmitEvent, ModalSubmitHandler, ModalCloseEvent, ModalCloseHandler, StoreConfig, LockConflictDecision, ChannelConcurrency, StatefulThread, ChannelComponent, ChannelComponentRegistration, } from "./create-channel.js";
+export { defineChannelComponent } from "./channel-component.js";
+export type { ChannelComponentDefinition, ChannelComponentPlatform, ChannelComponentRenderContext, } from "./channel-component.js";
 export { ChannelIdentityResolutionError, ChannelIdentityResultError, resolveChannelUser, } from "./identity.js";
 export type { ChannelConversation, ChannelEvent, ChannelIdentifyUser, ChannelIdentityContext, ChannelInstallation, ChannelTenant, IngressIdentityContext, } from "./identity.js";
 export { Thread } from "./thread.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":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EACL,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAGtE,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,YAAY,EACV,OAAO,EACP,oBAAoB,EACpB,wBAAwB,EACxB,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,WAAW,EACX,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EAChB,4BAA4B,GAC7B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,YAAY,EACV,0BAA0B,EAC1B,wBAAwB,EACxB,6BAA6B,GAC9B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,8BAA8B,EAC9B,0BAA0B,EAC1B,kBAAkB,GACnB,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,mBAAmB,EACnB,YAAY,EACZ,mBAAmB,EACnB,sBAAsB,EACtB,mBAAmB,EACnB,aAAa,EACb,sBAAsB,GACvB,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAG9C,YAAY,EACV,eAAe,EACf,mBAAmB,EACnB,WAAW,EACX,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,WAAW,EACX,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,yBAAyB,EACzB,sBAAsB,EACtB,oBAAoB,EACpB,SAAS,EACT,aAAa,GACd,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,aAAa,GACd,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,cAAc,EACd,cAAc,EACd,WAAW,GACZ,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,YAAY,EACV,WAAW,EACX,cAAc,EACd,yBAAyB,EACzB,yBAAyB,EACzB,2BAA2B,EAC3B,0BAA0B,GAC3B,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,cAAc,EACd,+BAA+B,EAC/B,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAG9B,YAAY,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAMtD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,kCAAkC,EAAE,MAAM,qCAAqC,CAAC;AAGzF,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAG3E,OAAO,EACL,sBAAsB,EACtB,aAAa,EACb,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,WAAW,EACX,YAAY,EACZ,kBAAkB,EAClB,YAAY,EACZ,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAGvD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EACL,gCAAgC,EAChC,iCAAiC,EACjC,6BAA6B,EAC7B,8BAA8B,GAC/B,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,8BAA8B,EAC9B,gCAAgC,GACjC,MAAM,qBAAqB,CAAC;AAK7B,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGhD,OAAO,EACL,8BAA8B,EAC9B,eAAe,EACf,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,YAAY,EACZ,WAAW,EACX,qBAAqB,GACtB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAC7E,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAGpD,cAAc,yBAAyB,CAAC"}

package/dist/index.js

@@ -8,6 +8,7 @@ export { sanitizeAgentEventStream } from "./sanitize-agent-events.js";
 // The usual `agent` for a Channel is an AG-UI agent over HTTP. Re-exported so
 // wiring one up needs no second import (any `AbstractAgent` still works).
 export { HttpAgent } from "@ag-ui/client";
+export { defineChannelComponent } from "./channel-component.js";
 export { ChannelIdentityResolutionError, ChannelIdentityResultError, resolveChannelUser, } from "./identity.js";
 // Thread
 export { Thread } from "./thread.js";

package/dist/keyed-action-recovery.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=keyed-action-recovery.test.d.ts.map

package/dist/keyed-action-recovery.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyed-action-recovery.test.d.ts","sourceRoot":"","sources":["../src/keyed-action-recovery.test.tsx"],"names":[],"mappings":""}

package/dist/keyed-action-recovery.test.js

@@ -0,0 +1,121 @@
+import { jsx as _jsx } from "@copilotkit/channels-core/jsx-runtime";
+import { createNativeNode } from "@copilotkit/channels-ui";
+import { expect, test, vi } from "vitest";
+import { ActionRegistry } from "./action-registry.js";
+import { InMemoryActionStore } from "./action-store.js";
+function SlackButton(props) {
+    return createNativeNode("slack", "element", "button", props);
+}
+async function unusedChoice() {
+    throw new Error("awaitChoice is not used by this fixture");
+}
+async function emptyState() {
+    return undefined;
+}
+function interactionContext(id) {
+    const thread = {
+        platform: "slack",
+        post: async () => ({ id: "message-1" }),
+        update: async (ref) => ref,
+        delete: async () => undefined,
+        awaitChoice: unusedChoice,
+        runAgent: async () => undefined,
+        resume: async () => undefined,
+        stream: async () => ({ id: "message-1" }),
+        postFile: async () => ({ ok: true, fileId: "file-1" }),
+        getMessages: async () => [],
+        lookupUser: async () => undefined,
+        setSuggestedPrompts: async () => ({ ok: true }),
+        setTitle: async () => ({ ok: true }),
+        react: async () => ({ ok: true }),
+        unreact: async () => ({ ok: true }),
+        postEphemeral: async () => null,
+        subscribe: async () => undefined,
+        unsubscribe: async () => undefined,
+        isSubscribed: async () => false,
+        setState: async () => undefined,
+        state: emptyState,
+    };
+    const actor = { id: "user-1", kind: "human" };
+    return {
+        thread,
+        message: {
+            text: "",
+            user: null,
+            actor,
+            ref: { id: "message-1" },
+            platform: "slack",
+        },
+        action: { id, value: { decision: "provider-mutated" } },
+        values: {},
+        user: null,
+        actor,
+        platform: "slack",
+    };
+}
+function actionId(tree, key) {
+    const elements = tree[0]?.props.elements;
+    if (!Array.isArray(elements)) {
+        throw new Error("expected native action elements");
+    }
+    const node = elements.find((candidate) => typeof candidate === "object" &&
+        candidate !== null &&
+        "key" in candidate &&
+        candidate.key === key);
+    if (!node || typeof node !== "object" || !("props" in node)) {
+        throw new Error(`expected action with key ${key}`);
+    }
+    const handler = node.props.onClick;
+    if (typeof handler !== "object" ||
+        handler === null ||
+        !("id" in handler) ||
+        typeof handler.id !== "string") {
+        throw new Error(`expected bound action with key ${key}`);
+    }
+    return handler.id;
+}
+test("cold recovery finds the same keyed handler after async sibling reorder", async () => {
+    const store = new InMemoryActionStore();
+    const handled = vi.fn();
+    let reordered = false;
+    const render = async () => {
+        await Promise.resolve();
+        const approve = (_jsx(SlackButton, { text: "Approve", value: { decision: reordered ? "changed" : "approve" }, onClick: (context) => handled("approve", context.action.value) }, "approve-order"));
+        const reject = (_jsx(SlackButton, { text: "Reject", value: { decision: "reject" }, onClick: (context) => handled("reject", context.action.value) }, "reject-order"));
+        const unrelated = (_jsx(SlackButton, { text: "Inspect", value: { decision: "inspect" }, onClick: (context) => handled("inspect", context.action.value) }, "inspect-order"));
+        return createNativeNode("slack", "block", "actions", {
+            elements: reordered ? [unrelated, reject, approve] : [approve, reject],
+        });
+    };
+    const first = new ActionRegistry({ store });
+    first.registerComponent("order_actions", render, { requireKeys: true });
+    const tree = await first.bindTree("order_actions", {}, "conversation-1", undefined, { platform: "slack", signal: new AbortController().signal });
+    const id = actionId(tree, "approve-order");
+    reordered = true;
+    const restarted = new ActionRegistry({ store });
+    restarted.registerComponent("order_actions", render, {
+        requireKeys: true,
+    });
+    const value = await restarted.dispatch(id, interactionContext(id));
+    expect(value).toEqual({ decision: "approve" });
+    expect(handled).toHaveBeenCalledOnce();
+    expect(handled).toHaveBeenCalledWith("approve", { decision: "approve" });
+});
+test("component tools reject a handler without a stable JSX key", async () => {
+    const registry = new ActionRegistry({ store: new InMemoryActionStore() });
+    registry.registerComponent("missing_key", () => createNativeNode("slack", "element", "button", {
+        text: "Approve",
+        onClick: () => undefined,
+    }), { requireKeys: true });
+    await expect(registry.bindTree("missing_key", {}, "conversation-1")).rejects.toThrow("missing_key[0].onClick requires a non-empty JSX key");
+});
+test("component tools reject duplicate interactive keys", async () => {
+    const registry = new ActionRegistry({ store: new InMemoryActionStore() });
+    registry.registerComponent("duplicate_key", () => createNativeNode("slack", "block", "actions", {
+        elements: [
+            _jsx(SlackButton, { text: "Approve", value: { decision: "approve" }, onClick: () => undefined }, "decision"),
+            _jsx(SlackButton, { text: "Reject", value: { decision: "reject" }, onClick: () => undefined }, "decision"),
+        ],
+    }), { requireKeys: true });
+    await expect(registry.bindTree("duplicate_key", {}, "conversation-1")).rejects.toThrow('duplicate interactive JSX key "decision"');
+});

package/dist/thread.d.ts

@@ -7,6 +7,7 @@ import type { AbstractAgent } from "@ag-ui/client";
 import type { StateStore } from "./state/state-store.js";
 import type { StandardSchemaV1 } from "./standard-schema.js";
 import type { MemoryGrant } from "./memory.js";
+import type { ChannelComponentRenderContext } from "./channel-component.js";
 /** A Channel run requested Memory without an attached Intelligence backend. */
 export declare class ChannelMemoryUnavailableError extends Error {
     readonly code = "channel_memory_unavailable";
@@ -98,6 +99,8 @@ export declare class Thread implements ThreadInterface {
      */
     private bindReaction;
     post(ui: Renderable): Promise<MessageRef>;
+    /** @internal Post a registered component through the normal bind and adapter path. */
+    postRegisteredComponent(componentName: string, props: Record<string, unknown>, renderContext: ChannelComponentRenderContext): Promise<MessageRef>;
     update(ref: MessageRef, ui: Renderable): Promise<MessageRef>;
     delete(ref: MessageRef): Promise<void>;
     stream(src: string | AsyncIterable<string>): Promise<MessageRef>;

package/dist/thread.d.ts.map

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

package/dist/thread.js

@@ -64,7 +64,10 @@ export class Thread {
         this.store = deps.state;
     }
     async bindForPost(ui) {
-        return this.deps.registry.bindRenderable(ui, this.deps.conversationKey, this.activeContinuation);
+        return this.deps.registry.bindRenderable(ui, this.deps.conversationKey, this.activeContinuation, {
+            platform: this.platform,
+            signal: new AbortController().signal,
+        });
     }
     trackOperation(operation) {
         if (!this.deps.adapter.trackThreadOperation) {
@@ -107,6 +110,15 @@ export class Thread {
             return ref;
         });
     }
+    /** @internal Post a registered component through the normal bind and adapter path. */
+    postRegisteredComponent(componentName, props, renderContext) {
+        return this.trackOperation(async () => {
+            const bound = await this.deps.registry.bindRegisteredRenderable(componentName, props, this.deps.conversationKey, this.activeContinuation, renderContext);
+            const ref = await this.deps.adapter.post(this.deps.replyTarget, bound.root);
+            await this.bindReaction(ref.id, bound);
+            return ref;
+        });
+    }
     update(ref, ui) {
         return this.trackOperation(async () => {
             const bound = await this.bindForPost(ui);
@@ -478,6 +490,7 @@ export class Thread {
                         message: this.deps.message,
                         user: this.deps.user,
                         actor: this.deps.actor,
+                        signal: session.agent.abortController?.signal ?? new AbortController().signal,
                         platform: this.platform,
                     }),
                     handleInterrupt: async (interrupt) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@copilotkit/channels-core",
-  "version": "0.6.0",
+  "version": "0.6.2-canary.1785779327",
   "description": "Platform-agnostic JSX channel engine for CopilotKit (createChannel, Thread, PlatformAdapter, ActionStore).",
   "license": "MIT",
   "repository": {
@@ -50,10 +50,10 @@
   "dependencies": {
     "@ag-ui/client": "0.0.57",
     "@ag-ui/core": "0.0.57",
-    "zod-to-json-schema": "^3.24.1",
-    "@copilotkit/core": "^1.64.2",
-    "@copilotkit/shared": "^1.64.2",
-    "@copilotkit/channels-ui": "~0.6.0"
+    "@copilotkit/channels-ui": "0.6.2-canary.1785779327",
+    "@copilotkit/core": "1.65.1-canary.1785779327",
+    "@copilotkit/shared": "1.65.1-canary.1785779327",
+    "zod-to-json-schema": "^3.24.1"
   },
   "devDependencies": {
     "@types/node": "^22.10.0",