@qwen-code/channel-base 0.19.3 → 0.19.4

package/README.md

@@ -1,6 +1,6 @@
 # @qwen-code/channel-base
 
-Base infrastructure for building Qwen Code channel adapters. Provides the abstract base class, access control, session routing, and the ACP bridge that communicates with the agent.
+Base infrastructure for building Qwen Code channel adapters. Provides the abstract base class, access control, session routing, and the adapter-facing bridge interface used to communicate with the agent.
 
 If you're building a channel plugin, this is your only dependency.
 
@@ -17,12 +17,22 @@ Subclass `ChannelBase` and implement three methods:
 ```typescript
 import { ChannelBase } from '@qwen-code/channel-base';
 import type {
+  ChannelAgentBridge,
+  ChannelBaseOptions,
   ChannelConfig,
   Envelope,
-  AcpBridge,
 } from '@qwen-code/channel-base';
 
 class MyChannel extends ChannelBase {
+  constructor(
+    name: string,
+    config: ChannelConfig,
+    bridge: ChannelAgentBridge,
+    options?: ChannelBaseOptions,
+  ) {
+    super(name, config, bridge, options);
+  }
+
   async connect(): Promise<void> {
     // Connect to platform API, register message handlers.
     // When a message arrives, build an Envelope and call:
@@ -55,6 +65,17 @@ export const plugin: ChannelPlugin = {
 
 For a complete working example, see [`@qwen-code/channel-plugin-example`](../plugin-example/).
 
+Migration note for existing TypeScript plugins: if your adapter constructor or factory explicitly types `bridge` as `AcpBridge`, change that annotation to `ChannelAgentBridge` and keep using only the methods exposed by that contract. JavaScript plugins are unaffected at runtime, and standalone `qwen channel start` still passes the current `AcpBridge` implementation.
+
+## Runtime modes
+
+Channel adapters can run in two host modes:
+
+- `qwen channel start [name]` is the standalone service. It uses `AcpBridge` over a `qwen-code --acp` child process and remains the default channel command.
+- `qwen serve --channel <name>` and `qwen serve --channel all` are experimental daemon-managed modes. `qwen serve` starts one out-of-process channel worker, the worker connects back to the daemon through the SDK, and adapters receive a `DaemonChannelBridge`-backed `ChannelAgentBridge` facade.
+
+In daemon-managed mode, one daemon is bound to one workspace. Every selected channel's `cwd` must resolve to that same workspace. The optional `shellCommand` method is exposed to adapters only when the daemon advertises the `session_shell_command` capability.
+
 ## Architecture
 
 ```
@@ -63,9 +84,9 @@ Inbound:  Platform message
             → GroupGate (group policy + mention gating)
             → SenderGate (allowlist / pairing / open)
             → Slash commands (/clear, /help, /status)
-            → SessionRouter (resolve or create ACP session)
+            → SessionRouter (resolve or create agent session)
             → Resolve attachments (images → bridge, files → prompt text)
-            → AcpBridge.prompt() → agent
+            → ChannelAgentBridge.prompt() → agent
 
 Outbound: Agent response
             → BlockStreamer (if enabled: split into blocks at paragraph boundaries)
@@ -78,36 +99,39 @@ Everything between `handleInbound()` and `sendMessage()` is handled by the base
 
 ### Classes
 
-| Class           | Purpose                                                          |
-| --------------- | ---------------------------------------------------------------- |
-| `ChannelBase`   | Abstract base class — extend this to build a channel adapter     |
-| `AcpBridge`     | Spawns and communicates with the `qwen-code --acp` agent process |
-| `BlockStreamer` | Progressive multi-message delivery for block streaming           |
-| `SessionRouter` | Maps senders to ACP sessions with configurable scoping           |
-| `SenderGate`    | DM access control (allowlist / pairing / open)                   |
-| `GroupGate`     | Group chat policy and @mention gating                            |
-| `PairingStore`  | Pairing code generation, approval, and allowlist persistence     |
+| Class           | Purpose                                                                              |
+| --------------- | ------------------------------------------------------------------------------------ |
+| `ChannelBase`   | Abstract base class — extend this to build a channel adapter                         |
+| `AcpBridge`     | Current standalone `qwen channel start` bridge implementation over `qwen-code --acp` |
+| `BlockStreamer` | Progressive multi-message delivery for block streaming                               |
+| `SessionRouter` | Maps senders to agent sessions with configurable scoping                             |
+| `SenderGate`    | DM access control (allowlist / pairing / open)                                       |
+| `GroupGate`     | Group chat policy and @mention gating                                                |
+| `PairingStore`  | Pairing code generation, approval, and allowlist persistence                         |
 
 ### Types
 
