@tencent-ai/agent-harness 0.2.0-beta.6 → 0.2.0-beta.8

package/cli/dist-server/types/workspace/cbc-cron/lib/node/cron/cron-storage.d.ts

@@ -0,0 +1,61 @@
+import { CronExecutionClaimResult, CronExecutionDeleteResult, CronTask, CronTaskExecution } from './cron-protocol.js';
+export declare class CronStorage {
+    private static taskWriteQueues;
+    private static schedulerLockReleases;
+    private static activeExecutionOwners;
+    private static withFileLock;
+    private static atomicWrite;
+    private static mutateTasks;
+    /**
+     * Read tasks from the persisted JSON file.
+     * Returns empty array on any error (file not found, parse error, etc.)
+     */
+    static readTasks(dir: string): Promise<CronTask[]>;
+    static readTasksConsistent(dir: string): Promise<CronTask[]>;
+    /**
+     * Write tasks to the persisted JSON file.
+     * Strips the `durable` property before writing.
+     */
+    static writeTasks(tasks: CronTask[], dir: string): Promise<void>;
+    static addTask(task: CronTask, dir: string): Promise<void>;
+    static updateTask(id: string, update: (task: CronTask) => CronTask, dir: string): Promise<CronTask | undefined>;
+    static takeTask(id: string, dir: string): Promise<CronTask | undefined>;
+    /** Remove tasks by ID from the persisted file. */
+    static removeTasks(ids: string[], dir: string): Promise<void>;
+    /**
+     * Update the lastFiredAt timestamp for tasks in the persisted file.
+     * Used to track recurring task fire times so restarts don't re-fire immediately.
+     */
+    static updateTaskLastFiredAt(taskIds: string[], timestamp: number, dir: string): Promise<void>;
+    static readExecutions(dir: string): Promise<CronTaskExecution[]>;
+    static writeExecutions(executions: CronTaskExecution[], dir: string): Promise<void>;
+    static registerExecutionOwner(ownerId: string): void;
+    static unregisterExecutionOwner(ownerId: string): void;
+    static tryInsertActiveExecution(execution: CronTaskExecution, dir: string): Promise<CronExecutionClaimResult>;
+    static renewExecutionLeases(ownerId: string, executionIds: ReadonlySet<string>, leaseExpiresAt: number, dir: string): Promise<number>;
+    static deleteExecutions(taskId: string, executionIds: readonly string[], dir: string): Promise<CronExecutionDeleteResult>;
+    static upsertExecution(execution: CronTaskExecution, dir: string): Promise<void>;
+    static failActiveExecutions(error: string, dir: string, excludedIds?: ReadonlySet<string>): Promise<number>;
+    private static isExecutionOwnerAlive;
+    /** Acquire the long-lived durable scheduler leader lock. */
+    static acquireLock(dir: string, identity: {
+        sessionId: string;
+        pid: number;
+        ownerId?: string;
+    }, onCompromised?: (error: Error) => void): Promise<boolean>;
+    /** Release the durable scheduler leader lock owned by this scheduler instance. */
+    static releaseLock(_dir: string, identity: {
+        sessionId: string;
+        pid: number;
+        ownerId?: string;
+    }): Promise<void>;
+    /**
+     * Watch the tasks file for changes using Node.js built-in fs.watch.
+     * Returns a watcher object with a `.close()` method.
+     *
+     * Uses a debounce timer (200ms) to coalesce rapid file changes.
+     */
+    static watchTasksFile(dir: string, onChange: () => void): {
+        close: () => void;
+    };
+}

package/cli/dist-server/types/workspace/cbc-cron/lib/node/cron/cron-task-session.d.ts

@@ -0,0 +1 @@
+export declare function cronTaskSessionId(taskId: string): string;

package/cli/dist-server/types/workspace/cbc-cron/lib/node/cron/index.d.ts

@@ -0,0 +1,8 @@
+export * from './cron-protocol.js';
+export * from './cron-parser.js';
+export * from './cron-state-manager.js';
+export * from './cron-scheduler.js';
+export * from './cron-scheduler-service.js';
+export * from './cron-storage.js';
+export * from './cron-task-session.js';
+export * from './loop-skill-provider.js';

package/cli/dist-server/types/workspace/cbc-cron/lib/node/cron/loop-skill-provider.d.ts

