akm-cli 0.10.261012-beta → 0.10.261014-beta

package/dist/integrations/harnesses/codex/result-extractor.js

@@ -1,110 +0,0 @@
-// This Source Code Form is subject to the terms of the Mozilla Public
-// License, v. 2.0. If a copy of the MPL was not distributed with this
-// file, You can obtain one at https://mozilla.org/MPL/2.0/.
-/**
- * OpenAI Codex CLI result extractor (P2, plan §"The adapter contract" step 3 /
- * §"Structured-output normalization").
- *
- * Normalizes the raw {@link AgentRunResult} of a `codex exec --json` run into
- * `{ text, sessionId? }` ({@link AgentResultExtraction}). Schema validation and
- * the retry-until-valid loop stay in the engine, shared across harnesses —
- * this module only strips transport framing.
- *
- * `--json` emits ONE JSON event per stdout line. Two documented event dialects
- * exist across codex versions; the adapter contract localizes that churn here,
- * so both are handled:
- *
- * Legacy protocol (envelope with an `msg` object):
- *   {"id":"0","msg":{"type":"session_configured","session_id":"<uuid>", ...}}
- *   {"id":"1","msg":{"type":"agent_message","message":"<text>"}}
- *   {"id":"1","msg":{"type":"task_complete","last_agent_message":"<text>"}}
- *
- * Newer experimental-JSON protocol (flat `type` field):
- *   {"type":"thread.started","thread_id":"<id>"}
- *   {"type":"item.completed","item":{"id":"item_1","type":"agent_message","text":"<text>"}}
- *   {"type":"turn.completed","usage":{...}}
- *
- * Extraction rules:
- *   - text: `task_complete.last_agent_message` wins when present (it is the
- *     harness's own "final answer" designation); otherwise the LAST
- *     agent-message event seen; otherwise the trimmed raw stdout (plain-text
- *     fallback for runs without `--json`, or unrecognized formats — the
- *     engine's `parseEmbeddedJsonResponse` tier still gets a fair input).
- *   - sessionId: `session_configured.session_id` / `thread.started.thread_id`,
- *     falling back to any sessionId the spawn layer already attached. Stored
- *     opportunistically on the unit row for `codex exec resume <id>`; akm
- *     never depends on it (plan §"Session, MCP, and identity").
- *
- * Non-event JSON lines (e.g. a bare JSON answer printed without framing) are
- * ignored by the event scan and land in the raw-stdout fallback untouched.
- *
- * Registered: `codexResultExtractor` is `CodexHarness.resultExtractor`
- * (`./index.ts`); the engine resolves it via `getHarness()` in
- * `workflows/exec/native-executor.ts` to normalize agent-unit stdout before
- * schema validation.
- */
-import { asNonEmptyString, isRecord } from "../../../core/common.js";
-/** Interpret one parsed JSONL event in either codex event dialect. */
-function interpretEvent(event) {
-    // Legacy protocol: {"id":..., "msg":{"type": ...}}
-    const msg = event.msg;
-    if (isRecord(msg)) {
-        switch (msg.type) {
-            case "session_configured":
-                return { sessionId: asNonEmptyString(msg.session_id) };
-            case "agent_message":
-                return { agentMessage: asNonEmptyString(msg.message) };
-            case "task_complete":
-                return { finalMessage: asNonEmptyString(msg.last_agent_message) };
-            default:
-                return {};
-        }
-    }
-    // Newer protocol: flat {"type": "thread.started" | "item.completed" | ...}
-    switch (event.type) {
-        case "thread.started":
-            return { sessionId: asNonEmptyString(event.thread_id) };
-        case "item.completed": {
-            const item = event.item;
-            if (isRecord(item) && item.type === "agent_message") {
-                return { agentMessage: asNonEmptyString(item.text) };
-            }
-            return {};
-        }
-        default:
-            return {};
-    }
-}
-/**
- * Codex result extractor: JSONL event stream (either dialect) → final agent
- * message + opportunistic session id, with a plain-stdout fallback.
- */
-export const codexResultExtractor = (result) => {
-    let sessionId = result.sessionId;
-    let lastAgentMessage;
-    let finalMessage;
-    for (const line of result.stdout.split("\n")) {
-        const trimmed = line.trim();
-        // Every codex event line is a JSON object; skip banner/noise lines cheaply.
-        if (!trimmed.startsWith("{"))
-            continue;
-        let parsed;
-        try {
-            parsed = JSON.parse(trimmed);
-        }
-        catch {
-            continue; // not a complete JSON line (e.g. wrapped text) — ignore
-        }
-        if (!isRecord(parsed))
-            continue;
-        const contribution = interpretEvent(parsed);
-        if (contribution.sessionId)
-            sessionId = contribution.sessionId;
-        if (contribution.agentMessage)
-            lastAgentMessage = contribution.agentMessage;
-        if (contribution.finalMessage)
-            finalMessage = contribution.finalMessage;
-    }
-    const text = finalMessage ?? lastAgentMessage ?? result.stdout.trim();
-    return sessionId === undefined ? { text } : { text, sessionId };
-};

