@copilotkit/channels-core 0.5.0 → 0.5.1-canary.1785633429

package/dist/source-platform.test.js

@@ -21,6 +21,7 @@ test("an ingress source platform reaches the text thread and its tool context",
         },
     ]);
     const channel = createChannel({
+        identifyUser: "platform",
         adapters: [adapter],
         agent: () => agent,
         tools: [
@@ -31,6 +32,8 @@ test("an ingress source platform reaches the text thread and its tool context",
                 handler: (_args, ctx) => {
                     observed.toolPlatform = ctx.platform;
                     observed.toolThreadPlatform = ctx.thread.platform;
+                    observed.toolUser = ctx.user?.id;
+                    observed.toolActor = ctx.actor.id;
                     return "captured";
                 },
             },
@@ -47,30 +50,41 @@ test("an ingress source platform reaches the text thread and its tool context",
         replyTarget: {},
         userText: "hello",
         platform: "slack",
+        actor: { id: "U1", kind: "human", name: "Ada" },
+        identityContext: {
+            tenant: { id: "T1" },
+            installation: { id: "I1" },
+            conversation: { id: "conversation-1", kind: "channel" },
+            trigger: "message",
+            event: { id: "E1" },
+            raw: {},
+        },
     });
     expect(observed).toEqual({
         messagePlatform: "slack",
         threadPlatform: "slack",
         toolPlatform: "slack",
         toolThreadPlatform: "slack",
+        toolUser: "slack:T1:U1",
+        toolActor: "U1",
     });
 });
 test("an ingress source platform scopes identity resolution and event dedupe", async () => {
     const state = new MemoryStore();
     const dedupeSeen = vi.spyOn(state.dedup, "seen").mockResolvedValue(false);
-    const identity = vi.fn(() => "person-1");
+    const identifyUser = vi.fn(() => ({ id: "person-1", name: "Person One" }));
     const adapter = new FakeAdapter({ platform: "intelligence" });
     const channel = createChannel({
         adapters: [adapter],
+        identifyUser,
         store: {
             adapter: state,
-            identity,
             transcripts: {},
         },
     });
-    let userKey;
+    let userId;
     channel.onMessage(({ message }) => {
-        userKey = message.userKey;
+        userId = message.user?.id;
     });
     await channel.ɵruntime.start();
     await adapter.getSink().onTurn({
@@ -79,14 +93,14 @@ test("an ingress source platform scopes identity resolution and event dedupe", a
         userText: "hello",
         platform: "teams",
         eventId: "event-1",
-        user: { id: "user-1" },
+        actor: { id: "user-1", kind: "human" },
     });
     expect(dedupeSeen).toHaveBeenCalledWith("message:teams:created:event-1:event-1", 300_000);
-    expect(identity).toHaveBeenCalledWith(expect.objectContaining({
-        adapter: "teams",
-        message: expect.objectContaining({ platform: "teams" }),
+    expect(identifyUser).toHaveBeenCalledWith(expect.objectContaining({
+        provider: "teams",
+        actor: expect.objectContaining({ id: "user-1" }),
     }));
-    expect(userKey).toBe("person-1");
+    expect(userId).toBe("person-1");
 });
 test("non-text ingress keeps source platform in handler contexts and dedupe keys", async () => {
     const state = new MemoryStore();
@@ -94,6 +108,7 @@ test("non-text ingress keeps source platform in handler contexts and dedupe keys
     const adapter = new FakeAdapter({ platform: "intelligence" });
     const observed = {};
     const channel = createChannel({
+        identifyUser: "platform",
         adapters: [adapter],
         store: { adapter: state },
     });

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

@@ -1 +1 @@
-{"version":3,"file":"kv-action-store.d.ts","sourceRoot":"","sources":["../../src/state/kv-action-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAkB,MAAM,oBAAoB,CAAC;AACtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAInD,uFAAuF;AACvF,wBAAgB,aAAa,CAC3B,KAAK,EAAE,UAAU,EACjB,IAAI,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/B,WAAW,CAOb"}
+{"version":3,"file":"kv-action-store.d.ts","sourceRoot":"","sources":["../../src/state/kv-action-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAkB,MAAM,oBAAoB,CAAC;AACtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAInD,uFAAuF;AACvF,wBAAgB,aAAa,CAC3B,KAAK,EAAE,UAAU,EACjB,IAAI,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/B,WAAW,CAQb"}

package/dist/state/kv-action-store.js

@@ -4,6 +4,7 @@ export function kvActionStore(state, opts) {
     return {
         put: (id, snap, ttlMs) => state.kv.set(key(id), snap, ttlMs ?? opts?.defaultTtlMs),
         get: (id) => state.kv.get(key(id)),
+        consume: (id) => state.kv.consume(key(id)),
         delete: (id) => state.kv.delete(key(id)),
     };
 }

package/dist/state/kv-action-store.test.js

@@ -18,4 +18,15 @@ describe("kvActionStore", () => {
         await store.delete("ck:abc");
         expect(await store.get("ck:abc")).toBeUndefined();
     });
+    it("consumes a snapshot once via state.kv", async () => {
+        const state = new MemoryStore();
+        const store = kvActionStore(state);
+        const snap = {
+            path: [0, "onClick"],
+            conversationKey: "c",
+        };
+        await store.put("ck:once", snap);
+        expect(await store.consume("ck:once")).toEqual(snap);
+        expect(await store.consume("ck:once")).toBeUndefined();
+    });
 });

package/dist/state/memory-store.d.ts

@@ -8,6 +8,7 @@ export declare class MemoryStore implements StateStore {
         get: <T>(key: string) => Promise<T | undefined>;
         set: <T>(key: string, value: T, ttlMs?: number) => Promise<void>;
         delete: (key: string) => Promise<void>;
+        consume: <T>(key: string) => Promise<T | undefined>;
     };
     list: {
         append: <T>(key: string, value: T, opts?: {

package/dist/state/memory-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory-store.d.ts","sourceRoot":"","sources":["../../src/state/memory-store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAQnD,qBAAa,WAAY,YAAW,UAAU;IAC5C,OAAO,CAAC,KAAK,CAAwC;IACrD,OAAO,CAAC,KAAK,CAA0C;IACvD,OAAO,CAAC,KAAK,CAA4D;IACzE,OAAO,CAAC,MAAM,CAAgC;IAE9C,EAAE;cACY,CAAC,OAAO,MAAM,KAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;cAQvC,CAAC,OAAO,MAAM,SAAS,CAAC,UAAU,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;sBAMhD,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;MAG1C;IAEF,IAAI;iBACa,CAAC,OACT,MAAM,SACJ,CAAC,SACD;YAAE,MAAM,CAAC,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE,KACzC,OAAO,CAAC,MAAM,CAAC;gBAYJ,CAAC,OAAO,MAAM,yBAAoB,MAAM,KAAG,OAAO,CAAC,CAAC,EAAE,CAAC;oBASnD,MAAM,UAAU,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;sBAMpC,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;MAG1C;IAEF,IAAI;uBAEK,MAAM,SACJ;YAAE,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE,KACxB,OAAO,CAAC;YAAE,KAAK,EAAE,MAAM,CAAA;SAAE,GAAG,IAAI,CAAC;uBAWf,MAAM,SAAS,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;MAI1D;IAEF,KAAK;oBACe,MAAM,SAAS,MAAM,KAAG,OAAO,CAAC,OAAO,CAAC;MAO1D;IAEF,KAAK;kBACa,CAAC,OACV,MAAM,SACJ,CAAC,SACD;YAAE,OAAO,CAAC,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,aAAa,GAAG,aAAa,CAAA;SAAE,KAClE,OAAO,CAAC,MAAM,CAAC;kBAaF,CAAC,OAAO,MAAM,KAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;qBAIpC,MAAM,KAAG,OAAO,CAAC,MAAM,CAAC;MAE3C;CACH"}
+{"version":3,"file":"memory-store.d.ts","sourceRoot":"","sources":["../../src/state/memory-store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAQnD,qBAAa,WAAY,YAAW,UAAU;IAC5C,OAAO,CAAC,KAAK,CAAwC;IACrD,OAAO,CAAC,KAAK,CAA0C;IACvD,OAAO,CAAC,KAAK,CAA4D;IACzE,OAAO,CAAC,MAAM,CAAgC;IAE9C,EAAE;cACY,CAAC,OAAO,MAAM,KAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;cAQvC,CAAC,OAAO,MAAM,SAAS,CAAC,UAAU,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;sBAMhD,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;kBAG1B,CAAC,OAAO,MAAM,KAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;MASvD;IAEF,IAAI;iBACa,CAAC,OACT,MAAM,SACJ,CAAC,SACD;YAAE,MAAM,CAAC,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE,KACzC,OAAO,CAAC,MAAM,CAAC;gBAYJ,CAAC,OAAO,MAAM,yBAAoB,MAAM,KAAG,OAAO,CAAC,CAAC,EAAE,CAAC;oBASnD,MAAM,UAAU,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;sBAMpC,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;MAG1C;IAEF,IAAI;uBAEK,MAAM,SACJ;YAAE,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE,KACxB,OAAO,CAAC;YAAE,KAAK,EAAE,MAAM,CAAA;SAAE,GAAG,IAAI,CAAC;uBAWf,MAAM,SAAS,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;MAI1D;IAEF,KAAK;oBACe,MAAM,SAAS,MAAM,KAAG,OAAO,CAAC,OAAO,CAAC;MAO1D;IAEF,KAAK;kBACa,CAAC,OACV,MAAM,SACJ,CAAC,SACD;YAAE,OAAO,CAAC,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,aAAa,GAAG,aAAa,CAAA;SAAE,KAClE,OAAO,CAAC,MAAM,CAAC;kBAaF,CAAC,OAAO,MAAM,KAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;qBAIpC,MAAM,KAAG,OAAO,CAAC,MAAM,CAAC;MAE3C;CACH"}

package/dist/state/memory-store.js

@@ -24,6 +24,15 @@ export class MemoryStore {
         delete: async (key) => {
             this.kvMap.delete(key);
         },
+        consume: async (key) => {
+            const e = this.kvMap.get(key);
+            if (!live(e)) {
+                this.kvMap.delete(key);
+                return undefined;
+            }
+            this.kvMap.delete(key);
+            return e.value;
+        },
     };
     list = {
         append: async (key, value, opts) => {

package/dist/state/state-store.d.ts

@@ -12,6 +12,8 @@ export interface StateStore {
         get<T>(key: string): Promise<T | undefined>;
         set<T>(key: string, value: T, ttlMs?: number): Promise<void>;
         delete(key: string): Promise<void>;
+        /** Atomically return and delete one live value. */
+        consume<T>(key: string): Promise<T | undefined>;
     };
     list: {
         /**

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

@@ -1 +1 @@
-{"version":3,"file":"state-store.d.ts","sourceRoot":"","sources":["../../src/state/state-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE;QACF,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;QAC5C,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC7D,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KACpC,CAAC;IACF,IAAI,EAAE;QACJ;;;;WAIG;QACH,MAAM,CAAC,CAAC,EACN,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,CAAC,EACR,IAAI,CAAC,EAAE;YAAE,MAAM,CAAC,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE,GACzC,OAAO,CAAC,MAAM,CAAC,CAAC;QACnB;;;;WAIG;QACH,KAAK,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;QACnE,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QACjD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KACpC,CAAC;IACF,IAAI,EAAE;QACJ;;;;;WAKG;QACH,OAAO,CACL,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE;YAAE,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE,GACxB,OAAO,CAAC;YAAE,KAAK,EAAE,MAAM,CAAA;SAAE,GAAG,IAAI,CAAC,CAAC;QACrC,kDAAkD;QAClD,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KACpD,CAAC;IACF,KAAK,EAAE;QACL,+EAA+E;QAC/E,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;KACpD,CAAC;IACF,KAAK,EAAE;QACL,OAAO,CAAC,CAAC,EACP,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,CAAC,EACR,IAAI,CAAC,EAAE;YAAE,OAAO,CAAC,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,aAAa,GAAG,aAAa,CAAA;SAAE,GAClE,OAAO,CAAC,MAAM,CAAC,CAAC;QACnB,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;QAChD,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;KACrC,CAAC;CACH"}
+{"version":3,"file":"state-store.d.ts","sourceRoot":"","sources":["../../src/state/state-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE;QACF,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;QAC5C,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC7D,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QACnC,mDAAmD;QACnD,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;KACjD,CAAC;IACF,IAAI,EAAE;QACJ;;;;WAIG;QACH,MAAM,CAAC,CAAC,EACN,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,CAAC,EACR,IAAI,CAAC,EAAE;YAAE,MAAM,CAAC,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE,GACzC,OAAO,CAAC,MAAM,CAAC,CAAC;QACnB;;;;WAIG;QACH,KAAK,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;QACnE,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QACjD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KACpC,CAAC;IACF,IAAI,EAAE;QACJ;;;;;WAKG;QACH,OAAO,CACL,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE;YAAE,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE,GACxB,OAAO,CAAC;YAAE,KAAK,EAAE,MAAM,CAAA;SAAE,GAAG,IAAI,CAAC,CAAC;QACrC,kDAAkD;QAClD,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KACpD,CAAC;IACF,KAAK,EAAE;QACL,+EAA+E;QAC/E,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;KACpD,CAAC;IACF,KAAK,EAAE;QACL,OAAO,CAAC,CAAC,EACP,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,CAAC,EACR,IAAI,CAAC,EAAE;YAAE,OAAO,CAAC,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,aAAa,GAAG,aAAa,CAAA;SAAE,GAClE,OAAO,CAAC,MAAM,CAAC,CAAC;QACnB,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;QAChD,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;KACrC,CAAC;CACH"}

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

@@ -21,6 +21,7 @@ describe("createChannel telemetry wiring", () => {
         // telemetry) is resolved there, not at construction, so an adapter attached
         // via addAdapter can still provide the persistence backend.
         const channel = createChannel({
+            identifyUser: "platform",
             adapters: [new FakeAdapter()],
             components: [
                 function Card() {
@@ -37,14 +38,14 @@ 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] });
+        const channel = createChannel({ identifyUser: "platform", adapters: [ok] });
         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] });
+        const bot2 = createChannel({ identifyUser: "platform", adapters: [bad] });
         // All adapters failed → start() rejects (the channel is dead; the runtime
         // reports status "error"). The start_failed telemetry is still captured
         // before the throw.
@@ -57,6 +58,7 @@ describe("createChannel telemetry wiring", () => {
     it("emits oss.channel.agent_run on a successful run", async () => {
         const fake = new FakeAdapter();
         const channel = createChannel({
+            identifyUser: "platform",
             adapters: [fake],
             agent: () => new FakeAgent(),
         });

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

@@ -34,6 +34,7 @@ describe("oss.channel.* end-to-end (real ChannelTelemetry, only network boundary
     it("flows configured -> started -> agent_run with anonymous_id + channel_session_id and no env config", async () => {
         const fake = new FakeAdapter();
         const channel = createChannel({
+            identifyUser: "platform",
             adapters: [fake],
             agent: () => new FakeAgent(),
         });

package/dist/telemetry/install-id.test.js

@@ -10,6 +10,11 @@ class FakeDurableStore {
         get: async (k) => this.map.get(k),
         set: async (k, v) => void this.map.set(k, v),
         delete: async (k) => void this.map.delete(k),
+        consume: async (k) => {
+            const value = this.map.get(k);
+            this.map.delete(k);
+            return value;
+        },
     };
     list = {};
     lock = {};

package/dist/testing/fake-adapter.d.ts

@@ -1,13 +1,31 @@
-import type { ChannelNode, MessageRef, PlatformUser, ThreadMessage } from "@copilotkit/channels-ui";
-import type { PlatformAdapter, SurfaceCapabilities, IngressSink, IncomingTurn, IncomingThreadStart, InteractionEvent, IncomingCommand, RunRenderer, ReplyTarget, NativePayload, UserQuery, ConversationStore, IncomingReaction, IncomingModalSubmit, IncomingModalClose, ModalSubmitResult } from "../platform-adapter.js";
+import type { ChannelNode, MessageRef, ProviderActor, ThreadMessage } from "@copilotkit/channels-ui";
+import type { PlatformAdapter, SurfaceCapabilities, IngressSink, IncomingTurn, IncomingThreadStart, IncomingWelcome, InteractionEvent, IncomingCommand, RunRenderer, ReplyTarget, NativePayload, UserQuery, ConversationStore, IncomingReaction, IncomingModalSubmit, IncomingModalClose, ModalSubmitResult } from "../platform-adapter.js";
 import type { CommandSpec } from "../commands.js";
 import type { StateStore } from "../state/state-store.js";
+type OptionalIdentity<T extends {
+    actor: unknown;
+    identityContext: unknown;
+}> = Omit<T, "actor" | "identityContext"> & Partial<Pick<T, "actor" | "identityContext">>;
+type FakeIngressSink = {
+    onTurn(turn: OptionalIdentity<Omit<IncomingTurn, "operation">> & {
+        operation?: IncomingTurn["operation"];
+    }): void | Promise<void>;
+    onInteraction(event: OptionalIdentity<InteractionEvent>): void | Promise<void>;
+    onCommand(event: OptionalIdentity<IncomingCommand>): void | Promise<void>;
+    onThreadStarted(event: OptionalIdentity<IncomingThreadStart>): void | Promise<void>;
+    onWelcome(event: OptionalIdentity<IncomingWelcome>): void | Promise<void>;
+    onReaction(event: OptionalIdentity<IncomingReaction>): void | Promise<void>;
+    onModalSubmit(event: OptionalIdentity<IncomingModalSubmit>): Promise<ModalSubmitResult | void>;
+    onModalClose(event: OptionalIdentity<IncomingModalClose>): void | Promise<void>;
+};
 /** A RunRenderer whose subscriber captures tool-call-end and custom (interrupt) events — used by run-loop tests. */
 export declare function makeFakeRunRenderer(): RunRenderer;
 export declare class FakeAdapter implements PlatformAdapter {
     platform: string;
     readonly capabilities: SurfaceCapabilities;
     readonly ackDeadlineMs = 3000;
+    supportsIntelligenceMemory?: boolean;
+    runAgentLifecycle?: PlatformAdapter["runAgentLifecycle"];
     /** When true, `start()` rejects (set via constructor `failStart`). */
     readonly failStart: boolean;
     /** When true, `registerCommands()` rejects (set via constructor `failRegisterCommands`). */
@@ -57,18 +75,15 @@ export declare class FakeAdapter implements PlatformAdapter {
     /** History returned by getMessages(); override in tests. */
     messages: ThreadMessage[];
     /** User returned by lookupUser(); override in tests. */
-    user?: PlatformUser;
+    user?: ProviderActor;
     /** Optional persistence backend the adapter provides (test-only); exercises createChannel's store resolution. */
     stateStore?: StateStore;
     private sink?;
     private counter;
     private turnCounter;
     /** Expose the registered sink so tests can invoke onTurn() directly for overlap/lock tests. */
-    getSink(): Omit<IngressSink, "onTurn"> & {
-        onTurn(turn: Omit<IncomingTurn, "operation"> & {
-            operation?: IncomingTurn["operation"];
-        }): void | Promise<void>;
-    };
+    getSink(): FakeIngressSink;
+    private withIdentity;
     start(sink: IngressSink): Promise<void>;
     stop(): Promise<void>;
     render(ir: ChannelNode[]): NativePayload;
@@ -78,7 +93,7 @@ export declare class FakeAdapter implements PlatformAdapter {
     delete(_ref: MessageRef): Promise<void>;
     createRunRenderer(_target: ReplyTarget): RunRenderer;
     decodeInteraction(raw: unknown): InteractionEvent | undefined;
-    lookupUser(_q: UserQuery): Promise<PlatformUser | undefined>;
+    lookupUser(_q: UserQuery): Promise<ProviderActor | undefined>;
     getMessages(_target: ReplyTarget): Promise<ThreadMessage[]>;
     /** Suggested-prompt calls recorded by the capability-gated method (when present). */
     suggestedPromptsCalls: {
@@ -124,6 +139,7 @@ export declare class FakeAdapter implements PlatformAdapter {
     openModal?: PlatformAdapter["openModal"];
     emitTurn(partial: Partial<IncomingTurn>): void;
     emitThreadStarted(partial?: Partial<IncomingThreadStart>): Promise<void> | void;
+    emitWelcome(partial?: Partial<IncomingWelcome>): Promise<void> | void;
     emitInteraction(partial: Partial<InteractionEvent>): void;
     emitCommand(partial: Partial<IncomingCommand> & {
         command: string;
@@ -141,4 +157,5 @@ export declare class FakeAdapter implements PlatformAdapter {
     registeredCommands?: readonly CommandSpec[];
     registerCommands(commands: readonly CommandSpec[]): Promise<void>;
 }
+export {};
 //# sourceMappingURL=fake-adapter.d.ts.map

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

@@ -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,wEAAwE;QACxE,aAAa,CAAC,EAAE,OAAO,CAAC;QACxB,+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;IAgER,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;IACpB,OAAO,CAAC,WAAW,CAAK;IAExB,+FAA+F;IAC/F,OAAO,IAAI,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,GAAG;QACvC,MAAM,CACJ,IAAI,EAAE,IAAI,CAAC,YAAY,EAAE,WAAW,CAAC,GAAG;YACtC,SAAS,CAAC,EAAE,YAAY,CAAC,WAAW,CAAC,CAAC;SACvC,GACA,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KACzB;IAuCK,KAAK,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAKvC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,MAAM,CAAC,EAAE,EAAE,WAAW,EAAE,GAAG,aAAa;IAGlC,IAAI,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC;IAIlE,MAAM,CAAC,GAAG,EAAE,UAAU,EAAE,EAAE,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAGzD,MAAM,CACV,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,GAC5B,OAAO,CAAC,UAAU,CAAC;IAMhB,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAE7C,iBAAiB,CAAC,OAAO,EAAE,WAAW,GAAG,WAAW;IAKpD,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,gBAAgB,GAAG,SAAS;IAGvD,UAAU,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;IAG5D,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAIjE,qFAAqF;IACrF,qBAAqB,EAAE;QACrB,MAAM,EAAE,WAAW,CAAC;QACpB,OAAO,EAAE,aAAa,CAAC;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAC3D,IAAI,CAAC,EAAE;YAAE,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KAC3B,EAAE,CAAM;IACT,mBAAmB,CAAC,EAAE,eAAe,CAAC,qBAAqB,CAAC,CAAC;IAE7D,iFAAiF;IACjF,gBAAgB,EAAE;QAAE,MAAM,EAAE,WAAW,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAM;IAChE,cAAc,CAAC,EAAE,eAAe,CAAC,gBAAgB,CAAC,CAAC;IAGnD,cAAc,EAAE;QAAE,GAAG,EAAE,UAAU,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAM;IAC1D,gBAAgB,EAAE;QAAE,GAAG,EAAE,UAAU,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAM;IAC5D,WAAW,CAAC,EAAE,eAAe,CAAC,aAAa,CAAC,CAAC;IAC7C,cAAc,CAAC,EAAE,eAAe,CAAC,gBAAgB,CAAC,CAAC;IAGnD,cAAc,EAAE;QACd,IAAI,EAAE,OAAO,CAAC;QACd,EAAE,EAAE,WAAW,EAAE,CAAC;QAClB,IAAI,EAAE;YAAE,YAAY,EAAE,OAAO,CAAA;SAAE,CAAC;KACjC,EAAE,CAAM;IACT,aAAa,CAAC,EAAE,eAAe,CAAC,eAAe,CAAC,CAAC;IAGjD,YAAY,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,WAAW,EAAE,CAAA;KAAE,EAAE,CAAM;IAC9D,WAAW,CAAC,EAAE,eAAe,CAAC,aAAa,CAAC,CAAC;IAC7C,SAAS,CAAC,EAAE,eAAe,CAAC,WAAW,CAAC,CAAC;IAGzC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI;IAgB9C,iBAAiB,CACf,OAAO,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,GACrC,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAQvB,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI;IAUzD,WAAW,CACT,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,GACtD,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IASvB,YAAY,CACV,OAAO,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GACxD,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAUvB,eAAe,CACb,OAAO,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,GAC7D,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,GAAG,SAAS;IAQhD,cAAc,CACZ,OAAO,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,GAC5D,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAIvB,gGAAgG;IAChG,kBAAkB,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IACtC,gBAAgB,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAKxE"}
+{"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

@@ -37,6 +37,8 @@ export class FakeAdapter {
     platform = "fake";
     capabilities;
     ackDeadlineMs = 3000;
+    supportsIntelligenceMemory;
+    runAgentLifecycle;
     /** When true, `start()` rejects (set via constructor `failStart`). */
     failStart;
     /** When true, `registerCommands()` rejects (set via constructor `failRegisterCommands`). */
@@ -149,24 +151,54 @@ export class FakeAdapter {
         const adapter = this;
         return new Proxy(sink, {
             get(target, property, receiver) {
-                if (property !== "onTurn") {
-                    return Reflect.get(target, property, receiver);
+                if (property === "onTurn") {
+                    return (turn) => {
+                        const syntheticId = turn.eventId ?? `fake-message-${++adapter.turnCounter}`;
+                        return sink.onTurn(adapter.withIdentity({
+                            ...turn,
+                            operation: turn.operation ?? {
+                                kind: "created",
+                                logicalMessageId: syntheticId,
+                                revisionId: syntheticId,
+                                mentioned: true,
+                            },
+                        }, "message"));
+                    };
                 }
-                return (turn) => {
-                    const syntheticId = turn.eventId ?? `fake-message-${++adapter.turnCounter}`;
-                    return sink.onTurn({
-                        ...turn,
-                        operation: turn.operation ?? {
-                            kind: "created",
-                            logicalMessageId: syntheticId,
-                            revisionId: syntheticId,
-                            mentioned: true,
-                        },
-                    });
+                const triggers = {
+                    onInteraction: "interaction",
+                    onCommand: "command",
+                    onThreadStarted: "thread-start",
+                    onWelcome: "welcome",
+                    onReaction: "reaction",
+                    onModalSubmit: "modal-submit",
+                    onModalClose: "modal-close",
                 };
+                const trigger = triggers[property];
+                if (trigger) {
+                    return (event) => target[property](adapter.withIdentity(event, trigger));
+                }
+                return Reflect.get(target, property, receiver);
             },
         });
     }
+    withIdentity(event, trigger) {
+        const conversationKey = typeof event.conversationKey === "string" ? event.conversationKey : "c";
+        const actor = event.actor ??
+            { id: "", kind: "unknown" };
+        return {
+            ...event,
+            actor,
+            identityContext: event.identityContext ?? {
+                tenant: { id: "fake-tenant" },
+                installation: { id: "fake-installation" },
+                conversation: { id: conversationKey, kind: "test" },
+                trigger,
+                event: {},
+                raw: {},
+            },
+        };
+    }
     async start(sink) {
         if (this.failStart)
             throw new Error("fake-adapter: start failed");
@@ -230,7 +262,7 @@ export class FakeAdapter {
     // --- test helpers ---
     emitTurn(partial) {
         const syntheticId = partial.eventId ?? `fake-message-${++this.turnCounter}`;
-        void this.sink?.onTurn({
+        void this.getSink().onTurn({
             conversationKey: "c",
             replyTarget: {},
             userText: "",
@@ -245,13 +277,21 @@ export class FakeAdapter {
         });
     }
     emitThreadStarted(partial) {
-        return this.sink?.onThreadStarted({
+        return this.getSink().onThreadStarted({
             conversationKey: "c",
             replyTarget: {},
             platform: "fake",
             ...partial,
         });
     }
+    emitWelcome(partial) {
+        return this.getSink().onWelcome(this.withIdentity({
+            conversationKey: "c",
+            replyTarget: {},
+            platform: "fake",
+            ...partial,
+        }, "welcome"));
+    }
     emitInteraction(partial) {
         const evt = {
             id: "",
@@ -259,11 +299,11 @@ export class FakeAdapter {
             replyTarget: {},
             ...partial,
         };
-        this.interactionsSeen.push(evt);
-        void this.sink?.onInteraction(evt);
+        this.interactionsSeen.push(this.withIdentity(evt, "interaction"));
+        void this.getSink().onInteraction(evt);
     }
     emitCommand(partial) {
-        return this.sink?.onCommand({
+        return this.getSink().onCommand({
             text: "",
             conversationKey: "c",
             replyTarget: {},
@@ -272,7 +312,7 @@ export class FakeAdapter {
         });
     }
     emitReaction(partial) {
-        return this.sink?.onReaction({
+        return this.getSink().onReaction({
             added: true,
             conversationKey: "c",
             replyTarget: {},
@@ -282,7 +322,7 @@ export class FakeAdapter {
         });
     }
     emitModalSubmit(partial) {
-        return this.sink?.onModalSubmit({
+        return this.getSink().onModalSubmit({
             values: {},
             platform: "fake",
             raw: {},
@@ -290,7 +330,11 @@ export class FakeAdapter {
         });
     }
     emitModalClose(partial) {
-        return this.sink?.onModalClose({ platform: "fake", raw: {}, ...partial });
+        return this.getSink().onModalClose({
+            platform: "fake",
+            raw: {},
+            ...partial,
+        });
     }
     /** Commands handed to the adapter via `registerCommands`; asserts the capability hook fires. */
     registeredCommands;

package/dist/testing/state-store-conformance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"state-store-conformance.d.ts","sourceRoot":"","sources":["../../src/testing/state-store-conformance.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAE1D,gFAAgF;AAChF,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,EAC5C,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,GAC1C,IAAI,CAwHN"}
+{"version":3,"file":"state-store-conformance.d.ts","sourceRoot":"","sources":["../../src/testing/state-store-conformance.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAE1D,gFAAgF;AAChF,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,EAC5C,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,GAC1C,IAAI,CAwIN"}

package/dist/testing/state-store-conformance.js

@@ -17,11 +17,27 @@ export function runStateStoreConformance(name, make, teardown) {
                 expect(await s.kv.get("a")).toBeUndefined();
             });
             it("missing key is undefined", async () => expect(await s.kv.get("nope")).toBeUndefined());
+            it("atomically consumes one live value", async () => {
+                await s.kv.set("once", { n: 1 });
+                const results = await Promise.all([
+                    s.kv.consume("once"),
+                    s.kv.consume("once"),
+                ]);
+                expect(results.filter((value) => value !== undefined)).toEqual([
+                    { n: 1 },
+                ]);
+                expect(await s.kv.get("once")).toBeUndefined();
+            });
             it("expires after ttl", async () => {
                 await s.kv.set("t", 1, 30);
                 await new Promise((r) => setTimeout(r, 60));
                 expect(await s.kv.get("t")).toBeUndefined();
             });
+            it("does not return an expired value from consume", async () => {
+                await s.kv.set("expired-once", 1, 30);
+                await new Promise((r) => setTimeout(r, 60));
+                expect(await s.kv.consume("expired-once")).toBeUndefined();
+            });
         });
         describe("list", () => {
             it("appends oldest-first and ranges", async () => {

package/dist/thread-capabilities.test.js

@@ -4,18 +4,29 @@ import { FakeAdapter } from "./testing/fake-adapter.js";
 describe("onThreadStarted routing", () => {
     it("invokes registered handlers with the thread and user", async () => {
         const fake = new FakeAdapter();
-        const channel = createChannel({ adapters: [fake] });
+        const channel = createChannel({
+            adapters: [fake],
+            identifyUser: ({ actor }) => ({
+                id: actor.id,
+                name: actor.name ?? actor.id,
+            }),
+        });
         const seen = [];
-        channel.onThreadStarted(({ thread, user }) => {
-            seen.push({ user: user?.id, platform: thread.platform });
+        channel.onThreadStarted(({ thread, user, actor }) => {
+            seen.push({ user: user?.id, actor: actor.id, platform: thread.platform });
         });
         await channel.ɵruntime.start();
-        await fake.emitThreadStarted({ user: { id: "U1", name: "Ada" } });
-        expect(seen).toEqual([{ user: "U1", platform: "fake" }]);
+        await fake.emitThreadStarted({
+            actor: { id: "U1", kind: "human", name: "Ada" },
+        });
+        expect(seen).toEqual([{ user: "U1", actor: "U1", platform: "fake" }]);
     });
     it("invokes every registered handler in order", async () => {
         const fake = new FakeAdapter();
-        const channel = createChannel({ adapters: [fake] });
+        const channel = createChannel({
+            identifyUser: "platform",
+            adapters: [fake],
+        });
         const order = [];
         channel.onThreadStarted(() => {
             order.push(1);
@@ -29,7 +40,10 @@ describe("onThreadStarted routing", () => {
     });
     it("is a no-op when no handler is registered", async () => {
         const fake = new FakeAdapter();
-        const channel = createChannel({ adapters: [fake] });
+        const channel = createChannel({
+            identifyUser: "platform",
+            adapters: [fake],
+        });
         await channel.ɵruntime.start();
         // Should not throw.
         await expect(Promise.resolve(fake.emitThreadStarted())).resolves.toBeUndefined();
@@ -38,7 +52,10 @@ describe("onThreadStarted routing", () => {
 describe("Thread.setSuggestedPrompts / setTitle capability gating", () => {
     it("delegates to the adapter when supported", async () => {
         const fake = new FakeAdapter();
-        const channel = createChannel({ adapters: [fake] });
+        const channel = createChannel({
+            identifyUser: "platform",
+            adapters: [fake],
+        });
         const results = [];
         channel.onThreadStarted(async ({ thread }) => {
             results.push(await thread.setSuggestedPrompts([{ title: "Triage", message: "Triage my issues" }], { title: "Try" }));
@@ -59,7 +76,10 @@ describe("Thread.setSuggestedPrompts / setTitle capability gating", () => {
     });
     it("returns { ok: false } without throwing when unsupported", async () => {
         const fake = new FakeAdapter({ paneMethods: false });
-        const channel = createChannel({ adapters: [fake] });
+        const channel = createChannel({
+            identifyUser: "platform",
+            adapters: [fake],
+        });
         const results = [];
         channel.onThreadStarted(async ({ thread }) => {
             results.push(await thread.setSuggestedPrompts([]));

package/dist/thread-ephemeral.test.js

@@ -2,10 +2,13 @@ import { describe, it, expect } from "vitest";
 import { createChannel } from "./create-channel.js";
 import { FakeAdapter } from "./testing/fake-adapter.js";
 async function runOnMessage(fake, fn) {
-    const channel = createChannel({ adapters: [fake] });
+    const channel = createChannel({ identifyUser: "platform", adapters: [fake] });
     channel.onMessage(fn);
     await channel.ɵruntime.start();
-    fake.emitTurn({ userText: "hi", user: { id: "U1" } });
+    fake.emitTurn({
+        userText: "hi",
+        actor: { id: "U1", kind: "human" },
+    });
     await new Promise((r) => setTimeout(r, 0));
 }
 describe("Thread.postEphemeral", () => {
@@ -13,7 +16,7 @@ describe("Thread.postEphemeral", () => {
         const fake = new FakeAdapter({ nativeEphemeral: true });
         let res;
         await runOnMessage(fake, async ({ thread, message }) => {
-            res = await thread.postEphemeral(message.user, "psst", {
+            res = await thread.postEphemeral(message.actor, "psst", {
                 fallbackToDM: false,
             });
         });
@@ -26,7 +29,7 @@ describe("Thread.postEphemeral", () => {
         const fake = new FakeAdapter({ nativeEphemeral: false });
         let res;
         await runOnMessage(fake, async ({ thread, message }) => {
-            res = await thread.postEphemeral(message.user, "psst", {
+            res = await thread.postEphemeral(message.actor, "psst", {
                 fallbackToDM: true,
             });
         });
@@ -36,7 +39,7 @@ describe("Thread.postEphemeral", () => {
         const fake = new FakeAdapter({ nativeEphemeral: false });
         let res = "sentinel";
         await runOnMessage(fake, async ({ thread, message }) => {
-            res = await thread.postEphemeral(message.user, "psst", {
+            res = await thread.postEphemeral(message.actor, "psst", {
                 fallbackToDM: false,
             });
         });