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

package/dist/thread-promise-contract.test.js

@@ -13,6 +13,8 @@ function setupThreadWithSyncDeleteFailure(failure) {
         adapter,
         replyTarget: {},
         conversationKey: "thread-promise-contract",
+        channelName: "test",
+        threadId: "thread-promise-contract",
         registry: new ActionRegistry({ store: new InMemoryActionStore() }),
         agentFactory: (threadId) => {
             throw new Error(`agentFactory not needed in this test: ${threadId}`);
@@ -23,6 +25,8 @@ function setupThreadWithSyncDeleteFailure(failure) {
         registerWaiter: () => undefined,
         interruptHandlers: new Map(),
         state: new MemoryStore(),
+        user: null,
+        actor: { id: "actor", kind: "unknown" },
     };
     return new Thread(deps);
 }

package/dist/thread-reactions.test.js

@@ -5,7 +5,10 @@ import { FakeAdapter } from "./testing/fake-adapter.js";
 describe("Thread.react / unreact", () => {
     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.onMessage(async ({ thread, message }) => {
             results.push(await thread.react(message.ref, emoji.thumbs_up));
@@ -24,7 +27,10 @@ describe("Thread.react / unreact", () => {
     });
     it("returns { ok: false } without throwing when unsupported", async () => {
         const fake = new FakeAdapter({ reactions: false });
-        const channel = createChannel({ adapters: [fake] });
+        const channel = createChannel({
+            identifyUser: "platform",
+            adapters: [fake],
+        });
         let res;
         channel.onMessage(async ({ thread, message }) => {
             res = await thread.react(message.ref, emoji.heart);

package/dist/thread.d.ts

@@ -1,11 +1,32 @@
 import type { PlatformAdapter, ReplyTarget } from "./platform-adapter.js";
 import type { ActionRegistry } from "./action-registry.js";
-import type { AgentContentPart, Renderable, MessageRef, PlatformUser, ThreadMessage, IncomingMessage, Thread as ThreadInterface, EmojiValue, EphemeralResult } from "@copilotkit/channels-ui";
+import type { AgentContentPart, Renderable, MessageRef, ProviderActor, ApplicationUser, ThreadMessage, IncomingMessage, Thread as ThreadInterface, EmojiValue, EphemeralResult } from "@copilotkit/channels-ui";
 import type { Transcripts } from "./transcripts.js";
 import type { ChannelTool, ContextEntry, AgentToolDescriptor } from "./tools.js";
 import type { AbstractAgent } from "@ag-ui/client";
 import type { StateStore } from "./state/state-store.js";
 import type { StandardSchemaV1 } from "./standard-schema.js";
+import type { MemoryGrant } from "./memory.js";
+/** A Channel run requested Memory without an attached Intelligence backend. */
+export declare class ChannelMemoryUnavailableError extends Error {
+    readonly code = "channel_memory_unavailable";
+    constructor();
+}
+/** A Channel run requested personal Memory without an application user. */
+export declare class ChannelMemoryUserRequiredError extends Error {
+    readonly code = "channel_memory_user_required";
+    constructor();
+}
+/** A personal-Memory resume omitted the trusted principal selector. */
+export declare class ChannelMemorySubjectRequiredError extends Error {
+    readonly code = "channel_memory_subject_required";
+    constructor();
+}
+/** A resume was not triggered by a persisted one-use action capability. */
+export declare class ChannelContinuationRequiredError extends Error {
+    readonly code = "channel_continuation_required";
+    constructor();
+}
 export interface ThreadDeps {
     adapter: PlatformAdapter;
     /** Source provider for this ingress event; falls back to the adapter identity. */
@@ -21,6 +42,8 @@ export interface ThreadDeps {
     interruptHandlers: Map<string, (args: {
         payload: unknown;
         thread: Thread;
+        user: ApplicationUser | null;
+        actor: ProviderActor;
     }) => void | Promise<void>>;
     /** Pluggable persistence. Injected by createChannel; always required. */
     state: StateStore;
@@ -31,10 +54,18 @@ export interface ThreadDeps {
     stateSchema?: StandardSchemaV1;
     /** Cross-platform transcript store. Present only when `store.transcripts` is configured. */
     transcripts?: Transcripts;
-    /** Resolved cross-platform identity key for this turn (if any). */
-    userKey?: string;
     /** The inbound message that triggered this turn (for transcript bridging). */
     message?: IncomingMessage;
+    user: ApplicationUser | null;
+    actor: ProviderActor;
+    /** Declared Channel identity bound to one-use continuations. */
+    channelName: string;
+    /** Trusted canonical Thread identity bound to one-use continuations. */
+    threadId: string;
+    /** Action capability that created this interaction Thread. */
+    interactionActionId?: string;
+    /** Set only when the owning Runtime attached Intelligence Memory. */
+    intelligenceMemoryAvailable?: boolean;
     /**
      * Optional anonymous telemetry sink. Structural type (not the concrete
      * ChannelTelemetry) avoids an import cycle; the real ChannelTelemetry satisfies it.
@@ -53,9 +84,13 @@ export declare class Thread implements ThreadInterface {
     readonly supportsBlockingChoice?: boolean;
     private readonly store;
     private implicitInboundConsumed;
+    private activeContinuation?;
+    private agentRunTail;
     constructor(deps: ThreadDeps);
     private bindForPost;
     private trackOperation;
+    /** Keep one Thread's agent runs isolated while preserving failure independence. */
+    private enqueueAgentRun;
     /**
      * Wire a posted message's `onReaction` to its returned id: cache it for this
      * process and, when it came from a component, persist a durable snapshot so a
@@ -107,7 +142,7 @@ export declare class Thread implements ThreadInterface {
      * `true` → DM the user when native ephemeral is unsupported; `false` →
      * resolve to `null` when native ephemeral is unsupported.
      */
-    postEphemeral(user: PlatformUser | string, ui: Renderable, opts: {
+    postEphemeral(user: ProviderActor | string, ui: Renderable, opts: {
         fallbackToDM: boolean;
     }): Promise<EphemeralResult | null>;
     /** Record this conversation as subscribed (persisted in state). Proactive delivery to subscribed conversations is not yet wired. */
@@ -123,7 +158,7 @@ export declare class Thread implements ThreadInterface {
     /** Read the conversation's messages (returns `[]` when the adapter can't read history). */
     getMessages(): Promise<ThreadMessage[]>;
     /** Resolve a platform user by free-form query (returns `undefined` when unsupported). */
-    lookupUser(query: string): Promise<PlatformUser | undefined>;
+    lookupUser(query: string): Promise<ProviderActor | undefined>;
     /** Post a picker and wait until an interaction in this conversation resolves it. */
     awaitChoice<T = unknown>(ui: Renderable): Promise<T>;
     runAgent(input?: {
@@ -139,7 +174,7 @@ export declare class Thread implements ThreadInterface {
         prompt?: string | AgentContentPart[];
         /**
          * Auto-bridge cross-platform transcripts for this run. When truthy AND the
-         * thread has a resolved `userKey` AND a `Transcripts` instance, this:
+         * thread has a resolved `userId` AND a `Transcripts` instance, this:
          *   1. injects prior history (`transcripts.list`, default limit 20) as a
          *      context entry,
          *   2. appends the current user turn,
@@ -152,8 +187,16 @@ export declare class Thread implements ThreadInterface {
         transcript?: boolean | {
             limit?: number;
         };
+        /** Intelligence Memory access for this run only. Omission disables Memory. */
+        memory?: MemoryGrant;
+    }): Promise<MessageRef | undefined>;
+    resume(value: unknown, options?: {
+        memory?: MemoryGrant;
+        subject?: "initiator" | "actor";
     }): Promise<MessageRef | undefined>;
-    resume(value: unknown): Promise<MessageRef | undefined>;
+    private resolveResumeMemory;
+    private resolveMemory;
+    private assertMemoryAvailable;
     private run;
 }
 //# sourceMappingURL=thread.d.ts.map

package/dist/thread.d.ts.map

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

package/dist/thread.js

@@ -2,6 +2,39 @@ import { runAgentLoop } from "./run-loop.js";
 import { errorClass, normalizePlatform } from "./telemetry/sanitize-error.js";
 import { toAgentToolDescriptors } from "./tools.js";
 import { validateSchema } from "./standard-schema.js";
+import { hasMemoryAccess, resolveMemoryGrant } from "./memory.js";
+/** A Channel run requested Memory without an attached Intelligence backend. */
+export class ChannelMemoryUnavailableError extends Error {
+    code = "channel_memory_unavailable";
+    constructor() {
+        super("Channel Memory requires an attached Intelligence Runtime");
+        this.name = "ChannelMemoryUnavailableError";
+    }
+}
+/** A Channel run requested personal Memory without an application user. */
+export class ChannelMemoryUserRequiredError extends Error {
+    code = "channel_memory_user_required";
+    constructor() {
+        super("Channel user Memory requires an identified application user");
+        this.name = "ChannelMemoryUserRequiredError";
+    }
+}
+/** A personal-Memory resume omitted the trusted principal selector. */
+export class ChannelMemorySubjectRequiredError extends Error {
+    code = "channel_memory_subject_required";
+    constructor() {
+        super('Channel user Memory on resume requires subject "initiator" or "actor"');
+        this.name = "ChannelMemorySubjectRequiredError";
+    }
+}
+/** A resume was not triggered by a persisted one-use action capability. */
+export class ChannelContinuationRequiredError extends Error {
+    code = "channel_continuation_required";
+    constructor() {
+        super("Channel resume requires a valid interaction continuation");
+        this.name = "ChannelContinuationRequiredError";
+    }
+}
 /** Stable rejection for surfaces that cannot hold one run open for a choice. */
 class ChannelAwaitChoiceNotSupportedError extends Error {
     code = "channel_await_choice_not_supported";
@@ -20,6 +53,8 @@ export class Thread {
     supportsBlockingChoice;
     store;
     implicitInboundConsumed = false;
+    activeContinuation;
+    agentRunTail = Promise.resolve();
     constructor(deps) {
         this.deps = deps;
         this.platform = deps.platform ?? deps.adapter.platform;
@@ -29,7 +64,7 @@ export class Thread {
         this.store = deps.state;
     }
     async bindForPost(ui) {
-        return this.deps.registry.bindRenderable(ui, this.deps.conversationKey);
+        return this.deps.registry.bindRenderable(ui, this.deps.conversationKey, this.activeContinuation);
     }
     trackOperation(operation) {
         if (!this.deps.adapter.trackThreadOperation) {
@@ -42,6 +77,12 @@ export class Thread {
         }
         return this.deps.adapter.trackThreadOperation(this.deps.replyTarget, operation);
     }
+    /** Keep one Thread's agent runs isolated while preserving failure independence. */
+    enqueueAgentRun(operation) {
+        const result = this.agentRunTail.then(operation, operation);
+        this.agentRunTail = result.then(() => undefined, () => undefined);
+        return result;
+    }
     /**
      * Wire a posted message's `onReaction` to its returned id: cache it for this
      * process and, when it came from a component, persist a durable snapshot so a
@@ -227,7 +268,11 @@ export class Thread {
         catch (error) {
             return Promise.reject(error);
         }
-        return this.trackOperation(async () => {
+        const memoryRequest = input?.memory === undefined
+            ? undefined
+            : { user: input.memory.user, project: input.memory.project };
+        return this.enqueueAgentRun(() => this.trackOperation(async () => {
+            const memory = this.resolveMemory(memoryRequest, this.deps.user);
             const message = this.deps.message;
             const defaultPrompt = message?.contentParts && message.contentParts.length > 0
                 ? message.contentParts
@@ -239,14 +284,106 @@ export class Thread {
             if (implicitPrompt && defaultPrompt) {
                 this.implicitInboundConsumed = true;
             }
-            return this.run(undefined, {
-                ...input,
-                prompt: input?.prompt ?? (!implicitPrompt ? undefined : defaultPrompt),
-            });
+            const continuation = {
+                channelName: this.deps.channelName,
+                conversationKey: this.deps.conversationKey,
+                threadId: this.deps.threadId,
+                runChainId: globalThis.crypto.randomUUID(),
+                initiator: { user: this.deps.user, actor: this.deps.actor },
+            };
+            this.activeContinuation = continuation;
+            try {
+                return await this.run(undefined, {
+                    ...input,
+                    memory,
+                    prompt: input?.prompt ?? (!implicitPrompt ? undefined : defaultPrompt),
+                });
+            }
+            finally {
+                if (this.activeContinuation === continuation) {
+                    this.activeContinuation = undefined;
+                }
+            }
+        }));
+    }
+    resume(value, options) {
+        const memoryRequest = options?.memory === undefined
+            ? undefined
+            : { user: options.memory.user, project: options.memory.project };
+        const subject = options?.subject;
+        const actionId = this.deps.interactionActionId;
+        if (!actionId) {
+            return Promise.reject(new ChannelContinuationRequiredError());
+        }
+        return this.trackOperation(async () => {
+            const binding = {
+                channelName: this.deps.channelName,
+                conversationKey: this.deps.conversationKey,
+                threadId: this.deps.threadId,
+            };
+            const available = await this.deps.registry.getContinuation(actionId, binding);
+            const memory = this.resolveResumeMemory(memoryRequest === undefined && subject === undefined
+                ? undefined
+                : { memory: memoryRequest, subject }, available);
+            const claimed = await this.deps.registry.claimContinuation(actionId, binding);
+            const continuation = {
+                channelName: claimed.channelName,
+                conversationKey: claimed.conversationKey,
+                threadId: claimed.threadId,
+                runChainId: claimed.runChainId,
+                initiator: claimed.initiator,
+            };
+            this.activeContinuation = continuation;
+            try {
+                return await this.run({ resume: value }, { memory });
+            }
+            finally {
+                if (this.activeContinuation === continuation) {
+                    this.activeContinuation = undefined;
+                }
+            }
         });
     }
-    resume(value) {
-        return this.trackOperation(() => this.run({ resume: value }));
+    resolveResumeMemory(options, continuation) {
+        if (options?.memory === undefined)
+            return undefined;
+        const grant = resolveMemoryGrant(options.memory);
+        if (!hasMemoryAccess(grant))
+            return undefined;
+        let user = null;
+        if (grant.user !== "none") {
+            if (!options.subject)
+                throw new ChannelMemorySubjectRequiredError();
+            user =
+                options.subject === "initiator"
+                    ? continuation.initiator.user
+                    : this.deps.user;
+            if (user === null)
+                throw new ChannelMemoryUserRequiredError();
+        }
+        this.assertMemoryAvailable();
+        return Object.freeze({ grant, user });
+    }
+    resolveMemory(requested, user) {
+        if (requested === undefined)
+            return undefined;
+        const grant = resolveMemoryGrant(requested);
+        if (!hasMemoryAccess(grant))
+            return undefined;
+        if (grant.user !== "none" && user === null) {
+            throw new ChannelMemoryUserRequiredError();
+        }
+        this.assertMemoryAvailable();
+        return Object.freeze({
+            grant,
+            user: grant.user === "none" ? null : user,
+        });
+    }
+    assertMemoryAvailable() {
+        if (this.deps.intelligenceMemoryAvailable !== true &&
+            this.deps.adapter.supportsIntelligenceMemory !== true) {
+            throw new ChannelMemoryUnavailableError();
+        }
     }
     async run(initialResume, extra) {
         const session = await this.deps.adapter.conversationStore.getOrCreate(this.deps.conversationKey, this.deps.replyTarget, this.deps.agentFactory);
@@ -275,16 +412,16 @@ export class Thread {
             // bridge — see `runAgent`'s `transcript` doc. No-ops with one warning when
             // identity/transcripts aren't configured.
             const transcripts = this.deps.transcripts;
-            const userKey = this.deps.userKey;
+            const userId = this.deps.user?.id;
             let transcriptContext;
             if (extra?.transcript) {
-                if (transcripts && userKey) {
+                if (transcripts && userId) {
                     const limit = typeof extra.transcript === "object"
                         ? (extra.transcript.limit ?? 20)
                         : 20;
                     // List BEFORE appending the current user turn so the current message
                     // isn't counted as its own "prior history".
-                    const prior = await transcripts.list({ userKey, limit });
+                    const prior = await transcripts.list({ userId, limit });
                     if (prior.length > 0) {
                         transcriptContext = {
                             description: `Prior cross-platform conversation history with this user. Current channel: ${this.platform}.`,
@@ -294,7 +431,7 @@ export class Thread {
                         };
                     }
                     if (this.deps.message) {
-                        await transcripts.append(this, this.deps.message, { userKey });
+                        await transcripts.append(this, this.deps.message, { userId });
                     }
                 }
                 else {
@@ -338,12 +475,20 @@ export class Thread {
                     context,
                     makeToolCtx: () => ({
                         thread: this,
+                        message: this.deps.message,
+                        user: this.deps.user,
+                        actor: this.deps.actor,
                         platform: this.platform,
                     }),
                     handleInterrupt: async (interrupt) => {
                         const h = this.deps.interruptHandlers.get(interrupt.eventName);
                         if (h)
-                            await h({ payload: interrupt.value, thread: this });
+                            await h({
+                                payload: interrupt.value,
+                                thread: this,
+                                user: this.deps.user,
+                                actor: this.deps.actor,
+                            });
                     },
                     initialResume,
                 };
@@ -355,6 +500,7 @@ export class Thread {
                         tools: toolDescriptors,
                         context,
                         isResume: initialResume !== undefined,
+                        memory: extra?.memory,
                         execute: (subscriber, canonicalRun) => runAgentLoop({
                             ...loopArgs,
                             subscriber,
@@ -365,8 +511,8 @@ export class Thread {
                 stage = "finalize";
                 // Transcript auto-bridge (step 4): capture the assistant text this run
                 // produced and append it. Only when the bridge actually applied (transcripts
-                // + userKey both present and `transcript` was requested).
-                if (extra?.transcript && transcripts && userKey) {
+                // + userId both present and `transcript` was requested).
+                if (extra?.transcript && transcripts && userId) {
                     const produced = session.agent.messages.slice(messagesBefore);
                     const text = produced
                         .filter((m) => m.role === "assistant" &&
@@ -375,7 +521,7 @@ export class Thread {
                         .map((m) => m.content)
                         .join("\n\n");
                     if (text.length > 0) {
-                        await transcripts.append(this, { role: "assistant", text }, { userKey });
+                        await transcripts.append(this, { role: "assistant", text }, { userId });
                     }
                 }
                 // Turn-end hook: lets a renderer finalize any turn-scoped resource it kept
@@ -434,5 +580,5 @@ function warnTranscriptIgnored() {
     if (transcriptWarned)
         return;
     transcriptWarned = true;
-    console.warn("[channel] runAgent({ transcript }) ignored — configure store.identity + store.transcripts so a userKey resolves");
+    console.warn("[channel] runAgent({ transcript }) ignored — configure store.transcripts and identify the current application user");
 }

package/dist/thread.test.js

@@ -11,6 +11,8 @@ function makeTestThread(overrides) {
         adapter,
         replyTarget: {},
         conversationKey: overrides.conversationKey ?? "c1",
+        channelName: "test",
+        threadId: overrides.conversationKey ?? "c1",
         registry,
         agentFactory: (id) => {
             throw new Error(`agentFactory not needed in this test: ${id}`);
@@ -21,6 +23,8 @@ function makeTestThread(overrides) {
         registerWaiter: () => { },
         interruptHandlers: new Map(),
         state: overrides.state,
+        user: null,
+        actor: { id: "actor", kind: "unknown" },
     };
     return new Thread(deps);
 }

package/dist/tools.d.ts

@@ -1,11 +1,12 @@
 import type { InferSchemaOutput, ObjectSchema } from "./standard-schema.js";
 import { validateSchema } from "./standard-schema.js";
-import type { Thread, IncomingMessage, PlatformUser } from "@copilotkit/channels-ui";
+import type { Thread, IncomingMessage, ApplicationUser, ProviderActor } from "@copilotkit/channels-ui";
 export type { ObjectSchema } from "./standard-schema.js";
 export interface ChannelToolContext {
     thread: Thread;
     message?: IncomingMessage;
-    user?: PlatformUser;
+    user: ApplicationUser | null;
+    actor: ProviderActor;
     signal?: AbortSignal;
     platform: string;
 }
@@ -35,7 +36,8 @@ export type ChannelTool<Schema extends ObjectSchema = ObjectSchema> = {
 /**
  * Define a {@link ChannelTool} with full type inference. The handler's `args` are
  * inferred from `parameters`, and `ctx` is the generic {@link ChannelToolContext}
- * ({@link Thread} + optional message/user/signal + platform). Reach for
+ * ({@link Thread} + optional message/signal + application user + provider actor
+ * + platform). Reach for
  * platform power via capability-gated `thread` methods (e.g.
  * `thread.getMessages()`, `thread.lookupUser(query)`).
  *

package/dist/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAC5E,OAAO,EAAgB,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,KAAK,EACV,MAAM,EACN,eAAe,EACf,YAAY,EACb,MAAM,yBAAyB,CAAC;AAEjC,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB;AACD,MAAM,MAAM,WAAW,CAAC,MAAM,SAAS,YAAY,GAAG,YAAY,IAAI;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CACL,IAAI,EAAE,iBAAiB,CAAC,MAAM,CAAC,EAC/B,GAAG,EAAE,kBAAkB,GACtB,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CAC/B,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,SAAS,YAAY,EAC3D,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,GACxB,WAAW,CAAC,MAAM,CAAC,CAErB;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf;AACD,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,aAAa,CAAC,WAAW,CAAC,GAChC,mBAAmB,EAAE,CAMvB;AACD,eAAO,MAAM,aAAa,uBAAiB,CAAC;AAC5C,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAI7D"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAC5E,OAAO,EAAgB,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,KAAK,EACV,MAAM,EACN,eAAe,EACf,eAAe,EACf,aAAa,EACd,MAAM,yBAAyB,CAAC;AAEjC,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,IAAI,EAAE,eAAe,GAAG,IAAI,CAAC;IAC7B,KAAK,EAAE,aAAa,CAAC;IACrB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB;AACD,MAAM,MAAM,WAAW,CAAC,MAAM,SAAS,YAAY,GAAG,YAAY,IAAI;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CACL,IAAI,EAAE,iBAAiB,CAAC,MAAM,CAAC,EAC/B,GAAG,EAAE,kBAAkB,GACtB,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CAC/B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,SAAS,YAAY,EAC3D,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,GACxB,WAAW,CAAC,MAAM,CAAC,CAErB;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf;AACD,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,aAAa,CAAC,WAAW,CAAC,GAChC,mBAAmB,EAAE,CAMvB;AACD,eAAO,MAAM,aAAa,uBAAiB,CAAC;AAC5C,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAI7D"}

package/dist/tools.js

@@ -2,7 +2,8 @@ import { toJsonSchema, validateSchema } from "./standard-schema.js";
 /**
  * Define a {@link ChannelTool} with full type inference. The handler's `args` are
  * inferred from `parameters`, and `ctx` is the generic {@link ChannelToolContext}
- * ({@link Thread} + optional message/user/signal + platform). Reach for
+ * ({@link Thread} + optional message/signal + application user + provider actor
+ * + platform). Reach for
  * platform power via capability-gated `thread` methods (e.g.
  * `thread.getMessages()`, `thread.lookupUser(query)`).
  *

package/dist/transcripts.d.ts

@@ -1,18 +1,12 @@
 import type { StateStore } from "./state/state-store.js";
-import type { PlatformUser, IncomingMessage } from "@copilotkit/channels-ui";
 export interface TranscriptEntry {
     role: "user" | "assistant";
     text: string;
     platform: string;
     threadId: string;
-    userKey: string;
+    userId: string;
     ts: number;
 }
-export type Identity = (ctx: {
-    adapter: string;
-    author: PlatformUser;
-    message: IncomingMessage;
-}) => string | null | Promise<string | null>;
 export interface TranscriptsConfig {
     retention?: string | number;
     maxPerUser?: number;
@@ -24,7 +18,7 @@ export declare class Transcripts {
     constructor(state: StateStore, cfg?: TranscriptsConfig);
     /**
      * Append a message to the user's transcript.
-     * No-ops silently when no `userKey` is resolved (from `opts.userKey` or `msg.userKey`).
+     * No-ops silently when no canonical application user ID is supplied.
      */
     append(thread: {
         platform: string;
@@ -32,19 +26,18 @@ export declare class Transcripts {
     }, msg: {
         role?: "user" | "assistant";
         text: string;
-        userKey?: string;
-    }, opts?: {
-        userKey?: string;
+    }, opts: {
+        userId: string | null;
     }): Promise<void>;
     list(q: {
-        userKey: string;
+        userId: string;
         limit?: number;
         platforms?: string[];
         threadId?: string;
         roles?: ("user" | "assistant")[];
     }): Promise<TranscriptEntry[]>;
     delete(q: {
-        userKey: string;
+        userId: string;
     }): Promise<{
         deleted: number;
     }>;

package/dist/transcripts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transcripts.d.ts","sourceRoot":"","sources":["../src/transcripts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEzD,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE7E,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,MAAM,QAAQ,GAAG,CAAC,GAAG,EAAE;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,EAAE,eAAe,CAAC;CAC1B,KAAK,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;AAE7C,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAID,qBAAa,WAAW;IAIpB,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,GAAG;IAJb,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;gBAGvC,KAAK,EAAE,UAAU,EACjB,GAAG,GAAE,iBAAsB;IAMrC;;;OAGG;IACG,MAAM,CACV,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE,EACrD,GAAG,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,EACpE,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAC1B,OAAO,CAAC,IAAI,CAAC;IA2BV,IAAI,CAAC,CAAC,EAAE;QACZ,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,CAAC,MAAM,GAAG,WAAW,CAAC,EAAE,CAAC;KAClC,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAcxB,MAAM,CAAC,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAKnE"}
+{"version":3,"file":"transcripts.d.ts","sourceRoot":"","sources":["../src/transcripts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGzD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAID,qBAAa,WAAW;IAIpB,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,GAAG;IAJb,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;gBAGvC,KAAK,EAAE,UAAU,EACjB,GAAG,GAAE,iBAAsB;IAMrC;;;OAGG;IACG,MAAM,CACV,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE,EACrD,GAAG,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAClD,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAC9B,OAAO,CAAC,IAAI,CAAC;IA2BV,IAAI,CAAC,CAAC,EAAE;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,CAAC,MAAM,GAAG,WAAW,CAAC,EAAE,CAAC;KAClC,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAcxB,MAAM,CAAC,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAKlE"}