package/dist/integrations/harnesses/copilot/agent-builder.js

@@ -1,117 +0,0 @@
-// This Source Code Form is subject to the terms of the Mozilla Public
-// License, v. 2.0. If a copy of the MPL was not distributed with this
-// file, You can obtain one at https://mozilla.org/MPL/2.0/.
-/**
- * GitHub Copilot CLI agent command builder (P2, plan §"The adapter contract"
- * step 2 / §"Capability matrix").
- *
- * Translates a platform-agnostic {@link AgentDispatchRequest} into the exact
- * headless argv the `copilot` CLI expects. Per the capability matrix the
- * headless invocation is:
- *
- *   copilot -p "<prompt>" --allow-all-tools
- *
- * with `--output-format json` for structured output, `--model <m>` for model
- * selection, and `--resume <id>` for resume (not built here because
- * `AgentDispatchRequest` carries no session id).
- *
- * Platform-specific mapping decisions (all localized here, per the adapter
- * contract):
- *
- * - **systemPrompt** — Copilot CLI has no system-prompt flag (it reads
- *   repo/user custom-instructions files instead), so the system prompt is
- *   folded into the `-p` payload ahead of the task prompt, separated by a
- *   blank line.
- * - **schema** — the matrix places Copilot in the "via prompt+validate" tier
- *   (no native `--output-schema` equivalent, unlike Codex), so the JSON
- *   Schema reaches it as the instruction the shared request lowering appends
- *   to the prompt, and `--output-format json` is emitted so stdout is the
- *   documented JSON envelope the copilot result extractor normalizes. The
- *   engine's shared retry-until-valid loop performs the actual validation.
- * - **tools** — a string/array tool policy maps to repeated
- *   `--allow-tool <t>` flags (Copilot's per-tool approval flag). With no
- *   policy at all, headless runs need autonomy, so `--allow-all-tools` is
- *   emitted per the matrix. A *structured* policy object is NOT expressible
- *   as Copilot flags; it is deliberately dropped without falling back to
- *   `--allow-all-tools` (never silently widen a restriction) — in
- *   programmatic mode Copilot then denies unapproved tool calls, which is the
- *   conservative failure mode.
- *
- * Registered: `copilotBuilder` is `CopilotHarness.agentBuilder`
- * (`./index.ts`), one of the ten harnesses `HARNESS_REGISTRY` constructs
- * (`harnesses/index.ts`); `agent/builders.ts` derives `BUILTIN_BUILDERS` from
- * that registry, so this builder is reachable under the `"copilot"` platform
- * name without any further wiring.
- */
-import { resolveDispatchModel } from "../../agent/builder-shared.js";
-import { createAgentRequestLowerer } from "../../agent/request-lowering.js";
-/** Canonical harness/platform id used for model-alias resolution. */
-export const COPILOT_PLATFORM = "copilot";
-/**
- * Split a tool policy into individual tool names for `--allow-tool`.
- * Strings are comma-separated lists; arrays are taken as-is. Structured
- * policy objects return `undefined` (not expressible as Copilot flags — see
- * module doc).
- */
-function toolPolicyEntries(tools) {
-    if (typeof tools === "string") {
-        return tools
-            .split(",")
-            .map((t) => t.trim())
-            .filter(Boolean);
-    }
-    if (Array.isArray(tools)) {
-        return tools.map((t) => t.trim()).filter(Boolean);
-    }
-    return undefined;
-}
-/** Assemble the `-p` payload: optional system prompt, then the task prompt. */
-function buildPromptPayload(req) {
-    const sections = [];
-    if (req.systemPrompt)
-        sections.push(req.systemPrompt);
-    sections.push(req.prompt);
-    return sections.join("\n\n");
-}
-/**
- * GitHub Copilot CLI builder.
- * Command shape:
- *   copilot [--model <m>] (--allow-all-tools | --allow-tool <t> ...)
- *           [--output-format json] -p "<systemPrompt?\n\nprompt>"
- */
-export const copilotBuilder = {
-    platform: COPILOT_PLATFORM,
-    personaChannel: "prompt",
-    lower: createAgentRequestLowerer({
-        adapter: COPILOT_PLATFORM,
-        personaChannel: "prompt",
-        tools: "flat",
-    }),
-    build(profile, req) {
-        const args = [...profile.args];
-        if (req.model) {
-            const resolved = resolveDispatchModel(req, profile, COPILOT_PLATFORM);
-            args.push("--model", resolved);
-        }
-        if (req.tools) {
-            const entries = toolPolicyEntries(req.tools);
-            // Structured policy objects (entries === undefined) emit NO allow flags:
-            // dropping a restriction must never widen to --allow-all-tools.
-            for (const tool of entries ?? []) {
-                args.push("--allow-tool", tool);
-            }
-        }
-        else {
-            // Headless default per the capability matrix: units must run without
-            // interactive tool-approval prompts.
-            args.push("--allow-all-tools");
-        }
-        if (req.schema) {
-            // Structured unit: ask for the documented JSON envelope so the result
-            // extractor can pull the final message + session id deterministically.
-            args.push("--output-format", "json");
-        }
-        args.push("-p", buildPromptPayload(req));
-        return { argv: [profile.bin, ...args] };
-    },
-};

