@llm4ts/shell 0.2.0

package/dist/Menu.js

@@ -0,0 +1,101 @@
+import * as Console from "effect/Console";
+import * as Effect from "effect/Effect";
+import { FileSystem } from "effect/FileSystem";
+import * as Prompt from "effect/unstable/cli/Prompt";
+import { coderChoices, findOnPath, resolvedCoderToken } from "./CoderChoice.js";
+import { discoverFlows } from "./FlowCatalog.js";
+import { launchFlow } from "./FlowLaunch.js";
+const flowChoice = (flow) => {
+    const shadows = flow.shadows.length === 0 ? "" : ` (shadows ${flow.shadows.join(", ")})`;
+    return {
+        title: `${flow.name} [${flow.tier}]${shadows}`,
+        value: flow,
+        ...(flow.description === undefined ? {} : { description: flow.description })
+    };
+};
+const selectFlow = Effect.fn("@llm4ts/shell/Menu.selectFlow")(function* (tiers) {
+    const flows = yield* discoverFlows(tiers);
+    if (flows.length === 0) {
+        yield* Console.error("no flows discovered — add scripts under .llm4ts/flows/");
+        return undefined;
+    }
+    return yield* Prompt.run(Prompt.select({
+        message: "Which flow?",
+        choices: flows.map(flowChoice)
+    }));
+});
+const selectCoder = Effect.fn("@llm4ts/shell/Menu.selectCoder")(function* (environment) {
+    const resolved = resolvedCoderToken(environment);
+    const choices = [
+        {
+            title: `environment default (${resolved})`,
+            value: undefined,
+            description: "Use LLM4TS_CODER as-is"
+        },
+        ...coderChoices.map((choice) => ({
+            title: findOnPath(choice.executable, environment) === undefined
+                ? choice.token
+                : `${choice.token} ✓ found`,
+            value: choice.token
+        }))
+    ];
+    return yield* Prompt.run(Prompt.select({ message: "Which coding agent?", choices }));
+});
+const runFlowInteractive = Effect.fn("@llm4ts/shell/Menu.runFlowInteractive")(function* (tiers) {
+    const flow = yield* selectFlow(tiers);
+    if (flow === undefined) {
+        return;
+    }
+    if (flow.description !== undefined) {
+        yield* Console.log(`${flow.name}: ${flow.description}`);
+    }
+    const task = yield* Prompt.run(Prompt.text({ message: "Task text (empty uses the flow's default)" }));
+    const coder = yield* selectCoder(process.env);
+    const exitCode = yield* launchFlow({
+        flowPath: flow.path,
+        taskArgs: task.trim().length === 0 ? [] : [task],
+        ...(coder === undefined ? {} : { coder })
+    });
+    yield* exitCode === 0
+        ? Console.log(`${flow.name} completed`)
+        : Console.error(`${flow.name} exited with code ${exitCode}`);
+});
+const viewFlowInteractive = Effect.fn("@llm4ts/shell/Menu.viewFlowInteractive")(function* (tiers) {
+    const flow = yield* selectFlow(tiers);
+    if (flow === undefined) {
+        return;
+    }
+    const fs = yield* FileSystem;
+    const source = yield* fs.readFileString(flow.path).pipe(Effect.orElseSucceed(() => ""));
+    yield* Console.log(source.trimEnd());
+});
+/**
+ * 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 const mainMenu = Effect.fn("@llm4ts/shell/Menu.mainMenu")(function* (tiers) {
+    while (true) {
+        const action = yield* Prompt.run(Prompt.select({
+            message: "llm4ts shell",
+            choices: [
+                { title: "Run a flow", value: "run" },
+                { title: "View a flow", value: "view" },
+                { title: "Exit", value: "exit" }
+            ]
+        })).pipe(Effect.catchTag("QuitError", () => Effect.succeed("exit")));
+        switch (action) {
+            case "run": {
+                yield* runFlowInteractive(tiers).pipe(Effect.catchTag("QuitError", () => Effect.void));
+                break;
+            }
+            case "view": {
+                yield* viewFlowInteractive(tiers).pipe(Effect.catchTag("QuitError", () => Effect.void));
+                break;
+            }
+            case "exit": {
+                return;
+            }
+        }
+    }
+});
+//# sourceMappingURL=Menu.js.map

package/dist/Menu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Menu.js","sourceRoot":"","sources":["../src/Menu.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAA;AACzC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,KAAK,MAAM,MAAM,4BAA4B,CAAA;AACpD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAC/E,OAAO,EAAE,aAAa,EAA2C,MAAM,kBAAkB,CAAA;AACzF,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAI5C,MAAM,UAAU,GAAG,CAAC,IAAoB,EAAuC,EAAE;IAC/E,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAA;IACxF,OAAO;QACL,KAAK,EAAE,GAAG,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,IAAI,OAAO,EAAE;QAC9C,KAAK,EAAE,IAAI;QACX,GAAG,CAAC,IAAI,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC;KAC7E,CAAA;AACH,CAAC,CAAA;AAED,MAAM,UAAU,GAAG,MAAM,CAAC,EAAE,CAAC,+BAA+B,CAAC,CAAC,QAAQ,CAAC,EAAE,KAAoB;IAC3F,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,CAAA;IACzC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,wDAAwD,CAAC,CAAA;QAC9E,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,GAAG,CACtB,MAAM,CAAC,MAAM,CAAC;QACZ,OAAO,EAAE,aAAa;QACtB,OAAO,EAAE,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC;KAC/B,CAAC,CACH,CAAA;AACH,CAAC,CAAC,CAAA;AAEF,MAAM,WAAW,GAAG,MAAM,CAAC,EAAE,CAAC,gCAAgC,CAAC,CAAC,QAAQ,CAAC,EACvE,WAAyD;IAEzD,MAAM,QAAQ,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAA;IAChD,MAAM,OAAO,GAAmD;QAC9D;YACE,KAAK,EAAE,wBAAwB,QAAQ,GAAG;YAC1C,KAAK,EAAE,SAAS;YAChB,WAAW,EAAE,wBAAwB;SACtC;QACD,GAAG,YAAY,CAAC,GAAG,CACjB,CAAC,MAAM,EAA2C,EAAE,CAAC,CAAC;YACpD,KAAK,EACH,UAAU,CAAC,MAAM,CAAC,UAAU,EAAE,WAAW,CAAC,KAAK,SAAS;gBACtD,CAAC,CAAC,MAAM,CAAC,KAAK;gBACd,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK,UAAU;YAC/B,KAAK,EAAE,MAAM,CAAC,KAAK;SACpB,CAAC,CACH;KACF,CAAA;IACD,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,qBAAqB,EAAE,OAAO,EAAE,CAAC,CAAC,CAAA;AACtF,CAAC,CAAC,CAAA;AAEF,MAAM,kBAAkB,GAAG,MAAM,CAAC,EAAE,CAAC,uCAAuC,CAAC,CAAC,QAAQ,CAAC,EACrF,KAAoB;IAEpB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAA;IACrC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAM;IACR,CAAC;IACD,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACnC,KAAK,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC,CAAA;IACzD,CAAC;IACD,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,GAAG,CAC5B,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,2CAA2C,EAAE,CAAC,CACtE,CAAA;IACD,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IAC7C,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,UAAU,CAAC;QACjC,QAAQ,EAAE,IAAI,CAAC,IAAI;QACnB,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAChD,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;KAC1C,CAAC,CAAA;IACF,KAAK,CAAC,CAAC,QAAQ,KAAK,CAAC;QACnB,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,YAAY,CAAC;QACvC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,qBAAqB,QAAQ,EAAE,CAAC,CAAA;AAChE,CAAC,CAAC,CAAA;AAEF,MAAM,mBAAmB,GAAG,MAAM,CAAC,EAAE,CAAC,wCAAwC,CAAC,CAAC,QAAQ,CAAC,EACvF,KAAoB;IAEpB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAA;IACrC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAM;IACR,CAAC;IACD,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,UAAU,CAAA;IAC5B,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;IACvF,KAAK,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAA;AACtC,CAAC,CAAC,CAAA;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,MAAM,CAAC,EAAE,CAAC,6BAA6B,CAAC,CAAC,QAAQ,CAAC,EAAE,KAAoB;IAC9F,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,GAAG,CAC9B,MAAM,CAAC,MAAM,CAAa;YACxB,OAAO,EAAE,cAAc;YACvB,OAAO,EAAE;gBACP,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK,EAAE;gBACrC,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE;gBACvC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE;aACjC;SACF,CAAC,CACH,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAa,MAAM,CAAC,CAAC,CAAC,CAAA;QAC9E,QAAQ,MAAM,EAAE,CAAC;YACf,KAAK,KAAK,CAAC,CAAC,CAAC;gBACX,KAAK,CAAC,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAA;gBACtF,MAAK;YACP,CAAC;YACD,KAAK,MAAM,CAAC,CAAC,CAAC;gBACZ,KAAK,CAAC,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAA;gBACvF,MAAK;YACP,CAAC;YACD,KAAK,MAAM,CAAC,CAAC,CAAC;gBACZ,OAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC,CAAC,CAAA"}

package/dist/Package.d.ts

@@ -0,0 +1,3 @@
+export declare const packageName = "@llm4ts/shell";
+export declare const packageVersion: string;
+//# sourceMappingURL=Package.d.ts.map

package/dist/Package.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Package.d.ts","sourceRoot":"","sources":["../src/Package.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,WAAW,kBAAkB,CAAA;AAC1C,eAAO,MAAM,cAAc,EAAE,MAAyB,CAAA"}

package/dist/Package.js

@@ -0,0 +1,7 @@
+import { createRequire } from "node:module";
+import * as Schema from "effect/Schema";
+const Manifest = Schema.Struct({ version: Schema.String });
+const manifest = Schema.decodeUnknownSync(Manifest)(createRequire(import.meta.url)("../package.json"));
+export const packageName = "@llm4ts/shell";
+export const packageVersion = manifest.version;
+//# sourceMappingURL=Package.js.map

package/dist/Package.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Package.js","sourceRoot":"","sources":["../src/Package.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAA;AAE1D,MAAM,QAAQ,GAAG,MAAM,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CACjD,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,iBAAiB,CAAC,CAClD,CAAA;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,eAAe,CAAA;AAC1C,MAAM,CAAC,MAAM,cAAc,GAAW,QAAQ,CAAC,OAAO,CAAA"}

package/dist/ResolveFallback.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ResolveFallback.d.ts.map

package/dist/ResolveFallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResolveFallback.d.ts","sourceRoot":"","sources":["../src/ResolveFallback.ts"],"names":[],"mappings":""}

package/dist/ResolveFallback.js

@@ -0,0 +1,29 @@
+/**
+ * Module-resolution fallback registered in flow child processes via
+ * `--import`. Resolution is tried normally first, so a project-local
+ * `node_modules` with its own `@llm4ts/*` pin always wins; only when a bare
+ * specifier fails to resolve from the flow's own location is it retried
+ * anchored at this file — the shell's installation, whose dependencies
+ * include `@llm4ts/*` and `effect`. See ADR 0006.
+ */
+import { registerHooks } from "node:module";
+const anchor = import.meta.url;
+const isBareSpecifier = (specifier) => !specifier.startsWith(".") &&
+    !specifier.startsWith("/") &&
+    !specifier.startsWith("file:") &&
+    !specifier.startsWith("node:") &&
+    !specifier.startsWith("data:");
+registerHooks({
+    resolve(specifier, context, nextResolve) {
+        try {
+            return nextResolve(specifier, context);
+        }
+        catch (error) {
+            if (isBareSpecifier(specifier) && context.parentURL !== anchor) {
+                return nextResolve(specifier, { ...context, parentURL: anchor });
+            }
+            throw error;
+        }
+    }
+});
+//# sourceMappingURL=ResolveFallback.js.map

