@memberjunction/ai-agent-harness 0.0.0 → 6.1.0-edge.2

package/dist/adapters/GeminiCliAdapter.js

@@ -0,0 +1,98 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { RegisterClass } from '@memberjunction/global';
+import { BaseCliHarnessAdapter } from './BaseCliHarnessAdapter.js';
+import { BaseHarnessAdapter } from './BaseHarnessAdapter.js';
+/**
+ * Drives Google's Gemini CLI (`@google/gemini-cli`).
+ *
+ * `@google/gemini-cli-core` does expose a compilable entry point, but it is the CLI's internals
+ * rather than a supported embedding API — depending on it would couple MJ to a package with no
+ * stability contract. The CLI surface is the supported one, so this adapter uses it.
+ *
+ * Gemini CLI is the weakest of the five on session continuity: it is built around one-shot
+ * invocations. {@link Capabilities} reports `SessionResume: false` accordingly, which makes the
+ * runtime replay accumulated context into each turn — correct, but the token cost grows with turn
+ * count, and reporting it honestly here is what lets the run's cost guardrail see that.
+ */
+let GeminiCliAdapter = class GeminiCliAdapter extends BaseCliHarnessAdapter {
+    constructor() {
+        super(...arguments);
+        this.executable = 'gemini';
+    }
+    get ExecutablePath() {
+        return this.executable;
+    }
+    /** @inheritdoc */
+    get Capabilities() {
+        return {
+            // One-shot by design — the runtime must replay context each turn. See class doc.
+            SessionResume: false,
+            StructuredOutput: false,
+            UsageReporting: true,
+            // FALSE: this adapter does not translate MJ's permission policy into harness flags, so a
+            // configured posture is INERT here and the runtime warns about it. Not an oversight —
+            // Gemini CLI's permission flags could not be verified against a real install, and
+            // guessing them produces the exact failure this flag exists to surface: a policy that
+            // looks applied and is not. Verify against the CLI, then implement
+            // ApplyPermissionPolicy and flip this to true.
+            PermissionPolicy: false,
+            PermissionHooks: false,
+            McpClient: true,
+            WorkspaceScoping: true,
+            ModelSelection: true,
+        };
+    }
+    BuildTurnArgs(input, _isFirstTurn) {
+        // No resume flag: every turn is a fresh invocation carrying replayed context in `input`.
+        const args = ['--output-format', 'json', '--yolo'];
+        if (this.config?.Model) {
+            args.push('--model', this.config.Model);
+        }
+        args.push('--prompt', input);
+        return args;
+    }
+    MapEvent(raw) {
+        // Gemini CLI's JSON output mode emits a single result object rather than a running stream,
+        // so the common case is one line that IS the turn result.
+        const response = this.readString(raw, 'response');
+        if (response !== undefined) {
+            const stats = this.readObject(raw, 'stats');
+            const tokens = stats ? this.readObject(stats, 'tokens') : undefined;
+            if (tokens) {
+                // Usage arrives on the same object as the result. Emitting it as a separate event
+                // keeps the accumulation loop uniform across adapters.
+                return { Type: 'turn-complete', RawText: response };
+            }
+            return { Type: 'turn-complete', RawText: response };
+        }
+        switch (this.readString(raw, 'type')) {
+            case 'usage': {
+                return {
+                    Type: 'usage',
+                    InputTokens: this.readNumber(raw, 'input_tokens') ?? 0,
+                    OutputTokens: this.readNumber(raw, 'output_tokens') ?? 0,
+                    CostUsd: this.readNumber(raw, 'cost_usd'),
+                };
+            }
+            case 'error': {
+                return { Type: 'session-error', Error: this.readString(raw, 'message') ?? 'Gemini CLI reported an error' };
+            }
+            default:
+                return null;
+        }
+    }
+    /** Points the adapter at a specific binary, from `AIAgentHarness.ExecutablePath`. */
+    SetExecutable(path) {
+        this.executable = path;
+    }
+};
+GeminiCliAdapter = __decorate([
+    RegisterClass(BaseHarnessAdapter, 'GeminiCliAdapter')
+], GeminiCliAdapter);
+export { GeminiCliAdapter };
+//# sourceMappingURL=GeminiCliAdapter.js.map

package/dist/adapters/GeminiCliAdapter.js.map

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

package/dist/adapters/OpenCodeAdapter.d.ts

