agim-cli 1.2.45 → 1.2.49

package/dist/plugins/agents/cursor/index.js

@@ -0,0 +1,290 @@
+// Cursor (`cursor-agent`) agent adapter.
+//
+// CLI surface (observed from `cursor-agent --help` on v2026.05.20+):
+//   cursor-agent [flags] [prompt...]              # interactive if TTY
+//   cursor-agent --print "<prompt>"               # headless single-shot
+//   cursor-agent --print --output-format stream-json "<prompt>"
+//     ↓
+//     newline-delimited events: system.init, user, assistant, tool_call,
+//     result. Each event carries `session_id` (constant throughout a run).
+//   cursor-agent --print --resume <chatId> ...    # resume an existing chat
+//   cursor-agent --print --continue ...           # resume the most recent
+//   cursor-agent --print --plan ...               # plan mode (read-only)
+//   cursor-agent --print --mode ask ...           # Q&A mode (read-only)
+//   cursor-agent --print --model <id> ...         # override model
+//   cursor-agent create-chat                      # pre-create a chat, get id
+//
+// Permissions model:
+//   - cursor reads MCP servers from `~/.cursor/mcp.json` (global) or
+//     `.cursor/mcp.json` (per-workspace). On adapter init we write the
+//     global file with an `imhub` entry pointing at the shared MCP sidecar
+//     (the same one claude-code uses). Subsequent tool calls hop through
+//     agim's approval-bus exactly like claude-code's.
+//   - `--approve-mcps` auto-approves MCP servers (no per-launch prompt;
+//     individual `mcp__imhub__*` calls still gate on agim's approval-bus).
+//   - `--force` (alias `--yolo`) bypasses cursor's own per-tool confirmation
+//     for shell / write / delete actions. Required for headless IM use —
+//     there's no interactive TTY to answer prompts. Operators can still
+//     deny via agim policy or by editing `~/.cursor/cli-config.json`'s
+//     `permissions.deny` array.
+//   - `--trust` marks the workspace as trusted; otherwise cursor refuses
+//     to start in `--print` mode against an unknown directory.
+//
+// Session lifecycle:
+//   - First call: spawn without `--resume`. The first event we see on
+//     stdout is `system.init` which carries `session_id`. inspectEvent
+//     calls `opts.onAgentSessionId(id)` so cli persists it on the agim
+//     Session row.
+//   - Subsequent calls: spawn with `--resume <session_id>`. cursor
+//     reopens the chat and appends the new turn.
+//   - `/new` clears the agim session row's cursor id; next run starts
+//     fresh.
+//
+// Authentication:
+//   - cursor stores credentials at `~/.cursor/cli-config.json` after
+//     `cursor-agent login`. agim runs as the same user, so the file is
+//     readable out of the box — no env-var dance needed. Set
+//     CURSOR_API_KEY env if the operator prefers a token over OAuth.
+//
+// Default model:
+//   - We respect whatever is set in `~/.cursor/cli-config.json`'s
+//     `model.modelId`. Operators override per-call via `opts.model` (e.g.
+//     `/cs model sonnet-4-thinking <prompt>`) or globally via cli-config.
+import { randomUUID } from 'node:crypto';
+import { existsSync, statSync } from 'node:fs';
+import { mkdir } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { AgentBase } from '../../../core/agent-base.js';
+import { approvalBus } from '../../../core/approval-bus.js';
+import { resolveAgentCwd } from '../../../core/agent-cwd.js';
+import { crossSpawn } from '../../../utils/cross-platform.js';
+import { logger as rootLogger } from '../../../core/logger.js';
+import { ensureImhubMcp } from './ensure-mcp-config.js';
+const log = rootLogger.child({ component: 'agent.cursor' });
+const DEFAULT_BIN = 'cursor-agent';
+/** Path to the imhub MCP sidecar JS file. Shared with claude-code /
+ *  antigravity — the protocol surface is host-agnostic. */
+function sidecarPath() {
+    // From dist/plugins/agents/cursor/index.js the sidecar is at:
+    //   ../claude-code/mcp-approval-server.js
+    return new URL('../claude-code/mcp-approval-server.js', import.meta.url).pathname;
+}
+export class CursorAdapter extends AgentBase {
+    name = 'cursor';
+    aliases = ['cs', 'cur'];
+    kind = 'cli';
+    /** Cached bin path resolution. null = "haven't probed";
+     *  undefined = "probed, not found, fall back to bare name". */
+    resolvedBin = null;
+    /** Have we written the imhub MCP entry to ~/.cursor/mcp.json yet this
+     *  agim process lifetime? Saves the disk hit on every send. Reset on
+     *  agim restart so the next run rewrites with the fresh socket path. */
+    mcpReady = false;
+    get commandName() {
+        const override = process.env.IMHUB_CURSOR_BIN;
+        if (override)
+            return override;
+        if (this.resolvedBin !== null)
+            return this.resolvedBin ?? DEFAULT_BIN;
+        // The official installer puts the bin at `~/.local/bin/cursor-agent`
+        // (XDG user-local). systemd-launched agim doesn't source the user's
+        // shell rc, so PATH lookup of bare `cursor-agent` often fails even
+        // when the binary is right there. Probe the known locations.
+        const candidates = [
+            join(homedir(), '.local', 'bin', 'cursor-agent'),
+            '/usr/local/bin/cursor-agent',
+            '/opt/cursor/bin/cursor-agent',
+        ];
+        for (const p of candidates) {
+            try {
+                const s = statSync(p);
+                if (s.isFile() && (s.mode & 0o111) !== 0) {
+                    this.resolvedBin = p;
+                    log.info({ event: 'cursor.bin.resolved', path: p }, 'resolved cursor-agent outside PATH');
+                    return p;
+                }
+            }
+            catch { /* not here */ }
+        }
+        this.resolvedBin = undefined;
+        return DEFAULT_BIN;
+    }
+    buildArgs(prompt, opts) {
+        const args = ['--print', '--output-format', 'stream-json'];
+        // Trust + force are mandatory for headless IM use — cursor refuses
+        // to write / shell otherwise and there's no TTY to answer prompts.
+        // Operators wanting tighter control can use IMHUB_NATIVE_AGENT_DENYLIST
+        // for agim tools and edit `~/.cursor/cli-config.json`'s `permissions.deny`
+        // for cursor-side tool gating.
+        args.push('--trust', '--force', '--approve-mcps');
+        if (opts.model)
+            args.push('--model', opts.model);
+        if (opts.planMode)
+            args.push('--plan');
+        if (opts.agentSessionId && !opts.agentSessionResume) {
+            // First call with this session id — cursor doesn't have a
+            // "--session-id <new>" form like claude-code; the session id is
+            // assigned by cursor and surfaced in system.init. Treat
+            // pre-supplied id as a resume hint.
+            args.push('--resume', opts.agentSessionId);
+        }
+        else if (opts.agentSessionId) {
+            args.push('--resume', opts.agentSessionId);
+        }
+        args.push(prompt);
+        return args;
+    }
+    async prepareCommand(prompt, opts) {
+        let cwd = resolveAgentCwd(this.name, opts);
+        if (cwd) {
+            try {
+                if (!existsSync(cwd))
+                    await mkdir(cwd, { recursive: true });
+            }
+            catch (err) {
+                log.warn({ event: 'cursor.cwd.mkdir_failed', cwd, err: String(err) }, 'falling back to inherited cwd because workspace dir could not be created');
+                cwd = undefined;
+            }
+        }
+        // Append cwd to --workspace so cursor scopes file ops to the per-agent
+        // workspace instead of the systemd cwd ("/").
+        const baseArgs = this.buildArgs(prompt, opts);
+        if (cwd) {
+            // Insert before the prompt (last arg). Order matters for cursor's
+            // commander parser — flags before positional.
+            const promptArg = baseArgs.pop();
+            baseArgs.push('--workspace', cwd, promptArg);
+        }
+        // MCP wiring (one-shot per agim process lifetime).
+        const sockPath = approvalBus.getSocketPath();
+        if (sockPath && !this.mcpReady) {
+            try {
+                await ensureImhubMcp({
+                    command: process.execPath,
+                    args: [sidecarPath()],
+                    env: { IMHUB_APPROVAL_SOCK: sockPath },
+                });
+                this.mcpReady = true;
+            }
+            catch (err) {
+                log.warn({ event: 'cursor.mcp.disabled', err: String(err) }, 'imhub MCP not wired into cursor — agim tools will be invisible to cursor this run');
+            }
+        }
+        // approval-bus registration so mcp__imhub__* tool calls inside the
+        // cursor run resolve to this IM thread.
+        const { threadId, platform, channelId, userId } = opts;
+        const runId = randomUUID();
+        let registered = false;
+        if (sockPath && threadId && platform && channelId) {
+            approvalBus.registerRun(runId, {
+                threadId,
+                platform,
+                userId: userId ?? '',
+                channelId,
+                callerAgent: this.name,
+                ...(typeof opts.parentJobId === 'number' ? { parentJobId: opts.parentJobId } : {}),
+                ...(typeof opts.callDepth === 'number' ? { callDepth: opts.callDepth } : {}),
+            });
+            registered = true;
+            log.info({ event: 'cursor.approval.routed', runId, threadId, platform }, 'cursor run routed via approval-bus');
+        }
+        return {
+            args: baseArgs,
+            cwd,
+            extraEnv: {
+                IMHUB_RUN_ID: runId,
+                // cursor reads CURSOR_API_KEY if set; otherwise falls back to
+                // OAuth creds in ~/.cursor/cli-config.json. Pass HOME through
+                // so systemd-stripped env doesn't break the credential lookup.
+                HOME: process.env.HOME || homedir(),
+            },
+            cleanup: async () => {
+                if (registered)
+                    approvalBus.unregisterRun(runId);
+            },
+        };
+    }
+    /** Pull the assistant text from a single stream-json event. */
+    extractText(event) {
+        const e = event;
+        if (e.type === 'assistant' && e.message?.content) {
+            const parts = [];
+            for (const item of e.message.content) {
+                if (item.type === 'text' && item.text)
+                    parts.push(item.text);
+            }
+            return parts.join('');
+        }
+        // The terminal `result` event carries the aggregated final answer.
+        // We don't double-emit it (assistant events already covered the
+        // text); but if the stream skipped intermediate assistant events for
+        // some reason, result.result is the fallback.
+        return '';
+    }
+    /** Capture `session_id` from system.init AND token usage from result
+     *  events so cli persists session resume + audit log records cost
+     *  (well, tokens — cursor doesn't price client-side). */
+    inspectEvent(event, opts) {
+        const e = event;
+        if (e.type === 'system' && e.subtype === 'init' && typeof e.session_id === 'string') {
+            // Only surface if the caller didn't already pin one — saves a
+            // pointless SQLite write when resuming an existing session.
+            if (!opts.agentSessionId && opts.onAgentSessionId) {
+                try {
+                    opts.onAgentSessionId(e.session_id);
+                    log.info({ event: 'cursor.session.captured', id: e.session_id }, 'captured fresh cursor session id');
+                }
+                catch (err) {
+                    log.debug({ event: 'cursor.session.callback_failed', err: String(err) });
+                }
+            }
+        }
+        if (e.type === 'result' && opts.onUsage && e.usage) {
+            const u = e.usage;
+            const cacheRead = typeof u.cacheReadTokens === 'number' ? u.cacheReadTokens : 0;
+            const cacheWrite = typeof u.cacheWriteTokens === 'number' ? u.cacheWriteTokens : 0;
+            const rawInput = typeof u.inputTokens === 'number' ? u.inputTokens : 0;
+            const tokensInput = rawInput + cacheRead + cacheWrite;
+            const tokensOutput = typeof u.outputTokens === 'number' ? u.outputTokens : 0;
+            const delta = {};
+            if (tokensInput > 0)
+                delta.tokensInput = tokensInput;
+            if (tokensOutput > 0)
+                delta.tokensOutput = tokensOutput;
+            if (delta.tokensInput !== undefined || delta.tokensOutput !== undefined) {
+                try {
+                    opts.onUsage(delta);
+                }
+                catch { /* best-effort */ }
+            }
+            // cursor doesn't surface USD cost client-side; operators see it on
+            // cursor.com/dashboard. costUsd stays unset for cursor turns.
+        }
+    }
+    handleError(_code, stderr, errorMessage) {
+        const combined = `${stderr} ${errorMessage}`;
+        if (/unauthor|sign in|log in|CURSOR_API_KEY/i.test(combined)) {
+            return [
+                '🔐 Cursor 未登录 / 凭据过期。',
+                '   在装有 cursor-agent 的机器跑：`cursor-agent login`',
+                '   或设环境变量 CURSOR_API_KEY=<your-key>',
+            ].join('\n');
+        }
+        return null;
+    }
+    notAvailableMessage() {
+        return ('Cursor CLI 未安装。安装：\n' +
+            '  curl https://cursor.com/install -fsS | bash\n' +
+            '装完后跑一次 `cursor-agent login` 完成首次登录。');
+    }
+    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));
+        });
+    }
+}
+export const cursorAdapter = new CursorAdapter();
+//# sourceMappingURL=index.js.map

