@aligndottech/cli 0.67.0 → 0.68.0

package/dist/lib/agent/edit-gate.js

@@ -0,0 +1,67 @@
+import { decisionLinkFor } from '../decision-links.js';
+import { proposedChangeText } from './edit-text.js';
+/** Same budget as the advisory hook's retrieval (check.ts RETRIEVAL_TIMEOUT_MS). */
+const RETRIEVAL_MS = 2500;
+const ADJUDICATE_MS = 15_000;
+/** A card's why is one short line: a git-imported summary is the whole commit body. */
+const WHY_MAX = 160;
+function shortWhy(summary) {
+    const first = summary?.split('\n').map((l) => l.trim()).find(Boolean);
+    if (!first)
+        return undefined;
+    return first.length > WHY_MAX ? `${first.slice(0, WHY_MAX - 3).trimEnd()}...` : first;
+}
+const TIMED_OUT = Symbol('timed-out');
+function within(ms, work) {
+    let timer;
+    const late = new Promise((resolve) => { timer = setTimeout(() => resolve(TIMED_OUT), ms); });
+    return Promise.race([work, late]).finally(() => clearTimeout(timer));
+}
+export async function gateEdit(ask, deps) {
+    // An edit with no path is a shape this gate cannot read (an engine field it does not map).
+    // It asks rather than passing unseen.
+    const filePath = ask.edit?.file_path ?? '';
+    if (!filePath)
+        return { kind: 'ask', reason: 'unchecked', cards: [] };
+    // A deletion has no new text to search with, but blame still reads the lines it removes.
+    const text = proposedChangeText(ask.edit);
+    const noRelated = Promise.resolve({ relevant_decisions: [] });
+    // Separate budgets: a failed or slow retrieval must not throw away a blame hit, which is the
+    // stronger signal and the one that asks the person.
+    const ms = deps.retrievalMs ?? RETRIEVAL_MS;
+    const settle = (work) => within(ms, work).catch(() => TIMED_OUT);
+    const [related, wrote] = await Promise.all([
+        settle(text.trim() ? deps.client.checkAlignment(text, filePath, { depth: 'related' }) : noRelated),
+        settle(deps.blame(ask.edit, deps.cwd)),
+    ]);
+    const blameCards = (wrote === TIMED_OUT ? [] : wrote).map((d) => ({ id: d.id, title: d.title, via: 'blame' }));
+    const seen = new Set(blameCards.map((c) => c.id));
+    const retrievalCards = (related === TIMED_OUT ? [] : related.relevant_decisions ?? [])
+        .filter((d) => !seen.has(d.id))
+        .map((d) => ({ id: d.id, title: d.title, why: shortWhy(d.summary), url: decisionLinkFor(d), via: 'retrieval' }));
+    // A blame hit always reaches the person, and no model verdict can clear it: that the edit
+    // rewrites lines a decision wrote is a fact from git, a verdict is a guess about a fragment
+    // (measured on fastify #7089, 6 Nov: "not a conflict" let the reversal through). So no model
+    // call is spent here either.
+    if (blameCards.length)
+        return { kind: 'ask', reason: 'rewrites-decided-lines', cards: [...blameCards, ...retrievalCards] };
+    // No blame hit. A half that did not finish makes the result "not checked", but what the other
+    // half found is still used: retrieval hits are still adjudicated and shown when blame timed out.
+    const unfinished = related === TIMED_OUT || wrote === TIMED_OUT;
+    if (!retrievalCards.length)
+        return unfinished ? { kind: 'allow', cards: [], note: 'not-checked' } : { kind: 'allow', cards: [] };
+    // Retrieval alone only finds what is similar. A model may escalate that to a question; it
+    // never turns a question into a silent pass, because there is none to clear.
+    if (deps.canAdjudicate()) {
+        const verdict = await within(deps.adjudicateMs ?? ADJUDICATE_MS, deps.client.checkAlignment(text, filePath, { depth: 'full' })).catch(() => TIMED_OUT);
+        if (verdict !== TIMED_OUT && verdict.status === 'conflicting') {
+            const cards = (verdict.conflicts ?? []).map((c) => ({ id: c.decision_id, title: c.title, why: c.reason, url: decisionLinkFor(c), via: 'verdict' }));
+            return { kind: 'ask', reason: 'conflict', cards };
+        }
+        // A verdict that never came is not a verdict: keep the cards, and say it was not checked.
+        if (verdict === TIMED_OUT || verdict.status === 'unknown')
+            return { kind: 'allow', cards: retrievalCards, note: 'not-checked' };
+    }
+    return unfinished ? { kind: 'allow', cards: retrievalCards, note: 'not-checked' } : { kind: 'allow', cards: retrievalCards };
+}
+//# sourceMappingURL=edit-gate.js.map

