@pickle-pee/runtime 0.0.0

package/README.md

@@ -0,0 +1,99 @@
+# @pickle-pee/runtime
+
+## 职责
+
+产品层运行时。围绕 `pi-coding-agent` 构建 facade，管理会话（SessionFacade）、运行时上下文（RuntimeContext）、计划执行协议和事件标准化。所有 CLI 模式共享此 runtime。
+
+## 导出
+
+### 入口
+
+- `createAppRuntime(config)` — 运行时工厂入口，返回 `AppRuntime`
+- `AppRuntime` — 提供 `createSession()`、`recoverSession()`、`shutdown()` 和全局事件总线
+
+### 会话管理
+
+- `SessionFacade` — 会话外观接口，封装 prompt/continue/abort/close 生命周期
+- `SessionFacadeImpl` — SessionFacade 的实现类
+- `createInitialSessionState()` — 创建初始会话状态
+- `recoverSessionState()` / `serializeForRecovery()` — 会话恢复与序列化
+
+### 上下文
+
+- `RuntimeContext` — 不可变执行上下文（sessionId, cwd, mode, model, toolSet, taskState）
+- `createRuntimeContext()` — 上下文工厂
+
+### 事件体系
+
+- `EventBus` — 类型化事件总线（`on`/`onCategory`/`emit`/`off`/`removeAllListeners`）
+- `RuntimeEvent` — 18 种标准化产品层事件的联合类型，6 个分类：
+  - `session` — 会话生命周期（created/resumed/suspended/closing/closed）
+  - `tool` — 工具执行（started/update/completed/denied）
+  - `plan` — 计划进度（created/step_started/step_completed/completed）
+  - `compaction` — 上下文压缩（started/completed）
+  - `permission` — 权限判定（requested/resolved）
+  - `text` — 文本流（text_delta/thinking_delta）
+
+### 适配层
+
+- `KernelSessionAdapter` — 上游 pi-mono 会话桥接接口
+- `RawUpstreamEvent` — 上游原始事件信封
+- `EventNormalizer` — raw event → RuntimeEvent 标准化翻译器
+
+### 计划类型（P2 仅类型，引擎在 P4）
+
+- `PlanSummary`、`PlanStep`、`PlanStatus`
+
+## 依赖方向
+
+- 依赖: 无（本项目叶子节点）
+- 被依赖: `app-tools`, `app-ui`, `app-extensions`, `app-evaluation`, `app-cli`
+
+## 禁止事项
+
+- 不渲染 UI
+- 不实现具体工具逻辑
+- 不直接暴露上游零散事件，统一标准化后导出
+
+## 内部结构
+
+```
+src/
+├── index.ts                    # 主 barrel 导出
+├── create-app-runtime.ts       # 工厂入口
+├── runtime-context.ts          # RuntimeContext 工厂
+├── types/index.ts              # 所有公共类型定义
+├── domain/index.ts             # 领域类型重导出
+├── events/
+│   ├── index.ts                # 事件 barrel
+│   ├── runtime-event.ts        # 18 种标准化事件定义
+│   └── event-bus.ts            # 类型化事件总线
+├── session/
+│   ├── session-facade.ts       # SessionFacade 实现
+│   ├── session-state.ts        # 状态管理纯函数
+│   └── session-events.ts       # 会话事件工厂
+├── planning/
+│   ├── index.ts                # barrel
+│   └── plan-types.ts           # 计划类型
+├── adapters/
+│   ├── index.ts                # barrel
+│   └── kernel-session-adapter.ts # 上游适配器接口
+├── services/
+│   ├── index.ts                # barrel
+│   └── event-normalizer.ts     # 事件标准化翻译器
+└── test/                       # 测试
+    ├── create-app-runtime.test.ts
+    ├── session-facade.test.ts
+    ├── session-state.test.ts
+    ├── runtime-context.test.ts
+    ├── event-bus.test.ts
+    ├── event-normalizer.test.ts
+    └── stubs/
+        └── stub-kernel-session-adapter.ts
+```
+
+## 验证
+
+- `npx tsc --noEmit` 类型检查通过
+- `vitest run` 全部测试通过（51 tests, 6 files）
+- `npm run check` lint + format + types 全部通过