package/dist/plugins/agents/cursor/index.js.map

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

package/dist/plugins/agents/native/index.d.ts

@@ -0,0 +1,34 @@
+import type { AgentAdapter } from '../../../core/types.js';
+/** Read <cwd>/AGENTS.md (if present) and prepare it for injection into
+ *  the system prompt. Returns '' on missing file / read failure / empty
+ *  content. Sanitises text length (8000 char cap) and scans for the
+ *  classic prompt-injection signals ("ignore previous instructions",
+ *  "always allow", etc.); when matches are found we still inject (the
+ *  operator likely wrote them deliberately) but log a warn + audit
+ *  hit so post-incident forensics can correlate. Honours
+ *  IMHUB_NATIVE_AGENT_ROLE_FILE for a non-default location. */
+export declare function readOperatorRole(cwd: string): string;
+/**
+ * Extract media attachments from a prompt string. Messenger adapters
+ * (telegram / wechat / discord / feishu / dingtalk) inline a marker like
+ * `[图片附件：/abs/path/to/file.jpg]` or `[image attachment: ...]` when a
+ * user message carries a media payload. The path is already downloaded
+ * to `~/.agim/media/<platform>/...` by the adapter, so we only need to
+ * surface it to vision-capable providers; non-vision providers see the
+ * original text and can still acknowledge the attachment.
+ *
+ * Heuristic-safe: matches absolute paths under common image extensions
+ * + a path-safety check that the file exists. Anything ambiguous (no
+ * extension, file missing, points outside ~/.agim/media) is silently
+ * skipped so we never leak random filesystem paths into a vision call.
+ */
+export declare function parsePromptMedia(prompt: string): Array<{
+    path: string;
+    mime?: string;
+}>;
+export declare const nativeAgentAdapter: AgentAdapter;
+/** Lightweight banner for cli.ts boot log. Lets operators see at a
+ *  glance whether `/cc native` will work before they try it in an IM
+ *  thread. */
+export declare function describeNativeAgent(): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/agents/native/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/plugins/agents/native/index.ts"],"names":[],"mappings":"AAyCA,OAAO,KAAK,EACV,YAAY,EAGb,MAAM,wBAAwB,CAAA;AAyG/B;;;;;;;+DAO+D;AAC/D,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAmBpD;AAgGD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAiCvF;AA4UD,eAAO,MAAM,kBAAkB,EAAE,YAAuC,CAAA;AAExE;;cAEc;AACd,wBAAgB,mBAAmB,IAAI,MAAM,CAI5C"}