@@ -0,0 +1,36 @@
+import { ProductConfiguration, ProductProvider } from '../../../../product/lib/common/index.js';
+/**
+ * Marker prefix embedded at the front of every wrapped /loop prompt
+ * (`${LOOP_JOB_MARKER_PREFIX}<LOOP_ID>]`). CronListTool truncates each
+ * job's prompt preview to 80 chars, so this must stay at the very front to
+ * survive the fallback lookup — see the "## Action" instructions below.
+ *
+ * `<LOOP_ID>` is a short opaque token the model makes up itself (not a real
+ * timestamp). Deriving it from anything precise (an ISO timestamp) used to
+ * force a `Bash(date …)` call on every /loop invocation, which blocks on a
+ * permission prompt in default mode and reads as a "hang" — see
+ * loop-hang-after-reschedule.spec.ts. The id only needs to be unique per
+ * loop and stable across reschedules; it does not need to encode the time.
+ */
+export declare const LOOP_JOB_MARKER_PREFIX = "[/loop:";
+/**
+ * ProductProvider that injects the /loop bundled skill.
+ *
+ * Aligns with Claude Code's registerBundledSkill pattern (WH() + qgz()).
+ * Uses the standard ProductProvider mechanism to inject the skill into the
+ * product configuration, avoiding the need for a separate registerBundledSkill API.
+ *
+ * The skill instructions use $ARGUMENTS placeholder which is replaced by
+ * SkillTool.executeSkill → customCommandRenderer.processContent when args are provided.
+ * When no args are provided, $ARGUMENTS stays as-is in the text, and the AI
+ * recognizes the empty input condition from the template instructions.
+ */
+export declare class LoopSkillProductProvider implements ProductProvider {
+    scope: 'runtime';
+    /**
+     * Use a priority lower than WORKSPACE (SkillProductProvider) so that
+     * bundled skills can be overridden by user/project skills with the same name.
+     */
+    priority: number;
+    provide(): Promise<ProductConfiguration>;
+}

package/cli/dist-server/types/workspace/cbc-cron/lib/node/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @genie/cbc-cron — CodeBuddy Code Cron 调度运行时。
+ *
+ * 目录布局镜像 agent-cli：`src/node/cron/**` 与拆分前保持一致，git 历史通过 `git mv` 继承。
+ * agent-cli 侧对 `../cron/*` 相对 import 改为主入口 `@genie/cbc-cron`；本包内部对 agent-cli
+ * 的引用一律走 `@genie/agent-cli/node/<子路径>` 精确 subpath（走 src 源码），与 workflow / tui 一致。
+ *
+ * 与 `@genie/agent-cli` 之间允许循环依赖：本包顶层不允许直接消费 agent-cli 运行时值。
+ */
+export * from './cron/index.js';

package/cli/dist-server/types/workspace/cbc-daemon/lib/node/daemon/bg-session-handler.d.ts

