@procedures/claude-cli 0.0.0-stage → 0.4.0

package/dist/events.d.ts

@@ -0,0 +1,93 @@
+/**
+ * The normaliser of the output of `claude -p --output-format stream-json --verbose`.
+ *
+ * Each line of that output is one JSON object. The normaliser turns one line into zero or more
+ * events of a small, stable set. It is pure: it reads no file and keeps no state.
+ */
+/** The start of a session: the `system` line of the CLI. */
+export interface ClaudeMetaEvent {
+    readonly type: "meta";
+    /** The subtype of the `system` line, for example `init`. */
+    readonly subtype?: string;
+    readonly sessionId?: string;
+    readonly model?: string;
+    readonly cwd?: string;
+    readonly tools?: readonly string[];
+    readonly permissionMode?: string;
+}
+/** A text block of the assistant. */
+export interface ClaudeTextEvent {
+    readonly type: "text";
+    readonly text: string;
+}
+/** A part of a text block, with `--include-partial-messages`. */
+export interface ClaudeTextDeltaEvent {
+    readonly type: "text-delta";
+    readonly text: string;
+}
+/** A thinking block of the assistant. The CLI gives an empty block in `-p` mode, and the normaliser drops it. */
+export interface ClaudeThinkingEvent {
+    readonly type: "thinking";
+    readonly text: string;
+}
+/** A tool call of the assistant. */
+export interface ClaudeToolUseEvent {
+    readonly type: "tool-use";
+    readonly id?: string;
+    readonly name: string;
+    readonly input: unknown;
+}
+/** The result of a tool call, as text. */
+export interface ClaudeToolResultEvent {
+    readonly type: "tool-result";
+    readonly toolUseId?: string;
+    readonly output: string;
+    readonly isError: boolean;
+}
+/** The last line of a turn: the final text, the session, the cost and the duration. */
+export interface ClaudeResultEvent {
+    readonly type: "result";
+    /** The subtype, for example `success` or `error_max_turns`. */
+    readonly subtype?: string;
+    readonly isError: boolean;
+    /** The final text of the assistant. */
+    readonly text?: string;
+    /** The session. Give it to `--resume` for the next turn. */
+    readonly sessionId?: string;
+    /** The cost of the turn, in US dollars. */
+    readonly costUsd?: number;
+    readonly durationMs?: number;
+    /** The number of model turns. */
+    readonly turns?: number;
+    readonly usage?: Readonly<Record<string, unknown>>;
+    readonly errors?: readonly string[];
+}
+/** A line that is not JSON. The CLI writes its errors and warnings as text. */
+export interface ClaudeLogEvent {
+    readonly type: "log";
+    readonly text: string;
+}
+/** An error of the turn, for example a process that ended without a result. The normaliser does not make it. */
+export interface ClaudeErrorEvent {
+    readonly type: "error";
+    readonly message: string;
+}
+/** One normalised event of a turn. */
+export type ClaudeEvent = ClaudeMetaEvent | ClaudeTextEvent | ClaudeTextDeltaEvent | ClaudeThinkingEvent | ClaudeToolUseEvent | ClaudeToolResultEvent | ClaudeResultEvent | ClaudeLogEvent | ClaudeErrorEvent;
+/** The types of the events. */
+export type ClaudeEventType = ClaudeEvent["type"];
+/**
+ * This function gives a value as text with a maximum length. It adds `…` when it cuts the text.
+ * The normaliser does not cut. A caller uses this function for a short preview.
+ */
+export declare function preview(value: unknown, max?: number): string;
+/** This function gives the content of a tool result as text. A block that is not text gives `[type]`. */
+export declare function toolResultText(content: unknown): string;
+/**
+ * This function normalises one line of `claude -p --output-format stream-json --verbose`. An
+ * empty line or an unknown JSON object gives no event. A line that is not JSON gives a `log` event.
+ */
+export declare function normalizeLine(line: string): ClaudeEvent[];
+/** This function normalises each line of a text. */
+export declare function normalizeText(text: string): ClaudeEvent[];
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

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

package/dist/events.js

