@llm4ts/shell 0.2.0

package/dist/Cli.d.ts

@@ -0,0 +1,33 @@
+import * as Effect from "effect/Effect";
+import { FileSystem } from "effect/FileSystem";
+import * as Schema from "effect/Schema";
+import * as Command from "effect/unstable/cli/Command";
+import { type DiscoveredFlow, type FlowTierPaths } from "./FlowCatalog.ts";
+declare const ShellUsageError_base: Schema.Class<ShellUsageError, Schema.TaggedStruct<"ShellUsage", {
+    readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+export declare class ShellUsageError extends ShellUsageError_base {
+}
+declare const ShellActionError_base: Schema.Class<ShellActionError, Schema.TaggedStruct<"ShellAction", {
+    readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+export declare class ShellActionError extends ShellActionError_base {
+}
+export declare const builtinFlowsDir: () => string;
+export declare const shellTierPaths: (options?: {
+    readonly cwd?: string;
+    readonly environment?: Readonly<Record<string, string | undefined>>;
+}) => FlowTierPaths;
+export declare const renderFlowList: (flows: ReadonlyArray<DiscoveredFlow>, options?: {
+    readonly json?: boolean;
+}) => string;
+/**
+ * Resolves a flow argument to a runnable script path: an explicit path (a
+ * value containing a separator or ending in `.ts`) is used as-is, anything
+ * else is looked up by name in the discovery listing.
+ */
+export declare const resolveFlow: (reference: string, tiers: FlowTierPaths) => Effect.Effect<string, ShellUsageError, FileSystem>;
+export declare const shellCommand: Command.Command<"llm4ts", {} | {}, {}, ShellUsageError | ShellActionError | import("./FlowLaunch.ts").FlowLaunchError, import("effect/unstable/cli/Prompt").Environment>;
+export declare const runShellCommand: (argv: ReadonlyArray<string>) => Effect.Effect<void, unknown, Command.Environment>;
+export {};
+//# sourceMappingURL=Cli.d.ts.map

package/dist/Cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Cli.d.ts","sourceRoot":"","sources":["../src/Cli.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC,OAAO,KAAK,OAAO,MAAM,6BAA6B,CAAA;AAItD,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,kBAAkB,CAAA;;;;AAKzB,qBAAa,eAAgB,SAAQ,oBAEnC;CAAG;;;;AAEL,qBAAa,gBAAiB,SAAQ,qBAEpC;CAAG;AAEL,eAAO,MAAM,eAAe,QAAO,MAA6D,CAAA;AAEhG,eAAO,MAAM,cAAc,GAAI,UAAU;IACvC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAA;CACpE,KAAG,aAMA,CAAA;AAOJ,eAAO,MAAM,cAAc,GACzB,OAAO,aAAa,CAAC,cAAc,CAAC,EACpC,UAAU;IAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,KACpC,MAwBF,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,WAAW,iGAwBtB,CAAA;AAyGF,eAAO,MAAM,YAAY,0KAcxB,CAAA;AAED,eAAO,MAAM,eAAe,GAC1B,MAAM,aAAa,CAAC,MAAM,CAAC,KAC1B,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,WAAW,CACe,CAAA"}

package/dist/Cli.js

@@ -0,0 +1,148 @@
+import { homedir } from "node:os";
+import { fileURLToPath } from "node:url";
+import * as Console from "effect/Console";
+import * as Effect from "effect/Effect";
+import { FileSystem } from "effect/FileSystem";
+import * as Schema from "effect/Schema";
+import * as Argument from "effect/unstable/cli/Argument";
+import * as Command from "effect/unstable/cli/Command";
+import * as Flag from "effect/unstable/cli/Flag";
+import { makeCliProgram } from "@llm4ts/runner/Cli";
+import { makeDoctorProgram } from "@llm4ts/runner/Doctor";
+import { defaultTierPaths, discoverFlows } from "./FlowCatalog.js";
+import { launchFlow } from "./FlowLaunch.js";
+import { mainMenu } from "./Menu.js";
+import { packageVersion } from "./Package.js";
+export class ShellUsageError extends Schema.TaggedErrorClass()("ShellUsage", {
+    message: Schema.String
+}) {
+}
+export class ShellActionError extends Schema.TaggedErrorClass()("ShellAction", {
+    message: Schema.String
+}) {
+}
+export const builtinFlowsDir = () => fileURLToPath(new URL("../flows", import.meta.url));
+export const shellTierPaths = (options) => defaultTierPaths({
+    cwd: options?.cwd ?? process.cwd(),
+    homeDir: homedir(),
+    environment: options?.environment ?? process.env,
+    builtinDir: builtinFlowsDir()
+});
+const tierLabel = (flow) => {
+    const shadows = flow.shadows.length === 0 ? "" : ` shadows ${flow.shadows.join(", ")}`;
+    return `[${flow.tier}${shadows}]`;
+};
+export const renderFlowList = (flows, options) => {
+    if (options?.json === true) {
+        return JSON.stringify(flows.map((flow) => ({
+            name: flow.name,
+            tier: flow.tier,
+            path: flow.path,
+            ...(flow.description === undefined ? {} : { description: flow.description }),
+            shadows: flow.shadows
+        })), undefined, 2);
+    }
+    const nameWidth = flows.reduce((width, flow) => Math.max(width, flow.name.length), 0);
+    return flows
+        .map((flow) => [
+        flow.name.padEnd(nameWidth),
+        tierLabel(flow),
+        ...(flow.description === undefined ? [] : [flow.description])
+    ].join("  "))
+        .join("\n");
+};
+/**
+ * Resolves a flow argument to a runnable script path: an explicit path (a
+ * value containing a separator or ending in `.ts`) is used as-is, anything
+ * else is looked up by name in the discovery listing.
+ */
+export const resolveFlow = Effect.fn("@llm4ts/shell/Cli.resolveFlow")(function* (reference, tiers) {
+    if (reference.includes("/") || reference.endsWith(".ts")) {
+        const fs = yield* FileSystem;
+        const exists = yield* fs.exists(reference).pipe(Effect.orElseSucceed(() => false));
+        if (!exists) {
+            return yield* new ShellUsageError({ message: `flow script not found: ${reference}` });
+        }
+        return reference;
+    }
+    const flows = yield* discoverFlows(tiers);
+    const found = flows.find((flow) => flow.name === reference);
+    if (found === undefined) {
+        const known = flows.map((flow) => flow.name).join(", ");
+        return yield* new ShellUsageError({
+            message: known.length === 0
+                ? `unknown flow '${reference}' (no flows discovered)`
+                : `unknown flow '${reference}' (known flows: ${known})`
+        });
+    }
+    return found.path;
+});
+const runCommand = Command.make("run", {
+    flow: Argument.string("flow").pipe(Argument.withDescription("Flow name from `llm4ts list`, or a path to a flow script")),
+    task: Argument.string("task").pipe(Argument.variadic(), Argument.withDescription("Task text passed to the flow")),
+    verbose: Flag.boolean("verbose").pipe(Flag.withDescription("Stream verbose flow output"))
+}, (config) => Effect.gen(function* () {
+    const tiers = shellTierPaths();
+    const flowPath = yield* resolveFlow(config.flow, tiers);
+    const environment = { ...process.env };
+    if (config.verbose) {
+        environment.LLM4TS_VERBOSITY = "verbose";
+    }
+    const exitCode = yield* launchFlow({
+        flowPath,
+        taskArgs: config.task,
+        environment
+    });
+    yield* Effect.sync(() => {
+        process.exitCode = exitCode;
+    });
+})).pipe(Command.withDescription("Run a discovered flow as a child process"));
+const listCommand = Command.make("list", {
+    json: Flag.boolean("json").pipe(Flag.withDescription("Emit the listing as JSON"))
+}, (config) => Effect.gen(function* () {
+    const flows = yield* discoverFlows(shellTierPaths());
+    if (flows.length === 0 && !config.json) {
+        yield* Console.error("no flows discovered");
+        return;
+    }
+    yield* Console.log(renderFlowList(flows, { json: config.json }));
+})).pipe(Command.withDescription("List flows across the project, global, and built-in tiers"));
+const viewCommand = Command.make("view", {
+    flow: Argument.string("flow").pipe(Argument.withDescription("Flow name from `llm4ts list`, or a path to a flow script"))
+}, (config) => Effect.gen(function* () {
+    const flowPath = yield* resolveFlow(config.flow, shellTierPaths());
+    const fs = yield* FileSystem;
+    const source = yield* fs
+        .readFileString(flowPath)
+        .pipe(Effect.mapError(() => new ShellActionError({ message: `cannot read ${flowPath}` })));
+    yield* Console.log(source.trimEnd());
+})).pipe(Command.withDescription("Print a flow's source"));
+const askCommand = Command.make("ask", {
+    prompt: Argument.string("prompt").pipe(Argument.variadic(), Argument.withDescription("Prompt streamed once to the selected coding agent")),
+    repo: Flag.string("repo").pipe(Flag.optional, Flag.withDescription("Repository to run against (defaults to the current directory)"))
+}, (config) => Effect.gen(function* () {
+    if (config.prompt.length === 0) {
+        return yield* new ShellUsageError({ message: "ask needs a prompt" });
+    }
+    const argv = [
+        config.prompt.join(" "),
+        ...(config.repo._tag === "Some" ? ["--repo", config.repo.value] : [])
+    ];
+    yield* makeCliProgram(argv).pipe(Effect.mapError((error) => error._tag === "ScriptUsage"
+        ? new ShellUsageError({ message: error.message })
+        : new ShellActionError({ message: error.message })));
+})).pipe(Command.withDescription("Stream a one-shot prompt to the selected coding agent"));
+const doctorCommand = Command.make("doctor", {}, () => Effect.gen(function* () {
+    const report = yield* makeDoctorProgram();
+    yield* Console.log(report.trimEnd());
+})).pipe(Command.withDescription("Report available connectors and credentials"));
+export const shellCommand = Command.make("llm4ts", {}, () => Effect.gen(function* () {
+    if (!process.stdin.isTTY || !process.stdout.isTTY) {
+        return yield* new ShellUsageError({
+            message: "no command given and no interactive terminal; try `llm4ts --help`"
+        });
+    }
+    yield* mainMenu(shellTierPaths());
+})).pipe(Command.withDescription("Interactive shell and CLI for llm4ts flows: discover, inspect, and run them."), Command.withSubcommands([runCommand, listCommand, viewCommand, askCommand, doctorCommand]));
+export const runShellCommand = (argv) => Command.runWith(shellCommand, { version: packageVersion })(argv);
+//# sourceMappingURL=Cli.js.map

package/dist/Cli.js.map

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

package/dist/CoderChoice.d.ts

@@ -0,0 +1,18 @@
+/**
+ * The coder tokens `coderFromEnv` accepts as `LLM4TS_CODER` values, each with
+ * the executable name the corresponding CLI connector spawns. The tokens are
+ * the connector identity vocabulary of `@llm4ts/core/Models` narrowed to the
+ * CLI coding agents the runner exposes.
+ */
+export interface CoderChoice {
+    readonly token: string;
+    readonly executable: string;
+}
+export declare const coderChoices: ReadonlyArray<CoderChoice>;
+/**
+ * Locates an executable on `PATH` without spawning a process. Decoration
+ * only: an undetected CLI stays selectable, mirroring orca's wizard probing.
+ */
+export declare const findOnPath: (executable: string, environment?: Readonly<Record<string, string | undefined>>) => string | undefined;
+export declare const resolvedCoderToken: (environment?: Readonly<Record<string, string | undefined>>) => string;
+//# sourceMappingURL=CoderChoice.d.ts.map

package/dist/CoderChoice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CoderChoice.d.ts","sourceRoot":"","sources":["../src/CoderChoice.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B;AAED,eAAO,MAAM,YAAY,EAAE,aAAa,CAAC,WAAW,CASnD,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,UAAU,GACrB,YAAY,MAAM,EAClB,cAAa,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAe,KACtE,MAAM,GAAG,SAkBX,CAAA;AAED,eAAO,MAAM,kBAAkB,GAC7B,cAAa,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAe,KACtE,MAGF,CAAA"}

package/dist/CoderChoice.js

@@ -0,0 +1,41 @@
+import { accessSync, constants } from "node:fs";
+import { delimiter, join } from "node:path";
+export const coderChoices = [
+    { token: "claude", executable: "claude" },
+    { token: "codex", executable: "codex" },
+    { token: "gemini", executable: "gemini" },
+    { token: "pi", executable: "pi" },
+    { token: "agy", executable: "agy" },
+    { token: "grok", executable: "grok" },
+    { token: "cursor", executable: "cursor-agent" },
+    { token: "opencode", executable: "opencode" }
+];
+/**
+ * Locates an executable on `PATH` without spawning a process. Decoration
+ * only: an undetected CLI stays selectable, mirroring orca's wizard probing.
+ */
+export const findOnPath = (executable, environment = process.env) => {
+    const searchPath = environment.PATH;
+    if (searchPath === undefined || searchPath.length === 0) {
+        return undefined;
+    }
+    for (const directory of searchPath.split(delimiter)) {
+        if (directory.length === 0) {
+            continue;
+        }
+        const candidate = join(directory, executable);
+        try {
+            accessSync(candidate, constants.X_OK);
+            return candidate;
+        }
+        catch {
+            continue;
+        }
+    }
+    return undefined;
+};
+export const resolvedCoderToken = (environment = process.env) => {
+    const token = environment.LLM4TS_CODER ?? environment.LLM4ZIO_CODER ?? "claude";
+    return coderChoices.some((choice) => choice.token === token) ? token : "claude";
+};
+//# sourceMappingURL=CoderChoice.js.map

package/dist/CoderChoice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CoderChoice.js","sourceRoot":"","sources":["../src/CoderChoice.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAC/C,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAa3C,MAAM,CAAC,MAAM,YAAY,GAA+B;IACtD,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE;IACzC,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE;IACvC,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE;IACzC,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE;IACjC,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE;IACnC,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE;IACrC,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,cAAc,EAAE;IAC/C,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE;CAC9C,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,UAAkB,EAClB,cAA4D,OAAO,CAAC,GAAG,EACnD,EAAE;IACtB,MAAM,UAAU,GAAG,WAAW,CAAC,IAAI,CAAA;IACnC,IAAI,UAAU,KAAK,SAAS,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxD,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,KAAK,MAAM,SAAS,IAAI,UAAU,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;QACpD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,SAAQ;QACV,CAAC;QACD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAA;QAC7C,IAAI,CAAC;YACH,UAAU,CAAC,SAAS,EAAE,SAAS,CAAC,IAAI,CAAC,CAAA;YACrC,OAAO,SAAS,CAAA;QAClB,CAAC;QAAC,MAAM,CAAC;YACP,SAAQ;QACV,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,cAA4D,OAAO,CAAC,GAAG,EAC/D,EAAE;IACV,MAAM,KAAK,GAAG,WAAW,CAAC,YAAY,IAAI,WAAW,CAAC,aAAa,IAAI,QAAQ,CAAA;IAC/E,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAA;AACjF,CAAC,CAAA"}

package/dist/FlowCatalog.d.ts

@@ -0,0 +1,37 @@
+import * as Effect from "effect/Effect";
+import { FileSystem } from "effect/FileSystem";
+export type FlowTier = "project" | "global" | "builtin";
+export interface FlowTierPaths {
+    readonly project?: string;
+    readonly global?: string;
+    readonly builtin?: string;
+}
+export interface DiscoveredFlow {
+    readonly name: string;
+    readonly path: string;
+    readonly tier: FlowTier;
+    readonly description?: string;
+    readonly shadows: ReadonlyArray<FlowTier>;
+}
+/**
+ * The first non-empty `//` comment line within the file's leading block of
+ * blank lines and `//` comments is the flow's one-line description. A bare or
+ * whitespace-only `//` line is skipped, never returned as an empty
+ * description; the scan stops at the first line that is neither blank nor a
+ * `//` comment.
+ */
+export declare const parseFlowDescription: (source: string) => string | undefined;
+export declare const defaultTierPaths: (options: {
+    readonly cwd: string;
+    readonly homeDir: string;
+    readonly environment?: Readonly<Record<string, string | undefined>>;
+    readonly builtinDir?: string;
+}) => FlowTierPaths;
+/**
+ * Discovers flows across the project, global, and built-in tiers. Precedence
+ * is project > global > builtin, keyed by flow name; a shadowed tier is
+ * recorded on the winning flow's `shadows` list. Missing or unreadable
+ * directories contribute nothing.
+ */
+export declare const discoverFlows: (tiers: FlowTierPaths) => Effect.Effect<DiscoveredFlow[], never, FileSystem>;
+//# sourceMappingURL=FlowCatalog.d.ts.map

package/dist/FlowCatalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FlowCatalog.d.ts","sourceRoot":"","sources":["../src/FlowCatalog.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAE9C,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAA;AAEvD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAA;CAC1C;AAED;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAAI,QAAQ,MAAM,KAAG,MAAM,GAAG,SAe9D,CAAA;AAED,eAAO,MAAM,gBAAgB,GAAI,SAAS;IACxC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAA;IACnE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAC7B,KAAG,aAWH,CAAA;AA4BD;;;;;GAKG;AACH,eAAO,MAAM,aAAa,8EAwBxB,CAAA"}

package/dist/FlowCatalog.js

@@ -0,0 +1,86 @@
+import { join } from "node:path";
+import * as Effect from "effect/Effect";
+import { FileSystem } from "effect/FileSystem";
+/**
+ * The first non-empty `//` comment line within the file's leading block of
+ * blank lines and `//` comments is the flow's one-line description. A bare or
+ * whitespace-only `//` line is skipped, never returned as an empty
+ * description; the scan stops at the first line that is neither blank nor a
+ * `//` comment.
+ */
+export const parseFlowDescription = (source) => {
+    for (const line of source.split("\n")) {
+        const trimmed = line.trim();
+        if (trimmed.length === 0) {
+            continue;
+        }
+        if (!trimmed.startsWith("//")) {
+            return undefined;
+        }
+        const text = trimmed.slice(2).trim();
+        if (text.length > 0) {
+            return text;
+        }
+    }
+    return undefined;
+};
+export const defaultTierPaths = (options) => {
+    const environment = options.environment ?? process.env;
+    const configHome = environment.XDG_CONFIG_HOME !== undefined && environment.XDG_CONFIG_HOME.length > 0
+        ? environment.XDG_CONFIG_HOME
+        : join(options.homeDir, ".config");
+    return {
+        project: join(options.cwd, ".llm4ts", "flows"),
+        global: join(configHome, "llm4ts", "flows"),
+        ...(options.builtinDir === undefined ? {} : { builtin: options.builtinDir })
+    };
+};
+const tierOrder = ["project", "global", "builtin"];
+const listTier = Effect.fn("@llm4ts/shell/FlowCatalog.listTier")(function* (tier, directory) {
+    const fs = yield* FileSystem;
+    const entries = yield* fs.readDirectory(directory).pipe(Effect.orElseSucceed(() => []));
+    const flows = [];
+    for (const entry of [...entries].sort()) {
+        if (!entry.endsWith(".ts")) {
+            continue;
+        }
+        const path = join(directory, entry);
+        const source = yield* fs.readFileString(path).pipe(Effect.orElseSucceed(() => ""));
+        const description = parseFlowDescription(source);
+        flows.push({
+            name: entry.slice(0, -".ts".length),
+            path,
+            tier,
+            ...(description === undefined ? {} : { description })
+        });
+    }
+    return flows;
+});
+/**
+ * Discovers flows across the project, global, and built-in tiers. Precedence
+ * is project > global > builtin, keyed by flow name; a shadowed tier is
+ * recorded on the winning flow's `shadows` list. Missing or unreadable
+ * directories contribute nothing.
+ */
+export const discoverFlows = Effect.fn("@llm4ts/shell/FlowCatalog.discoverFlows")(function* (tiers) {
+    const byName = new Map();
+    for (const tier of tierOrder) {
+        const directory = tiers[tier];
+        if (directory === undefined) {
+            continue;
+        }
+        for (const flow of yield* listTier(tier, directory)) {
+            const existing = byName.get(flow.name);
+            if (existing === undefined) {
+                byName.set(flow.name, { flow, shadows: [] });
+            }
+            else {
+                existing.shadows.push(tier);
+            }
+        }
+    }
+    return [...byName.values()]
+        .map(({ flow, shadows }) => ({ ...flow, shadows }))
+        .sort((left, right) => left.name.localeCompare(right.name));
+});
+//# sourceMappingURL=FlowCatalog.js.map

package/dist/FlowCatalog.js.map

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

package/dist/FlowLaunch.d.ts

@@ -0,0 +1,36 @@
+import * as Effect from "effect/Effect";
+import * as Schema from "effect/Schema";
+declare const FlowLaunchError_base: Schema.Class<FlowLaunchError, Schema.TaggedStruct<"FlowLaunch", {
+    readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+export declare class FlowLaunchError extends FlowLaunchError_base {
+}
+/**
+ * True when the flow script cannot resolve `@llm4ts/runner` from its own
+ * location — a global flow, a built-in copy, or a bare repository. Project
+ * flows inside a repository that installs `@llm4ts/*` resolve their own pin
+ * and need no help (the project-wins policy of ADR 0006). Implemented as the
+ * same `node_modules` directory walk ESM resolution performs, so the check
+ * stays honest under test runners that patch the module system.
+ */
+export declare const needsResolveFallback: (flowPath: string) => boolean;
+export interface LaunchFlowOptions {
+    readonly flowPath: string;
+    readonly taskArgs: ReadonlyArray<string>;
+    readonly environment?: Readonly<Record<string, string | undefined>>;
+    readonly cwd?: string;
+    /** Overrides `LLM4TS_CODER` in the child for this run only. */
+    readonly coder?: string;
+    /** `inherit` shares the terminal (the default); tests use `ignore`. */
+    readonly stdio?: "inherit" | "ignore";
+}
+/**
+ * Runs a flow script as a child `node` process with type stripping, the
+ * terminal inherited, and the task text appended to argv. While the child
+ * runs, SIGINT is ignored in the parent so Ctrl-C reaches the whole
+ * foreground process group and the shell survives to resume. Resolves with
+ * the child's exit code (`128 + signal` when terminated by a signal).
+ */
+export declare const launchFlow: (options: LaunchFlowOptions) => Effect.Effect<number, FlowLaunchError>;
+export {};
+//# sourceMappingURL=FlowLaunch.d.ts.map

package/dist/FlowLaunch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FlowLaunch.d.ts","sourceRoot":"","sources":["../src/FlowLaunch.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;;;;AAEvC,qBAAa,eAAgB,SAAQ,oBAEnC;CAAG;AAEL;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,GAAI,UAAU,MAAM,KAAG,OAYvD,CAAA;AAYD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IACxC,QAAQ,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAA;IACnE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;IACrB,+DAA+D;IAC/D,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,uEAAuE;IACvE,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAA;CACtC;AAED;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,GAAI,SAAS,iBAAiB,KAAG,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAoCzF,CAAA"}

package/dist/FlowLaunch.js

@@ -0,0 +1,86 @@
+import { spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+import { constants } from "node:os";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import * as Effect from "effect/Effect";
+import * as Schema from "effect/Schema";
+export class FlowLaunchError extends Schema.TaggedErrorClass()("FlowLaunch", {
+    message: Schema.String
+}) {
+}
+/**
+ * True when the flow script cannot resolve `@llm4ts/runner` from its own
+ * location — a global flow, a built-in copy, or a bare repository. Project
+ * flows inside a repository that installs `@llm4ts/*` resolve their own pin
+ * and need no help (the project-wins policy of ADR 0006). Implemented as the
+ * same `node_modules` directory walk ESM resolution performs, so the check
+ * stays honest under test runners that patch the module system.
+ */
+export const needsResolveFallback = (flowPath) => {
+    let directory = dirname(resolve(flowPath));
+    while (true) {
+        if (existsSync(join(directory, "node_modules", "@llm4ts", "runner", "package.json"))) {
+            return false;
+        }
+        const parent = dirname(directory);
+        if (parent === directory) {
+            return true;
+        }
+        directory = parent;
+    }
+};
+// In the published package the hook is the compiled sibling; when running
+// from src (tests), it is the TypeScript source, which the child can load
+// because it always runs with type stripping enabled.
+const resolveFallbackUrl = (() => {
+    const compiled = new URL("./ResolveFallback.js", import.meta.url);
+    return existsSync(fileURLToPath(compiled))
+        ? compiled.href
+        : new URL("./ResolveFallback.ts", import.meta.url).href;
+})();
+/**
+ * Runs a flow script as a child `node` process with type stripping, the
+ * terminal inherited, and the task text appended to argv. While the child
+ * runs, SIGINT is ignored in the parent so Ctrl-C reaches the whole
+ * foreground process group and the shell survives to resume. Resolves with
+ * the child's exit code (`128 + signal` when terminated by a signal).
+ */
+export const launchFlow = (options) => Effect.callback((resume) => {
+    const environment = { ...(options.environment ?? process.env) };
+    if (options.coder !== undefined) {
+        environment.LLM4TS_CODER = options.coder;
+    }
+    const nodeArgs = ["--experimental-strip-types"];
+    if (needsResolveFallback(options.flowPath)) {
+        nodeArgs.push("--import", resolveFallbackUrl);
+    }
+    const child = spawn(process.execPath, [...nodeArgs, options.flowPath, ...options.taskArgs], {
+        stdio: options.stdio ?? "inherit",
+        env: environment,
+        ...(options.cwd === undefined ? {} : { cwd: options.cwd })
+    });
+    const ignoreSigint = () => { };
+    process.on("SIGINT", ignoreSigint);
+    const restoreSigint = () => {
+        process.removeListener("SIGINT", ignoreSigint);
+    };
+    child.on("error", (error) => {
+        restoreSigint();
+        resume(Effect.fail(new FlowLaunchError({ message: error.message })));
+    });
+    child.on("exit", (code, signal) => {
+        restoreSigint();
+        if (signal !== null) {
+            resume(Effect.succeed(128 + (constants.signals[signal] ?? 15)));
+        }
+        else {
+            resume(Effect.succeed(code ?? 1));
+        }
+    });
+    return Effect.sync(() => {
+        restoreSigint();
+        child.kill("SIGINT");
+    });
+});
+//# sourceMappingURL=FlowLaunch.js.map

package/dist/FlowLaunch.js.map

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

package/dist/Menu.d.ts

@@ -0,0 +1,9 @@
+import * as Effect from "effect/Effect";
+import * as Prompt from "effect/unstable/cli/Prompt";
+import { type FlowTierPaths } from "./FlowCatalog.ts";
+/**
+ * The interactive main menu: run a flow, view a flow, exit. Ctrl-C inside a
+ * prompt quits the menu cleanly rather than crashing the shell.
+ */
+export declare const mainMenu: (tiers: FlowTierPaths) => Effect.Effect<void, import("./FlowLaunch.ts").FlowLaunchError, Prompt.Environment>;
+//# sourceMappingURL=Menu.d.ts.map

package/dist/Menu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Menu.d.ts","sourceRoot":"","sources":["../src/Menu.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC,OAAO,KAAK,MAAM,MAAM,4BAA4B,CAAA;AAEpD,OAAO,EAAsC,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAuFzF;;;GAGG;AACH,eAAO,MAAM,QAAQ,8GA0BnB,CAAA"}