@procedures/claude-cli 0.0.0-stage → 0.4.0

package/dist/procedures/claude/start.d.ts

@@ -0,0 +1,14 @@
+/**
+ * claude.start procedure
+ *
+ * This procedure starts one turn of the Claude Code CLI as a detached process that writes to a
+ * file. The turn continues when the host stops.
+ */
+import { type Spawner } from "../../turn.js";
+import type { ClaudeStartInput, ClaudeStartOutput } from "../../types.js";
+/**
+ * This function starts a turn. The variables of `input.env` go on top of the environment of the
+ * host. It gives the process id and the output file of the turn.
+ */
+export declare function claudeStart(input: ClaudeStartInput, spawner?: Spawner): Promise<ClaudeStartOutput>;
+//# sourceMappingURL=start.d.ts.map

package/dist/procedures/claude/start.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../../src/procedures/claude/start.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAa,KAAK,OAAO,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAE1E;;;GAGG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAaxG"}

package/dist/procedures/claude/start.js

@@ -0,0 +1,26 @@
+/**
+ * claude.start procedure
+ *
+ * This procedure starts one turn of the Claude Code CLI as a detached process that writes to a
+ * file. The turn continues when the host stops.
+ */
+import { startTurn } from "../../turn.js";
+/**
+ * This function starts a turn. The variables of `input.env` go on top of the environment of the
+ * host. It gives the process id and the output file of the turn.
+ */
+export async function claudeStart(input, spawner) {
+    const turn = await startTurn({
+        prompt: input.prompt,
+        cwd: input.cwd,
+        args: input.args,
+        outputFile: input.outputFile,
+        promptFile: input.promptFile,
+        executable: input.executable,
+        executableArgs: input.executableArgs,
+        env: input.env !== undefined ? { ...process.env, ...input.env } : undefined,
+        spawner,
+    });
+    return { ...turn, args: [...turn.args] };
+}
+//# sourceMappingURL=start.js.map

package/dist/procedures/claude/start.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.js","sourceRoot":"","sources":["../../../src/procedures/claude/start.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAgB,MAAM,eAAe,CAAC;AAGxD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,KAAuB,EAAE,OAAiB;IAC1E,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC;QAC3B,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,GAAG,EAAE,KAAK,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,SAAS;QAC3E,OAAO;KACR,CAAC,CAAC;IACH,OAAO,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AAC3C,CAAC"}

package/dist/register.d.ts

@@ -0,0 +1,6 @@
+/**
+ * An import of this file registers the procedures of @procedures/claude-cli in the global registry:
+ * `import "@procedures/claude-cli/register"`. The package root registers nothing.
+ */
+export * from "./module.js";
+//# sourceMappingURL=register.d.ts.map

package/dist/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,cAAc,aAAa,CAAC"}

package/dist/register.js

@@ -0,0 +1,8 @@
+/**
+ * An import of this file registers the procedures of @procedures/claude-cli in the global registry:
+ * `import "@procedures/claude-cli/register"`. The package root registers nothing.
+ */
+import { registerClaudeCliProcedures } from "./module.js";
+export * from "./module.js";
+registerClaudeCliProcedures();
+//# sourceMappingURL=register.js.map

package/dist/register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAE1D,cAAc,aAAa,CAAC;AAE5B,2BAA2B,EAAE,CAAC"}

package/dist/turn.d.ts