package/dist/adapters/index.d.ts

@@ -0,0 +1,3 @@
+export type { KernelSessionAdapter, RawUpstreamEvent } from "./kernel-session-adapter.js";
+export { bridgePiMonoEvent, createInitialBridgeState, type PiMonoBridgeResult, type PiMonoBridgeState, } from "./pi-mono-event-bridge.js";
+export { PiMonoSessionAdapter, type PiMonoSessionAdapterOptions } from "./pi-mono-session-adapter.js";

package/dist/adapters/index.js

@@ -0,0 +1,10 @@
+"use strict";
+// adapters/ — Bridges to the upstream kernel session implementation.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PiMonoSessionAdapter = exports.createInitialBridgeState = exports.bridgePiMonoEvent = void 0;
+var pi_mono_event_bridge_js_1 = require("./pi-mono-event-bridge.js");
+Object.defineProperty(exports, "bridgePiMonoEvent", { enumerable: true, get: function () { return pi_mono_event_bridge_js_1.bridgePiMonoEvent; } });
+Object.defineProperty(exports, "createInitialBridgeState", { enumerable: true, get: function () { return pi_mono_event_bridge_js_1.createInitialBridgeState; } });
+var pi_mono_session_adapter_js_1 = require("./pi-mono-session-adapter.js");
+Object.defineProperty(exports, "PiMonoSessionAdapter", { enumerable: true, get: function () { return pi_mono_session_adapter_js_1.PiMonoSessionAdapter; } });
+//# sourceMappingURL=index.js.map

package/dist/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":";AAAA,qEAAqE;;;AAGrE,qEAKmC;AAJlC,4HAAA,iBAAiB,OAAA;AACjB,mIAAA,wBAAwB,OAAA;AAIzB,2EAAsG;AAA7F,kIAAA,oBAAoB,OAAA"}

package/dist/adapters/kernel-session-adapter.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Adapter interface for bridging to pi-mono's AgentSession.
+ *
+ * Since pi-mono is not installed as a dependency yet, this file defines the
+ * contract that the real adapter will implement when integration begins.
+ * For P2, StubKernelSessionAdapter (in test/) provides a test double.
+ */
+import type { SessionRecoveryData } from "../types/index.js";
+/**
+ * Minimal representation of an event emitted by the upstream kernel.
+ *
+ * The EventNormalizer interprets these and maps them to product-layer
+ * RuntimeEvent instances. Unrecognized events are silently dropped.
+ */
+export interface RawUpstreamEvent {
+    readonly type: string;
+    readonly timestamp: number;
+    readonly payload?: Readonly<Record<string, unknown>>;
+}
+export interface ToolExecutionGateContext {
+    readonly toolName: string;
+    readonly toolCallId: string;
+    readonly parameters: Readonly<Record<string, unknown>>;
+}
+export type ToolExecutionGateDecision = {
+    readonly type: "allow";
+} | {
+    readonly type: "deny";
+    readonly reason: string;
+    readonly riskLevel: string;
+} | {
+    readonly type: "ask_user";
+    readonly reason: string;
+    readonly riskLevel: string;
+};
+export interface ToolExecutionGate {
+    beforeToolExecution(context: ToolExecutionGateContext): ToolExecutionGateDecision;
+}
+/**
+ * Bridge between the product layer and the upstream pi-coding-agent session.
+ *
+ * When pi-mono is integrated, a PiMonoSessionAdapter class will implement
+ * this interface by wrapping AgentSession. Only the adapter and normalizer
+ * need updating — nothing else in app-runtime changes.
+ */
+export interface KernelSessionAdapter {
+    /**
+     * Optional pre-execution governance hook.
+     *
+     * Adapters that support real tool interception should call this before
+     * dispatching a tool to the upstream executor.
+     */
+    setToolExecutionGate?(gate: ToolExecutionGate): void;
+    /** Send a user prompt and receive raw upstream events as a stream. */
+    sendPrompt(input: string): AsyncIterable<RawUpstreamEvent>;
+    /** Continue an existing conversation turn. */
+    sendContinue(input: string): AsyncIterable<RawUpstreamEvent>;
+    /** Optional manual compaction hook. */
+    sendCompact?(customInstructions?: string): AsyncIterable<RawUpstreamEvent>;
+    /**
+     * Optional permission-resolution callback for adapters that can suspend a
+     * tool until the product layer collects a user decision.
+     */
+    resolveToolPermission?(callId: string, decision: "allow" | "allow_for_session" | "allow_once" | "deny"): void | Promise<void>;
+    /** Abort the current streaming response. */
+    abort(): void;
+    /** Close the underlying session and release resources. */
+    close(): Promise<void>;
+    /** Extract serializable recovery data from the current session state. */
+    getRecoveryData(): SessionRecoveryData;
+    /** Resume a previously serialized session. Called before any prompt/continue. */
+    resume(data: SessionRecoveryData): void;
+}

