@openacp/cli 2026.410.3 → 2026.414.1

package/dist/{channel-CFMUPzvH.d.ts → channel-bWC2vDOv.d.ts}

@@ -56,6 +56,14 @@ interface TurnContext {
     sourceAdapterId: string;
     /** Where to send the response: null = silent (suppress), undefined = same as source, string = explicit target. */
     responseAdapterId?: string | null;
+    /** The raw user prompt before any middleware modifications. */
+    userPrompt: string;
+    /** The final prompt text sent to the agent after all middleware transformations. */
+    finalPrompt: string;
+    /** File or media attachments included with the prompt. */
+    attachments?: Attachment[];
+    /** Caller-supplied metadata for this turn (e.g., identity, source info). */
+    meta?: TurnMeta;
 }
 /**
  * Routing hints attached to an incoming prompt — carried through the queue
@@ -65,11 +73,13 @@ interface TurnRouting {
     sourceAdapterId: string;
     responseAdapterId?: string | null;
 }
-/**
- * Create a new TurnContext. Called when a prompt is dequeued from the queue.
- * If a pre-generated turnId is provided (from enqueuePrompt), it is used; otherwise a new one is generated.
- */
-declare function createTurnContext(sourceAdapterId: string, responseAdapterId?: string | null, turnId?: string): TurnContext;
+/** Identity and display info for the user who sent the turn. */
+interface TurnSender {
+    userId: string;
+    identityId: string;
+    displayName?: string;
+    username?: string;
+}
 /**
  * Get the effective response adapter for a turn.
  * - null → silent (no adapter renders)
@@ -77,8 +87,26 @@ declare function createTurnContext(sourceAdapterId: string, responseAdapterId?:
  * - string → explicit target
  */
 declare function getEffectiveTarget(ctx: TurnContext): string | null;
+/**
+ * Create a new TurnContext. Called when a prompt is dequeued from the queue.
+ * If a pre-generated turnId is provided (from enqueuePrompt), it is used; otherwise a new one is generated.
+ */
+declare function createTurnContext(sourceAdapterId: string, responseAdapterId: string | null | undefined, turnId: string | undefined, userPrompt: string, finalPrompt: string, attachments?: Attachment[], meta?: TurnMeta): TurnContext;
 declare function isSystemEvent(event: AgentEvent): boolean;
 
