@aeolus-fleet/trierarch 0.32.1 → 0.33.0

package/dist/adapters/harnesses.d.ts

@@ -15,12 +15,13 @@ interface CommandLines {
 export declare function adapterFlagsOf(configuration: TrierarchConfiguration): Record<string, readonly AdapterFlag[]>;
 /** The flags each configured harness's adapter calls risky, for the report (#326). */
 export declare function riskyFlagsOf(configuration: TrierarchConfiguration): Record<string, readonly string[]>;
-/** What a harness launches with the given flags, on a first start and a restart, for config check; undefined without an adapter. */
+/** What a harness launches with the given flags, on a first start and a restart, headless or in a terminal, for config check; undefined without an adapter. */
 export declare function commandLinesOf(at: {
     harness: string;
     flags: readonly string[];
     files: HarnessFiles;
     permissionModes: readonly string[] | undefined;
+    isHeadless: boolean;
 }): Promise<CommandLines | undefined>;
 /**
  * The adapters of the harnesses the configuration offers, by name, each with
@@ -36,8 +37,8 @@ export declare function createHarnesses(at: {
     managedSettings: string;
     /** What detection last found, read at each launch (#517). */
     detected: () => Detected;
-    sessions: Pick<SessionRuntime, 'start' | 'type' | 'interrupt' | 'screen'>;
-    /** For sessions in containers: a home of each ship's own (decision 0039). */
+    sessions: Pick<SessionRuntime, 'start' | 'send' | 'interrupt' | 'events'>;
+    /** For sessions in containers: a home of each ship's own (decision 0039); without, sessions run headless on the host (headless H4). */
     shipHomes?: {
         homes: string;
         managedSettings: string;

package/dist/adapters/harnesses.js

@@ -5,17 +5,16 @@ import { createCodexSetup } from './codex-setup.js';
 import { CODEX_ADAPTER_FLAGS, CODEX_RISKY_FLAGS, codexCommandLine, createCodexHarness, WAKE_PROMPT as CODEX_WAKE_PROMPT } from './codex.js';
 import { firstPromptOf, wakePromptOf } from '../core/no-terminal-questions.js';
 import { findAeolusPlugin } from './plugin.js';
-/** What the settings' first prompt and a ship's session name stand for where config check shows a command line. */
+/** What the settings' first prompt stands for where config check shows a command line. */
 const FIRST_PROMPT = '<first prompt>';
-const SESSION_NAME = '[<repository or folder>] <ship>';
 /** Per harness this trierarch has an adapter for: the flags it adds itself, its risky flags, and its command lines for given flags. */
 const ADAPTERS = {
     'claude-code': {
         adapterFlags: CLAUDE_CODE_ADAPTER_FLAGS,
         riskyFlags: CLAUDE_CODE_RISKY_FLAGS,
-        commandLines: async (flags, { files, permissionModes }) => {
+        commandLines: async (flags, { files, permissionModes, isHeadless }) => {
             const defaultPermissionMode = await claudeCodeSettingsDefaultMode(files.claudeCode, { flags });
-            const commandLine = (isFirstStart) => claudeCodeCommandLine({ flags, sessionName: SESSION_NAME, prompt: isFirstStart ? firstPromptOf(FIRST_PROMPT) : wakePromptOf(CLAUDE_CODE_WAKE_PROMPT), isFirstStart, defaultPermissionMode, permissionModes });
+            const commandLine = (isFirstStart) => claudeCodeCommandLine({ flags, isHeadless, prompt: isFirstStart ? firstPromptOf(FIRST_PROMPT) : wakePromptOf(CLAUDE_CODE_WAKE_PROMPT), isFirstStart, defaultPermissionMode, permissionModes });
             return { firstStart: commandLine(true), restart: commandLine(false) };
         },
     },
@@ -36,9 +35,9 @@ export function adapterFlagsOf(configuration) {
 export function riskyFlagsOf(configuration) {
     return Object.fromEntries(Object.keys(configuration.harnesses).map((name) => [name, ADAPTERS[name]?.riskyFlags ?? []]));
 }
-/** What a harness launches with the given flags, on a first start and a restart, for config check; undefined without an adapter. */
+/** What a harness launches with the given flags, on a first start and a restart, headless or in a terminal, for config check; undefined without an adapter. */
 export async function commandLinesOf(at) {
-    return ADAPTERS[at.harness]?.commandLines(at.flags, { files: at.files, permissionModes: at.permissionModes });
+    return ADAPTERS[at.harness]?.commandLines(at.flags, { files: at.files, permissionModes: at.permissionModes, isHeadless: at.isHeadless });
 }
 /**
  * The adapters of the harnesses the configuration offers, by name, each with
@@ -57,7 +56,7 @@ export async function createHarnesses(at) {
         }
         const plugin = await findAeolusPlugin({ homeDirectory, env, harness: name });
         plugins[name] = plugin;
-        harnesses[name] = name === 'codex' ? createCodexHarness({ configuration, plugin, sessions, setup: createCodexSetup() }) : createClaudeCodeHarness({ configuration, plugin, sessions, permissionModes: () => detected()['claude-code']?.permissionModes, projects: join(env.CLAUDE_CONFIG_DIR ?? join(homeDirectory, '.claude'), 'projects'), setup: createClaudeCodeSetup({ homeDirectory, managedSettings, ...(env.CLAUDE_CONFIG_DIR !== undefined && { configDirectory: env.CLAUDE_CONFIG_DIR }) }), ...(shipHomes !== undefined && { shipHomes }) });
+        harnesses[name] = name === 'codex' ? createCodexHarness({ configuration, plugin, sessions, setup: createCodexSetup() }) : createClaudeCodeHarness({ configuration, plugin, sessions, isHeadless: shipHomes === undefined, permissionModes: () => detected()['claude-code']?.permissionModes, projects: join(env.CLAUDE_CONFIG_DIR ?? join(homeDirectory, '.claude'), 'projects'), setup: createClaudeCodeSetup({ homeDirectory, managedSettings, ...(env.CLAUDE_CONFIG_DIR !== undefined && { configDirectory: env.CLAUDE_CONFIG_DIR }) }), ...(shipHomes !== undefined && { shipHomes }) });
     }
     return { harnesses, plugins };
 }

package/dist/adapters/harnesses.js.map

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

package/dist/adapters/hold-protocol.d.ts

@@ -0,0 +1,50 @@
+import type { ShipId } from '@aeolus-fleet/common';
+import { z } from 'zod';
+/**
+ * How the trierarch talks to a session's hold (headless H8, H9): the hold's
+ * files in the session's own folder, `<sessions>/<ship id>/`, and its socket's
+ * calls, one JSON line each way. The trierarch speaks only its own version of
+ * this protocol: a hold of another version is replaced (H19).
+ */
+/** A session's hold files, in its folder under the sessions folder. */
+export interface HoldFiles {
+    readonly folder: string;
+    readonly socket: string;
+    readonly pid: string;
+    /** Every event line the harness writes, appended. */
+    readonly events: string;
+    /** The harness's own session id, as its first event names it, so a start resumes it. */
+    readonly sessionId: string;
+}
+export declare function holdFilesOf(sessions: string, shipId: ShipId): HoldFiles;
+export declare const holdRequestSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    call: z.ZodLiteral<"send">;
+    line: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    call: z.ZodLiteral<"interrupt">;
+}, z.core.$strip>, z.ZodObject<{
+    call: z.ZodLiteral<"state">;
+}, z.core.$strip>], "call">;
+export type HoldRequest = z.infer<typeof holdRequestSchema>;
+export declare const holdAnswerSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    isOk: z.ZodLiteral<true>;
+    state: z.ZodOptional<z.ZodObject<{
+        status: z.ZodLiteral<"running">;
+        version: z.ZodString;
+        sessionId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+    isOk: z.ZodLiteral<false>;
+    error: z.ZodString;
+}, z.core.$strip>], "isOk">;
+export type HoldAnswer = z.infer<typeof holdAnswerSchema>;
+/** The answer a hold gives a caller that is not the trierarch. */
+export declare const REFUSED = "refused: only the trierarch talks to a hold";
+/** A line as JSON; undefined when it holds none. */
+export declare function parsedLine(line: string): unknown;
+/** Calls the hold at the socket and answers what it said; a hold that does not answer within the time, or ends the call unanswered, throws. */
+export declare function callHold(call: {
+    socket: string;
+    request: HoldRequest;
+    timeoutMs: number;
+}): Promise<HoldAnswer>;

package/dist/adapters/hold-protocol.js

@@ -0,0 +1,58 @@
+import { connect } from 'node:net';
+import { join } from 'node:path';
+import { z } from 'zod';
+export function holdFilesOf(sessions, shipId) {
+    const folder = join(sessions, shipId);
+    return { folder, socket: join(folder, 'hold.sock'), pid: join(folder, 'hold.pid'), events: join(folder, 'events.jsonl'), sessionId: join(folder, 'session-id') };
+}
+export const holdRequestSchema = z.discriminatedUnion('call', [
+    z.object({ call: z.literal('send'), line: z.string() }),
+    z.object({ call: z.literal('interrupt') }),
+    z.object({ call: z.literal('state') }),
+]);
+export const holdAnswerSchema = z.discriminatedUnion('isOk', [
+    z.object({ isOk: z.literal(true), state: z.object({ status: z.literal('running'), version: z.string(), sessionId: z.string().optional() }).optional() }),
+    z.object({ isOk: z.literal(false), error: z.string() }),
+]);
+/** The answer a hold gives a caller that is not the trierarch. */
+export const REFUSED = 'refused: only the trierarch talks to a hold';
+/** A line as JSON; undefined when it holds none. */
+export function parsedLine(line) {
+    try {
+        return JSON.parse(line);
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Calls the hold at the socket and answers what it said; a hold that does not answer within the time, or ends the call unanswered, throws. */
+export function callHold(call) {
+    const { socket, request, timeoutMs } = call;
+    return new Promise((resolve, reject) => {
+        const connection = connect(socket);
+        let received = '';
+        const timer = setTimeout(() => {
+            connection.destroy();
+            reject(new Error(`the hold at ${socket} did not answer ${request.call} within ${String(timeoutMs)} ms`));
+        }, timeoutMs);
+        connection.on('connect', () => connection.write(`${JSON.stringify(request)}\n`));
+        connection.on('data', (chunk) => {
+            received += chunk.toString('utf8');
+        });
+        connection.on('error', (error) => {
+            clearTimeout(timer);
+            reject(error);
+        });
+        connection.on('close', () => {
+            clearTimeout(timer);
+            const answer = holdAnswerSchema.safeParse(parsedLine(received.split('\n')[0] ?? ''));
+            if (answer.success) {
+                resolve(answer.data);
+            }
+            else {
+                reject(new Error(`the hold at ${socket} gave no answer to ${request.call}`));
+            }
+        });
+    });
+}
+//# sourceMappingURL=hold-protocol.js.map

package/dist/adapters/hold-protocol.js.map

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

package/dist/adapters/hold-runtime.d.ts

@@ -0,0 +1,36 @@
+import type { SessionRuntime } from '../core/ports.js';
+import type { SessionRoots } from './caller-check.js';
+/** What a session's start goes through: a systemd scope of its own under a systemd unit, which sets INVOCATION_ID, so a restart or upgrade of the service ends no session (#479, #537). */
+export declare function sessionsLaunch(at: {
+    platform: string;
+    env: Readonly<Record<string, string | undefined>>;
+}): readonly string[];
+/**
+ * The host session runtime (headless H4, H8, H9): one hold per ship, the
+ * trierarch program run as `aeolus-trierarch hold`, which runs the harness as
+ * its child and holds its input and output. Under a systemd unit a hold starts
+ * in a scope of its own, so a restart or an upgrade of the service ends no
+ * session (#479, #537). A hold is nobody's child: the fleet socket takes it
+ * as its session's root (decision 0026), and a session's processes are never
+ * under the trierarch's.
+ *
+ * A hold that answers runs; one that started since the machine did and no
+ * longer answers has exited, kept so the exit is seen with its events; one
+ * from before the machine started is gone. A hold another version started is
+ * listed as such (H19), as is a session an older trierarch started in tmux,
+ * which a start stops before the ship's hold starts.
+ */
+export declare function createHoldRuntime(options: {
+    /** The sessions folder: a folder per ship, with its hold's files. */
+    sessions: string;
+    /** The trierarch program, which `hold` and its words follow. */
+    program: readonly string[];
+    version: string;
+    platform: string;
+    /** What a hold's start goes through: a systemd scope of its own under a systemd unit (see sessionsLaunch). */
+    launch?: readonly string[];
+    /** The sessions an older trierarch started in tmux: listed and stopped, never started. */
+    legacy?: Pick<SessionRuntime, 'list' | 'stop'>;
+    /** When the machine started. */
+    bootedAt?: () => Date;
+}): SessionRuntime & SessionRoots;

package/dist/adapters/hold-runtime.js

@@ -0,0 +1,146 @@
+import { spawn } from 'node:child_process';
+import { readdir, readFile, rm, stat } from 'node:fs/promises';
+import { uptime } from 'node:os';
+import { setTimeout as wait } from 'node:timers/promises';
+import { idSchema } from '@aeolus-fleet/common';
+import { INTERRUPT_WAIT_MS } from './hold.js';
+import { callHold, holdFilesOf } from './hold-protocol.js';
+/** How long a hold has to answer a call other than interrupt. */
+const CALL_TIMEOUT_MS = 2000;
+/** How long a hold has to answer its first call after its start. */
+const START_WAIT_MS = 10_000;
+/** How often a starting hold is asked whether it answers. */
+const START_POLL_MS = 50;
+/** How long a stopped hold has to end with its harness before it is killed. */
+const STOP_WAIT_MS = 5000;
+/** How many of the last event lines are read: the launch window's error event is among the last. */
+const EVENT_LINES = 200;
+/** Runs the command in the background and returns at once: its process is then nobody's child, so no session runs under the trierarch's own process. */
+const DETACHED = '"$@" < /dev/null > /dev/null 2>&1 &';
+/** What a session's start goes through: a systemd scope of its own under a systemd unit, which sets INVOCATION_ID, so a restart or upgrade of the service ends no session (#479, #537). */
+export function sessionsLaunch(at) {
+    return at.platform === 'linux' && at.env.INVOCATION_ID !== undefined ? ['systemd-run', '--user', '--scope', '--quiet', '--collect', '--'] : [];
+}
+/**
+ * The host session runtime (headless H4, H8, H9): one hold per ship, the
+ * trierarch program run as `aeolus-trierarch hold`, which runs the harness as
+ * its child and holds its input and output. Under a systemd unit a hold starts
+ * in a scope of its own, so a restart or an upgrade of the service ends no
+ * session (#479, #537). A hold is nobody's child: the fleet socket takes it
+ * as its session's root (decision 0026), and a session's processes are never
+ * under the trierarch's.
+ *
+ * A hold that answers runs; one that started since the machine did and no
+ * longer answers has exited, kept so the exit is seen with its events; one
+ * from before the machine started is gone. A hold another version started is
+ * listed as such (H19), as is a session an older trierarch started in tmux,
+ * which a start stops before the ship's hold starts.
+ */
+export function createHoldRuntime(options) {
+    const { sessions, version } = options;
+    const bootedAt = options.bootedAt ?? (() => new Date(Date.now() - uptime() * 1000));
+    const filesOf = (shipId) => holdFilesOf(sessions, shipId);
+    /** The hold's pid, while its process runs. */
+    const runningPid = async (shipId) => {
+        const pid = Number(await readFile(filesOf(shipId).pid, 'utf8').catch(() => ''));
+        if (!Number.isInteger(pid) || pid <= 1) {
+            return undefined;
+        }
+        try {
+            process.kill(pid, 0);
+            return pid;
+        }
+        catch {
+            return undefined;
+        }
+    };
+    const observed = async (shipId) => {
+        const files = filesOf(shipId);
+        const started = await stat(files.pid).catch(() => undefined);
+        if (started === undefined || started.mtime < bootedAt()) {
+            return undefined;
+        }
+        const answer = await callHold({ socket: files.socket, request: { call: 'state' }, timeoutMs: CALL_TIMEOUT_MS }).catch(() => undefined);
+        if (answer?.isOk !== true || answer.state === undefined) {
+            return { shipId, status: 'exited' };
+        }
+        return { shipId, status: 'running', ...(answer.state.version !== version && { isOtherVersion: true }) };
+    };
+    const stop = async (shipId) => {
+        await options.legacy?.stop(shipId);
+        const pid = await runningPid(shipId);
+        if (pid !== undefined) {
+            process.kill(pid, 'SIGTERM');
+            const until = Date.now() + STOP_WAIT_MS;
+            while ((await runningPid(shipId)) !== undefined && Date.now() < until) {
+                await wait(START_POLL_MS);
+            }
+            if ((await runningPid(shipId)) !== undefined) {
+                process.kill(pid, 'SIGKILL');
+            }
+        }
+        await rm(filesOf(shipId).folder, { recursive: true, force: true });
+    };
+    const must = async (shipId, call) => {
+        const { request } = call;
+        const answer = await callHold({ socket: filesOf(shipId).socket, ...call });
+        if (!answer.isOk) {
+            throw new Error(`the hold of ${shipId} refused ${request.call}: ${answer.error}`);
+        }
+    };
+    return {
+        list: async () => {
+            const folders = await readdir(sessions).catch(() => []);
+            const shipIds = folders.flatMap((folder) => {
+                const shipId = idSchema('ship').safeParse(folder);
+                return shipId.success ? [shipId.data] : [];
+            });
+            const held = (await Promise.all(shipIds.map(observed))).flatMap((session) => (session === undefined ? [] : [session]));
+            const heldIds = new Set(held.map((session) => session.shipId));
+            const legacy = ((await options.legacy?.list()) ?? []).filter((session) => !heldIds.has(session.shipId)).map((session) => ({ ...session, isOtherVersion: true }));
+            return [...held, ...legacy];
+        },
+        stop,
+        start: async ({ shipId, folder, command, harness, env = {} }) => {
+            await stop(shipId);
+            const files = filesOf(shipId);
+            const hold = [...options.program, 'hold', shipId, '--sessions', sessions, '--folder', folder, '--harness', harness, ...Object.entries(env).flatMap(([variable, value]) => ['--env', `${variable}=${value}`]), '--', ...command];
+            const [program = 'sh', ...args] = [...(options.launch ?? []), 'sh', '-c', DETACHED, 'sh', ...hold];
+            const starter = spawn(program, args, { stdio: 'ignore', detached: true });
+            await new Promise((resolve, reject) => {
+                starter.on('error', reject);
+                starter.on('exit', () => {
+                    resolve();
+                });
+            });
+            const until = Date.now() + START_WAIT_MS;
+            while (Date.now() < until) {
+                if ((await callHold({ socket: files.socket, request: { call: 'state' }, timeoutMs: CALL_TIMEOUT_MS }).catch(() => undefined))?.isOk === true) {
+                    return;
+                }
+                // A hold whose harness ended at once has ended too: its exit is seen in the next list.
+                if ((await stat(files.pid).catch(() => undefined)) !== undefined && (await runningPid(shipId)) === undefined) {
+                    return;
+                }
+                await wait(START_POLL_MS);
+            }
+            throw new Error(`the hold of ${shipId} did not answer within ${String(START_WAIT_MS)} ms of its start`);
+        },
+        // A Codex hold starts the line's turn once the last turn's process has ended, which it waits for as long as for an interrupted turn.
+        send: async ({ shipId, line }) => {
+            await must(shipId, { request: { call: 'send', line }, timeoutMs: INTERRUPT_WAIT_MS + CALL_TIMEOUT_MS });
+        },
+        interrupt: async (shipId) => {
+            await must(shipId, { request: { call: 'interrupt' }, timeoutMs: INTERRUPT_WAIT_MS + CALL_TIMEOUT_MS });
+        },
+        events: async (shipId) => {
+            const text = await readFile(filesOf(shipId).events, 'utf8').catch(() => '');
+            return text
+                .split('\n')
+                .filter((line) => line !== '')
+                .slice(-EVENT_LINES);
+        },
+        sessionRootOf: runningPid,
+    };
+}
+//# sourceMappingURL=hold-runtime.js.map

package/dist/adapters/hold-runtime.js.map

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

package/dist/adapters/hold.d.ts

@@ -0,0 +1,41 @@
+import { type Socket } from 'node:net';
+import type { HoldFiles } from './hold-protocol.js';
+/**
+ * The hold (headless H8 to H12): a small process per session, started outside
+ * the trierarch's service so it outlives it, the only holder of its harness's
+ * stdin and stdout. It starts the harness as its child, appends every line the
+ * harness writes to the session's events, keeps the harness's session id, and
+ * answers the trierarch alone on its socket: send a line, interrupt the turn,
+ * say its state. When the harness ends, the hold ends; when the hold is
+ * stopped, the harness ends with it. A hold that dies without the chance to
+ * stop it, as SIGKILL leaves it, still ends its harness: a guard, a process of
+ * its own, holds a pipe from the hold and ends each harness's group once that
+ * pipe closes, which the hold's death does.
+ *
+ * Claude Code's turn is stopped with the interrupt control request on its
+ * stdin, which keeps the process (H12, Thomas, 25 Oct: "Headless option 2").
+ * When Claude Code refuses it, SIGINT stops the turn and the process, and the
+ * hold starts it again resuming its session, so the trierarch sees no exit.
+ *
+ * Codex runs one `codex exec` per turn (H11): the start command is the first
+ * turn, and each line sent is the prompt of a `codex exec resume` of the
+ * thread the first named, started once the last turn's process has ended.
+ * Between turns no Codex process runs and the hold stays; its turn is stopped
+ * with SIGINT, which ends the process (H12).
+ */
+/** The longest the hold waits for an interrupted turn to end before the forced line goes in anyway (timings-and-limits.md). */
+export declare const INTERRUPT_WAIT_MS = 10000;
+export interface HoldOptions {
+    readonly files: HoldFiles;
+    readonly folder: string;
+    /** The harness the command runs: how its turn is stopped. */
+    readonly harness: string;
+    readonly command: readonly string[];
+    /** The harness's whole environment: nothing else of the hold's reaches it (H10). */
+    readonly environment: Readonly<Record<string, string>>;
+    readonly version: string;
+    /** Whether the caller at the other end of a connection to the socket is the trierarch (H9). */
+    readonly mayCall: (connection: Socket) => Promise<boolean>;
+}
+/** Runs the hold until its harness ends; answers the harness's exit code. */
+export declare function runHold(options: HoldOptions): Promise<number>;