c0de-agent 1.2.0 → 1.4.0

package/dist/llm/registry.js

@@ -15,6 +15,44 @@ const registerProvider = (registry, input) => {
         models: input.models ?? {},
     });
 };
+/**
+ * Default capabilities for models not explicitly declared in the route's models map.
+ *
+ * Modern models overwhelmingly support ≥128k context windows; the previous 8192
+ * default caused false-positive compaction deadlocks on any provider that
+ * didn't declare per-model capabilities. 128k is a conservative floor that
+ * matches the most common modern context window.
+ */
+const DEFAULT_MODEL_CAPABILITIES = {
+    contextWindow: 128_000,
+    maxOutput: 8192,
+    supportsTools: true,
+    supportsVision: false,
+    supportsThinking: false,
+    costPer1kInput: 0,
+    costPer1kOutput: 0,
+};
+/**
+ * Merge sparse per-model overrides from config (ModelOverride) into full
+ * ModelCapabilities by filling gaps with DEFAULT_MODEL_CAPABILITIES.
+ * Strips `enabled` (a UI-only concern) — the registry tracks all models
+ * regardless of selector visibility.
+ */
+function overrideToCapabilities(overrides) {
+    const result = {};
+    for (const [name, o] of Object.entries(overrides)) {
+        result[name] = {
+            contextWindow: o.contextWindow ?? DEFAULT_MODEL_CAPABILITIES.contextWindow,
+            maxOutput: o.maxOutput ?? DEFAULT_MODEL_CAPABILITIES.maxOutput,
+            supportsTools: o.supportsTools ?? DEFAULT_MODEL_CAPABILITIES.supportsTools,
+            supportsVision: o.supportsVision ?? DEFAULT_MODEL_CAPABILITIES.supportsVision,
+            supportsThinking: o.supportsThinking ?? DEFAULT_MODEL_CAPABILITIES.supportsThinking,
+            costPer1kInput: o.costPer1kInput ?? DEFAULT_MODEL_CAPABILITIES.costPer1kInput,
+            costPer1kOutput: o.costPer1kOutput ?? DEFAULT_MODEL_CAPABILITIES.costPer1kOutput,
+        };
+    }
+    return result;
+}
 /**
  * Resolve a (provider, modelId) pair into a route + typed model.
  * Throws NoRoute when the provider is unknown.
@@ -29,16 +67,7 @@ const resolveRoute = (registry, provider, modelId) => {
             model: modelId,
         });
     }
-    const capabilities = route.models[modelId] ??
-        {
-            contextWindow: 8192,
-            maxOutput: 4096,
-            supportsTools: true,
-            supportsVision: false,
-            supportsThinking: false,
-            costPer1kInput: 0,
-            costPer1kOutput: 0,
-        };
+    const capabilities = route.models[modelId] ?? DEFAULT_MODEL_CAPABILITIES;
     return {
         route,
         model: makeModel(modelId, provider, {
@@ -104,4 +133,4 @@ const builtinCapabilities = {
         },
     },
 };
-export { builtinCapabilities, createRegistry, registerProvider, resolveModelByRole, resolveRoute, setRole, };
+export { builtinCapabilities, createRegistry, DEFAULT_MODEL_CAPABILITIES, overrideToCapabilities, registerProvider, resolveModelByRole, resolveRoute, setRole, };

package/dist/server/app.js

@@ -21,6 +21,7 @@ import { createSessionRoute } from './routes/session.js';
 import { createTerminalRoute } from './routes/terminal.js';
 import { createToolRoute } from './routes/tool.js';
 import { createUpdateRoute } from './routes/update.js';
+import { createWorkflowsRoute } from './routes/workflows.js';
 /** 创建完整的 Hono 应用，挂载所有路由 + 中间件。 */
 function createApp(ctx) {
     const app = new Hono();
@@ -46,6 +47,7 @@ function createApp(ctx) {
     app.route('/api/permissions', createPermissionsRoute(ctx));
     app.route('/api/files', createFilesRoute(ctx));
     app.route('/api/terminal', createTerminalRoute(ctx));
+    app.route('/api/workflows', createWorkflowsRoute(ctx));
     // 根路径
     app.get('/', (c) => c.json({
         name: 'c0de-agent',
@@ -66,6 +68,7 @@ function createApp(ctx) {
             '/api/permissions',
             '/api/files',
             '/api/terminal',
+            '/api/workflows',
         ],
     }));
     // 静态文件服务（生产环境 dist-web/ 存在时启用）

package/dist/server/context.js

@@ -1,6 +1,7 @@
 // src/server/context.ts
 import { BUILTIN_AGENTS, createAgentRegistry } from '../core/agents/index.js';
 import { DEFAULT_CONFIG, mergeConfig } from '../core/config.js';
+import { BUILTIN_WORKFLOWS, createWorkflowRegistry } from '../core/workflows/index.js';
 import { createHookRunner, createPluginRegistry } from '../plugins/index.js';
 import { createDefaultRegistry, createDefaultURLRegistry } from '../tools/index.js';
 import { createUpdateScheduler } from '../update/index.js';
@@ -21,6 +22,7 @@ function createServerContext(opts) {
                 reg.register(def);
             return reg;
         })();
+    let _workflowRegistry;
     return {
         db: opts.db,
         config,
@@ -33,6 +35,15 @@ function createServerContext(opts) {
         permissionStore: createPermissionStore(),
         permissionMode: config.permission.defaultMode,
         agentRegistry,
+        // 工作流注册表：惰性初始化，只含内置（项目级 discovery 由 bootstrap 或 API 触发热加载）。
+        get workflowRegistry() {
+            if (!_workflowRegistry) {
+                _workflowRegistry = createWorkflowRegistry();
+                for (const wf of BUILTIN_WORKFLOWS)
+                    _workflowRegistry.register(wf);
+            }
+            return _workflowRegistry;
+        },
         // 测试上下文：默认 scheduler 不启动（enabled=false 由调用方控制）。
         updateScheduler: createUpdateScheduler({
             checkFn: async () => ({

package/dist/server/routes/chat.js

@@ -5,7 +5,7 @@ import { createAgent, runAgent } from '../../core/agent.js';
 import { compactContext } from '../../core/loop.js';
 import { createSlashRegistry, parseSlashInput } from '../../core/slash.js';
 import { injectSteering } from '../../core/steering.js';
-import { containsWorkflow, WORKFLOW_NOTICE } from '../../core/workflow.js';
+import { buildWorkflowNotice, containsWorkflow } from '../../core/workflow.js';
 import { getProject } from '../../project/project.js';
 import { getLLMSegments, getSession, updateSessionLastRun } from '../../session/session.js';
 import { upsertFileSnapshot } from '../../session/snapshot.js';
@@ -53,7 +53,10 @@ function createChatRoute(ctx) {
                     cwd,
                     config: ctx.config,
                     // 内置斜杠命令（/clear、/fork、/config）仅需 db + config；
-                    // permission/toolRegistry/llmRegistry 不会触发，用 autoAllow 凑齐类型。
+                    // 但 /workflow run 会走 executeWorkflow → buildWorkflowContext → runSubAgent，
+                    // 该路径需要 agentRegistry 来派生子 agent，因此必须注入。
+                    // permission/toolRegistry 用 autoAllow 凑齐类型（子命令不触发交互权限）。
+                    workflowRegistry: ctx.workflowRegistry,
                     deps: {
                         db: ctx.db,
                         config: ctx.config,
@@ -61,6 +64,7 @@ function createChatRoute(ctx) {
                         permission: autoAllowChecker,
                         toolRegistry: ctx.toolRegistry,
                         llmRegistry: ctx.llmRegistry,
+                        agentRegistry: ctx.agentRegistry,
                     },
                 };
                 return streamSSE(c, async (stream) => {
@@ -258,7 +262,13 @@ function createChatRoute(ctx) {
             // workflowz 关键词检测：用户消息包含独立关键词时注入工作流通知（steering），
             // 引导模型用 task 工具批量 fan-out 做确定性多子 agent 分解。
             if (containsWorkflow(message)) {
-                injectSteering(state, WORKFLOW_NOTICE);
+                const wfList = ctx.workflowRegistry
+                    ? ctx.workflowRegistry.list().map((w) => ({
+                        name: w.meta.name,
+                        description: w.meta.description,
+                    }))
+                    : [];
+                injectSteering(state, buildWorkflowNotice(wfList));
             }
             // 客户端断开时中止 agent
             stream.onAbort(() => {

package/dist/server/routes/session.js

@@ -4,7 +4,7 @@ import { fromDirectory } from '../../project/index.js';
 import { archiveOriginalEntries } from '../../session/archive.js';
 import { forkSession, getBranches, getTree } from '../../session/branch.js';
 import { deleteEntriesByIds, getMessages, insertEntry } from '../../session/message.js';
-import { createSession, deleteSession, getLLMSegments, getSession, listSessions, listSessionsByProject, } from '../../session/session.js';
+import { createSession, deleteSession, getLLMSegments, getSession, listSessions, listSessionsByProject, touchLastOpened, } from '../../session/session.js';
 import { applyShakeRegions, collectShakeRegions, DEFAULT_SHAKE_CONFIG, toRegionViews, } from '../../session/shake.js';
 import { estimateMessageTokens } from '../../session/token.js';
 import { generateId } from '../../shared/index.js';
@@ -194,6 +194,11 @@ function createSessionRoute(ctx) {
         }
         return c.json({ shaken: selected.length, archiveId });
     });
+    // 记录会话打开（更新 metadata.lastOpenedAt，用于会话列表按最近打开排序）
+    app.post('/:id/open', async (c) => {
+        await touchLastOpened(ctx.db, c.req.param('id'));
+        return c.json({ ok: true });
+    });
     // 获取分支
     app.get('/:id/branches', async (c) => {
         const branches = await getBranches(ctx.db, c.req.param('id'));

package/dist/server/routes/workflows.d.ts

@@ -0,0 +1,5 @@
+import { Hono } from 'hono';
+import type { ServerContext } from '../types.js';
+/** 创建工作流 REST API 路由。 */
+declare function createWorkflowsRoute(ctx: ServerContext): Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">;
+export { createWorkflowsRoute };

package/dist/server/routes/workflows.js

@@ -0,0 +1,149 @@
+import { unlink } from 'node:fs/promises';
+import { Hono } from 'hono';
+import { streamSSE } from 'hono/streaming';
+import { createAgent } from '../../core/agent.js';
+import { executeWorkflow } from '../../core/workflows/runtime.js';
+import { createSession } from '../../session/session.js';
+import { autoAllowChecker } from '../../tools/permission.js';
+import { apiError } from '../middleware/error.js';
+/** 创建工作流 REST API 路由。 */
+function createWorkflowsRoute(ctx) {
+    const app = new Hono();
+    // GET / — 列出所有工作流
+    app.get('/', (c) => {
+        const registry = ctx.workflowRegistry;
+        if (!registry) {
+            return c.json({ workflows: [] });
+        }
+        const workflows = registry.list().map((entry) => ({
+            name: entry.meta.name,
+            description: entry.meta.description,
+            argsHint: entry.meta.argsHint,
+            phases: entry.meta.phases,
+            source: entry.source,
+        }));
+        return c.json({ workflows });
+    });
+    // GET /:name — 元数据 + 源码
+    app.get('/:name', (c) => {
+        const name = c.req.param('name');
+        const registry = ctx.workflowRegistry;
+        if (!registry) {
+            return apiError(c, 500, 'NOT_INITIALIZED', 'Workflow registry not initialized');
+        }
+        const entry = registry.get(name);
+        if (!entry) {
+            return apiError(c, 404, 'NOT_FOUND', `Workflow "${name}" not found`);
+        }
+        return c.json({
+            name: entry.meta.name,
+            description: entry.meta.description,
+            argsHint: entry.meta.argsHint,
+            phases: entry.meta.phases,
+            source: entry.source,
+            sourceCode: entry.sourceCode,
+        });
+    });
+    // POST /:name/run — 执行工作流（SSE 推送进度）
+    app.post('/:name/run', async (c) => {
+        const name = c.req.param('name');
+        const registry = ctx.workflowRegistry;
+        if (!registry) {
+            return apiError(c, 500, 'NOT_INITIALIZED', 'Workflow registry not initialized');
+        }
+        const entry = registry.get(name);
+        if (!entry) {
+            return apiError(c, 404, 'NOT_FOUND', `Workflow "${name}" not found`);
+        }
+        const body = await c.req.json().catch(() => ({}));
+        const args = body.args ?? '';
+        const agentConfig = {
+            provider: ctx.config.defaultProvider,
+            model: ctx.config.defaultModel,
+            tools: [],
+            plugins: ctx.config.plugins.enabled,
+            agentName: 'default',
+        };
+        const session = await createSession(ctx.db, `workflow:${name}`, undefined, 'workflow');
+        const parent = await createAgent(session, agentConfig, {
+            db: ctx.db,
+            llmRegistry: ctx.llmRegistry,
+            toolRegistry: ctx.toolRegistry,
+            permission: autoAllowChecker,
+            config: ctx.config,
+            cwd: ctx.cwd,
+            agentRegistry: ctx.agentRegistry,
+        });
+        return streamSSE(c, async (stream) => {
+            const deps = {
+                db: ctx.db,
+                llmRegistry: ctx.llmRegistry,
+                toolRegistry: ctx.toolRegistry,
+                permission: autoAllowChecker,
+                config: ctx.config,
+                cwd: ctx.cwd,
+                agentRegistry: ctx.agentRegistry,
+            };
+            try {
+                const result = await executeWorkflow({
+                    registry,
+                    name,
+                    args,
+                    deps,
+                    parent,
+                    onProgress: async (message, detail) => {
+                        await stream.writeSSE({
+                            event: 'progress',
+                            data: JSON.stringify({ message, detail }),
+                        });
+                    },
+                });
+                await stream.writeSSE({
+                    event: 'result',
+                    data: JSON.stringify(result),
+                });
+            }
+            catch (e) {
+                await stream.writeSSE({
+                    event: 'error',
+                    data: JSON.stringify({
+                        _tag: 'error',
+                        message: e instanceof Error ? e.message : String(e),
+                    }),
+                });
+            }
+        });
+    });
+    // DELETE /:name — 删除（仅非 builtin）
+    app.delete('/:name', async (c) => {
+        const name = c.req.param('name');
+        // 名称格式校验（涉及文件系统操作前阻断路径穿越）
+        if (!/^[a-z0-9-]+$/.test(name)) {
+            return apiError(c, 400, 'BAD_REQUEST', `Invalid workflow name "${name}"`);
+        }
+        const registry = ctx.workflowRegistry;
+        if (!registry) {
+            return apiError(c, 500, 'NOT_INITIALIZED', 'Workflow registry not initialized');
+        }
+        const entry = registry.get(name);
+        if (!entry) {
+            return apiError(c, 404, 'NOT_FOUND', `Workflow "${name}" not found`);
+        }
+        if (entry.source === 'builtin') {
+            return apiError(c, 400, 'BAD_REQUEST', 'Cannot delete builtin workflow');
+        }
+        // 先从磁盘删除文件（若存在），失败则告知用户且不清理 registry 以保持状态一致
+        if (entry.filePath) {
+            try {
+                await unlink(entry.filePath);
+            }
+            catch {
+                return apiError(c, 500, 'DELETE_FAILED', `Failed to delete workflow file for "${name}"`);
+            }
+        }
+        registry.delete(name);
+        return c.json({ ok: true });
+    });
+    return app;
+}
+export { createWorkflowsRoute };

package/dist/server/server.js

@@ -7,15 +7,16 @@ import { WebSocketServer } from 'ws';
 import { BUILTIN_AGENTS, createAgentRegistry } from '../core/agents/index.js';
 import { loadConfig } from '../core/config.js';
 import { decryptSecret } from '../core/secret.js';
+import { BUILTIN_WORKFLOWS, createWorkflowRegistry } from '../core/workflows/index.js';
 import { createDB, migrateDB } from '../db/index.js';
-import { createRegistry, registerProvider } from '../llm/registry.js';
+import { createRegistry, overrideToCapabilities, registerProvider, } from '../llm/registry.js';
 import { initPlugins } from '../plugins/index.js';
 import { createDefaultRegistry, createDefaultURLRegistry } from '../tools/index.js';
 import { checkForUpdate, createHandoffServer, createUpdateScheduler, requestHandoff, restoreSessions, } from '../update/index.js';
 import { createAgentManager } from './agent-manager.js';
-import { PTYManager } from './terminal/pty-manager.js';
 import { createApp } from './app.js';
 import { createPermissionStore } from './permission/store.js';
+import { PTYManager } from './terminal/pty-manager.js';
 /** 把 config.providers 注册到新建的 LLM registry（修复此前空 registry 的遗漏）。 */
 function buildRegistryFromConfig(config) {
     const registry = createRegistry();
@@ -36,6 +37,9 @@ function registerProviderFromConfig(registry, p) {
         baseURL: p.baseURL,
         apiKey: p.apiKey ? decryptSecret(p.apiKey) : p.apiKey,
         ...(path ? { path } : {}),
+        // 传递用户配置的 per-model capabilities（contextWindow 等），
+        // 否则 resolveRoute 回退到 DEFAULT_MODEL_CAPABILITIES，可能导致预算过小。
+        ...(p.models ? { models: overrideToCapabilities(p.models) } : {}),
     });
 }
 /**
@@ -79,6 +83,8 @@ async function buildServerContext(db, opts = {}) {
         toolRegistry,
         llmRegistry,
     });
+    // workflowRegistry 惰性初始化 backing field（见下方 ctx getter）。
+    let _workflowRegistry;
     const ctx = {
         db,
         config,
@@ -97,6 +103,16 @@ async function buildServerContext(db, opts = {}) {
                 reg.register(def);
             return reg;
         })(),
+        // 工作流注册表：惰性初始化，只含内置（项目级 discovery 由 bootstrap 或 API 触发热加载）。
+        // 与 context.ts 的 createServerContext 保持一致的模式。
+        get workflowRegistry() {
+            if (!_workflowRegistry) {
+                _workflowRegistry = createWorkflowRegistry();
+                for (const wf of BUILTIN_WORKFLOWS)
+                    _workflowRegistry.register(wf);
+            }
+            return _workflowRegistry;
+        },
         // spec §18.1 后台版本检查调度器；config.update.enabled 控制是否启动。
         updateScheduler: createUpdateScheduler({
             checkFn: opts.checkForUpdateFn ?? checkForUpdate,

package/dist/server/types.d.ts

@@ -30,6 +30,8 @@ type ServerContext = {
     permissionMode: 'default' | 'auto';
     /** Agent 类型注册表（spec: multi-agent-design）。注入 agent loop 的 runSubAgent。 */
     agentRegistry: AgentRegistry;
+    /** 工作流注册表（spec: dynamic-workflow-design）。注入 /workflow slash 命令和 workflowz steering。 */
+    workflowRegistry?: import('../core/workflows/registry.js').WorkflowRegistry;
     /** 后台版本检查调度器（spec §18.1）；/api/update 读取其缓存结果。 */
     updateScheduler: UpdateScheduler;
     /** Handoff HTTP 端点（spec §18.3）；热更新时新实例 POST /handoff 触发优雅退出。 undefined 表示未启用。 */

package/dist/session/branch.d.ts

@@ -4,6 +4,8 @@ import type { Session, SessionTreeNode } from './types.js';
 declare function forkSession(handle: DB, sessionId: string, messageIndex: number): Promise<Session>;
 /** Get direct child sessions (branches) of a session. */
 declare function getBranches(handle: DB, sessionId: string): Promise<Session[]>;
-/** Build a full session tree from root sessions down. */
+/** Build a full session tree from root sessions down.
+ * 每层按 metadata.lastOpenedAt 降序（fallback updatedAt、createdAt）。
+ */
 declare function getTree(handle: DB): Promise<SessionTreeNode[]>;
 export { forkSession, getBranches, getTree };

package/dist/session/branch.js

@@ -44,7 +44,9 @@ async function getBranches(handle, sessionId) {
     const rows = await handle.db.select().from(sessions).where(eq(sessions.parentId, sessionId));
     return rows.map(rowToSession);
 }
-/** Build a full session tree from root sessions down. */
+/** Build a full session tree from root sessions down.
+ * 每层按 metadata.lastOpenedAt 降序（fallback updatedAt、createdAt）。
+ */
 async function getTree(handle) {
     const rows = await handle.db.select().from(sessions);
     const byParent = new Map();
@@ -54,7 +56,12 @@ async function getTree(handle) {
         list.push(session);
         byParent.set(session.parentId, list);
     }
-    const build = (parentId) => (byParent.get(parentId) ?? []).map((session) => ({
+    // 排序键：lastOpenedAt > updatedAt > createdAt（均为 epoch ms）
+    const sortKey = (s) => s.metadata.lastOpenedAt ?? s.updatedAt ?? s.createdAt ?? 0;
+    const build = (parentId) => (byParent.get(parentId) ?? [])
+        .slice()
+        .sort((a, b) => sortKey(b) - sortKey(a))
+        .map((session) => ({
         session,
         children: build(session.id),
     }));

package/dist/session/session.d.ts

@@ -17,6 +17,8 @@ declare function deleteSession(handle: DB, id: string): Promise<void>;
 declare function updateSessionTitle(handle: DB, id: string, title: string): Promise<void>;
 /** Bump updatedAt to now (used after appending messages). */
 declare function touchSession(handle: DB, id: string): Promise<void>;
+/** 记录会话上次打开时间（用于会话列表按最近打开排序）。 */
+declare function touchLastOpened(handle: DB, id: string): Promise<void>;
 /** 规格化工具集并计算前缀指纹。tools 顺序不影响指纹（按 name 排序）。 */
 export declare function segmentFingerprint(systemPrompt: string, tools: ChatTool[]): string;
 /**
@@ -34,4 +36,4 @@ export declare function saveLLMSegments(handle: DB, id: string, segments: LLMSeg
 /** 更新会话 metadata.lastRun（agent run 开始/结束时写入；重启后检测中断用）。 */
 declare function updateSessionLastRun(handle: DB, id: string, lastRun: LastRun): Promise<void>;
 declare function listSessionsByProject(handle: DB, projectId: string): Promise<Session[]>;
-export { createSession, deleteSession, getSession, listSessions, listSessionsByProject, touchSession, updateSessionLastRun, updateSessionTitle, };
+export { createSession, deleteSession, getSession, listSessions, listSessionsByProject, touchLastOpened, touchSession, updateSessionLastRun, updateSessionTitle, };

package/dist/session/session.js

@@ -50,6 +50,17 @@ async function updateSessionTitle(handle, id, title) {
 async function touchSession(handle, id) {
     await handle.db.update(sessions).set({ updatedAt: new Date() }).where(eq(sessions.id, id));
 }
+/** 记录会话上次打开时间（用于会话列表按最近打开排序）。 */
+async function touchLastOpened(handle, id) {
+    const [row] = await handle.db.select().from(sessions).where(eq(sessions.id, id));
+    if (!row)
+        return;
+    const meta = (row.metadata ?? {});
+    await handle.db
+        .update(sessions)
+        .set({ metadata: { ...meta, lastOpenedAt: Date.now() } })
+        .where(eq(sessions.id, id));
+}
 /** 规格化工具集并计算前缀指纹。tools 顺序不影响指纹（按 name 排序）。 */
 export function segmentFingerprint(systemPrompt, tools) {
     const norm = JSON.stringify({
@@ -141,4 +152,4 @@ async function listSessionsByProject(handle, projectId) {
     const rows = await handle.db.select().from(sessions).where(eq(sessions.projectId, projectId));
     return rows.map(rowToSession);
 }
-export { createSession, deleteSession, getSession, listSessions, listSessionsByProject, touchSession, updateSessionLastRun, updateSessionTitle, };
+export { createSession, deleteSession, getSession, listSessions, listSessionsByProject, touchLastOpened, touchSession, updateSessionLastRun, updateSessionTitle, };

package/dist/shared/types/message.d.ts

@@ -52,6 +52,8 @@ type SessionMetadata = {
     segments?: LLMSegment[];
     /** 上次 agent run 状态；status='running' 且进程无活跃 run → 被中断。 */
     lastRun?: LastRun;
+    /** 上次打开时间戳（ms），用于会话列表按最近打开排序。 */
+    lastOpenedAt?: number;
 };
 /** A conversation session (may have a parent for branching). */
 type Session = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "c0de-agent",
-  "version": "1.2.0",
+  "version": "1.4.0",
   "description": "Open-source AI coding assistant with Browser-Server architecture",
   "type": "module",
   "bin": {