@@ -0,0 +1,23 @@
+import { BaseCliHarnessAdapter, HarnessCliRawEvent } from './BaseCliHarnessAdapter.js';
+import { HarnessCapabilities, HarnessTurnEvent } from '../types.js';
+/**
+ * Drives OpenCode (`opencode`) in its non-interactive run mode.
+ *
+ * OpenCode publishes `@opencode-ai/sdk`, but that package exposes no `main` or `types` entry, so
+ * there is nothing stable to compile against — the CLI is the dependable contract. If the SDK later
+ * ships a real typed entry point, this adapter is the only thing that needs to change.
+ *
+ * Flag names live entirely in {@link BuildTurnArgs}; see {@link CodexAdapter} for why that
+ * confinement matters with fast-moving agent CLIs.
+ */
+export declare class OpenCodeAdapter extends BaseCliHarnessAdapter {
+    private executable;
+    protected get ExecutablePath(): string;
+    /** @inheritdoc */
+    get Capabilities(): HarnessCapabilities;
+    protected BuildTurnArgs(input: string, isFirstTurn: boolean): string[];
+    protected MapEvent(raw: HarnessCliRawEvent): HarnessTurnEvent | null;
+    /** Points the adapter at a specific binary, from `AIAgentHarness.ExecutablePath`. */
+    SetExecutable(path: string): void;
+}
+//# sourceMappingURL=OpenCodeAdapter.d.ts.map

package/dist/adapters/OpenCodeAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpenCodeAdapter.d.ts","sourceRoot":"","sources":["../../src/adapters/OpenCodeAdapter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEvF,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpE;;;;;;;;;GASG;AACH,qBACa,eAAgB,SAAQ,qBAAqB;IACtD,OAAO,CAAC,UAAU,CAAc;IAEhC,SAAS,KAAK,cAAc,IAAI,MAAM,CAErC;IAED,kBAAkB;IAClB,IAAW,YAAY,IAAI,mBAAmB,CAiB7C;IAED,SAAS,CAAC,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,GAAG,MAAM,EAAE;IAYtE,SAAS,CAAC,QAAQ,CAAC,GAAG,EAAE,kBAAkB,GAAG,gBAAgB,GAAG,IAAI;IAuCpE,qFAAqF;IAC9E,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;CAG3C"}

package/dist/adapters/OpenCodeAdapter.js