-| Type            | Description                                    |
-| --------------- | ---------------------------------------------- |
-| `Attachment`    | Structured file/image/audio/video attachment   |
-| `ChannelConfig` | Channel configuration from `settings.json`     |
-| `ChannelPlugin` | Plugin factory interface (what you export)     |
-| `Envelope`      | Normalized inbound message format              |
-| `SenderPolicy`  | `'allowlist' \| 'pairing' \| 'open'`           |
-| `GroupPolicy`   | `'disabled' \| 'allowlist' \| 'open'`          |
-| `SessionScope`  | `'user' \| 'thread' \| 'single'`               |
-| `GroupConfig`   | Per-group settings (e.g. `requireMention`)     |
-| `SessionTarget` | Maps a session back to its channel/sender/chat |
+| Type                 | Description                                                              |
+| -------------------- | ------------------------------------------------------------------------ |
+| `Attachment`         | Structured file/image/audio/video attachment                             |
+| `AvailableCommand`   | Agent command advertised through the bridge                              |
+| `ChannelAgentBridge` | Adapter-facing bridge contract used by `ChannelBase` and `SessionRouter` |
+| `ChannelConfig`      | Channel configuration from `settings.json`                               |
+| `ChannelPlugin`      | Plugin factory interface (what you export)                               |
+| `Envelope`           | Normalized inbound message format                                        |
+| `SenderPolicy`       | `'allowlist' \| 'pairing' \| 'open'`                                     |
+| `GroupPolicy`        | `'disabled' \| 'allowlist' \| 'open'`                                    |
+| `SessionScope`       | `'user' \| 'thread' \| 'single'`                                         |
+| `GroupConfig`        | Per-group settings (e.g. `requireMention`)                               |
+| `SessionTarget`      | Maps a session back to its channel/sender/chat                           |
+| `ToolCallEvent`      | Agent tool-call event delivered to adapters                              |
 
 ## API reference
 
 ### ChannelBase
 
 ```typescript
-constructor(name: string, config: ChannelConfig, bridge: AcpBridge, options?: ChannelBaseOptions)
+constructor(name: string, config: ChannelConfig, bridge: ChannelAgentBridge, options?: ChannelBaseOptions)
 ```
 
 **Abstract methods** (you must implement):