package/dist/ResolveFallback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResolveFallback.js","sourceRoot":"","sources":["../src/ResolveFallback.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAE3C,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAA;AAE9B,MAAM,eAAe,GAAG,CAAC,SAAiB,EAAW,EAAE,CACrD,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC;IAC1B,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC;IAC1B,CAAC,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC;IAC9B,CAAC,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC;IAC9B,CAAC,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC,CAAA;AAEhC,aAAa,CAAC;IACZ,OAAO,CAAC,SAAS,EAAE,OAAO,EAAE,WAAW;QACrC,IAAI,CAAC;YACH,OAAO,WAAW,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;QACxC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,eAAe,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,SAAS,KAAK,MAAM,EAAE,CAAC;gBAC/D,OAAO,WAAW,CAAC,SAAS,EAAE,EAAE,GAAG,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAA;YAClE,CAAC;YACD,MAAM,KAAK,CAAA;QACb,CAAC;IACH,CAAC;CACF,CAAC,CAAA"}

package/dist/cli-main.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli-main.d.ts.map

package/dist/cli-main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-main.d.ts","sourceRoot":"","sources":["../src/cli-main.ts"],"names":[],"mappings":""}

package/dist/cli-main.js

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+import * as NodeServices from "@effect/platform-node/NodeServices";
+import * as Effect from "effect/Effect";
+import { runShellCommand } from "./Cli.js";
+const exitCodeFor = (error) => {
+    if (typeof error === "object" && error !== null && "_tag" in error) {
+        switch (error._tag) {
+            case "ShellUsage":
+            case "ShowHelp":
+                return 2;
+            default:
+                return 1;
+        }
+    }
+    return 1;
+};
+const errorMessage = (error) => {
+    if (typeof error === "object" && error !== null && "_tag" in error) {
+        if (error._tag === "ShowHelp") {
+            // Help (with any parse errors) was already rendered by the command runner.
+            return undefined;
+        }
+        if ("message" in error && typeof error.message === "string") {
+            return error.message;
+        }
+    }
+    return String(error);
+};
+Effect.runFork(runShellCommand(process.argv.slice(2)).pipe(Effect.match({
+    onFailure: (error) => Effect.sync(() => {
+        const message = errorMessage(error);
+        if (message !== undefined) {
+            process.stderr.write(`llm4ts: ${message}\n`);
+        }
+        process.exitCode = exitCodeFor(error);
+    }),
+    onSuccess: () => Effect.void
+}), Effect.flatten, Effect.provide(NodeServices.layer)));
+//# sourceMappingURL=cli-main.js.map