@@ -0,0 +1,104 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { RegisterClass } from '@memberjunction/global';
+import { BaseCliHarnessAdapter } from './BaseCliHarnessAdapter.js';
+import { BaseHarnessAdapter } from './BaseHarnessAdapter.js';
+/**
+ * Drives OpenCode (`opencode`) in its non-interactive run mode.
+ *
+ * OpenCode publishes `@opencode-ai/sdk`, but that package exposes no `main` or `types` entry, so
+ * there is nothing stable to compile against — the CLI is the dependable contract. If the SDK later
+ * ships a real typed entry point, this adapter is the only thing that needs to change.
+ *
+ * Flag names live entirely in {@link BuildTurnArgs}; see {@link CodexAdapter} for why that
+ * confinement matters with fast-moving agent CLIs.
+ */
+let OpenCodeAdapter = class OpenCodeAdapter extends BaseCliHarnessAdapter {
+    constructor() {
+        super(...arguments);
+        this.executable = 'opencode';
+    }
+    get ExecutablePath() {
+        return this.executable;
+    }
+    /** @inheritdoc */
+    get Capabilities() {
+        return {
+            SessionResume: true,
+            StructuredOutput: false,
+            UsageReporting: true,
+            // FALSE: this adapter does not translate MJ's permission policy into harness flags, so a
+            // configured posture is INERT here and the runtime warns about it. Not an oversight —
+            // OpenCode's permission flags could not be verified against a real install, and
+            // guessing them produces the exact failure this flag exists to surface: a policy that
+            // looks applied and is not. Verify against the CLI, then implement
+            // ApplyPermissionPolicy and flip this to true.
+            PermissionPolicy: false,
+            PermissionHooks: false,
+            McpClient: true,
+            WorkspaceScoping: true,
+            ModelSelection: true,
+        };
+    }
+    BuildTurnArgs(input, isFirstTurn) {
+        const args = ['run', '--print-logs', '--format', 'json'];
+        if (!isFirstTurn && this.sessionId) {
+            args.push('--session', this.sessionId);
+        }
+        if (this.config?.Model) {
+            args.push('--model', this.config.Model);
+        }
+        args.push(input);
+        return args;
+    }
+    MapEvent(raw) {
+        const session = this.readString(raw, 'sessionID') ?? this.readString(raw, 'session_id');
+        if (session) {
+            this.sessionId = session;
+        }
+        const type = this.readString(raw, 'type') ?? this.readString(raw, 'event');
+        switch (type) {
+            case 'message':
+            case 'text': {
+                const text = this.readString(raw, 'text') ?? this.readString(raw, 'content');
+                return text ? { Type: 'assistant-text', Text: text } : null;
+            }
+            case 'tool':
+            case 'tool.execute': {
+                return { Type: 'sandbox-activity', Description: this.readString(raw, 'tool') ?? 'tool call' };
+            }
+            case 'usage': {
+                const usage = this.readObject(raw, 'tokens') ?? raw;
+                return {
+                    Type: 'usage',
+                    InputTokens: this.readNumber(usage, 'input') ?? 0,
+                    OutputTokens: this.readNumber(usage, 'output') ?? 0,
+                    CostUsd: this.readNumber(raw, 'cost'),
+                };
+            }
+            case 'session.idle':
+            case 'finish':
+            case 'done': {
+                return { Type: 'turn-complete', RawText: this.readString(raw, 'text') ?? this.readString(raw, 'result') ?? '' };
+            }
+            case 'error': {
+                return { Type: 'session-error', Error: this.readString(raw, 'message') ?? 'OpenCode reported an error' };
+            }
+            default:
+                return null;
+        }
+    }
+    /** Points the adapter at a specific binary, from `AIAgentHarness.ExecutablePath`. */
+    SetExecutable(path) {
+        this.executable = path;
+    }
+};
+OpenCodeAdapter = __decorate([
+    RegisterClass(BaseHarnessAdapter, 'OpenCodeAdapter')
+], OpenCodeAdapter);
+export { OpenCodeAdapter };
+//# sourceMappingURL=OpenCodeAdapter.js.map

package/dist/adapters/OpenCodeAdapter.js.map

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

package/dist/adapters/PiAdapter.d.ts

@@ -0,0 +1,73 @@
+import { BaseCliHarnessAdapter, HarnessCliRawEvent } from './BaseCliHarnessAdapter.js';
+import { HarnessCapabilities, HarnessPermissionPolicy, HarnessTurnEvent } from '../types.js';
+/**
+ * Drives Pi (`@earendil-works/pi-coding-agent`).
+ *
+ * ## Verified against a real install, not inferred
+ *
+ * An earlier version of this adapter subclassed the generic stdio-JSON escape hatch, because the
+ * obvious npm names for Pi are placeholder reservations and there was no published contract to code
+ * against. With Pi actually installed (0.83.0), its CLI turns out to be well specified, so this is
+ * now a first-class adapter:
+ *
+ *   · `-p` / `--print`     non-interactive: process the prompt and exit
+ *   · `--mode json`        newline-delimited JSON events
+ *   · `--session-id <id>`  exact session, created if missing — so turns resume rather than replay
+ *   · `--provider <name>`  default `google`
+ *   · `--model <pattern>`  model pattern or `provider/id`
+ *
+ * The session-id form is what earns `SessionResume: true`: MJ supplies the id up front rather than
+ * discovering it, so continuity does not depend on parsing it back out before turn two.
+ *
+ * ## Authentication
+ *
+ * Pi resolves credentials from environment variables (or its own `/login`). It therefore works with
+ * the standard credential path — grant a credential whose `EnvVariableName` matches what the chosen
+ * provider expects — and equally with the "true local" mode, where a developer who has already run
+ * `pi /login` needs no credential row at all, because the local executor passes `HOME` through.
+ */
+export declare class PiAdapter extends BaseCliHarnessAdapter {
+    private executable;
+    private provider;
+    private permissionArgs;
+    protected get ExecutablePath(): string;
+    /** @inheritdoc */
+    get Capabilities(): HarnessCapabilities;
+    /**
+     * Maps MJ's posture onto Pi's `--tools` / `--exclude-tools`.
+     *
+     * Pi gates at the TOOL level, and unlike Claude Code's prefix-matched Bash patterns these are
+     * exact tool-name matches — so what this configures is what is enforced, with no way for a
+     * cleverly-flagged command to slip past. `strict` is therefore genuinely enforceable here,
+     * whereas on Claude Code it degrades to "prompts that have nowhere to go".
+     *
+     * ## Command-scoped patterns cannot be expressed, and are NOT quietly widened
+     *
+     * A policy authored for Claude Code may contain `Bash(git:*)`. Pi has no sub-command vocabulary,
+     * so the only faithful translations are "all of `bash`" or "none of it" — and those are not
+     * equivalent to what was written. The rule is fail-closed in both directions:
+     *
+     * - a command-scoped **allow** is DROPPED — granting the whole tool would hand over strictly more
+     *   authority than the policy asked for;
+     * - a command-scoped **deny** is WIDENED to the whole tool — denying more than asked is the safe
+     *   direction, and a policy that bothered to deny `git push` should not get all of `bash`.
+     *
+     * Silently widening an allow is the failure this whole capability exists to prevent.
+     */
+    ApplyPermissionPolicy(policy: HarnessPermissionPolicy): void;
+    /**
+     * Built-in tools each posture grants when no explicit allowlist is given.
+     *
+     * `dangerous` returns undefined — no `--tools` flag at all, leaving Pi's own defaults in place.
+     */
+    private defaultToolsForPosture;
+    /** Applies {@link PI_TOOL_ALIASES} and the command-scoped-pattern rules described above. */
+    private translateTools;
+    protected BuildTurnArgs(input: string, _isFirstTurn: boolean): string[];
+    protected MapEvent(raw: HarnessCliRawEvent): HarnessTurnEvent | null;
+    /** Points the adapter at a specific binary, from `AIAgentHarness.ExecutablePath`. */
+    SetExecutable(path: string): void;
+    /** Selects Pi's provider (default `google`), typically from the harness row's configuration. */
+    SetProvider(provider: string): void;
+}
+//# sourceMappingURL=PiAdapter.d.ts.map

