agim-cli 1.2.45 → 1.2.49

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

@@ -0,0 +1,598 @@
+// Native AgentAdapter — agim's first in-process LLM agent (Stage 2 sub-PR #4).
+//
+// The native adapter is the **opt-in backup** path: the CLI agents
+// (Claude Code / Codex / OpenCode) keep being the main route for IM
+// users, but operators can now ALSO register a native agent that runs
+// entirely inside agim — no subprocess spawn, no claude.json, just
+// LLM API call + the agent loop from sub-PR #3.
+//
+// Concrete shape of one IM turn driven by this adapter:
+//
+//   user message
+//      ↓
+//   AgentAdapter.sendPrompt(sessionId, prompt, history, opts)
+//      ↓
+//   1. resolveProvider(role)             ← pick the LLM (role-based)
+//   2. build LlmMessage[] from history+prompt
+//   3. assemble dispatcher
+//        = combineDispatchers(builtin, mcp)
+//   4. assemble approval gate (from operator policy config)
+//   5. runAgentLoop(...) — multi-iter tool loop
+//   6. yield the final text as a SINGLE chunk (buffered) back to the
+//      adapter's AsyncGenerator contract
+//
+// Stage 2 sub-PR #4 deliberately ships:
+//   - one LLM call per IM turn (no streaming of incremental thinking
+//     to IM; that's a separate feature)
+//   - sequential tool execution within each iteration (matches
+//     agent-loop's current contract)
+//   - policy-based approval (mode=allow-list by default; operators
+//     opt into looser modes via env)
+//   - the existing tryIntrospect-style usage / cost audit accounting
+//
+// Out of scope here (covered later):
+//   - IM-interactive approval cards (button taps / y-n IM reply); the
+//     policy gate is sufficient for the initial release
+//   - Streaming partial responses to IM (we already accumulate the
+//     final text; partial streaming wants viewer-routing support too)
+//   - Session persistence specific to native (we reuse the caller-
+//     supplied history; agim's regular session manager handles
+//     persistence across turns)
+import { logger as rootLogger } from '../../../core/logger.js';
+import { logInvocation } from '../../../core/audit-log.js';
+import { runAgentLoop, buildMcpDispatcher, combineDispatchers, getProvider, getAllMcpTools, } from '../../../core/llm/index.js';
+import { buildBuiltinDispatcher, getBuiltinTools, } from '../../../core/llm/builtin-dispatcher.js';
+import { buildPolicyApprovalGate, describePolicy, } from '../../../core/llm/policy-approval-gate.js';
+import { buildImhubDispatcher, getImhubTools, } from '../../../core/llm/imhub-dispatcher.js';
+import { listSkills } from '../../../core/skills/loader.js';
+import { describeRegistry as describeMcpRegistry } from '../../../core/llm/mcp-registry.js';
+import { resolveAgentCwd, defaultAgentCwd } from '../../../core/agent-cwd.js';
+import { handlePushOp } from '../../../core/push-rpc.js';
+import { maybeCompactHistory } from '../../../core/llm/auto-compact.js';
+import { existsSync as fsExistsSync, statSync as fsStatSync, readFileSync as fsReadFileSync } from 'node:fs';
+import { resolve as pathResolve, sep as pathSep, join as pathJoin } from 'node:path';
+import { sanitizeForInjection, scanForInjectionAttempts } from '../../../core/prompt-injection-guard.js';
+const log = rootLogger.child({ component: 'native-agent' });
+/**
+ * v1.2.47 — system prompt is rebuilt per IM turn so the model sees:
+ *   - which LLM backend + role it's actually running on
+ *   - the agim process working directory (no per-thread cwd today)
+ *   - the live skill roster (names + one-line descriptions), with the
+ *     hint to call mcp__imhub__read_skill for full bodies
+ *   - external MCP servers currently connected
+ *
+ * Before v1.2.47 the prompt was a 4-line generic string; users
+ * complained that asking "what model are you" / "what skills do you
+ * have" got non-answers ("I don't know; ask the operator"). The
+ * builder closes that information gap without leaking secrets — every
+ * field surfaced here is operator-configured and non-sensitive.
+ */
+function buildSystemPrompt(provider, role, cwd) {
+    const skills = listSkills();
+    const skillsBlock = skills.length
+        ? skills.map((s) => `  - ${s.name}: ${s.description}`).join('\n')
+        : '  (no skill cards loaded; see docs/skills.md to add one)';
+    const mcpReg = describeMcpRegistry();
+    const externalMcp = mcpReg.servers.length
+        ? mcpReg.servers
+            .map((s) => `  - ${s.name} (${s.connected ? `${s.toolCount} tools` : `disconnected${s.error ? ': ' + s.error : ''}`})`)
+            .join('\n')
+        : '  (none configured)';
+    const lines = [];
+    // Operator-supplied role definition. Reads <cwd>/AGENTS.md (seeded by
+    // bootstrapAgentWorkspaces) and prepends it as a role block. Lets
+    // operators customise the agent's identity, tone, and house rules
+    // without touching code. Sanitised + scanned for prompt-injection
+    // patterns (best-effort warn; never blocks turn).
+    const opRole = readOperatorRole(cwd);
+    if (opRole) {
+        lines.push('[operator role definition]');
+        lines.push(opRole);
+        lines.push('[/operator role definition]');
+        lines.push('');
+    }
+    lines.push(`You are agim native — agim's in-process LLM agent talking to a user over an IM platform.`, ``, `Runtime:`, `  Backend:           ${provider.providerType}:${provider.name}`, `  Role:              ${role}`, `  Working directory: ${cwd}`, ``, `Tools available beyond the four native built-ins (echo / now / sleep / random_uuid):`, `  - agim built-in MCP tools (mcp__imhub__*): read_skill, list_skills, save_memo, search_memos, update_memo, delete_memo, push_message, ask_user, call_agent`, `  - External MCP servers configured by the operator:`, externalMcp, ``, `Available skill cards (call mcp__imhub__read_skill('<name>') for the full body):`, skillsBlock, ``, `Guidance:`, `  - Be terse; avoid filler. Prefer tool use over guessing.`, `  - When uncertain, call mcp__imhub__ask_user(question, choices[]) instead of free-form back-and-forth.`, `  - When the user references something they told the bot before, search memos via mcp__imhub__search_memos.`, `  - When a heavy task fits another agent better (e.g. code editing → claude-code), use mcp__imhub__call_agent.`);
+    return lines.join('\n');
+}
+/** 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 function readOperatorRole(cwd) {
+    const override = process.env.IMHUB_NATIVE_AGENT_ROLE_FILE;
+    const path = override && override.length > 0 ? override : pathJoin(cwd, 'AGENTS.md');
+    if (!fsExistsSync(path))
+        return '';
+    let raw = '';
+    try {
+        raw = fsReadFileSync(path, 'utf-8');
+    }
+    catch {
+        return '';
+    }
+    const trimmed = raw.trim();
+    if (!trimmed)
+        return '';
+    try {
+        const scan = scanForInjectionAttempts(trimmed);
+        if (scan.suspicious) {
+            log.warn({
+                event: 'native.role_file.injection_signals',
+                file: path,
+                matched: scan.matched,
+            }, `${path} contains prompt-injection-style language; injecting anyway — operator review recommended`);
+        }
+    }
+    catch { /* scan is best-effort */ }
+    return sanitizeForInjection(trimmed, 8000);
+}
+/** Role priority for picking which LLM backend powers the native chat
+ *  turn. First found wins. Operators can override the role via
+ *  `IMHUB_NATIVE_AGENT_ROLE`. */
+const DEFAULT_ROLE_FALLBACK = ['native-chat', 'cheap'];
+function resolveRole() {
+    const raw = process.env.IMHUB_NATIVE_AGENT_ROLE;
+    if (raw?.trim())
+        return [raw.trim(), ...DEFAULT_ROLE_FALLBACK];
+    return DEFAULT_ROLE_FALLBACK.slice();
+}
+function pickProvider() {
+    for (const role of resolveRole()) {
+        const p = getProvider(role);
+        if (p)
+            return { provider: p, role };
+    }
+    return null;
+}
+/**
+ * Build the ordered fallback chain of (provider, role) pairs the agent
+ * loop will retry against. The chain begins with whatever pickProvider
+ * picks (operator's primary), then appends each remaining role that has
+ * a registered provider — de-duplicated by provider name so we never
+ * retry the exact same backend.
+ *
+ * The loop driver in sendPrompt walks this chain when an iteration ends
+ * with a TRANSIENT provider error (HTTP 5xx / network reset / 408).
+ * Non-transient errors (4xx misconfig, schema validation) end the turn
+ * immediately — retrying won't help and just multiplies cost.
+ */
+function pickProviderChain() {
+    const chain = [];
+    const seen = new Set();
+    for (const role of resolveRole()) {
+        const p = getProvider(role);
+        if (!p)
+            continue;
+        if (seen.has(p.name))
+            continue;
+        seen.add(p.name);
+        chain.push({ provider: p, role });
+    }
+    return chain;
+}
+/** Resolve the operator's approval policy from env. Defaults to
+ *  `allow-list` mode with NO allow entries — equivalent to "no tool
+ *  calls". Operators that want native to actually call tools must
+ *  configure at least one of these env vars:
+ *
+ *    IMHUB_NATIVE_AGENT_MODE=allow-all|read-only|allow-list|deny-all
+ *    IMHUB_NATIVE_AGENT_AUTOALLOW=tool1,tool2,...
+ *    IMHUB_NATIVE_AGENT_DENYLIST=tool1,...
+ *
+ *  The `read-only` mode is the recommended starter — it accepts every
+ *  tool whose name starts/ends with a read-only verb (`read_*` /
+ *  `list_*` / `get_*` / etc.) and the four built-ins
+ *  (`native_echo`/`now`/`random_uuid` — `sleep_ms` excluded).
+ */
+function resolvePolicy() {
+    const mode = (process.env.IMHUB_NATIVE_AGENT_MODE || 'allow-list').toLowerCase();
+    const autoAllow = splitEnvList(process.env.IMHUB_NATIVE_AGENT_AUTOALLOW);
+    const denyList = splitEnvList(process.env.IMHUB_NATIVE_AGENT_DENYLIST);
+    // Allow the 3 safe native builtins + all first-party imhub MCP tools by
+    // default. The imhub tools are in-process (no external API cost, no
+    // network side-effects beyond what the IM bridge would do anyway) and
+    // are part of agim's own surface — denying them by default is the same
+    // class of misconfiguration as denying agim itself. Operators can
+    // remove individual entries via IMHUB_NATIVE_AGENT_DENYLIST.
+    const defaultBuiltins = [
+        'native_echo', 'native_now', 'native_random_uuid',
+        'mcp__imhub__read_skill', 'mcp__imhub__list_skills',
+        'mcp__imhub__save_memo', 'mcp__imhub__search_memos',
+        'mcp__imhub__update_memo', 'mcp__imhub__delete_memo',
+        'mcp__imhub__push_message', 'mcp__imhub__ask_user',
+        'mcp__imhub__call_agent',
+    ];
+    const effectiveAllow = mode === 'allow-list'
+        ? Array.from(new Set([...autoAllow, ...defaultBuiltins]))
+        : autoAllow;
+    return { mode, autoAllow: effectiveAllow, denyList };
+}
+function splitEnvList(raw) {
+    if (!raw)
+        return [];
+    return raw.split(',').map((s) => s.trim()).filter(Boolean);
+}
+/** Are we configured AT ALL to make tool calls? Reflected in startup
+ *  log + onboarding hints so the operator notices when they ship
+ *  `agents:['native']` without configuring a backend. */
+function isConfigured() {
+    return pickProvider() !== null;
+}
+/**
+ * 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 function parsePromptMedia(prompt) {
+    if (!prompt)
+        return [];
+    // Match both Chinese 图片附件 marker and English "image attachment".
+    // Capture group is the path between `：`/`: ` and `]`.
+    const re = /\[(?:图片附件|image attachment)[：:]\s*([^\]]+)\]/g;
+    const out = [];
+    const home = process.env.HOME || '/root';
+    const mediaRootRaw = process.env.IMHUB_MEDIA_ROOT || `${home}/.agim/media`;
+    // Normalise media root once so the prefix check works regardless of
+    // trailing slashes / dotted segments in the env override.
+    const mediaRoot = pathResolve(mediaRootRaw);
+    const mediaPrefix = mediaRoot.endsWith(pathSep) ? mediaRoot : mediaRoot + pathSep;
+    let m;
+    while ((m = re.exec(prompt)) !== null) {
+        const rawPath = (m[1] || '').trim();
+        if (!rawPath)
+            continue;
+        // Path-safety: must be absolute AND resolve to a real file UNDER
+        // the media root. Use path.resolve + sep-aware prefix check so
+        // siblings like `/root/.agim/media-evil/x` and traversals like
+        // `/root/.agim/media/../etc/x` are rejected.
+        if (!rawPath.startsWith('/'))
+            continue;
+        const normalised = pathResolve(rawPath);
+        if (normalised !== mediaRoot && !normalised.startsWith(mediaPrefix))
+            continue;
+        try {
+            if (!fsExistsSync(normalised))
+                continue;
+            if (!fsStatSync(normalised).isFile())
+                continue;
+        }
+        catch {
+            continue;
+        }
+        // Image-only for v1; ignore other extensions to keep providers happy.
+        const lower = normalised.toLowerCase();
+        if (!/\.(jpg|jpeg|png|webp|gif)$/.test(lower))
+            continue;
+        out.push({ path: normalised });
+    }
+    return out;
+}
+/**
+ * Tool-call heartbeat helper. Solves the "agim 没反应" anxiety during
+ * long tool calls (research-shaped tools / call_agent A2A turns can
+ * run > 10s under the 30-minute hard timeout).
+ *
+ * Behaviour:
+ *   - When a tool call's onToolStart fires, schedule a one-shot push
+ *     to the IM thread after IMHUB_NATIVE_HEARTBEAT_MS (default 6000).
+ *   - When the call's onToolEnd fires first, cancel the pending push.
+ *   - shutdown() clears any still-pending timers (turn finished cleanly).
+ *
+ * Suppression: handlePushOp uses the standard notification-evaluator
+ * gate + the per-user rate limit (10/min default). The heartbeat is
+ * intentionally short ("🔧 调用工具 X 中…") so the gate's "low signal"
+ * rule rarely drops it; if operators want them muted entirely, set
+ * IMHUB_NATIVE_HEARTBEAT_MS=0.
+ */
+function buildHeartbeats(runCtx) {
+    // Tool-level pulse: tools that take longer than IMHUB_NATIVE_HEARTBEAT_MS
+    // (default 6000) push a one-shot "🔧 调用工具 X 中…" so the user knows
+    // why the bot has gone quiet. Cancelled on tool end. Set 0 to disable.
+    const rawDelay = parseInt(process.env.IMHUB_NATIVE_HEARTBEAT_MS || '6000', 10);
+    const toolDelayMs = Number.isFinite(rawDelay) && rawDelay > 0 ? rawDelay : 0;
+    // Turn-level pulse: every IMHUB_NATIVE_TURN_HEARTBEAT_MS (default 180_000
+    // = 3 min) since turn start, push a "⏳ 还在处理（已 Nm）..." so a multi-
+    // step research turn that runs many sub-agents reassures the user it's
+    // still alive even between tool calls. Set 0 to disable. The first
+    // pulse fires after delayMs, NOT immediately, so short turns stay silent.
+    const rawTurnMs = parseInt(process.env.IMHUB_NATIVE_TURN_HEARTBEAT_MS || '180000', 10);
+    const turnDelayMs = Number.isFinite(rawTurnMs) && rawTurnMs > 0 ? rawTurnMs : 0;
+    const pending = new Map();
+    const startedAt = Date.now();
+    let turnTimer = null;
+    if (turnDelayMs > 0) {
+        turnTimer = setInterval(() => {
+            const elapsedMin = Math.round((Date.now() - startedAt) / 60_000);
+            void handlePushOp({ text: `⏳ 还在处理（已 ${elapsedMin}m）…` }, runCtx).catch(() => { });
+        }, turnDelayMs);
+    }
+    const shutdown = () => {
+        for (const t of pending.values())
+            clearTimeout(t);
+        pending.clear();
+        if (turnTimer) {
+            clearInterval(turnTimer);
+            turnTimer = null;
+        }
+    };
+    const noop = () => { };
+    if (toolDelayMs === 0)
+        return { hooks: { onToolStart: noop, onToolEnd: noop }, shutdown };
+    return {
+        hooks: {
+            onToolStart(call) {
+                const timer = setTimeout(() => {
+                    void handlePushOp({ text: `🔧 调用工具 \`${call.name}\` 中…（已 ${Math.round(toolDelayMs / 1000)}s）` }, runCtx).catch(() => { });
+                    pending.delete(call.id);
+                }, toolDelayMs);
+                pending.set(call.id, timer);
+            },
+            onToolEnd(call) {
+                const t = pending.get(call.id);
+                if (t) {
+                    clearTimeout(t);
+                    pending.delete(call.id);
+                }
+            },
+        },
+        shutdown,
+    };
+}
+// ─── AgentAdapter implementation ─────────────────────────────────────
+class NativeAgentAdapter {
+    name = 'native';
+    aliases = ['llm', 'native-llm', 'na'];
+    kind = 'in-process';
+    /** One-line UI hint surfaced by `/agents`: which LLM role + backend
+     *  currently powers this adapter. Returns undefined when not
+     *  configured (caller renders 'NOT CONFIGURED' elsewhere). */
+    describe() {
+        const picked = pickProvider();
+        if (!picked)
+            return undefined;
+        // 'role -> vendor:backend' so a glance at /agents tells you which
+        // LLM is wired without opening config.json.
+        return `role=${picked.role} -> ${picked.provider.providerType}:${picked.provider.name}`;
+    }
+    async isAvailable() {
+        return isConfigured();
+    }
+    async *sendPrompt(sessionId, prompt, history = [], opts = {}) {
+        const picked = pickProvider();
+        if (!picked) {
+            const msg = '❌ native agent: no LLM backend configured for role `native-chat` or `cheap`. Add one in `~/.agim/config.json` `llmBackends`/`llmRoles` (see docs/llm-backends.md).';
+            yield msg;
+            return;
+        }
+        const { provider, role } = picked;
+        // Build the message array. The native loop accepts a system message
+        // either as the first element OR via systemPrompt; we go with the
+        // dedicated field so user-supplied history doesn't get clipped by
+        // a synthetic system message.
+        const messages = [];
+        for (const m of history) {
+            // ChatMessage role is 'user' | 'assistant'; both map straight
+            // through. Skip empty content to keep prompts compact.
+            if (!m.content)
+                continue;
+            messages.push({ role: m.role, content: m.content });
+        }
+        // Parse `[图片附件：/path/to/file]` / `[image attachment: ...]` markers
+        // that messenger adapters inline into the prompt. Vision-capable
+        // providers will encode them as image_url blocks; others just see
+        // the original text and the model can acknowledge "an image was
+        // attached at <path>" without inspecting bytes.
+        const userMedia = parsePromptMedia(prompt);
+        messages.push({ role: 'user', content: prompt, ...(userMedia.length > 0 ? { media: userMedia } : {}) });
+        // Auto-compact long chats before the provider call. Op-out via
+        // IMHUB_NATIVE_COMPACT_TRIGGER_CHARS=0. Failure mode is no-op.
+        const compact = await maybeCompactHistory(messages);
+        const effectiveMessages = compact.messages;
+        if (compact.compacted) {
+            log.info({
+                event: 'native.compact.applied',
+                sessionId,
+                originalChars: compact.originalChars,
+                summaryChars: compact.summaryChars,
+                collapsedCount: compact.collapsedCount,
+            });
+        }
+        // Compose dispatcher: built-in first (so a stray MCP server with
+        // a colliding tool name doesn't shadow `native_now` etc.), then
+        // imhub built-ins (skills / memo / push / ask_user / call_agent),
+        // then external MCP. v1.2.47 added the imhub layer so native sees
+        // exactly the same mcp__imhub__* surface claude-code does via the
+        // MCP sidecar.
+        const imhubCtx = {
+            platform: opts.platform || 'native-agent',
+            channelId: opts.channelId || 'default',
+            threadId: opts.threadId || sessionId,
+            userId: opts.userId || 'unknown',
+            callerAgent: 'native',
+            callerDepth: opts.callDepth ?? 0,
+        };
+        const dispatch = combineDispatchers(buildBuiltinDispatcher(), buildImhubDispatcher(imhubCtx), buildMcpDispatcher());
+        // Compose tool list the same way (built-in → imhub → external MCP).
+        // Provider tool roster wins on duplicate names via "later
+        // definition wins" semantics inside the provider, but our naming
+        // is namespaced (`native_*`, `mcp__imhub__*`, `mcp_<server>_*`)
+        // so collisions are not expected in practice.
+        const tools = [
+            ...getBuiltinTools(),
+            ...getImhubTools(),
+            ...getAllMcpTools(),
+        ];
+        const policy = resolvePolicy();
+        const approve = buildPolicyApprovalGate(policy);
+        const startedAt = Date.now();
+        log.info({
+            event: 'native.turn.start',
+            sessionId,
+            role,
+            backend: provider.name,
+            policy: describePolicy(policy),
+            tools: tools.length,
+            platform: opts.platform,
+            threadId: opts.threadId,
+        });
+        // Resolve native's working directory the same way claude-code does:
+        // IM calls (threadId + platform set) pin to ~/.agim-workspaces/native/
+        // so the agent has a stable, isolated home for any future filesystem
+        // tools and AGENTS.md guidance. Out-of-IM calls (web, scheduler) fall
+        // back to defaultAgentCwd so the prompt always reports a real path
+        // rather than systemd's '/'.
+        const cwd = resolveAgentCwd('native', opts) || defaultAgentCwd('native');
+        const traceId = `native-${sessionId}-${Date.now()}`;
+        // Wall-clock cap for the agent loop. agim's IM-layer enforces a 30-
+        // minute hard ceiling per turn (DEFAULT_TIMEOUT_MS in agent-base.ts);
+        // we set the inner loop a hair below so the loop's own abort fires
+        // with a clean `finishReason='aborted'` BEFORE the outer SIGTERM. The
+        // agent-loop default is a conservative 5 minutes which is far too
+        // short for native turns that orchestrate sub-agents via call_agent
+        // (each hop can run 1-3 minutes); without this override a multi-step
+        // research turn would abort mid-flight even with sub-tasks healthy.
+        // Operator can override via IMHUB_NATIVE_AGENT_TIMEOUT_MS.
+        const nativeTimeoutMs = (() => {
+            const raw = parseInt(process.env.IMHUB_NATIVE_AGENT_TIMEOUT_MS || '', 10);
+            if (Number.isFinite(raw) && raw > 0)
+                return raw;
+            return 28 * 60 * 1000; // 28 min — leaves 2 min of IM-layer headroom
+        })();
+        const heartbeats = buildHeartbeats(imhubCtx);
+        const chain = pickProviderChain();
+        // chain always starts with `picked` from above — index 0 is the
+        // primary; rest are fallbacks. We walk the chain only when the
+        // PREVIOUS attempt ended with a transient provider error and the
+        // turn produced no assistant text yet (so retrying is safe — no
+        // duplicate replies).
+        let result = null;
+        let usedRole = role;
+        let usedProvider = provider;
+        for (let i = 0; i < chain.length; i++) {
+            const candidate = chain[i];
+            usedProvider = candidate.provider;
+            usedRole = candidate.role;
+            result = await runAgentLoop({
+                provider: candidate.provider,
+                systemPrompt: buildSystemPrompt(candidate.provider, candidate.role, cwd),
+                messages: effectiveMessages,
+                tools,
+                dispatch,
+                approve,
+                callOptions: { model: opts.model },
+                timeoutMs: nativeTimeoutMs,
+                signal: opts.signal,
+                audit: {
+                    agent: `llm:${candidate.provider.name}`,
+                    intent: 'native.agent.iter',
+                    userId: opts.userId,
+                    platform: opts.platform || 'native-agent',
+                    traceId,
+                },
+                hooks: heartbeats.hooks,
+            });
+            if (result.finishReason !== 'error')
+                break;
+            const errStr = String(result.error || '');
+            const isTransient = /5\d\d|timeout|ECONN|ETIMEDOUT|fetch failed|socket hang up|408|network/i.test(errStr);
+            const hasText = result.text && result.text.length > 0;
+            if (!isTransient || hasText || i === chain.length - 1)
+                break;
+            log.warn({
+                event: 'native.fallback.next',
+                from: candidate.provider.name,
+                nextIdx: i + 1,
+                err: errStr,
+            }, `provider ${candidate.provider.name} transient-failed; trying next fallback`);
+        }
+        heartbeats.shutdown();
+        if (!result) {
+            // Shouldn't happen — pickProvider above already returned the primary
+            // so the chain has at least one entry. Defensive belt-and-suspenders.
+            yield '❌ native agent: provider chain ended without any attempt';
+            return;
+        }
+        // Per-turn parent audit row that aggregates the iteration rows
+        // already written by runAgentLoop. Lets /tasks#cost sum cost per
+        // turn rather than per iteration.
+        try {
+            logInvocation({
+                traceId,
+                userId: opts.userId ?? '',
+                platform: opts.platform || 'native-agent',
+                agent: this.name,
+                intent: 'native.agent.turn',
+                promptLen: prompt.length,
+                responseLen: result.text.length,
+                durationMs: Date.now() - startedAt,
+                cost: typeof result.usage.costUsd === 'number' ? result.usage.costUsd : 0,
+                success: result.finishReason !== 'error' && result.finishReason !== 'aborted',
+                error: result.error,
+            });
+        }
+        catch { /* audit best-effort */ }
+        // Surface usage to cli's per-session accumulator the same way CLI
+        // adapters do (via opts.onUsage). agim's cost dashboard reads from
+        // the audit table either way, but the in-memory session usage panel
+        // wants it pushed here too.
+        if (opts.onUsage && typeof result.usage.costUsd === 'number') {
+            try {
+                opts.onUsage({ costUsd: result.usage.costUsd });
+            }
+            catch { /* best-effort */ }
+        }
+        log.info({
+            event: 'native.turn.done',
+            sessionId,
+            backend: usedProvider.name,
+            role: usedRole,
+            fellBack: usedProvider.name !== provider.name,
+            finishReason: result.finishReason,
+            iterations: result.iterations,
+            toolCalls: result.toolCalls.length,
+            elapsedMs: Date.now() - startedAt,
+        });
+        // Compose the user-facing reply. Failure modes surface as ASCII
+        // banners so the IM user sees something concrete rather than
+        // silence (and so logs in /tasks#cost have a non-empty
+        // response_len to filter on).
+        let body = result.text;
+        if (result.finishReason === 'error') {
+            body = `❌ native agent error: ${result.error ?? '(no detail)'}`;
+        }
+        else if (result.finishReason === 'max_iterations') {
+            body = '⚠️ native agent hit max iterations without finishing. Try a more focused prompt or raise IMHUB_NATIVE_AGENT_MAX_ITER.';
+        }
+        else if (result.finishReason === 'aborted') {
+            body = '⏹ native agent aborted before completion.';
+        }
+        else if (!body) {
+            body = '(native agent returned an empty response)';
+        }
+        yield body;
+    }
+}
+export const nativeAgentAdapter = new NativeAgentAdapter();
+/** 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 function describeNativeAgent() {
+    const picked = pickProvider();
+    if (!picked)
+        return 'native agent: NOT CONFIGURED (no llmRoles.native-chat / .cheap)';
+    return `native agent: backend=${picked.provider.name} (role=${picked.role}); policy=${describePolicy(resolvePolicy())}`;
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/plugins/agents/native/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,EAAE;AACF,mEAAmE;AACnE,oEAAoE;AACpE,sEAAsE;AACtE,mEAAmE;AACnE,gDAAgD;AAChD,EAAE;AACF,wDAAwD;AACxD,EAAE;AACF,iBAAiB;AACjB,SAAS;AACT,8DAA8D;AAC9D,SAAS;AACT,qEAAqE;AACrE,8CAA8C;AAC9C,2BAA2B;AAC3B,4CAA4C;AAC5C,4DAA4D;AAC5D,gDAAgD;AAChD,qEAAqE;AACrE,yCAAyC;AACzC,EAAE;AACF,wCAAwC;AACxC,qEAAqE;AACrE,wCAAwC;AACxC,+DAA+D;AAC/D,qCAAqC;AACrC,mEAAmE;AACnE,qCAAqC;AACrC,qEAAqE;AACrE,EAAE;AACF,qCAAqC;AACrC,sEAAsE;AACtE,wDAAwD;AACxD,mEAAmE;AACnE,sEAAsE;AACtE,mEAAmE;AACnE,+DAA+D;AAC/D,gCAAgC;AAOhC,OAAO,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,yBAAyB,CAAA;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAC1D,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,EAClB,WAAW,EACX,cAAc,GAIf,MAAM,4BAA4B,CAAA;AACnC,OAAO,EACL,sBAAsB,EACtB,eAAe,GAChB,MAAM,yCAAyC,CAAA;AAChD,OAAO,EACL,uBAAuB,EACvB,cAAc,GAGf,MAAM,2CAA2C,CAAA;AAClD,OAAO,EACL,oBAAoB,EACpB,aAAa,GACd,MAAM,uCAAuC,CAAA;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAA;AAC3D,OAAO,EAAE,gBAAgB,IAAI,mBAAmB,EAAE,MAAM,mCAAmC,CAAA;AAC3F,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AAC7E,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAExD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAA;AACvE,OAAO,EAAE,UAAU,IAAI,YAAY,EAAE,QAAQ,IAAI,UAAU,EAAE,YAAY,IAAI,cAAc,EAAE,MAAM,SAAS,CAAA;AAC5G,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,GAAG,IAAI,OAAO,EAAE,IAAI,IAAI,QAAQ,EAAE,MAAM,WAAW,CAAA;AACpF,OAAO,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,yCAAyC,CAAA;AAExG,MAAM,GAAG,GAAG,UAAU,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC,CAAA;AAE3D;;;;;;;;;;;;;GAaG;AACH,SAAS,iBAAiB,CAAC,QAAqB,EAAE,IAAY,EAAE,GAAW;IACzE,MAAM,MAAM,GAAG,UAAU,EAAE,CAAA;IAC3B,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM;QAC/B,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QACjE,CAAC,CAAC,0DAA0D,CAAA;IAC9D,MAAM,MAAM,GAAG,mBAAmB,EAAE,CAAA;IACpC,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM;QACvC,CAAC,CAAC,MAAM,CAAC,OAAO;aACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,QAAQ,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC;aACtH,IAAI,CAAC,IAAI,CAAC;QACf,CAAC,CAAC,qBAAqB,CAAA;IAEzB,MAAM,KAAK,GAAa,EAAE,CAAA;IAE1B,sEAAsE;IACtE,kEAAkE;IAClE,kEAAkE;IAClE,kEAAkE;IAClE,kDAAkD;IAClD,MAAM,MAAM,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAA;IACpC,IAAI,MAAM,EAAE,CAAC;QACX,KAAK,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAA;QACxC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAClB,KAAK,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAA;QACzC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAChB,CAAC;IAED,KAAK,CAAC,IAAI,CACR,0FAA0F,EAC1F,EAAE,EACF,UAAU,EACV,wBAAwB,QAAQ,CAAC,YAAY,IAAI,QAAQ,CAAC,IAAI,EAAE,EAChE,wBAAwB,IAAI,EAAE,EAC9B,wBAAwB,GAAG,EAAE,EAC7B,EAAE,EACF,sFAAsF,EACtF,6JAA6J,EAC7J,sDAAsD,EACtD,WAAW,EACX,EAAE,EACF,kFAAkF,EAClF,WAAW,EACX,EAAE,EACF,WAAW,EACX,4DAA4D,EAC5D,yGAAyG,EACzG,6GAA6G,EAC7G,gHAAgH,CACjH,CAAA;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACzB,CAAC;AAED;;;;;;;+DAO+D;AAC/D,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAA;IACzD,MAAM,IAAI,GAAG,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC,CAAA;IACpF,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAA;IAClC,IAAI,GAAG,GAAG,EAAE,CAAA;IACZ,IAAI,CAAC;QAAC,GAAG,GAAG,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,EAAE,CAAA;IAAC,CAAC;IAC/D,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAA;IAC1B,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAA;IACvB,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,wBAAwB,CAAC,OAAO,CAAC,CAAA;QAC9C,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,GAAG,CAAC,IAAI,CAAC;gBACP,KAAK,EAAE,oCAAoC;gBAC3C,IAAI,EAAE,IAAI;gBACV,OAAO,EAAE,IAAI,CAAC,OAAO;aACtB,EAAE,GAAG,IAAI,2FAA2F,CAAC,CAAA;QACxG,CAAC;IACH,CAAC;IAAC,MAAM,CAAC,CAAC,yBAAyB,CAAC,CAAC;IACrC,OAAO,oBAAoB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;AAC5C,CAAC;AAED;;iCAEiC;AACjC,MAAM,qBAAqB,GAAa,CAAC,aAAa,EAAE,OAAO,CAAC,CAAA;AAEhE,SAAS,WAAW;IAClB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAA;IAC/C,IAAI,GAAG,EAAE,IAAI,EAAE;QAAE,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,GAAG,qBAAqB,CAAC,CAAA;IAC9D,OAAO,qBAAqB,CAAC,KAAK,EAAE,CAAA;AACtC,CAAC;AAED,SAAS,YAAY;IACnB,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,EAAE,CAAC;QACjC,MAAM,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC,CAAA;QAC3B,IAAI,CAAC;YAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,CAAA;IACrC,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAS,iBAAiB;IACxB,MAAM,KAAK,GAAmD,EAAE,CAAA;IAChE,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAA;IAC9B,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,EAAE,CAAC;QACjC,MAAM,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC,CAAA;QAC3B,IAAI,CAAC,CAAC;YAAE,SAAQ;QAChB,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;YAAE,SAAQ;QAC9B,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;QAChB,KAAK,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAA;IACnC,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,SAAS,aAAa;IACpB,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,YAAY,CAAC,CAAC,WAAW,EAAkB,CAAA;IAChG,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAA;IACxE,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAA;IACtE,wEAAwE;IACxE,oEAAoE;IACpE,sEAAsE;IACtE,uEAAuE;IACvE,kEAAkE;IAClE,6DAA6D;IAC7D,MAAM,eAAe,GAAG;QACtB,aAAa,EAAE,YAAY,EAAE,oBAAoB;QACjD,wBAAwB,EAAE,yBAAyB;QACnD,uBAAuB,EAAE,0BAA0B;QACnD,yBAAyB,EAAE,yBAAyB;QACpD,0BAA0B,EAAE,sBAAsB;QAClD,wBAAwB;KACzB,CAAA;IACD,MAAM,cAAc,GAAG,IAAI,KAAK,YAAY;QAC1C,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,SAAS,EAAE,GAAG,eAAe,CAAC,CAAC,CAAC;QACzD,CAAC,CAAC,SAAS,CAAA;IACb,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,cAAc,EAAE,QAAQ,EAAE,CAAA;AACtD,CAAC;AAED,SAAS,YAAY,CAAC,GAAuB;IAC3C,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAA;IACnB,OAAO,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;AAC5D,CAAC;AAED;;yDAEyD;AACzD,SAAS,YAAY;IACnB,OAAO,YAAY,EAAE,KAAK,IAAI,CAAA;AAChC,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAc;IAC7C,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,CAAA;IACtB,iEAAiE;IACjE,sDAAsD;IACtD,MAAM,EAAE,GAAG,+CAA+C,CAAA;IAC1D,MAAM,GAAG,GAA2C,EAAE,CAAA;IACtD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,CAAA;IACxC,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,GAAG,IAAI,cAAc,CAAA;IAC1E,oEAAoE;IACpE,0DAA0D;IAC1D,MAAM,SAAS,GAAG,WAAW,CAAC,YAAY,CAAC,CAAA;IAC3C,MAAM,WAAW,GAAG,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,GAAG,OAAO,CAAA;IACjF,IAAI,CAAyB,CAAA;IAC7B,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACtC,MAAM,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;QACnC,IAAI,CAAC,OAAO;YAAE,SAAQ;QACtB,iEAAiE;QACjE,+DAA+D;QAC/D,+DAA+D;QAC/D,6CAA6C;QAC7C,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAQ;QACtC,MAAM,UAAU,GAAG,WAAW,CAAC,OAAO,CAAC,CAAA;QACvC,IAAI,UAAU,KAAK,SAAS,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,WAAW,CAAC;YAAE,SAAQ;QAC7E,IAAI,CAAC;YACH,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC;gBAAE,SAAQ;YACvC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,MAAM,EAAE;gBAAE,SAAQ;QAChD,CAAC;QAAC,MAAM,CAAC;YAAC,SAAQ;QAAC,CAAC;QACpB,sEAAsE;QACtE,MAAM,KAAK,GAAG,UAAU,CAAC,WAAW,EAAE,CAAA;QACtC,IAAI,CAAC,4BAA4B,CAAC,IAAI,CAAC,KAAK,CAAC;YAAE,SAAQ;QACvD,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAA;IAChC,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,SAAS,eAAe,CAAC,MAMxB;IAIC,0EAA0E;IAC1E,kEAAkE;IAClE,uEAAuE;IACvE,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,yBAAyB,IAAI,MAAM,EAAE,EAAE,CAAC,CAAA;IAC9E,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAA;IAC5E,0EAA0E;IAC1E,kEAAkE;IAClE,uEAAuE;IACvE,mEAAmE;IACnE,0EAA0E;IAC1E,MAAM,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,8BAA8B,IAAI,QAAQ,EAAE,EAAE,CAAC,CAAA;IACtF,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAA;IAE/E,MAAM,OAAO,GAAG,IAAI,GAAG,EAAyC,CAAA;IAChE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;IAC5B,IAAI,SAAS,GAA0C,IAAI,CAAA;IAE3D,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;QACpB,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE;YAC3B,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,GAAG,MAAM,CAAC,CAAA;YAChE,KAAK,YAAY,CACf,EAAE,IAAI,EAAE,YAAY,UAAU,KAAK,EAAE,EACrC,MAAM,CACP,CAAC,KAAK,CAAC,GAAG,EAAE,GAAqC,CAAC,CAAC,CAAA;QACtD,CAAC,EAAE,WAAW,CAAC,CAAA;IACjB,CAAC;IAED,MAAM,QAAQ,GAAG,GAAS,EAAE;QAC1B,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,MAAM,EAAE;YAAE,YAAY,CAAC,CAAC,CAAC,CAAA;QACjD,OAAO,CAAC,KAAK,EAAE,CAAA;QACf,IAAI,SAAS,EAAE,CAAC;YAAC,aAAa,CAAC,SAAS,CAAC,CAAC;YAAC,SAAS,GAAG,IAAI,CAAA;QAAC,CAAC;IAC/D,CAAC,CAAA;IACD,MAAM,IAAI,GAAG,GAAS,EAAE,GAAyC,CAAC,CAAA;IAClE,IAAI,WAAW,KAAK,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAA;IACzF,OAAO;QACL,KAAK,EAAE;YACL,WAAW,CAAC,IAAI;gBACd,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;oBAC5B,KAAK,YAAY,CACf,EAAE,IAAI,EAAE,aAAa,IAAI,CAAC,IAAI,WAAW,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC,IAAI,EAAE,EAC7E,MAAM,CACP,CAAC,KAAK,CAAC,GAAG,EAAE,GAAqC,CAAC,CAAC,CAAA;oBACpD,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;gBACzB,CAAC,EAAE,WAAW,CAAC,CAAA;gBACf,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,CAAA;YAC7B,CAAC;YACD,SAAS,CAAC,IAAI;gBACZ,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;gBAC9B,IAAI,CAAC,EAAE,CAAC;oBAAC,YAAY,CAAC,CAAC,CAAC,CAAC;oBAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;gBAAC,CAAC;YACrD,CAAC;SACF;QACD,QAAQ;KACT,CAAA;AACH,CAAC;AAED,wEAAwE;AAExE,MAAM,kBAAkB;IACb,IAAI,GAAG,QAAQ,CAAA;IACf,OAAO,GAAG,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,CAAC,CAAA;IACrC,IAAI,GAAG,YAAqB,CAAA;IAErC;;kEAE8D;IAC9D,QAAQ;QACN,MAAM,MAAM,GAAG,YAAY,EAAE,CAAA;QAC7B,IAAI,CAAC,MAAM;YAAE,OAAO,SAAS,CAAA;QAC7B,kEAAkE;QAClE,4CAA4C;QAC5C,OAAO,QAAQ,MAAM,CAAC,IAAI,OAAO,MAAM,CAAC,QAAQ,CAAC,YAAY,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAA;IACzF,CAAC;IAED,KAAK,CAAC,WAAW;QACf,OAAO,YAAY,EAAE,CAAA;IACvB,CAAC;IAED,KAAK,CAAC,CAAC,UAAU,CACf,SAAiB,EACjB,MAAc,EACd,UAAyB,EAAE,EAC3B,OAAsB,EAAE;QAExB,MAAM,MAAM,GAAG,YAAY,EAAE,CAAA;QAC7B,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,GAAG,GAAG,oKAAoK,CAAA;YAChL,MAAM,GAAG,CAAA;YACT,OAAM;QACR,CAAC;QACD,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,MAAM,CAAA;QAEjC,oEAAoE;QACpE,kEAAkE;QAClE,kEAAkE;QAClE,8BAA8B;QAC9B,MAAM,QAAQ,GAAiB,EAAE,CAAA;QACjC,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,8DAA8D;YAC9D,uDAAuD;YACvD,IAAI,CAAC,CAAC,CAAC,OAAO;gBAAE,SAAQ;YACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAA;QACrD,CAAC;QACD,mEAAmE;QACnE,iEAAiE;QACjE,kEAAkE;QAClE,gEAAgE;QAChE,gDAAgD;QAChD,MAAM,SAAS,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAA;QAC1C,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;QAEvG,+DAA+D;QAC/D,+DAA+D;QAC/D,MAAM,OAAO,GAAG,MAAM,mBAAmB,CAAC,QAAQ,CAAC,CAAA;QACnD,MAAM,iBAAiB,GAAG,OAAO,CAAC,QAAQ,CAAA;QAC1C,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YACtB,GAAG,CAAC,IAAI,CAAC;gBACP,KAAK,EAAE,wBAAwB;gBAC/B,SAAS;gBACT,aAAa,EAAE,OAAO,CAAC,aAAa;gBACpC,YAAY,EAAE,OAAO,CAAC,YAAY;gBAClC,cAAc,EAAE,OAAO,CAAC,cAAc;aACvC,CAAC,CAAA;QACJ,CAAC;QAED,iEAAiE;QACjE,gEAAgE;QAChE,kEAAkE;QAClE,kEAAkE;QAClE,kEAAkE;QAClE,eAAe;QACf,MAAM,QAAQ,GAAG;YACf,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,cAAc;YACzC,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,SAAS;YACtC,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,SAAS;YACpC,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,SAAS;YAChC,WAAW,EAAE,QAAQ;YACrB,WAAW,EAAE,IAAI,CAAC,SAAS,IAAI,CAAC;SACjC,CAAA;QACD,MAAM,QAAQ,GAAG,kBAAkB,CACjC,sBAAsB,EAAE,EACxB,oBAAoB,CAAC,QAAQ,CAAC,EAC9B,kBAAkB,EAAE,CACrB,CAAA;QAED,oEAAoE;QACpE,0DAA0D;QAC1D,iEAAiE;QACjE,gEAAgE;QAChE,8CAA8C;QAC9C,MAAM,KAAK,GAAc;YACvB,GAAG,eAAe,EAAE;YACpB,GAAG,aAAa,EAAE;YAClB,GAAG,cAAc,EAAE;SACpB,CAAA;QAED,MAAM,MAAM,GAAG,aAAa,EAAE,CAAA;QAC9B,MAAM,OAAO,GAAG,uBAAuB,CAAC,MAAM,CAAC,CAAA;QAE/C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QAC5B,GAAG,CAAC,IAAI,CAAC;YACP,KAAK,EAAE,mBAAmB;YAC1B,SAAS;YACT,IAAI;YACJ,OAAO,EAAE,QAAQ,CAAC,IAAI;YACtB,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC;YAC9B,KAAK,EAAE,KAAK,CAAC,MAAM;YACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC,CAAA;QAEF,oEAAoE;QACpE,uEAAuE;QACvE,qEAAqE;QACrE,sEAAsE;QACtE,mEAAmE;QACnE,6BAA6B;QAC7B,MAAM,GAAG,GAAG,eAAe,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,eAAe,CAAC,QAAQ,CAAC,CAAA;QAExE,MAAM,OAAO,GAAG,UAAU,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAA;QACnD,oEAAoE;QACpE,sEAAsE;QACtE,mEAAmE;QACnE,sEAAsE;QACtE,kEAAkE;QAClE,oEAAoE;QACpE,qEAAqE;QACrE,oEAAoE;QACpE,2DAA2D;QAC3D,MAAM,eAAe,GAAG,CAAC,GAAG,EAAE;YAC5B,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,6BAA6B,IAAI,EAAE,EAAE,EAAE,CAAC,CAAA;YACzE,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC;gBAAE,OAAO,GAAG,CAAA;YAC/C,OAAO,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA,CAAE,6CAA6C;QACtE,CAAC,CAAC,EAAE,CAAA;QACJ,MAAM,UAAU,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAA;QAC5C,MAAM,KAAK,GAAG,iBAAiB,EAAE,CAAA;QACjC,gEAAgE;QAChE,+DAA+D;QAC/D,iEAAiE;QACjE,gEAAgE;QAChE,sBAAsB;QACtB,IAAI,MAAM,GAAoD,IAAI,CAAA;QAClE,IAAI,QAAQ,GAAG,IAAI,CAAA;QACnB,IAAI,YAAY,GAAG,QAAQ,CAAA;QAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;YAC1B,YAAY,GAAG,SAAS,CAAC,QAAQ,CAAA;YACjC,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAA;YACzB,MAAM,GAAG,MAAM,YAAY,CAAC;gBAC1B,QAAQ,EAAE,SAAS,CAAC,QAAQ;gBAC5B,YAAY,EAAE,iBAAiB,CAAC,SAAS,CAAC,QAAQ,EAAE,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC;gBACxE,QAAQ,EAAE,iBAAiB;gBAC3B,KAAK;gBACL,QAAQ;gBACR,OAAO;gBACP,WAAW,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE;gBAClC,SAAS,EAAE,eAAe;gBAC1B,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,KAAK,EAAE;oBACL,KAAK,EAAE,OAAO,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE;oBACvC,MAAM,EAAE,mBAAmB;oBAC3B,MAAM,EAAE,IAAI,CAAC,MAAM;oBACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,cAAc;oBACzC,OAAO;iBACR;gBACD,KAAK,EAAE,UAAU,CAAC,KAAK;aACxB,CAAC,CAAA;YACF,IAAI,MAAM,CAAC,YAAY,KAAK,OAAO;gBAAE,MAAK;YAC1C,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAA;YACzC,MAAM,WAAW,GAAG,wEAAwE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;YACzG,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAA;YACrD,IAAI,CAAC,WAAW,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,CAAC,MAAM,GAAG,CAAC;gBAAE,MAAK;YAC5D,GAAG,CAAC,IAAI,CAAC;gBACP,KAAK,EAAE,sBAAsB;gBAC7B,IAAI,EAAE,SAAS,CAAC,QAAQ,CAAC,IAAI;gBAC7B,OAAO,EAAE,CAAC,GAAG,CAAC;gBACd,GAAG,EAAE,MAAM;aACZ,EAAE,YAAY,SAAS,CAAC,QAAQ,CAAC,IAAI,yCAAyC,CAAC,CAAA;QAClF,CAAC;QACD,UAAU,CAAC,QAAQ,EAAE,CAAA;QACrB,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,qEAAqE;YACrE,sEAAsE;YACtE,MAAM,0DAA0D,CAAA;YAChE,OAAM;QACR,CAAC;QAED,+DAA+D;QAC/D,iEAAiE;QACjE,kCAAkC;QAClC,IAAI,CAAC;YACH,aAAa,CAAC;gBACZ,OAAO;gBACP,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,EAAE;gBACzB,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,cAAc;gBACzC,KAAK,EAAE,IAAI,CAAC,IAAI;gBAChB,MAAM,EAAE,mBAAmB;gBAC3B,SAAS,EAAE,MAAM,CAAC,MAAM;gBACxB,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM;gBAC/B,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;gBAClC,IAAI,EAAE,OAAO,MAAM,CAAC,KAAK,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;gBACzE,OAAO,EAAE,MAAM,CAAC,YAAY,KAAK,OAAO,IAAI,MAAM,CAAC,YAAY,KAAK,SAAS;gBAC7E,KAAK,EAAE,MAAM,CAAC,KAAK;aACpB,CAAC,CAAA;QACJ,CAAC;QAAC,MAAM,CAAC,CAAC,uBAAuB,CAAC,CAAC;QAEnC,kEAAkE;QAClE,mEAAmE;QACnE,oEAAoE;QACpE,4BAA4B;QAC5B,IAAI,IAAI,CAAC,OAAO,IAAI,OAAO,MAAM,CAAC,KAAK,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;YAC7D,IAAI,CAAC;gBAAC,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAA;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,iBAAiB,CAAC,CAAC;QACrF,CAAC;QAED,GAAG,CAAC,IAAI,CAAC;YACP,KAAK,EAAE,kBAAkB;YACzB,SAAS;YACT,OAAO,EAAE,YAAY,CAAC,IAAI;YAC1B,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,YAAY,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI;YAC7C,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,MAAM;YAClC,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;SAClC,CAAC,CAAA;QAEF,gEAAgE;QAChE,6DAA6D;QAC7D,uDAAuD;QACvD,8BAA8B;QAC9B,IAAI,IAAI,GAAG,MAAM,CAAC,IAAI,CAAA;QACtB,IAAI,MAAM,CAAC,YAAY,KAAK,OAAO,EAAE,CAAC;YACpC,IAAI,GAAG,yBAAyB,MAAM,CAAC,KAAK,IAAI,aAAa,EAAE,CAAA;QACjE,CAAC;aAAM,IAAI,MAAM,CAAC,YAAY,KAAK,gBAAgB,EAAE,CAAC;YACpD,IAAI,GAAG,uHAAuH,CAAA;QAChI,CAAC;aAAM,IAAI,MAAM,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;YAC7C,IAAI,GAAG,2CAA2C,CAAA;QACpD,CAAC;aAAM,IAAI,CAAC,IAAI,EAAE,CAAC;YACjB,IAAI,GAAG,2CAA2C,CAAA;QACpD,CAAC;QACD,MAAM,IAAI,CAAA;IACZ,CAAC;CACF;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAiB,IAAI,kBAAkB,EAAE,CAAA;AAExE;;cAEc;AACd,MAAM,UAAU,mBAAmB;IACjC,MAAM,MAAM,GAAG,YAAY,EAAE,CAAA;IAC7B,IAAI,CAAC,MAAM;QAAE,OAAO,iEAAiE,CAAA;IACrF,OAAO,yBAAyB,MAAM,CAAC,QAAQ,CAAC,IAAI,UAAU,MAAM,CAAC,IAAI,aAAa,cAAc,CAAC,aAAa,EAAE,CAAC,EAAE,CAAA;AACzH,CAAC"}

package/dist/plugins/agents/opencode/opencode-stdio-adapter.d.ts

@@ -3,6 +3,7 @@ import type { AgentSendOpts } from '../../../core/types.js';
 export declare class OpenCodeAdapter extends AgentBase {
     readonly name = "opencode";
     readonly aliases: string[];
+    readonly kind: "cli";
     protected buildArgs(prompt: string, opts: AgentSendOpts): string[];
     /**
      * opencode keys its per-project AGENTS.md and memory off the spawn cwd,

package/dist/plugins/agents/opencode/opencode-stdio-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"opencode-stdio-adapter.d.ts","sourceRoot":"","sources":["../../../../src/plugins/agents/opencode/opencode-stdio-adapter.ts"],"names":[],"mappings":"AA2BA,OAAO,EAAE,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,6BAA6B,CAAA;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AA2B3D,qBAAa,eAAgB,SAAQ,SAAS;IAC5C,QAAQ,CAAC,IAAI,cAAa;IAC1B,QAAQ,CAAC,OAAO,WAAuB;IAEvC,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,MAAM,EAAE;IAelE;;;;;;;;;;;;;OAaG;cACa,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,SAAS,CAAC;IAsCvF,SAAS,CAAC,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM;IAO7C;;;;;;OAMG;IACH,SAAS,CAAC,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,GAAG,IAAI;CAiBlE"}
+{"version":3,"file":"opencode-stdio-adapter.d.ts","sourceRoot":"","sources":["../../../../src/plugins/agents/opencode/opencode-stdio-adapter.ts"],"names":[],"mappings":"AA2BA,OAAO,EAAE,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,6BAA6B,CAAA;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AA2B3D,qBAAa,eAAgB,SAAQ,SAAS;IAC5C,QAAQ,CAAC,IAAI,cAAa;IAC1B,QAAQ,CAAC,OAAO,WAAuB;IACvC,QAAQ,CAAC,IAAI,EAAG,KAAK,CAAS;IAE9B,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,MAAM,EAAE;IAelE;;;;;;;;;;;;;OAaG;cACa,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,SAAS,CAAC;IAsCvF,SAAS,CAAC,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM;IAO7C;;;;;;OAMG;IACH,SAAS,CAAC,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,GAAG,IAAI;CAiBlE"}

package/dist/plugins/agents/opencode/opencode-stdio-adapter.js

@@ -32,6 +32,7 @@ const log = rootLogger.child({ component: 'agent.opencode' });
 export class OpenCodeAdapter extends AgentBase {
     name = 'opencode';
     aliases = ['oc', 'opencodeai'];
+    kind = 'cli';
     buildArgs(prompt, opts) {
         const args = ['run', '--format', 'json'];
         if (opts.agentSessionId)