@weiping/wingline-core 0.1.0 → 0.2.0

package/dist/index.js

@@ -9,18 +9,22 @@ export * from './orca/types.js';
 export * from './spec/hash.js';
 export * from './spec/load.js';
 export * from './spec/draft.js';
+export * from './spec/doc.js';
 export * from './spec/edit.js';
 export * from './spec/plan-change.js';
+export * from './spec/facade.js';
 export * from './commands/spec.js';
 export * from './commands/about.js';
 export * from './registry/registry.js';
 export * from './brief/render.js';
 export * from './audit.js';
+export * from './audit-table.js';
 export * from './commands/deps.js';
 export * from './commands/locate.js';
 export * from './commands/up.js';
 export * from './commands/restore/index.js';
 export * from './commands/autostart/index.js';
+export * from './commands/autostart/sys.js';
 export * from './commands/version-range.js';
 export * from './commands/ps.js';
 export * from './commands/send.js';
@@ -48,9 +52,12 @@ export * from './commands/task/escalate.js';
 export { HEARTBEAT_STALE_MS, HEARTBEAT_TAKEOVER_MS, dispatcherHealth, dispatcherLaunchCommand, dispatcherUp, dispatcherDown, } from './commands/dispatcher/lifecycle.js';
 export * from './commands/dispatcher/loop.js';
 export * from './commands/dispatcher/attention.js';
+export * from './commands/dispatcher/signal-summary.js';
 export * from './commands/dispatcher/controls.js';
 export * from './commands/dispatcher/inbox.js';
 export * from './commands/dispatcher/outlets.js';
 export * from './commands/dispatcher/signals.js';
 export * from './commands/dispatcher/advance.js';
 export * from './commands/dispatcher/orca-sync.js';
+export * from './commands/templates.js';
+export * from './commands/init.js';

package/dist/orca/client.js

@@ -29,6 +29,8 @@ function tabTitles(node, found = new Map()) {
 }
 const retryArgs = (a) => (a.retryRequest ? ['--retry-request', a.retryRequest] : []);
 const replayedOf = (r) => r.mutation?.replayed ?? false;