package/dist/adapters/kernel-session-adapter.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * Adapter interface for bridging to pi-mono's AgentSession.
+ *
+ * Since pi-mono is not installed as a dependency yet, this file defines the
+ * contract that the real adapter will implement when integration begins.
+ * For P2, StubKernelSessionAdapter (in test/) provides a test double.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=kernel-session-adapter.js.map

package/dist/adapters/kernel-session-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kernel-session-adapter.js","sourceRoot":"","sources":["../../src/adapters/kernel-session-adapter.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG"}

package/dist/adapters/pi-mono-event-bridge.d.ts

@@ -0,0 +1,54 @@
+import type { RawUpstreamEvent } from "./kernel-session-adapter.js";
+type PiMonoBridgeEvent = {
+    type: "agent_start";
+} | {
+    type: "agent_end";
+} | {
+    type: "message_update";
+    assistantMessageEvent: {
+        type: "text_delta" | "thinking_delta";
+        delta: string;
+    };
+} | {
+    type: "tool_execution_start";
+    toolName: string;
+    toolCallId: string;
+    args?: unknown;
+} | {
+    type: "tool_execution_update";
+    toolName: string;
+    toolCallId: string;
+    partialResult?: unknown;
+} | {
+    type: "tool_execution_end";
+    toolName: string;
+    toolCallId: string;
+    isError: boolean;
+    result?: unknown;
+} | {
+    type: "compaction_start";
+} | {
+    type: "compaction_end";
+    result?: {
+        tokensBefore?: number;
+    };
+};
+export interface PiMonoBridgeState {
+    readonly model: {
+        readonly id: string;
+        readonly provider: string;
+        readonly displayName?: string;
+    } | null;
+    readonly toolSet: readonly string[];
+    readonly toolStartedAtById: ReadonlyMap<string, number>;
+}
+export interface PiMonoBridgeResult {
+    readonly rawEvents: readonly RawUpstreamEvent[];
+    readonly nextState: PiMonoBridgeState;
+}
+export declare function createInitialBridgeState(params: {
+    model: PiMonoBridgeState["model"];
+    toolSet: readonly string[];
+}): PiMonoBridgeState;
+export declare function bridgePiMonoEvent(event: PiMonoBridgeEvent, state: PiMonoBridgeState): PiMonoBridgeResult;
+export {};

package/dist/adapters/pi-mono-event-bridge.js

