lark-remote 0.1.6 → 0.1.8

package/dist/runner/codex/app-server/translator.d.ts

@@ -7,29 +7,9 @@
  * completes. Method names and parameter shapes follow the real Codex
  * app-server v2 protocol (see protocol-types.ts).
  */
-import type { AgentEvent } from '../../types.js';
+import type { AgentEvent, TurnStartedEvent, TurnDiffEvent } from '../../types.js';
 import type { ApprovalRequestedEvent, ApprovalResolvedEvent } from '../../types.js';
 import { type TurnCompletedNotification } from './protocol-types.js';
-export interface TurnStartedEvent {
-    type: 'turn_started';
-    threadId: string;
-    turnId: string;
-    operationKind: 'turn' | 'compaction';
-}
-export interface TurnDiffEvent {
-    type: 'turn_diff';
-    text?: string;
-    reasoning?: string;
-    toolOutput?: string;
-    plan?: string;
-    fileChanges?: Array<{
-        path: string;
-        kind: 'add' | 'update' | 'delete';
-        diff?: string;
-    }>;
-    threadId: string;
-    turnId: string;
-}
 export type TranslatorEvent = AgentEvent | TurnStartedEvent | TurnDiffEvent | ApprovalRequestedEvent | ApprovalResolvedEvent;
 export declare class CodexAppServerTranslator {
     private turnId;
@@ -63,6 +43,13 @@ export declare class CodexAppServerTranslator {
      * Handle a server request (incoming JSON-RPC request from server, e.g. approval).
      */
     handleServerRequest(id: number | string, method: string, params: unknown): TranslatorEvent[];
+    /**
+     * Codex AskUserQuestion：item/tool/requestUserInput → question 审批事件。
+     * 问题 id 保留在 UserQuestion.id（回编时文本 → id 映射），options 为
+     * null/空 → 自由文本题（空数组驱动卡片渲染输入框）；autoResolutionMs
+     * 透传为 per-request 超时（coordinator 优先使用）。
+     */
+    private handleRequestUserInput;
     /**
      * Synthesize a ResultEvent from the current turn state.
      * Called when the turn completes.

package/dist/runner/codex/app-server/translator.js

@@ -7,6 +7,7 @@
  * completes. Method names and parameter shapes follow the real Codex
  * app-server v2 protocol (see protocol-types.ts).
  */
+import { makeQuestionApprovalEvent } from '../../question-common.js';
 import { NotificationMethod, ServerRequestMethod, UNSUPPORTED_SERVER_REQUEST_METHODS, } from './protocol-types.js';
 // =============================================================================
 // Translator
@@ -86,10 +87,33 @@ export class CodexAppServerTranslator {
                 return this.handleFileApproval(id, params);
             case ServerRequestMethod.PERMISSIONS_APPROVAL:
                 return this.handlePermissionsApproval(id, params);
+            case ServerRequestMethod.REQUEST_USER_INPUT:
+                return this.handleRequestUserInput(id, params);
             default:
                 return [];
         }
     }
+    /**
+     * Codex AskUserQuestion：item/tool/requestUserInput → question 审批事件。
+     * 问题 id 保留在 UserQuestion.id（回编时文本 → id 映射），options 为
+     * null/空 → 自由文本题（空数组驱动卡片渲染输入框）；autoResolutionMs
+     * 透传为 per-request 超时（coordinator 优先使用）。
+     */
+    handleRequestUserInput(requestId, params) {
+        const questions = params.questions
+            .map((q) => requestUserInputQuestionToUserQuestion(q))
+            .filter((q) => q !== null);
+        if (questions.length === 0) {
+            // 无有效问题：不渲染空提问卡，返回 [] 由 runner 以 method-not-found
+            // 拒绝（服务端视作请求失败，不会悬挂）。
+            return [];
+        }
+        return [
+            makeQuestionApprovalEvent(requestId, questions, params.threadId, {
+                timeoutMs: params.autoResolutionMs ?? undefined,
+            }),
+        ];
+    }
     /**
      * Synthesize a ResultEvent from the current turn state.
      * Called when the turn completes.
@@ -450,21 +474,11 @@ export class CodexAppServerTranslator {
         const view = {
             requestId,
             kind: 'command',
-            threadShort: params.threadId.slice(0, 8),
-            turnShort: params.turnId.slice(0, 8),
-            workspace: params.cwd ?? '',
             command: params.command ?? undefined,
             commandCwd: params.cwd ?? undefined,
             reason: params.reason ?? undefined,
-            network: params.networkApprovalContext
-                ? {
-                    host: params.networkApprovalContext.host,
-                    protocol: params.networkApprovalContext.protocol,
-                }
-                : undefined,
             availableDecisions: decisions,
             ...(payloads ? { decisionPayloads: payloads } : {}),
-            pendingTotal: 1,
         };
         return [
             {
@@ -492,14 +506,10 @@ export class CodexAppServerTranslator {
         const view = {
             requestId,
             kind: 'file',
-            threadShort: params.threadId.slice(0, 8),
-            turnShort: params.turnId.slice(0, 8),
-            workspace: '',
             fileChanges,
             reason: params.reason ?? undefined,
             // 真实 FileChangeApprovalDecision 枚举：accept/acceptForSession/decline/cancel。
             availableDecisions: ['accept', 'acceptForSession', 'decline', 'cancel'],
-            pendingTotal: 1,
         };
         // 乱序流：审批先到、item/started 后到。先出事件（回退信息），item 到达时
         // 以 approval_view_updated 补全，避免卡片永久空白。
@@ -582,12 +592,8 @@ export class CodexAppServerTranslator {
         const view = {
             requestId,
             kind: 'permissions',
-            threadShort: params.threadId.slice(0, 8),
-            turnShort: params.turnId.slice(0, 8),
-            workspace: params.cwd,
             reason: params.reason ?? undefined,
             availableDecisions: ['accept', 'decline', 'cancel'],
-            pendingTotal: 1,
             permissions: {
                 items: permItems,
             },
@@ -731,4 +737,25 @@ function normalizeCommandDecisions(list) {
         ...(Object.keys(payloads).length > 0 ? { payloads } : {}),
     };
 }
+/** Codex wire question → 统一 UserQuestion（options null/空 → 自由文本题）。 */
+function requestUserInputQuestionToUserQuestion(q) {
+    const question = q.question?.trim();
+    if (!question)
+        return null;
+    const options = (q.options ?? []).map((opt) => ({
+        label: opt.label,
+        ...(opt.description ? { description: opt.description } : {}),
+    }));
+    return {
+        id: q.id,
+        header: q.header || undefined,
+        question,
+        isOther: q.isOther,
+        isSecret: q.isSecret,
+        options,
+        // Codex user_note：选项题渲染「补充说明（可选）」输入（live 验证模型理解
+        // "user_note:" 条目）；自由文本题（options 空）不需要。
+        ...(options.length > 0 ? { allowNote: true } : {}),
+    };
+}
 //# sourceMappingURL=translator.js.map

package/dist/runner/codex/index.d.ts

@@ -1,3 +1 @@
-export { CodexExecRunner } from './runner.js';
 export { CodexAppServerRunner } from './app-server/runner.js';
-export { createCodexRunner } from './factory.js';

package/dist/runner/codex/index.js

@@ -1,4 +1,2 @@
-export { CodexExecRunner } from './runner.js';
 export { CodexAppServerRunner } from './app-server/runner.js';
-export { createCodexRunner } from './factory.js';
 //# sourceMappingURL=index.js.map

package/dist/runner/common/acp/protocol-helpers.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Shared helper functions for the ACP protocol layer.
+ *
+ * Extracted from runner.ts and translator.ts to avoid duplication (G5).
+ * Shape source: approval.ts:28-29 — optionId is opaque, echo back as-is.
+ */
+import type { PermissionOption } from './protocol-types.js';
+/**
+ * Find an option by matching its `kind` against a list of candidate values,
+ * and return the `optionId` to echo back in the approval response.
+ * ACP option kind values vary between kimi versions; this handles both
+ * the documented names and the observed real names (§2.3).
+ */
+export declare function findOptionIdByKind(options: PermissionOption[], candidateKinds: string[]): string | undefined;

package/dist/runner/common/acp/protocol-helpers.js

@@ -0,0 +1,21 @@
+/**
+ * Shared helper functions for the ACP protocol layer.
+ *
+ * Extracted from runner.ts and translator.ts to avoid duplication (G5).
+ * Shape source: approval.ts:28-29 — optionId is opaque, echo back as-is.
+ */
+/**
+ * Find an option by matching its `kind` against a list of candidate values,
+ * and return the `optionId` to echo back in the approval response.
+ * ACP option kind values vary between kimi versions; this handles both
+ * the documented names and the observed real names (§2.3).
+ */
+export function findOptionIdByKind(options, candidateKinds) {
+    for (const kind of candidateKinds) {
+        const found = options.find((opt) => opt.kind === kind);
+        if (found)
+            return found.optionId;
+    }
+    return undefined;
+}
+//# sourceMappingURL=protocol-helpers.js.map

package/dist/runner/common/acp/protocol-types.d.ts

@@ -0,0 +1,271 @@
+/**
+ * ACP (Agent Client Protocol) JSON-RPC Protocol Types — shared layer.
+ *
+ * Aligned with the real `kimi acp` protocol (kimi-code/packages/acp-server).
+ * Method names and field names use the wire format exactly.
+ * Only covers the methods and events needed for the integration
+ * (§4 event mapping table + §5 approval + §6 compact).
+ *
+ * ============================================================================
+ * 事件契约（translator 共享规范 —— 文档不是抽象，各家 translator 仍各自实现）
+ * ============================================================================
+ *
+ * lark-remote 内部事件流对 ACP 系 agent（kimi acp、后续 opencode acp）的约定：
+ *
+ * 1. `assistant/text` 与 `assistant/thinking` 是**增量通道**：run-state 收到后
+ *    向对应 item **追加**文本。
+ * 2. `turn_diff` 是**快照通道**：run-state 按 itemId **原地替换**全文（kimi ACP
+ *    文本/思考固定 itemId `'text'`/`'thinking'`）。
+ * 3. kimi wire 的 `content.text`（agent_message_chunk / agent_thought_chunk）
+ *    是**增量 delta**（来源：kimi-code events-map.ts
+ *    `assistantDeltaToSessionUpdate`）。translator 必须把 delta 累积成全文后
+ *    以 `turn_diff` 快照发出——禁止把 delta 直接当快照或把全文当增量重复追加。
+ * 4. `tool_call` 事件可能**没有 rawInput**（工具 lazy-create，参数在后续
+ *    tool_call_update 才补齐）；translator 必须归一化为 `{}`，不得因缺失崩溃。
+ */
+export type { JsonRpcRequest, JsonRpcNotification, JsonRpcSuccessResponse, JsonRpcErrorResponse, } from '../jsonrpc/types.js';
+/** Standard JSON-RPC error codes. */
+export declare const RpcErrorCode: {
+    readonly PARSE_ERROR: -32700;
+    readonly INVALID_REQUEST: -32600;
+    readonly METHOD_NOT_FOUND: -32601;
+    readonly INVALID_PARAMS: -32602;
+    readonly INTERNAL_ERROR: -32603;
+    /** Timeout error (custom, not standard JSON-RPC). */
+    readonly TIMEOUT_ERROR: -32000;
+    /** Connection lost / transport error (custom). */
+    readonly CONNECTION_LOST: -32001;
+};
+export interface InitializeParams {
+    /** Protocol version — must be 1 (number, not string). */
+    protocolVersion: number;
+    /** Client capabilities: explicitly declare what we support (all off). */
+    clientCapabilities: {
+        fs: {
+            readTextFile: boolean;
+            writeTextFile: boolean;
+        };
+        terminal: boolean;
+    };
+}
+export interface AgentInfo {
+    name: string;
+    version: string;
+}
+export interface InitializeResult {
+    /** Protocol version returned by the server. */
+    protocolVersion: number;
+    /** Agent info — NOTE: field is `agentInfo`, NOT `serverInfo`. */
+    agentInfo: AgentInfo;
+    /** Authentication methods the server supports. */
+    authMethods?: string[];
+    /** Agent capabilities declared by the server. */
+    agentCapabilities?: Record<string, unknown>;
+}
+/**
+ * ACP mode ids (what the server accepts in session/set_mode).
+ * kimi exposes default/auto/yolo (plan not exposed in v1);
+ * opencode uses agent names build/plan.
+ */
+export type AcpMode = 'default' | 'plan' | 'auto' | 'yolo' | 'build';
+export interface SessionNewParams {
+    cwd: string;
+    /** MCP servers config — REQUIRED (can be empty array). */
+    mcpServers: unknown[];
+}
+export interface SessionNewResult {
+    sessionId: string;
+    configOptions?: Record<string, unknown>;
+}
+export interface SessionResumeParams {
+    sessionId: string;
+    cwd: string;
+}
+export interface SessionResumeResult {
+    sessionId: string;
+    configOptions?: Record<string, unknown>;
+}
+export interface SessionPromptParams {
+    sessionId: string;
+    prompt: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}
+export interface SessionPromptResult {
+    stopReason: 'end_turn' | 'cancelled' | string;
+    [key: string]: unknown;
+}
+export interface SessionCancelParams {
+    sessionId: string;
+}
+export interface SessionSetModeParams {
+    sessionId: string;
+    /** Parameter name is `modeId`, NOT `mode` (server.ts:439). */
+    modeId: AcpMode;
+}
+/** Notification method names for ACP protocol. */
+export declare const NotificationMethod: {
+    /** Session update carries one of the event types below. */
+    readonly SESSION_UPDATE: "session/update";
+};
+/** Event types within session/update params. */
+export declare const SessionEventType: {
+    readonly AGENT_MESSAGE_CHUNK: "agent_message_chunk";
+    readonly AGENT_THOUGHT_CHUNK: "agent_thought_chunk";
+    readonly TOOL_CALL: "tool_call";
+    readonly TOOL_CALL_UPDATE: "tool_call_update";
+    readonly PLAN: "plan";
+    readonly AVAILABLE_COMMANDS_UPDATE: "available_commands_update";
+    readonly SESSION_INFO_UPDATE: "session_info_update";
+    readonly CURRENT_MODE_UPDATE: "current_mode_update";
+    readonly CONFIG_OPTION_UPDATE: "config_option_update";
+    readonly USAGE_UPDATE: "usage_update";
+};
+export interface AgentMessageChunkEvent {
+    sessionUpdate: 'agent_message_chunk';
+    /** events-map.ts:30-37 — content.text, NOT delta. */
+    content: {
+        type: 'text';
+        text: string;
+    };
+}
+export interface AgentThoughtChunkEvent {
+    sessionUpdate: 'agent_thought_chunk';
+    /** events-map.ts:280-288 — same content.text structure. */
+    content: {
+        type: 'text';
+        text: string;
+    };
+}
+export interface ToolCallEvent {
+    sessionUpdate: 'tool_call';
+    toolCallId: string;
+    title: string;
+    /** events-map.ts toolCallStartToSessionUpdate — rawInput is the args
+     *  OBJECT (not a JSON string). */
+    kind: string;
+    status: 'pending' | 'in_progress' | string;
+    rawInput: unknown;
+    locations?: unknown[];
+    content?: unknown[];
+    [key: string]: unknown;
+}
+export interface ToolCallUpdateEvent {
+    sessionUpdate: 'tool_call_update';
+    toolCallId: string;
+    status: 'running' | 'completed' | 'failed';
+    title?: string;
+    rawInput?: unknown;
+    /** events-map.ts toolResultToSessionUpdate — raw output of the tool. */
+    rawOutput?: string;
+    locations?: unknown[];
+    content?: unknown[];
+    [key: string]: unknown;
+}
+export interface AcpPlanEvent {
+    sessionUpdate: 'plan';
+    entries?: unknown[];
+    [key: string]: unknown;
+}
+export interface AvailableCommandsUpdateEvent {
+    sessionUpdate: 'available_commands_update';
+    availableCommands?: unknown[];
+    [key: string]: unknown;
+}
+export interface SessionInfoUpdateEvent {
+    sessionUpdate: 'session_info_update';
+    title: string | null;
+    [key: string]: unknown;
+}
+export interface CurrentModeUpdateEvent {
+    sessionUpdate: 'current_mode_update';
+    currentModeId: string;
+    [key: string]: unknown;
+}
+export interface ConfigOptionUpdateEvent {
+    sessionUpdate: 'config_option_update';
+    configOptions?: unknown[];
+    [key: string]: unknown;
+}
+export interface UsageUpdateEvent {
+    sessionUpdate: 'usage_update';
+    /** events-map.ts:505-516 — current context occupancy (token count).
+     *  There is NO inputTokens/outputTokens split. */
+    used: number;
+    /** Model context window upper bound. */
+    size: number;
+    [key: string]: unknown;
+}
+export type SessionUpdateEvent = AgentMessageChunkEvent | AgentThoughtChunkEvent | ToolCallEvent | ToolCallUpdateEvent | AcpPlanEvent | AvailableCommandsUpdateEvent | SessionInfoUpdateEvent | CurrentModeUpdateEvent | ConfigOptionUpdateEvent | UsageUpdateEvent;
+export interface SessionUpdateNotification {
+    method: 'session/update';
+    params: {
+        sessionId: string;
+        update: SessionUpdateEvent;
+    };
+}
+export declare const ServerRequestMethod: {
+    readonly REQUEST_PERMISSION: "session/request_permission";
+    /** Kimi AskUserQuestion elicitation form（客户端广告 elicitation.form 时启用）。 */
+    readonly ELICITATION_CREATE: "elicitation/create";
+};
+export interface PermissionOption {
+    /** Opaque option identifier — echo back in response outcome.optionId. */
+    optionId: string;
+    /** Human-readable option name. */
+    name: string;
+    /** Option kind: 'approve_once'/'allow_once', 'approve_always'/'allow_always', 'reject'/'reject_once'. */
+    kind: string;
+}
+export interface RequestPermissionParams {
+    sessionId: string;
+    toolCall?: {
+        title: string;
+        rawInput: string;
+        [key: string]: unknown;
+    };
+    options: PermissionOption[];
+    /** Question elicitation marker: true when this is a question rather than
+     *  a tool approval (§5.4). Identified by absence of toolCall and/or presence
+     *  of options with Skip semantics. */
+    isQuestion?: boolean;
+    [key: string]: unknown;
+}
+export interface RequestPermissionResponse {
+    outcome: {
+        outcome: 'selected' | 'cancelled';
+        optionId?: string;
+    };
+}
+export interface ElicitationEnumOption {
+    const: string;
+    title?: string;
+    description?: string;
+}
+export interface ElicitationPropertySchema {
+    type: 'string' | 'array';
+    title?: string;
+    description?: string;
+    minItems?: number;
+    oneOf?: ElicitationEnumOption[];
+    items?: {
+        anyOf?: ElicitationEnumOption[];
+    };
+}
+export interface ElicitationCreateParams {
+    sessionId: string;
+    toolCallId?: string;
+    mode: 'form';
+    message?: string;
+    requestedSchema: {
+        type: 'object';
+        required?: string[];
+        properties: Record<string, ElicitationPropertySchema>;
+    };
+}
+export interface ElicitationCreateResponse {
+    action: 'accept' | 'decline' | 'cancel';
+    /** accept 时的答案，key 为 q0..qn（按问题顺序）。 */
+    content?: Record<string, string | string[]>;
+}

package/dist/runner/common/acp/protocol-types.js

@@ -0,0 +1,77 @@
+/**
+ * ACP (Agent Client Protocol) JSON-RPC Protocol Types — shared layer.
+ *
+ * Aligned with the real `kimi acp` protocol (kimi-code/packages/acp-server).
+ * Method names and field names use the wire format exactly.
+ * Only covers the methods and events needed for the integration
+ * (§4 event mapping table + §5 approval + §6 compact).
+ *
+ * ============================================================================
+ * 事件契约（translator 共享规范 —— 文档不是抽象，各家 translator 仍各自实现）
+ * ============================================================================
+ *
+ * lark-remote 内部事件流对 ACP 系 agent（kimi acp、后续 opencode acp）的约定：
+ *
+ * 1. `assistant/text` 与 `assistant/thinking` 是**增量通道**：run-state 收到后
+ *    向对应 item **追加**文本。
+ * 2. `turn_diff` 是**快照通道**：run-state 按 itemId **原地替换**全文（kimi ACP
+ *    文本/思考固定 itemId `'text'`/`'thinking'`）。
+ * 3. kimi wire 的 `content.text`（agent_message_chunk / agent_thought_chunk）
+ *    是**增量 delta**（来源：kimi-code events-map.ts
+ *    `assistantDeltaToSessionUpdate`）。translator 必须把 delta 累积成全文后
+ *    以 `turn_diff` 快照发出——禁止把 delta 直接当快照或把全文当增量重复追加。
+ * 4. `tool_call` 事件可能**没有 rawInput**（工具 lazy-create，参数在后续
+ *    tool_call_update 才补齐）；translator 必须归一化为 `{}`，不得因缺失崩溃。
+ */
+/** Standard JSON-RPC error codes. */
+export const RpcErrorCode = {
+    PARSE_ERROR: -32700,
+    INVALID_REQUEST: -32600,
+    METHOD_NOT_FOUND: -32601,
+    INVALID_PARAMS: -32602,
+    INTERNAL_ERROR: -32603,
+    /** Timeout error (custom, not standard JSON-RPC). */
+    TIMEOUT_ERROR: -32000,
+    /** Connection lost / transport error (custom). */
+    CONNECTION_LOST: -32001,
+};
+// =============================================================================
+// Notifications (server → client, via session/update)
+// Shape source: kimi-code/packages/acp-server/src/events-map.ts
+//   (each constructor below) + 2026-08-15 live smoke test against kimi 0.36.0
+//
+// REAL envelope: {sessionId, update: {sessionUpdate: '<kind>', ...}}.
+// The discriminator field is `update.sessionUpdate` — there is NO nested
+// `event.type` / `event.delta` (S5/S6 打回根因：旧实现读 params.event，
+// 真实通知全部静默丢弃)。
+// =============================================================================
+/** Notification method names for ACP protocol. */
+export const NotificationMethod = {
+    /** Session update carries one of the event types below. */
+    SESSION_UPDATE: 'session/update',
+};
+/** Event types within session/update params. */
+export const SessionEventType = {
+    AGENT_MESSAGE_CHUNK: 'agent_message_chunk',
+    AGENT_THOUGHT_CHUNK: 'agent_thought_chunk',
+    TOOL_CALL: 'tool_call',
+    TOOL_CALL_UPDATE: 'tool_call_update',
+    PLAN: 'plan',
+    AVAILABLE_COMMANDS_UPDATE: 'available_commands_update',
+    SESSION_INFO_UPDATE: 'session_info_update',
+    CURRENT_MODE_UPDATE: 'current_mode_update',
+    CONFIG_OPTION_UPDATE: 'config_option_update',
+    USAGE_UPDATE: 'usage_update',
+};
+// =============================================================================
+// Server Requests (approval — reverse RPC)
+// Shape source: kimi-code/packages/acp-server/src/approval.ts:28-29
+//   options: [{optionId, name, kind}]; optionId is opaque, echo back as-is
+//   + 2026-08-15 live smoke test: approve_once / approve_always / reject
+// =============================================================================
+export const ServerRequestMethod = {
+    REQUEST_PERMISSION: 'session/request_permission',
+    /** Kimi AskUserQuestion elicitation form（客户端广告 elicitation.form 时启用）。 */
+    ELICITATION_CREATE: 'elicitation/create',
+};
+//# sourceMappingURL=protocol-types.js.map

package/dist/runner/common/connection-based-runner.d.ts

@@ -0,0 +1,111 @@
+/**
+ * ConnectionBasedRunner: abstract base class for workspace-lifetime JSON-RPC
+ * agent runners (codex app-server / kimi acp / opencode acp).
+ *
+ * Encapsulates the shared connection-based turn machinery the three runners
+ * were duplicating (and had drifted apart on):
+ *   - notification queue + waitResolve pump (consumeTurn / waitForEvents)
+ *   - forceFinish / stopRequested / deferred-stop semantics
+ *   - connection-lost respawn-and-retry-once in run()
+ *   - turn idle watchdog (nextTurnIdleDeadline)
+ *   - dispose / killOrphan / registerExitHandlers / getUsageAuthority no-ops
+ *
+ * Subclasses keep the protocol-specific parts (setupTurn, runCompact,
+ * handleNotification/handleServerRequest, respondApproval, pendingApprovals,
+ * updateApprovalMode, getStatusInfo) and provide the small abstract hooks below.
+ */
+import type { AgentKind, AgentSessionReader, AgentEvent, AgentRunner, AgentStatusInfo, SpawnOptions } from '../types.js';
+/** How long to wait for turn output notifications before failing. */
+export declare const TURN_IDLE_TIMEOUT_MS: number;
+export declare abstract class ConnectionBasedRunner<TClient, TEvent = AgentEvent> implements AgentRunner {
+    readonly kind: AgentKind;
+    readonly sessionReader: AgentSessionReader;
+    readonly lifetime: "workspace";
+    protected currentClient: TClient | null;
+    protected currentTurnId: string | null;
+    protected lastEventAt: number;
+    protected _isRunning: boolean;
+    protected readonly turnIdleTimeoutMs: number;
+    /** Notification queue consumed by the active run generator. */
+    protected notificationQueue: TEvent[];
+    protected waitResolve: (() => void) | null;
+    protected forceFinish: boolean;
+    /** stop() 在 turn/start 或 prompt 响应前到达时置位，完成后再补发 cancel/interrupt。 */
+    protected stopRequested: boolean;
+    protected constructor(opts: {
+        kind: AgentKind;
+        sessionReader: AgentSessionReader;
+        turnIdleTimeoutMs?: number;
+    }, defaultTurnIdleTimeoutMs?: number);
+    /** Log tag used for operational log lines (e.g. 'kimi-acp-runner'). */
+    protected abstract get logTag(): string;
+    /** Error message for the turn-idle-timeout result. */
+    protected abstract get turnTimeoutErrorMessage(): string;
+    /** Error message for the interrupted (stop/forceFinish) result. */
+    protected abstract get turnInterruptedErrorMessage(): string;
+    /** The active thread/session id, used for result events / synthetic init. */
+    protected abstract currentSessionId(): string | null;
+    /** Deferred-stop predicate: stop() marks stopRequested instead of cancelling now. */
+    protected abstract shouldDeferStop(): boolean;
+    /** Cancel the current turn (codex: turn/interrupt request; acp: session/cancel notify). */
+    protected abstract cancelCurrentTurn(): Promise<void>;
+    /** Set up the turn: acquire + thread|session new/resume + prompt. */
+    protected abstract setupTurn(message: string, opts: SpawnOptions): Promise<void>;
+    get isRunning(): boolean;
+    /** Agent self-describing status info for /status display. */
+    abstract getStatusInfo(): AgentStatusInfo;
+    /**
+     * Run a message. Delegates to executeTurn() with the standard setup.
+     */
+    run(message: string, opts: SpawnOptions): AsyncGenerator<AgentEvent>;
+    /**
+     * Shared turn lifecycle used by run() and runCompact(): isRunning guard →
+     * resetRunState → setupFn (with connection-lost respawn-and-retry-once) →
+     * deferred stop → synthetic init → consumeTurn; catch yields synthetic init
+     * + error result; finally resets flags + notifyIdle.
+     *
+     * `setupFn` performs the turn-specific setup (acquire, session new/resume,
+     * prompt, etc.) and may push events into the notification queue.
+     */
+    protected executeTurn(opts: SpawnOptions, setupFn: () => Promise<void>): AsyncGenerator<AgentEvent>;
+    /**
+     * Stop the current turn by cancelling it. Shared skeleton: if the turn/start
+     * or prompt has not yet resolved (shouldDeferStop), mark stopRequested and
+     * unblock; otherwise cancel now via cancelCurrentTurn().
+     */
+    stop(_opts?: {
+        immediate?: boolean;
+    }): Promise<void>;
+    /**
+     * Dispose the runner: release the connection.
+     */
+    dispose(): Promise<void>;
+    getUsageAuthority(): 'live';
+    killOrphan(): void;
+    registerExitHandlers(): void;
+    unregisterExitHandlers(): void;
+    /**
+     * Consume the notification queue until a result event arrives or the turn
+     * times out / is interrupted. forceFinish drains the queue first (the
+     * deferred cancel's own events may still be in it) before yielding the
+     * interrupted result.
+     */
+    protected consumeTurn(): AsyncGenerator<AgentEvent>;
+    /** Compute the current idle deadline. 0 disables; otherwise rolling on last event. */
+    protected nextTurnIdleDeadline(): number;
+    protected waitForEvents(deadline: number): Promise<boolean>;
+    protected pushEvents(events: TEvent[]): void;
+    protected wakeWaiters(): void;
+    protected failTurn(message: string): void;
+    protected resetRunState(): void;
+    /** Release the connection + detach stale client hooks after a lost connection. */
+    protected respawnAfterConnectionLost(opts: SpawnOptions): Promise<void>;
+    /** Hook: clear subclass turn state in run() finally (session ids, translator, flags). */
+    protected abstract clearTurnState(): void;
+    /** Release the connection for a workspace (subclass dispatches to its manager). */
+    protected abstract releaseConnection(cwd: string): Promise<void>;
+    /** Notify the connection manager that the workspace is idle (subclass). */
+    protected abstract notifyIdle(cwd: string): void;
+    /** Dispose all connections (subclass dispatches to its manager). */
+    protected abstract disposeConnections(): Promise<void>;
+}