@@ -0,0 +1,142 @@
+/**
+ * One turn of the Claude Code CLI as a process that can outlive its host.
+ *
+ * - `startTurn` starts `claude -p --output-format stream-json --verbose` as a detached process.
+ *   The prompt comes from a file, and the output goes to a file. The host holds no pipe to the
+ *   process, so a restart of the host does not stop the turn.
+ * - `readTurn` and `followTurn` read the output file from a byte offset, and give normalised
+ *   events. A new host continues from the last offset.
+ * - `cancelTurn` stops the process tree of a turn by its process id.
+ */
+import { type SpawnOptions } from "node:child_process";
+import { type CommandOptions, type CommandResult } from "@procedures/shell/command";
+import { type ClaudeEvent } from "./events.js";
+/** The flags that make the CLI run one turn and write stream-json. */
+export declare const CLAUDE_FLAGS: readonly string[];
+/** The part of a child process that `startTurn` uses. */
+export interface SpawnedProcess {
+    readonly pid?: number | undefined;
+    once(event: "spawn" | "error", listener: (error?: Error) => void): unknown;
+    unref(): void;
+}
+/** The function that starts a process. The default is `spawn` of `node:child_process`. */
+export type Spawner = (command: string, args: readonly string[], options: SpawnOptions) => SpawnedProcess;
+/** The options of `startTurn`. */
+export interface StartTurnOptions {
+    /** The prompt. The process reads it from a file on its stdin. */
+    readonly prompt: string;
+    /** The working folder of the turn (default: the current folder). */
+    readonly cwd?: string | undefined;
+    /** More arguments after the default flags, for example `--resume <session>` or `--model <name>`. */
+    readonly args?: readonly string[] | undefined;
+    /** The file that gets the output. The process appends to it. The default is a file in a new temporary folder. */
+    readonly outputFile?: string | undefined;
+    /** The file that holds the prompt (default: `<outputFile>.prompt.txt`). */
+    readonly promptFile?: string | undefined;
+    /** The `claude` program (default: `CLAUDE_BIN` of the host, then a search). */
+    readonly executable?: string | undefined;
+    /** The arguments before the default flags, for example the path of `cli.js` when `executable` is `node`. */
+    readonly executableArgs?: readonly string[] | undefined;
+    /** The full environment of the process (default: `process.env`). The caller removes the secrets. */
+    readonly env?: Readonly<Record<string, string | undefined>> | undefined;
+    /** The function that starts the process (default: `spawn`). The tests give their own. */
+    readonly spawner?: Spawner | undefined;
+}
+/** A turn that runs. Keep `pid`, `outputFile` and `offset` to read or stop the turn later. */
+export interface StartedTurn {
+    readonly pid: number;
+    /** The absolute path of the output file. */
+    readonly outputFile: string;
+    /** The absolute path of the prompt file. */
+    readonly promptFile: string;
+    /** The byte offset in the output file where the output of this turn starts. */
+    readonly offset: number;
+    /** The program and its arguments. */
+    readonly command: string;
+    readonly args: readonly string[];
+    /** The start time, as an ISO 8601 text. */
+    readonly startedAt: string;
+}
+/**
+ * This function starts one turn as a detached process: stdin is the prompt file, stdout and
+ * stderr go to the output file. The process starts with argv, not through a shell.
+ */
+export declare function startTurn(options: StartTurnOptions): Promise<StartedTurn>;
+/** This function tells if a process with this id runs. */
+export declare function isProcessAlive(pid: number): boolean;
+/** One event of a turn, with the byte offset after its line. Give that offset to continue. */
+export interface TurnEvent {
+    readonly offset: number;
+    readonly event: ClaudeEvent;
+}
+/** The options of `readTurn`. */
+export interface ReadTurnOptions {
+    /** The output file of the turn. */
+    readonly outputFile: string;
+    /** The byte offset to start from (default: 0). */
+    readonly offset?: number | undefined;
+    /** The process id of the turn. Without it, the last line without a line end stays unread. */
+    readonly pid?: number | undefined;
+    /** The function that tells if a process runs (default: `isProcessAlive`). */
+    readonly isAlive?: ((pid: number) => boolean) | undefined;
+}
+/** The result of `readTurn`. */
+export interface ReadTurnResult {
+    readonly events: TurnEvent[];
+    /** The byte offset after the last line that was read. Give it to the next read. */
+    readonly offset: number;
+    /** True when the events include the `result` of the turn. */
+    readonly finished: boolean;
+    /** True when the process runs. It is absent without `pid`. */
+    readonly running?: boolean;
+    /** The number of new bytes in the file, read or not. */
+    readonly newBytes: number;
+}
+/**
+ * This function reads the complete lines of the output file after `offset`, and normalises them.
+ * When the process has ended, it also reads a last line without a line end.
+ */
+export declare function readTurn(options: ReadTurnOptions): ReadTurnResult;
+/** The options of `followTurn`. */
+export interface FollowTurnOptions extends ReadTurnOptions {
+    /** The time between two reads, in milliseconds (default: 250). */
+    readonly pollMs?: number | undefined;
+    /** The reads without new bytes after the end of the process, before the follow stops (default: 2). */
+    readonly quietReads?: number | undefined;
+    /** When the signal aborts, the follow stops. The process continues. */
+    readonly signal?: AbortSignal | undefined;
+}
+/**
+ * This function follows the output file and gives each event while the turn runs. It stops after
+ * the `result` event. When the process ends without a result, it gives an `error` event and stops.
+ * Without `pid`, only the result or the signal stops it.
+ */
+export declare function followTurn(options: FollowTurnOptions): AsyncGenerator<TurnEvent, void, undefined>;
+/** The function that runs a program. The default is `runCommand` of `@procedures/shell`. */
+export type CommandRunner = (command: string, options: CommandOptions) => Promise<CommandResult>;
+/** The options of `cancelTurn`. Each one has a default from the host. */
+export interface CancelTurnOptions {
+    /** The operating system (default: `process.platform`). */
+    readonly platform?: NodeJS.Platform | undefined;
+    /** The function that runs `taskkill` on Windows (default: `runCommand`). */
+    readonly runner?: CommandRunner | undefined;
+    /** The function that sends a signal on POSIX (default: `process.kill`). */
+    readonly kill?: ((pid: number, signal: NodeJS.Signals) => void) | undefined;
+    /** The function that tells if a process runs (default: `isProcessAlive`). */
+    readonly isAlive?: ((pid: number) => boolean) | undefined;
+    /** The signal on POSIX (default: `SIGTERM`). */
+    readonly signal?: NodeJS.Signals | undefined;
+}
+/** The result of `cancelTurn`. */
+export interface CancelTurnResult {
+    /** True when the stop reached the process. */
+    readonly stopped: boolean;
+    /** Why the stop did not occur, when `stopped` is false. */
+    readonly reason?: string;
+}
+/**
+ * This function stops the process tree of a turn. On Windows it starts `taskkill /T /F /PID`.
+ * On POSIX it signals the process group, which `startTurn` made. It refuses the id of the host.
+ */
+export declare function cancelTurn(pid: number, options?: CancelTurnOptions): Promise<CancelTurnResult>;
+//# sourceMappingURL=turn.d.ts.map