@@ -0,0 +1,88 @@
+import { type IBgSessionHandler } from './daemon-protocol.js';
+/**
+ * 后台会话命令处理器 — ps / logs / attach / kill / --bg
+ *
+ * 所有命令都是轻量级短生命周期操作，直接读取 PID 注册表完成。
+ */
+export declare class BgSessionHandlerImpl implements IBgSessionHandler {
+    private readonly registry;
+    private readonly processManager;
+    private readonly consoleManager;
+    private readonly jobStore;
+    ps(args: string[]): Promise<void>;
+    logs(pidOrName: string): Promise<void>;
+    /**
+     * `codebuddy attach <id>` —— 接管一个后台会话。
+     *
+     * 先按 job 找：agent view 派发出来的会话是 broker 托管的，能连上它自己
+     * 持有的 PTY，拿到的是一个**可以打字的完整交互会话**。
+     * 以前这里对 bg session 一律 `tailFollow(logPath)`，那只是只读地看日志，
+     * 与命令名承诺的「接管」完全是两回事。
+     *
+     * 进程已经退出的 job 也走这条路：broker.attach() 会按 `--resume` 把它
+     * 重新拉起来再接管，对话不丢。只有压根不是 job 的后台进程
+     * （旧的 `--bg`、`--serve` 之类没有 PTY 的）才退回日志。
+     */
+    attach(pidOrName: string): Promise<void>;
+    /**
+     * detach 后**在当前进程原地**打开 agent view，并让 Esc/← 回到刚 attach 的会话。
+     *
+     * 绝不fork 子进程：`codebuddy attach` 是控制终端的前台进程组 leader，
+     * spawn 出来的子进程不在前台组，Ink 挂载时对 tty 做 `setRawMode`
+     * （tcsetattr）会被内核 EIO 拒绝——无论子进程继承 fd0 还是自开
+     * `/dev/tty` 都拒（fd 有效但不是它前台组的控制终端）。而本进程刚才
+     * 在 pipeTerminal 里 setRawMode 是成功的，说明它就是前台、就握着终端，
+     * 所以直接在这里挂载 agent view。复用 `codebuddy agents` 那条同一渲染路径。
+     */
+    private openAgentViewAfterDetach;
+    kill(pidOrName: string): Promise<void>;
+    handleBgFlag(args: string[]): Promise<void>;
+    remove(idOrName: string | undefined): Promise<void>;
+    respawn(idOrName: string | undefined): Promise<void>;
+    /**
+     * `codebuddy respawn --all` —— 重启每个运行中的会话。
+     *
+     * 典型用途：升级 CLI 二进制后把所有后台会话一次性搬到新版。
+     * 只重启进程还活着的会话（对齐文档 "every running session"）；
+     * shell 作业（state.exec）不是模型会话，跳过。单个失败不中断其余。
+     */
+    respawnAll(): Promise<void>;
+    /**
+     * 和 {@link resolveJob} 一样按 id/name/sessionId 找，但找不到时不报错。
+     *
+     * `attach` 要先试 job、再退回 PID 注册表，中途不能先喷一句
+     * "Session not found" 又接着成功 —— 那比不打印还让人困惑。
+     */
+    private resolveJobQuietly;
+    /** 按 job 短 id / 会话名 / sessionId 定位一个 job，并合并进程存活信息 */
+    private resolveJob;
+    private resolveSession;
+    /** 断言 entry 非空，用于流式调用链中（resolve 后立即 require） */
+    private requireSession;
+    private log;
+    private error;
+    private formatRow;
+    private truncatePath;
+    private formatTimeAgo;
+    /** 从 args 中提取 --session-id 的值（用户可能自己传了一个） */
+    private extractSessionIdArg;
+    /**
+     * 确保 args 里带上 --session-id。
+     *
+     * agent view 需要在 fork 之前就知道会话 id 才能建好 job 目录，
+     * 所以这里主动把它固定下来而不是让子进程自己随机生成。
+     */
+    private ensureSessionIdArg;
+    /** 取第一个非 flag 位置参数作为原始 prompt（用于 job 的 intent） */
+    private extractPromptArg;
+    /** 从 args 里抽 `--exec <cmd>` / `--exec=<cmd>`（未给出时返回 undefined） */
+    private extractExecArg;
+    /** 从 args 中提取 --name <value> 或 --name=<value> */
+    private extractNameArg;
+    /**
+     * 持续跟踪日志文件输出（类似 tail -f）。
+     * 使用 fs.watch 监听文件变化，增量读取新内容。
+     * Ctrl+C 断开时只退出当前进程，不影响后台会话。
+     */
+    private tailFollow;
+}

package/cli/dist-server/types/workspace/cbc-daemon/lib/node/daemon/daemon-auto-restart.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Daemon Auto-Restart — 更新后空闲自动重启
+ *
+ * 由 AutoUpdateService 安装更新成功后调用 schedulePendingRestart()，
+ * 然后每 10 秒轮询空闲状态，确认空闲后执行 graceful restart：
+ * 保存端口 + channel 列表 → stop 长连接 → 注销 PID → 非托管时 fork，systemd 下交回 supervisor
+ */
+import { ServerAware } from '@celljs/web/lib/node';
+import type { Server } from 'http';
+import { type DaemonConfig, type IDaemonAutoRestart } from './daemon-protocol.js';
+export declare class DaemonAutoRestartImpl implements IDaemonAutoRestart, ServerAware {
+    private readonly logger;
+    private readonly registry;
+    private readonly processManager;
+    private readonly acpAgentManager?;
+    private readonly gatewayAcpBridge?;
+    private readonly wakeDetector?;
+    private readonly channelAutoConnect?;
+    private pendingRestart;
+    private idleCheckTimer;
+    private pendingSince;
+    private restartInFlight;
+    private httpServer?;
+    private readonly sockets;
+    setServer(server: Server): Promise<void>;
+    start(): void;
+    stop(): void;
+    schedulePendingRestart(): void;
+    /**
+     * 立即优雅自重启（Web UI "重启 daemon" 按钮路径，#72979）。
+     *
+     * 延迟 RESTART_RESPONSE_FLUSH_DELAY_MS 再动手，让调用方（daemon 自己）
+     * 先把当前 restart 的 HTTP 响应发出去。真正的互斥在 performGracefulRestart
+     * 入口（覆盖 auto-update idle 路径与本路径的交叉竞态）；这里的检查只是
+     * 提前挡掉明显重复的调用。
+     */
+    restartNow(config?: Partial<DaemonConfig>): void;
+    private startIdleCheck;
+    private clearIdleCheck;
+    /**
+     * 判断 daemon 是否空闲。daemon 自身的注册状态只在启动时写一次，不能代表
+     * 它承载的会话；这里检查所有活跃 session/job 的权威注册状态。未知状态按忙处理，
+     * 防止状态上报暂时缺失时误切正在运行的任务。
+     */
+    private isIdle;
+    private isSystemdManaged;
+    private isLegacySystemdUnit;
+    /**
+     * Graceful Restart:
+     * 1. 读取端口配置（override 优先，其次 PID 文件快照）
+     * 2. 收集已连接 channel
+     * 3. 停止唤醒检测和防休眠
+     * 4. 注销 PID
+     * 5. Fork 新 daemon（相同端口 + channel 恢复列表）
+     * 6. 退出旧进程
+     */
+    private performGracefulRestart;
+    private releaseHttpServerForRestart;
+    private destroyTrackedSockets;
+    private parseUrl;
+}