package/dist/lib/agent/edit-gate.js.map

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

package/dist/lib/agent/edit-text.d.ts

@@ -0,0 +1,14 @@
+import type { HookToolInput } from '../hook-payload.js';
+export type RelatedDecision = {
+    id: string;
+    title: string;
+    summary?: string;
+};
+/**
+ * The decisions that wrote the lines this edit replaces: `git blame` the lines, then a keyed lookup
+ * of the blamed commits and PRs in the graph. Local mode only (the cloud client has no such lookup yet,
+ * so it is skipped). Fail-open: any problem returns [] and the hook behaves as it did before.
+ */
+export declare function decisionsThatWroteTheseLines(client: unknown, input: HookToolInput | undefined, cwd: string): Promise<RelatedDecision[]>;
+export declare function proposedChangeText(input?: HookToolInput): string;
+//# sourceMappingURL=edit-text.d.ts.map

package/dist/lib/agent/edit-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit-text.d.ts","sourceRoot":"","sources":["../../../src/lib/agent/edit-text.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGxD,MAAM,MAAM,eAAe,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAI9E;;;;GAIG;AACH,wBAAsB,4BAA4B,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,aAAa,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAU7I;AAID,wBAAgB,kBAAkB,CAAC,KAAK,CAAC,EAAE,aAAa,GAAG,MAAM,CAMhE"}

package/dist/lib/agent/edit-text.js

@@ -0,0 +1,34 @@
+import { findLineWriters, isWriterTitle } from '../blame-attribution.js';
+/**
+ * The decisions that wrote the lines this edit replaces: `git blame` the lines, then a keyed lookup
+ * of the blamed commits and PRs in the graph. Local mode only (the cloud client has no such lookup yet,
+ * so it is skipped). Fail-open: any problem returns [] and the hook behaves as it did before.
+ */
+export async function decisionsThatWroteTheseLines(client, input, cwd) {
+    try {
+        const lookup = client.decisionsBySourceRefs;
+        if (typeof lookup !== 'function')
+            return [];
+        const writers = await findLineWriters(input, cwd);
+        if (!writers)
+            return [];
+        return lookup.call(client, writers.commitShas, writers.prUrls).filter((d) => isWriterTitle(d.title)).slice(0, 5);
+    }
+    catch {
+        return [];
+    }
+}
+// The proposed change from a PreToolUse payload: Write sends the full content, Edit a
+// new_string, MultiEdit a list of edits. We check the new text against the graph.
+export function proposedChangeText(input) {
+    if (!input)
+        return '';
+    if (typeof input.content === 'string')
+        return input.content;
+    if (Array.isArray(input.edits))
+        return input.edits.map((e) => e.new_string ?? '').join('\n');
+    if (typeof input.new_string === 'string')
+        return input.new_string;
+    return '';
+}
+//# sourceMappingURL=edit-text.js.map

package/dist/lib/agent/edit-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit-text.js","sourceRoot":"","sources":["../../../src/lib/agent/edit-text.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAMzE;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAAC,MAAe,EAAE,KAAgC,EAAE,GAAW;IAC/G,IAAI,CAAC;QACH,MAAM,MAAM,GAAI,MAAyB,CAAC,qBAAqB,CAAC;QAChE,IAAI,OAAO,MAAM,KAAK,UAAU;YAAE,OAAO,EAAE,CAAC;QAC5C,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAClD,IAAI,CAAC,OAAO;YAAE,OAAO,EAAE,CAAC;QACxB,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACnH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,sFAAsF;AACtF,kFAAkF;AAClF,MAAM,UAAU,kBAAkB,CAAC,KAAqB;IACtD,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC,OAAO,CAAC;IAC5D,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7F,IAAI,OAAO,KAAK,CAAC,UAAU,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC,UAAU,CAAC;IAClE,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/lib/agent/engines/claude-code-protocol.d.ts

