Dev

.dockerignore

@@ -0,0 +1,15 @@
+.git
+.github
+.gitignore
+.agent-sessions
+.env
+.env.local
+.env.*
+node_modules
+**/node_modules
+packages/*/dist
+*.tsbuildinfo
+bundle.*
+docs
+tests
+.DS_Store

.gitignore

@@ -26,3 +26,9 @@ bundle.*
 docs/*
 !docs/index.html
 .DS_Store                     # macOS
+.agent-sessions/*
+packages/client/dist/*
+packages/server/dist/*
+packages/agent-core/dist/*
+sessions.db
+packages/session-sqlite/dist/*

Dockerfile

@@ -0,0 +1,30 @@
+# 使用 Node 24 提供 node:sqlite 和 npm，Bun 负责按 bun.lock 安装依赖
+FROM node:24-bookworm-slim
+
+# coding agent 会在挂载的工作区执行命令，补齐常用工具
+RUN apt-get update \
+  && apt-get install -y --no-install-recommends bash git ripgrep ca-certificates \
+  && rm -rf /var/lib/apt/lists/*
+
+# 与 packageManager 保持一致，避免 bun.lock 被其他版本改写
+RUN npm install -g bun@1.3.11
+
+WORKDIR /app
+
+# 先复制清单文件，依赖层可以复用 Docker 缓存
+COPY package.json bun.lock bunfig.toml tsconfig.json ./
+COPY packages/agent-core/package.json packages/agent-core/
+COPY packages/client/package.json packages/client/
+COPY packages/session-sqlite/package.json packages/session-sqlite/
+
+RUN bun install --frozen-lockfile
+
+COPY source source
+COPY packages/agent-core packages/agent-core
+COPY packages/session-sqlite packages/session-sqlite
+
+# 默认把挂载的用户目录作为工作区，会话和工具执行都落在里面
+WORKDIR /workspace
+
+# 入口用 tsx 加载 TypeScript，tsconfig 固定指向 /app，避免受工作区影响
+CMD ["node", "/app/node_modules/tsx/dist/cli.mjs", "--tsconfig", "/app/tsconfig.json", "/app/source/app.tsx"]

README.md

@@ -20,7 +20,7 @@ call-code 是一个本地运行的终端编程 Agent（CLI coding agent），基
 - 本地记忆：短期记忆按任务保存，长期记忆按主题沉淀，仅在进程内使用，不写入本地 JSON。
 - 上下文预算：运行时基于 token 估算对历史消息做裁剪，减少超出模型上下文的风险。
 - 会话持久化：基于 Node 内置 `node:sqlite` 保存会话、条目、泳道、分支、记录、统计、事实和租约，默认写入 `.agent-sessions/sessions.db`。
-- 会话客户端：`packages/client` 提供 React + Vite 会话界面，静态展示已停止，后续用于实时对话展示。
+- 会话客户端：`packages/client` 提供 React + Vite 会话界面，通过 WebSocket 实时展示会话数据。
 
 ## 架构
 
@@ -63,6 +63,7 @@ OpenAI-compatible LLM                  模型层
 ```text
 source/
   app.tsx                    # Ink CLI 入口与交互界面
+  web-server.ts              # Web 会话面板服务入口
 packages/
   agent-core/                # 核心 agent、上下文、记忆、工具与协议实现
     src/
@@ -80,8 +81,8 @@ packages/
         utils/               # shell 与文本截断等工具
       types/                 # 领域类型
       utils/                 # JSON、日志工具
-      web/                   # 会话数据导出
-  client/                    # TypeScript + React 会话界面客户端
+      web/                   # 会话导出与 WebSocket 服务
+  client/                    # TypeScript + React 会话界面客户端（WebSocket 数据）
   session-sqlite/            # 基于 node:sqlite 的会话历史与运行状态存储
 tests/                        # 项目统一单元测试
  vitest.config.ts             # Vitest 测试配置
@@ -121,6 +122,7 @@ bun dev
 | `AGENT_DESKTOP_DIR`   | 可选，覆盖桌面目录路径，便于测试或自定义工作环境。                           |
 | `SESSION_DB_PATH`     | 可选，SQLite 会话库文件路径，默认 `.agent-sessions/sessions.db`。            |
 | `CALL_CODE_WEB_DATA`  | 可选，CLI 内 `/export` 的输出路径，默认 `packages/client/public/data.json`。 |
+| `CALL_CODE_WEB_PORT`  | 可选，Web 会话面板监听端口，默认 4173。                                      |
 
 ## CLI 命令与快捷键
 
@@ -169,8 +171,40 @@ bun run export:web
 
 # 构建会话客户端（本地预览用）
 bun run build:client
+
+# 启动 Web 会话面板（静态托管客户端 + WebSocket 数据服务）
+bun run web:serve
+```
+
+## Web 会话面板
+
+Web 会话面板由 `source/web-server.ts` 启动：它读取 `SESSION_DB_PATH` 指向的会话库，静态托管 `packages/client/dist`，并在 `/ws` 提供 `sessions.list` / `sessions.snapshot` 消息。客户端默认连接同源 `/ws`，并周期性刷新会话快照；也可以用 `?ws=<url>` 覆盖服务地址，用 `?session=<id>` 直达某个会话。
+
+```bash
+bun run build:client
+bun run web:serve
+```
+
+然后打开 `http://127.0.0.1:4173`。开发模式下先启动 `web:serve`，再运行 `bun run dev:client`，Vite 会把 `/ws` 代理到会话服务。
+
+## Docker 镜像
+
+构建镜像：
+
+```bash
+docker build -t call-code .
 ```
 
+以当前目录作为工作区运行，容器内工作目录固定为 `/workspace`，会话库会写入 `/workspace/.agent-sessions`：
+
+```bash
+docker run --rm -it \
+  -v "$PWD":/workspace \
+  call-code
+```
+
+API 配置优先从挂载目录下的 `.env.local` 读取，也可以用 `-e OPENAI_API_KEY=... -e OPENAI_MODEL=...` 传入。
+
 ## 测试说明
 
 测试文件统一放在项目根目录的 `tests/` 目录下，根目录的 `vitest.config.ts` 会统一收集并运行。

package.json

@@ -14,10 +14,13 @@
     "typecheck:client": "tsc -p packages/client/tsconfig.json --noEmit",
     "test": "vitest run --reporter verbose",
     "build:agent-core": "tsc -p packages/agent-core/tsconfig.json",
+    "build:session-sqlite": "tsc -p packages/session-sqlite/tsconfig.json",
+    "build:server": "bun run build:session-sqlite && bun run build:agent-core && bun run --cwd packages/server build",
     "export:web": "tsx tests/export-web.ts",
     "dev:client": "bun run --cwd packages/client dev",
     "build:client": "bun run --cwd packages/client build",
-    "preview:client": "bun run --cwd packages/client preview"
+    "preview:client": "bun run --cwd packages/client preview",
+    "web:serve": "tsx source/web-server.ts"
   },
   "dependencies": {
     "dotenv": "^17.4.2",

packages/agent-core/package.json

@@ -13,9 +13,11 @@
     "dotenv": "^17.4.2",
     "openai": "^6.34.0",
     "tesseract.js": "^7.0.0",
-    "tiktoken": "^1.0.20"
+    "tiktoken": "^1.0.20",
+    "ws": "^8.21.3"
   },
   "devDependencies": {
+    "@types/ws": "^8.18.1",
     "typescript": "^6.0.3"
   }
 }

packages/agent-core/src/harness/compaction/branch-summarization.ts

@@ -1,6 +1,6 @@
-import type { ContextMessage } from '../context/context-types';
-import type { EntryLike, SessionStoreLike } from '../session/store-types';
-import type { SummarizeFn } from './compaction';
+import type { ContextMessage } from '../context/context-types.js';
+import type { EntryLike, SessionStoreLike } from '../session/store-types.js';
+import type { SummarizeFn } from './compaction.js';
 import {
   computeFileLists,
   createFileOps,
@@ -9,7 +9,7 @@ import {
   formatFileOperations,
   serializeConversation,
   type FileOperations,
-} from './utils';
+} from './utils.js';
 
 export interface BranchSummaryEntryPayload {
   kind: 'branch_summary';

packages/agent-core/src/harness/compaction/compaction.ts

@@ -1,5 +1,5 @@
-import type { ContextMessage } from '../context/context-types';
-import type { EntryLike, SessionStoreLike } from '../session/store-types';
+import type { ContextMessage } from '../context/context-types.js';
+import type { EntryLike, SessionStoreLike } from '../session/store-types.js';
 import {
   computeFileLists,
   createFileOps,
@@ -9,7 +9,7 @@ import {
   formatFileOperations,
   serializeConversation,
   type FileOperations,
-} from './utils';
+} from './utils.js';
 
 export interface CompactionSettings {
   enabled: boolean;

packages/agent-core/src/harness/compaction/index.ts

@@ -1,3 +1,3 @@
-export * from './branch-summarization';
-export * from './compaction';
-export * from './utils';
+export * from './branch-summarization.js';
+export * from './compaction.js';
+export * from './utils.js';

packages/agent-core/src/harness/compaction/utils.ts

@@ -1,5 +1,5 @@
-import type { ContextMessage } from '../context/context-types';
-import type { EntryLike } from '../session/store-types';
+import type { ContextMessage } from '../context/context-types.js';
+import type { EntryLike } from '../session/store-types.js';
 
 /** 摘要阶段累积的文件读写信息，后续追加到摘要里让模型保留文件上下文。 */
 export interface FileOperations {

packages/agent-core/src/harness/context/builder.ts

@@ -1,7 +1,7 @@
-export { ContextBuilder } from './context-builder';
+export { ContextBuilder } from './context-builder.js';
 export type {
   ContextMessage,
   MessageRole,
   RuntimeContext,
-} from './context-types';
-export { buildRuntimeContext } from './runtime-context';
+} from './context-types.js';
+export { buildRuntimeContext } from './runtime-context.js';