package/dist/integrations/harnesses/copilot/result-extractor.js

@@ -1,178 +0,0 @@
-// This Source Code Form is subject to the terms of the Mozilla Public
-// License, v. 2.0. If a copy of the MPL was not distributed with this
-// file, You can obtain one at https://mozilla.org/MPL/2.0/.
-/**
- * GitHub Copilot CLI result extractor (P2, plan §"The adapter contract"
- * step 3 / §"Structured-output normalization", tier "native-json").
- *
- * Normalizes one raw {@link AgentRunResult} from a headless `copilot` run
- * into `{ text, sessionId? }` — the {@link AgentResultExtraction} seam. The
- * engine's shared schema-validation / retry-until-valid loop runs *after*
- * this; the extractor only strips transport framing.
- *
- * Copilot's stdout takes one of three shapes depending on flags/version
- * (`--output-format json` per the capability matrix), all handled here:
- *
- *  1. **Single JSON document** — a result envelope, e.g.
- *     `{"type":"result","session_id":"…","result":"<final answer>"}`.
- *     Pretty-printed multi-line JSON is included (whole-stdout parse is
- *     attempted first). Only objects carrying a transport marker (a `type`
- *     discriminator or a session-id field) are unwrapped; a bare JSON answer
- *     with no marker (a schema unit's `{"result":"ok"}`) is passed through
- *     raw so the engine's schema validator sees the whole object.
- *  2. **JSONL event stream** — one JSON object per line
- *     (`session.start` / assistant `message` / `result` events); the LAST
- *     text-bearing event wins, the first session-id-bearing event supplies
- *     the session id. Non-JSON banner lines are skipped.
- *  3. **Plain text** — no JSON anywhere; trimmed stdout passes through
- *     verbatim (the engine's embedded-JSON parsing still runs downstream for
- *     schema units).
- *
- * Key names are matched tolerantly (`result`/`response`/`text`/`output`/
- * `content`/`message`, snake_case and camelCase session-id variants) so
- * point-release renames in the CLI's envelope degrade to the plain-text
- * fallback instead of hard-failing — version churn stays contained in this
- * one file, per the adapter contract.
- *
- * Registered: `copilotResultExtractor` is `CopilotHarness.resultExtractor`
- * (`./index.ts`); the engine resolves it via `getHarness()` in
- * `workflows/exec/native-executor.ts` to normalize agent-unit stdout before
- * schema validation.
- */
-import { isRecord, tryParseJson } from "../../../core/common.js";
-/** Keys that may carry the final answer, in precedence order. */
-const TEXT_KEYS = ["result", "response", "text", "output", "content", "message"];
-/** Keys that may carry the harness-native session id, in precedence order. */
-const SESSION_KEYS = ["session_id", "sessionId", "conversation_id", "conversationId", "thread_id", "threadId"];
-/**
- * Coerce a candidate value into text. Handles the shapes Copilot's envelope
- * nests answers in: bare strings, `{content|text}` wrappers (assistant
- * message objects), and arrays of `{type:"text",text}` content blocks.
- * Depth-bounded: JSON.parse output is acyclic, but nesting is capped anyway
- * so a pathological envelope cannot recurse unboundedly.
- */
-function textOf(value, depth = 0) {
-    if (depth > 4)
-        return undefined;
-    if (typeof value === "string")
-        return value;
-    if (Array.isArray(value)) {
-        const parts = [];
-        for (const block of value) {
-            const t = textOf(block, depth + 1);
-            if (t)
-                parts.push(t);
-        }
-        return parts.length > 0 ? parts.join("\n") : undefined;
-    }
-    if (isRecord(value)) {
-        return textOf(value.content ?? value.text, depth + 1);
-    }
-    return undefined;
-}
-/** Extract the final-answer text from one parsed JSON value, if any. */
-function extractText(value) {
-    if (typeof value === "string")
-        return value;
-    if (!isRecord(value))
-        return undefined;
-    for (const key of TEXT_KEYS) {
-        if (!(key in value))
-            continue;
-        const text = textOf(value[key]);
-        if (text !== undefined)
-            return text;
-    }
-    return undefined;
-}
-/** Extract a harness-native session id from one parsed JSON value, if any. */
-function extractSessionId(value) {
-    if (!isRecord(value))
-        return undefined;
-    for (const key of SESSION_KEYS) {
-        const candidate = value[key];
-        if (typeof candidate === "string" && candidate.length > 0)
-            return candidate;
-    }
-    return undefined;
-}
-/**
- * `type` discriminator values Copilot's `--output-format json` envelopes are
- * documented to use (plus the `session.*` event family). Deliberately a
- * CLOSED set: a schema unit's own answer may legitimately be a discriminated
- * union with a `type` field (`{"type":"success","output":"data"}`), and
- * treating ANY string `type` as a transport marker would unwrap — and
- * corrupt — such answers. An unrecognized type degrades to raw pass-through,
- * which the schema validator handles (whole object) and free-text tolerates.
- */
-const ENVELOPE_TYPES = new Set(["result", "response", "message", "assistant", "error"]);
-/**
- * Does this parsed object look like one of Copilot's transport ENVELOPES (a
- * `result`/event document) rather than a bare JSON answer the model produced?
- *
- * Copilot's `--output-format json` documents always carry a transport marker:
- * a known `type` discriminator (`"result"`, `"session.start"`, `"message"`, …)
- * and, in every documented result envelope, a session-id field. A bare
- * structured answer a schema unit was asked for — e.g. `{"result":"ok"}` or
- * `{"type":"success","output":"data"}` — carries neither a known discriminator
- * nor (normally) a session-id key. Unwrapping such an answer would hand the
- * schema validator only the field value (`"ok"`) and reject the run despite
- * valid JSON (PR #714 review), so we only unwrap objects that are genuinely
- * envelopes and pass everything else through raw.
- */
-function isTransportEnvelope(value) {
-    const type = value.type;
-    if (typeof type === "string" && (ENVELOPE_TYPES.has(type) || type.startsWith("session.")))
-        return true;
-    return extractSessionId(value) !== undefined;
-}
-/**
- * Normalize a raw copilot run result into `{ text, sessionId? }`.
- * See the module doc for the three stdout shapes handled.
- */
-export const copilotResultExtractor = (result) => {
-    // The raw result's own sessionId (SDK-style paths) is the fallback; an id
-    // found in the output stream wins because it is fresher.
-    const fallbackSessionId = result.sessionId;
-    const raw = result.stdout.trim();
-    // Shape 1 — whole stdout is one JSON document (spawn may have pre-parsed
-    // it when the profile requested parseOutput: "json").
-    const whole = result.parsed !== undefined ? result.parsed : raw.length > 0 ? tryParseJson(raw) : undefined;
-    if (whole !== undefined) {
-        const sessionId = extractSessionId(whole) ?? fallbackSessionId;
-        // A bare JSON OBJECT with no transport marker is a legitimate structured
-        // answer (a schema unit's `{"result":"ok"}`), NOT an envelope — pass its
-        // raw JSON through so the engine's schema validator receives the whole
-        // object instead of an unwrapped field value (PR #714 review). Only
-        // genuine Copilot envelopes are unwrapped; non-object JSON (a top-level
-        // string/array/primitive) keeps the prior extraction. Either way, an
-        // unknown envelope with no recognized text key falls back to raw stdout.
-        const text = isRecord(whole) && !isTransportEnvelope(whole) ? raw : (extractText(whole) ?? raw);
-        return { text, ...(sessionId ? { sessionId } : {}) };
-    }
-    // Shape 2 — JSONL event stream: last text-bearing event wins; first
-    // session-id-bearing event supplies the id. Non-JSON lines are banner
-    // noise and are skipped.
-    let lastText;
-    let streamSessionId;
-    let sawJsonLine = false;
-    for (const line of raw.split("\n")) {
-        const trimmed = line.trim();
-        if (trimmed.length === 0)
-            continue;
-        const event = tryParseJson(trimmed);
-        if (event === undefined)
-            continue;
-        sawJsonLine = true;
-        streamSessionId ??= extractSessionId(event);
-        const text = extractText(event);
-        if (text !== undefined)
-            lastText = text;
-    }
-    if (sawJsonLine) {
-        const sessionId = streamSessionId ?? fallbackSessionId;
-        return { text: lastText ?? raw, ...(sessionId ? { sessionId } : {}) };
-    }
-    // Shape 3 — plain text passthrough.
-    return { text: raw, ...(fallbackSessionId ? { sessionId: fallbackSessionId } : {}) };
-};

