agim-cli 1.0.1

package/dist/core/agent-base.js

@@ -0,0 +1,373 @@
+// AgentBase — base class for CLI-based agent adapters
+//
+// Provides a unified streaming JSONL invocation pipeline:
+//   sendPrompt        — true AsyncGenerator that yields chunks live
+//   spawnAndCollect   — Promise<string> wrapper for job-board / sync calls
+//   isAvailable       — `--version` probe
+//   buildContextualPrompt / buildArgs / extractText — subclass hooks
+//
+// Subclasses must implement: buildArgs(), extractText().
+// Optional override: handleError(), notAvailableMessage(), commandName.
+import { StringDecoder } from 'node:string_decoder';
+import { crossSpawn } from '../utils/cross-platform.js';
+import { logger as rootLogger } from './logger.js';
+const DEFAULT_TIMEOUT_MS = 30 * 60 * 1000;
+/** Resolve per-agent timeout: env var AGENT_TIMEOUT_MS or class default */
+function resolveTimeout(envKey, fallback) {
+    const raw = process.env[envKey];
+    if (raw) {
+        const n = parseInt(raw, 10);
+        if (Number.isFinite(n) && n > 0)
+            return n;
+        rootLogger.warn({ event: 'agent.timeout.invalid', raw, envKey, fallback }, `Invalid timeout env "${envKey}=${raw}", using default ${Math.round(fallback / 60000)}min`);
+    }
+    return fallback;
+}
+/**
+ * Buffer line splitter that respects UTF-8 multi-byte boundaries.
+ *
+ * Holds a single `partial` string of bytes seen so far without a newline
+ * boundary. push(chunk) returns any complete lines found in
+ * partial+chunk, and resets partial to the remainder.
+ *
+ * Implementation notes:
+ *   - Uses StringDecoder so a 3-byte CJK codepoint split across chunks
+ *     stays whole (no U+FFFD).
+ *   - Skips the partial+chunk concat when the chunk has no newline AND
+ *     partial is empty (the common case for tiny chunks).
+ *   - Walks via indexOf + slice instead of String.split so we avoid
+ *     allocating an intermediate array of every line just to pop the
+ *     last one back into partial.
+ */
+class LineBuffer {
+    decoder = new StringDecoder('utf8');
+    partial = '';
+    push(chunk) {
+        const decoded = this.decoder.write(chunk);
+        if (!decoded)
+            return [];
+        if (decoded.indexOf('\n') === -1) {
+            // No newline in this chunk — extend partial. V8 ropes strings, so
+            // the concat is amortized O(1) here.
+            this.partial += decoded;
+            return [];
+        }
+        const data = this.partial.length === 0 ? decoded : this.partial + decoded;
+        const out = [];
+        let start = 0;
+        while (true) {
+            const nl = data.indexOf('\n', start);
+            if (nl === -1)
+                break;
+            out.push(data.slice(start, nl));
+            start = nl + 1;
+        }
+        this.partial = start < data.length ? data.slice(start) : '';
+        return out;
+    }
+    flush() {
+        const tail = this.decoder.end();
+        const data = this.partial.length === 0 ? tail : this.partial + tail;
+        this.partial = '';
+        if (data.length === 0)
+            return [];
+        const out = [];
+        let start = 0;
+        while (true) {
+            const nl = data.indexOf('\n', start);
+            if (nl === -1)
+                break;
+            if (nl > start)
+                out.push(data.slice(start, nl));
+            start = nl + 1;
+        }
+        if (start < data.length)
+            out.push(data.slice(start));
+        return out;
+    }
+}
+export class AgentBase {
+    /** Binary name to check for isAvailable */
+    get commandName() { return this.name; }
+    /**
+     * Returns a complete spawn plan. Default implementation just wraps
+     * buildArgs(). Subclasses needing per-call temp resources (mcp-config
+     * file, registered run id, etc.) should override and put ALL derived
+     * state inside the returned plan / closure — never on `this`, since
+     * concurrent spawns would race.
+     */
+    async prepareCommand(prompt, opts) {
+        return { args: this.buildArgs(prompt, opts) };
+    }
+    /**
+     * Optional side-channel hook fired for every parsed JSONL event before
+     * extractText. Default no-op. Used by adapters whose CLI surfaces metadata
+     * (session id, cost, token counts) inline with content events — they
+     * dispatch back to the caller via `opts.onAgentSessionId` / `opts.onUsage`.
+     *
+     * Keep it cheap: this runs on the hot stdout path. No network or disk.
+     */
+    inspectEvent(_event, _opts) { }
+    /** Optional: transform error info into a user-friendly message string (resolved instead of rejected). */
+    handleError(_code, _stderr, _errorMessage) {
+        return null; // default: reject
+    }
+    /** Optional: return user-friendly unavailable message. */
+    notAvailableMessage() {
+        return `${this.name} CLI not found. Please install it.`;
+    }
+    async isAvailable() {
+        return new Promise((resolve) => {
+            const proc = crossSpawn(this.commandName, ['--version'], { stdio: 'ignore' });
+            proc.on('close', (code) => resolve(code === 0));
+            proc.on('error', () => resolve(false));
+        });
+    }
+    /** Lightweight health probe (same as isAvailable for CLI agents). */
+    async healthCheck() {
+        const start = Date.now();
+        const ok = await this.isAvailable();
+        return { ok, latencyMs: Date.now() - start };
+    }
+    /**
+     * Stream JSONL chunks live. Yields each `extractText` result as it
+     * arrives; on non-zero exit, yields the friendly error tail (if any) and
+     * returns.
+     */
+    async *sendPrompt(_sessionId, prompt, history, opts) {
+        rootLogger.info({ component: `agent.${this.name}`, agent: this.name, historyLen: history?.length || 0 }, `[${this.name}] sendPrompt`);
+        const contextualPrompt = this.buildContextualPrompt(prompt, history);
+        yield* this.spawnStream(contextualPrompt, undefined, opts || {});
+    }
+    /**
+     * Build prompt with conversation history context.
+     * Subclasses may override for custom formatting.
+     */
+    buildContextualPrompt(prompt, history) {
+        if (!history || history.length === 0) {
+            return prompt;
+        }
+        const historyText = history
+            .map(msg => `[${msg.role === 'user' ? 'User' : 'Assistant'}]: ${msg.content}`)
+            .join('\n\n');
+        return `Previous conversation context:\n${historyText}\n\nCurrent request: ${prompt}`;
+    }
+    /** Per-agent timeout in ms. Override or set env var (upper-case name + _TIMEOUT_MS). */
+    get timeoutMs() {
+        return resolveTimeout(`${this.name.toUpperCase()}_TIMEOUT_MS`, DEFAULT_TIMEOUT_MS);
+    }
+    /**
+     * Sync convenience wrapper: drain the streaming generator into a single
+     * string. Used by Job Board where the caller wants the final result.
+     */
+    async spawnAndCollect(prompt, signal) {
+        let acc = '';
+        for await (const chunk of this.spawnStream(prompt, signal, {})) {
+            acc += chunk;
+        }
+        return acc;
+    }
+    /**
+     * Core streaming pipeline: spawn the CLI, parse JSONL line-by-line, yield
+     * each extracted text fragment. Handles timeout, abort, and process exit
+     * with cleanup of all timers and listeners.
+     */
+    async *spawnStream(prompt, signal, opts = {}) {
+        const timeout = this.timeoutMs;
+        // prepareCommand returns a self-contained plan — args, optional extra env,
+        // optional cleanup. No instance state involved, so concurrent spawnStream
+        // calls cannot race each other. (Previously setupSpawn() would mutate
+        // this.mcpConfigPath etc. between awaits, leading to two parallel claude
+        // runs sharing one mcp.json and the second one finding it already deleted.)
+        let plan;
+        plan = await this.prepareCommand(prompt, opts);
+        const proc = crossSpawn(this.commandName, plan.args, {
+            stdio: ['ignore', 'pipe', 'pipe'],
+            env: plan.extraEnv ? { ...process.env, ...plan.extraEnv } : undefined,
+            cwd: plan.cwd,
+        });
+        const buf = new LineBuffer();
+        const stderrBuf = new LineBuffer();
+        let stderrAccum = '';
+        let errorMessage = '';
+        let pendingChunks = [];
+        let closed = false;
+        let exitCode = null;
+        let spawnError = null;
+        let timedOut = false;
+        let aborted = false;
+        // Each `notify` resolves the current poll cycle; the consumer awaits a
+        // promise that flips whenever new state is available.
+        let notify = null;
+        const wait = () => new Promise((resolve) => { notify = resolve; });
+        const ping = () => { const n = notify; notify = null; n?.(); };
+        const timer = setTimeout(() => {
+            timedOut = true;
+            try {
+                proc.kill('SIGTERM');
+            }
+            catch { /* ignore */ }
+            ping();
+        }, timeout);
+        let killTimer = null;
+        const scheduleKill = () => {
+            if (killTimer)
+                return;
+            killTimer = setTimeout(() => {
+                try {
+                    proc.kill('SIGKILL');
+                }
+                catch { /* ignore */ }
+            }, 5000);
+        };
+        const onAbort = () => {
+            aborted = true;
+            try {
+                proc.kill('SIGTERM');
+            }
+            catch { /* ignore */ }
+            scheduleKill();
+            ping();
+        };
+        if (signal) {
+            if (signal.aborted) {
+                onAbort();
+            }
+            else {
+                signal.addEventListener('abort', onAbort, { once: true });
+            }
+        }
+        proc.stdout?.on('data', (data) => {
+            const lines = buf.push(data);
+            for (const line of lines) {
+                if (!line.trim())
+                    continue;
+                try {
+                    const event = JSON.parse(line);
+                    if (event && typeof event === 'object' && event.type === 'error') {
+                        const e = event;
+                        errorMessage = e.error || e.message || 'error event';
+                        // Don't yield error event content alongside extractText
+                        continue;
+                    }
+                    this.inspectEvent(event, opts);
+                    const text = this.extractText(event);
+                    if (text)
+                        pendingChunks.push(text);
+                }
+                catch {
+                    // Non-JSON line — pass through verbatim with newline preserved
+                    pendingChunks.push(`${line}\n`);
+                }
+            }
+            if (pendingChunks.length > 0)
+                ping();
+        });
+        proc.stderr?.on('data', (data) => {
+            stderrAccum += data.toString();
+            // Surface to root logger as warn — pino-aware, no console.error noise
+            for (const line of stderrBuf.push(data)) {
+                if (line.trim()) {
+                    rootLogger.warn({ component: `agent.${this.name}`, agent: this.name, stderr: line }, `[${this.name}] stderr`);
+                }
+            }
+        });
+        proc.on('error', (err) => {
+            spawnError = err;
+            closed = true;
+            ping();
+        });
+        proc.on('close', (code) => {
+            exitCode = code;
+            closed = true;
+            // Flush any remaining stderr line
+            for (const line of stderrBuf.flush()) {
+                if (line.trim()) {
+                    rootLogger.warn({ component: `agent.${this.name}`, agent: this.name, stderr: line }, `[${this.name}] stderr`);
+                }
+            }
+            // Flush any non-newline-terminated tail in stdout buffer
+            for (const line of buf.flush()) {
+                try {
+                    const event = JSON.parse(line);
+                    const text = this.extractText(event);
+                    if (text)
+                        pendingChunks.push(text);
+                }
+                catch {
+                    pendingChunks.push(line);
+                }
+            }
+            ping();
+        });
+        try {
+            while (!closed || pendingChunks.length > 0) {
+                if (pendingChunks.length === 0) {
+                    await wait();
+                    if (aborted)
+                        break;
+                    if (timedOut)
+                        break;
+                }
+                // Drain whatever has accumulated this cycle
+                const out = pendingChunks;
+                pendingChunks = [];
+                for (const c of out)
+                    yield c;
+            }
+            if (timedOut) {
+                const mins = Math.round(timeout / 60000);
+                rootLogger.warn({ component: `agent.${this.name}`, agent: this.name, timeoutMs: timeout }, `[${this.name}] timeout after ${mins}min`);
+                yield `\n\n⚠️ 处理超时（已超过 ${mins} 分钟）`;
+                return;
+            }
+            if (aborted) {
+                rootLogger.info({ component: `agent.${this.name}`, agent: this.name }, `[${this.name}] cancelled via signal`);
+                yield '\n\n🚫 任务已被取消。';
+                return;
+            }
+            if (spawnError) {
+                throw spawnError;
+            }
+            rootLogger.info({
+                component: `agent.${this.name}`,
+                agent: this.name,
+                exitCode,
+            }, `[${this.name}] process closed`);
+            if (exitCode !== null && exitCode !== 0) {
+                const friendly = this.handleError(exitCode, stderrAccum, errorMessage);
+                if (friendly !== null) {
+                    yield friendly;
+                    return;
+                }
+                let detail = '';
+                if (errorMessage)
+                    detail = errorMessage;
+                if (!detail && stderrAccum.trim() && stderrAccum.trim().length < 200) {
+                    detail = stderrAccum.trim();
+                }
+                yield `${this.name} failed (exit ${exitCode})${detail ? `: ${detail}` : ''}`;
+            }
+        }
+        finally {
+            clearTimeout(timer);
+            if (killTimer)
+                clearTimeout(killTimer);
+            if (signal)
+                signal.removeEventListener('abort', onAbort);
+            if (plan.cleanup) {
+                try {
+                    await plan.cleanup();
+                }
+                catch (err) {
+                    // L13: surface to /api/metrics in addition to pino so ops can
+                    // alert on cumulative cleanup failures (orphan tmpdir leakage).
+                    const { recordAgentCleanupFailure } = await import('./metrics.js');
+                    recordAgentCleanupFailure();
+                    rootLogger.warn({ component: `agent.${this.name}`, agent: this.name, err: String(err) }, `[${this.name}] cleanup hook threw`);
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=agent-base.js.map

package/dist/core/agent-base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-base.js","sourceRoot":"","sources":["../../src/core/agent-base.ts"],"names":[],"mappings":"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"}

package/dist/core/agent-cwd.d.ts

@@ -0,0 +1,48 @@
+import type { AgentSendOpts } from './types.js';
+/** Root for all per-agent IM workspaces. Kept stable so memory persists.
+ *  Honors the legacy `IMHUB_WORKSPACES_ROOT` env override; otherwise
+ *  resolves via core/agim-paths (which prefers `~/.agim-workspaces/` but
+ *  falls back to the legacy `~/.im-hub-workspaces/` on 0.x systems). */
+export declare function imhubWorkspacesRoot(): string;
+/** Default cwd for a given agent under the workspaces root. */
+export declare function defaultAgentCwd(agentName: string): string;
+/**
+ * Resolve the cwd to spawn an agent CLI in.
+ *
+ * Decision order:
+ *   1. Env override `IMHUB_<AGENT>_CWD` always wins.
+ *   2. If we're in an IM context (threadId + platform both present), pin to
+ *      `~/.im-hub-workspaces/<agent>/`.
+ *   3. Otherwise return undefined → adapter inherits im-hub's cwd. This
+ *      keeps web/scheduler/intent-llm judge paths exactly as they were.
+ */
+export declare function resolveAgentCwd(agentName: string, opts: AgentSendOpts): string | undefined;
+/**
+ * Idempotent: create the workspace dir and seed initial CLAUDE.md / AGENTS.md
+ * if they don't exist. Existing files are NEVER overwritten — the user is free
+ * to evolve them by hand or have the agent itself rewrite them via
+ * auto-memory.
+ *
+ * Honors IMHUB_<AGENT>_CWD overrides — if set, we bootstrap THAT path
+ * instead. Skips bootstrapping when the override is empty / unset and we
+ * compute it from defaultAgentCwd; either way the resolved path is what
+ * spawnStream will pass as cwd.
+ */
+export declare function ensureAgentWorkspace(agentName: string, seed: {
+    filename: string;
+    content: string;
+}): Promise<string>;
+/**
+ * Bootstrap the workspaces for the two built-in CLI agents we ship by
+ * default. Safe to call multiple times. Returns a summary suitable for
+ * logging.
+ *
+ * Other agents (codex, copilot, ACP-imported) don't need cwd isolation
+ * either because they don't have per-cwd memory, or because they're
+ * remote — they'll pass through with cwd undefined like before.
+ */
+export declare function bootstrapAgentWorkspaces(): Promise<Array<{
+    agent: string;
+    dir: string;
+}>>;
+//# sourceMappingURL=agent-cwd.d.ts.map

package/dist/core/agent-cwd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-cwd.d.ts","sourceRoot":"","sources":["../../src/core/agent-cwd.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAG/C;;;wEAGwE;AACxE,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED,+DAA+D;AAC/D,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEzD;AAQD;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,MAAM,GAAG,SAAS,CAS1F;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC1C,OAAO,CAAC,MAAM,CAAC,CAcjB;AAED;;;;;;;;GAQG;AACH,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CA8F/F"}

package/dist/core/agent-cwd.js

@@ -0,0 +1,181 @@
+// Per-agent working directory resolution for the IM context.
+//
+// Both Claude Code and opencode key their per-project memory / history off
+// the spawned process's cwd. When im-hub runs as a systemd service, that cwd
+// is "/" — so every IM thread, every direct-terminal session, and every
+// background scheduler tick all share the SAME global memory bucket. This
+// is the root cause of:
+//
+//   - The IM-only Claude not being able to carry a distinct CLAUDE.md role
+//   - The user's terminal MEMORY.md getting polluted by IM auto-saves
+//   - opencode's AGENTS.md being unable to differ between IM and terminal
+//
+// Fix: when we detect we're in an IM call (threadId + platform both set),
+// pin the agent into a stable per-agent workspace under
+// `~/.im-hub-workspaces/<agent>/`. Non-IM calls (web UI, scheduler,
+// intent-llm judge) keep the inherited cwd, preserving prior behavior.
+//
+// Override path: `IMHUB_<AGENT>_CWD` env var beats everything (e.g.
+// `IMHUB_CLAUDE_CODE_CWD=/srv/foo`). Useful for migration tests and for
+// future per-tenant deployments.
+import { join } from 'node:path';
+import { mkdir, writeFile, access } from 'node:fs/promises';
+import { AGIM_WORKSPACES } from './agim-paths.js';
+/** Root for all per-agent IM workspaces. Kept stable so memory persists.
+ *  Honors the legacy `IMHUB_WORKSPACES_ROOT` env override; otherwise
+ *  resolves via core/agim-paths (which prefers `~/.agim-workspaces/` but
+ *  falls back to the legacy `~/.im-hub-workspaces/` on 0.x systems). */
+export function imhubWorkspacesRoot() {
+    return process.env.IMHUB_WORKSPACES_ROOT || AGIM_WORKSPACES;
+}
+/** Default cwd for a given agent under the workspaces root. */
+export function defaultAgentCwd(agentName) {
+    return join(imhubWorkspacesRoot(), agentName);
+}
+/** Env var name for an explicit override on a given agent. */
+function envKeyFor(agentName) {
+    // claude-code -> IMHUB_CLAUDE_CODE_CWD
+    return `IMHUB_${agentName.replace(/-/g, '_').toUpperCase()}_CWD`;
+}
+/**
+ * Resolve the cwd to spawn an agent CLI in.
+ *
+ * Decision order:
+ *   1. Env override `IMHUB_<AGENT>_CWD` always wins.
+ *   2. If we're in an IM context (threadId + platform both present), pin to
+ *      `~/.im-hub-workspaces/<agent>/`.
+ *   3. Otherwise return undefined → adapter inherits im-hub's cwd. This
+ *      keeps web/scheduler/intent-llm judge paths exactly as they were.
+ */
+export function resolveAgentCwd(agentName, opts) {
+    const explicit = process.env[envKeyFor(agentName)];
+    if (explicit)
+        return explicit;
+    if (opts.threadId && opts.platform) {
+        return defaultAgentCwd(agentName);
+    }
+    return undefined;
+}
+/**
+ * Idempotent: create the workspace dir and seed initial CLAUDE.md / AGENTS.md
+ * if they don't exist. Existing files are NEVER overwritten — the user is free
+ * to evolve them by hand or have the agent itself rewrite them via
+ * auto-memory.
+ *
+ * Honors IMHUB_<AGENT>_CWD overrides — if set, we bootstrap THAT path
+ * instead. Skips bootstrapping when the override is empty / unset and we
+ * compute it from defaultAgentCwd; either way the resolved path is what
+ * spawnStream will pass as cwd.
+ */
+export async function ensureAgentWorkspace(agentName, seed) {
+    const explicit = process.env[envKeyFor(agentName)];
+    const dir = explicit || defaultAgentCwd(agentName);
+    await mkdir(dir, { recursive: true });
+    const seedPath = join(dir, seed.filename);
+    try {
+        await access(seedPath);
+        // already exists — leave the user's customizations alone
+    }
+    catch {
+        await writeFile(seedPath, seed.content, 'utf8');
+    }
+    return dir;
+}
+/**
+ * Bootstrap the workspaces for the two built-in CLI agents we ship by
+ * default. Safe to call multiple times. Returns a summary suitable for
+ * logging.
+ *
+ * Other agents (codex, copilot, ACP-imported) don't need cwd isolation
+ * either because they don't have per-cwd memory, or because they're
+ * remote — they'll pass through with cwd undefined like before.
+ */
+export async function bootstrapAgentWorkspaces() {
+    const result = [];
+    const claudeSeed = `# Claude Code — IM 入口工作区
+
+> 这是 im-hub 通过 IM 唤起 Claude Code 时的专用工作目录。
+> 与你直接在终端里跑 \`claude\` 时使用的全局配置 (~/.claude/CLAUDE.md) 隔离。
+>
+> 文件位置：${defaultAgentCwd('claude-code')}/CLAUDE.md
+
+## 角色
+
+你是被 IM 入口（微信 / Telegram / Feishu / Discord 等）唤起的 Claude Code。
+回复要简洁、可在 IM 里阅读，避免大段代码块除非用户明确要求代码。
+
+## 长期项目记忆
+
+- 你自己的 auto-memory 落在本目录的 \`memory/MEMORY.md\`
+- 长期项目档案手写在本目录下，由 Claude 自己读取与维护
+- 与终端里的 Claude 互不干扰，可以分头记录不同侧重
+
+## 注意
+
+- 当前 cwd 不是真正的代码仓库；要查代码请去 /root/workspace/...
+- IM 单条消息的硬超时是 30 分钟（im-hub 层），长任务必须走 bgjob
+`;
+    result.push({
+        agent: 'claude-code',
+        dir: await ensureAgentWorkspace('claude-code', { filename: 'CLAUDE.md', content: claudeSeed }),
+    });
+    const opencodeSeed = `# OpenCode — IM 入口工作区
+
+> 这是 im-hub 通过 IM 唤起 opencode 时的专用工作目录。
+> 与你直接在终端里跑 \`opencode\` 时使用的全局配置 (~/.config/opencode/AGENTS.md) 隔离。
+>
+> 文件位置：${defaultAgentCwd('opencode')}/AGENTS.md
+
+## 角色
+
+你是被 IM 入口（微信 / Telegram / Feishu / Discord 等）唤起的 opencode。
+回复要简洁、可在 IM 里阅读，避免大段代码块除非用户明确要求代码。
+
+## 长期项目记忆
+
+- 长期项目档案手写在本目录下的 PROJECT.md，由 opencode 自己读取与维护
+- 与终端里的 opencode 互不干扰，可以分头记录不同侧重
+
+## 注意
+
+- 当前 cwd 不是真正的代码仓库；要查代码请去 /root/workspace/...
+- IM 单条消息的硬超时是 30 分钟（im-hub 层），长任务必须走 bgjob
+`;
+    result.push({
+        agent: 'opencode',
+        dir: await ensureAgentWorkspace('opencode', { filename: 'AGENTS.md', content: opencodeSeed }),
+    });
+    const codexSeed = `# Codex — IM 入口工作区
+
+> 这是 im-hub 通过 IM 唤起 OpenAI Codex CLI 时的专用工作目录。
+> 与你直接在终端里跑 \`codex\` 时使用的全局配置 (~/.codex/config.toml) 隔离。
+>
+> 文件位置：${defaultAgentCwd('codex')}/AGENTS.md
+
+## 角色
+
+你是被 IM 入口（微信 / Telegram / Feishu / Discord 等）唤起的 Codex。
+回复要简洁、可在 IM 里阅读，避免大段代码块除非用户明确要求代码。
+
+## 长期项目记忆
+
+- 长期项目档案手写在本目录下（PROJECT.md 或自定义文件名）
+- 本目录下的 \`memory/\` 目录用于手写笔记，与 Claude / opencode 工作区互不干扰
+- 与终端里的 codex 互不干扰，可以分头记录不同侧重
+
+## 注意
+
+- 当前 cwd 不是真正的代码仓库；要查代码请去 /root/workspace/...
+- IM 单条消息的硬超时是 30 分钟（im-hub 层），长任务必须走 bgjob
+- bgjob 数据目录：~/.codex/bgjobs/（与 claude / opencode 隔离）
+  使用方式：\`/root/.codex/scripts/bgjob start <name> -- <cmd...>\`
+- AGENTS.md 与 opencode 同名但工作区分离 —— codex 只读本目录的 AGENTS.md，
+  不会读 ~/.im-hub-workspaces/opencode/AGENTS.md
+`;
+    result.push({
+        agent: 'codex',
+        dir: await ensureAgentWorkspace('codex', { filename: 'AGENTS.md', content: codexSeed }),
+    });
+    return result;
+}
+//# sourceMappingURL=agent-cwd.js.map

package/dist/core/agent-cwd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-cwd.js","sourceRoot":"","sources":["../../src/core/agent-cwd.ts"],"names":[],"mappings":"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"}