@llm4ts/runner 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Riccardo Merolla
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,61 @@
+# @llm4ts/runner
+
+Node runner for [llm4ts](https://github.com/riccardomerolla/llm4ts): the
+`runNode` embedded entry point, connector presets, terminal rendering, the
+`llm4ts` CLI, and the MCP stdio server.
+
+## Install
+
+```bash
+npm install @llm4ts/runner @llm4ts/flow @llm4ts/core effect
+```
+
+Requires Node.js >= 22. `effect` is a peer dependency pinned to the Effect 4
+beta line.
+
+## Run a flow
+
+`runNode` provides every Node boundary (HTTP client, process executor,
+temporary files, file store, connector registry) with sensible defaults — you
+never assemble Effect layers yourself:
+
+```ts
+import { runNode } from "@llm4ts/runner/FlowRunner"
+import { ApiConnectorConfig } from "@llm4ts/core/ConnectorConfig"
+import { ConnectorIds } from "@llm4ts/core/Models"
+import { collect } from "@llm4ts/core/Streaming"
+
+const program = runNode(
+  {
+    workDir: process.cwd(),
+    workspace: process.cwd(),
+    userPrompt: "Draft a small implementation plan",
+    coder: ApiConnectorConfig.make({ connectorId: ConnectorIds.Mock })
+  },
+  (context) => collect(context.coder.executeStream(context.userPrompt))
+)
+```
+
+The mock connector needs no credentials. Swap in a real provider via
+`ApiConnectorConfig` (API keys are read from standard environment variables
+such as `ANTHROPIC_API_KEY`) or a CLI coding agent via `coderFromEnv`
+(`LLM4TS_CODER=claude|codex|gemini|...`).
+
+## CLI
+
+The package ships a `llm4ts` binary that streams one prompt to your configured
+coder and records a trace under `.llm4ts/`:
+
+```bash
+npx llm4ts "explain this repository" --repo .
+```
+
+## Documentation
+
+- [Repository and full documentation](https://github.com/riccardomerolla/llm4ts)
+- [Configuration guide](https://github.com/riccardomerolla/llm4ts/blob/main/docs/configuration.md)
+- [Runnable examples](https://github.com/riccardomerolla/llm4ts/tree/main/examples)
+
+## License
+
+MIT

package/dist/Cli.d.ts

@@ -0,0 +1,5 @@
+import * as Effect from "effect/Effect";
+import { type FlowError } from "@llm4ts/flow/FlowError";
+import { type ScriptUsage } from "./FlowArgs.ts";
+export declare const makeCliProgram: (argv: ReadonlyArray<string>, environment?: Readonly<Record<string, string | undefined>>, workspace?: string, defaultPrompt?: string) => Effect.Effect<void, ScriptUsage | FlowError>;
+//# 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":"AACA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,EAAgB,KAAK,SAAS,EAAE,MAAM,wBAAwB,CAAA;AAKrE,OAAO,EAAkD,KAAK,WAAW,EAAE,MAAM,eAAe,CAAA;AAIhG,eAAO,MAAM,cAAc,GACzB,MAAM,aAAa,CAAC,MAAM,CAAC,EAC3B,cAAa,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAe,EACvE,kBAAyB,EACzB,gBAAgB,MAAM,KACrB,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,SAAS,CAkC7C,CAAA"}

package/dist/Cli.js

@@ -0,0 +1,36 @@
+import { join } from "node:path";
+import * as Effect from "effect/Effect";
+import { FlowLlmError } from "@llm4ts/flow/FlowError";
+import { AssistantMessage } from "@llm4ts/flow/FlowEvents";
+import { collect } from "@llm4ts/core/Streaming";
+import { CliConnectorConfig } from "@llm4ts/core/ConnectorConfig";
+import { coderFromEnv } from "./Connectors.js";
+import { parseFlowArgs, readFlowPrompt, resolveFlowRepo } from "./FlowArgs.js";
+import { runNode } from "./FlowRunner.js";
+import { parseVerbosity } from "./Terminal.js";
+export const makeCliProgram = (argv, environment = process.env, workspace = process.cwd(), defaultPrompt) => {
+    const parsed = parseFlowArgs(argv);
+    if (!parsed.ok) {
+        return Effect.fail(parsed.error);
+    }
+    return Effect.gen(function* () {
+        const prompt = yield* readFlowPrompt(parsed.value, defaultPrompt);
+        const workDir = yield* resolveFlowRepo(parsed.value, workspace);
+        const selected = coderFromEnv(environment);
+        const coder = CliConnectorConfig.make({
+            ...selected,
+            workingDir: workDir
+        });
+        const timestamp = Date.now();
+        yield* runNode({
+            workDir,
+            workspace,
+            userPrompt: prompt,
+            coder,
+            verbosity: parseVerbosity(environment.LLM4TS_VERBOSITY),
+            tracePath: join(workDir, ".llm4ts", `trace-${timestamp}.jsonl`),
+            runId: timestamp.toString()
+        }, (context) => collect(context.coder.executeStream(prompt)).pipe(Effect.mapError(FlowLlmError.from), Effect.tap((response) => context.events.publish(AssistantMessage.make({ text: response.content }))), Effect.asVoid));
+    });
+};
+//# sourceMappingURL=Cli.js.map

package/dist/Cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Cli.js","sourceRoot":"","sources":["../src/Cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,EAAE,YAAY,EAAkB,MAAM,wBAAwB,CAAA;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAA;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAA;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,eAAe,EAAoB,MAAM,eAAe,CAAA;AAChG,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAE9C,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,IAA2B,EAC3B,cAA4D,OAAO,CAAC,GAAG,EACvE,SAAS,GAAG,OAAO,CAAC,GAAG,EAAE,EACzB,aAAsB,EACwB,EAAE;IAChD,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,CAAA;IAClC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IAClC,CAAC;IACD,OAAO,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QACzB,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,KAAK,EAAE,aAAa,CAAC,CAAA;QACjE,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,eAAe,CAAC,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,CAAA;QAC/D,MAAM,QAAQ,GAAG,YAAY,CAAC,WAAW,CAAC,CAAA;QAC1C,MAAM,KAAK,GAAG,kBAAkB,CAAC,IAAI,CAAC;YACpC,GAAG,QAAQ;YACX,UAAU,EAAE,OAAO;SACpB,CAAC,CAAA;QACF,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QAC5B,KAAK,CAAC,CAAC,OAAO,CACZ;YACE,OAAO;YACP,SAAS;YACT,UAAU,EAAE,MAAM;YAClB,KAAK;YACL,SAAS,EAAE,cAAc,CAAC,WAAW,CAAC,gBAAgB,CAAC;YACvD,SAAS,EAAE,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,SAAS,SAAS,QAAQ,CAAC;YAC/D,KAAK,EAAE,SAAS,CAAC,QAAQ,EAAE;SAC5B,EACD,CAAC,OAAO,EAAE,EAAE,CACV,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAC/C,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,EAClC,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CACtB,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,CAC1E,EACD,MAAM,CAAC,MAAM,CACd,CACJ,CAAA;IACH,CAAC,CAAC,CAAA;AACJ,CAAC,CAAA"}

package/dist/CoderPolicy.d.ts

@@ -0,0 +1,12 @@
+import * as Schema from "effect/Schema";
+import type { Grants } from "@llm4ts/core/Capability";
+import { CliConnectorConfig } from "@llm4ts/core/ConnectorConfig";
+declare const AppliedCoderPolicy_base: Schema.Class<AppliedCoderPolicy, Schema.Struct<{
+    readonly config: typeof CliConnectorConfig;
+    readonly unenforceable: Schema.$Array<Schema.String>;
+}>, {}>;
+export declare class AppliedCoderPolicy extends AppliedCoderPolicy_base {
+}
+export declare const applyCoderPolicy: (config: CliConnectorConfig, grants: Grants) => AppliedCoderPolicy;
+export {};
+//# sourceMappingURL=CoderPolicy.d.ts.map

package/dist/CoderPolicy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CoderPolicy.d.ts","sourceRoot":"","sources":["../src/CoderPolicy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAA;;;;;AAGjE,qBAAa,kBAAmB,SAAQ,uBAGtC;CAAG;AAgDL,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,kBAAkB,EAC1B,QAAQ,MAAM,KACb,kBAqBF,CAAA"}

package/dist/CoderPolicy.js

@@ -0,0 +1,59 @@
+import * as Schema from "effect/Schema";
+import { Capabilities, allows } from "@llm4ts/core/Capability";
+import { CliConnectorConfig } from "@llm4ts/core/ConnectorConfig";
+import { ConnectorIds } from "@llm4ts/core/Models";
+export class AppliedCoderPolicy extends Schema.Class("AppliedCoderPolicy")({
+    config: CliConnectorConfig,
+    unenforceable: Schema.Array(Schema.String)
+}) {
+}
+const patterns = [
+    {
+        capability: Capabilities.GitPush,
+        pattern: "Bash(git push:*)"
+    },
+    {
+        capability: Capabilities.GitWrite,
+        pattern: "Bash(git commit:*),Bash(git add:*),Bash(git checkout:*)"
+    },
+    {
+        capability: Capabilities.GhWrite,
+        pattern: "Bash(gh pr:*),Bash(gh issue:*),Bash(gh api:*)"
+    },
+    {
+        capability: Capabilities.AdoWrite,
+        pattern: "Bash(az repos:*),Bash(az boards:*)"
+    }
+];
+const capabilityName = (capability) => capability._tag === "Exec" ? `Exec(${capability.command})` : capability._tag;
+const withDisallowed = (config, denied) => {
+    const existing = config.flags["disallowed-tools"];
+    const values = [
+        ...(existing === undefined || existing.length === 0 ? [] : [existing]),
+        ...denied.map(({ pattern }) => pattern)
+    ];
+    return new CliConnectorConfig({
+        ...config,
+        flags: {
+            ...config.flags,
+            "disallowed-tools": values.join(",")
+        }
+    });
+};
+export const applyCoderPolicy = (config, grants) => {
+    const denied = patterns.filter(({ capability }) => !allows(grants, capability));
+    if (denied.length === 0) {
+        return new AppliedCoderPolicy({ config, unenforceable: [] });
+    }
+    if (config.connectorId.value === ConnectorIds.ClaudeCli.value) {
+        return new AppliedCoderPolicy({
+            config: withDisallowed(config, denied),
+            unenforceable: []
+        });
+    }
+    return new AppliedCoderPolicy({
+        config,
+        unenforceable: denied.map(({ capability }) => `${config.connectorId.value} cannot enforce the missing ${capabilityName(capability)} restriction on the coder`)
+    });
+};
+//# sourceMappingURL=CoderPolicy.js.map

package/dist/CoderPolicy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CoderPolicy.js","sourceRoot":"","sources":["../src/CoderPolicy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,EAAE,YAAY,EAAmB,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAE/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAA;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAElD,MAAM,OAAO,kBAAmB,SAAQ,MAAM,CAAC,KAAK,CAAqB,oBAAoB,CAAC,CAAC;IAC7F,MAAM,EAAE,kBAAkB;IAC1B,aAAa,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC;CAC3C,CAAC;CAAG;AAOL,MAAM,QAAQ,GAAiC;IAC7C;QACE,UAAU,EAAE,YAAY,CAAC,OAAO;QAChC,OAAO,EAAE,kBAAkB;KAC5B;IACD;QACE,UAAU,EAAE,YAAY,CAAC,QAAQ;QACjC,OAAO,EAAE,yDAAyD;KACnE;IACD;QACE,UAAU,EAAE,YAAY,CAAC,OAAO;QAChC,OAAO,EAAE,+CAA+C;KACzD;IACD;QACE,UAAU,EAAE,YAAY,CAAC,QAAQ;QACjC,OAAO,EAAE,oCAAoC;KAC9C;CACF,CAAA;AAED,MAAM,cAAc,GAAG,CAAC,UAAsB,EAAU,EAAE,CACxD,UAAU,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,QAAQ,UAAU,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAA;AAE9E,MAAM,cAAc,GAAG,CACrB,MAA0B,EAC1B,MAAoC,EAChB,EAAE;IACtB,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAA;IACjD,MAAM,MAAM,GAAG;QACb,GAAG,CAAC,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QACtE,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC;KACxC,CAAA;IAED,OAAO,IAAI,kBAAkB,CAAC;QAC5B,GAAG,MAAM;QACT,KAAK,EAAE;YACL,GAAG,MAAM,CAAC,KAAK;YACf,kBAAkB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;SACrC;KACF,CAAC,CAAA;AACJ,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAC9B,MAA0B,EAC1B,MAAc,EACM,EAAE;IACtB,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAA;IAE/E,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,IAAI,kBAAkB,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC,CAAA;IAC9D,CAAC;IAED,IAAI,MAAM,CAAC,WAAW,CAAC,KAAK,KAAK,YAAY,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QAC9D,OAAO,IAAI,kBAAkB,CAAC;YAC5B,MAAM,EAAE,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC;YACtC,aAAa,EAAE,EAAE;SAClB,CAAC,CAAA;IACJ,CAAC;IAED,OAAO,IAAI,kBAAkB,CAAC;QAC5B,MAAM;QACN,aAAa,EAAE,MAAM,CAAC,GAAG,CACvB,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,CACjB,GAAG,MAAM,CAAC,WAAW,CAAC,KAAK,+BAA+B,cAAc,CAAC,UAAU,CAAC,2BAA2B,CAClH;KACF,CAAC,CAAA;AACJ,CAAC,CAAA"}

package/dist/Connectors.d.ts

@@ -0,0 +1,28 @@
+import * as Effect from "effect/Effect";
+import { ApiConnectorConfig, CliConnectorConfig, type ConnectorConfig } from "@llm4ts/core/ConnectorConfig";
+import { ScriptUsage } from "./FlowArgs.ts";
+export declare const claude: CliConnectorConfig;
+export declare const codex: CliConnectorConfig;
+export declare const gemini: CliConnectorConfig;
+export declare const pi: CliConnectorConfig;
+export declare const antigravity: CliConnectorConfig;
+export declare const grok: CliConnectorConfig;
+export declare const cursor: CliConnectorConfig;
+export declare const opencode: CliConnectorConfig;
+export declare const lmStudio: ApiConnectorConfig;
+export declare const openAI: ApiConnectorConfig;
+export declare const anthropic: ApiConnectorConfig;
+export declare const geminiApi: ApiConnectorConfig;
+export declare const ollama: ApiConnectorConfig;
+export declare const mock: ApiConnectorConfig;
+export declare function withModel(config: CliConnectorConfig, model: string): CliConnectorConfig;
+export declare function withModel(config: ApiConnectorConfig, model: string): ApiConnectorConfig;
+export declare const withTurnLimit: (config: CliConnectorConfig, turnLimit: number) => CliConnectorConfig;
+export declare const withEnvironment: (config: CliConnectorConfig, environment: Readonly<Record<string, string>>) => CliConnectorConfig;
+export declare const asReadOnly: (config: CliConnectorConfig) => CliConnectorConfig;
+export declare const withTimeoutSeconds: (config: ApiConnectorConfig, seconds: number) => ApiConnectorConfig;
+export declare const enrichApiConnector: (config: ApiConnectorConfig, environment?: Readonly<Record<string, string | undefined>>) => ApiConnectorConfig;
+export declare const prepareConnector: (config: ConnectorConfig, workDir: string, environment?: Readonly<Record<string, string | undefined>>) => ConnectorConfig;
+export declare const apiConnectorFromEnvironment: (environment?: Readonly<Record<string, string | undefined>> | undefined) => Effect.Effect<ApiConnectorConfig, ScriptUsage, never>;
+export declare const coderFromEnv: (env?: Readonly<Record<string, string | undefined>>) => CliConnectorConfig;
+//# sourceMappingURL=Connectors.d.ts.map

package/dist/Connectors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Connectors.d.ts","sourceRoot":"","sources":["../src/Connectors.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,KAAK,eAAe,EACrB,MAAM,8BAA8B,CAAA;AAErC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAE3C,eAAO,MAAM,MAAM,oBAKjB,CAAA;AAEF,eAAO,MAAM,KAAK,oBAKhB,CAAA;AAEF,eAAO,MAAM,MAAM,oBAEjB,CAAA;AAEF,eAAO,MAAM,EAAE,oBAEb,CAAA;AAEF,eAAO,MAAM,WAAW,oBAKtB,CAAA;AAEF,eAAO,MAAM,IAAI,oBAEf,CAAA;AAEF,eAAO,MAAM,MAAM,oBAEjB,CAAA;AAEF,eAAO,MAAM,QAAQ,oBAEnB,CAAA;AAEF,eAAO,MAAM,QAAQ,oBAGnB,CAAA;AAEF,eAAO,MAAM,MAAM,oBAEjB,CAAA;AAEF,eAAO,MAAM,SAAS,oBAEpB,CAAA;AAEF,eAAO,MAAM,SAAS,oBAEpB,CAAA;AAEF,eAAO,MAAM,MAAM,oBAEjB,CAAA;AAEF,eAAO,MAAM,IAAI,oBAGf,CAAA;AAEF,wBAAgB,SAAS,CAAC,MAAM,EAAE,kBAAkB,EAAE,KAAK,EAAE,MAAM,GAAG,kBAAkB,CAAA;AACxF,wBAAgB,SAAS,CAAC,MAAM,EAAE,kBAAkB,EAAE,KAAK,EAAE,MAAM,GAAG,kBAAkB,CAAA;AAUxF,eAAO,MAAM,aAAa,GAAI,QAAQ,kBAAkB,EAAE,WAAW,MAAM,KAAG,kBAI1E,CAAA;AAEJ,eAAO,MAAM,eAAe,GAC1B,QAAQ,kBAAkB,EAC1B,aAAa,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,KAC5C,kBAOC,CAAA;AAEJ,eAAO,MAAM,UAAU,GAAI,QAAQ,kBAAkB,KAAG,kBACA,CAAA;AAExD,eAAO,MAAM,kBAAkB,GAC7B,QAAQ,kBAAkB,EAC1B,SAAS,MAAM,KACd,kBAIC,CAAA;AAkBJ,eAAO,MAAM,kBAAkB,GAC7B,QAAQ,kBAAkB,EAC1B,cAAa,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAe,KACtE,kBAYF,CAAA;AAED,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,eAAe,EACvB,SAAS,MAAM,EACf,cAAa,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAe,KACtE,eAG8D,CAAA;AAEjE,eAAO,MAAM,2BAA2B,mIAwCtC,CAAA;AAEF,eAAO,MAAM,YAAY,GACvB,MAAK,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAe,KAC9D,kBAmBF,CAAA"}

package/dist/Connectors.js

@@ -0,0 +1,165 @@
+import * as Duration from "effect/Duration";
+import * as Effect from "effect/Effect";
+import * as Redacted from "effect/Redacted";
+import { ApiConnectorConfig, CliConnectorConfig } from "@llm4ts/core/ConnectorConfig";
+import { ConnectorIds, connectorDefaultBaseUrl } from "@llm4ts/core/Models";
+import { ScriptUsage } from "./FlowArgs.js";
+export const claude = CliConnectorConfig.make({
+    connectorId: ConnectorIds.ClaudeCli,
+    flags: {
+        "permission-mode": "acceptEdits"
+    }
+});
+export const codex = CliConnectorConfig.make({
+    connectorId: ConnectorIds.Codex,
+    flags: {
+        sandbox: "workspace-write"
+    }
+});
+export const gemini = CliConnectorConfig.make({
+    connectorId: ConnectorIds.GeminiCli
+});
+export const pi = CliConnectorConfig.make({
+    connectorId: ConnectorIds.Pi
+});
+export const antigravity = CliConnectorConfig.make({
+    connectorId: ConnectorIds.AntigravityCli,
+    flags: {
+        mode: "accept-edits"
+    }
+});
+export const grok = CliConnectorConfig.make({
+    connectorId: ConnectorIds.Grok
+});
+export const cursor = CliConnectorConfig.make({
+    connectorId: ConnectorIds.Cursor
+});
+export const opencode = CliConnectorConfig.make({
+    connectorId: ConnectorIds.OpenCode
+});
+export const lmStudio = ApiConnectorConfig.make({
+    connectorId: ConnectorIds.LmStudio,
+    baseUrl: "http://localhost:1234/v1"
+});
+export const openAI = ApiConnectorConfig.make({
+    connectorId: ConnectorIds.OpenAI
+});
+export const anthropic = ApiConnectorConfig.make({
+    connectorId: ConnectorIds.Anthropic
+});
+export const geminiApi = ApiConnectorConfig.make({
+    connectorId: ConnectorIds.GeminiApi
+});
+export const ollama = ApiConnectorConfig.make({
+    connectorId: ConnectorIds.Ollama
+});
+export const mock = ApiConnectorConfig.make({
+    connectorId: ConnectorIds.Mock,
+    model: "mock"
+});
+export function withModel(config, model) {
+    return config instanceof CliConnectorConfig
+        ? CliConnectorConfig.make({ ...config, model })
+        : ApiConnectorConfig.make({ ...config, model });
+}
+export const withTurnLimit = (config, turnLimit) => CliConnectorConfig.make({
+    ...config,
+    turnLimit
+});
+export const withEnvironment = (config, environment) => CliConnectorConfig.make({
+    ...config,
+    envVars: {
+        ...config.envVars,
+        ...environment
+    }
+});
+export const asReadOnly = (config) => CliConnectorConfig.make({ ...config, readOnly: true });
+export const withTimeoutSeconds = (config, seconds) => ApiConnectorConfig.make({
+    ...config,
+    timeout: Duration.seconds(seconds)
+});
+const environmentApiKey = (config, environment) => {
+    switch (config.connectorId.value) {
+        case "openai":
+            return environment.OPENAI_API_KEY;
+        case "anthropic":
+            return environment.ANTHROPIC_API_KEY;
+        case "gemini-api":
+            return environment.GEMINI_API_KEY ?? environment.GOOGLE_API_KEY;
+        default:
+            return undefined;
+    }
+};
+export const enrichApiConnector = (config, environment = process.env) => {
+    const baseUrl = config.baseUrl ?? connectorDefaultBaseUrl(config.connectorId);
+    const environmentKey = environmentApiKey(config, environment);
+    return ApiConnectorConfig.make({
+        ...config,
+        ...(baseUrl === undefined ? {} : { baseUrl }),
+        ...(config.apiKey !== undefined
+            ? { apiKey: config.apiKey }
+            : environmentKey === undefined
+                ? {}
+                : { apiKey: Redacted.make(environmentKey) })
+    });
+};
+export const prepareConnector = (config, workDir, environment = process.env) => config instanceof ApiConnectorConfig
+    ? enrichApiConnector(config, environment)
+    : CliConnectorConfig.make({ ...config, workingDir: workDir });
+export const apiConnectorFromEnvironment = Effect.fn("@llm4ts/runner/Connectors.apiConnectorFromEnvironment")(function* (environment = process.env) {
+    const provider = environment.LLM4TS_PROVIDER?.trim().toLowerCase() ?? "mock";
+    const preset = (() => {
+        switch (provider) {
+            case "mock":
+                return mock;
+            case "openai":
+                return openAI;
+            case "anthropic":
+                return anthropic;
+            case "gemini":
+            case "gemini-api":
+                return geminiApi;
+            case "lm-studio":
+            case "lmstudio":
+                return lmStudio;
+            case "ollama":
+                return ollama;
+            default:
+                return undefined;
+        }
+    })();
+    if (preset === undefined) {
+        return yield* ScriptUsage.make({
+            message: `unknown LLM4TS_PROVIDER '${provider}'; expected ` +
+                "mock|openai|anthropic|gemini|lm-studio|ollama"
+        });
+    }
+    const model = environment.LLM4TS_MODEL?.trim();
+    if (provider !== "mock" && (model === undefined || model.length === 0)) {
+        return yield* ScriptUsage.make({
+            message: `LLM4TS_MODEL is required for provider '${provider}' (e.g. LLM4TS_MODEL=gpt-4o-mini)`
+        });
+    }
+    return model === undefined || model.length === 0 ? preset : withModel(preset, model);
+});
+export const coderFromEnv = (env = process.env) => {
+    switch (env.LLM4TS_CODER ?? env.LLM4ZIO_CODER ?? "claude") {
+        case "codex":
+            return codex;
+        case "gemini":
+            return gemini;
+        case "pi":
+            return pi;
+        case "agy":
+            return antigravity;
+        case "grok":
+            return grok;
+        case "cursor":
+            return cursor;
+        case "opencode":
+            return opencode;
+        default:
+            return claude;
+    }
+};
+//# sourceMappingURL=Connectors.js.map

package/dist/Connectors.js.map

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

package/dist/Doctor.d.ts

@@ -0,0 +1,4 @@
+import * as Effect from "effect/Effect";
+import type { ConnectorRegistryShape } from "@llm4ts/core/ConnectorRegistry";
+export declare const makeDoctorProgram: (registry?: ConnectorRegistryShape, environment?: Readonly<Record<string, string | undefined>>) => Effect.Effect<string>;
+//# sourceMappingURL=Doctor.d.ts.map

package/dist/Doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Doctor.d.ts","sourceRoot":"","sources":["../src/Doctor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAA;AAiB5E,eAAO,MAAM,iBAAiB,GAC5B,WAAU,sBAA8D,EACxE,cAAa,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAe,KACtE,MAAM,CAAC,MAAM,CAAC,MAAM,CAqBnB,CAAA"}

package/dist/Doctor.js

@@ -0,0 +1,33 @@
+import * as Effect from "effect/Effect";
+import { nodeFlowRunnerDependencies } from "./FlowRunner.js";
+const credentialKeys = [
+    "OPENAI_API_KEY",
+    "ANTHROPIC_API_KEY",
+    "GEMINI_API_KEY",
+    "GOOGLE_API_KEY"
+];
+const statusLine = (id, status) => {
+    const mark = status.availability === "Healthy" ? "✔" : status.availability === "Unknown" ? "?" : "✖";
+    const auth = status.authStatus === "Unknown" ? "" : `  auth: ${status.authStatus.toLowerCase()}`;
+    return `  ${mark} ${id.padEnd(14)} ${status.availability.toLowerCase()}${auth}`;
+};
+export const makeDoctorProgram = (registry = nodeFlowRunnerDependencies().registry, environment = process.env) => Effect.map(registry.healthCheckAll, (statuses) => {
+    const lines = [];
+    lines.push("llm4ts doctor");
+    lines.push("");
+    lines.push("connectors:");
+    const sorted = Array.from(statuses.entries()).sort(([a], [b]) => a.value.localeCompare(b.value));
+    for (const [id, status] of sorted) {
+        lines.push(statusLine(id.value, status));
+    }
+    lines.push("");
+    lines.push("credentials:");
+    for (const key of credentialKeys) {
+        const value = environment[key];
+        lines.push(`  ${value === undefined || value.length === 0 ? "✖" : "✔"} ${key}`);
+    }
+    lines.push("");
+    lines.push(`coder: ${environment.LLM4TS_CODER ?? environment.LLM4ZIO_CODER ?? "claude (default)"}`);
+    return `${lines.join("\n")}\n`;
+});
+//# sourceMappingURL=Doctor.js.map

package/dist/Doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Doctor.js","sourceRoot":"","sources":["../src/Doctor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAGvC,OAAO,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAA;AAE5D,MAAM,cAAc,GAAG;IACrB,gBAAgB;IAChB,mBAAmB;IACnB,gBAAgB;IAChB,gBAAgB;CACR,CAAA;AAEV,MAAM,UAAU,GAAG,CAAC,EAAU,EAAE,MAAoB,EAAU,EAAE;IAC9D,MAAM,IAAI,GACR,MAAM,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAA;IACzF,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,MAAM,CAAC,UAAU,CAAC,WAAW,EAAE,EAAE,CAAA;IAChG,OAAO,KAAK,IAAI,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,MAAM,CAAC,YAAY,CAAC,WAAW,EAAE,GAAG,IAAI,EAAE,CAAA;AACjF,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,WAAmC,0BAA0B,EAAE,CAAC,QAAQ,EACxE,cAA4D,OAAO,CAAC,GAAG,EAChD,EAAE,CACzB,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,cAAc,EAAE,CAAC,QAAQ,EAAE,EAAE;IAC/C,MAAM,KAAK,GAAkB,EAAE,CAAA;IAC/B,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAA;IAC3B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACd,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAA;IACzB,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAA;IAChG,KAAK,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QAClC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAA;IAC1C,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACd,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;IAC1B,KAAK,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;QACjC,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,CAAA;QAC9B,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,EAAE,CAAC,CAAA;IACjF,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACd,KAAK,CAAC,IAAI,CACR,UAAU,WAAW,CAAC,YAAY,IAAI,WAAW,CAAC,aAAa,IAAI,kBAAkB,EAAE,CACxF,CAAA;IACD,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAA;AAChC,CAAC,CAAC,CAAA"}

package/dist/FlowArgs.d.ts

@@ -0,0 +1,34 @@
+import * as Effect from "effect/Effect";
+import * as Schema from "effect/Schema";
+export interface FlowArgs {
+    readonly promptText?: string;
+    readonly promptFile?: string;
+    readonly repo?: string;
+    readonly help?: boolean;
+    readonly version?: boolean;
+}
+export declare const FlowUsage = "usage: llm4ts [\"<prompt>\" | --prompt-file <path> | @<path>] [--repo <path>] | llm4ts doctor";
+export declare const FlowHelp = "usage: llm4ts [\"<prompt>\" | --prompt-file <path> | @<path>] [--repo <path>] | llm4ts doctor\n\nStream one prompt to your configured coding agent and print the response.\n\narguments:\n  \"<prompt>\"              prompt text\n  @<path>                 read the prompt from a file\n  --prompt-file <path>    read the prompt from a file\n  --repo, -C <path>       run against this repository (default: current directory)\n  -h, --help              show this help\n  --version               print the version\n\ncommands:\n  doctor                  check connector availability and credentials\n\nenvironment:\n  LLM4TS_CODER            coding agent: claude|codex|gemini|pi|agy|grok|cursor|opencode (default: claude)\n  LLM4TS_VERBOSITY        terminal verbosity: quiet|normal|verbose\n  OPENAI_API_KEY, ANTHROPIC_API_KEY, GEMINI_API_KEY\n                          credentials for API providers\n\nA trace of each run is written under .llm4ts/ in the target repository.\n";
+declare const ScriptUsage_base: Schema.Class<ScriptUsage, Schema.TaggedStruct<"ScriptUsage", {
+    readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+export declare class ScriptUsage extends ScriptUsage_base {
+}
+export type FlowArgsParseResult = {
+    readonly ok: true;
+    readonly value: FlowArgs;
+} | {
+    readonly ok: false;
+    readonly error: ScriptUsage;
+};
+export declare const parseFlowArgs: (args: ReadonlyArray<string>) => FlowArgsParseResult;
+export declare const readFlowPrompt: (args: FlowArgs, defaultPrompt?: string) => Effect.Effect<string, ScriptUsage>;
+export declare const resolveFlowRepo: (args: FlowArgs, workspace: string) => Effect.Effect<string, ScriptUsage>;
+export interface FlowInput {
+    readonly prompt: string;
+    readonly workDir: string;
+    readonly workspace: string;
+}
+export declare const resolveFlowInput: (defaultPrompt?: string | undefined, argv?: readonly string[] | undefined, workspace?: any) => Effect.Effect<FlowInput, ScriptUsage, never>;
+export {};
+//# sourceMappingURL=FlowArgs.d.ts.map

package/dist/FlowArgs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FlowArgs.d.ts","sourceRoot":"","sources":["../src/FlowArgs.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAC3B;AAED,eAAO,MAAM,SAAS,kGACyE,CAAA;AAE/F,eAAO,MAAM,QAAQ,88BAsBpB,CAAA;;;;AAED,qBAAa,WAAY,SAAQ,gBAE/B;CAAG;AAEL,MAAM,MAAM,mBAAmB,GAC3B;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAA;CAAE,GAC/C;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAA;CAAE,CAAA;AAEvD,eAAO,MAAM,aAAa,GAAI,MAAM,aAAa,CAAC,MAAM,CAAC,KAAG,mBAuD3D,CAAA;AAED,eAAO,MAAM,cAAc,GACzB,MAAM,QAAQ,EACd,gBAAgB,MAAM,KACrB,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAgBnC,CAAA;AAED,eAAO,MAAM,eAAe,GAC1B,MAAM,QAAQ,EACd,WAAW,MAAM,KAChB,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAiBnC,CAAA;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED,eAAO,MAAM,gBAAgB,6IAY3B,CAAA"}