package/cli/dist-server/types/workspace/cbc-daemon/lib/node/daemon/daemon-channel-autoconnect.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Daemon Channel Auto-Connect — 自动连接已保存凭证的 channel 实例
+ *
+ * daemon 启动时：
+ * 1. 优先检查 CODEBUDDY_DAEMON_RESTORE_CHANNELS 环境变量（restart 恢复）
+ * 2. 否则扫描 ~/.codebuddy/channels/ 下的 instances.json，自动连接有凭证的实例
+ *
+ * 开关优先级（从高到低）：
+ * 1. 环境变量 CODEBUDDY_DAEMON_AUTO_CONNECT_CHANNELS=0/false → 全局禁用
+ * 2. settings.json daemonAutoConnectChannels: false → 全局禁用
+ * 3. 实例级别 autoConnect: false → 跳过该实例
+ * 4. 默认 → 自动连接
+ */
+import { type IDaemonChannelAutoConnect } from './daemon-protocol.js';
+export declare class DaemonChannelAutoConnectImpl implements IDaemonChannelAutoConnect {
+    private readonly logger;
+    private readonly remoteControlService?;
+    private readonly clientRegistry?;
+    private readonly settingsManager?;
+    connectSavedChannels(): Promise<void>;
+    restoreChannels(channelIds: string[]): Promise<void>;
+    getConnectedChannelIds(): string[];
+    /**
+     * 检查全局开关是否禁用了自动连接。
+     * 优先级：环境变量 > settings
+     */
+    private isGloballyDisabled;
+}

package/cli/dist-server/types/workspace/cbc-daemon/lib/node/daemon/daemon-enhancements-lifecycle.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Daemon Enhancements Lifecycle
+ *
+ * 在 daemon 模式（ENV_SESSION_KIND=daemon）下自动启动增强功能：
+ * 1. WakeDetector — 防 idle sleep + 唤醒检测 → 重连所有长连接
+ * 2. DaemonAutoRestart — 更新安装后空闲自动重启
+ * 3. DaemonChannelAutoConnect — 自动连接已保存凭证的 channel 实例
+ *
+ * 生命周期:
+ *   - initialize: 检测 daemon 模式 → 延迟启动各模块（等待依赖就绪）
+ *   - onStop: 停止检测器和自动重启，清理订阅
+ */
+import { Application, ApplicationLifecycle } from '@celljs/core';
+export declare class DaemonEnhancementsLifecycle implements ApplicationLifecycle<Application> {
+    private logger?;
+    private wakeDetector?;
+    private autoRestart?;
+    private wakeSubscription?;
+    initialize(): void;
+    onStop(): Promise<void>;
+    private initAsync;
+    private startWakeDetector;
+    private startAutoRestart;
+    /**
+     * Daemon 启动时主动 "无人值守地" 走一遍完整 session 创建流程，让 webhook（微信/企微/HTTP runs）
+     * 一进来就能复用这个 primary session，无需等用户先打开 Web UI 创建对话。
+     *
+     * 关键：必须发真实的 `POST /internal/agent` 请求（body 不带 prompt），
+     * 而不是直接 `sessionManager.create()`。原因：
+     *   - 直接 create 只造一个对象，**不会触发** SessionMiddleware
+     *   - SessionMiddleware 是注入 cliRuntimeOptions / 触发 setCurrent / 启动 hooks /
+     *     初始化 ToolPermissionContext / 推送 sessionSubject 的统一入口
+     *   - sessionSubject.next 触发后，ServerModeStrategy 的 take(1) 监听才会调
+     *     `gatewayBridge.setPrimarySession(session)`，让后续 webhook 全部汇聚到此 session
+     *
+     * 等价于"daemon 自己代替无人值守的 Web UI 创建一个完整 session"。
+     */
+    private bootstrapPrimarySession;
+    private connectChannels;
+    /**
+     * 唤醒后重连所有长连接客户端。
+     * 等待 3 秒让网络栈恢复，然后逐个断开并重连。
+     */
+    private reconnectAllChannels;
+}