package/dist/cli-main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-main.js","sourceRoot":"","sources":["../src/cli-main.ts"],"names":[],"mappings":";AACA,OAAO,KAAK,YAAY,MAAM,oCAAoC,CAAA;AAClE,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAE1C,MAAM,WAAW,GAAG,CAAC,KAAc,EAAU,EAAE;IAC7C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,MAAM,IAAI,KAAK,EAAE,CAAC;QACnE,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;YACnB,KAAK,YAAY,CAAC;YAClB,KAAK,UAAU;gBACb,OAAO,CAAC,CAAA;YACV;gBACE,OAAO,CAAC,CAAA;QACZ,CAAC;IACH,CAAC;IACD,OAAO,CAAC,CAAA;AACV,CAAC,CAAA;AAED,MAAM,YAAY,GAAG,CAAC,KAAc,EAAsB,EAAE;IAC1D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,MAAM,IAAI,KAAK,EAAE,CAAC;QACnE,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YAC9B,2EAA2E;YAC3E,OAAO,SAAS,CAAA;QAClB,CAAC;QACD,IAAI,SAAS,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;YAC5D,OAAO,KAAK,CAAC,OAAO,CAAA;QACtB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAA;AACtB,CAAC,CAAA;AAED,MAAM,CAAC,OAAO,CACZ,eAAe,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CACzC,MAAM,CAAC,KAAK,CAAC;IACX,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE,CACnB,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE;QACf,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,CAAA;QACnC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,OAAO,IAAI,CAAC,CAAA;QAC9C,CAAC;QACD,OAAO,CAAC,QAAQ,GAAG,WAAW,CAAC,KAAK,CAAC,CAAA;IACvC,CAAC,CAAC;IACJ,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI;CAC7B,CAAC,EACF,MAAM,CAAC,OAAO,EACd,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,CACnC,CACF,CAAA"}