@@ -0,0 +1,24 @@
+import type { AgentUiEvent, BrokerVerdict, ToolAsk } from '../types.js';
+/**
+ * The wire format of the user's own `claude` in stream-json mode, as probed against 2.1.318.
+ * Everything here is pure so a change in Claude Code's format is fixed in one file.
+ */
+export interface ParsedLine {
+    events: AgentUiEvent[];
+    /** The engine saw its system/init line. */
+    init?: true;
+    /** A can_use_tool request the host must answer. */
+    permission?: {
+        requestId: string;
+        ask: ToolAsk;
+        input: Record<string, unknown>;
+    };
+}
+/** `manual` + host prompts: every permission question comes to us. Never bypassPermissions. */
+export declare function buildArgs(extra?: string[]): string[];
+export declare const initializeLine: (requestId: string) => string;
+export declare const userMessageLine: (text: string) => string;
+export declare const interruptLine: (requestId: string) => string;
+export declare function controlResponse(requestId: string, verdict: BrokerVerdict, input: Record<string, unknown>): string;
+export declare function parseLine(raw: string): ParsedLine;
+//# sourceMappingURL=claude-code-protocol.d.ts.map

package/dist/lib/agent/engines/claude-code-protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code-protocol.d.ts","sourceRoot":"","sources":["../../../../src/lib/agent/engines/claude-code-protocol.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,OAAO,EAAY,MAAM,aAAa,CAAC;AAElF;;;GAGG;AAEH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,2CAA2C;IAC3C,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,mDAAmD;IACnD,UAAU,CAAC,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;CAClF;AAOD,+FAA+F;AAC/F,wBAAgB,SAAS,CAAC,KAAK,GAAE,MAAM,EAAO,GAAG,MAAM,EAAE,CAOxD;AAED,eAAO,MAAM,cAAc,GAAI,WAAW,MAAM,KAAG,MAC2C,CAAC;AAC/F,eAAO,MAAM,eAAe,GAAI,MAAM,MAAM,KAAG,MACmB,CAAC;AACnE,eAAO,MAAM,aAAa,GAAI,WAAW,MAAM,KAAG,MAC2C,CAAC;AAE9F,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAGjH;AA8CD,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CA4CjD"}

package/dist/lib/agent/engines/claude-code-protocol.js

