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

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EACL,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAGtE,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,YAAY,EACV,OAAO,EACP,oBAAoB,EACpB,sBAAsB,EACtB,wBAAwB,EACxB,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,WAAW,EACX,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,EACd,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAG9C,YAAY,EACV,eAAe,EACf,mBAAmB,EACnB,WAAW,EACX,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,WAAW,EACX,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,yBAAyB,EACzB,sBAAsB,EACtB,oBAAoB,EACpB,SAAS,EACT,aAAa,GACd,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,aAAa,GACd,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,cAAc,EACd,cAAc,EACd,WAAW,GACZ,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGrE,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAG1E,YAAY,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAMtD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,kCAAkC,EAAE,MAAM,qCAAqC,CAAC;AAGzF,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EACV,eAAe,EACf,QAAQ,EACR,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,sBAAsB,EACtB,aAAa,EACb,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,WAAW,EACX,YAAY,EACZ,kBAAkB,EAClB,YAAY,EACZ,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAGvD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EACL,8BAA8B,EAC9B,gCAAgC,GACjC,MAAM,qBAAqB,CAAC;AAK7B,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGhD,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAC7E,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAGpD,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -8,6 +8,7 @@ export { sanitizeAgentEventStream } from "./sanitize-agent-events.js";
 // The usual `agent` for a Channel is an AG-UI agent over HTTP. Re-exported so
 // wiring one up needs no second import (any `AbstractAgent` still works).
 export { HttpAgent } from "@ag-ui/client";
+export { ChannelIdentityResolutionError, ChannelIdentityResultError, resolveChannelUser, } from "./identity.js";
 // Thread
 export { Thread } from "./thread.js";
 // Slash commands
@@ -15,7 +16,7 @@ export { defineChannelCommand, normalizeCommandName, toCommandSpec, } from "./co
 // Action store
 export { InMemoryActionStore } from "./action-store.js";
 // Action registry
-export { ActionRegistry, ActionExpiredError } from "./action-registry.js";
+export { ActionRegistry, ActionContinuationMismatchError, ActionExpiredError, } from "./action-registry.js";
 export { MemoryStore } from "./state/memory-store.js";
 // NOTE: `runStateStoreConformance` is intentionally NOT re-exported here. It
 // pulls in `vitest`, so re-exporting it from the package entry would drag a