package/dist/turn.d.ts.map

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

package/dist/turn.js

@@ -0,0 +1,208 @@
+/**
+ * One turn of the Claude Code CLI as a process that can outlive its host.
+ *
+ * - `startTurn` starts `claude -p --output-format stream-json --verbose` as a detached process.
+ *   The prompt comes from a file, and the output goes to a file. The host holds no pipe to the
+ *   process, so a restart of the host does not stop the turn.
+ * - `readTurn` and `followTurn` read the output file from a byte offset, and give normalised
+ *   events. A new host continues from the last offset.
+ * - `cancelTurn` stops the process tree of a turn by its process id.
+ */
+import { spawn } from "node:child_process";
+import { closeSync, mkdirSync, mkdtempSync, openSync, readSync, statSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { dirname, join, resolve } from "node:path";
+import { setTimeout as sleep } from "node:timers/promises";
+import { runCommand } from "@procedures/shell/command";
+import { normalizeLine } from "./events.js";
+import { CLAUDE_ENV, findClaude } from "./executable.js";
+/** The flags that make the CLI run one turn and write stream-json. */
+export const CLAUDE_FLAGS = ["-p", "--output-format", "stream-json", "--verbose"];
+const defaultSpawner = (command, args, options) => spawn(command, [...args], options);
+/** True when the program is a batch file of Windows, which does not start without a shell. */
+function isBatchFile(program) {
+    return /\.(cmd|bat)$/i.test(program);
+}
+function sizeOf(path) {
+    try {
+        return statSync(path).size;
+    }
+    catch {
+        return 0;
+    }
+}
+/**
+ * This function starts one turn as a detached process: stdin is the prompt file, stdout and
+ * stderr go to the output file. The process starts with argv, not through a shell.
+ */
+export async function startTurn(options) {
+    // The search reads the environment of the host, not the environment of the turn
+    const command = findClaude({ executable: options.executable });
+    if (command === undefined)
+        throw new Error(`The claude program was not found. Install Claude Code, or set ${CLAUDE_ENV} to the program.`);
+    if (process.platform === "win32" && isBatchFile(command)) {
+        throw new Error(`${command} is a batch file, which does not start without a shell. Give the native claude.exe, or node and the path of cli.js.`);
+    }
+    const outputFile = resolve(options.outputFile ?? join(mkdtempSync(join(tmpdir(), "claude-turn-")), "output.ndjson"));
+    const promptFile = resolve(options.promptFile ?? `${outputFile}.prompt.txt`);
+    mkdirSync(dirname(outputFile), { recursive: true });
+    mkdirSync(dirname(promptFile), { recursive: true });
+    writeFileSync(promptFile, options.prompt, "utf8");
+    const offset = sizeOf(outputFile);
+    const args = [...(options.executableArgs ?? []), ...CLAUDE_FLAGS, ...(options.args ?? [])];
+    const input = openSync(promptFile, "r");
+    const output = openSync(outputFile, "a");
+    try {
+        const child = (options.spawner ?? defaultSpawner)(command, args, {
+            cwd: options.cwd,
+            env: { ...(options.env ?? process.env) },
+            // Its own process group on POSIX (the cancel signals the group), and no console window
+            detached: true,
+            windowsHide: true,
+            shell: false,
+            stdio: [input, output, output],
+        });
+        await new Promise((resolveStart, rejectStart) => {
+            child.once("spawn", () => resolveStart());
+            child.once("error", (error) => rejectStart(new Error(`claude did not start: ${error?.message ?? "unknown error"}`)));
+        });
+        if (child.pid === undefined)
+            throw new Error("claude did not start: no process id");
+        child.unref();
+        return { pid: child.pid, outputFile, promptFile, offset, command, args, startedAt: new Date().toISOString() };
+    }
+    finally {
+        // The process has its own copies of the two files
+        closeSync(input);
+        closeSync(output);
+    }
+}
+/** This function tells if a process with this id runs. */
+export function isProcessAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        // EPERM: the process runs, but it belongs to another user
+        return error.code === "EPERM";
+    }
+}
+function readBytes(path, start, end) {
+    const fd = openSync(path, "r");
+    try {
+        const buffer = Buffer.alloc(end - start);
+        let done = 0;
+        while (done < buffer.length) {
+            const read = readSync(fd, buffer, done, buffer.length - done, start + done);
+            if (read === 0)
+                break;
+            done += read;
+        }
+        return buffer.subarray(0, done);
+    }
+    finally {
+        closeSync(fd);
+    }
+}
+/**
+ * This function reads the complete lines of the output file after `offset`, and normalises them.
+ * When the process has ended, it also reads a last line without a line end.
+ */
+export function readTurn(options) {
+    const start = options.offset ?? 0;
+    // The check comes before the read: when the process has ended, the file is complete
+    const running = options.pid === undefined ? undefined : (options.isAlive ?? isProcessAlive)(options.pid);
+    const status = running === undefined ? {} : { running };
+    const size = sizeOf(options.outputFile);
+    if (size <= start)
+        return { events: [], offset: start, finished: false, newBytes: 0, ...status };
+    const bytes = readBytes(options.outputFile, start, size);
+    const events = [];
+    let position = 0;
+    let finished = false;
+    while (position < bytes.length) {
+        let end = bytes.indexOf(0x0a, position);
+        if (end === -1) {
+            if (running !== false)
+                break;
+            end = bytes.length;
+        }
+        const line = bytes.subarray(position, end).toString("utf8");
+        position = Math.min(end + 1, bytes.length);
+        for (const event of normalizeLine(line)) {
+            events.push({ offset: start + position, event });
+            if (event.type === "result")
+                finished = true;
+        }
+    }
+    return { events, offset: start + position, finished, newBytes: bytes.length, ...status };
+}
+/**
+ * This function follows the output file and gives each event while the turn runs. It stops after
+ * the `result` event. When the process ends without a result, it gives an `error` event and stops.
+ * Without `pid`, only the result or the signal stops it.
+ */
+export async function* followTurn(options) {
+    const pollMs = options.pollMs ?? 250;
+    const quietLimit = options.quietReads ?? 2;
+    let offset = options.offset ?? 0;
+    let quiet = 0;
+    while (options.signal?.aborted !== true) {
+        const read = readTurn({ ...options, offset });
+        for (const item of read.events) {
+            yield item;
+            if (item.event.type === "result")
+                return;
+        }
+        offset = read.offset;
+        if (read.running === false) {
+            quiet = read.newBytes > 0 ? 0 : quiet + 1;
+            if (quiet >= quietLimit) {
+                yield { offset, event: { type: "error", message: "The process ended without a result" } };
+                return;
+            }
+        }
+        try {
+            await sleep(pollMs, undefined, options.signal ? { signal: options.signal } : undefined);
+        }
+        catch {
+            return;
+        }
+    }
+}
+/**
+ * This function stops the process tree of a turn. On Windows it starts `taskkill /T /F /PID`.
+ * On POSIX it signals the process group, which `startTurn` made. It refuses the id of the host.
+ */
+export async function cancelTurn(pid, options = {}) {
+    if (!Number.isSafeInteger(pid) || pid <= 1)
+        throw new Error(`cancelTurn refuses the process id ${pid}`);
+    if (pid === process.pid || pid === process.ppid)
+        throw new Error("cancelTurn refuses the process of the host");
+    if (!(options.isAlive ?? isProcessAlive)(pid))
+        return { stopped: false, reason: "The process has ended" };
+    if ((options.platform ?? process.platform) === "win32") {
+        const result = await (options.runner ?? runCommand)("taskkill", { args: ["/T", "/F", "/PID", String(pid)], timeout: 30_000 });
+        if (result.exitCode === 0)
+            return { stopped: true };
+        return { stopped: false, reason: (result.error ?? result.stderr.trim()) || `taskkill gave the exit code ${result.exitCode}` };
+    }
+    const kill = options.kill ?? ((target, signal) => void process.kill(target, signal));
+    const signal = options.signal ?? "SIGTERM";
+    try {
+        // The negative id signals the process group: the turn and the programs that it started
+        kill(-pid, signal);
+        return { stopped: true };
+    }
+    catch {
+        try {
+            kill(pid, signal);
+            return { stopped: true };
+        }
+        catch (error) {
+            return { stopped: false, reason: error instanceof Error ? error.message : String(error) };
+        }
+    }
+}
+//# sourceMappingURL=turn.js.map