@@ -0,0 +1,123 @@
+const asRecord = (v) => (v && typeof v === 'object' && !Array.isArray(v) ? v : null);
+const str = (v) => (typeof v === 'string' ? v : undefined);
+const line = (o) => `${JSON.stringify(o)}\n`;
+/** `manual` + host prompts: every permission question comes to us. Never bypassPermissions. */
+export function buildArgs(extra = []) {
+    return ['-p', '--input-format', 'stream-json', '--output-format', 'stream-json', '--verbose',
+        '--include-partial-messages', '--permission-mode', 'manual', '--permission-prompts', 'host',
+        '--permission-prompt-tool', 'stdio',
+        // The user's own settings only. A repo's .claude/settings.json could otherwise run its hooks and
+        // pre-approve tools before Align is asked, and headless claude shows no trust prompt for it.
+        '--setting-sources', 'user', ...extra];
+}
+export const initializeLine = (requestId) => line({ type: 'control_request', request_id: requestId, request: { subtype: 'initialize' } });
+export const userMessageLine = (text) => line({ type: 'user', message: { role: 'user', content: text } });
+export const interruptLine = (requestId) => line({ type: 'control_request', request_id: requestId, request: { subtype: 'interrupt' } });
+export function controlResponse(requestId, verdict, input) {
+    const response = verdict.allow ? { behavior: 'allow', updatedInput: input } : { behavior: 'deny', message: verdict.message };
+    return line({ type: 'control_response', response: { subtype: 'success', request_id: requestId, response } });
+}
+const EDIT_TOOLS = new Set(['Write', 'Edit', 'MultiEdit', 'NotebookEdit']);
+const COMMAND_TOOLS = new Set(['Bash', 'PowerShell']);
+const READ_TOOLS = new Set(['Read', 'Glob', 'Grep', 'LS', 'TodoWrite']);
+function kindOf(tool) {
+    if (EDIT_TOOLS.has(tool))
+        return 'edit';
+    if (COMMAND_TOOLS.has(tool))
+        return 'command';
+    return READ_TOOLS.has(tool) ? 'read' : 'other';
+}
+/** Only the fields the hook check reads, so the gate sees the same shape from every engine. */
+function toEdit(input) {
+    const out = {};
+    const path = str(input['file_path']) ?? str(input['notebook_path']);
+    if (path !== undefined)
+        out.file_path = path;
+    if (str(input['content']) !== undefined)
+        out.content = str(input['content']);
+    if (str(input['old_string']) !== undefined)
+        out.old_string = str(input['old_string']);
+    const next = str(input['new_string']) ?? str(input['new_source']);
+    if (next !== undefined)
+        out.new_string = next;
+    if (Array.isArray(input['edits']))
+        out.edits = input['edits'];
+    return out;
+}
+function toAsk(id, tool, input) {
+    const kind = kindOf(tool);
+    const ask = { id, tool, kind };
+    if (kind === 'edit')
+        ask.edit = toEdit(input);
+    if (kind === 'command')
+        ask.command = str(input['command']) ?? '';
+    if (kind === 'other')
+        ask.detail = JSON.stringify(input);
+    return ask;
+}
+function summaryOf(tool, input) {
+    const kind = kindOf(tool);
+    if (kind === 'command')
+        return str(input['command']) ?? tool;
+    if (kind === 'edit')
+        return str(input['file_path']) ?? tool;
+    return tool;
+}
+function contentBlocks(msg) {
+    const content = asRecord(msg['message'])?.['content'];
+    return Array.isArray(content) ? content.map(asRecord).filter((b) => b !== null) : [];
+}
+export function parseLine(raw) {
+    let msg;
+    try {
+        msg = asRecord(JSON.parse(raw));
+    }
+    catch {
+        return { events: [] };
+    }
+    if (!msg)
+        return { events: [] };
+    switch (msg['type']) {
+        case 'system':
+            return msg['subtype'] === 'init' ? { events: [], init: true } : { events: [] };
+        case 'result': {
+            // An error result ("Not logged in", a refused request) must show, not read as an empty turn.
+            const failed = msg['is_error'] === true ? str(msg['result']) : undefined;
+            return { events: failed ? [{ type: 'error', message: failed }, { type: 'turn-end' }] : [{ type: 'turn-end' }] };
+        }
+        case 'stream_event': {
+            const delta = asRecord(asRecord(msg['event'])?.['delta']);
+            const text = delta?.['type'] === 'text_delta' ? str(delta['text']) : undefined;
+            return { events: text === undefined ? [] : [{ type: 'text', delta: text }] };
+        }
+        case 'assistant': {
+            const events = [];
+            for (const b of contentBlocks(msg)) {
+                if (b['type'] !== 'tool_use')
+                    continue;
+                const tool = str(b['name']) ?? '';
+                events.push({ type: 'tool-start', id: str(b['id']) ?? '', tool, summary: summaryOf(tool, asRecord(b['input']) ?? {}) });
+            }
+            return { events };
+        }
+        case 'user': {
+            const events = [];
+            for (const b of contentBlocks(msg)) {
+                if (b['type'] === 'tool_result')
+                    events.push({ type: 'tool-end', id: str(b['tool_use_id']) ?? '', ok: b['is_error'] !== true });
+            }
+            return { events };
+        }
+        case 'control_request': {
+            const req = asRecord(msg['request']);
+            if (req?.['subtype'] !== 'can_use_tool')
+                return { events: [] };
+            const input = asRecord(req['input']) ?? {};
+            const tool = str(req['tool_name']) ?? '';
+            return { events: [], permission: { requestId: str(msg['request_id']) ?? '', ask: toAsk(str(req['tool_use_id']) ?? '', tool, input), input } };
+        }
+        default:
+            return { events: [] };
+    }
+}
+//# sourceMappingURL=claude-code-protocol.js.map