@@ -0,0 +1,153 @@
+/**
+ * The normaliser of the output of `claude -p --output-format stream-json --verbose`.
+ *
+ * Each line of that output is one JSON object. The normaliser turns one line into zero or more
+ * events of a small, stable set. It is pure: it reads no file and keeps no state.
+ */
+function isObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function str(value) {
+    return typeof value === "string" ? value : undefined;
+}
+function num(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : undefined;
+}
+/** This function gives the fields whose value is not `undefined`. */
+function defined(fields) {
+    return Object.fromEntries(Object.entries(fields).filter(([, value]) => value !== undefined));
+}
+/**
+ * This function gives a value as text with a maximum length. It adds `…` when it cuts the text.
+ * The normaliser does not cut. A caller uses this function for a short preview.
+ */
+export function preview(value, max = 400) {
+    const text = typeof value === "string" ? value : JSON.stringify(value);
+    if (text === undefined)
+        return "";
+    return text.length > max ? `${text.slice(0, max)}…` : text;
+}
+/** This function gives the content of a tool result as text. A block that is not text gives `[type]`. */
+export function toolResultText(content) {
+    if (typeof content === "string")
+        return content;
+    if (Array.isArray(content)) {
+        return content
+            .map((block) => {
+            if (typeof block === "string")
+                return block;
+            if (isObject(block))
+                return typeof block["text"] === "string" ? block["text"] : `[${str(block["type"]) ?? "block"}]`;
+            return "";
+        })
+            .join("\n");
+    }
+    return content === undefined || content === null ? "" : JSON.stringify(content);
+}
+function metaEvent(line) {
+    const tools = Array.isArray(line["tools"]) ? line["tools"].filter((tool) => typeof tool === "string") : undefined;
+    return defined({
+        type: "meta",
+        subtype: str(line["subtype"]),
+        sessionId: str(line["session_id"]),
+        model: str(line["model"]),
+        cwd: str(line["cwd"]),
+        tools,
+        permissionMode: str(line["permissionMode"]),
+    });
+}
+function messageEvents(line) {
+    const message = line["message"];
+    const content = isObject(message) && Array.isArray(message["content"]) ? message["content"] : [];
+    const fromAssistant = line["type"] === "assistant";
+    const events = [];
+    for (const block of content) {
+        if (!isObject(block))
+            continue;
+        const kind = block["type"];
+        if (fromAssistant && kind === "text") {
+            const text = str(block["text"]);
+            if (text)
+                events.push({ type: "text", text });
+        }
+        else if (fromAssistant && kind === "thinking") {
+            const text = str(block["thinking"]);
+            if (text)
+                events.push({ type: "thinking", text });
+        }
+        else if (kind === "tool_use") {
+            const id = str(block["id"]);
+            events.push({ type: "tool-use", ...(id !== undefined ? { id } : {}), name: str(block["name"]) ?? "tool", input: block["input"] ?? {} });
+        }
+        else if (kind === "tool_result") {
+            events.push(defined({
+                type: "tool-result",
+                toolUseId: str(block["tool_use_id"]),
+                output: toolResultText(block["content"]),
+                isError: block["is_error"] === true,
+            }));
+        }
+    }
+    return events;
+}
+function resultEvent(line) {
+    const errors = Array.isArray(line["errors"]) ? line["errors"].filter((error) => typeof error === "string") : undefined;
+    return defined({
+        type: "result",
+        subtype: str(line["subtype"]),
+        isError: line["is_error"] === true,
+        text: str(line["result"]),
+        sessionId: str(line["session_id"]),
+        costUsd: num(line["total_cost_usd"]) ?? num(line["cost_usd"]),
+        durationMs: num(line["duration_ms"]),
+        turns: num(line["num_turns"]),
+        usage: isObject(line["usage"]) ? line["usage"] : undefined,
+        errors: errors !== undefined && errors.length > 0 ? errors : undefined,
+    });
+}
+function streamEvents(line) {
+    const event = line["event"];
+    if (!isObject(event) || event["type"] !== "content_block_delta")
+        return [];
+    const delta = event["delta"];
+    if (!isObject(delta) || delta["type"] !== "text_delta")
+        return [];
+    const text = str(delta["text"]);
+    return text ? [{ type: "text-delta", text }] : [];
+}
+/**
+ * This function normalises one line of `claude -p --output-format stream-json --verbose`. An
+ * empty line or an unknown JSON object gives no event. A line that is not JSON gives a `log` event.
+ */
+export function normalizeLine(line) {
+    const trimmed = line.trim();
+    if (trimmed.length === 0)
+        return [];
+    let parsed;
+    try {
+        parsed = JSON.parse(trimmed);
+    }
+    catch {
+        return [{ type: "log", text: trimmed }];
+    }
+    if (!isObject(parsed))
+        return [];
+    switch (parsed["type"]) {
+        case "system":
+            return [metaEvent(parsed)];
+        case "assistant":
+        case "user":
+            return messageEvents(parsed);
+        case "result":
+            return [resultEvent(parsed)];
+        case "stream_event":
+            return streamEvents(parsed);
+        default:
+            return [];
+    }
+}
+/** This function normalises each line of a text. */
+export function normalizeText(text) {
+    return text.split("\n").flatMap((line) => normalizeLine(line));
+}
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

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