@@ -123,7 +147,7 @@ constructor(name: string, config: ChannelConfig, bridge: AcpBridge, options?: Ch
 | Method                                            | Description                                                                                                                       |
 | ------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
 | `handleInbound(envelope)`                         | Route an inbound message through the full pipeline (gate checks, commands, session, prompt). Call this from your message handler. |
-| `setBridge(bridge)`                               | Replace the ACP bridge after crash recovery                                                                                       |
+| `setBridge(bridge)`                               | Replace the agent bridge after crash recovery                                                                                     |
 | `registerCommand(name, handler)`                  | Register a custom slash command (e.g. `/mycommand`)                                                                               |
 | `onToolCall(chatId, event)`                       | Hook called on agent tool invocations — override to show indicators                                                               |
 | `onResponseChunk(chatId, chunk, sessionId)`       | Hook called per streaming text chunk — override for progressive display (default: no-op)                                          |
@@ -133,9 +157,60 @@ constructor(name: string, config: ChannelConfig, bridge: AcpBridge, options?: Ch
 
 **Built-in slash commands:** `/clear` (`/reset`, `/new`), `/help`, `/status`
 
+**ChannelBaseOptions:**
+
+| Option                 | Description                                                                                                                                                |
+| ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `router`               | Optional `SessionRouter`. Omit for the default standalone router.                                                                                          |
+| `proxy`                | Optional proxy URL made available to adapters.                                                                                                             |
+| `registerBridgeEvents` | Set only when the adapter owns a supplied router and `ChannelBase` should consume bridge events directly. Leave unset for routers supplied by the gateway. |
+
+### ChannelAgentBridge
+
+`ChannelAgentBridge` is the adapter-facing contract. Channel adapters, channel plugins, `ChannelBase`, and `SessionRouter` should depend on this type instead of a concrete bridge implementation.
+
+`shellCommand` is optional. Adapters should check for it before enabling `!cmd`-style features because daemon-managed hosts expose it only when the connected daemon supports shell execution.
+
+```typescript
+interface ChannelAgentBridge {
+  readonly availableCommands: AvailableCommand[];
+  on(eventName: 'toolCall', listener: (event: ToolCallEvent) => void): unknown;
+  on(
+    eventName: 'textChunk',
+    listener: (sessionId: string, chunk: string) => void,
+  ): unknown;
+  on(
+    eventName: 'sessionDied',
+    listener: (event: { sessionId: string; reason?: string }) => void,
+  ): unknown;
+  off(eventName: 'toolCall', listener: (event: ToolCallEvent) => void): unknown;
+  off(
+    eventName: 'textChunk',
+    listener: (sessionId: string, chunk: string) => void,
+  ): unknown;
+  off(
+    eventName: 'sessionDied',
+    listener: (event: { sessionId: string; reason?: string }) => void,
+  ): unknown;
+  newSession(cwd: string): Promise<string>;
+  loadSession(sessionId: string, cwd: string): Promise<string>;
+  prompt(
+    sessionId: string,
+    text: string,
+    options?: { imageBase64?: string; imageMimeType?: string },
+  ): Promise<string>;
+  cancelSession(sessionId: string): Promise<void>;
+  shellCommand?(
+    sessionId: string,
+    command: string,
+    signal?: AbortSignal,
+  ): Promise<{ exitCode: number | null; output: string; aborted: boolean }>;
+}
+```
+
 ### AcpBridge
 
-Manages the `qwen-code --acp` child process and ACP sessions.
+`AcpBridge` is the current implementation used by standalone `qwen channel start`. It manages the `qwen-code --acp` child process and implements `ChannelAgentBridge`.
 
 ```typescript
 constructor(options: { cliEntryPath: string; cwd: string; model?: string })
@@ -160,10 +235,10 @@ constructor(options: { cliEntryPath: string; cwd: string; model?: string })
 
 ### SessionRouter
 
-Maps senders to ACP sessions based on the configured scope.
+Maps senders to agent sessions based on the configured scope.
 
 ```typescript
-constructor(bridge: AcpBridge, defaultCwd: string, scope?: SessionScope, persistPath?: string)
+constructor(bridge: ChannelAgentBridge, defaultCwd: string, scope?: SessionScope, persistPath?: string)
 ```
 
 **Routing keys by scope:**
@@ -174,12 +249,13 @@ constructor(bridge: AcpBridge, defaultCwd: string, scope?: SessionScope, persist
 | `thread`         | `channel:threadId`        | One session per thread                    |
 | `single`         | `channel:__single__`      | One shared session for the entire channel |
 
-| Method                                                    | Description                                                 |
-| --------------------------------------------------------- | ----------------------------------------------------------- |
-| `resolve(channelName, senderId, chatId, threadId?, cwd?)` | Get or create a session for the given sender                |
-| `removeSession(channelName, senderId, chatId?)`           | Remove session(s) — used by `/clear`                        |
-| `restoreSessions()`                                       | Reload sessions from disk after bridge restart              |
-| `clearAll()`                                              | Clear all sessions and delete persist file (clean shutdown) |
+| Method                                                     | Description                                                 |
+| ---------------------------------------------------------- | ----------------------------------------------------------- |
+| `resolve(channelName, senderId, chatId, threadId?, cwd?)`  | Get or create a session for the given sender                |
+| `removeSession(channelName, senderId, chatId?, threadId?)` | Remove session(s) — used by `/clear`                        |
+| `removeSessionId(sessionId)`                               | Remove all routing state for a bridge session ID            |
+| `restoreSessions()`                                        | Reload sessions from disk after bridge restart              |
+| `clearAll()`                                               | Clear all sessions and delete persist file (clean shutdown) |
 
 ### SenderGate
 

package/dist/AcpBridge.d.ts

@@ -1,25 +1,19 @@
 import { EventEmitter } from 'node:events';
+import type { AvailableCommand, ChannelAgentBridge } from './ChannelAgentBridge.js';
+export type { AvailableCommand, ToolCallEvent } from './ChannelAgentBridge.js';
 export interface AcpBridgeOptions {
     cliEntryPath: string;
     cwd: string;
     model?: string;
 }
-export interface AvailableCommand {
-    name: string;
-    description: string;
-    input?: {
-        hint: string;
-    } | null;
-}
-export interface ToolCallEvent {
-    sessionId: string;
-    toolCallId: string;
-    kind: string;
-    title: string;
-    status: string;
-    rawInput?: Record<string, unknown>;
-}
-export declare class AcpBridge extends EventEmitter {
+/**
+ * Read a command's aliases off a raw wire `available_commands_update` entry. ACP
+ * carries them in `_meta` (its only extension point); a top-level `altNames` is
+ * also accepted for forward-compat. Returns undefined when absent so the field
+ * stays optional and entries without aliases are left byte-identical.
+ */
+export declare function readAvailableCommandAltNames(raw: unknown): string[] | undefined;
+export declare class AcpBridge extends EventEmitter implements ChannelAgentBridge {
     private child;
     private connection;
     private options;

package/dist/AcpBridge.js

@@ -2,6 +2,30 @@ import { spawn } from 'node:child_process';
 import { Readable, Writable } from 'node:stream';
 import { EventEmitter } from 'node:events';
 import { ClientSideConnection, ndJsonStream, PROTOCOL_VERSION, } from '@agentclientprotocol/sdk';
+/**
+ * Read a command's aliases off a raw wire `available_commands_update` entry. ACP
+ * carries them in `_meta` (its only extension point); a top-level `altNames` is
+ * also accepted for forward-compat. Returns undefined when absent so the field
+ * stays optional and entries without aliases are left byte-identical.
+ */
+export function readAvailableCommandAltNames(raw) {
+    if (typeof raw !== 'object' || raw === null)
+        return undefined;
+    const record = raw;
+    const meta = record['_meta'];
+    const fromMeta = typeof meta === 'object' && meta !== null
+        ? meta['altNames']
+        : undefined;
+    const source = Array.isArray(record['altNames'])
+        ? record['altNames']
+        : Array.isArray(fromMeta)
+            ? fromMeta
+            : undefined;
+    if (!source)
+        return undefined;
+    const names = source.filter((n) => typeof n === 'string');
+    return names.length > 0 ? names : undefined;
+}
 export class AcpBridge extends EventEmitter {
     child = null;
     connection = null;
@@ -38,6 +62,8 @@ export class AcpBridge extends EventEmitter {
         });
         this.child.on('exit', (code, signal) => {
             process.stderr.write(`[AcpBridge] Process exited (code=${code}, signal=${signal})\n`);
+            // Do not emit sessionDied here: a full ACP process exit is handled by
+            // channel start crash recovery, which reloads the persisted sessions.
             this.connection = null;
             this.child = null;
             this.emit('disconnected', code, signal);
@@ -154,7 +180,10 @@ export class AcpBridge extends EventEmitter {
             }
             case 'available_commands_update': {
                 if (Array.isArray(update['availableCommands'])) {
-                    this._availableCommands = update['availableCommands'];
+                    this._availableCommands = update['availableCommands'].map((cmd) => {
+                        const altNames = readAvailableCommandAltNames(cmd);
+                        return altNames ? { ...cmd, altNames } : cmd;
+                    });
                 }
                 break;
             }

package/dist/AcpBridge.js.map

@@ -1 +1 @@
-{"version":3,"file":"AcpBridge.js","sourceRoot":"","sources":["../src/AcpBridge.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"AcpBridge.js","sourceRoot":"","sources":["../src/AcpBridge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EACL,oBAAoB,EACpB,YAAY,EACZ,gBAAgB,GACjB,MAAM,0BAA0B,CAAC;AAoBlC;;;;;GAKG;AACH,MAAM,UAAU,4BAA4B,CAC1C,GAAY;IAEZ,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAC9D,MAAM,MAAM,GAAG,GAA8B,CAAC;IAC9C,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAC7B,MAAM,QAAQ,GACZ,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI;QACvC,CAAC,CAAE,IAAgC,CAAC,UAAU,CAAC;QAC/C,CAAC,CAAC,SAAS,CAAC;IAChB,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC9C,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC;QACpB,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;YACvB,CAAC,CAAC,QAAQ;YACV,CAAC,CAAC,SAAS,CAAC;IAChB,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAC9B,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC;IACvE,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAC9C,CAAC;AAED,MAAM,OAAO,SAAU,SAAQ,YAAY;IACjC,KAAK,GAAwB,IAAI,CAAC;IAClC,UAAU,GAAgC,IAAI,CAAC;IAC/C,OAAO,CAAmB;IAC1B,kBAAkB,GAAuB,EAAE,CAAC;IAEpD,YAAY,OAAyB;QACnC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,IAAI,iBAAiB;QACnB,OAAO,IAAI,CAAC,kBAAkB,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,EAAE,YAAY,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC;QAE3C,MAAM,IAAI,GAAG;YACX,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,wBAAwB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACpE,YAAY;YACZ,OAAO;SACR,CAAC;QACF,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YACvB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC3C,CAAC;QAED,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE;YACzC,GAAG;YACH,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;YAC/B,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE;YACvB,KAAK,EAAE,KAAK;SACb,CAAC,CAAC;QAEH,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;YAC7C,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC;YACnC,IAAI,GAAG,EAAE,CAAC;gBACR,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;YAC/C,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;YACrC,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,oCAAoC,IAAI,YAAY,MAAM,KAAK,CAChE,CAAC;YACF,sEAAsE;YACtE,sEAAsE;YACtE,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;YACvB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;YAClB,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;QAEH,qCAAqC;QACrC,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;QAE1D,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YACrC,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;QACjD,CAAC;QAED,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAC3B,IAAI,CAAC,KAAK,CAAC,MAAO,CACW,CAAC;QAChC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAM,CAAmB,CAAC;QAClE,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAE3C,IAAI,CAAC,UAAU,GAAG,IAAI,oBAAoB,CACxC,GAAW,EAAE,CAAC,CAAC;YACb,aAAa,EAAE,CAAC,MAA2B,EAAiB,EAAE;gBAC5D,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;gBACjC,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;YAC3B,CAAC;YAED,iBAAiB,EAAE,KAAK,EACtB,MAAgC,EACI,EAAE;gBACtC,8DAA8D;gBAC9D,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;gBACpE,MAAM,QAAQ,GACZ,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,cAAc,CAAC,EAAE,QAAQ;oBAC5D,OAAO,CAAC,CAAC,CAAC,EAAE,QAAQ;oBACpB,cAAc,CAAC;gBACjB,OAAO,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,CAAC;YACxD,CAAC;YAED,eAAe,EAAE,KAAK,IAAmB,EAAE,GAAE,CAAC;SAC/C,CAAC,EACF,MAAM,CACP,CAAC;QAEF,MAAM,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;YAC/B,eAAe,EAAE,gBAAgB;YACjC,kBAAkB,EAAE,EAAE;SACvB,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,GAAW;QAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC;QAChE,OAAO,QAAQ,CAAC,SAAS,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,SAAiB,EAAE,GAAW;QAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC;YACtC,SAAS;YACT,GAAG;YACH,UAAU,EAAE,EAAE;SACf,CAAC,CAAC;QACH,OAAO,QAAQ,CAAC,SAAS,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,MAAM,CACV,SAAiB,EACjB,IAAY,EACZ,OAA0D;QAE1D,MAAM,IAAI,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAErC,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,CAAC,GAAW,EAAE,KAAa,EAAE,EAAE;YAC7C,IAAI,GAAG,KAAK,SAAS;gBAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5C,CAAC,CAAC;QACF,IAAI,CAAC,EAAE,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAE9B,MAAM,MAAM,GAAmC,EAAE,CAAC;QAClD,IAAI,OAAO,EAAE,WAAW,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;YAClD,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE,OAAO,CAAC,WAAW;gBACzB,QAAQ,EAAE,OAAO,CAAC,aAAa;aAChC,CAAC,CAAC;QACL,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAEpC,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,MAAM,CAAC;gBAChB,SAAS;gBACT,MAAM,EAAE,MAA+C;aACxD,CAAC,CAAC;QACL,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QACjC,CAAC;QAED,OAAO,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,SAAiB;QACnC,MAAM,IAAI,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACrC,MAAM,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;IACnC,CAAC;IAED,IAAI;QACF,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YAClB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QACpB,CAAC;QACD,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;IACzB,CAAC;IAED,IAAI,WAAW;QACb,OAAO,CACL,IAAI,CAAC,KAAK,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,KAAK,IAAI,CAC1E,CAAC;IACJ,CAAC;IAEO,mBAAmB,CAAC,MAA2B;QACrD,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;QAC7B,MAAM,MAAM,GAAI,MAA6C,CAAC,QAAQ,CAEzD,CAAC;QACd,IAAI,CAAC,MAAM;YAAE,OAAO;QAEpB,MAAM,IAAI,GAAG,MAAM,CAAC,eAAe,CAAW,CAAC;QAE/C,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,qBAAqB,CAAC,CAAC,CAAC;gBAC3B,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS,CAEnB,CAAC;gBACd,IAAI,OAAO,EAAE,IAAI,KAAK,MAAM,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;oBAC7C,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;gBAClD,CAAC;gBACD,MAAM;YACR,CAAC;YACD,KAAK,WAAW,CAAC,CAAC,CAAC;gBACjB,MAAM,KAAK,GAAkB;oBAC3B,SAAS;oBACT,UAAU,EAAE,MAAM,CAAC,YAAY,CAAW;oBAC1C,IAAI,EAAG,MAAM,CAAC,MAAM,CAAY,IAAI,EAAE;oBACtC,KAAK,EAAG,MAAM,CAAC,OAAO,CAAY,IAAI,EAAE;oBACxC,MAAM,EAAG,MAAM,CAAC,QAAQ,CAAY,IAAI,SAAS;oBACjD,QAAQ,EAAE,MAAM,CAAC,UAAU,CAAwC;iBACpE,CAAC;gBACF,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;gBAC7B,MAAM;YACR,CAAC;YACD,KAAK,2BAA2B,CAAC,CAAC,CAAC;gBACjC,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,EAAE,CAAC;oBAC/C,IAAI,CAAC,kBAAkB,GACrB,MAAM,CAAC,mBAAmB,CAC3B,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;wBACZ,MAAM,QAAQ,GAAG,4BAA4B,CAAC,GAAG,CAAC,CAAC;wBACnD,OAAO,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;oBAC/C,CAAC,CAAC,CAAC;gBACL,CAAC;gBACD,MAAM;YACR,CAAC;YACD;gBACE,oCAAoC;gBACpC,MAAM;QACV,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;IACrC,CAAC;IAEO,gBAAgB;QACtB,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YAC1C,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAChD,CAAC;QACD,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;CACF"}

package/dist/ChannelAgentBridge.d.ts

@@ -0,0 +1,48 @@
+export interface AvailableCommand {
+    name: string;
+    description: string;
+    input?: {
+        hint: string;
+    } | null;
+    /**
+     * Aliases the agent's parser also accepts for this command (for example
+     * `summarize` for `compress`).
+     */
+    altNames?: string[];
+}
+export interface ToolCallEvent {
+    sessionId: string;
+    toolCallId: string;
+    kind: string;
+    title: string;
+    status: string;
+    rawInput?: Record<string, unknown>;
+}
+export interface SessionDiedEvent {
+    sessionId: string;
+    reason?: string;
+}
+interface ChannelAgentBridgeEventMap {
+    sessionDied: [SessionDiedEvent];
+    textChunk: [sessionId: string, chunk: string];
+    toolCall: [ToolCallEvent];
+}
+export interface ChannelAgentBridge {
+    readonly availableCommands: AvailableCommand[];
+    getAvailableCommands?(sessionId: string): AvailableCommand[];
+    on<K extends keyof ChannelAgentBridgeEventMap>(eventName: K, listener: (...args: ChannelAgentBridgeEventMap[K]) => void): unknown;
+    off<K extends keyof ChannelAgentBridgeEventMap>(eventName: K, listener: (...args: ChannelAgentBridgeEventMap[K]) => void): unknown;
+    newSession(cwd: string): Promise<string>;
+    loadSession(sessionId: string, cwd: string): Promise<string>;
+    prompt(sessionId: string, text: string, options?: {
+        imageBase64?: string;
+        imageMimeType?: string;
+    }): Promise<string>;
+    cancelSession(sessionId: string): Promise<void>;
+    shellCommand?(sessionId: string, command: string, signal?: AbortSignal): Promise<{
+        exitCode: number | null;
+        output: string;
+        aborted: boolean;
+    }>;
+}
+export {};

package/dist/ChannelAgentBridge.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ChannelAgentBridge.js.map

package/dist/ChannelAgentBridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChannelAgentBridge.js","sourceRoot":"","sources":["../src/ChannelAgentBridge.ts"],"names":[],"mappings":""}

package/dist/ChannelBase.d.ts

@@ -1,38 +1,89 @@
-import type { ChannelConfig, Envelope } from './types.js';
+import type { ChannelConfig, ChannelMemoryCallbacks, Envelope, SessionTarget } from './types.js';
 import { GroupGate } from './GroupGate.js';
 import { SenderGate } from './SenderGate.js';
 import { SessionRouter } from './SessionRouter.js';
-import type { AcpBridge, ToolCallEvent } from './AcpBridge.js';
+import type { ChannelAgentBridge, ToolCallEvent } from './ChannelAgentBridge.js';
+import type { ChannelLoop, ChannelLoopInput } from './ChannelLoopStore.js';
+/**
+ * Max time /clear waits for a cancelled in-flight turn to wind down before
+ * purging anyway. A wedged ACP child (stuck tool call, not reading stdin, or
+ * crashed without closing) can leave active.done unresolved forever; without
+ * this bound /clear — and the whole channel — would hang. Safe because the
+ * purge runs regardless and the generation is bumped, so a turn that settles
+ * later is already invalidated.
+ */
+export declare const CLEAR_CANCEL_TIMEOUT_MS = 3000;
 export interface ChannelBaseOptions {
     router?: SessionRouter;
     proxy?: string;
+    channelMemory?: ChannelMemoryCallbacks;
+    /**
+     * Set when a channel owns a supplied router and should consume bridge
+     * events directly.
+     */
+    registerBridgeEvents?: boolean;
+    groupHistoryPath?: string;
+    loopController?: ChannelLoopController;
+}
+export interface ChannelLoopController {
+    create(input: ChannelLoopInput): Promise<ChannelLoop>;
+    createForTarget?(input: ChannelLoopInput, maxEnabledLoops: number): Promise<ChannelLoop | undefined>;
+    listForTarget(channelName: string, target: SessionTarget): Promise<ChannelLoop[]>;
+    disable(id: string): Promise<boolean>;
+    validateCron(cron: string): void;
+    nextFireTime?(job: ChannelLoop): Date;
+}
+export interface ChannelLoopPromptOptions {
+    timeoutMs?: number;
+    shouldContinue?: () => Promise<boolean>;
 }
 /** Handler for a slash command. Return true if handled, false to forward to agent. */
 type CommandHandler = (envelope: Envelope, args: string) => Promise<boolean>;
 export declare abstract class ChannelBase {
     protected config: ChannelConfig;
-    protected bridge: AcpBridge;
+    protected bridge: ChannelAgentBridge;
     protected groupGate: GroupGate;
     protected gate: SenderGate;
     protected router: SessionRouter;
     protected name: string;
     /** Resolved proxy URL, available to subclasses for adapter-specific clients. */
     protected proxy?: string;
+    private readonly channelMemory?;
+    private groupHistory;
+    private readonly loopController?;
     private instructedSessions;
     private commands;
     /** Per-session promise chain to serialize prompt + send (followup mode). */
     private sessionQueues;
+    private readonly registerBridgeEvents;
+    /**
+     * Per-session generation, bumped by /clear. A queued followup turn captures the
+     * generation when it enqueues and bails if /clear bumped it before the turn ran,
+     * so a cleared session can't be resurrected by an already-queued prompt.
+     */
+    private sessionGenerations;
     /** Per-session active prompt tracking for dispatch modes. */
     private activePrompts;
     /** Per-session message buffer for collect mode. */
     private collectBuffers;
-    constructor(name: string, config: ChannelConfig, bridge: AcpBridge, options?: ChannelBaseOptions);
+    private readonly bridgeToolCallListener;
+    private readonly bridgeSessionDiedListener;
+    constructor(name: string, config: ChannelConfig, bridge: ChannelAgentBridge, options?: ChannelBaseOptions);
     abstract connect(): Promise<void>;
     abstract sendMessage(chatId: string, text: string): Promise<void>;
     abstract disconnect(): void;
+    supportsProactiveSend(): boolean;
+    protected supportsProactiveTarget(target: SessionTarget): boolean;
+    protected pushProactive(target: SessionTarget, text: string): Promise<void>;
     /** Replace the bridge instance (used after crash recovery restart). */
-    setBridge(bridge: AcpBridge): void;
+    setBridge(bridge: ChannelAgentBridge): void;
+    runLoopPrompt(job: ChannelLoop, options?: ChannelLoopPromptOptions): Promise<string | undefined>;
+    private runLoopBridgePrompt;
+    private cancelTimedOutLoopPrompt;
     onToolCall(_chatId: string, _event: ToolCallEvent): void;
+    onSessionDied(sessionId: string): void;
+    private attachBridgeEvents;
+    private detachBridgeEvents;
     /**
      * Called when a prompt actually begins processing (inside the session queue).
      * Override to show a platform-specific working indicator (e.g., typing, reaction).
@@ -65,14 +116,114 @@ export declare abstract class ChannelBase {
     protected registerCancelCommand(name?: string): void;
     /** Register shared slash commands. Called from constructor. */
     private registerSharedCommands;
+    private handleLoopCommand;
+    private handleLoopAdd;
+    private handleLoopList;
+    private handleLoopInspect;
+    private formatLoopListLine;
+    private lastLoopStatus;
+    private formatNextFireTime;
+    private handleLoopCancel;
+    private loopTargetFromEnvelope;
+    private isStoredLoopTargetAuthorized;
     /** Check if a message text matches a registered local command. */
     protected isLocalCommand(text: string): boolean;
     private findActiveSessionId;
+    private channelMemoryTarget;
+    private invalidateSessionContext;
+    private dropQueuedTurnIfStale;
+    private isAuthorizedForChannelMemory;
+    private isSenderAuthorizedForChannelMemory;
+    private ensureChannelMemoryAuthorized;
+    private getChannelMemory;
+    private channelMemoryErrorMessage;
+    private channelMemoryUserErrorMessage;
+    private logChannelMemoryError;
+    /**
+     * Whether the resolved session is SHARED across senders. `single` collapses
+     * the whole channel to one `__single__` session for EVERY sender — group OR
+     * DM — so it is ALWAYS shared (even a DM maps to `__single__`). `thread` is
+     * shared only in a group (a DM maps to the lone caller's own chat). `user` is
+     * per-sender, never shared. Drives both the destructive-/clear confirm gate
+     * and the host-shell (`!`) gate.
+     */
+    private isSharedSession;
+    private isSharedSessionTarget;
+    /**
+     * Whether `envelope.senderId` may act on the resolved session's destructive or
+     * workspace-leaking commands (/clear, /who). A SHARED session with a non-empty
+     * allowedUsers list is restricted to those members; a per-user session, or one
+     * with no allowlist, is unrestricted. Shared verbatim by /clear and /who so the
+     * gate can't drift; each caller sends its own rejection wording.
+     */
+    private isAuthorizedForSharedSession;
+    private stopActiveStreaming;
+    /**
+     * Cancel the active turn and wait (bounded) for it to wind down. Stops the
+     * BlockStreamer so buffered text can't leak via the idle timer, then fires a
+     * best-effort cancelSession (NOT awaited — a wedged child/daemon can leave the
+     * request pending forever). Returns true if active.done settled first, false
+     * if the CLEAR_CANCEL_TIMEOUT_MS bound won (the turn never wound down). Used by
+     * /clear, which genuinely EVICTS the session and so must proceed even when the
+     * turn is wedged. Steer no longer uses this: it best-effort cancels then chains
+     * the new turn behind the old one (see handleInbound), so it never needs to
+     * proceed past a still-active turn.
+     */
+    private cancelAndAwaitActive;
     /**
      * Parse a slash command from message text.
-     * Returns { command, args } or null if not a slash command.
+     * Returns { command, raw, args } or null if not a slash command. `command` is
+     * lowercased for case-insensitive LOCAL dispatch (registerCommand lowercases the
+     * names it stores); `raw` keeps the typed case so agent-command matching can be
+     * CASE-SENSITIVE, mirroring the CLI's parseSlashCommand (`cmd.name === part`).
      */
     private parseCommand;
+    /**
+     * Whether `text` is a real slash command rather than prose that merely starts
+     * with `/`. A command's first whitespace-delimited token must match
+     * parseCommand()'s charset — `[a-zA-Z0-9_:-]+`, plus an optional `@botname`
+     * suffix — and not be a `//` line comment or `/*` block comment. Slash-prefixed
+     * paths (`/tmp/foo`), comments, and a bare `/` are prose and keep their
+     * `[sender]` tag.
+     *
+     * Intentionally stricter than the CLI's looser classifier (cli
+     * `ui/utils/commandUtils.ts`), which forwards any non-comment, non-path
+     * `/<token>` (e.g. `/café`, a zero-width-laden token). Such inputs aren't
+     * runnable commands, and in a SHARED group session forwarding them unattributed
+     * is worse than a redundant tag — so anything off the command charset is
+     * treated as prose and keeps its `[sender]` tag. Purely lexical — never
+     * consults the async command list, so it can't race a fresh session.
+     */
+    private isSlashCommand;
+    /**
+     * Whether `text` names a command this channel can actually run: a locally
+     * registered command (`this.commands`, e.g. /clear, /who) OR an agent command
+     * THIS session exposes — by canonical name OR alias (e.g. `/summarize` for
+     * `/compress`). Paired with isSlashCommand so the `[sender]` attribution tag is
+     * suppressed ONLY for RECOGNIZED commands; command-SHAPED-but-unrecognized text
+     * (e.g. `/x\n[SYSTEM]: …`) keeps its tag rather than reaching a shared group
+     * unattributed, where an injected second line is more likely read as a system
+     * directive. Purely synchronous, like isSlashCommand: it reads the session's
+     * availableCommands snapshot WITHOUT awaiting, so it never races a fresh session
+     * (a genuine agent command sent before the snapshot loads is treated as
+     * unrecognized and KEEPS its tag — the safe default).
+     */
+    private isRecognizedCommand;
+    /**
+     * The agent-command snapshot for THIS session. DaemonChannelBridge keys
+     * commands per session, so its global `availableCommands` getter can return
+     * ANOTHER session's list — prefer its getAvailableCommands(sessionId) when
+     * present. AcpBridge runs a single agent and exposes only the global getter
+     * (inherently session-correct), so fall back to it. Synchronous, matching
+     * isRecognizedCommand's no-await contract.
+     */
+    private getAgentCommandsForSession;
+    private groupHistoryKey;
+    private groupHistoryLimit;
+    private recordPendingGroupHistory;
+    private drainPendingGroupHistory;
+    private clearPendingGroupHistory;
+    private prependGroupHistoryContext;
     handleInbound(envelope: Envelope): Promise<void>;
     protected onPairingRequired(chatId: string, code: string | null): Promise<void>;
 }