package/dist/lib/agent/engines/claude-code-protocol.js.map

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

package/dist/lib/agent/engines/claude-code.d.ts

@@ -0,0 +1,17 @@
+import { spawn as nodeSpawn } from 'node:child_process';
+import type { AgentEngine } from '../types.js';
+export interface ClaudeCodeOpts {
+    cwd: string;
+    bin?: string;
+    extraArgs?: string[];
+    /** Exactly the child's env. The caller passes the user's startup env so a key Align saved never reaches `claude`. */
+    env: Record<string, string | undefined>;
+    spawn?: typeof nodeSpawn;
+    firstEventTimeoutMs?: number;
+}
+/**
+ * Drives the user's own, unmodified `claude` over stream-json. Align never touches its auth or
+ * model: it only answers the permission questions `claude` asks the host.
+ */
+export declare function createClaudeCodeEngine(opts: ClaudeCodeOpts): AgentEngine;
+//# sourceMappingURL=claude-code.d.ts.map

package/dist/lib/agent/engines/claude-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code.d.ts","sourceRoot":"","sources":["../../../../src/lib/agent/engines/claude-code.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuC,KAAK,IAAI,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC7F,OAAO,KAAK,EAAE,WAAW,EAAwC,MAAM,aAAa,CAAC;AAGrF,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,qHAAqH;IACrH,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACxC,KAAK,CAAC,EAAE,OAAO,SAAS,CAAC;IACzB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAKD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,cAAc,GAAG,WAAW,CAyGxE"}

package/dist/lib/agent/engines/claude-code.js