package/cli/dist-server/types/workspace/cbc-daemon/lib/node/daemon/daemon-process.d.ts

@@ -0,0 +1,77 @@
+import { type BgSessionOptions, type DaemonConfig, type IDaemonProcessManager } from './daemon-protocol.js';
+/**
+ * 子进程管理器 — fork detached 进程、信号处理、存活检测
+ *
+ * 负责 daemon supervisor 和后台会话的进程创建与管理。
+ * 所有 fork 出的子进程都是 detached 模式，父进程可以立即退出。
+ */
+export declare class DaemonProcessManagerImpl implements IDaemonProcessManager {
+    forkDaemon(config: DaemonConfig, extraEnv?: Record<string, string>): Promise<{
+        pid: number;
+        logPath: string;
+    }>;
+    /**
+     * 构造 daemon 子进程的 CLI 参数。抽离成独立方法是为了：
+     * 1) `forkDaemon` 主流程更清晰；
+     * 2) 单测可以直接覆盖参数装配规则（-y vs --permission-mode 优先级、startupArgs 回放等）
+     *    而无需 stub child_process.fork。
+     */
+    buildDaemonChildArgs(config: DaemonConfig): string[];
+    forkBgSession(args: string[], options: BgSessionOptions): Promise<{
+        pid: number;
+        logPath: string;
+    }>;
+    sendSignal(pid: number, signal: NodeJS.Signals): boolean;
+    isProcessRunning(pid: number): boolean;
+    waitForExit(pid: number, timeoutMs?: number): Promise<boolean>;
+    private getLogDir;
+    /**
+     * 确定 CLI 入口路径。
+     * 使用当前进程的启动脚本路径（process.argv[1]），确保 fork 出的子进程
+     * 使用和当前进程相同的入口文件，不受 __dirname 打包路径影响。
+     */
+    private getEntryPath;
+    /**
+     * 创建 detached 子进程的统一方法。
+     * stdout/stderr 重定向到日志文件，IPC 通道创建后立即断开。
+     *
+     * Bun SFE 下不能用 `fork()`：它无条件把「模块路径」塞进子进程 argv[1]
+     * （`fork(modulePath, args)` 等价于 `spawn(execPath, [modulePath, ...args])`），
+     * 而 Bun 编译出的可执行文件本身就是完整入口——那个「模块路径」在Bun SFE 下
+     * 是 `process.argv[1]` 的虚拟路径（`/$bunfs/root/<bin>`），被当成参数续传给
+     * 子进程后会落进 commander 的位置参数（`argv[2]` 起），子进程又把它当 CLI
+     * 入口重新拼进自己的 argv——递归下去 argv 逐代累积虚拟路径（对齐
+     * `PathUtils.buildRespawnArgs` 修复的同一类问题，issue #82398）。这里改用
+     * `spawn()` 手动带 `'ipc'` stdio（等价于 fork 的 IPC 语义），配合
+     * `PathUtils.buildRespawnArgs` 决定要不要把 entry 塞进 argv——本方法只调了
+     * `.unref()` + `.disconnect()`，从未用 `.send()`/`.on('message')`，
+     * 换成 `spawn` 不影响现有语义。
+     */
+    protected forkDetached(args: string[], opts: {
+        env: Record<string, string>;
+        logPath: string;
+        cwd: string;
+    }): Promise<{
+        pid: number;
+        logPath: string;
+    }>;
+    /**
+     * 从 args 中移除 --bg, --background, --name <value> 参数。
+     * 后台会话不需要这些标志 — 它们已经通过环境变量传递。
+     */
+    private filterBgArgs;
+    /** 确保 args 中包含指定参数（两个别名都检查） */
+    private ensureArg;
+    /**
+     * 判断 args 中是否已经传入了带值的 flag（同时支持 `--key value` 与 `--key=value` 两种形式）。
+     */
+    private hasFlagWithValue;
+    /**
+     * Extract inheritable CLI arguments from the parent process.
+     * Skips daemon-specific args and mode/lifecycle args that don't apply to the child.
+     *
+     * 公开为 public：`daemon-service` 在 `runAsSupervisor()` 时需要拿到这份"原始用户参数"
+     * 持久化到 PID 文件，供后续 `daemon restart` / auto-restart 还原。
+     */
+    getInheritableArgs(): string[];
+}