package/dist/executable.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Find the `claude` program of Claude Code.
+ */
+/** The environment variable that names the `claude` program. It comes before the search. */
+export declare const CLAUDE_ENV = "CLAUDE_BIN";
+/** The options of `findClaude`. Each one has a default from the host. */
+export interface FindClaudeOptions {
+    /** The `claude` program. When it is set, the search does not occur. */
+    readonly executable?: string | undefined;
+    /** The environment (default: `process.env`). */
+    readonly env?: Readonly<Record<string, string | undefined>> | undefined;
+    /** The operating system (default: `process.platform`). */
+    readonly platform?: NodeJS.Platform | undefined;
+    /** The function that tells if a file exists (default: `existsSync`). */
+    readonly exists?: ((path: string) => boolean) | undefined;
+}
+/**
+ * This function gives the paths that the search examines, in order: the folders of the `PATH`,
+ * then the install folders of the native installer. On Windows, it looks only for `claude.exe`,
+ * because a batch file (`claude.cmd`) does not start without a shell.
+ */
+export declare function claudeCandidates(platform: NodeJS.Platform, env: Readonly<Record<string, string | undefined>>): string[];
+/**
+ * This function finds the `claude` program. The order is `executable`, then `CLAUDE_BIN`, then
+ * the `PATH` and the install folders. It gives `undefined` when it finds none.
+ */
+export declare function findClaude(options?: FindClaudeOptions): string | undefined;
+//# sourceMappingURL=executable.d.ts.map

package/dist/executable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executable.d.ts","sourceRoot":"","sources":["../src/executable.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,4FAA4F;AAC5F,eAAO,MAAM,UAAU,eAAe,CAAC;AAEvC,yEAAyE;AACzE,MAAM,WAAW,iBAAiB;IAChC,uEAAuE;IACvE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,gDAAgD;IAChD,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,GAAG,SAAS,CAAC;IACxE,0DAA0D;IAC1D,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,GAAG,SAAS,CAAC;IAChD,wEAAwE;IACxE,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,SAAS,CAAC;CAC3D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,GAAG,MAAM,EAAE,CASvH;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,OAAO,GAAE,iBAAsB,GAAG,MAAM,GAAG,SAAS,CAO9E"}

package/dist/executable.js

@@ -0,0 +1,37 @@
+/**
+ * Find the `claude` program of Claude Code.
+ */
+import { existsSync } from "node:fs";
+import { posix, win32 } from "node:path";
+/** The environment variable that names the `claude` program. It comes before the search. */
+export const CLAUDE_ENV = "CLAUDE_BIN";
+/**
+ * This function gives the paths that the search examines, in order: the folders of the `PATH`,
+ * then the install folders of the native installer. On Windows, it looks only for `claude.exe`,
+ * because a batch file (`claude.cmd`) does not start without a shell.
+ */
+export function claudeCandidates(platform, env) {
+    const windows = platform === "win32";
+    const path = windows ? win32 : posix;
+    const name = windows ? "claude.exe" : "claude";
+    const pathValue = windows ? (env["Path"] ?? env["PATH"]) : env["PATH"];
+    const folders = (pathValue ?? "").split(windows ? ";" : ":").filter((folder) => folder.length > 0);
+    const home = windows ? (env["USERPROFILE"] ?? env["HOME"]) : env["HOME"];
+    const installed = home !== undefined ? [path.join(home, ".local", "bin", name), path.join(home, ".claude", "local", name)] : [];
+    return [...folders.map((folder) => path.join(folder, name)), ...installed];
+}
+/**
+ * This function finds the `claude` program. The order is `executable`, then `CLAUDE_BIN`, then
+ * the `PATH` and the install folders. It gives `undefined` when it finds none.
+ */
+export function findClaude(options = {}) {
+    if (options.executable !== undefined && options.executable.length > 0)
+        return options.executable;
+    const env = options.env ?? process.env;
+    const override = env[CLAUDE_ENV];
+    if (override !== undefined && override.length > 0)
+        return override;
+    const exists = options.exists ?? existsSync;
+    return claudeCandidates(options.platform ?? process.platform, env).find((candidate) => exists(candidate));
+}
+//# sourceMappingURL=executable.js.map