@@ -0,0 +1,122 @@
+import { spawn as nodeSpawn } from 'node:child_process';
+import { buildArgs, controlResponse, initializeLine, interruptLine, parseLine, userMessageLine } from './claude-code-protocol.js';
+const NOT_INSTALLED = 'Claude Code is not installed (no `claude` on PATH)';
+const KILL_AFTER_MS = 2000;
+/**
+ * Drives the user's own, unmodified `claude` over stream-json. Align never touches its auth or
+ * model: it only answers the permission questions `claude` asks the host.
+ */
+export function createClaudeCodeEngine(opts) {
+    const spawnFn = opts.spawn ?? nodeSpawn;
+    const firstEventTimeoutMs = opts.firstEventTimeoutMs ?? 20000;
+    let child;
+    let exitMessage;
+    let pending;
+    let emit = () => { };
+    let broker = async () => ({ allow: true });
+    let stderrTail = '';
+    let initTimer;
+    let buffer = '';
+    let interrupts = 0;
+    const send = (text) => { child?.stdin.write(text); };
+    async function answer(requestId, ask, input) {
+        let verdict;
+        try {
+            verdict = await broker(ask);
+        }
+        catch (err) {
+            // Never leave `claude` waiting on a question nobody will answer.
+            verdict = { allow: false, message: `Align could not check this action (${err instanceof Error ? err.message : String(err)}). Do not retry it.` };
+        }
+        send(controlResponse(requestId, verdict, input));
+    }
+    function onLine(raw) {
+        if (!raw.trim())
+            return;
+        const parsed = parseLine(raw);
+        if (parsed.init)
+            clearTimeout(initTimer);
+        for (const e of parsed.events) {
+            emit(e);
+            if (e.type === 'turn-end') {
+                pending?.resolve();
+                pending = undefined;
+            }
+        }
+        if (parsed.permission)
+            void answer(parsed.permission.requestId, parsed.permission.ask, parsed.permission.input);
+    }
+    return {
+        label: 'Claude Code',
+        start(onEvent, onAsk) {
+            emit = onEvent;
+            broker = onAsk;
+            return new Promise((resolve, reject) => {
+                const c = spawnFn(opts.bin ?? 'claude', buildArgs(opts.extraArgs), { cwd: opts.cwd, env: opts.env, stdio: ['pipe', 'pipe', 'pipe'] });
+                child = c;
+                c.stdout.on('data', (d) => {
+                    buffer += String(d);
+                    let i;
+                    while ((i = buffer.indexOf('\n')) >= 0) {
+                        const l = buffer.slice(0, i);
+                        buffer = buffer.slice(i + 1);
+                        onLine(l);
+                    }
+                });
+                c.stderr.on('data', (d) => { stderrTail = (stderrTail + String(d)).slice(-500); });
+                // A claude that died mid-write breaks the pipe. The 'exit' handler reports the death;
+                // an unhandled stream error here would crash Align instead.
+                c.stdin.on('error', () => { });
+                c.once('error', (err) => {
+                    const message = err.code === 'ENOENT' ? NOT_INSTALLED : err.message;
+                    emit({ type: 'error', message });
+                    reject(new Error(message));
+                });
+                c.once('exit', (code, signal) => {
+                    clearTimeout(initTimer);
+                    exitMessage = `Claude Code exited (${signal ? `signal ${signal}` : `code ${code}`})${stderrTail.trim() ? `: ${stderrTail.trim()}` : ''}`;
+                    if (pending) {
+                        emit({ type: 'error', message: exitMessage });
+                        pending.reject(new Error(exitMessage));
+                        pending = undefined;
+                    }
+                });
+                c.once('spawn', () => {
+                    send(initializeLine(`init-${Date.now()}`));
+                    // A claude that never starts ends the run: the waiting turn fails, the child is stopped,
+                    // and later prompts are refused with the same reason, so the screen never hangs.
+                    initTimer = setTimeout(() => {
+                        exitMessage = `Claude Code did not start within ${Math.round(firstEventTimeoutMs / 1000)}s. Run \`claude --version\` to check it works.`;
+                        emit({ type: 'error', message: exitMessage });
+                        pending?.reject(new Error(exitMessage));
+                        pending = undefined;
+                        c.kill();
+                    }, firstEventTimeoutMs);
+                    resolve();
+                });
+            });
+        },
+        prompt(text) {
+            if (exitMessage)
+                return Promise.reject(new Error(exitMessage));
+            return new Promise((resolve, reject) => {
+                pending = { resolve, reject };
+                send(userMessageLine(text));
+            });
+        },
+        // Verified against claude 2.1.318: it answers with a result line (error_during_execution), which
+        // ends the turn through the normal path, and the process stays up for the next prompt.
+        abort() { send(interruptLine(`int-${++interrupts}`)); },
+        close() {
+            const c = child;
+            if (!c || exitMessage)
+                return Promise.resolve();
+            return new Promise((resolve) => {
+                const killer = setTimeout(() => c.kill(), KILL_AFTER_MS);
+                c.once('exit', () => { clearTimeout(killer); resolve(); });
+                c.stdin.end();
+            });
+        },
+    };
+}
+//# sourceMappingURL=claude-code.js.map

package/dist/lib/agent/engines/claude-code.js.map

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

package/dist/lib/agent/engines/pi-models.d.ts

