npm - @copilotkit/channels-core - Versions diffs - 0.2.1 → 0.3.0 - Mend

@copilotkit/channels-core 0.2.1 → 0.3.0

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.

Files changed (17) hide show

package/README.md +45 -2
package/dist/create-channel.d.ts +20 -10
package/dist/create-channel.d.ts.map +1 -1
package/dist/create-channel.foundations.test.js +14 -14
package/dist/create-channel.js +133 -121
package/dist/create-channel.test.js +34 -34
package/dist/modal-submit.test.js +4 -4
package/dist/open-modal.test.js +4 -4
package/dist/reactions.test.js +11 -11
package/dist/telemetry/create-channel-telemetry.test.js +7 -4
package/dist/telemetry/e2e-telemetry.test.js +1 -1
package/dist/testing/fake-adapter.d.ts.map +1 -1
package/dist/testing/fake-adapter.js +1 -1
package/dist/thread-capabilities.test.js +5 -5
package/dist/thread-ephemeral.test.js +1 -1
package/dist/thread-reactions.test.js +2 -2
package/package.json +4 -4

package/README.md CHANGED Viewed

@@ -4,6 +4,11 @@ The supported platform-neutral foundation behind `@copilotkit/channels`.
 Most applications should use the batteries-included `@copilotkit/channels` package;
 install core directly when building an adapter or intentionally selecting one platform.