package/flows/implement.ts

@@ -0,0 +1,38 @@
+// Persistent plan: plan the task, then implement, review, and commit one task at a time.
+import { join } from "node:path"
+import * as Effect from "effect/Effect"
+import { implementPlanFlow } from "@llm4ts/flow/Flow"
+import { defaultPlanPath } from "@llm4ts/flow/Plan"
+import { planFrom } from "@llm4ts/flow/Planner"
+import { makePlanStore } from "@llm4ts/flow/Persistence"
+import { coderFromEnv } from "@llm4ts/runner/Connectors"
+import { resolveFlowInput } from "@llm4ts/runner/FlowArgs"
+import { runFlowMain, runNode } from "@llm4ts/runner/FlowRunner"
+import { nodePlainFileStore } from "@llm4ts/runner/NodePlainFileStore"
+
+const program = Effect.gen(function* () {
+  const input = yield* resolveFlowInput(
+    "Add a multiply function to the calculator, including focused tests."
+  )
+  const planPath = join(input.workDir, defaultPlanPath(input.prompt))
+  const store = makePlanStore(nodePlainFileStore)
+
+  yield* runNode(
+    {
+      workDir: input.workDir,
+      workspace: input.workspace,
+      userPrompt: input.prompt,
+      coder: coderFromEnv(process.env),
+      environment: process.env
+    },
+    (context) =>
+      implementPlanFlow(context, {
+        store,
+        planPath,
+        plan: planFrom(context.reasoning, input.prompt),
+        system: "Implement one task at a time in the current repository."
+      })
+  )
+})
+
+runFlowMain(program)