@@ -0,0 +1,46 @@
+import { type SavedLlmConfig } from '../../local-llm.js';
+/**
+ * Which model the Align engine runs, and the key to run it with. No Pi types here: the result is
+ * plain data and pi.ts builds Pi's model from it.
+ *
+ * Keys come from what the user already gave Align (an exported variable, or a key saved with
+ * `align ai`) and travel in-process only (H1): they are never put into process.env, so a child
+ * process cannot inherit them.
+ *
+ * NEVER a subscription login. Anthropic's terms forbid a Claude subscription login in third-party
+ * apps, and Pi's other OAuth providers (openai-codex, github-copilot, ...) are partner-only. Nothing
+ * here, or in pi.ts, calls or offers Pi's login; an override naming one is refused.
+ */
+export interface ResolvedPiModel {
+    /** Pi's provider id, which is not always Align's (Align says gemini and grok; Pi says google and xai). */
+    provider: string;
+    modelId: string;
+    apiKey?: string;
+    /** Set for Ollama only: its OpenAI-compatible endpoint. */
+    baseUrl?: string;
+    /** Shown in the header, e.g. "Anthropic claude-sonnet-5-5". */
+    label: string;
+}
+/**
+ * The default coding-grade model per Align provider, read from Pi 1.5.0's catalogue (the test
+ * asserts every entry exists there, so a Pi bump that drops one fails loudly).
+ *  - anthropic: Sonnet 5.5, the model the engine was built and tried against.
+ *  - openai: gpt-6.1-sol, the newest non-pro flagship, priced like Sonnet 5.5 ($2/$10 per Mtok).
+ *  - gemini: gemini-3.1-pro-preview, the only Pro-tier model in the catalogue (the rest are Flash).
+ *  - grok: grok-4.7, the newest Grok. groq: gpt-oss-120b, its largest tool-calling model.
+ *  - mistral: mistral-large-4, the newest large model with reasoning. deepseek: deepseek-v4-pro.
+ * Other Align providers (OpenRouter, a custom endpoint, the long tail) have no default: pick one
+ * with ALIGN_AGENT_MODEL, because a guess at a model on a gateway we cannot enumerate is worse than asking.
+ */
+export declare const DEFAULT_PI_MODELS: Record<string, {
+    provider: string;
+    modelId: string;
+}>;
+export interface ResolvePiModelOptions {
+    /** Keys saved by `align ai`. The caller reads them from the config store; they never touch process.env. */
+    saved?: SavedLlmConfig;
+    /** Injected so tests need no network. Returns the model a reachable Ollama would use, or null. */
+    probeOllama?: () => Promise<string | null>;
+}
+export declare function resolvePiModel(opts?: ResolvePiModelOptions): Promise<ResolvedPiModel | undefined>;
+//# sourceMappingURL=pi-models.d.ts.map

package/dist/lib/agent/engines/pi-models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi-models.d.ts","sourceRoot":"","sources":["../../../../src/lib/agent/engines/pi-models.ts"],"names":[],"mappings":"AACA,OAAO,EAAsD,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAE7G;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,eAAe;IAC9B,0GAA0G;IAC1G,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+DAA+D;IAC/D,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAQnF,CAAC;AAOF,MAAM,WAAW,qBAAqB;IACpC,2GAA2G;IAC3G,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,kGAAkG;IAClG,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC5C;AAuBD,wBAAsB,cAAc,CAAC,IAAI,GAAE,qBAA0B,GAAG,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CA2C3G"}

package/dist/lib/agent/engines/pi-models.js