package/dist/adapters/PiAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PiAdapter.d.ts","sourceRoot":"","sources":["../../src/adapters/PiAdapter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEvF,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAuB7F;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBACa,SAAU,SAAQ,qBAAqB;IAChD,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,cAAc,CAAgB;IAEtC,SAAS,KAAK,cAAc,IAAI,MAAM,CAErC;IAED,kBAAkB;IAClB,IAAW,YAAY,IAAI,mBAAmB,CAkB7C;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACa,qBAAqB,CAAC,MAAM,EAAE,uBAAuB,GAAG,IAAI;IAoB5E;;;;OAIG;IACH,OAAO,CAAC,sBAAsB;IAc9B,4FAA4F;IAC5F,OAAO,CAAC,cAAc;IAqBtB,SAAS,CAAC,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,GAAG,MAAM,EAAE;IAsBvE,SAAS,CAAC,QAAQ,CAAC,GAAG,EAAE,kBAAkB,GAAG,gBAAgB,GAAG,IAAI;IA8CpE,qFAAqF;IAC9E,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIxC,gGAAgG;IACzF,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;CAG7C"}

package/dist/adapters/PiAdapter.js

@@ -0,0 +1,237 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { RegisterClass } from '@memberjunction/global';
+import { BaseCliHarnessAdapter } from './BaseCliHarnessAdapter.js';
+import { BaseHarnessAdapter } from './BaseHarnessAdapter.js';
+/**
+ * Pi's built-in tools, from `pi --help` on a real install (0.83.0).
+ *
+ * `--tools` / `--exclude-tools` take Pi's own tool names, which are lowercase and differ from
+ * Claude Code's (`bash` not `Bash`, `find` not `Glob`). MJ's policy is written once in agent
+ * metadata, so the adapter — not the operator — is responsible for speaking each harness's
+ * vocabulary. Names not in this map pass through unchanged, so extension and custom tools still
+ * work; only the built-ins need translating.
+ */
+const PI_TOOL_ALIASES = {
+    Bash: 'bash',
+    Read: 'read',
+    Edit: 'edit',
+    Write: 'write',
+    Grep: 'grep',
+    Glob: 'find',
+};
+/** Mutating built-ins — what `strict` must leave out when no explicit allowlist is supplied. */
+const PI_READ_ONLY_TOOLS = ['read', 'grep', 'find'];
+/**
+ * Drives Pi (`@earendil-works/pi-coding-agent`).
+ *
+ * ## Verified against a real install, not inferred
+ *
+ * An earlier version of this adapter subclassed the generic stdio-JSON escape hatch, because the
+ * obvious npm names for Pi are placeholder reservations and there was no published contract to code
+ * against. With Pi actually installed (0.83.0), its CLI turns out to be well specified, so this is
+ * now a first-class adapter:
+ *
+ *   · `-p` / `--print`     non-interactive: process the prompt and exit
+ *   · `--mode json`        newline-delimited JSON events
+ *   · `--session-id <id>`  exact session, created if missing — so turns resume rather than replay
+ *   · `--provider <name>`  default `google`
+ *   · `--model <pattern>`  model pattern or `provider/id`
+ *
+ * The session-id form is what earns `SessionResume: true`: MJ supplies the id up front rather than
+ * discovering it, so continuity does not depend on parsing it back out before turn two.
+ *
+ * ## Authentication
+ *
+ * Pi resolves credentials from environment variables (or its own `/login`). It therefore works with
+ * the standard credential path — grant a credential whose `EnvVariableName` matches what the chosen
+ * provider expects — and equally with the "true local" mode, where a developer who has already run
+ * `pi /login` needs no credential row at all, because the local executor passes `HOME` through.
+ */
+let PiAdapter = class PiAdapter extends BaseCliHarnessAdapter {
+    constructor() {
+        super(...arguments);
+        this.executable = 'pi';
+        this.permissionArgs = [];
+    }
+    get ExecutablePath() {
+        return this.executable;
+    }
+    /** @inheritdoc */
+    get Capabilities() {
+        return {
+            // MJ supplies --session-id, so continuity does not depend on parsing an id back out.
+            SessionResume: true,
+            MidTurnCancellation: true,
+            // --mode json structures the TRANSPORT, not the model's content; the turn-end envelope
+            // is still coaxed by prompt and recovered by BaseAgent's malformed-response retry.
+            StructuredOutput: false,
+            UsageReporting: true,
+            // ApplyPermissionPolicy translates posture + allow/deny into --tools/--exclude-tools.
+            PermissionPolicy: true,
+            // Pi can gate tools at LAUNCH but exposes no mid-turn interception MJ can pause on, so
+            // there is still nowhere to route an approval request. Static policy, no HITL.
+            PermissionHooks: false,
+            McpClient: false,
+            WorkspaceScoping: true,
+            ModelSelection: true,
+        };
+    }
+    /**
+     * Maps MJ's posture onto Pi's `--tools` / `--exclude-tools`.
+     *
+     * Pi gates at the TOOL level, and unlike Claude Code's prefix-matched Bash patterns these are
+     * exact tool-name matches — so what this configures is what is enforced, with no way for a
+     * cleverly-flagged command to slip past. `strict` is therefore genuinely enforceable here,
+     * whereas on Claude Code it degrades to "prompts that have nowhere to go".
+     *
+     * ## Command-scoped patterns cannot be expressed, and are NOT quietly widened
+     *
+     * A policy authored for Claude Code may contain `Bash(git:*)`. Pi has no sub-command vocabulary,
+     * so the only faithful translations are "all of `bash`" or "none of it" — and those are not
+     * equivalent to what was written. The rule is fail-closed in both directions:
+     *
+     * - a command-scoped **allow** is DROPPED — granting the whole tool would hand over strictly more
+     *   authority than the policy asked for;
+     * - a command-scoped **deny** is WIDENED to the whole tool — denying more than asked is the safe
+     *   direction, and a policy that bothered to deny `git push` should not get all of `bash`.
+     *
+     * Silently widening an allow is the failure this whole capability exists to prevent.
+     */
+    ApplyPermissionPolicy(policy) {
+        const args = [];
+        const allowed = this.translateTools(policy.AllowedTools, 'allow');
+        const denied = this.translateTools(policy.DisallowedTools, 'deny');
+        // An explicit allowlist always wins over the posture default: the operator said exactly what
+        // they wanted. Without one, the posture picks a sensible built-in set.
+        const allowlist = allowed.length > 0 ? allowed : this.defaultToolsForPosture(policy.Posture);
+        if (allowlist) {
+            args.push('--tools', allowlist.join(','));
+        }
+        // Applied last and independently of --tools so deny wins on any overlap.
+        if (denied.length > 0) {
+            args.push('--exclude-tools', denied.join(','));
+        }
+        this.permissionArgs = args;
+    }
+    /**
+     * Built-in tools each posture grants when no explicit allowlist is given.
+     *
+     * `dangerous` returns undefined — no `--tools` flag at all, leaving Pi's own defaults in place.
+     */
+    defaultToolsForPosture(posture) {
+        switch (posture) {
+            case 'dangerous':
+                return undefined;
+            case 'auto':
+                // File mutation proceeds; shell does not. The analogue of Claude Code's acceptEdits,
+                // which likewise accepts edits while still gating command execution.
+                return [...PI_READ_ONLY_TOOLS, 'edit', 'write'];
+            case 'strict':
+            default:
+                return [...PI_READ_ONLY_TOOLS];
+        }
+    }
+    /** Applies {@link PI_TOOL_ALIASES} and the command-scoped-pattern rules described above. */
+    translateTools(tools, direction) {
+        if (!tools?.length) {
+            return [];
+        }
+        const out = [];
+        for (const tool of tools) {
+            const parenIndex = tool.indexOf('(');
+            if (parenIndex === -1) {
+                out.push(PI_TOOL_ALIASES[tool] ?? tool);
+                continue;
+            }
+            if (direction === 'deny') {
+                // Widen to the whole tool — the safe direction.
+                const base = tool.slice(0, parenIndex);
+                out.push(PI_TOOL_ALIASES[base] ?? base);
+            }
+            // direction === 'allow': dropped deliberately. See the method doc.
+        }
+        return [...new Set(out)];
+    }
+    BuildTurnArgs(input, _isFirstTurn) {
+        // The session id is generated once per session and passed on EVERY turn: --session-id
+        // creates the session if missing, so the first turn establishes it and later turns attach
+        // to it. No branch on first-vs-subsequent is needed, which removes a state bug by design.
+        if (!this.sessionId) {
+            this.sessionId = `mj-${Date.now().toString(36)}-${Math.floor(Math.random() * 1e6).toString(36)}`;
+        }
+        const args = ['-p', '--mode', 'json', '--session-id', this.sessionId];
+        if (this.provider) {
+            args.push('--provider', this.provider);
+        }
+        if (this.config?.Model) {
+            args.push('--model', this.config.Model);
+        }
+        // Per-invocation, like every other flag here: Pi's process dies at turn end, so a policy
+        // applied only at session start would silently lapse from turn two onward.
+        args.push(...this.permissionArgs);
+        args.push(input);
+        return args;
+    }
+    MapEvent(raw) {
+        const type = this.readString(raw, 'type');
+        switch (type) {
+            case 'session': {
+                // Pi announces its session up front; prefer its id over the one MJ proposed so
+                // AIAgentRun.ExternalSessionID correlates with Pi's own session files.
+                const id = this.readString(raw, 'id');
+                if (id) {
+                    this.sessionId = id;
+                }
+                return null;
+            }
+            case 'assistant':
+            case 'text':
+            case 'message': {
+                const text = this.readString(raw, 'text') ?? this.readString(raw, 'content');
+                return text ? { Type: 'assistant-text', Text: text } : null;
+            }
+            case 'tool':
+            case 'tool_use': {
+                return { Type: 'sandbox-activity', Description: this.readString(raw, 'name') ?? 'tool call' };
+            }
+            case 'usage': {
+                const usage = this.readObject(raw, 'usage') ?? raw;
+                return {
+                    Type: 'usage',
+                    InputTokens: this.readNumber(usage, 'input_tokens') ?? this.readNumber(usage, 'input') ?? 0,
+                    OutputTokens: this.readNumber(usage, 'output_tokens') ?? this.readNumber(usage, 'output') ?? 0,
+                    CostUsd: this.readNumber(usage, 'cost_usd') ?? this.readNumber(raw, 'cost'),
+                };
+            }
+            case 'result':
+            case 'done':
+            case 'complete': {
+                const text = this.readString(raw, 'result') ?? this.readString(raw, 'text') ?? '';
+                return { Type: 'turn-complete', RawText: text };
+            }
+            case 'error': {
+                return { Type: 'session-error', Error: this.readString(raw, 'message') ?? 'Pi reported an error' };
+            }
+            default:
+                return null;
+        }
+    }
+    /** Points the adapter at a specific binary, from `AIAgentHarness.ExecutablePath`. */
+    SetExecutable(path) {
+        this.executable = path;
+    }
+    /** Selects Pi's provider (default `google`), typically from the harness row's configuration. */
+    SetProvider(provider) {
+        this.provider = provider;
+    }
+};
+PiAdapter = __decorate([
+    RegisterClass(BaseHarnessAdapter, 'PiAdapter')
+], PiAdapter);
+export { PiAdapter };
+//# sourceMappingURL=PiAdapter.js.map