+/**
+ * Per-turn context bag threaded through all turn-lifecycle middleware hooks.
+ *
+ * Core fills in `turnId`; plugins attach arbitrary keys at any hook and read
+ * them at subsequent hooks in the same turn. The object is mutable by design —
+ * plugins collaborating through meta should use namespaced keys to avoid clashes
+ * (e.g., `meta['workspace.sender']` not `meta.sender`).
+ */
+interface TurnMeta {
+    /** The turn's unique ID — same value passed to session.enqueuePrompt(). */
+    turnId: string;
+    [key: string]: unknown;
+}
 /**
  * A file attachment sent to or received from an agent.
  *
@@ -451,6 +479,10 @@ interface SessionRecord<P = Record<string, unknown>> {
     firstAgent?: string;
     currentPromptCount?: number;
     agentSwitchHistory?: AgentSwitchEntry[];
+    /** userId of the user who created this session (from identity system). */
+    createdBy?: string;
+    /** userId[] of all users who have sent messages in this session. */
+    participants?: string[];
     acpState?: {
         configOptions?: ConfigOption[];
         agentCapabilities?: AgentCapabilities;
@@ -734,6 +766,16 @@ interface IChannelAdapter {
     /** Flush skill commands that were queued before threadId was available. */
     flushPendingSkillCommands?(sessionId: string): Promise<void>;
     cleanupSessionState?(sessionId: string): Promise<void>;
+    /** Send a notification directly to a user by platform ID. Best-effort delivery. */
+    sendUserNotification?(platformId: string, message: NotificationMessage, options?: {
+        via?: 'dm' | 'thread' | 'topic';
+        topicId?: string;
+        sessionId?: string;
+        platformMention?: {
+            platformUsername?: string;
+            platformId: string;
+        };
+    }): Promise<void>;
 }
 /**
  * Original base class for channel adapters. Provides default no-op implementations
@@ -764,6 +806,7 @@ declare abstract class ChannelAdapter<TCore = unknown> implements IChannelAdapte
     cleanupSkillCommands(_sessionId: string): Promise<void>;
     cleanupSessionState(_sessionId: string): Promise<void>;
     archiveSessionTopic(_sessionId: string): Promise<void>;
+    sendUserNotification(_platformId: string, _message: NotificationMessage, _options?: any): Promise<void>;
 }
 
-export { type SessionModelState as $, type Attachment as A, type ConfigSelectGroup as B, type ConfigOption as C, type DisplayVerbosity as D, type ContentBlock as E, type ModelInfo as F, type NewSessionResponse as G, type PermissionOption as H, type IChannelAdapter as I, type PromptResponse as J, KIND_ICONS as K, type RegistryBinaryTarget as L, type McpServerConfig as M, type NotificationMessage as N, type OutgoingMessage as O, type PermissionRequest as P, type RegistryDistribution as Q, type RegistryAgent as R, type StopReason as S, type TurnContext as T, type UsageRecord as U, type ViewerLinks as V, STATUS_ICONS as W, type SessionListItem as X, type SessionListResponse as Y, type SessionMode as Z, type SessionModeState as _, type AgentEvent as a, type TelegramPlatformData as a0, type ToolUpdateMeta as a1, createTurnContext as a2, getEffectiveTarget as a3, isSystemEvent as a4, type AgentCapabilities as b, type AgentDefinition as c, type SetConfigOptionValue as d, type InstalledAgent as e, type AgentListItem as f, type AvailabilityResult as g, type InstallProgress as h, type InstallResult as i, type SessionStatus as j, type AgentSwitchEntry as k, type AgentCommand as l, type TurnRouting as m, type SessionRecord as n, type UsageRecordEvent as o, type IncomingMessage as p, type ChannelConfig as q, type AdapterCapabilities as r, type ToolCallMeta as s, type OutputMode as t, type PlanEntry as u, type AgentDistribution as v, type AuthMethod as w, type AuthenticateRequest as x, ChannelAdapter as y, type ConfigSelectChoice as z };
+export { type SessionMode as $, type Attachment as A, ChannelAdapter as B, type ConfigOption as C, type DisplayVerbosity as D, type ConfigSelectChoice as E, type ConfigSelectGroup as F, type ContentBlock as G, type ModelInfo as H, type IChannelAdapter as I, type NewSessionResponse as J, KIND_ICONS as K, type PermissionOption as L, type McpServerConfig as M, type NotificationMessage as N, type OutgoingMessage as O, type PermissionRequest as P, type PromptResponse as Q, type RegistryAgent as R, type StopReason as S, type TurnMeta as T, type UsageRecord as U, type ViewerLinks as V, type RegistryBinaryTarget as W, type RegistryDistribution as X, STATUS_ICONS as Y, type SessionListItem as Z, type SessionListResponse as _, type AgentEvent as a, type SessionModeState as a0, type SessionModelState as a1, type TelegramPlatformData as a2, type ToolUpdateMeta as a3, createTurnContext as a4, getEffectiveTarget as a5, isSystemEvent as a6, type SessionStatus as b, type AgentCapabilities as c, type AgentDefinition as d, type SetConfigOptionValue as e, type InstalledAgent as f, type AgentListItem as g, type AvailabilityResult as h, type InstallProgress as i, type InstallResult as j, type TurnContext as k, type AgentSwitchEntry as l, type AgentCommand as m, type TurnRouting as n, type SessionRecord as o, type UsageRecordEvent as p, type TurnSender as q, type IncomingMessage as r, type ChannelConfig as s, type AdapterCapabilities as t, type ToolCallMeta as u, type OutputMode as v, type PlanEntry as w, type AgentDistribution as x, type AuthMethod as y, type AuthenticateRequest as z };