+**Every Channel requires a CopilotKit Intelligence connection** (an API key — a
+free tier is available). There is no standalone / DIY run path: a Channel is
+started and owned by the `CopilotRuntime` once Intelligence is configured, not
+by calling a method on the Channel itself. See "Running a Channel" below.
 ## Selective install
 ```sh
@@ -45,12 +50,50 @@ import { slack } from "@copilotkit/channels-slack";
   (e.g. Discord). Forwarded to adapters that support commands and ignored
   elsewhere — also pass them up front via `commands` in `CreateChannelOptions`.
 - `tool(t)` — register a `ChannelTool` (alternative to `opts.tools`); must be
-  added before `start()`.
-- `start()` / `stop()` — bring adapters up / down.
+  added before the runtime activates the channel.
 `agent` is optional. If omitted, calling `thread.runAgent()` throws; supply
 an `AbstractAgent` or a `(threadId) => AbstractAgent` factory.
+A `Channel` has no public `start()` / `stop()` — lifecycle is runtime-owned
+(see below).
+## Running a Channel
+A Channel only runs when it's declared on an Intelligence-configured
+`CopilotRuntime`; there is no `channel.start()` and no standalone/DIY runner.
+Pass the `Channel` in `channels`, then drive activation through the returned
+handler:
+```ts
+import { createChannel } from "@copilotkit/channels-core";
+import { slack } from "@copilotkit/channels-slack";
+import {
+  CopilotRuntime,
+  CopilotKitIntelligence,
+  createCopilotRuntimeHandler,
+} from "@copilotkit/runtime/v2";
+const channel = createChannel({
+  name: "support-bot", // project-unique Intelligence Channel name
+  adapters: [slack({ botToken, appToken })],
+});
+const runtime = new CopilotRuntime({
+  intelligence: new CopilotKitIntelligence({
+    apiUrl: "https://api.copilotkit.ai",
+    wsUrl: "wss://api.copilotkit.ai",
+    apiKey: process.env.COPILOTKIT_INTELLIGENCE_API_KEY!, // free tier available
+  }),
+  identifyUser: async () => ({ id: "support-bot", name: "Support Bot" }),
+  channels: [channel],
+});
+const handler = createCopilotRuntimeHandler({ runtime });
+await handler.channels.ready(); // starts every declared channel
+// await handler.channels.stop(); // tears them down
+```
 ## `Thread`
 A `Thread` is the per-conversation handle handed to your handlers and tool

package/dist/create-channel.d.ts CHANGED Viewed

@@ -26,9 +26,10 @@ export type LockConflictDecision = "drop" | "force";
  * (Intelligence OSS-450 / #511).
  *
  * Distinct from a {@link PlatformAdapter} attached via
- * `createChannel({ adapters })` / {@link Channel.addAdapter}: an adapter is a
- * *direct*, developer-owned connection this handler does not manage, whereas
- * `provider` selects the *managed* platform for a Channel with no adapters.
+ * `createChannel({ adapters })` / `channel.ɵruntime.addAdapter`: an adapter is
+ * a *direct*, developer-owned connection this handler does not manage,
+ * whereas `provider` selects the *managed* platform for a Channel with no
+ * adapters.
  */
 export type ManagedChannelProvider = "slack" | "teams";
 /**
@@ -124,7 +125,8 @@ export interface CreateChannelOptions<TStateSchema extends StandardSchemaV1 | un
     name?: string;
     /**
      * Adapters supplied at construction. Optional — adapters can also be attached
-     * before `start()` via {@link Channel.addAdapter} (the Channel runtime uses this).
+     * before the runner starts the channel, via `channel.ɵruntime.addAdapter`
+     * (the Channel runtime uses this).
      */
     adapters?: PlatformAdapter[];
     /**
@@ -139,8 +141,8 @@ export interface CreateChannelOptions<TStateSchema extends StandardSchemaV1 | un
      * {@link ManagedChannelProvider}.
      *
      * Ignored for direct-adapter Channels (those created with `adapters` /
-     * {@link Channel.addAdapter}) — a direct Channel is owned by the developer's
-     * own adapter, not by managed activation.
+     * `channel.ɵruntime.addAdapter`) — a direct Channel is owned by the
+     * developer's own adapter, not by managed activation.
      */
     provider?: ManagedChannelProvider;
     agent?: AbstractAgent | ((threadId: string) => AbstractAgent);
@@ -205,12 +207,20 @@ export interface Channel<TState = unknown> {
     /** Handle a modal dismissal for `callbackId` (Slack `view_closed`). */
     onModalClose(callbackId: string, handler: ModalCloseHandler): void;
     tool(t: ChannelTool): void;
-    /** Attach an adapter before `start()`. Throws if called after the channel has started. */
-    addAdapter(adapter: PlatformAdapter): void;
-    start(): Promise<void>;
-    stop(): Promise<void>;
     /** Cross-platform transcript store. Append, list, and delete entries per user. */
     transcripts: Transcripts;
+    /**
+     * Internal lifecycle seam. Holds the `start`/`stop`/`addAdapter`
+     * implementations that the runtime uses to drive the lifecycle directly —
+     * there is no public equivalent; channels are runtime-driven only. (Read the
+     * managed provider off the top-level `channel.provider`, not here.)
+     * @internal
+     */
+    ɵruntime: {
+        start(): Promise<void>;
+        stop(): Promise<void>;
+        addAdapter(adapter: PlatformAdapter): void;
+    };
 }
 export declare function createChannel<TStateSchema extends StandardSchemaV1 | undefined = undefined>(opts: CreateChannelOptions<TStateSchema>): Channel<ThreadStateOf<TStateSchema>>;
 export {};

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

	@@ -1 +1 @@
1	- {"version":3,"file":"create-channel.d.ts","sourceRoot":"","sources":["../src/create-channel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EASf,iBAAiB,EAClB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEzD,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE5D,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,KAAK,EACV,kBAAkB,EAClB,eAAe,EACf,YAAY,EACZ,UAAU,EAGV,WAAW,EACX,UAAU,EACX,MAAM,yBAAyB,CAAC;AAMjC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AA8BhF,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,OAAO,CAAC;AAEpD~~;;;;;;;;;;;;;;;;;;;GAmBG~~;AACH,MAAM,MAAM,sBAAsB,GAAG,OAAO,GAAG,OAAO,CAAC;AAEvD;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,KAAK,KAAK,UAAU,CAAC,WAAW,CAAC,CAAC;AAEzE,MAAM,MAAM,cAAc,CAAC,MAAM,GAAG,OAAO,IAAI,CAAC,GAAG,EAAE;IACnD,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;IAC/B,OAAO,EAAE,eAAe,CAAC;CAC1B,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE3B,2FAA2F;AAC3F,MAAM,MAAM,kBAAkB,CAAC,MAAM,GAAG,OAAO,IAAI,CAAC,GAAG,EAAE;IACvD,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;IAC/B,IAAI,CAAC,EAAE,YAAY,CAAC;CACrB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE3B,+CAA+C;AAC/C,MAAM,WAAW,aAAa;IAC5B,oEAAoE;IACpE,KAAK,EAAE,UAAU,CAAC;IAClB,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,KAAK,EAAE,OAAO,CAAC;IACf,wDAAwD;IACxD,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,mFAAmF;IACnF,UAAU,EAAE,UAAU,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,eAAe,CAAC;IACzB,GAAG,EAAE,OAAO,CAAC;CACd;AACD,MAAM,MAAM,eAAe,GAAG,CAAC,GAAG,EAAE,aAAa,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE3E,kDAAkD;AAClD,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,GAAG,EAAE,OAAO,CAAC;CACd;AACD,MAAM,MAAM,kBAAkB,GAAG,CAC/B,GAAG,EAAE,gBAAgB,KAClB,iBAAiB,GAAG,IAAI,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;AAElE,iDAAiD;AACjD,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,GAAG,EAAE,OAAO,CAAC;CACd;AACD,MAAM,MAAM,iBAAiB,GAAG,CAAC,GAAG,EAAE,eAAe,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE/E,gFAAgF;AAChF,KAAK,aAAa,CAAC,OAAO,SAAS,gBAAgB,GAAG,SAAS,IAC7D,OAAO,SAAS,gBAAgB,GAAG,iBAAiB,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;AAE1E,mFAAmF;AACnF,MAAM,MAAM,cAAc,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,GAAG;IACxE,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,KAAK,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CACtC,CAAC;AAEF;;;;GAIG;AACH,MAAM,WAAW,WAAW,CAC1B,YAAY,SAAS,gBAAgB,GAAG,SAAS,GAAG,SAAS;IAE7D,0FAA0F;IAC1F,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,2IAA2I;IAC3I,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,4FAA4F;IAC5F,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,wEAAwE;IACxE,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,mGAAmG;IACnG,cAAc,CAAC,EACX,oBAAoB,GACpB,CAAC,CACC,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE,eAAe,KACrB,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC;IAC/D,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB,CACnC,YAAY,SAAS,gBAAgB,GAAG,SAAS,GAAG,SAAS;IAE7D;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd~~;;;OAGG~~;IACH,QAAQ,CAAC,EAAE,eAAe,EAAE,CAAC;IAC7B;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CAAC,EAAE,sBAAsB,CAAC;IAClC,KAAK,CAAC,EAAE,aAAa,GAAG,CAAC,CAAC,QAAQ,EAAE,MAAM,KAAK,aAAa,CAAC,CAAC;IAC9D,gDAAgD;IAChD,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,KAAK,CAAC,EAAE,WAAW,EAAE,CAAC;IACtB,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IACzB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAChC,kFAAkF;IAClF,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC;IAC5B,gFAAgF;IAChF,KAAK,CAAC,EAAE,WAAW,CAAC,YAAY,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,OAAO,CAAC,MAAM,GAAG,OAAO;IACvC,6FAA6F;IAC7F,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,oNAAoN;IACpN,QAAQ,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,CAAC;IAC9C;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,sBAAsB,CAAC;IAC3C,2FAA2F;IAC3F,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,CAAC;IAChC,SAAS,CAAC,CAAC,EAAE,cAAc,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IAC3C,SAAS,CAAC,CAAC,EAAE,cAAc,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IAC3C;;;;OAIG;IACH,eAAe,CAAC,CAAC,EAAE,kBAAkB,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IACrD,wFAAwF;IACxF,aAAa,CAAC,MAAM,GAAG,OAAO,EAC5B,EAAE,EAAE,MAAM,EACV,CAAC,EAAE,CAAC,GAAG,EAAE,kBAAkB,CAAC,MAAM,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAC3D,IAAI,CAAC;IACR;;;;OAIG;IACH,WAAW,CAAC,QAAQ,GAAG,OAAO,EAC5B,SAAS,EAAE,MAAM,EACjB,CAAC,EAAE,CAAC,IAAI,EAAE;QACR,OAAO,EAAE,QAAQ,CAAC;QAClB,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;KAChC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GACzB,IAAI,CAAC;IACR,8DAA8D;IAC9D,SAAS,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAAC;IACzC,kDAAkD;IAClD,SAAS,CACP,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GACrD,IAAI,CAAC;IACR,kGAAkG;IAClG,UAAU,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAAC;IAC3C,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,EAAE,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI,CAAC;IAC7E,uFAAuF;IACvF,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACrE,uEAAuE;IACvE,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACnE,IAAI,CAAC,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IAC3B,~~0FAA0F~~;~~IAC1F~~,~~UAAU~~,~~CAAC,OAAO,~~EAAE,~~eAAe~~,~~GAAG~~,~~IAAI~~,~~CAAC~~;~~IAC3C~~,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;~~IACvB~~,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;~~IACtB~~,~~kFAAkF;IAClF~~,~~WAAW~~,EAAE,~~WAAW~~,CAAC;~~CAC1B~~;AAuDD,wBAAgB,aAAa,CAC3B,YAAY,SAAS,gBAAgB,GAAG,SAAS,GAAG,SAAS,EAE7D,IAAI,EAAE,oBAAoB,CAAC,YAAY,CAAC,GACvC,OAAO,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,~~CA0nBtC~~"}
1	+ {"version":3,"file":"create-channel.d.ts","sourceRoot":"","sources":["../src/create-channel.ts"],"names":[],"mappings":"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"}

package/dist/create-channel.foundations.test.js CHANGED Viewed

@@ -8,8 +8,8 @@ describe("createChannel — optional adapters + addAdapter", () => {
     it("starts with no adapters and runs one added before start()", async () => {
         const fake = new FakeAdapter();
         const channel = createChannel({ agent: () => new FakeAgent() });
-        channel.addAdapter(fake);
-        await channel.start();
+        channel.ɵruntime.addAdapter(fake);
+        await channel.ɵruntime.start();
         expect(fake.started).toBe(true);
     });
     it("throws when addAdapter is called after start()", async () => {
@@ -17,8 +17,8 @@ describe("createChannel — optional adapters + addAdapter", () => {
             adapters: [new FakeAdapter()],
             agent: () => new FakeAgent(),
         });
-        await channel.start();
-        expect(() => channel.addAdapter(new FakeAdapter())).toThrow(/start/i);
+        await channel.ɵruntime.start();
+        expect(() => channel.ɵruntime.addAdapter(new FakeAdapter())).toThrow(/start/i);
     });
     it("is idempotent: a second start() does not re-start adapters or rebuild state", async () => {
         const fake = new FakeAdapter();
@@ -27,9 +27,9 @@ describe("createChannel — optional adapters + addAdapter", () => {
             agent: () => new FakeAgent(),
         });
         const startSpy = vi.spyOn(fake, "start");
-        await channel.start();
+        await channel.ɵruntime.start();
         const transcriptsAfterFirst = channel.transcripts;
-        await channel.start(); // second call must be a no-op
+        await channel.ɵruntime.start(); // second call must be a no-op
         expect(startSpy).toHaveBeenCalledTimes(1);
         // Same transcript-store instance → state (locks/dedup/actions) not wiped.
         expect(channel.transcripts).toBe(transcriptsAfterFirst);
@@ -41,9 +41,9 @@ describe("createChannel — optional adapters + addAdapter", () => {
             agent: () => new FakeAgent(),
         });
         const startSpy = vi.spyOn(fake, "start");
-        await channel.start();
-        await channel.stop();
-        await channel.start(); // stop() cleared `started`, so this is a real restart
+        await channel.ɵruntime.start();
+        await channel.ɵruntime.stop();
+        await channel.ɵruntime.start(); // stop() cleared `started`, so this is a real restart
         expect(startSpy).toHaveBeenCalledTimes(2);
     });
 });
@@ -75,7 +75,7 @@ describe("createChannel — store resolution", () => {
                 transcripts: {},
             },
         });
-        await seeder.start();
+        await seeder.ɵruntime.start();
         await seeder.transcripts.append({ platform: "fake", conversationKey: "c" }, { role: "user", text: "seeded" }, { userKey: "u@x.com" });
         const fake = new FakeAdapter();
         fake.stateStore = adapterStore;
@@ -84,7 +84,7 @@ describe("createChannel — store resolution", () => {
             agent: () => new FakeAgent(),
             store: { identity: () => "u@x.com", transcripts: {} },
         });
-        await channel.start();
+        await channel.ɵruntime.start();
         const entries = await channel.transcripts.list({ userKey: "u@x.com" });
         expect(entries.map((e) => e.text)).toContain("seeded");
     });
@@ -102,7 +102,7 @@ describe("createChannel — store resolution", () => {
                 transcripts: {},
             },
         });
-        await channel.start();
+        await channel.ɵruntime.start();
         expect(warn).not.toHaveBeenCalled();
         warn.mockRestore();
     });
@@ -116,7 +116,7 @@ describe("createChannel — store resolution", () => {
             adapters: [a, b],
             agent: () => new FakeAgent(),
         });
-        await channel.start();
+        await channel.ɵruntime.start();
         expect(warn).toHaveBeenCalledWith(expect.stringContaining("state store"));
         warn.mockRestore();
     });
@@ -136,7 +136,7 @@ describe("createChannel — id propagation to handler context", () => {
                 eventId: message.eventId,
             };
         });
-        await channel.start();
+        await channel.ɵruntime.start();
         fake.emitTurn({
             userText: "hi",
             conversationKey: "c1",

package/dist/create-channel.js CHANGED Viewed

@@ -79,16 +79,18 @@ export function createChannel(opts) {
         (!cfg.identity && cfg.transcripts)) {
         throw new Error("createChannel: `identity` and `transcripts` must be configured together.");
     }
-    // Adapters can be supplied up front or added later via `channel.addAdapter`
-    // (before `start()`). The runtime uses the latter to attach Channel delivery.
+    // Adapters can be supplied up front or added later via
+    // `channel.ɵruntime.addAdapter` (before `channel.ɵruntime.start()`). The
+    // runtime uses the latter to attach Channel delivery.
     const adapters = [...(opts.adapters ?? [])];
     assertExclusive(adapters);
     let started = false;
     // Backend, transcripts, telemetry, the action registry, and component
-    // registration are resolved in `start()` — not at construction — so an
-    // adapter added via `addAdapter` after `createChannel` can still supply the
-    // persistence backend (see `resolveBackend`). Nothing reads these before the
-    // first event, which can only arrive after `start()`.
+    // registration are resolved in `ɵruntime.start()` — not at construction —
+    // so an adapter added via `ɵruntime.addAdapter` after `createChannel` can
+    // still supply the persistence backend (see `resolveBackend`). Nothing
+    // reads these before the first event, which can only arrive after
+    // `ɵruntime.start()`.
     let backend;
     let transcripts;
     let registry;
@@ -123,7 +125,7 @@ export function createChannel(opts) {
     let toolDescriptors = toAgentToolDescriptors([...toolMap.values()]);
     function makeThread(adapter, replyTarget, conversationKey, extras) {
         if (!backend || !registry || !telemetry) {
-            throw new Error("channel not started: call channel.start() before handling events");
+            throw new Error("channel not started: the runner must start the channel (channel.ɵruntime.start()) before handling events");
         }
         const deps = {
             adapter,
@@ -419,16 +421,133 @@ export function createChannel(opts) {
         },
         get transcripts() {
             if (!transcripts) {
-                throw new Error("channel.transcripts is available after channel.start()");
+                throw new Error("channel.transcripts is available after the runner starts the channel (channel.ɵruntime.start())");
             }
             return transcripts;
         },
-        addAdapter(adapter) {
-            if (started) {
-                throw new Error("channel.addAdapter must be called before channel.start()");
-            }
-            assertExclusive([...adapters, adapter]);
-            adapters.push(adapter);
+        ɵruntime: {
+            addAdapter(adapter) {
+                if (started) {
+                    throw new Error("channel.ɵruntime.addAdapter must be called before channel.ɵruntime.start()");
+                }
+                assertExclusive([...adapters, adapter]);
+                adapters.push(adapter);
+            },
+            async start() {
+                // Idempotent: a second start() must not re-resolve the backend and
+                // rebuild Transcripts/Telemetry/ActionRegistry or re-call adapter.start()
+                // — with a MemoryStore that wipes all lock/dedup/transcript/action state,
+                // and real adapters would connect/port-bind twice.
+                if (started)
+                    return;
+                started = true;
+                assertExclusive(adapters);
+                // Resolve persistence now that all adapters (including any attached via
+                // addAdapter) are known, then build the transcript store, action
+                // registry, and register components against it.
+                backend = resolveBackend(cfg.adapter, adapters);
+                transcripts = new Transcripts(backend, cfg.transcripts ?? {});
+                const tel = new ChannelTelemetry({
+                    backend,
+                    packageName: pkg.name,
+                    packageVersion: pkg.version,
+                });
+                telemetry = tel;
+                const registryInstance = new ActionRegistry({
+                    store: opts.actionStore ?? kvActionStore(backend),
+                });
+                registry = registryInstance;
+                for (const c of opts.components ?? []) {
+                    if (!c.name) {
+                        console.warn("[channel] createChannel: skipping anonymous component — give it a name to enable durable actions after restart.");
+                        continue;
+                    }
+                    registryInstance.registerComponent(c.name, c);
+                }
+                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,
+                    toolsCount: toolMap.size,
+                    commandsCount: commandHandlers.size,
+                    contextCount: context.length,
+                    transcripts: !!cfg.transcripts,
+                    identity: !!cfg.identity,
+                });
+                // Isolate per-adapter startup failures: one adapter rejecting (e.g.
+                // Telegram's setMyCommands rejecting a hyphenated command name, a revoked
+                // token, a port already in use) must NOT crash the channel or prevent the
+                // other adapters from starting. Log + degrade, never throw.
+                const startResults = await Promise.allSettled(adapters.map((a) => a.start(makeSink(a), { channelName: opts.name })));
+                const startedPlatforms = [];
+                const failedPlatforms = [];
+                startResults.forEach((r, i) => {
+                    const rawPlatform = adapters[i].platform;
+                    // Raw label for the human-facing log; normalized label for telemetry.
+                    const platform = normalizePlatform(rawPlatform);
+                    if (r.status === "rejected") {
+                        failedPlatforms.push(platform);
+                        console.error(`[channel] adapter "${rawPlatform}" failed to start:`, r.reason);
+                        tel.capture("oss.channel.start_failed", {
+                            platform,
+                            errorClass: errorClass(r.reason),
+                        });
+                    }
+                    else {
+                        startedPlatforms.push(platform);
+                    }
+                });
+                if (startedPlatforms.length > 0) {
+                    tel.capture("oss.channel.started", {
+                        platforms: startedPlatforms,
+                        startedCount: startedPlatforms.length,
+                        failedCount: failedPlatforms.length,
+                        hasMentionHandler: mentionHandlers.length > 0,
+                        hasMessageHandler: messageHandlers.length > 0,
+                        interruptHandlers: interruptHandlers.size,
+                        commandsCount: commandHandlers.size,
+                        toolsCount: toolMap.size,
+                    });
+                }
+                // A channel that has adapters but where NONE started is dead — surface an
+                // error so the runtime reports status "error", not a false "online". A
+                // PARTIAL start (>=1 adapter live) still counts as started. Reset the
+                // `started` guard so a caller can retry after fixing the misconfiguration.
+                if (adapters.length > 0 && startedPlatforms.length === 0) {
+                    started = false;
+                    throw new Error(`channel "${opts.name ?? "(unnamed)"}" failed to start: all ${failedPlatforms.length} adapter(s) failed to connect (${failedPlatforms.join(", ")}) — see the logged errors above`);
+                }
+                // Hand declared commands to adapters that register them up front (e.g.
+                // Discord); adapters without `registerCommands` are skipped. Per-adapter
+                // failures are isolated the same way as start().
+                const commandSpecs = [...commandHandlers.values()].map(toCommandSpec);
+                if (commandSpecs.length > 0) {
+                    const registerResults = await Promise.allSettled(adapters.map((a) => a.registerCommands?.(commandSpecs)));
+                    registerResults.forEach((r, i) => {
+                        if (r.status === "rejected") {
+                            console.error(`[channel] adapter "${adapters[i].platform}" failed to register commands:`, r.reason);
+                        }
+                    });
+                }
+            },
+            async stop() {
+                // Clear the started flag so a later start() is a real restart (re-resolve
+                // backend, rebuild components, reconnect adapters) rather than a silent
+                // no-op. The idempotency guard in start() only exists to block a DOUBLE
+                // start() while running — not a legitimate start→stop→start cycle.
+                started = false;
+                // Isolate per-adapter shutdown failures: one adapter's stop() rejecting
+                // must not prevent the others from being stopped.
+                const stopResults = await Promise.allSettled(adapters.map((a) => a.stop()));
+                stopResults.forEach((r, i) => {
+                    if (r.status === "rejected") {
+                        console.error(`[channel] adapter "${adapters[i].platform}" failed to stop:`, r.reason);
+                    }
+                });
+            },
         },
         onMention(h) {
             // The public surface narrows `thread` to StatefulThread<TState>; the
@@ -483,113 +602,6 @@ export function createChannel(opts) {
         tool(t) {
             toolMap.set(t.name, t);
         },
-        async start() {
-            // Idempotent: a second start() must not re-resolve the backend and
-            // rebuild Transcripts/Telemetry/ActionRegistry or re-call adapter.start()
-            // — with a MemoryStore that wipes all lock/dedup/transcript/action state,
-            // and real adapters would connect/port-bind twice.
-            if (started)
-                return;
-            started = true;
-            assertExclusive(adapters);
-            // Resolve persistence now that all adapters (including any attached via
-            // addAdapter) are known, then build the transcript store, action
-            // registry, and register components against it.
-            backend = resolveBackend(cfg.adapter, adapters);
-            transcripts = new Transcripts(backend, cfg.transcripts ?? {});
-            const tel = new ChannelTelemetry({
-                backend,
-                packageName: pkg.name,
-                packageVersion: pkg.version,
-            });
-            telemetry = tel;
-            const registryInstance = new ActionRegistry({
-                store: opts.actionStore ?? kvActionStore(backend),
-            });
-            registry = registryInstance;
-            for (const c of opts.components ?? []) {
-                if (!c.name) {
-                    console.warn("[channel] createChannel: skipping anonymous component — give it a name to enable durable actions after restart.");
-                    continue;
-                }
-                registryInstance.registerComponent(c.name, c);
-            }
-            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,
-                toolsCount: toolMap.size,
-                commandsCount: commandHandlers.size,
-                contextCount: context.length,
-                transcripts: !!cfg.transcripts,
-                identity: !!cfg.identity,
-            });
-            // Isolate per-adapter startup failures: one adapter rejecting (e.g.
-            // Telegram's setMyCommands rejecting a hyphenated command name, a revoked
-            // token, a port already in use) must NOT crash the channel or prevent the
-            // other adapters from starting. Log + degrade, never throw.
-            const startResults = await Promise.allSettled(adapters.map((a) => a.start(makeSink(a), { channelName: opts.name })));
-            const startedPlatforms = [];
-            const failedPlatforms = [];
-            startResults.forEach((r, i) => {
-                const rawPlatform = adapters[i].platform;
-                // Raw label for the human-facing log; normalized label for telemetry.
-                const platform = normalizePlatform(rawPlatform);
-                if (r.status === "rejected") {
-                    failedPlatforms.push(platform);
-                    console.error(`[channel] adapter "${rawPlatform}" failed to start:`, r.reason);
-                    tel.capture("oss.channel.start_failed", {
-                        platform,
-                        errorClass: errorClass(r.reason),
-                    });
-                }
-                else {
-                    startedPlatforms.push(platform);
-                }
-            });
-            if (startedPlatforms.length > 0) {
-                tel.capture("oss.channel.started", {
-                    platforms: startedPlatforms,
-                    startedCount: startedPlatforms.length,
-                    failedCount: failedPlatforms.length,
-                    hasMentionHandler: mentionHandlers.length > 0,
-                    hasMessageHandler: messageHandlers.length > 0,
-                    interruptHandlers: interruptHandlers.size,
-                    commandsCount: commandHandlers.size,
-                    toolsCount: toolMap.size,
-                });
-            }
-            // Hand declared commands to adapters that register them up front (e.g.
-            // Discord); adapters without `registerCommands` are skipped. Per-adapter
-            // failures are isolated the same way as start().
-            const commandSpecs = [...commandHandlers.values()].map(toCommandSpec);
-            if (commandSpecs.length > 0) {
-                const registerResults = await Promise.allSettled(adapters.map((a) => a.registerCommands?.(commandSpecs)));
-                registerResults.forEach((r, i) => {
-                    if (r.status === "rejected") {
-                        console.error(`[channel] adapter "${adapters[i].platform}" failed to register commands:`, r.reason);
-                    }
-                });
-            }
-        },
-        async stop() {
-            // Clear the started flag so a later start() is a real restart (re-resolve
-            // backend, rebuild components, reconnect adapters) rather than a silent
-            // no-op. The idempotency guard in start() only exists to block a DOUBLE
-            // start() while running — not a legitimate start→stop→start cycle.
-            started = false;
-            // Isolate per-adapter shutdown failures: one adapter's stop() rejecting
-            // must not prevent the others from being stopped.
-            const stopResults = await Promise.allSettled(adapters.map((a) => a.stop()));
-            stopResults.forEach((r, i) => {
-                if (r.status === "rejected") {
-                    console.error(`[channel] adapter "${adapters[i].platform}" failed to stop:`, r.reason);
-                }
-            });
-        },
     };
     return channel;
 }

package/dist/create-channel.test.js CHANGED Viewed

@@ -60,7 +60,7 @@ describe("createChannel", () => {
         channel.onMention(async ({ thread }) => {
             await thread.post(Section({ children: "hi" }));
         });
-        await channel.start();
+        await channel.ɵruntime.start();
         fake.emitTurn({ userText: "yo", conversationKey: "c1" });
         await tick();
         expect(fake.posted.length).toBe(1);
@@ -75,7 +75,7 @@ describe("createChannel", () => {
         channel.onMention(async ({ thread }) => {
             await thread.runAgent();
         });
-        await channel.start();
+        await channel.ɵruntime.start();
         fake.emitTurn({ userText: "yo", conversationKey: "c1" });
         await tick();
         const renderer = fake.lastRunRenderer;
@@ -107,7 +107,7 @@ describe("createChannel", () => {
                     : message.text,
             });
         });
-        await channel.start();
+        await channel.ɵruntime.start();
         fake.emitTurn({
             userText: "look",
             conversationKey: "c1",
@@ -138,7 +138,7 @@ describe("createChannel", () => {
                 ],
             }));
         });
-        await channel.start();
+        await channel.ɵruntime.start();
         fake.emitTurn({ userText: "yo", conversationKey: "c1" });
         await tick();
         const button = findNode(fake.posted[0], "button");
@@ -164,7 +164,7 @@ describe("createChannel", () => {
                 ],
             }));
         });
-        await channel.start();
+        await channel.ɵruntime.start();
         fake.emitTurn({ userText: "create a thing", conversationKey: "c1" });
         await tick();
         const button = findNode(fake.posted[0], "button");
@@ -201,7 +201,7 @@ describe("createChannel", () => {
                 context: [{ description: "who", value: "user U1" }],
             });
         });
-        await channel.start();
+        await channel.ɵruntime.start();
         fake.emitTurn({ userText: "go", conversationKey: "c1" });
         await tick();
         expect(seenContext).toEqual([
@@ -221,7 +221,7 @@ describe("createChannel", () => {
                 filename: "x.png",
             });
         });
-        await channel.start();
+        await channel.ɵruntime.start();
         fake.emitTurn({ userText: "hi", conversationKey: "c1" });
         await tick();
         expect(result).toEqual({
@@ -243,7 +243,7 @@ describe("createChannel", () => {
             history = await thread.getMessages();
             resolved = await thread.lookupUser("Ada");
         });
-        await channel.start();
+        await channel.ɵruntime.start();
         fake.emitTurn({ userText: "hi", conversationKey: "c1" });
         await tick();
         expect(history).toEqual([
@@ -267,7 +267,7 @@ describe("createChannel", () => {
                 ],
             }));
         });
-        await channel.start();
+        await channel.ɵruntime.start();
         fake.emitTurn({ userText: "decide", conversationKey: "c1" });
         await tick();
         const button = findNode(fake.posted[0], "button");
@@ -297,7 +297,7 @@ describe("createChannel", () => {
             runs++;
             await gate;
         });
-        await channel.start();
+        await channel.ɵruntime.start();
         const sink = fake.getSink();
         const turn = {
             conversationKey: "c1",
@@ -329,7 +329,7 @@ describe("createChannel", () => {
             runs++;
             await gate;
         });
-        await channel.start();
+        await channel.ɵruntime.start();
         const sink = fake.getSink();
         const turn = {
             conversationKey: "c1",
@@ -358,7 +358,7 @@ describe("createChannel", () => {
         channel.onMention(async () => {
             runs++;
         });
-        await channel.start();
+        await channel.ɵruntime.start();
         const sink = fake.getSink();
         const base = {
             conversationKey: "c",
@@ -406,7 +406,7 @@ describe("createChannel", () => {
         channel.onMention(async ({ message }) => {
             capturedKey = message.userKey;
         });
-        await channel.start();
+        await channel.ɵruntime.start();
         const sink = fake.getSink();
         await sink.onTurn({
             conversationKey: "c1",
@@ -430,7 +430,7 @@ describe("createChannel", () => {
                 transcripts: { maxPerUser: 50 },
             },
         });
-        await channel.start();
+        await channel.ɵruntime.start();
         const sink = fake.getSink();
         // Drive a turn so identity is resolved and we can verify transcripts exist
         const thread = { platform: "fake", conversationKey: "c1" };
@@ -481,7 +481,7 @@ describe("createChannel", () => {
         channel.onMention(async ({ thread }) => {
             await thread.runAgent({ transcript: true });
         });
-        await channel.start();
+        await channel.ɵruntime.start();
         // Seed one prior cross-platform entry (different platform label) so we can
         // assert it shows up in the injected context. Seeded post-start: transcripts
         // are only available once the backend is resolved in start().
@@ -535,7 +535,7 @@ describe("createChannel", () => {
                 rejected = true;
             }
         });
-        await channel.start();
+        await channel.ɵruntime.start();
         fake.emitTurn({ userText: "go", conversationKey: "c1" });
         await tick();
         expect(roundTripped).toEqual({ step: "x" });
@@ -559,7 +559,7 @@ describe("createChannel lock and dedup edge cases", () => {
             await gate;
             throw new Error("boom");
         });
-        await bot1.start();
+        await bot1.ɵruntime.start();
         const sink = fake.getSink();
         const turn = {
             conversationKey: "c1",
@@ -601,7 +601,7 @@ describe("createChannel lock and dedup edge cases", () => {
             runs++;
             await gate;
         });
-        await channel.start();
+        await channel.ɵruntime.start();
         const sink = fake.getSink();
         const turn = {
             conversationKey: "c1",
@@ -634,7 +634,7 @@ describe("createChannel lock and dedup edge cases", () => {
             runs++;
             await gate;
         });
-        await channel.start();
+        await channel.ɵruntime.start();
         const sink = fake.getSink();
         const turn = {
             conversationKey: "c1",
@@ -665,7 +665,7 @@ describe("createChannel lock and dedup edge cases", () => {
         channel.onMention(async ({ message }) => {
             capturedUserKey = message.userKey;
         });
-        await channel.start();
+        await channel.ɵruntime.start();
         const sink = fake.getSink();
         await sink.onTurn({
             conversationKey: "c1",
@@ -686,7 +686,7 @@ describe("createChannel lock and dedup edge cases", () => {
         channel.onMention(async ({ message }) => {
             capturedUserKey = message.userKey;
         });
-        await channel.start();
+        await channel.ɵruntime.start();
         const sink = fake.getSink();
         await sink.onTurn({
             conversationKey: "c1",
@@ -707,7 +707,7 @@ describe("createChannel lock and dedup edge cases", () => {
         channel.onMention(async () => {
             runs++;
         });
-        await channel.start();
+        await channel.ɵruntime.start();
         const sink = fake.getSink();
         const base = {
             conversationKey: "c1",
@@ -746,7 +746,7 @@ describe("createChannel lock and dedup edge cases", () => {
         channel.onMention(async () => {
             runs++;
         });
-        await channel.start();
+        await channel.ɵruntime.start();
         const sink = fake.getSink();
         await sink.onTurn({
             conversationKey: "c1",
@@ -772,7 +772,7 @@ describe("createChannel lock and dedup edge cases", () => {
             runs++;
             await gate;
         });
-        await channel.start();
+        await channel.ɵruntime.start();
         const sink = fake.getSink();
         const turnA = {
             conversationKey: "c1",
@@ -813,7 +813,7 @@ describe("createChannel lock and dedup edge cases", () => {
         channel.onMention(async () => {
             runs++;
         });
-        await channel.start();
+        await channel.ɵruntime.start();
         const sink = fake.getSink();
         const turn = {
             conversationKey: "c2",
@@ -838,7 +838,7 @@ describe("createChannel slash commands", () => {
         channel.onCommand("triage", ({ command, text }) => {
             seen = { command, text };
         });
-        await channel.start();
+        await channel.ɵruntime.start();
         await fake.emitCommand({ command: "/Triage", text: "db is down" });
         expect(seen).toEqual({ command: "triage", text: "db is down" });
     });
@@ -849,7 +849,7 @@ describe("createChannel slash commands", () => {
         channel.onCommand("triage", () => {
             fired = true;
         });
-        await channel.start();
+        await channel.ɵruntime.start();
         await fake.emitCommand({ command: "unknown", text: "x" });
         expect(fired).toBe(false);
     });
@@ -868,7 +868,7 @@ describe("createChannel slash commands", () => {
                 }),
             ],
         });
-        await channel.start();
+        await channel.ɵruntime.start();
         await fake.emitCommand({
             command: "book",
             text: "raw",
@@ -881,7 +881,7 @@ describe("createChannel slash commands", () => {
         const channel = createChannel({ adapters: [fake] });
         channel.onCommand("triage", () => { });
         channel.onCommand("status", () => { });
-        await channel.start();
+        await channel.ɵruntime.start();
         expect(fake.registeredCommands?.map((c) => c.name).sort()).toEqual([
             "status",
             "triage",
@@ -893,7 +893,7 @@ describe("createChannel slash commands", () => {
             const bad = new FakeAdapter({ platform: "telegram", failStart: true });
             const good = new FakeAdapter({ platform: "slack" });
             const channel = createChannel({ adapters: [bad, good] });
-            await expect(channel.start()).resolves.toBeUndefined();
+            await expect(channel.ɵruntime.start()).resolves.toBeUndefined();
             expect(good.started).toBe(true);
             expect(errSpy.mock.calls.some((c) => String(c[0]).includes("telegram"))).toBe(true);
         }
@@ -911,7 +911,7 @@ describe("createChannel slash commands", () => {
             const good = new FakeAdapter({ platform: "slack" });
             const channel = createChannel({ adapters: [bad, good] });
             channel.onCommand("triage", () => { });
-            await expect(channel.start()).resolves.toBeUndefined();
+            await expect(channel.ɵruntime.start()).resolves.toBeUndefined();
             expect(good.started).toBe(true);
             expect(good.registeredCommands?.map((c) => c.name)).toEqual(["triage"]);
             expect(errSpy.mock.calls.some((c) => String(c[0]).includes("telegram"))).toBe(true);
@@ -927,8 +927,8 @@ describe("createChannel slash commands", () => {
             const good = new FakeAdapter({ platform: "slack" });
             const stopSpy = vi.spyOn(good, "stop");
             const channel = createChannel({ adapters: [bad, good] });
-            await channel.start();
-            await expect(channel.stop()).resolves.toBeUndefined();
+            await channel.ɵruntime.start();
+            await expect(channel.ɵruntime.stop()).resolves.toBeUndefined();
             expect(stopSpy).toHaveBeenCalled();
             expect(errSpy.mock.calls.some((c) => String(c[0]).includes("telegram"))).toBe(true);
         }
@@ -949,7 +949,7 @@ describe("createChannel slash commands", () => {
         const channel = createChannel({});
         expect(channel.adapters).toHaveLength(0);
         const fake = new FakeAdapter();
-        channel.addAdapter(fake);
+        channel.ɵruntime.addAdapter(fake);
         expect(channel.adapters).toEqual([fake]);
     });
 });

package/dist/modal-submit.test.js CHANGED Viewed

@@ -15,7 +15,7 @@ describe("channel.onModalSubmit / onModalClose", () => {
                 hasThread: !!evt.thread,
             });
         });
-        await channel.start();
+        await channel.ɵruntime.start();
         const res = await fake.emitModalSubmit({
             callbackId: "triage",
             values: { summary: "boom", prio: "high" },
@@ -37,7 +37,7 @@ describe("channel.onModalSubmit / onModalClose", () => {
         const fake = new FakeAdapter();
         const channel = createChannel({ adapters: [fake] });
         channel.onModalSubmit("triage", (evt) => evt.values.summary ? undefined : { errors: { summary: "Required" } });
-        await channel.start();
+        await channel.ɵruntime.start();
         const res = await fake.emitModalSubmit({
             callbackId: "triage",
             values: {},
@@ -47,7 +47,7 @@ describe("channel.onModalSubmit / onModalClose", () => {
     it("ignores submissions with no registered handler", async () => {
         const fake = new FakeAdapter();
         const channel = createChannel({ adapters: [fake] });
-        await channel.start();
+        await channel.ɵruntime.start();
         const res = await fake.emitModalSubmit({
             callbackId: "unknown",
             values: {},
@@ -61,7 +61,7 @@ describe("channel.onModalSubmit / onModalClose", () => {
         channel.onModalClose("triage", (evt) => {
             closed.push(evt.callbackId);
         });
-        await channel.start();
+        await channel.ɵruntime.start();
         await fake.emitModalClose({ callbackId: "triage", user: { id: "U2" } });
         expect(closed).toEqual(["triage"]);
     });

package/dist/open-modal.test.js CHANGED Viewed

@@ -18,7 +18,7 @@ describe("ctx.openModal", () => {
         channel.onInteraction("ck:open", async (ctx) => {
             res = await ctx.openModal(view);
         });
-        await channel.start();
+        await channel.ɵruntime.start();
         fake.emitInteraction({ id: "ck:open", triggerId: "T123" });
         await tick();
         expect(res).toEqual({ ok: true });
@@ -33,7 +33,7 @@ describe("ctx.openModal", () => {
         channel.onCommand("triage", async (ctx) => {
             res = await ctx.openModal(view);
         });
-        await channel.start();
+        await channel.ɵruntime.start();
         await fake.emitCommand({ command: "triage", triggerId: "T999" });
         expect(res).toEqual({ ok: true });
         expect(fake.openedModals[0].triggerId).toBe("T999");
@@ -45,7 +45,7 @@ describe("ctx.openModal", () => {
         channel.onInteraction("ck:noop", (ctx) => {
             hasOpen = typeof ctx.openModal === "function";
         });
-        await channel.start();
+        await channel.ɵruntime.start();
         fake.emitInteraction({ id: "ck:noop" });
         await tick();
         expect(hasOpen).toBe(false);
@@ -57,7 +57,7 @@ describe("ctx.openModal", () => {
         channel.onInteraction("ck:x", (ctx) => {
             hasOpen = typeof ctx.openModal === "function";
         });
-        await channel.start();
+        await channel.ɵruntime.start();
         fake.emitInteraction({ id: "ck:x", triggerId: "T1" });
         await tick();
         expect(hasOpen).toBe(false);

package/dist/reactions.test.js CHANGED Viewed

@@ -13,7 +13,7 @@ describe("channel.onReaction", () => {
         channel.onReaction([emoji.thumbs_up], (evt) => {
             seen.push({ emoji: evt.emoji, raw: evt.rawEmoji, added: evt.added });
         });
-        await channel.start();
+        await channel.ɵruntime.start();
         // FakeAdapter.platform === "fake": normalizeEmoji falls through, but engine
         // normalizes by adapter.platform. Use a Slack-style token via a fake whose
         // platform normalizes — here we assert passthrough + catch-all instead.
@@ -35,7 +35,7 @@ describe("channel.onReaction", () => {
                 platform: evt.thread.platform,
             });
         });
-        await channel.start();
+        await channel.ɵruntime.start();
         fake.emitReaction({
             rawEmoji: "🎉",
             added: true,
@@ -64,7 +64,7 @@ describe("channel.onReaction", () => {
         channel.onReaction(["thumbs_up"], (evt) => {
             hits.push(evt.emoji);
         });
-        await channel.start();
+        await channel.ɵruntime.start();
         fake.emitReaction({ rawEmoji: "thumbsup", added: true }); // Slack alias
         await tick();
         expect(hits).toEqual(["thumbs_up"]);
@@ -80,7 +80,7 @@ describe("channel.onReaction", () => {
         channel.onReaction(["refresh"], (evt) => {
             hits.push(evt.emoji);
         });
-        await channel.start();
+        await channel.ɵruntime.start();
         fake.emitReaction({
             rawEmoji: "1f504_refresh",
             added: true,
@@ -101,7 +101,7 @@ describe("channel.onReaction", () => {
                 children: "hi",
             }));
         });
-        await channel.start();
+        await channel.ɵruntime.start();
         fake.emitTurn({});
         await tick();
         // The handler is a closure, never serialized into the native payload.
@@ -128,7 +128,7 @@ describe("channel.onReaction", () => {
                 children: "hi",
             }));
         });
-        await channel.start();
+        await channel.ɵruntime.start();
         fake.emitTurn({});
         await tick();
         // Channel delivery: the reaction arrives keyed by the provider ts (NOT the
@@ -165,7 +165,7 @@ describe("channel.onReaction", () => {
             // pre-rendered Message() node.
             await thread.post({ type: Card, props: {} });
         });
-        await bot1.start();
+        await bot1.ɵruntime.start();
         fake1.emitTurn({});
         await tick();
         // "Restart": a fresh channel + registry sharing the same store, Card re-registered.
@@ -176,7 +176,7 @@ describe("channel.onReaction", () => {
             store: { adapter: backend },
             components: [Card],
         });
-        await bot2.start();
+        await bot2.ɵruntime.start();
         fake2.emitReaction({ rawEmoji: "🎉", added: true, messageId: "msg-1" });
         await tick();
         expect(seen).toEqual(["🎉"]);
@@ -194,7 +194,7 @@ describe("channel.onReaction", () => {
                 children: "hi",
             }));
         });
-        await channel.start();
+        await channel.ɵruntime.start();
         fake.emitTurn({});
         await tick();
         const before = fake.posted.length;
@@ -217,7 +217,7 @@ describe("channel.onReaction", () => {
                 children: "hi",
             }));
         });
-        await channel.start();
+        await channel.ɵruntime.start();
         fake.emitTurn({});
         await tick();
         fake.emitReaction({ rawEmoji: "🎉", added: true, messageId: "other" });
@@ -237,7 +237,7 @@ describe("channel.onReaction", () => {
         channel.onReaction(["thumbsup"], (evt) => {
             hits.push(`alias:${evt.emoji}`);
         });
-        await channel.start();
+        await channel.ɵruntime.start();
         fake.emitReaction({ rawEmoji: "thumbsup", added: true }); // Slack alias
         await tick();
         expect(hits).toEqual(["thumbs_up", "alias:thumbs_up"]);

package/dist/telemetry/create-channel-telemetry.test.js CHANGED Viewed

@@ -28,7 +28,7 @@ describe("createChannel telemetry wiring", () => {
                 },
             ],
         });
-        await channel.start();
+        await channel.ɵruntime.start();
         const call = capture.mock.calls.find((c) => c[0] === "oss.channel.configured");
         expect(call).toBeDefined();
         expect(call[1].platforms).toEqual(["custom"]); // FakeAdapter.platform "fake" → normalized
@@ -38,14 +38,17 @@ describe("createChannel telemetry wiring", () => {
     it("emits oss.channel.started on start, start_failed (category only) on a throwing adapter", async () => {
         const ok = new FakeAdapter();
         const channel = createChannel({ adapters: [ok] });
-        await channel.start();
+        await channel.ɵruntime.start();
         expect(capture.mock.calls.find((c) => c[0] === "oss.channel.started")?.[1]
             .startedCount).toBe(1);
         capture.mockClear();
         const bad = new FakeAdapter();
         bad.start = () => Promise.reject(Object.assign(new Error("xoxb-SECRET token bad"), { code: "EAUTH" }));
         const bot2 = createChannel({ adapters: [bad] });
-        await bot2.start();
+        // All adapters failed → start() rejects (the channel is dead; the runtime
+        // reports status "error"). The start_failed telemetry is still captured
+        // before the throw.
+        await expect(bot2.ɵruntime.start()).rejects.toThrow(/failed to start/i);
         const f = capture.mock.calls.find((c) => c[0] === "oss.channel.start_failed");
         expect(f).toBeDefined();
         expect(f[1].errorClass).toBe("auth");
@@ -60,7 +63,7 @@ describe("createChannel telemetry wiring", () => {
         channel.onMention(async ({ thread }) => {
             await thread.runAgent();
         });
-        await channel.start();
+        await channel.ɵruntime.start();
         capture.mockClear();
         fake.emitTurn({ userText: "hi", conversationKey: "c1" });
         await tick();

package/dist/telemetry/e2e-telemetry.test.js CHANGED Viewed

@@ -40,7 +40,7 @@ describe("oss.channel.* end-to-end (real ChannelTelemetry, only network boundary
         channel.onMention(async ({ thread }) => {
             await thread.runAgent();
         });
-        await channel.start();
+        await channel.ɵruntime.start();
         fake.emitTurn({ userText: "hi", conversationKey: "c1" });
         await waitFor(() => sendSpy.mock.calls.some((c) => c[0].event === "oss.channel.agent_run"));
         const events = sendSpy.mock.calls.map((c) => c[0].event);

package/dist/testing/fake-adapter.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"fake-adapter.d.ts","sourceRoot":"","sources":["../../src/testing/fake-adapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,WAAW,EACX,UAAU,EACV,YAAY,EACZ,aAAa,EACd,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EACV,eAAe,EACf,mBAAmB,EACnB,WAAW,EACX,YAAY,EACZ,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,EACf,WAAW,EAGX,WAAW,EACX,aAAa,EACb,SAAS,EACT,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAE1D,oHAAoH;AACpH,wBAAgB,mBAAmB,IAAI,WAAW,CAgCjD;AAED,qBAAa,WAAY,YAAW,eAAe;IACjD,QAAQ,SAAU;IAClB,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAAC;IAC3C,QAAQ,CAAC,aAAa,QAAQ;IAE9B,sEAAsE;IACtE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,4FAA4F;IAC5F,QAAQ,CAAC,oBAAoB,EAAE,OAAO,CAAC;IACvC,oEAAoE;IACpE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,mGAAmG;IACnG,OAAO,UAAS;IAEhB;;;;;;;;;;;;;OAaG;gBAED,QAAQ,GAAE;QACR,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,+FAA+F;QAC/F,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,iFAAiF;QACjF,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,0FAA0F;QAC1F,oBAAoB,CAAC,EAAE,OAAO,CAAC;QAC/B,kEAAkE;QAClE,QAAQ,CAAC,EAAE,OAAO,CAAC;KACf;IA+DR,QAAQ,CAAC,iBAAiB,EAAE,iBAAiB,CAI3C;IAEF,MAAM,EAAE,WAAW,EAAE,EAAE,CAAM;IAC7B,OAAO,EAAE;QAAE,GAAG,EAAE,UAAU,CAAC;QAAC,EAAE,EAAE,WAAW,EAAE,CAAA;KAAE,EAAE,CAAM;IACvD,gBAAgB,EAAE,gBAAgB,EAAE,CAAM;IAC1C,eAAe,CAAC,EAAE,WAAW,CAAC;IAC9B,4DAA4D;IAC5D,QAAQ,EAAE,aAAa,EAAE,CAAM;IAC/B,wDAAwD;IACxD,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,iHAAiH;IACjH,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,OAAO,CAAC,IAAI,CAAC,CAAc;IAC3B,OAAO,CAAC,OAAO,CAAK;IAEpB,+FAA+F;IAC/F,OAAO,IAAI,WAAW;~~IAMhB~~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"}
1	+ {"version":3,"file":"fake-adapter.d.ts","sourceRoot":"","sources":["../../src/testing/fake-adapter.ts"],"names":[],"mappings":"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"}

package/dist/testing/fake-adapter.js CHANGED Viewed

@@ -142,7 +142,7 @@ export class FakeAdapter {
     /** Expose the registered sink so tests can invoke onTurn() directly for overlap/lock tests. */
     getSink() {
         if (!this.sink)
-            throw new Error("FakeAdapter: sink not set — call channel.start() first");
+            throw new Error("FakeAdapter: sink not set — start the channel (channel.ɵruntime.start()) first");
         return this.sink;
     }
     async start(sink) {

package/dist/thread-capabilities.test.js CHANGED Viewed

@@ -9,7 +9,7 @@ describe("onThreadStarted routing", () => {
         channel.onThreadStarted(({ thread, user }) => {
             seen.push({ user: user?.id, platform: thread.platform });
         });
-        await channel.start();
+        await channel.ɵruntime.start();
         await fake.emitThreadStarted({ user: { id: "U1", name: "Ada" } });
         expect(seen).toEqual([{ user: "U1", platform: "fake" }]);
     });
@@ -23,14 +23,14 @@ describe("onThreadStarted routing", () => {
         channel.onThreadStarted(() => {
             order.push(2);
         });
-        await channel.start();
+        await channel.ɵruntime.start();
         await fake.emitThreadStarted();
         expect(order).toEqual([1, 2]);
     });
     it("is a no-op when no handler is registered", async () => {
         const fake = new FakeAdapter();
         const channel = createChannel({ adapters: [fake] });
-        await channel.start();
+        await channel.ɵruntime.start();
         // Should not throw.
         await expect(Promise.resolve(fake.emitThreadStarted())).resolves.toBeUndefined();
     });
@@ -44,7 +44,7 @@ describe("Thread.setSuggestedPrompts / setTitle capability gating", () => {
             results.push(await thread.setSuggestedPrompts([{ title: "Triage", message: "Triage my issues" }], { title: "Try" }));
             results.push(await thread.setTitle("My conversation"));
         });
-        await channel.start();
+        await channel.ɵruntime.start();
         await fake.emitThreadStarted({ replyTarget: { channel: "D1" } });
         expect(results).toEqual([{ ok: true }, { ok: true }]);
         expect(fake.suggestedPromptsCalls).toHaveLength(1);
@@ -65,7 +65,7 @@ describe("Thread.setSuggestedPrompts / setTitle capability gating", () => {
             results.push(await thread.setSuggestedPrompts([]));
             results.push(await thread.setTitle("nope"));
         });
-        await channel.start();
+        await channel.ɵruntime.start();
         await fake.emitThreadStarted();
         expect(results[0].ok).toBe(false);
         expect(results[0].error).toMatch(/does not support suggested prompts/);

package/dist/thread-ephemeral.test.js CHANGED Viewed

@@ -4,7 +4,7 @@ import { FakeAdapter } from "./testing/fake-adapter.js";
 async function runOnMessage(fake, fn) {
     const channel = createChannel({ adapters: [fake] });
     channel.onMessage(fn);
-    await channel.start();
+    await channel.ɵruntime.start();
     fake.emitTurn({ userText: "hi", user: { id: "U1" } });
     await new Promise((r) => setTimeout(r, 0));
 }

package/dist/thread-reactions.test.js CHANGED Viewed

@@ -11,7 +11,7 @@ describe("Thread.react / unreact", () => {
             results.push(await thread.react(message.ref, emoji.thumbs_up));
             results.push(await thread.unreact(message.ref, emoji.thumbs_up));
         });
-        await channel.start();
+        await channel.ɵruntime.start();
         fake.emitTurn({ userText: "hi" });
         await new Promise((r) => setTimeout(r, 0));
         expect(results).toEqual([{ ok: true }, { ok: true }]);
@@ -29,7 +29,7 @@ describe("Thread.react / unreact", () => {
         channel.onMessage(async ({ thread, message }) => {
             res = await thread.react(message.ref, emoji.heart);
         });
-        await channel.start();
+        await channel.ɵruntime.start();
         fake.emitTurn({ userText: "hi" });
         await new Promise((r) => setTimeout(r, 0));
         expect(res.ok).toBe(false);

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@copilotkit/channels-core",
-  "version": "0.2.1",
+  "version": "0.3.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.57",
     "@ag-ui/core": "0.0.57",
     "zod-to-json-schema": "^3.24.1",
-    "@copilotkit/channels-ui": "~0.2.1",
-    "@copilotkit/core": "^1.63.1",
-    "@copilotkit/shared": "^1.63.1"
+    "@copilotkit/channels-ui": "~0.3.0",
+    "@copilotkit/shared": "^1.63.2",
+    "@copilotkit/core": "^1.63.2"
   },
   "devDependencies": {
     "@types/node": "^22.10.0",