package/dist/adapters/PiAdapter.js.map

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

package/dist/adapters/StdioJsonAdapter.d.ts

@@ -0,0 +1,43 @@
+import { BaseCliHarnessAdapter, HarnessCliRawEvent } from './BaseCliHarnessAdapter.js';
+import { HarnessCapabilities, HarnessTurnEvent } from '../types.js';
+/**
+ * Drives ANY command that speaks a documented newline-delimited JSON event contract.
+ *
+ * This is the escape hatch that keeps "adding a harness must not require core changes" true in the
+ * strong sense: a harness MJ has never heard of works with zero MJ code, provided its CLI emits
+ * lines matching the vocabulary below.
+ *
+ * ## The contract
+ *
+ * Each stdout line is a JSON object with a `type` field:
+ *
+ * | `type`       | Other fields                          | Meaning                                  |
+ * |--------------|---------------------------------------|------------------------------------------|
+ * | `text`       | `text`                                | Narration; streamed, never persisted     |
+ * | `activity`   | `description`                         | In-sandbox activity, for live view only  |
+ * | `permission` | `id`, `description`, `command?`       | Requests approval; becomes a HITL row    |
+ * | `usage`      | `input_tokens`, `output_tokens`, `cost_usd?` | Turn usage; drives cost guardrails |
+ * | `complete`   | `text`                                | Turn ended; `text` carries the envelope  |
+ * | `error`      | `message`                             | Turn failed                              |
+ *
+ * Unrecognised lines are ignored, so a harness may interleave its own diagnostics freely.
+ *
+ * Capabilities default to the conservative end — an unknown harness is assumed NOT to resume
+ * sessions or honour permission hooks, so the runtime emulates continuity rather than silently
+ * losing context. Override via `AIAgentHarness.CapabilitySettings` when the harness does better.
+ */
+export declare class StdioJsonAdapter extends BaseCliHarnessAdapter {
+    protected executable: string;
+    protected extraArgs: string[];
+    protected declaredCapabilities: HarnessCapabilities | null;
+    protected get ExecutablePath(): string;
+    /** @inheritdoc */
+    get Capabilities(): HarnessCapabilities;
+    protected BuildTurnArgs(input: string, _isFirstTurn: boolean): string[];
+    protected MapEvent(raw: HarnessCliRawEvent): HarnessTurnEvent | null;
+    /** Configures the command, extra argv and declared capabilities from `AIAgentHarness` metadata. */
+    Configure(executable: string, extraArgs: string[], capabilities: HarnessCapabilities | null): void;
+    /** Points the adapter at a specific binary, from `AIAgentHarness.ExecutablePath`. */
+    SetExecutable(path: string): void;
+}
+//# sourceMappingURL=StdioJsonAdapter.d.ts.map

package/dist/adapters/StdioJsonAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StdioJsonAdapter.d.ts","sourceRoot":"","sources":["../../src/adapters/StdioJsonAdapter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEvF,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpE;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBACa,gBAAiB,SAAQ,qBAAqB;IACvD,SAAS,CAAC,UAAU,SAAa;IACjC,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,CAAM;IACnC,SAAS,CAAC,oBAAoB,EAAE,mBAAmB,GAAG,IAAI,CAAQ;IAElE,SAAS,KAAK,cAAc,IAAI,MAAM,CAErC;IAED,kBAAkB;IAClB,IAAW,YAAY,IAAI,mBAAmB,CAiB7C;IAED,SAAS,CAAC,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,GAAG,MAAM,EAAE;IAIvE,SAAS,CAAC,QAAQ,CAAC,GAAG,EAAE,kBAAkB,GAAG,gBAAgB,GAAG,IAAI;IA6BpE,mGAAmG;IAC5F,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,YAAY,EAAE,mBAAmB,GAAG,IAAI,GAAG,IAAI;IAMzG,qFAAqF;IAC9E,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;CAG3C"}