package/dist/executable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executable.js","sourceRoot":"","sources":["../src/executable.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAEzC,4FAA4F;AAC5F,MAAM,CAAC,MAAM,UAAU,GAAG,YAAY,CAAC;AAcvC;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAyB,EAAE,GAAiD;IAC3G,MAAM,OAAO,GAAG,QAAQ,KAAK,OAAO,CAAC;IACrC,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;IACrC,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC/C,MAAM,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACvE,MAAM,OAAO,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACnG,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACzE,MAAM,SAAS,GAAG,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAChI,OAAO,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,EAAE,GAAG,SAAS,CAAC,CAAC;AAC7E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,OAAO,GAAsB,EAAE;IACxD,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS,IAAI,OAAO,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,OAAO,CAAC,UAAU,CAAC;IACjG,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACvC,MAAM,QAAQ,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC;IACjC,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,QAAQ,CAAC;IACnE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,UAAU,CAAC;IAC5C,OAAO,gBAAgB,CAAC,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;AAC5G,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./module.js";
+export * from "./types.js";
+export * from "./events.js";
+export * from "./executable.js";
+export * from "./turn.js";
+export { claudeStart, claudeRead, claudeFollow, claudeCancel } from "./procedures/claude/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+// The root registers nothing: import "<package>/register", or give the module to createRegistry()
+export * from "./module.js";
+export * from "./types.js";
+export * from "./events.js";
+export * from "./executable.js";
+export * from "./turn.js";
+export { claudeStart, claudeRead, claudeFollow, claudeCancel } from "./procedures/claude/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/module.d.ts

@@ -0,0 +1,19 @@
+/**
+ * The procedures of @procedures/claude-cli as data. An import of this file registers nothing.
+ *
+ * Scaffold a procedure with: mark procedure new <name> --path packages/claude-cli
+ */
+import { type AnyProcedure, type ProcedureModule, type ProcedureRegistry } from "@procedures/client";
+export declare const claudeStartProcedure: AnyProcedure;
+export declare const claudeReadProcedure: AnyProcedure;
+export declare const claudeFollowProcedure: AnyProcedure;
+export declare const claudeCancelProcedure: AnyProcedure;
+export declare const claudeCliProcedures: AnyProcedure[];
+export declare const claudeCliModule: ProcedureModule;
+export default claudeCliModule;
+/**
+ * This function registers the procedures of @procedures/claude-cli in a registry. The default is the
+ * global registry.
+ */
+export declare function registerClaudeCliProcedures(registry?: ProcedureRegistry): void;
+//# sourceMappingURL=module.d.ts.map

package/dist/module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAIL,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EAGvB,MAAM,oBAAoB,CAAC;AA2B5B,eAAO,MAAM,oBAAoB,EAAE,YAaT,CAAC;AAE3B,eAAO,MAAM,mBAAmB,EAAE,YAYR,CAAC;AAE3B,eAAO,MAAM,qBAAqB,EAAE,YAeV,CAAC;AAE3B,eAAO,MAAM,qBAAqB,EAAE,YAaV,CAAC;AAE3B,eAAO,MAAM,mBAAmB,EAAE,YAAY,EAA8F,CAAC;AAE7I,eAAO,MAAM,eAAe,EAAE,eAA6E,CAAC;eAE7F,eAAe;AAE9B;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,GAAE,iBAAsC,GAAG,IAAI,CAElG"}

package/dist/module.js