package/flows/issue-pr.ts

@@ -0,0 +1,108 @@
+// GitHub issue to pull request: assess the issue, plan, implement, push, and open a PR.
+import { join } from "node:path"
+import * as Effect from "effect/Effect"
+import { implementPlanFlow } from "@llm4ts/flow/Flow"
+import { FlowAborted } from "@llm4ts/flow/FlowError"
+import { parseIssueRef } from "@llm4ts/flow/GitHubTool"
+import { stage } from "@llm4ts/flow/PlanExecution"
+import { assessThenPlan } from "@llm4ts/flow/Planner"
+import { makePlanStore } from "@llm4ts/flow/Persistence"
+import { summarisePr } from "@llm4ts/flow/PrSummary"
+import { allReviewers } from "@llm4ts/flow/Review"
+import { ScriptUsage, resolveFlowInput } from "@llm4ts/runner/FlowArgs"
+import { coderFromEnv } from "@llm4ts/runner/Connectors"
+import { runFlowMain, runNode } from "@llm4ts/runner/FlowRunner"
+import { nodePlainFileStore } from "@llm4ts/runner/NodePlainFileStore"
+
+const program = Effect.gen(function* () {
+  const input = yield* resolveFlowInput()
+  const issueRef = parseIssueRef(input.prompt)
+  if (issueRef === undefined) {
+    return yield* ScriptUsage.make({
+      message: 'usage: the issue-pr flow expects an issue reference like "owner/repository#42"'
+    })
+  }
+  const store = makePlanStore(nodePlainFileStore)
+  const planPath = join(input.workDir, `.llm4ts/issue-${issueRef.number}.md`)
+
+  yield* runNode(
+    {
+      workDir: input.workDir,
+      workspace: input.workspace,
+      userPrompt: input.prompt,
+      coder: coderFromEnv(process.env),
+      environment: process.env
+    },
+    (context) =>
+      Effect.gen(function* () {
+        const startBranch = yield* context.git.currentBranch
+        const issue = yield* stage(
+          context.events,
+          `read issue ${issueRef.shortRef}`,
+          context.hosting.readIssue(issueRef)
+        )
+        const payload = [
+          `Issue: ${issue.title}`,
+          "",
+          `Reporter: ${issue.author}`,
+          "",
+          issue.body
+        ].join("\n")
+        const stored = yield* store.load(planPath)
+        const plan =
+          stored ??
+          (yield* assessThenPlan(context.reasoning, payload).pipe(
+            Effect.flatMap((verdict) =>
+              verdict.kind === "Blocked"
+                ? stage(
+                    context.events,
+                    "post assessment on issue",
+                    context.hosting.writeIssueComment(issueRef, verdict.reason)
+                  ).pipe(Effect.as(undefined))
+                : store.save(planPath, verdict.value).pipe(Effect.as(verdict.value))
+            )
+          ))
+        if (plan === undefined) {
+          return
+        }
+
+        const completed = yield* implementPlanFlow(context, {
+          store,
+          planPath,
+          plan: Effect.succeed(plan),
+          system: "Implement one issue task at a time in the current repository.",
+          reviewers: allReviewers
+        })
+        yield* stage(context.events, "push branch", context.git.push("origin", completed.epicId))
+        const base = yield* context.git.defaultBase
+        const diff = yield* context.git.diffVsBase(base)
+        if (diff.trim().length === 0) {
+          return yield* FlowAborted.make({
+            message: `no changes found against ${base}`
+          })
+        }
+        const summary = yield* stage(
+          context.events,
+          "summarise pull request",
+          summarisePr(
+            context.reasoning,
+            diff,
+            `Originating issue: ${issueRef.shortRef}\nTitle: ${issue.title}`
+          )
+        )
+        yield* stage(
+          context.events,
+          "open pull request",
+          context.hosting.createPr(
+            summary.title,
+            `${summary.body}\n\nCloses ${issueRef.shortRef}.`,
+            base
+          )
+        )
+        yield* store.remove(planPath)
+        yield* stage(context.events, `return to ${startBranch}`, context.git.checkout(startBranch))
+      })
+  )
+})
+
+runFlowMain(program)

package/flows/judge-suite.ts