package/dist/integrations/harnesses/gemini/agent-builder.js

@@ -1,114 +0,0 @@
-// This Source Code Form is subject to the terms of the Mozilla Public
-// License, v. 2.0. If a copy of the MPL was not distributed with this
-// file, You can obtain one at https://mozilla.org/MPL/2.0/.
-/**
- * Gemini CLI agent command builder (P2, plan §"The adapter contract" step 2 /
- * §"Capability matrix").
- *
- * Translates a platform-agnostic {@link AgentDispatchRequest} into the exact
- * headless argv the `gemini` CLI expects. Per the capability matrix the
- * headless invocation is:
- *
- *   gemini -p "<prompt>"
- *
- * with `--output-format json` for structured output, `--model <m>` for model
- * selection, and `--resume <id>` for resume; resume is not built here because
- * `AgentDispatchRequest` carries no session id. The `GEMINI_CLI=1` identity
- * env marker is likewise registry-side (`AkmHarness.identityEnv` /
- * `agent-identity.ts`), not a builder concern.
- *
- * Platform-specific mapping decisions (all localized here, per the adapter
- * contract):
- *
- * - **systemPrompt** — Gemini CLI has no system-prompt flag in headless mode
- *   (system text comes from `GEMINI.md` context files / `GEMINI_SYSTEM_MD`),
- *   so the system prompt is folded into the `-p` payload ahead of the task
- *   prompt, separated by a blank line.
- * - **schema** — the matrix places Gemini in the "via prompt+validate" tier
- *   (no native `--output-schema` equivalent, unlike Codex — so no temp-file
- *   plumbing here), so the JSON Schema reaches it as the instruction the
- *   shared request lowering appends to the prompt, and
- *   `--output-format json` is emitted so stdout is the documented JSON
- *   envelope the gemini result extractor normalizes. The engine's shared
- *   retry-until-valid loop performs the actual validation.
- * - **tools** — a string/array tool policy maps to repeated
- *   `--allowed-tools <t>` flags (Gemini's run-without-confirmation
- *   allowlist). A *structured* policy object is NOT expressible as Gemini
- *   flags; it is deliberately dropped without widening to an auto-approve
- *   flag (never silently widen a restriction). With no policy at all,
- *   NOTHING is emitted — the matrix's headless shape is the bare
- *   `gemini -p "<p>"`; autonomy flags (`--yolo`, `--approval-mode`) belong in
- *   `profile.args` where the operator opts in explicitly.
- *
- * Registered: `geminiBuilder` is `GeminiHarness.agentBuilder` (`./index.ts`),
- * one of the ten harnesses `HARNESS_REGISTRY` constructs
- * (`harnesses/index.ts`); `agent/builders.ts` derives `BUILTIN_BUILDERS` from
- * that registry, so this builder is reachable under the `"gemini"` platform
- * name without any further wiring.
- */
-import { resolveDispatchModel } from "../../agent/builder-shared.js";
-import { createAgentRequestLowerer } from "../../agent/request-lowering.js";
-/** Canonical harness/platform id used for model-alias resolution. */
-export const GEMINI_PLATFORM = "gemini";
-/**
- * Split a tool policy into individual tool names for `--allowed-tools`.
- * Strings are comma-separated lists; arrays are taken as-is. Structured
- * policy objects return `undefined` (not expressible as Gemini flags — see
- * module doc).
- */
-function toolPolicyEntries(tools) {
-    if (typeof tools === "string") {
-        return tools
-            .split(",")
-            .map((t) => t.trim())
-            .filter(Boolean);
-    }
-    if (Array.isArray(tools)) {
-        return tools.map((t) => t.trim()).filter(Boolean);
-    }
-    return undefined;
-}
-/** Assemble the `-p` payload: optional system prompt, then the task prompt. */
-function buildPromptPayload(req) {
-    const sections = [];
-    if (req.systemPrompt)
-        sections.push(req.systemPrompt);
-    sections.push(req.prompt);
-    return sections.join("\n\n");
-}
-/**
- * Gemini CLI builder.
- * Command shape:
- *   gemini [--model <m>] [--allowed-tools <t> ...]
- *          [--output-format json] -p "<systemPrompt?\n\nprompt>"
- */
-export const geminiBuilder = {
-    platform: GEMINI_PLATFORM,
-    personaChannel: "prompt",
-    lower: createAgentRequestLowerer({
-        adapter: GEMINI_PLATFORM,
-        personaChannel: "prompt",
-        tools: "flat",
-    }),
-    build(profile, req) {
-        const args = [...profile.args];
-        if (req.model) {
-            const resolved = resolveDispatchModel(req, profile, GEMINI_PLATFORM);
-            args.push("--model", resolved);
-        }
-        if (req.tools) {
-            // Structured policy objects (entries === undefined) emit NO flags:
-            // dropping a restriction must never widen to auto-approval.
-            for (const tool of toolPolicyEntries(req.tools) ?? []) {
-                args.push("--allowed-tools", tool);
-            }
-        }
-        if (req.schema) {
-            // Structured unit: ask for the documented JSON envelope so the result
-            // extractor can pull the final message + session id deterministically.
-            args.push("--output-format", "json");
-        }
-        args.push("-p", buildPromptPayload(req));
-        return { argv: [profile.bin, ...args] };
-    },
-};