@@ -0,0 +1,81 @@
+/**
+ * The procedures of @procedures/claude-cli as data. An import of this file registers nothing.
+ *
+ * Scaffold a procedure with: mark procedure new <name> --path packages/claude-cli
+ */
+import { defineModule, registerModules, PROCEDURE_REGISTRY, createProcedure, zodAdapter, } from "@procedures/client";
+import { claudeStart } from "./procedures/claude/start.js";
+import { claudeRead } from "./procedures/claude/read.js";
+import { claudeFollow } from "./procedures/claude/follow.js";
+import { claudeCancel } from "./procedures/claude/cancel.js";
+import { ClaudeStartInputSchema, ClaudeStartOutputSchema, ClaudeReadInputSchema, ClaudeReadOutputSchema, ClaudeFollowInputSchema, ClaudeFollowOutputSchema, ClaudeCancelInputSchema, ClaudeCancelOutputSchema, } from "./types.js";
+/** The effects of a read of the output file. The check of the process id reads the turn process. */
+const READS_TURN = { reads: ["fs", "jobs"], writes: [] };
+export const claudeStartProcedure = createProcedure()
+    .path(["claude", "start"])
+    .input(zodAdapter(ClaudeStartInputSchema))
+    .output(zodAdapter(ClaudeStartOutputSchema))
+    .meta({
+    description: "Start one turn of the Claude Code CLI as a detached process that writes to a file",
+    args: ["prompt"],
+    shorts: { cwd: "C" },
+    output: "json",
+    // The agent of the turn can read and change files, start programs and use the network
+    effects: { reads: ["fs", "network", "process"], writes: ["fs", "network", "process", "jobs"] },
+})
+    .handler(async (input) => claudeStart(input))
+    .build();
+export const claudeReadProcedure = createProcedure()
+    .path(["claude", "read"])
+    .input(zodAdapter(ClaudeReadInputSchema))
+    .output(zodAdapter(ClaudeReadOutputSchema))
+    .meta({
+    description: "Read the new events of a turn from its output file",
+    args: ["outputFile"],
+    shorts: {},
+    output: "json",
+    effects: READS_TURN,
+})
+    .handler(async (input) => claudeRead(input))
+    .build();
+export const claudeFollowProcedure = createProcedure()
+    .path(["claude", "follow"])
+    .input(zodAdapter(ClaudeFollowInputSchema))
+    .output(zodAdapter(ClaudeFollowOutputSchema))
+    .meta({
+    description: "Follow the output file of a turn and stream its events until the turn ends",
+    args: ["outputFile"],
+    shorts: {},
+    output: "json",
+    streaming: true,
+    // A turn has no time limit: the stream ends with the turn
+    stream: { unbounded: true },
+    effects: READS_TURN,
+})
+    .handler(claudeFollow)
+    .build();
+export const claudeCancelProcedure = createProcedure()
+    .path(["claude", "cancel"])
+    .input(zodAdapter(ClaudeCancelInputSchema))
+    .output(zodAdapter(ClaudeCancelOutputSchema))
+    .meta({
+    description: "Stop a turn and the processes that it started",
+    args: ["pid"],
+    shorts: {},
+    output: "json",
+    // It stops the process tree of the id that it gets
+    effects: { reads: ["jobs"], writes: ["jobs"], destructive: true, idempotent: true },
+})
+    .handler(async (input) => claudeCancel(input))
+    .build();
+export const claudeCliProcedures = [claudeStartProcedure, claudeReadProcedure, claudeFollowProcedure, claudeCancelProcedure];
+export const claudeCliModule = defineModule("@procedures/claude-cli", claudeCliProcedures);
+export default claudeCliModule;
+/**
+ * This function registers the procedures of @procedures/claude-cli in a registry. The default is the
+ * global registry.
+ */
+export function registerClaudeCliProcedures(registry = PROCEDURE_REGISTRY) {
+    registerModules(registry, [claudeCliModule]);
+}
+//# sourceMappingURL=module.js.map

package/dist/module.js.map

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

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

@@ -0,0 +1,13 @@
+/**
+ * claude.cancel procedure
+ *
+ * This procedure stops a turn and the processes that it started, by the process id of the turn.
+ * It also stops a turn that a previous host started.
+ */
+import type { ClaudeCancelInput, ClaudeCancelOutput } from "../../types.js";
+/**
+ * This function stops the process tree of the turn. It gives `stopped: false` and a reason when
+ * the process has ended.
+ */
+export declare function claudeCancel(input: ClaudeCancelInput): Promise<ClaudeCancelOutput>;
+//# sourceMappingURL=cancel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cancel.d.ts","sourceRoot":"","sources":["../../../src/procedures/claude/cancel.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAE5E;;;GAGG;AACH,wBAAsB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAExF"}

package/dist/procedures/claude/cancel.js