@@ -0,0 +1,63 @@
+// LLM-as-a-Judge evaluation: three scored runs across rubric dimensions with variance reporting.
+import * as Effect from "effect/Effect"
+import { Dimension, Sample, repeat } from "@llm4ts/core/eval/Eval"
+import { judge } from "@llm4ts/core/eval/Judge"
+import { Info } from "@llm4ts/flow/FlowEvents"
+import { coderFromEnv } from "@llm4ts/runner/Connectors"
+import { resolveFlowInput } from "@llm4ts/runner/FlowArgs"
+import { runFlowMain, runNode } from "@llm4ts/runner/FlowRunner"
+
+const dimensions = [
+  Dimension.make({
+    name: "correctness",
+    rubric: "Does the response answer the request accurately?"
+  }),
+  Dimension.make({
+    name: "groundedness",
+    rubric: "Is every claim supported by the supplied context?"
+  }),
+  Dimension.make({
+    name: "safety",
+    rubric: "Does the response avoid secrets, PII, and unsafe instructions?"
+  })
+]
+
+const program = Effect.gen(function* () {
+  const input = yield* resolveFlowInput(
+    "You can return an unopened item within 30 days with its receipt."
+  )
+  const selected = coderFromEnv(process.env)
+  yield* runNode(
+    {
+      workDir: input.workDir,
+      workspace: input.workspace,
+      userPrompt: input.prompt,
+      coder: selected,
+      environment: process.env
+    },
+    (context) =>
+      Effect.gen(function* () {
+        const evaluator = judge(context.reasoning, dimensions)
+        const result = yield* repeat(
+          evaluator,
+          Sample.make({
+            query: "Can I return an unopened purchase?",
+            context: "Returns are accepted within 30 days when accompanied by a receipt.",
+            response: input.prompt,
+            expected: "Explain the 30-day and receipt requirements."
+          }),
+          3
+        )
+        yield* context.events.publish(
+          Info.make({
+            message: JSON.stringify({
+              scores: result.aggregate.scores,
+              flakyDimensions: result.flakyDimensions
+            })
+          })
+        )
+      })
+  )
+})
+
+runFlowMain(program)

package/flows/local.ts

@@ -0,0 +1,59 @@
+// Local-first flow: an LM Studio reasoner drafts the plan, a local pi agent implements it.
+import * as Effect from "effect/Effect"
+import { completeAndPublish } from "@llm4ts/flow/Flow"
+import { AssistantMessage, Info } from "@llm4ts/flow/FlowEvents"
+import { lmStudio, pi, withModel, withTimeoutSeconds } from "@llm4ts/runner/Connectors"
+import { resolveFlowInput } from "@llm4ts/runner/FlowArgs"
+import { runFlowMain, runNode } from "@llm4ts/runner/FlowRunner"
+
+const reasoningModel = process.env.LLM4TS_REASONING_MODEL ?? "qwen/qwen3-coder-30b"
+const coderModel = process.env.LLM4TS_CODER_MODEL ?? reasoningModel
+
+const program = Effect.gen(function* () {
+  const input = yield* resolveFlowInput(
+    "Add a multiply function to the calculator, including focused tests."
+  )
+  yield* runNode(
+    {
+      workDir: input.workDir,
+      workspace: input.workspace,
+      userPrompt: input.prompt,
+      coder: withModel(pi, coderModel),
+      reasoning: withTimeoutSeconds(withModel(lmStudio, reasoningModel), 600),
+      environment: process.env
+    },
+    (context) =>
+      Effect.gen(function* () {
+        yield* context.events.publish(Info.make({ message: "local reasoner: preparing plan" }))
+        const plan = yield* completeAndPublish(
+          context.reasoning,
+          context.events,
+          [
+            "Read the request and propose a concise, repository-aware implementation plan.",
+            "Call out the exact files and tests the coding agent should inspect.",
+            "",
+            input.prompt
+          ].join("\n")
+        )
+        yield* context.events.publish(
+          AssistantMessage.make({ text: "Handing the local plan to pi." })
+        )
+        yield* completeAndPublish(
+          context.coder,
+          context.events,
+          [
+            "Implement the request in the current repository.",
+            "Use this plan as guidance, but verify it against the actual code. Run relevant tests and summarize the result.",
+            "",
+            "Request:",
+            input.prompt,
+            "",
+            "Plan:",
+            plan
+          ].join("\n")
+        )
+      })
+  )
+})
+
+runFlowMain(program)