package/dist/integrations/harnesses/gemini/result-extractor.js

@@ -1,149 +0,0 @@
-// This Source Code Form is subject to the terms of the Mozilla Public
-// License, v. 2.0. If a copy of the MPL was not distributed with this
-// file, You can obtain one at https://mozilla.org/MPL/2.0/.
-/**
- * Gemini CLI result extractor (P2, plan §"The adapter contract" step 3 /
- * §"Structured-output normalization", tier "native-json").
- *
- * Normalizes one raw {@link AgentRunResult} from a headless `gemini` run into
- * `{ text, sessionId? }` — the {@link AgentResultExtraction} seam. The
- * engine's shared schema-validation / retry-until-valid loop runs *after*
- * this; the extractor only strips transport framing.
- *
- * Gemini's stdout takes one of three shapes depending on flags/version
- * (`--output-format json` per the capability matrix), all handled here:
- *
- *  1. **Single JSON document** — the documented `--output-format json`
- *     envelope, e.g. `{"response":"<final answer>","stats":{...}}` (an
- *     `error` variant carries `{error:{type,message,code}}` and no usable
- *     response — that degrades to the raw-stdout fallback so the engine's
- *     failure handling sees the whole envelope). Pretty-printed multi-line
- *     JSON is included (whole-stdout parse is attempted first).
- *  2. **JSONL event stream** (`--output-format stream-json`) — one JSON
- *     object per line; the LAST text-bearing event wins, the first
- *     session-id-bearing event supplies the session id. Non-JSON banner
- *     lines ("Loaded cached credentials.", update notices) are skipped.
- *  3. **Plain text** — no JSON anywhere; trimmed stdout passes through
- *     verbatim (the engine's embedded-JSON parsing still runs downstream for
- *     schema units).
- *
- * Key names are matched tolerantly (`response` first — Gemini's documented
- * envelope key — then `result`/`text`/`output`/`content`/`message`;
- * snake_case and camelCase session-id variants) so point-release renames in
- * the CLI's envelope degrade to the plain-text fallback instead of
- * hard-failing — version churn stays contained in this one file, per the
- * adapter contract. The session id feeds `--resume <id>` opportunistically;
- * `workflow_run_units` remains the durable source of truth.
- *
- * Registered: `geminiResultExtractor` is `GeminiHarness.resultExtractor`
- * (`./index.ts`); the engine resolves it via `getHarness()` in
- * `workflows/exec/native-executor.ts` to normalize agent-unit stdout before
- * schema validation.
- */
-import { isRecord, tryParseJson } from "../../../core/common.js";
-/**
- * Keys that may carry the final answer, in precedence order. `response` is
- * Gemini's documented `--output-format json` envelope key.
- */
-const TEXT_KEYS = ["response", "result", "text", "output", "content", "message"];
-/** Keys that may carry the harness-native session id, in precedence order. */
-const SESSION_KEYS = ["session_id", "sessionId", "conversation_id", "conversationId", "chat_id", "chatId"];
-/**
- * Coerce a candidate value into text. Handles the shapes Gemini nests
- * answers in: bare strings, `{content|text}` wrappers (assistant message
- * objects), and arrays of `{type:"text",text}` content blocks (Gemini API
- * `parts`-style lists). Depth-bounded: JSON.parse output is acyclic, but
- * nesting is capped anyway so a pathological envelope cannot recurse
- * unboundedly.
- */
-function textOf(value, depth = 0) {
-    if (depth > 4)
-        return undefined;
-    if (typeof value === "string")
-        return value;
-    if (Array.isArray(value)) {
-        const parts = [];
-        for (const block of value) {
-            const t = textOf(block, depth + 1);
-            if (t)
-                parts.push(t);
-        }
-        return parts.length > 0 ? parts.join("\n") : undefined;
-    }
-    if (isRecord(value)) {
-        return textOf(value.content ?? value.text, depth + 1);
-    }
-    return undefined;
-}
-/** Extract the final-answer text from one parsed JSON value, if any. */
-function extractText(value) {
-    if (typeof value === "string")
-        return value;
-    if (!isRecord(value))
-        return undefined;
-    for (const key of TEXT_KEYS) {
-        if (!(key in value))
-            continue;
-        const text = textOf(value[key]);
-        if (text !== undefined)
-            return text;
-    }
-    return undefined;
-}
-/** Extract a harness-native session id from one parsed JSON value, if any. */
-function extractSessionId(value) {
-    if (!isRecord(value))
-        return undefined;
-    for (const key of SESSION_KEYS) {
-        const candidate = value[key];
-        if (typeof candidate === "string" && candidate.length > 0)
-            return candidate;
-    }
-    return undefined;
-}
-/**
- * Normalize a raw gemini run result into `{ text, sessionId? }`.
- * See the module doc for the three stdout shapes handled.
- */
-export const geminiResultExtractor = (result) => {
-    // The raw result's own sessionId (SDK-style paths) is the fallback; an id
-    // found in the output stream wins because it is fresher.
-    const fallbackSessionId = result.sessionId;
-    const raw = result.stdout.trim();
-    // Shape 1 — whole stdout is one JSON document (spawn may have pre-parsed
-    // it when the profile requested parseOutput: "json").
-    const whole = result.parsed !== undefined ? result.parsed : raw.length > 0 ? tryParseJson(raw) : undefined;
-    if (whole !== undefined) {
-        const sessionId = extractSessionId(whole) ?? fallbackSessionId;
-        // Unknown envelope (no recognized text key — includes the error-only
-        // variant): fall back to raw stdout so downstream embedded-JSON parsing
-        // and failure handling still have the full material to work with.
-        const text = extractText(whole) ?? raw;
-        return { text, ...(sessionId ? { sessionId } : {}) };
-    }
-    // Shape 2 — JSONL event stream: last text-bearing event wins; first
-    // session-id-bearing event supplies the id. Non-JSON lines are banner
-    // noise and are skipped.
-    let lastText;
-    let streamSessionId;
-    let sawJsonLine = false;
-    for (const line of raw.split("\n")) {
-        const trimmed = line.trim();
-        if (trimmed.length === 0)
-            continue;
-        const event = tryParseJson(trimmed);
-        if (event === undefined)
-            continue;
-        sawJsonLine = true;
-        streamSessionId ??= extractSessionId(event);
-        const text = extractText(event);
-        if (text !== undefined)
-            lastText = text;
-    }
-    if (sawJsonLine) {
-        const sessionId = streamSessionId ?? fallbackSessionId;
-        return { text: lastText ?? raw, ...(sessionId ? { sessionId } : {}) };
-    }
-    // Shape 3 — plain text passthrough.
-    return { text: raw, ...(fallbackSessionId ? { sessionId: fallbackSessionId } : {}) };
-};