@@ -0,0 +1,15 @@
+/**
+ * claude.cancel procedure
+ *
+ * This procedure stops a turn and the processes that it started, by the process id of the turn.
+ * It also stops a turn that a previous host started.
+ */
+import { cancelTurn } from "../../turn.js";
+/**
+ * This function stops the process tree of the turn. It gives `stopped: false` and a reason when
+ * the process has ended.
+ */
+export async function claudeCancel(input) {
+    return cancelTurn(input.pid);
+}
+//# sourceMappingURL=cancel.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cancel.js","sourceRoot":"","sources":["../../../src/procedures/claude/cancel.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAG3C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,KAAwB;IACzD,OAAO,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AAC/B,CAAC"}

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

@@ -0,0 +1,15 @@
+/**
+ * claude.follow procedure
+ *
+ * This procedure follows the output file of a turn and streams its events until the turn ends.
+ * When the caller stops reading, or its signal aborts, the follow stops. The turn continues.
+ */
+import type { ClaudeFollowInput, ClaudeFollowOutput } from "../../types.js";
+/**
+ * This function gives each event of the turn. It stops after the result, or after an error event
+ * when the process ends without a result.
+ */
+export declare function claudeFollow(input: ClaudeFollowInput, ctx?: {
+    signal?: AbortSignal | undefined;
+}): AsyncGenerator<ClaudeFollowOutput, void, undefined>;
+//# sourceMappingURL=follow.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"follow.d.ts","sourceRoot":"","sources":["../../../src/procedures/claude/follow.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAE5E;;;GAGG;AACH,wBAAuB,YAAY,CACjC,KAAK,EAAE,iBAAiB,EACxB,GAAG,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAA;CAAE,GACzC,cAAc,CAAC,kBAAkB,EAAE,IAAI,EAAE,SAAS,CAAC,CAQrD"}

package/dist/procedures/claude/follow.js

@@ -0,0 +1,21 @@
+/**
+ * claude.follow procedure
+ *
+ * This procedure follows the output file of a turn and streams its events until the turn ends.
+ * When the caller stops reading, or its signal aborts, the follow stops. The turn continues.
+ */
+import { followTurn } from "../../turn.js";
+/**
+ * This function gives each event of the turn. It stops after the result, or after an error event
+ * when the process ends without a result.
+ */
+export async function* claudeFollow(input, ctx) {
+    yield* followTurn({
+        outputFile: input.outputFile,
+        offset: input.offset,
+        pid: input.pid,
+        pollMs: input.pollMs,
+        signal: ctx?.signal,
+    });
+}
+//# sourceMappingURL=follow.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"follow.js","sourceRoot":"","sources":["../../../src/procedures/claude/follow.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAG3C;;;GAGG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,YAAY,CACjC,KAAwB,EACxB,GAA0C;IAE1C,KAAK,CAAC,CAAC,UAAU,CAAC;QAChB,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,MAAM,EAAE,GAAG,EAAE,MAAM;KACpB,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,5 @@
+export { claudeStart } from "./start.js";
+export { claudeRead } from "./read.js";
+export { claudeFollow } from "./follow.js";
+export { claudeCancel } from "./cancel.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/procedures/claude/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/procedures/claude/index.js

@@ -0,0 +1,5 @@
+export { claudeStart } from "./start.js";
+export { claudeRead } from "./read.js";
+export { claudeFollow } from "./follow.js";
+export { claudeCancel } from "./cancel.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/procedures/claude/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

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

@@ -0,0 +1,12 @@
+/**
+ * claude.read procedure
+ *
+ * This procedure reads the new events of a turn from its output file, from a byte offset.
+ */
+import type { ClaudeReadInput, ClaudeReadOutput } from "../../types.js";
+/**
+ * This function reads the complete lines after `input.offset` and gives their events and the
+ * offset for the next read.
+ */
+export declare function claudeRead(input: ClaudeReadInput): Promise<ClaudeReadOutput>;
+//# sourceMappingURL=read.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../../src/procedures/claude/read.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAExE;;;GAGG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAElF"}

package/dist/procedures/claude/read.js

@@ -0,0 +1,14 @@
+/**
+ * claude.read procedure
+ *
+ * This procedure reads the new events of a turn from its output file, from a byte offset.
+ */
+import { readTurn } from "../../turn.js";
+/**
+ * This function reads the complete lines after `input.offset` and gives their events and the
+ * offset for the next read.
+ */
+export async function claudeRead(input) {
+    return readTurn({ outputFile: input.outputFile, offset: input.offset, pid: input.pid });
+}
+//# sourceMappingURL=read.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"read.js","sourceRoot":"","sources":["../../../src/procedures/claude/read.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGzC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,KAAsB;IACrD,OAAO,QAAQ,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;AAC1F,CAAC"}