package/dist/turn.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,61 @@
+/**
+ * The input and the output of the procedures of this package.
+ */
+import { z } from "zod";
+import type { TurnEvent } from "./turn.js";
+/** The schema of one event of a turn, with the byte offset after its line. */
+export declare const TurnEventSchema: z.ZodType<TurnEvent>;
+export interface ClaudeStartInput {
+    prompt: string;
+    cwd?: string | undefined;
+    args?: string[] | undefined;
+    outputFile?: string | undefined;
+    promptFile?: string | undefined;
+    executable?: string | undefined;
+    executableArgs?: string[] | undefined;
+    env?: Record<string, string> | undefined;
+}
+export declare const ClaudeStartInputSchema: z.ZodType<ClaudeStartInput>;
+export interface ClaudeStartOutput {
+    pid: number;
+    outputFile: string;
+    promptFile: string;
+    offset: number;
+    command: string;
+    args: readonly string[];
+    startedAt: string;
+}
+export declare const ClaudeStartOutputSchema: z.ZodType<ClaudeStartOutput>;
+export interface ClaudeReadInput {
+    outputFile: string;
+    offset?: number | undefined;
+    pid?: number | undefined;
+}
+export declare const ClaudeReadInputSchema: z.ZodType<ClaudeReadInput>;
+export interface ClaudeReadOutput {
+    events: TurnEvent[];
+    offset: number;
+    finished: boolean;
+    running?: boolean | undefined;
+    newBytes: number;
+}
+export declare const ClaudeReadOutputSchema: z.ZodType<ClaudeReadOutput>;
+export interface ClaudeFollowInput {
+    outputFile: string;
+    offset?: number | undefined;
+    pid?: number | undefined;
+    pollMs?: number | undefined;
+}
+export declare const ClaudeFollowInputSchema: z.ZodType<ClaudeFollowInput>;
+export type ClaudeFollowOutput = TurnEvent;
+export declare const ClaudeFollowOutputSchema: z.ZodType<ClaudeFollowOutput>;
+export interface ClaudeCancelInput {
+    pid: number;
+}
+export declare const ClaudeCancelInputSchema: z.ZodType<ClaudeCancelInput>;
+export interface ClaudeCancelOutput {
+    stopped: boolean;
+    reason?: string | undefined;
+}
+export declare const ClaudeCancelOutputSchema: z.ZodType<ClaudeCancelOutput>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAO3C,8EAA8E;AAC9E,eAAO,MAAM,eAAe,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAGZ,CAAC;AAStC,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,cAAc,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IACtC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;CAC1C;AAED,eAAO,MAAM,sBAAsB,EAAE,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAS7D,CAAC;AAEH,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,uBAAuB,EAAE,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAQ/D,CAAC;AAMH,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B;AAED,eAAO,MAAM,qBAAqB,EAAE,CAAC,CAAC,OAAO,CAAC,eAAe,CAI3D,CAAC;AAEH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,sBAAsB,EAAE,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAM7D,CAAC;AAMH,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAED,eAAO,MAAM,uBAAuB,EAAE,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAK/D,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,SAAS,CAAC;AAE3C,eAAO,MAAM,wBAAwB,EAAE,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAAmB,CAAC;AAMvF,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;CACb;AAED,eAAO,MAAM,uBAAuB,EAAE,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAE/D,CAAC;AAEH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAED,eAAO,MAAM,wBAAwB,EAAE,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAGjE,CAAC"}