packages/agent-core/src/harness/context/context-builder.ts

@@ -1,5 +1,5 @@
 import { get_encoding, type Tiktoken } from 'tiktoken';
-import type { ContextMessage } from './context-types';
+import type { ContextMessage } from './context-types.js';
 
 export class ContextBuilder {
   private readonly encoder: Tiktoken;

packages/agent-core/src/harness/context/context-summarizer.ts

@@ -1,4 +1,4 @@
-import type { ContextMessage } from './context-types';
+import type { ContextMessage } from './context-types.js';
 
 export interface HistorySummary {
   summary: string;

packages/agent-core/src/harness/context/runtime-context.ts

@@ -1,11 +1,11 @@
-import type { TaskState } from '@agent-core/harness/core/state';
-import { createTaskContext } from './task-context';
-import { summarizeHistory } from './context-summarizer';
-import { ContextBuilder } from './context-builder';
+import type { TaskState } from '../core/state.js';
+import { createTaskContext } from './task-context.js';
+import { summarizeHistory } from './context-summarizer.js';
+import { ContextBuilder } from './context-builder.js';
 import type {
   ContextMessage,
   RuntimeContext,
-} from './context-types';
+} from './context-types.js';
 
 export interface BuildRuntimeContextInput {
   system: string;

packages/agent-core/src/harness/context/task-context.ts

@@ -1,4 +1,4 @@
-import type { TaskState } from '@agent-core/harness/core/state';
+import type { TaskState } from '../core/state.js';
 
 export interface TaskContext {
   id: string;

packages/agent-core/src/harness/core/agent.ts

@@ -1,6 +1,6 @@
-import { runLoop } from '@agent-core/harness/runtime/run-loop';
-import type { StreamHandlers } from '@agent-core/harness/core/llm';
-import { createTaskState, type AgentMode } from '@agent-core/harness/core/state';
+import { runLoop } from '../runtime/run-loop.js';
+import type { StreamHandlers } from './llm.js';
+import { createTaskState, type AgentMode } from './state.js';
 
 export interface AgentOptions {
   mode?: AgentMode;

packages/agent-core/src/harness/memory/memory-retriever.ts

@@ -1,4 +1,4 @@
-import { memoryStore } from './memory-store';
+import { memoryStore } from './memory-store.js';
 
 export interface RetrievedMemory {
   longFacts: string[];

packages/agent-core/src/harness/memory/memory-store.ts

@@ -2,7 +2,7 @@ import { randomUUID } from 'node:crypto';
 import type {
   LongMemoryItem,
   MemorySnapshot,
-} from './memory-schema';
+} from './memory-schema.js';
 
 export class MemoryStore {
   private readonly longMemory: LongMemoryItem[] = [];

packages/agent-core/src/harness/memory/memory-writer.ts

@@ -1,6 +1,6 @@
-import type { TaskState } from '@core/state';
-import type { ContextMessage } from '../context/context-types';
-import { memoryStore } from './memory-store';
+import type { TaskState } from '../core/state.js';
+import type { ContextMessage } from '../context/context-types.js';
+import { memoryStore } from './memory-store.js';
 
 const countStableMentions = (messages: ContextMessage[], text: string): number =>
   messages.reduce((count, item) => {

packages/agent-core/src/harness/prompt/modes.ts

@@ -1,4 +1,4 @@
-import type { AgentMode } from '@agent-core/harness/core/state';
+import type { AgentMode } from '../core/state.js';
 
 const modeSystemPrompts: Record<AgentMode, string> = {
   plan: `

packages/agent-core/src/harness/protocol/index.ts

@@ -1,5 +1,5 @@
-export type { ToolCallAction, FinalAction, AgentAction } from '@agent-core/harness/protocol/action';
-export { isToolCallAction, isFinalAction, isAgentAction } from '@agent-core/harness/protocol/action';
-export type { ToolResultObservation } from '@agent-core/harness/protocol/observation';
-export { createToolResultObservation } from '@agent-core/harness/protocol/observation';
-export { parseAgentResponse, shouldContinueLoop, extractFinalText } from '@agent-core/harness/protocol/parser';
+export type { ToolCallAction, FinalAction, AgentAction } from './action.js';
+export { isToolCallAction, isFinalAction, isAgentAction } from './action.js';
+export type { ToolResultObservation } from './observation.js';
+export { createToolResultObservation } from './observation.js';
+export { parseAgentResponse, shouldContinueLoop, extractFinalText } from './parser.js';

packages/agent-core/src/harness/protocol/parser.ts

@@ -1,4 +1,4 @@
-import { isAgentAction, isFinalAction, isToolCallAction, type AgentAction } from '@agent-core/harness/protocol/action';
+import { isAgentAction, isFinalAction, isToolCallAction, type AgentAction } from './action.js';
 
 export const parseAgentResponse = (response: string): AgentAction | null => {
   try {

packages/agent-core/src/harness/runtime/index.ts

@@ -1,3 +1,3 @@
-export * from './run-loop';
-export * from './session-runtime';
-export * from './tool-runtime';
+export * from './run-loop.js';
+export * from './session-runtime.js';
+export * from './tool-runtime.js';