@@ -0,0 +1,91 @@
+import { NAMED_PROVIDERS, namedProvider } from '../../llm-providers.js';
+import { preferredProvider, probeOllama as probeLocalOllama } from '../../local-llm.js';
+/**
+ * The default coding-grade model per Align provider, read from Pi 1.5.0's catalogue (the test
+ * asserts every entry exists there, so a Pi bump that drops one fails loudly).
+ *  - anthropic: Sonnet 5.5, the model the engine was built and tried against.
+ *  - openai: gpt-6.1-sol, the newest non-pro flagship, priced like Sonnet 5.5 ($2/$10 per Mtok).
+ *  - gemini: gemini-3.1-pro-preview, the only Pro-tier model in the catalogue (the rest are Flash).
+ *  - grok: grok-4.7, the newest Grok. groq: gpt-oss-120b, its largest tool-calling model.
+ *  - mistral: mistral-large-4, the newest large model with reasoning. deepseek: deepseek-v4-pro.
+ * Other Align providers (OpenRouter, a custom endpoint, the long tail) have no default: pick one
+ * with ALIGN_AGENT_MODEL, because a guess at a model on a gateway we cannot enumerate is worse than asking.
+ */
+export const DEFAULT_PI_MODELS = {
+    anthropic: { provider: 'anthropic', modelId: 'claude-sonnet-5-5' },
+    openai: { provider: 'openai', modelId: 'gpt-6.1-sol' },
+    gemini: { provider: 'google', modelId: 'gemini-3.1-pro-preview' },
+    grok: { provider: 'xai', modelId: 'grok-4.7' },
+    groq: { provider: 'groq', modelId: 'openai/gpt-oss-120b' },
+    mistral: { provider: 'mistral', modelId: 'mistral-large-4' },
+    deepseek: { provider: 'deepseek', modelId: 'deepseek-v4-pro' },
+};
+/** Pi providers that sign in with a subscription. Refused outright (see the header). */
+const SUBSCRIPTION_PROVIDERS = new Set([
+    'openai-codex', 'openai-chatgpt', 'github-copilot', 'google-gemini-cli', 'google-antigravity',
+]);
+const label = (alignId, modelId) => `${namedProvider(alignId)?.label ?? alignId} ${modelId}`;
+/** The key for one Align provider: a saved key, or an exported one that Align is allowed to use. */
+function keyFor(alignId, saved, preferred) {
+    const p = namedProvider(alignId);
+    if (!p)
+        return undefined;
+    const exported = p.keyEnv.map((n) => process.env[n]).find(Boolean);
+    const saveKey = saved.keys[alignId];
+    // Same rule as local-llm's credentials(): an exported key beyond the original six may be there for
+    // another tool, so it counts only when the user also saved one or chose the provider.
+    if (exported && (p.autoFromEnv || preferred === alignId || saveKey))
+        return exported;
+    return saveKey;
+}
+/** A local Ollama model. `||`, not `??`: OLLAMA_HOST='' must not make a relative URL (local-llm's ollamaHost says why). */
+function ollamaModel(model) {
+    const host = (process.env['OLLAMA_HOST'] || 'http://localhost:11434').replace(/\/+$/, '');
+    return { provider: 'ollama', modelId: model, apiKey: 'ollama', baseUrl: `${host}/v1`, label: `Ollama ${model}` };
+}
+export async function resolvePiModel(opts = {}) {
+    const saved = opts.saved ?? { keys: {} };
+    const preferred = preferredProvider(saved);
+    const override = process.env['ALIGN_AGENT_MODEL'];
+    if (override) {
+        const slash = override.indexOf('/');
+        if (slash < 1 || slash === override.length - 1) {
+            throw new Error(`ALIGN_AGENT_MODEL must be provider/model-id (for example anthropic/claude-sonnet-5-5), got "${override}".`);
+        }
+        const provider = override.slice(0, slash);
+        const modelId = override.slice(slash + 1);
+        // Ollama needs no key: the override names the local model to run.
+        if (provider === 'ollama')
+            return ollamaModel(modelId);
+        if (SUBSCRIPTION_PROVIDERS.has(provider)) {
+            throw new Error(`ALIGN_AGENT_MODEL names ${provider}, which signs in with a subscription. Align runs on API keys only: use a provider you have a key for.`);
+        }
+        const alignId = Object.entries(DEFAULT_PI_MODELS).find(([, d]) => d.provider === provider)?.[0] ?? provider;
+        const apiKey = namedProvider(alignId) ? keyFor(alignId, saved, preferred) : undefined;
+        if (!apiKey)
+            throw new Error(`ALIGN_AGENT_MODEL names ${provider}, but there is no key for it. Export its key or run align ai.`);
+        return { provider, modelId, apiKey, label: label(alignId, modelId) };
+    }
+    const probe = opts.probeOllama ?? probeLocalOllama;
+    // A user who chose Ollama gets Ollama when it runs, before any exported key: a local choice must
+    // not quietly become a paid API call.
+    if (preferred === 'ollama') {
+        const local = await probe();
+        if (local)
+            return ollamaModel(local);
+    }
+    // The preference goes first, then the fixed provider order, so the answer does not depend on which
+    // shell variable happens to be set.
+    const order = [preferred, ...NAMED_PROVIDERS.map((p) => p.id)].filter((id) => Boolean(id) && id !== 'ollama' && id !== 'custom' && id !== 'openrouter');
+    for (const alignId of order) {
+        const def = DEFAULT_PI_MODELS[alignId];
+        const apiKey = def ? keyFor(alignId, saved, preferred) : undefined;
+        if (def && apiKey)
+            return { provider: def.provider, modelId: def.modelId, apiKey, label: label(alignId, def.modelId) };
+    }
+    if (preferred === 'ollama')
+        return undefined; // already probed above, and it is not running
+    const model = await probe();
+    return model ? ollamaModel(model) : undefined;
+}
+//# sourceMappingURL=pi-models.js.map

package/dist/lib/agent/engines/pi-models.js.map

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