@@ -0,0 +1,159 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createInitialBridgeState = createInitialBridgeState;
+exports.bridgePiMonoEvent = bridgePiMonoEvent;
+function createInitialBridgeState(params) {
+    return {
+        model: params.model,
+        toolSet: [...params.toolSet],
+        toolStartedAtById: new Map(),
+    };
+}
+function bridgePiMonoEvent(event, state) {
+    const timestamp = Date.now();
+    const rawEvents = [];
+    const toolStartedAtById = new Map(state.toolStartedAtById);
+    switch (event.type) {
+        case "agent_start":
+            rawEvents.push({
+                type: "agent_start",
+                timestamp,
+                payload: {
+                    model: state.model ?? { id: "unknown", provider: "unknown" },
+                    toolSet: state.toolSet,
+                },
+            });
+            break;
+        case "agent_end":
+            rawEvents.push({
+                type: "agent_end",
+                timestamp,
+            });
+            break;
+        case "message_update": {
+            const delta = extractMessageDelta(event);
+            if (delta !== null) {
+                rawEvents.push({
+                    type: "message_update",
+                    timestamp,
+                    payload: {
+                        kind: delta.kind,
+                        content: delta.content,
+                    },
+                });
+            }
+            break;
+        }
+        case "tool_execution_start":
+            toolStartedAtById.set(event.toolCallId, timestamp);
+            rawEvents.push({
+                type: "tool_execution_start",
+                timestamp,
+                payload: {
+                    toolName: event.toolName,
+                    toolCallId: event.toolCallId,
+                    parameters: asRecord(event.args),
+                },
+            });
+            break;
+        case "tool_execution_update":
+            rawEvents.push({
+                type: "tool_execution_update",
+                timestamp,
+                payload: {
+                    toolName: event.toolName,
+                    toolCallId: event.toolCallId,
+                    update: extractToolText(event.partialResult),
+                },
+            });
+            break;
+        case "tool_execution_end": {
+            const startedAt = toolStartedAtById.get(event.toolCallId) ?? timestamp;
+            toolStartedAtById.delete(event.toolCallId);
+            rawEvents.push({
+                type: "tool_execution_end",
+                timestamp,
+                payload: {
+                    toolName: event.toolName,
+                    toolCallId: event.toolCallId,
+                    status: event.isError ? "failure" : "success",
+                    result: extractToolText(event.result),
+                    durationMs: Math.max(0, timestamp - startedAt),
+                },
+            });
+            break;
+        }
+        case "compaction_start":
+            rawEvents.push({
+                type: "compaction_start",
+                timestamp,
+            });
+            break;
+        case "compaction_end":
+            rawEvents.push({
+                type: "compaction_end",
+                timestamp,
+                payload: {
+                    originalMessageCount: 0,
+                    retainedMessageCount: 0,
+                    estimatedTokensSaved: event.result?.tokensBefore ?? 0,
+                },
+            });
+            break;
+        default:
+            break;
+    }
+    return {
+        rawEvents,
+        nextState: {
+            model: state.model,
+            toolSet: state.toolSet,
+            toolStartedAtById,
+        },
+    };
+}
+function extractMessageDelta(event) {
+    if (event.assistantMessageEvent.type === "text_delta") {
+        return {
+            kind: "text",
+            content: event.assistantMessageEvent.delta,
+        };
+    }
+    if (event.assistantMessageEvent.type === "thinking_delta") {
+        return {
+            kind: "thinking",
+            content: event.assistantMessageEvent.delta,
+        };
+    }
+    return null;
+}
+function extractToolText(value) {
+    if (!value || typeof value !== "object") {
+        return undefined;
+    }
+    const content = value.content;
+    if (Array.isArray(content)) {
+        const text = content
+            .filter((entry) => typeof entry === "object" && entry !== null)
+            .filter((entry) => entry.type === "text" && typeof entry.text === "string")
+            .map((entry) => entry.text.trim())
+            .filter((entry) => entry.length > 0)
+            .join("\n");
+        if (text.length > 0) {
+            return text;
+        }
+    }
+    try {
+        return JSON.stringify(value);
+    }
+    catch {
+        return String(value);
+    }
+}
+function asRecord(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        return {};
+    }
+    return { ...value };
+}
+//# sourceMappingURL=pi-mono-event-bridge.js.map