@@ -32,7 +33,10 @@ export { toAgentToolDescriptors, parseToolArgs, stringifyHandlerResult, defineCh
 export { mintId, stableStringify } from "./mint-id.js";
 // Run loop
 export { runAgentLoop } from "./run-loop.js";
+export { ChannelContinuationRequiredError, ChannelMemorySubjectRequiredError, ChannelMemoryUnavailableError, ChannelMemoryUserRequiredError, } from "./thread.js";
 export { ChannelDeliveryTerminatedError, isChannelDeliveryTerminatedError, } from "./delivery-error.js";
+// Per-run Intelligence Memory grants.
+export { ChannelMemoryGrantInvalidError, hasMemoryAccess, resolveMemoryGrant, } from "./memory.js";
 // Test utilities (also surfaces them for downstream adapter packages' tests).
 export { FakeAdapter, makeFakeRunRenderer } from "./testing/fake-adapter.js";
 export { FakeAgent } from "./testing/fake-agent.js";

package/dist/managed-v1-await-choice-guard.test.js

@@ -11,7 +11,10 @@ class NonBlockingManagedAdapter extends FakeAdapter {
 }
 async function setupNonBlockingManagedThread() {
     const adapter = new NonBlockingManagedAdapter();
-    const channel = createChannel({ adapters: [adapter] });
+    const channel = createChannel({
+        identifyUser: "platform",
+        adapters: [adapter],
+    });
     let thread;
     channel.onThreadStarted(({ thread: activeThread }) => {
         thread = activeThread;

package/dist/memory.d.ts

@@ -0,0 +1,23 @@
+import type { ApplicationUser } from "@copilotkit/channels-ui";
+/** Access granted to one Intelligence Memory scope for one agent run. */
+export type MemoryAccess = "none" | "read" | "read-write";
+/** Explicit user and project Memory access for one agent run. */
+export interface MemoryGrant {
+    readonly user?: MemoryAccess;
+    readonly project?: MemoryAccess;
+}
+/** Fully resolved, immutable Memory context passed to managed execution. */
+export interface ResolvedChannelMemory {
+    readonly grant: Required<MemoryGrant>;
+    readonly user: ApplicationUser | null;
+}
+/** A JavaScript caller bypassed the typed Channel Memory grant contract. */
+export declare class ChannelMemoryGrantInvalidError extends Error {
+    readonly code = "channel_memory_grant_invalid";
+    constructor();
+}
+/** Fill omitted scopes with no access. */
+export declare function resolveMemoryGrant(grant: MemoryGrant): Required<MemoryGrant>;
+/** True when a grant requests any Intelligence Memory operation. */
+export declare function hasMemoryAccess(grant: Required<MemoryGrant>): boolean;
+//# sourceMappingURL=memory.d.ts.map

package/dist/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../src/memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE/D,yEAAyE;AACzE,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,YAAY,CAAC;AAE1D,iEAAiE;AACjE,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC;CACjC;AAED,4EAA4E;AAC5E,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;IACtC,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,CAAC;CACvC;AAED,4EAA4E;AAC5E,qBAAa,8BAA+B,SAAQ,KAAK;IACvD,QAAQ,CAAC,IAAI,kCAAkC;;CAMhD;AAID,0CAA0C;AAC1C,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,WAAW,GAAG,QAAQ,CAAC,WAAW,CAAC,CAY5E;AAED,oEAAoE;AACpE,wBAAgB,eAAe,CAAC,KAAK,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,OAAO,CAErE"}

package/dist/memory.js

@@ -0,0 +1,25 @@
+/** A JavaScript caller bypassed the typed Channel Memory grant contract. */
+export class ChannelMemoryGrantInvalidError extends Error {
+    code = "channel_memory_grant_invalid";
+    constructor() {
+        super('Channel Memory access must be "none", "read", or "read-write"');
+        this.name = "ChannelMemoryGrantInvalidError";
+    }
+}
+const MEMORY_ACCESS = new Set(["none", "read", "read-write"]);
+/** Fill omitted scopes with no access. */
+export function resolveMemoryGrant(grant) {
+    const resolved = Object.freeze({
+        user: grant.user ?? "none",
+        project: grant.project ?? "none",
+    });
+    if (!MEMORY_ACCESS.has(resolved.user) ||
+        !MEMORY_ACCESS.has(resolved.project)) {
+        throw new ChannelMemoryGrantInvalidError();
+    }
+    return resolved;
+}
+/** True when a grant requests any Intelligence Memory operation. */
+export function hasMemoryAccess(grant) {
+    return grant.user !== "none" || grant.project !== "none";
+}

package/dist/modal-submit.test.js

@@ -5,7 +5,10 @@ import { FakeAdapter } from "./testing/fake-adapter.js";
 describe("channel.onModalSubmit / onModalClose", () => {
     it("routes a submission by callbackId and parses values; thread present when conversation context exists", async () => {
         const fake = new FakeAdapter();
-        const channel = createChannel({ adapters: [fake] });
+        const channel = createChannel({
+            adapters: [fake],
+            identifyUser: ({ actor }) => ({ id: actor.id, name: actor.id }),
+        });
         const seen = [];
         channel.onModalSubmit("triage", (evt) => {
             seen.push({
@@ -19,7 +22,7 @@ describe("channel.onModalSubmit / onModalClose", () => {
         const res = await fake.emitModalSubmit({
             callbackId: "triage",
             values: { summary: "boom", prio: "high" },
-            user: { id: "U1" },
+            actor: { id: "U1", kind: "human" },
             conversationKey: "c",
             replyTarget: {},
         });
@@ -35,7 +38,10 @@ describe("channel.onModalSubmit / onModalClose", () => {
     });
     it("returns the handler's field errors so the adapter can keep the modal open", async () => {
         const fake = new FakeAdapter();
-        const channel = createChannel({ adapters: [fake] });
+        const channel = createChannel({
+            identifyUser: "platform",
+            adapters: [fake],
+        });
         channel.onModalSubmit("triage", (evt) => evt.values.summary ? undefined : { errors: { summary: "Required" } });
         await channel.ɵruntime.start();
         const res = await fake.emitModalSubmit({
@@ -46,7 +52,10 @@ describe("channel.onModalSubmit / onModalClose", () => {
     });
     it("ignores submissions with no registered handler", async () => {
         const fake = new FakeAdapter();
-        const channel = createChannel({ adapters: [fake] });
+        const channel = createChannel({
+            identifyUser: "platform",
+            adapters: [fake],
+        });
         await channel.ɵruntime.start();
         const res = await fake.emitModalSubmit({
             callbackId: "unknown",
@@ -56,13 +65,19 @@ describe("channel.onModalSubmit / onModalClose", () => {
     });
     it("routes a close by callbackId", async () => {
         const fake = new FakeAdapter();
-        const channel = createChannel({ adapters: [fake] });
+        const channel = createChannel({
+            identifyUser: "platform",
+            adapters: [fake],
+        });
         const closed = [];
         channel.onModalClose("triage", (evt) => {
             closed.push(evt.callbackId);
         });
         await channel.ɵruntime.start();
-        await fake.emitModalClose({ callbackId: "triage", user: { id: "U2" } });
+        await fake.emitModalClose({
+            callbackId: "triage",
+            actor: { id: "U2", kind: "human" },
+        });
         expect(closed).toEqual(["triage"]);
     });
 });

package/dist/open-modal.test.js

@@ -13,7 +13,10 @@ const view = Modal({
 describe("ctx.openModal", () => {
     it("opens a modal from an interaction when a triggerId is present", async () => {
         const fake = new FakeAdapter();
-        const channel = createChannel({ adapters: [fake] });
+        const channel = createChannel({
+            identifyUser: "platform",
+            adapters: [fake],
+        });
         let res;
         channel.onInteraction("ck:open", async (ctx) => {
             res = await ctx.openModal(view);
@@ -28,7 +31,10 @@ describe("ctx.openModal", () => {
     });
     it("opens a modal from a command", async () => {
         const fake = new FakeAdapter();
-        const channel = createChannel({ adapters: [fake] });
+        const channel = createChannel({
+            identifyUser: "platform",
+            adapters: [fake],
+        });
         let res;
         channel.onCommand("triage", async (ctx) => {
             res = await ctx.openModal(view);
@@ -40,7 +46,10 @@ describe("ctx.openModal", () => {
     });
     it("omits openModal when no triggerId is present", async () => {
         const fake = new FakeAdapter();
-        const channel = createChannel({ adapters: [fake] });
+        const channel = createChannel({
+            identifyUser: "platform",
+            adapters: [fake],
+        });
         let hasOpen = true;
         channel.onInteraction("ck:noop", (ctx) => {
             hasOpen = typeof ctx.openModal === "function";
@@ -52,7 +61,10 @@ describe("ctx.openModal", () => {
     });
     it("omits openModal when the adapter has no modal support", async () => {
         const fake = new FakeAdapter({ modals: false });
-        const channel = createChannel({ adapters: [fake] });
+        const channel = createChannel({
+            identifyUser: "platform",
+            adapters: [fake],
+        });
         let hasOpen = true;
         channel.onInteraction("ck:x", (ctx) => {
             hasOpen = typeof ctx.openModal === "function";

package/dist/platform-adapter.d.ts

@@ -1,5 +1,7 @@
 import type { AgentSubscriber, AbstractAgent } from "@ag-ui/client";
-import type { AgentContentPart, ChannelNode, EmojiValue, EphemeralResult, MessageRef, MessageOperation, PlatformUser, ThreadMessage } from "@copilotkit/channels-ui";
+import type { AgentContentPart, ChannelNode, EmojiValue, EphemeralResult, MessageRef, MessageOperation, ProviderActor, ThreadMessage } from "@copilotkit/channels-ui";
+import type { IngressIdentityContext } from "./identity.js";
+import type { ResolvedChannelMemory } from "./memory.js";
 import type { CommandSpec } from "./commands.js";
 import type { StateStore } from "./state/state-store.js";
 import type { AgentToolDescriptor, ContextEntry } from "./tools.js";
@@ -94,6 +96,8 @@ export interface ChannelAgentLifecycleArgs {
      * agent command and never crosses the managed run-open boundary.
      */
     isResume?: boolean;
+    /** Explicit Memory access resolved before agent execution. */
+    memory?: ResolvedChannelMemory;
     execute(subscriber: AgentSubscriber, canonicalRun?: CanonicalRunIdentity): Promise<ChannelAgentLoopResult>;
 }
 /**
@@ -104,7 +108,10 @@ export interface ChannelAgentLifecycleArgs {
 export interface IngressEventBase {
     conversationKey: string;
     replyTarget: ReplyTarget;
-    user?: PlatformUser;
+    /** Provider account that caused this event. */
+    actor: ProviderActor;
+    /** Provider facts used by the Channel identity strategy. */
+    identityContext: IngressIdentityContext;
     /**
      * Provider that produced this event when it differs from the transport
      * adapter identity. Multiplexing adapters set it per event.
@@ -126,6 +133,8 @@ export interface IngressIds {
 export interface IncomingTurn extends IngressEventBase, IngressIds {
     userText: string;
     operation: MessageOperation;
+    /** Delivery-scoped opaque capability for mutating or reacting to this message. */
+    messageRef?: MessageRef;
     /**
      * Optional multimodal content parts built by the adapter (e.g. inbound
      * image/file attachments). Carried through to `IncomingMessage.contentParts`.
@@ -136,6 +145,8 @@ export interface IncomingTurn extends IngressEventBase, IngressIds {
 export interface InteractionEvent extends IngressEventBase, IngressIds {
     id: string;
     value?: unknown;
+    /** Submitted input id → value, separate from the clicked action's envelope. */
+    values?: Record<string, unknown>;
     /** The message the interaction occurred on (the picker), so handlers can update it in place. */
     messageRef?: MessageRef;
     /** Opaque platform trigger for opening a modal (Slack `trigger_id`; Discord interaction id). */
@@ -160,6 +171,10 @@ export interface IncomingCommand extends IngressEventBase, IngressIds {
 export interface IncomingThreadStart extends IngressEventBase {
     platform: string;
 }
+/** A provider installation or conversation activation that should be welcomed. */
+export interface IncomingWelcome extends IngressEventBase, IngressIds {
+    platform: string;
+}
 /** A reaction added/removed on a message. Adapters that can't observe reactions never emit it. */
 export interface IncomingReaction extends IngressEventBase {
     /** Platform-native emoji token (Slack shortcode, Unicode, Discord custom). */
@@ -194,7 +209,8 @@ export interface IncomingModalSubmit {
     callbackId: string;
     /** Field id → value (text string, selected option value, etc.). */
     values: Record<string, unknown>;
-    user?: PlatformUser;
+    actor: ProviderActor;
+    identityContext: IngressIdentityContext;
     privateMetadata?: string;
     /** Present when the submission carries a conversation context (so the engine can build a Thread). */
     conversationKey?: string;
@@ -205,7 +221,8 @@ export interface IncomingModalSubmit {
 /** A modal dismissal (Slack `view_closed`; requires `notifyOnClose`). */
 export interface IncomingModalClose {
     callbackId: string;
-    user?: PlatformUser;
+    actor: ProviderActor;
+    identityContext: IngressIdentityContext;
     privateMetadata?: string;
     /** Present when the dismissal carries a conversation context (so the engine can build a Thread). */
     conversationKey?: string;
@@ -220,6 +237,8 @@ export interface ModalSubmitResult {
 export interface IngressSink {
     onTurn(turn: IncomingTurn): void | Promise<void>;
     onInteraction(evt: InteractionEvent): void | Promise<void>;
+    /** A provider installation or conversation activation became usable. */
+    onWelcome(evt: IncomingWelcome): void | Promise<void>;
     /** A slash command fired. Routed to the matching `channel.onCommand` handler (ignored if none). */
     onCommand(cmd: IncomingCommand): void | Promise<void>;
     /** A conversation surface opened. Adapters without the concept never call it. */
@@ -273,6 +292,8 @@ export interface PlatformAdapter {
     readonly platform: string;
     readonly capabilities: SurfaceCapabilities;
     readonly ackDeadlineMs: number;
+    /** Return the trusted canonical Thread bound to an opaque reply target. */
+    getCanonicalThreadId?(target: ReplyTarget): string;
     start(sink: IngressSink, ctx?: AdapterStartContext): Promise<void>;
     stop(): Promise<void>;
     render(ir: ChannelNode[]): NativePayload;
@@ -289,6 +310,8 @@ export interface PlatformAdapter {
      * containing delivery.
      */
     assertRunAgentSupported?(target: ReplyTarget): void;
+    /** True when this adapter is attached to an Intelligence Memory backend. */
+    supportsIntelligenceMemory?: boolean;
     runAgentLifecycle?(args: ChannelAgentLifecycleArgs): Promise<ChannelAgentLoopResult>;
     /**
      * Optional delivery-lifecycle hook. {@link Thread} invokes this synchronously
@@ -297,7 +320,7 @@ export interface PlatformAdapter {
      */
     trackThreadOperation?<T>(target: ReplyTarget, operation: () => Promise<T>): Promise<T>;
     decodeInteraction(raw: unknown): InteractionEvent | undefined;
-    lookupUser(q: UserQuery): Promise<PlatformUser | undefined>;
+    lookupUser(q: UserQuery): Promise<ProviderActor | undefined>;
     readonly conversationStore: ConversationStore;
     /**
      * Optional persistence backend supplied by the adapter. `createChannel` uses it
@@ -391,7 +414,7 @@ export interface PlatformAdapter {
      * native vs DM fallback based on `opts.fallbackToDM` and returns
      * `{ ok, usedFallback }` or `null` (native unsupported and no fallback).
      */
-    postEphemeral?(target: ReplyTarget, user: PlatformUser | string, ir: ChannelNode[], opts: {
+    postEphemeral?(target: ReplyTarget, user: ProviderActor | string, ir: ChannelNode[], opts: {
         fallbackToDM: boolean;
     }): Promise<EphemeralResult | null>;
     /** Optional modal render (pure; backs `openModal`). Throws `ModalRenderError` on unsupported elements. */

package/dist/platform-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"platform-adapter.d.ts","sourceRoot":"","sources":["../src/platform-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACpE,OAAO,KAAK,EACV,gBAAgB,EAChB,WAAW,EACX,UAAU,EACV,eAAe,EACf,UAAU,EACV,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACd,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEpE,mHAAmH;AACnH,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC;AAClC,+DAA+D;AAC/D,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC;AAEpC,MAAM,WAAW,mBAAmB;IAClC,mEAAmE;IACnE,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,cAAc,EAAE,OAAO,CAAC;IACxB,cAAc,EAAE,OAAO,CAAC;IACxB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,4EAA4E;IAC5E,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,8DAA8D;IAC9D,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,kGAAkG;IAClG,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;;;;;;;OAQG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AACD,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,4HAA4H;AAC5H,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,eAAe,CAAC;IAC5B,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,oBAAoB,IAAI,SAAS,gBAAgB,EAAE,CAAC;IACpD,mBAAmB,IAAI,iBAAiB,GAAG,SAAS,CAAC;IACrD,qBAAqB,IAAI,IAAI,CAAC;IAC9B;;;;;;;;OAQG;IACH,MAAM,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,iFAAiF;AACjF,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,wEAAwE;AACxE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACtC;AAED;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACxC,WAAW,EAAE,WAAW,CAAC;IACzB,KAAK,EAAE,aAAa,CAAC;IACrB,QAAQ,EAAE,WAAW,CAAC;IACtB,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACtC,OAAO,EAAE,SAAS,YAAY,EAAE,CAAC;IACjC;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CACL,UAAU,EAAE,eAAe,EAC3B,YAAY,CAAC,EAAE,oBAAoB,GAClC,OAAO,CAAC,sBAAsB,CAAC,CAAC;CACpC;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,WAAW,CAAC;IACzB,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,oFAAoF;IACpF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+EAA+E;IAC/E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAa,SAAQ,gBAAgB,EAAE,UAAU;IAChE,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,gBAAgB,CAAC;IAC5B;;;OAGG;IACH,YAAY,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAClC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB,EAAE,UAAU;IACpE,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,gGAAgG;IAChG,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,gGAAgG;IAChG,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,2DAA2D;AAC3D,MAAM,WAAW,eAAgB,SAAQ,gBAAgB,EAAE,UAAU;IACnE,uFAAuF;IACvF,OAAO,EAAE,MAAM,CAAC;IAChB,wFAAwF;IACxF,IAAI,EAAE,MAAM,CAAC;IACb,oFAAoF;IACpF,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,gGAAgG;IAChG,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAoB,SAAQ,gBAAgB;IAC3D,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,kGAAkG;AAClG,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB;IACxD,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,KAAK,EAAE,OAAO,CAAC;IACf,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;;;OAOG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sBAAsB;IACtB,GAAG,EAAE,OAAO,CAAC;CACd;AAED,iEAAiE;AACjE,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,mEAAmE;IACnE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qGAAqG;IACrG,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,OAAO,CAAC;CACd;AAED,yEAAyE;AACzE,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,oGAAoG;IACpG,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,OAAO,CAAC;CACd;AAED,qFAAqF;AACrF,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,aAAa,CAAC,GAAG,EAAE,gBAAgB,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,mGAAmG;IACnG,SAAS,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,iFAAiF;IACjF,eAAe,CAAC,GAAG,EAAE,mBAAmB,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE,yFAAyF;IACzF,UAAU,CAAC,GAAG,EAAE,gBAAgB,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD;;;;OAIG;IACH,aAAa,CAAC,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;IAC3E,2EAA2E;IAC3E,YAAY,CAAC,GAAG,EAAE,kBAAkB,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7D;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,kHAAkH;AAClH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,aAAa,CAAC;IACrB;;;;;OAKG;IACH,OAAO,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClC;AAED,gHAAgH;AAChH,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IACpC,WAAW,CACT,eAAe,EAAE,MAAM,EACvB,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,aAAa,GAC7C,OAAO,CAAC,YAAY,CAAC,CAAC;CAC1B;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,yEAAyE;IACzE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAAC;IAC3C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,KAAK,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,MAAM,CAAC,EAAE,EAAE,WAAW,EAAE,GAAG,aAAa,CAAC;IACzC,IAAI,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAClE,MAAM,CAAC,GAAG,EAAE,UAAU,EAAE,EAAE,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,MAAM,CACJ,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,GAC5B,OAAO,CAAC,UAAU,CAAC,CAAC;IACvB,MAAM,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,CAAC;IACpD;;;;;;OAMG;IACH,uBAAuB,CAAC,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IACpD,iBAAiB,CAAC,CAChB,IAAI,EAAE,yBAAyB,GAC9B,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACnC;;;;OAIG;IACH,oBAAoB,CAAC,CAAC,CAAC,EACrB,MAAM,EAAE,WAAW,EACnB,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAC1B,OAAO,CAAC,CAAC,CAAC,CAAC;IACd,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,gBAAgB,GAAG,SAAS,CAAC;IAC9D,UAAU,CAAC,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAAC;IAC5D,QAAQ,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;IAC9C;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;IACjC,qFAAqF;IACrF,QAAQ,CAAC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IACzC;;;;;OAKG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IACpC,+EAA+E;IAC/E,QAAQ,CAAC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IACzC;;;;OAIG;IACH,WAAW,CAAC,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAC5D;;;;OAIG;IACH,QAAQ,CAAC,CACP,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE;QACJ,KAAK,EAAE,UAAU,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GACA,OAAO,CAAC;QACT,EAAE,EAAE,OAAO,CAAC;QACZ,uDAAuD;QACvD,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,mEAAmE;QACnE,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;IACH;;;;;;;OAOG;IACH,gBAAgB,CAAC,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1E;;;;;OAKG;IACH,mBAAmB,CAAC,CAClB,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,aAAa,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,EAC1D,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GACxB,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5C;;;;OAIG;IACH,cAAc,CAAC,CACb,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5C;;;OAGG;IACH,WAAW,CAAC,CACV,MAAM,EAAE,WAAW,EACnB,UAAU,EAAE,UAAU,EACtB,KAAK,EAAE,UAAU,GAChB,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5C,cAAc,CAAC,CACb,MAAM,EAAE,WAAW,EACnB,UAAU,EAAE,UAAU,EACtB,KAAK,EAAE,UAAU,GAChB,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5C;;;;OAIG;IACH,aAAa,CAAC,CACZ,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE,YAAY,GAAG,MAAM,EAC3B,EAAE,EAAE,WAAW,EAAE,EACjB,IAAI,EAAE;QAAE,YAAY,EAAE,OAAO,CAAA;KAAE,GAC9B,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IACnC,0GAA0G;IAC1G,WAAW,CAAC,CAAC,EAAE,EAAE,WAAW,EAAE,GAAG,aAAa,CAAC;IAC/C;;;;OAIG;IACH,SAAS,CAAC,CACR,MAAM,EAAE,WAAW,EACnB,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,WAAW,EAAE,GAChB,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC7C"}
+{"version":3,"file":"platform-adapter.d.ts","sourceRoot":"","sources":["../src/platform-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACpE,OAAO,KAAK,EACV,gBAAgB,EAChB,WAAW,EACX,UAAU,EACV,eAAe,EACf,UAAU,EACV,gBAAgB,EAChB,aAAa,EACb,aAAa,EACd,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEpE,mHAAmH;AACnH,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC;AAClC,+DAA+D;AAC/D,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC;AAEpC,MAAM,WAAW,mBAAmB;IAClC,mEAAmE;IACnE,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,cAAc,EAAE,OAAO,CAAC;IACxB,cAAc,EAAE,OAAO,CAAC;IACxB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,4EAA4E;IAC5E,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,8DAA8D;IAC9D,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,kGAAkG;IAClG,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;;;;;;;OAQG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AACD,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,4HAA4H;AAC5H,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,eAAe,CAAC;IAC5B,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,oBAAoB,IAAI,SAAS,gBAAgB,EAAE,CAAC;IACpD,mBAAmB,IAAI,iBAAiB,GAAG,SAAS,CAAC;IACrD,qBAAqB,IAAI,IAAI,CAAC;IAC9B;;;;;;;;OAQG;IACH,MAAM,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,iFAAiF;AACjF,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,wEAAwE;AACxE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACtC;AAED;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACxC,WAAW,EAAE,WAAW,CAAC;IACzB,KAAK,EAAE,aAAa,CAAC;IACrB,QAAQ,EAAE,WAAW,CAAC;IACtB,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACtC,OAAO,EAAE,SAAS,YAAY,EAAE,CAAC;IACjC;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,8DAA8D;IAC9D,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAC/B,OAAO,CACL,UAAU,EAAE,eAAe,EAC3B,YAAY,CAAC,EAAE,oBAAoB,GAClC,OAAO,CAAC,sBAAsB,CAAC,CAAC;CACpC;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,WAAW,CAAC;IACzB,+CAA+C;IAC/C,KAAK,EAAE,aAAa,CAAC;IACrB,4DAA4D;IAC5D,eAAe,EAAE,sBAAsB,CAAC;IACxC;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,oFAAoF;IACpF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+EAA+E;IAC/E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAa,SAAQ,gBAAgB,EAAE,UAAU;IAChE,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,kFAAkF;IAClF,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB;;;OAGG;IACH,YAAY,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAClC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB,EAAE,UAAU;IACpE,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,+EAA+E;IAC/E,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,gGAAgG;IAChG,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,gGAAgG;IAChG,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,2DAA2D;AAC3D,MAAM,WAAW,eAAgB,SAAQ,gBAAgB,EAAE,UAAU;IACnE,uFAAuF;IACvF,OAAO,EAAE,MAAM,CAAC;IAChB,wFAAwF;IACxF,IAAI,EAAE,MAAM,CAAC;IACb,oFAAoF;IACpF,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,gGAAgG;IAChG,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAoB,SAAQ,gBAAgB;IAC3D,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,kFAAkF;AAClF,MAAM,WAAW,eAAgB,SAAQ,gBAAgB,EAAE,UAAU;IACnE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,kGAAkG;AAClG,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB;IACxD,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,KAAK,EAAE,OAAO,CAAC;IACf,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;;;OAOG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sBAAsB;IACtB,GAAG,EAAE,OAAO,CAAC;CACd;AAED,iEAAiE;AACjE,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,mEAAmE;IACnE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,KAAK,EAAE,aAAa,CAAC;IACrB,eAAe,EAAE,sBAAsB,CAAC;IACxC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qGAAqG;IACrG,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,OAAO,CAAC;CACd;AAED,yEAAyE;AACzE,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,aAAa,CAAC;IACrB,eAAe,EAAE,sBAAsB,CAAC;IACxC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,oGAAoG;IACpG,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,OAAO,CAAC;CACd;AAED,qFAAqF;AACrF,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,aAAa,CAAC,GAAG,EAAE,gBAAgB,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,wEAAwE;IACxE,SAAS,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,mGAAmG;IACnG,SAAS,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,iFAAiF;IACjF,eAAe,CAAC,GAAG,EAAE,mBAAmB,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE,yFAAyF;IACzF,UAAU,CAAC,GAAG,EAAE,gBAAgB,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD;;;;OAIG;IACH,aAAa,CAAC,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;IAC3E,2EAA2E;IAC3E,YAAY,CAAC,GAAG,EAAE,kBAAkB,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7D;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,kHAAkH;AAClH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,aAAa,CAAC;IACrB;;;;;OAKG;IACH,OAAO,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClC;AAED,gHAAgH;AAChH,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IACpC,WAAW,CACT,eAAe,EAAE,MAAM,EACvB,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,aAAa,GAC7C,OAAO,CAAC,YAAY,CAAC,CAAC;CAC1B;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,yEAAyE;IACzE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAAC;IAC3C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,2EAA2E;IAC3E,oBAAoB,CAAC,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAAC;IACnD,KAAK,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,MAAM,CAAC,EAAE,EAAE,WAAW,EAAE,GAAG,aAAa,CAAC;IACzC,IAAI,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAClE,MAAM,CAAC,GAAG,EAAE,UAAU,EAAE,EAAE,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,MAAM,CACJ,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,GAC5B,OAAO,CAAC,UAAU,CAAC,CAAC;IACvB,MAAM,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,CAAC;IACpD;;;;;;OAMG;IACH,uBAAuB,CAAC,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IACpD,4EAA4E;IAC5E,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC,iBAAiB,CAAC,CAChB,IAAI,EAAE,yBAAyB,GAC9B,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACnC;;;;OAIG;IACH,oBAAoB,CAAC,CAAC,CAAC,EACrB,MAAM,EAAE,WAAW,EACnB,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAC1B,OAAO,CAAC,CAAC,CAAC,CAAC;IACd,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,gBAAgB,GAAG,SAAS,CAAC;IAC9D,UAAU,CAAC,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAAC;IAC7D,QAAQ,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;IAC9C;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;IACjC,qFAAqF;IACrF,QAAQ,CAAC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IACzC;;;;;OAKG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IACpC,+EAA+E;IAC/E,QAAQ,CAAC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IACzC;;;;OAIG;IACH,WAAW,CAAC,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAC5D;;;;OAIG;IACH,QAAQ,CAAC,CACP,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE;QACJ,KAAK,EAAE,UAAU,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GACA,OAAO,CAAC;QACT,EAAE,EAAE,OAAO,CAAC;QACZ,uDAAuD;QACvD,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,mEAAmE;QACnE,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;IACH;;;;;;;OAOG;IACH,gBAAgB,CAAC,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1E;;;;;OAKG;IACH,mBAAmB,CAAC,CAClB,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,aAAa,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,EAC1D,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GACxB,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5C;;;;OAIG;IACH,cAAc,CAAC,CACb,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5C;;;OAGG;IACH,WAAW,CAAC,CACV,MAAM,EAAE,WAAW,EACnB,UAAU,EAAE,UAAU,EACtB,KAAK,EAAE,UAAU,GAChB,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5C,cAAc,CAAC,CACb,MAAM,EAAE,WAAW,EACnB,UAAU,EAAE,UAAU,EACtB,KAAK,EAAE,UAAU,GAChB,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5C;;;;OAIG;IACH,aAAa,CAAC,CACZ,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE,aAAa,GAAG,MAAM,EAC5B,EAAE,EAAE,WAAW,EAAE,EACjB,IAAI,EAAE;QAAE,YAAY,EAAE,OAAO,CAAA;KAAE,GAC9B,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IACnC,0GAA0G;IAC1G,WAAW,CAAC,CAAC,EAAE,EAAE,WAAW,EAAE,GAAG,aAAa,CAAC;IAC/C;;;;OAIG;IACH,SAAS,CAAC,CACR,MAAM,EAAE,WAAW,EACnB,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,WAAW,EAAE,GAChB,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC7C"}

package/dist/platform-adapter.test.js

@@ -9,6 +9,7 @@ describe("FakeAdapter", () => {
                 got = t.userText;
             },
             onInteraction: () => { },
+            onWelcome: () => { },
             onCommand: () => { },
             onThreadStarted: () => { },
             onReaction: () => { },
@@ -28,6 +29,7 @@ describe("FakeAdapter", () => {
             onInteraction: (e) => {
                 id = e.id;
             },
+            onWelcome: () => { },
             onCommand: () => { },
             onThreadStarted: () => { },
             onReaction: () => { },

package/dist/reactions.test.js

@@ -8,7 +8,10 @@ const tick = () => new Promise((r) => setTimeout(r, 0));
 describe("channel.onReaction", () => {
     it("routes a specific reaction, normalizing the platform token", async () => {
         const fake = new FakeAdapter();
-        const channel = createChannel({ adapters: [fake] });
+        const channel = createChannel({
+            adapters: [fake],
+            identifyUser: ({ actor }) => actor.kind === "human" ? { id: actor.id, name: actor.id } : null,
+        });
         const seen = [];
         channel.onReaction([emoji.thumbs_up], (evt) => {
             seen.push({ emoji: evt.emoji, raw: evt.rawEmoji, added: evt.added });
@@ -24,13 +27,17 @@ describe("channel.onReaction", () => {
     });
     it("fires a catch-all for any reaction and reports added/removed", async () => {
         const fake = new FakeAdapter();
-        const channel = createChannel({ adapters: [fake] });
+        const channel = createChannel({
+            adapters: [fake],
+            identifyUser: ({ actor }) => actor.kind === "human" ? { id: actor.id, name: actor.id } : null,
+        });
         const seen = [];
         channel.onReaction((evt) => {
             seen.push({
                 raw: evt.rawEmoji,
                 added: evt.added,
                 user: evt.user?.id,
+                actor: evt.actor.id,
                 messageId: evt.messageId,
                 platform: evt.thread.platform,
             });
@@ -39,17 +46,25 @@ describe("channel.onReaction", () => {
         fake.emitReaction({
             rawEmoji: "🎉",
             added: true,
-            user: { id: "U1" },
+            actor: { id: "U1", kind: "human" },
             messageId: "m9",
         });
         fake.emitReaction({ rawEmoji: "🎉", added: false, messageId: "m9" });
         await tick();
         expect(seen).toEqual([
-            { raw: "🎉", added: true, user: "U1", messageId: "m9", platform: "fake" },
+            {
+                raw: "🎉",
+                added: true,
+                user: "U1",
+                actor: "U1",
+                messageId: "m9",
+                platform: "fake",
+            },
             {
                 raw: "🎉",
                 added: false,
                 user: undefined,
+                actor: "",
                 messageId: "m9",
                 platform: "fake",
             },
@@ -59,7 +74,10 @@ describe("channel.onReaction", () => {
         // A fake whose platform === "slack" so normalizeEmoji maps the shortcode.
         const fake = new FakeAdapter();
         Object.defineProperty(fake, "platform", { value: "slack" });
-        const channel = createChannel({ adapters: [fake] });
+        const channel = createChannel({
+            identifyUser: "platform",
+            adapters: [fake],
+        });
         const hits = [];
         channel.onReaction(["thumbs_up"], (evt) => {
             hits.push(evt.emoji);
@@ -75,7 +93,10 @@ describe("channel.onReaction", () => {
         // its source provider. Core must normalize by that source platform, so a
         // Teams `<codepoint>_<name>` token resolves to its canonical name.
         const fake = new FakeAdapter({ platform: "intelligence" });
-        const channel = createChannel({ adapters: [fake] });
+        const channel = createChannel({
+            identifyUser: "platform",
+            adapters: [fake],
+        });
         const hits = [];
         channel.onReaction(["refresh"], (evt) => {
             hits.push(evt.emoji);
@@ -91,7 +112,10 @@ describe("channel.onReaction", () => {
     });
     it("routes a reaction on a posted message to its <Message onReaction>", async () => {
         const fake = new FakeAdapter();
-        const channel = createChannel({ adapters: [fake] });
+        const channel = createChannel({
+            identifyUser: "platform",
+            adapters: [fake],
+        });
         const seen = [];
         channel.onMessage(async ({ thread }) => {
             await thread.post(Message({
@@ -117,7 +141,10 @@ describe("channel.onReaction", () => {
     });
     it("resolves <Message onReaction> by postedMessageId when the reaction id differs (Channel path)", async () => {
         const fake = new FakeAdapter();
-        const channel = createChannel({ adapters: [fake] });
+        const channel = createChannel({
+            identifyUser: "platform",
+            adapters: [fake],
+        });
         const seen = [];
         channel.onMessage(async ({ thread }) => {
             await thread.post(Message({
@@ -156,6 +183,7 @@ describe("channel.onReaction", () => {
         // Bot 1 posts the component message, persisting a reaction snapshot.
         const fake1 = new FakeAdapter();
         const bot1 = createChannel({
+            identifyUser: "platform",
             adapters: [fake1],
             store: { adapter: backend },
             components: [Card],
@@ -172,6 +200,7 @@ describe("channel.onReaction", () => {
         // Its reaction hot cache is empty, so it must resolve via the durable snapshot.
         const fake2 = new FakeAdapter();
         const bot2 = createChannel({
+            identifyUser: "platform",
             adapters: [fake2],
             store: { adapter: backend },
             components: [Card],
@@ -183,7 +212,10 @@ describe("channel.onReaction", () => {
     });
     it("gives the handler a thread to post new UI and the reacted message's ref", async () => {
         const fake = new FakeAdapter();
-        const channel = createChannel({ adapters: [fake] });
+        const channel = createChannel({
+            identifyUser: "platform",
+            adapters: [fake],
+        });
         let seenRefId;
         channel.onMessage(async ({ thread }) => {
             await thread.post(Message({
@@ -207,7 +239,10 @@ describe("channel.onReaction", () => {
     });
     it("does not fire a message handler for a reaction on a different message", async () => {
         const fake = new FakeAdapter();
-        const channel = createChannel({ adapters: [fake] });
+        const channel = createChannel({
+            identifyUser: "platform",
+            adapters: [fake],
+        });
         let fired = false;
         channel.onMessage(async ({ thread }) => {
             await thread.post(Message({
@@ -229,7 +264,10 @@ describe("channel.onReaction", () => {
         // Slack alias to the canonical "thumbs_up", so the filter must too.
         const fake = new FakeAdapter();
         Object.defineProperty(fake, "platform", { value: "slack" });
-        const channel = createChannel({ adapters: [fake] });
+        const channel = createChannel({
+            identifyUser: "platform",
+            adapters: [fake],
+        });
         const hits = [];
         channel.onReaction(["👍"], (evt) => {
             hits.push(evt.emoji);

package/dist/run-loop.test.js

@@ -40,7 +40,12 @@ describe("runAgentLoop", () => {
             tools,
             toolDescriptors,
             context,
-            makeToolCtx: () => ({ thread: {}, platform: "fake" }),
+            makeToolCtx: () => ({
+                thread: {},
+                user: null,
+                actor: { id: "actor", kind: "unknown" },
+                platform: "fake",
+            }),
         });
         expect(recorded).toEqual([{ msg: "hi" }]);
         expect(agent.runAgentCalls).toBe(2);
@@ -77,7 +82,12 @@ describe("runAgentLoop", () => {
             tools: new Map([["recoverable", tool]]),
             toolDescriptors,
             context,
-            makeToolCtx: () => ({ thread: {}, platform: "fake" }),
+            makeToolCtx: () => ({
+                thread: {},
+                user: null,
+                actor: { id: "actor", kind: "unknown" },
+                platform: "fake",
+            }),
         });
         expect(agent.runAgentCalls).toBe(2);
         expect(agent.messages.find(({ role }) => role === "tool")).toMatchObject({
@@ -103,7 +113,12 @@ describe("runAgentLoop", () => {
             tools,
             toolDescriptors,
             context,
-            makeToolCtx: () => ({ thread: {}, platform: "fake" }),
+            makeToolCtx: () => ({
+                thread: {},
+                user: null,
+                actor: { id: "actor", kind: "unknown" },
+                platform: "fake",
+            }),
             handleInterrupt,
         });
         expect(handleInterrupt).toHaveBeenCalledTimes(1);
@@ -132,7 +147,12 @@ describe("runAgentLoop", () => {
             tools,
             toolDescriptors,
             context,
-            makeToolCtx: () => ({ thread: {}, platform: "fake" }),
+            makeToolCtx: () => ({
+                thread: {},
+                user: null,
+                actor: { id: "actor", kind: "unknown" },
+                platform: "fake",
+            }),
             handleInterrupt,
         };
         const result = await runAgentLoop(args);
@@ -153,7 +173,12 @@ describe("runAgentLoop", () => {
             tools,
             toolDescriptors,
             context,
-            makeToolCtx: () => ({ thread: {}, platform: "fake" }),
+            makeToolCtx: () => ({
+                thread: {},
+                user: null,
+                actor: { id: "actor", kind: "unknown" },
+                platform: "fake",
+            }),
         };
         const result = await runAgentLoop(args);
         expect(result.interrupted).toBe(false);

package/dist/sanitize-agent-events.test.js

@@ -139,6 +139,7 @@ describe("createChannel({ sanitizeAgentEvents })", () => {
     async function runTurn(agent, opts) {
         const fake = new FakeAdapter();
         const channel = createChannel({
+            identifyUser: "platform",
             adapters: [fake],
             agent: () => agent,
             ...opts,
@@ -167,6 +168,7 @@ describe("createChannel({ sanitizeAgentEvents })", () => {
         // sanitizing has to live on the transport to reach the cloned instance.
         const fake = new FakeAdapter();
         const channel = createChannel({
+            identifyUser: "platform",
             adapters: [fake],
             agent: agentServing(nullParentRun()),
         });