+/** run-list 每页 10 条；翻够这么多页还没完，就当找不全（`wl up` 会按这个提示走 --adopt-run）。 */
+const RUN_LIST_MAX_PAGES = 50;
 const toTask = (t) => ({
     id: t.id,
     status: t.status,
@@ -39,27 +41,35 @@ const toTask = (t) => ({
     dispatchId: t.dispatch_id ?? null,
     result: t.result ?? null,
 });
+// Orca 1.4.251 起 run-* 的简版回执只剩 { runId, objective }（没有 coordinator_handle），
+// --full 才给完整记录；下面这几个调用都要 --full，否则协调者句柄读不出来。
 function runMethods(runner) {
     return {
         async runCreate(a) {
-            const r = await runner.json(['orchestration', 'run-create', '--objective', a.objective, '--from', a.from, ...retryArgs(a)]);
+            const r = await runner.json(['orchestration', 'run-create', '--full', '--objective', a.objective, '--from', a.from, ...retryArgs(a)]);
             return { id: r.run.id, coordinatorHandle: r.run.coordinator_handle, replayed: replayedOf(r) };
         },
         async runUse(a) {
-            const r = await runner.json(['orchestration', 'run-use', '--id', a.id, '--from', a.from]);
+            const r = await runner.json(['orchestration', 'run-use', '--full', '--id', a.id, '--from', a.from]);
             return { coordinatorHandle: r.run.coordinator_handle };
         },
         async runShow(a) {
-            const r = await runner.json(['orchestration', 'run-show', '--id', a.id]);
+            const r = await runner.json(['orchestration', 'run-show', '--full', '--id', a.id]);
             return { coordinatorHandle: r.run.coordinator_handle };
         },
         async runList() {
-            const r = await runner.json(['orchestration', 'run-list']);
-            // 还有下一页就不能当成"找全了"：按 objective 找回 Run 会漏掉后面的候选
-            if (r.nextCursor ?? r.page?.nextCursor) {
-                throw new WinglineError('orca', 'run_list_truncated', 'run-list 结果不止一页，无法确认没有其他候选 Run', { hint: '用 wl up --adopt-run <id> 指定要找回的 Run' });
+            const runs = [];
+            let cursor;
+            for (let page = 0; page < RUN_LIST_MAX_PAGES; page++) {
+                const r = await runner.json(['orchestration', 'run-list', '--full', ...(cursor ? ['--cursor', cursor] : [])]);
+                runs.push(...r.runs.map((x) => ({ id: x.id, objective: x.objective, coordinatorHandle: x.coordinator_handle, createdAt: x.created_at })));
+                // 还有下一页就得接着翻：按 objective 找回 Run 会漏掉后面的候选
+                const next = r.nextCursor ?? r.page?.nextCursor ?? undefined;
+                if (!next || next === cursor)
+                    return runs;
+                cursor = next;
             }
-            return r.runs.map((x) => ({ id: x.id, objective: x.objective, coordinatorHandle: x.coordinator_handle, createdAt: x.created_at }));
+            throw new WinglineError('orca', 'run_list_truncated', 'run-list 分页超过上限，无法确认没有其他候选 Run', { hint: '用 wl up --adopt-run <id> 指定要找回的 Run' });
         },
         async requestShow(a) {
             const r = await runner.json(['orchestration', 'request-show', '--request', a.request]);
@@ -166,10 +176,14 @@ function inboxMethods(runner) {
             };
         },
         async reply(a) {
+            // Orca 1.4.251 起回执是 { messageId }；旧版是 { message: { id } }。两种都认。
             const r = await runner.json([
                 'orchestration', 'reply', '--id', a.id, '--body', a.body, '--run', a.run, '--from', a.from,
             ]);
-            return { messageId: r.message.id, duplicate: r.duplicate ?? false };
+            const messageId = r.message?.id ?? r.messageId;
+            if (!messageId)
+                throw new WinglineError('orca', 'reply_shape_unknown', 'Orca 的回复回执里没有 messageId');
+            return { messageId, duplicate: r.duplicate ?? false };
         },
         async workerList(a) {
             const r = await runner.json(['orchestration', 'worker-list', '--run', a.run]);
@@ -243,6 +257,10 @@ function terminalMethods(runner) {
             const r = await runner.json(['terminal', 'close', '--terminal', a.handle]);
             return { ptyKilled: r.close.ptyKilled };
         },
+        async terminalSwitch(a) {
+            const r = await runner.json(['terminal', 'switch', '--terminal', a.handle]);
+            return { navigated: r.focus.navigated };
+        },
     };
 }
 /**

package/dist/orca/types.d.ts

@@ -113,6 +113,12 @@ export interface OrcaClient {
     terminalClose(a: {
         handle: string;
     }): Promise<CloseResult>;
+    /** 把 Orca 窗口切到某个终端标签页（UI 导航，不改变终端本身）。 */
+    terminalSwitch(a: {
+        handle: string;
+    }): Promise<{
+        navigated: boolean;
+    }>;
     runCreate(a: {
         objective: string;
         from: string;

package/dist/registry/registry.d.ts

@@ -101,6 +101,8 @@ export interface PatrolStateRow {
     detail?: Record<string, unknown> | null;
 }
 export interface FrozenRow {
+    /** 冻结行自带的团队名：被冻结的可以是没登记的终端，所以别从地址里反推。 */
+    team: string;
     post: string;
     reason: string;
     signal: string | null;
@@ -170,6 +172,13 @@ export declare class Registry {
     /** 换 id 与参数；给了 expectedOld 时是比较后交换：旧 id 已被别的进程换掉则不动，返回 false。 */
     reissueIntent(id: string, retryRequest: string, args: unknown, expectedOld?: string): boolean;
     dropRequest(id: string): void;
+    /**
+     * 岗位生命周期结束（down --close / 终端已消失）时，把该岗位未完成的请求行结为 done。
+     * 不结账的话，下次 up 的 nextRequestId 会沿用在 Orca 侧早已完成的旧行（本地还是 uncertain），
+     * beginRequest 与 Orca 的完成记录互相矛盾，up 卡死在 request_already_done。
+     * 返回结账的行数。
+     */
+    finalizePostRequests(team: string, post: string): number;
     listOpenRequests(prefix: string): Array<{
         id: string;
         state: RequestState;
@@ -283,6 +292,11 @@ export declare class Registry {
         id: number;
         at: string;
     }) | null;
+    /** 该信号主体最近一次 notify 事件（不受巡查事件保留窗口影响）；task_id 为 NULL 的主体与空串比较。 */
+    lastNotifyEventOf(team: string, post: string, signal: string, taskId: string): (PatrolEvent & {
+        id: number;
+        at: string;
+    }) | null;
     appendAudit(r: Omit<AuditRow, 'id' | 'at' | 'detail'> & {
         at?: string;
         detail?: unknown;
@@ -322,6 +336,12 @@ export declare class Registry {
     /** team 是否写过 actions 之一的事件。 */
     hasPatrolEventOf(team: string, actions: readonly string[]): boolean;
     prunePatrolEvents(before: string): number;
+    /**
+     * 已结束状态的日常清理：已清除的巡查行、已回答的提问、已定案且过保留期的任务账本行。
+     * 不动：pending/uncertain 行（可能还在重放）、代数键（restore:*、<team>:<post>:*，删了会让代数从头数起）、
+     * done:*:delivered:* 交付行（解冻时按冻结时间点数被跳过的任务）。
+     */
+    pruneFinishedState(before: string): void;
     /** finished_at > after（null 表示不限）的已完成判定，按 finished_at 升序。 */
     listFinishedVerdictsAfter(post: string, after: string | null): DoneVerdictRow[];
     /** 2A done 写下的交付记录（requests 里 done:%:delivered:<target> 且 done 的行）。 */

package/dist/registry/registry.js

@@ -74,7 +74,7 @@ const patrolRow = (r) => ({
     detail: r.detail === null || r.detail === undefined ? null : JSON.parse(r.detail),
 });
 const frozenRow = (r) => ({
-    post: r.post, reason: r.reason, signal: r.signal, frozenAt: r.frozen_at,
+    team: r.team, post: r.post, reason: r.reason, signal: r.signal, frozenAt: r.frozen_at,
 });
 const questionRow = (r) => ({
     team: r.team,
@@ -264,6 +264,18 @@ export class Registry {
     dropRequest(id) {
         this.db.prepare('DELETE FROM requests WHERE id = ?').run(id);
     }
+    /**
+     * 岗位生命周期结束（down --close / 终端已消失）时，把该岗位未完成的请求行结为 done。
+     * 不结账的话，下次 up 的 nextRequestId 会沿用在 Orca 侧早已完成的旧行（本地还是 uncertain），
+     * beginRequest 与 Orca 的完成记录互相矛盾，up 卡死在 request_already_done。
+     * 返回结账的行数。
+     */
+    finalizePostRequests(team, post) {
+        const open = this.listOpenRequests(`${team}:${post}:`);
+        for (const r of open)
+            this.finishRequest(r.id, 'done', { closed: true });
+        return open.length;
+    }
     listOpenRequests(prefix) {
         const rows = this.db
             .prepare("SELECT id, state, updated_at, args FROM requests WHERE state IN ('pending','uncertain') AND substr(id, 1, ?) = ? ORDER BY id")
@@ -466,7 +478,9 @@ export class Registry {
     }
     /** unfreeze 用：该岗位所有巡查行回到 level 0 并标记已清除（spec 第 7 节）。画面信号的行不动：解冻不该清掉用量暂停，也不该在提示仍留屏时让它重新通知一次。 */
     resetPatrolForPost(post, at) {
-        this.db.prepare("UPDATE patrol_state SET level = 0, cleared_at = ?, last_nudged_at = NULL WHERE post = ? AND signal NOT IN ('context_low', 'usage_limit')").run(at, post);
+        this.db
+            .prepare("UPDATE patrol_state SET level = 0, cleared_at = ?, last_nudged_at = NULL, notify_count = 0, next_due_at = NULL WHERE post = ? AND signal NOT IN ('context_low', 'usage_limit')")
+            .run(at, post);
     }
     freezePost(a) {
         this.db
@@ -552,6 +566,13 @@ export class Registry {
         const r = this.db.prepare(`SELECT * FROM patrol_events WHERE team = ? AND action IN (${marks}) ORDER BY id DESC LIMIT 1`).get(team, ...actions);
         return r ? eventRow(r) : null;
     }
+    /** 该信号主体最近一次 notify 事件（不受巡查事件保留窗口影响）；task_id 为 NULL 的主体与空串比较。 */
+    lastNotifyEventOf(team, post, signal, taskId) {
+        const r = this.db
+            .prepare("SELECT * FROM patrol_events WHERE team = ? AND action = 'notify' AND post = ? AND signal = ? AND COALESCE(task_id, '') = ? ORDER BY id DESC LIMIT 1")
+            .get(team, post, signal, taskId);
+        return r ? eventRow(r) : null;
+    }
     // —— 阶段 3A：审计事件、团队任务日志、时间线游标 ——
     // 三者共用 pageRows 的分页语义：id 升序；不带 afterId 取最新 limit 条；带 afterId 取游标之后最早的 limit 条。
     appendAudit(r) {
@@ -627,6 +648,18 @@ export class Registry {
     prunePatrolEvents(before) {
         return Number(this.db.prepare('DELETE FROM patrol_events WHERE at < ?').run(before).changes);
     }
+    /**
+     * 已结束状态的日常清理：已清除的巡查行、已回答的提问、已定案且过保留期的任务账本行。
+     * 不动：pending/uncertain 行（可能还在重放）、代数键（restore:*、<team>:<post>:*，删了会让代数从头数起）、
+     * done:*:delivered:* 交付行（解冻时按冻结时间点数被跳过的任务）。
+     */
+    pruneFinishedState(before) {
+        this.db.prepare('DELETE FROM patrol_state WHERE cleared_at IS NOT NULL AND cleared_at < ?').run(before);
+        this.db.prepare('DELETE FROM questions WHERE answered_at IS NOT NULL AND answered_at < ?').run(before);
+        this.db.prepare(`DELETE FROM requests WHERE state = 'done' AND updated_at < ?
+       AND (id LIKE 'dispatch:%' OR id LIKE 'recover:%' OR id LIKE 'resolve:%' OR id LIKE 'oneshot:%'
+            OR (id LIKE 'done:%' AND id NOT LIKE 'done:%:delivered:%'))`).run(before);
+    }
     /** finished_at > after（null 表示不限）的已完成判定，按 finished_at 升序。 */
     listFinishedVerdictsAfter(post, after) {
         const sql = 'SELECT * FROM task_done WHERE post = ? AND finished_at IS NOT NULL AND finished_at > ? ORDER BY finished_at, task_id';

package/dist/server/api-read.js

@@ -1,58 +1,69 @@
+import fs from 'node:fs';
 import { checkParam } from './http.js';
+import { WinglineError } from '../errors.js';
 import { ps } from '../commands/ps.js';
 import { dispatcherHealth } from '../commands/dispatcher/lifecycle.js';
-import { attention, dispatcherStatus } from '../commands/dispatcher/attention.js';
+import { attention, dispatcherStatus, pendingCount } from '../commands/dispatcher/attention.js';
 import { signalSummary } from '../commands/dispatcher/signal-summary.js';
 import { listTasks, showTask } from '../commands/task/query.js';
 import { listStale } from '../commands/task/query.js';
 import { readTimeline } from '../commands/log.js';
 import { postAddress } from '../commands/deps.js';
 import { plainText } from '../view/plain-text.js';
-async function teamSummary(ctx, name) {
-    const posts = await ps(ctx.deps, { team: name });
-    const disp = dispatcherHealth(ctx.deps, name).state;
-    const att = await attention(ctx.deps, name);
-    const attentionCount = (disp === 'stale' ? 1 : 0) +
-        att.frozen.length +
-        att.signals.length +
-        att.questions.length +
-        att.stale.length +
-        att.warnings.length;
-    return {
-        name,
-        postsCount: posts.length,
-        dispatcher: disp,
-        attentionCount,
-    };
+import { draftPathOf } from '../spec/draft.js';
+/** 总览摘要：未启动团队（runId === null）不碰 Orca——ps() 的 preflight 会抛错，直接给注册表口径（spec 3.3.4）。 */
+async function teamSummary(ctx, row) {
+    const base = { name: row.name, status: row.status, hasDraft: fs.existsSync(draftPathOf(row.specPath)) };
+    const dispatcher = dispatcherHealth(ctx.deps, row.name).state;
+    if (row.runId === null) {
+        return { ...base, postsCount: ctx.deps.registry.listPosts(row.name).length, dispatcher, attentionCount: 0 };
+    }
+    const posts = await ps(ctx.deps, { team: row.name });
+    const att = await attention(ctx.deps, row.name);
+    return { ...base, postsCount: posts.length, dispatcher, attentionCount: pendingCount(att) };
+}
+/** 未启动 / Orca 不可达时的离线岗位：全部字段来自注册表，handle 一律为 null（spec 3.3.4）。 */
+function offlinePosts(posts) {
+    return posts.map((p) => ({
+        address: p.address, agent: p.agent, status: 'offline', handle: null, worktree: p.worktree, isLead: p.isLead, sessionId: p.sessionId,
+    }));
 }
 function registerTeamRoutes(r) {
     // GET /api/teams
     r.get('/api/teams', async (ctx) => {
-        const teams = ctx.deps.registry.listTeams().map((t) => t.name);
-        const result = await Promise.all(teams.map((name) => teamSummary(ctx, name)));
-        return { teams: result };
+        const rows = ctx.deps.registry.listTeams();
+        return { teams: await Promise.all(rows.map((row) => teamSummary(ctx, row))) };
     });
     // GET /api/teams/:team
     r.get('/api/teams/:team', async (ctx) => {
         const team = ctx.params.team;
         checkParam('team', team);
-        const posts = await ps(ctx.deps, { team });
-        const disp = await dispatcherStatus(ctx.deps, team);
-        const runId = ctx.deps.registry.getTeam(team)?.runId ?? null;
-        // 移除 sessionMarker，只留 sessionId
-        const cleanPosts = posts.map((p) => {
-            const row = ctx.deps.registry.getPost(p.address);
+        const { registry } = ctx.deps;
+        const row = registry.getTeam(team);
+        if (!row)
+            throw new WinglineError('input', 'team_unknown', `没有团队 ${team}`, { hint: '先执行 wl up <team.yaml>' });
+        const base = { team, runId: row.runId, status: row.status, specPath: row.specPath, hasDraft: fs.existsSync(draftPathOf(row.specPath)) };
+        // 从未启动：不调 ps()/dispatcherStatus()，Orca 一次都不碰（spec 3.3.4）
+        if (row.runId === null) {
             return {
-                ...p,
-                sessionId: row?.sessionId ?? null,
+                ...base, neverStarted: true,
+                dispatcher: { health: { state: 'never' }, frozen: 0, hushed: 0, attentionItems: 0 },
+                posts: offlinePosts(registry.listPosts(team)),
             };
-        });
-        return {
-            team,
-            runId,
-            dispatcher: disp,
-            posts: cleanPosts,
-        };
+        }
+        let posts;
+        let orcaUnavailable;
+        try {
+            posts = (await ps(ctx.deps, { team })).map((p) => ({ ...p, sessionId: registry.getPost(p.address)?.sessionId ?? null }));
+        }
+        catch (err) {
+            // Orca 不可达：降级为离线岗位列表并附原因，其余照常返回
+            if (!(err instanceof WinglineError) || err.kind !== 'orca')
+                throw err;
+            orcaUnavailable = err.message;
+            posts = offlinePosts(registry.listPosts(team));
+        }
+        return { ...base, ...(orcaUnavailable !== undefined ? { orcaUnavailable } : {}), dispatcher: await dispatcherStatus(ctx.deps, team), posts };
     });
     // GET /api/teams/:team/attention
     r.get('/api/teams/:team/attention', async (ctx) => {
@@ -140,7 +151,7 @@ function registerPostRoutes(r) {
         const posts = await ps(ctx.deps, { team });
         const pRow = posts.find((p) => p.address === address);
         if (!pRow) {
-            throw new (await import('../errors.js')).WinglineError('input', 'invalid_param', `岗位 ${address} 不存在`);
+            throw new WinglineError('input', 'invalid_param', `岗位 ${address} 不存在`);
         }
         return await buildPostDetail(ctx, team, address, pRow);
     });
@@ -154,8 +165,15 @@ function registerLogRoute(r) {
         const post = ctx.query.get('post') ?? undefined;
         const since = ctx.query.get('since') ?? undefined;
         const source = ctx.query.get('source') ?? undefined;
+        // 与 wl log 的 --limit 同一口径：非正整数按用法错报，而不是 NaN 静默读空
         const limitStr = ctx.query.get('limit');
-        const limit = limitStr ? parseInt(limitStr, 10) : undefined;
+        let limit;
+        if (limitStr !== null) {
+            limit = Number(limitStr);
+            if (!(Number.isInteger(limit) && limit >= 1)) {
+                throw new WinglineError('input', 'limit_invalid', `limit ${limitStr} 无效：应为正整数`);
+            }
+        }
         return await readTimeline(ctx.deps, { team, task, post, since, source, limit });
     });
 }

package/dist/server/api-spec.js

@@ -12,14 +12,45 @@ function assertFields(body, allowed) {
             throw new WinglineError('input', 'unknown_field', `未知字段 ${k}`);
     }
 }
+const isObj = (v) => !!v && typeof v === 'object' && !Array.isArray(v);
+/** set 的三种形态：{ path, value }（op 缺省）、{ op: 'add_post', post }、{ op: 'remove_post', index }。 */
 function parseSet(raw) {
     if (raw === undefined)
         return undefined;
-    const s = raw;
-    const ok = s && typeof s === 'object' && Array.isArray(s.path) && s.path.length > 0 && s.path.every((p) => typeof p === 'string' || Number.isInteger(p));
-    if (!ok || !('value' in s))
-        throw new WinglineError('input', 'invalid_param', '参数 set 不合法');
-    return { path: s.path, value: s.value };
+    const bad = new WinglineError('input', 'invalid_param', '参数 set 不合法');
+    if (!isObj(raw))
+        throw bad;
+    if (raw.op === 'add_post') {
+        const p = raw.post;
+        if (!isObj(p) || typeof p.id !== 'string' || !p.id || typeof p.agent !== 'string' || !p.agent)
+            throw bad;
+        if (p.brief !== undefined && (!Array.isArray(p.brief) || !p.brief.every((b) => typeof b === 'string')))
+            throw bad;
+        for (const k of ['model', 'launch', 'worktree']) {
+            if (p[k] !== undefined && typeof p[k] !== 'string')
+                throw bad;
+        }
+        return { op: 'add_post', post: p };
+    }
+    if (raw.op === 'remove_post') {
+        if (!Number.isInteger(raw.index) || raw.index < 0)
+            throw bad;
+        return { op: 'remove_post', index: raw.index };
+    }
+    if (raw.op !== undefined && raw.op !== 'set')
+        throw bad;
+    const ok = Array.isArray(raw.path) && raw.path.length > 0 && raw.path.every((p) => typeof p === 'string' || Number.isInteger(p));
+    if (!ok || !('value' in raw))
+        throw bad;
+    return { path: raw.path, value: raw.value };
+}
+function parseFiles(raw) {
+    if (raw === undefined)
+        return undefined;
+    if (!isObj(raw) || !Object.values(raw).every((v) => typeof v === 'string')) {
+        throw new WinglineError('input', 'invalid_param', '参数 files 不合法');
+    }
+    return raw;
 }
 /** 编辑器与“关于”页的只读 / 校验接口。validate 虽是 POST，但不写文件、不进审计。 */
 export function registerSpecRoutes(r, o) {
@@ -29,9 +60,14 @@ export function registerSpecRoutes(r, o) {
     });
     r.post('/api/teams/:team/spec/validate', async (ctx) => {
         checkParam('team', ctx.params.team);
-        assertFields(ctx.body, ['yaml', 'set']);
+        assertFields(ctx.body, ['yaml', 'set', 'files']);
         checkParam('yaml', ctx.body.yaml);
-        return validateSpecEdit(ctx.deps, { team: ctx.params.team, yaml: ctx.body.yaml, set: parseSet(ctx.body.set) });
+        return validateSpecEdit(ctx.deps, {
+            team: ctx.params.team,
+            yaml: ctx.body.yaml,
+            set: parseSet(ctx.body.set),
+            files: parseFiles(ctx.body.files),
+        });
     });
     r.get('/api/about', async (ctx) => about(ctx.deps, { version: o.version, consoleFile: readConsoleFile(ctx.deps.home) }));
 }

package/dist/server/api-write.d.ts

@@ -1,12 +1,42 @@
 import type { HandlerContext, Router } from './http.js';
+import { type CommandDeps } from '../commands/deps.js';
 import { type AuditTable } from '../audit.js';
 import { send } from '../commands/send.js';
 import { createTask } from '../commands/task/create.js';
 import { escalateTask, recoverTask, resolveGate } from '../commands/task/escalate.js';
 import { reassignTask } from '../commands/task/claim.js';
+import { type DoneResult } from '../commands/task/done.js';
+import type { Delivery } from '../commands/task/dispatch.js';
 import { freezePostCmd, hushCmd, unfreezePostCmd, unhushCmd } from '../commands/dispatcher/controls.js';
 import { dispatcherReply } from '../commands/dispatcher/inbox.js';
 import { discardDraftCmd, saveSpecCmd } from '../commands/spec.js';
+import { type UpResult } from '../commands/up.js';
+import type { DownResult } from '../commands/down.js';
+import type { RestoreResult } from '../commands/restore/index.js';
+import { initTeamCmd } from '../commands/init.js';
+/** 控制台口径的参数：带 team 名（审计表靠它取团队），开关在路由层已归一成 boolean。 */
+export interface ConsoleUpArgs {
+    team: string;
+    draft?: boolean;
+    newRun?: boolean;
+    adoptRun?: string;
+}
+/** 控制台 / 插件的调度员启动参数；node/script 供插件 worker 等非 wingline 宿主覆盖 self 命令。 */
+export interface ConsoleDispatcherUpArgs {
+    team: string;
+    node?: string;
+    script?: string;
+}
+export interface ConsoleDownArgs {
+    team: string;
+    close?: boolean;
+}
+export interface ConsoleRestoreArgs {
+    team: string;
+    dryRun?: boolean;
+    noTasks?: boolean;
+    sessions?: Record<string, string>;
+}
 export interface WriteCommands {
     send: typeof send;
     createTask: typeof createTask;
@@ -14,6 +44,31 @@ export interface WriteCommands {
     reassignTask: typeof reassignTask;
     recoverTask: typeof recoverTask;
     resolveGate: typeof resolveGate;
+    claimTask: (deps: CommandDeps, a: {
+        id: string;
+        as?: string;
+    }) => Promise<void>;
+    releaseTask: (deps: CommandDeps, a: {
+        id: string;
+        as?: string;
+    }) => Promise<void>;
+    planTask: (deps: CommandDeps, a: {
+        id: string;
+        as?: string;
+        text: string;
+    }) => Promise<void>;
+    startTask: (deps: CommandDeps, a: {
+        id: string;
+        as?: string;
+    }) => Promise<{
+        delivery: Delivery;
+        reason?: string;
+        already?: true;
+    }>;
+    doneTask: (deps: CommandDeps, a: {
+        id: string;
+        as?: string;
+    }) => Promise<DoneResult>;
     freezePostCmd: typeof freezePostCmd;
     unfreezePostCmd: typeof unfreezePostCmd;
     hushCmd: typeof hushCmd;
@@ -21,6 +76,35 @@ export interface WriteCommands {
     dispatcherReply: typeof dispatcherReply;
     saveSpecCmd: typeof saveSpecCmd;
     discardDraftCmd: typeof discardDraftCmd;
+    up: (deps: CommandDeps, a: ConsoleUpArgs) => Promise<UpResult>;
+    down: (deps: CommandDeps, a: ConsoleDownArgs) => Promise<DownResult>;
+    restore: (deps: CommandDeps, a: ConsoleRestoreArgs) => Promise<RestoreResult>;
+    dispatcherUp: (deps: CommandDeps, a: ConsoleDispatcherUpArgs) => Promise<{
+        address: string;
+        outcome: 'already_running' | 'started';
+        handle?: string;
+    }>;
+    dispatcherDown: (deps: CommandDeps, a: {
+        team: string;
+        close?: boolean;
+    }) => Promise<{
+        address: string;
+        outcome: 'noop' | 'closed' | 'already_gone';
+    }>;
+    initTeamCmd: typeof initTeamCmd;
+    autostartInstall: (deps: CommandDeps, a: {
+        waitOrca?: string;
+    }) => Promise<{
+        platform: string;
+        file: string;
+        command: string[];
+        logPath: string;
+        waitOrca: string;
+    }>;
+    autostartUninstall: (deps: CommandDeps) => Promise<{
+        file: string;
+        removed: boolean;
+    }>;
 }
 export interface WriteRouteSpec {
     pattern: string;
@@ -30,7 +114,7 @@ export interface WriteRouteSpec {
 }
 export declare const WRITE_ROUTES: WriteRouteSpec[];
 export declare const CONSOLE_AUDIT: AuditTable<WriteCommands>;
-/** 控制台用 `console:`，TUI 用 `tui:`；两者共用同一张审计表，执行者都是 human。 */
-export declare function auditedWriteCommands(prefix: 'console:' | 'tui:'): WriteCommands;
+/** 控制台用 `console:`，TUI 用 `tui:`，Orca 插件用 `plugin:`；三者共用同一张审计表，执行者都是 human。 */
+export declare function auditedWriteCommands(prefix: 'console:' | 'tui:' | 'plugin:'): WriteCommands;
 export declare const consoleCommands: () => WriteCommands;
 export declare function registerWriteRoutes(r: Router, cmds: WriteCommands): void;