package/dist/adapters/pi-mono-event-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi-mono-event-bridge.js","sourceRoot":"","sources":["../../src/adapters/pi-mono-event-bridge.ts"],"names":[],"mappings":"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"}

package/dist/adapters/pi-mono-session-adapter.d.ts

@@ -0,0 +1,75 @@
+import type { ModelDescriptor, SessionRecoveryData } from "../types/index.js";
+import type { KernelSessionAdapter, RawUpstreamEvent, ToolExecutionGate } from "./kernel-session-adapter.js";
+type PermissionDecision = "allow" | "allow_for_session" | "allow_once" | "deny";
+type ThinkingLevel = "off" | "minimal" | "low" | "medium" | "high" | "xhigh";
+type PiMonoModel = Record<string, unknown>;
+interface AgentSession {
+    readonly sessionId: string;
+    readonly sessionFile?: string;
+    readonly isStreaming: boolean;
+    subscribe(listener: (event: unknown) => void): () => void;
+    prompt(input: string): Promise<void>;
+    followUp(input: string): Promise<void>;
+    abort(): Promise<void>;
+    compact(customInstructions?: string): Promise<void>;
+    dispose(): void;
+}
+interface PiMonoTool {
+    readonly name: string;
+    execute(toolCallId: string, params: unknown, signal?: AbortSignal, onUpdate?: ((partialResult: unknown) => void) | undefined): Promise<unknown>;
+}
+interface CreateAgentSessionOptions {
+    readonly cwd: string;
+    readonly agentDir?: string;
+    readonly model?: PiMonoModel;
+    readonly thinkingLevel?: ThinkingLevel;
+    readonly tools?: readonly PiMonoTool[];
+    readonly authStorage?: unknown;
+    readonly modelRegistry?: unknown;
+    readonly sessionManager?: unknown;
+}
+export interface PiMonoSessionAdapterOptions {
+    readonly workingDirectory: string;
+    readonly agentDir?: string;
+    readonly model: ModelDescriptor;
+    readonly toolSet?: readonly string[];
+    readonly thinkingLevel?: ThinkingLevel;
+    readonly createTools?: (cwd: string, toolSet: readonly string[]) => PiMonoTool[];
+    readonly createSession?: (options: CreateAgentSessionOptions) => Promise<AgentSession>;
+}
+export declare class PiMonoSessionAdapter implements KernelSessionAdapter {
+    private readonly options;
+    private session;
+    private toolExecutionGate;
+    private activeQueue;
+    private readonly pendingToolStartEvents;
+    private readonly approvedToolCalls;
+    private readonly deniedToolCalls;
+    private readonly pendingPermissionResolvers;
+    private pendingRecoveryData;
+    private closed;
+    private bridgeState;
+    constructor(options: PiMonoSessionAdapterOptions);
+    setToolExecutionGate(gate: ToolExecutionGate): void;
+    sendPrompt(input: string): AsyncIterable<RawUpstreamEvent>;
+    sendContinue(input: string): AsyncIterable<RawUpstreamEvent>;
+    sendCompact(customInstructions?: string): AsyncIterable<RawUpstreamEvent>;
+    resolveToolPermission(callId: string, decision: PermissionDecision): Promise<void>;
+    abort(): void;
+    close(): Promise<void>;
+    getRecoveryData(): SessionRecoveryData;
+    resume(data: SessionRecoveryData): void;
+    private runPromptLikeOperation;
+    private runCompactOperation;
+    private handleRawEvent;
+    private emitRawEvent;
+    private cleanupToolCall;
+    private approveToolCall;
+    private denyToolCall;
+    private initialize;
+    private createUnderlyingSession;
+    private wrapTools;
+    private executeGuardedTool;
+    private waitForPermissionResolution;
+}
+export {};