package/dist/types.js

@@ -0,0 +1,61 @@
+/**
+ * The input and the output of the procedures of this package.
+ */
+import { z } from "zod";
+/** The schema of one event. It keeps each field of the event. */
+const ClaudeEventSchema = z.looseObject({
+    type: z.string().describe("meta, text, text-delta, thinking, tool-use, tool-result, result, log or error"),
+});
+/** The schema of one event of a turn, with the byte offset after its line. */
+export const TurnEventSchema = z.object({
+    offset: z.number().describe("The byte offset after the line of the event"),
+    event: ClaudeEventSchema,
+});
+const pidSchema = z.number().int().min(2).describe("The process id of the turn");
+const offsetSchema = z.number().int().min(0).describe("The byte offset to start from (default: 0)");
+export const ClaudeStartInputSchema = z.object({
+    prompt: z.string().min(1).describe("The prompt of the turn"),
+    cwd: z.string().min(1).optional().describe("The working folder of the turn"),
+    args: z.array(z.string()).optional().describe('More arguments, for example ["--resume", "<session>"] or ["--model", "<name>"]'),
+    outputFile: z.string().min(1).optional().describe("The file that gets the output (default: a file in a new temporary folder)"),
+    promptFile: z.string().min(1).optional().describe("The file that holds the prompt (default: <outputFile>.prompt.txt)"),
+    executable: z.string().min(1).optional().describe("The claude program (default: CLAUDE_BIN, then a search)"),
+    executableArgs: z.array(z.string()).optional().describe("The arguments before the flags, for example the path of cli.js"),
+    env: z.record(z.string(), z.string()).optional().describe("Environment variables to add to the environment of the host"),
+});
+export const ClaudeStartOutputSchema = z.object({
+    pid: z.number().describe("The process id of the turn"),
+    outputFile: z.string().describe("The absolute path of the output file"),
+    promptFile: z.string().describe("The absolute path of the prompt file"),
+    offset: z.number().describe("The byte offset where the output of this turn starts"),
+    command: z.string().describe("The program"),
+    args: z.array(z.string()).describe("The arguments of the program"),
+    startedAt: z.string().describe("The start time (ISO 8601)"),
+});
+export const ClaudeReadInputSchema = z.object({
+    outputFile: z.string().min(1).describe("The output file of the turn"),
+    offset: offsetSchema.optional(),
+    pid: pidSchema.optional(),
+});
+export const ClaudeReadOutputSchema = z.object({
+    events: z.array(TurnEventSchema).describe("The new events"),
+    offset: z.number().describe("The byte offset for the next read"),
+    finished: z.boolean().describe("True when the events include the result of the turn"),
+    running: z.boolean().optional().describe("True when the process runs (only with pid)"),
+    newBytes: z.number().describe("The number of new bytes in the file"),
+});
+export const ClaudeFollowInputSchema = z.object({
+    outputFile: z.string().min(1).describe("The output file of the turn"),
+    offset: offsetSchema.optional(),
+    pid: pidSchema.optional().describe("The process id of the turn. Without it, only the result stops the follow."),
+    pollMs: z.number().int().min(10).max(60_000).optional().describe("The time between two reads, in milliseconds (default: 250)"),
+});
+export const ClaudeFollowOutputSchema = TurnEventSchema;
+export const ClaudeCancelInputSchema = z.object({
+    pid: pidSchema,
+});
+export const ClaudeCancelOutputSchema = z.object({
+    stopped: z.boolean().describe("True when the stop reached the process"),
+    reason: z.string().optional().describe("Why the stop did not occur"),
+});
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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