@clemrig/factory 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Clément CHESNEAU
+
+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

@@ -1,3 +1,199 @@
-# Temporary Holding Version
+# @clemrig/factory
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Write agent workflows in TypeScript inside any repository, run them in the terminal and watch them in a local dashboard.
+
+A workflow is an explicit graph of **CODE** stages (your code), **AGENT** stages (an agent run by [Claude Code](https://code.claude.com) or [Pi](https://www.npmjs.com/package/@earendil-works/pi-coding-agent)) and **GATE** stages that accept a result or send it back for correction, a bounded number of times. Workflows live in the repository's `.factory/` folder, are committed with it and run without a build step.
+
+## Requirements
+
+- macOS or Linux, Node.js 24 or later, npm.
+- For agents run by Claude Code: the `claude` CLI 2.1.296 or later in the `PATH`, logged in with a claude.ai subscription (`claude`, then `/login`) or given an API key (`ANTHROPIC_API_KEY`).
+- For agents run by Pi: the `pi` CLI (`@earendil-works/pi-coding-agent` 1.1.0 or later) in the `PATH`, connected to the provider each Pi profile names (`pi`, then `/login`, or the provider's API key).
+
+The factory never reads or stores credentials: each runtime uses its own connection, from its login or from an API key in the environment or `.factory/.env`. Claude Code prefers an API key to its login; Pi prefers a login stored for the provider to an API key. `factory doctor` and `factory run` show which connection each runtime uses.
+
+## Get started
+
+```sh
+npm install -g @clemrig/factory
+cd my-repository
+factory init
+factory doctor
+factory run ask --question "What changed recently?"
+```
+
+`factory init` creates `.factory/` in the current directory and installs it; it refuses to overwrite an existing `.factory/`. Commit `.factory/`: another machine only needs `npm ci --prefix .factory`.
+
+```
+.factory/
+  package.json             pins the exact core version
+  factory.ts               the repository's workflows
+  workflows/ask/
+    index.ts               the example workflow
+    prompts/answer.md      the prompt of its answer stage
+  tsconfig.json            editor settings only
+  .gitignore               node_modules/, runs/, .env
+  runs/                    one folder per run (ignored)
+  .env                     optional secrets (ignored)
+```
+
+The global `factory` command uses the nearest `.factory/` holding a `package.json`, in the current directory or a parent, and runs the core version installed there: every machine runs the version pinned in the repository. Only `factory init` and `factory help` run with the global version. Without `.factory/` the command asks for `factory init`; without installed dependencies it gives the `npm ci --prefix .factory` command to run.
+
+The example workflow `ask` reads the last 10 commits with `git log` (a CODE stage), asks a read-only Claude Code agent (`claude-sonnet-5-5`, effort `low`, tools `Read`, `Grep`, `Glob`) to answer the question, and checks the answer with a gate that sends it back at most 3 times. Copy its folder to start a new workflow.
+
+## Write a workflow
+
+```ts
+// .factory/workflows/changelog/index.ts
+import {
+  agent,
+  defineWorkflow,
+  END,
+  node,
+  pick,
+  retry,
+  runProcess,
+  schemaGate,
+  step,
+  z,
+} from "@clemrig/factory";
+
+const notes = z.strictObject({ entries: z.array(z.string().min(1)).min(1) });
+
+export default defineWorkflow({
+  name: "changelog", // also the folder name: .factory/workflows/changelog/
+  input: z.object({
+    since: z.string().min(1),
+    limit: z.coerce.number().int().positive().optional(), // options are strings: coerce numbers
+  }),
+  initial: "log",
+  nodes: {
+    log: node(
+      step(async ({ dir, state }) => {
+        const log = await runProcess(
+          ["git", "log", "--oneline", `--since=${String(state.input.since)}`],
+          dir,
+          30_000,
+        );
+        if (log.exitCode !== 0) throw new Error(log.stderr);
+        return { commits: log.stdout.trim().split("\n") };
+      }),
+      { ok: "write" },
+    ),
+    // AGENT: prompt in prompts/write.md, after the stage.
+    write: node(
+      agent({
+        profile: {
+          runtime: "claude-code",
+          model: "claude-sonnet-5-5",
+          thinking: "low",
+          tools: ["Read", "Grep", "Glob"],
+          // access: "read" by default; "write" allows tools that change the repository
+        },
+        schema: notes,
+        context: pick("input", "commits"),
+      }),
+      { ok: "check" },
+    ),
+    check: node(
+      schemaGate({
+        schema: notes,
+        into: "notes",
+        check: ({ entries }) =>
+          entries.length > 20 ? "Keep at most 20 entries" : undefined,
+      }),
+      { ok: END, invalid: retry("write", 3) },
+    ),
+  },
+  // Optional: without it, the result shows the run's validated data as JSON.
+  presentResult: (state) =>
+    (state.data.notes as { entries: string[] }).entries.map((entry) => `- ${entry}`),
+});
+```
+
+```ts
+// .factory/factory.ts
+import ask from "./workflows/ask/index.ts";
+import changelog from "./workflows/changelog/index.ts";
+
+export default [ask, changelog];
+```
+
+Workflows are TypeScript run directly by Node: use erasable syntax only (no `enum`, no parameter properties) and relative imports with their `.ts` extension. Import the core only from `@clemrig/factory`, which also exports `z` (Zod), so that workflows and the core share one Zod instance.
+
+**Graph.** Each stage declares its outcomes and the node routes every outcome to a stage, to `END` or to `retry(stage, max)`. A stage receives `{ state, agent, log, dir }`: the run (read-only), the agent runtime, the run journal and the repository directory. Stages and agents work in the repository (the folder that contains `.factory/`), which is also the process's working directory during a run, wherever the command was started.
+
+| Primitive | Use |
+|---|---|
+| `step(run)`, `code(outcomes, run)` | CODE stage: returns data (merged into `state.data`) or a named outcome |
+| `agent({ profile, schema, context, prompt?, session? })` | AGENT stage: one structured request run with its profile; its output waits in `state.output` for a gate |
+| `gate(outcomes, run)`, `schemaGate({ schema, into, check? })` | GATE stage: `schemaGate` validates the agent output, runs `check`, then writes it into `state.data[into]` or sends a correction |
+| `retry(stage, max)` | correction route, taken at most `max` times (1–100) per run, with the gate's reason as `feedback` for the next agent |
+| `pick(...keys)` | agent context from `input` and data keys |
+| `runProcess(argv, cwd, timeoutMs)` | runs a command without a shell; Ctrl-C stops it |
+
+`defineWorkflow` refuses, when the workflow is loaded: a `.` in a stage or outcome name (a correction counter is named `<stage>.<outcome>`), an unrouted outcome, an unknown target, a retry maximum outside 1–100, a loop whose edges include no `retry` (with the loop's path), an invalid profile, a write tool in a read-only profile, a prompt or session name that cannot name a file, a `maxCostUsd` that is not a positive number, and an input that is not a `z.object` or uses the names `json`, `help` or `max-cost-usd`. Every run is therefore bounded.
+
+**Inputs.** Each field of `input` becomes a `--<name>` option of `factory run`; an option given without a value is `true` and only a boolean field accepts it: `z.boolean()`, possibly with `.optional()`, `.nullable()` or `.default(…)` (a transformed boolean or one with `.catch` takes no option alone). A missing, invalid or unknown option is refused with the list of problems, before any run is created. A workflow without `input` accepts no input option.
+
+**Budget.** `maxCostUsd` (optional) fails a run once the cost its agents' runtimes announced exceeds it; `factory run … --max-cost-usd 2` sets it for one run, instead of the workflow's. It is checked before and after each agent call, failed or not, on the runtime's figures: a running call is not stopped and can go past it; once it is exceeded, no further call starts and the run fails at its next stage boundary, even if workflow code catches the error. A call that announced no cost fails a run that has a budget, since the budget can no longer be checked. With a subscription, the cost is an estimate.
+
+**Profiles.** Each agent stage declares its complete profile; no machine setting changes it. A profile is a plain object: share one between stages with a constant, typed with `satisfies AgentProfile` (`AgentProfile` is exported by `@clemrig/factory`).
+
+| Field | Claude Code (`runtime: "claude-code"`) | Pi (`runtime: "pi"`) |
+|---|---|---|
+| `access` | `"read"` (default) or `"write"` | `"read"` (default) or `"write"` |
+| `provider` | — | the Pi provider, required (`openai`, `openai-codex`…) |
+| `model` | model name or alias | model name |
+| `thinking` | effort: `low` … `max` | `off` … `max` |
+| `tools` | exact names (`Read`, `Grep`, `Bash`…) and `mcp__<server>__<tool>` | exact names (`read`, `bash`…); other names need an extension |
+| other | `mcpServers: { name: { command, args? } }` | `skills`, `extensions` (paths) |
+| `timeoutMs` | default 15 minutes | default 15 minutes |
+
+A read-only profile may use only `Read`, `Grep`, `Glob`, `WebFetch`, `WebSearch` and declared MCP tools on Claude Code, and no `bash`, `powershell`, `edit` or `write` on Pi. Relative skill, extension and MCP command paths are relative to `.factory/`; a bare command is looked up in the `PATH`. Each Claude Code session holds only the profile's tools and MCP servers, without the operator's settings, plugins, skills or memory: a session with another tool, MCP server or plugin is refused, and another customization (skills, commands, output style, memory) is journaled as a warning. Pi runs without the machine's extensions, skills, context files and MCP servers. Runtimes are not sandboxes: listed tools act with your rights.
+
+**Prompts.** An agent's prompt is `.factory/workflows/<workflow>/prompts/<name>.md`, where the name is the stage's unless `agent({ prompt })` names another. It is appended to the runtime's system prompt; the request (context and output JSON Schema) follows on standard input. Prompts are read when a run starts: an edit applies to the next run, without building anything.
+
+**Sessions.** An agent stage keeps one conversation per run: a correction sent back to it resumes the conversation, with the gate's feedback. `session: "name"` shares a conversation between stages of the same runtime (sharing one across runtimes is refused); `session: (state) => name` opens one per value. A run's stage and session names form one namespace per runtime: a name returned by a function joins the conversation of that name on the same runtime. Session names start and end with a letter or digit.
+
+## Run and observe
+
+```sh
+factory run changelog --since 2026-10-01 [--json]
+factory status [RUN_ID] [--json]
+factory ui [--port 4321]
+factory doctor [--json]
+```
+
+Before creating a run, `factory run` validates the input, reads the prompts and checks, for each runtime the workflow uses, that its executable is in the `PATH`, at least the supported version, and connected; a missing piece fails the command with the stage, runtime and reason. The terminal then shows each runtime's version and connection. A model the account cannot use fails the run at its first call, with the runtime's message.
+
+The run executes in the foreground. The terminal shows each stage's start and end, decisions and corrections with their counter (`[check.invalid 1/3]`), journal messages and, for an agent, the start and end of its call, each finished tool with its duration and isolation warnings; then the result, the duration, the agents' tokens and estimated cost, and the runtimes used. `--json` writes every event, then the result, as JSON lines on standard output. Exit codes: 0 completed, 1 error or failed run.
+
+**Ctrl-C** stops the run's child processes and ends the run as `failed` with its cause before its next stage, or instead of completing; a second Ctrl-C kills the remaining child processes and quits at once (exit code 130, the run may then stay `running`). A failed or interrupted run is not resumed: start a new one.
+
+`factory status` lists the repository's runs or shows one; while `factory.ts` cannot load, `status` and `ui` say so and still show the runs with the default rendering. `factory ui` serves a read-only dashboard of the repository's runs on `127.0.0.1` (port chosen by the system unless `--port` sets it, URL printed; Ctrl-C stops it): the runs with workflow, status, current stage, duration, estimated cost and last update, and for a run its runtimes, a timeline with one block per stage (status, duration, the agent's tools and tokens as they come, journal, decision), the correction counters and the result. It follows a running run as it goes. To watch a run on another machine, forward the same port through SSH: `ssh -L 4321:127.0.0.1:4321 machine`, run `factory ui --port 4321` there, and open `http://localhost:4321/`. `factory doctor` checks Node, loads the workflows, reads their prompts, lists each workflow's options and checks each runtime's executable, version and connection, without any provider request.
+
+## Data
+
+Each run keeps `state.json` and `events.jsonl` in `.factory/runs/<RUN_ID>/`, plus its Pi sessions and Claude Code session markers; Claude Code keeps its transcripts in its own storage (`~/.claude/projects/…`). Runs hold inputs, agent outputs and the journal: they stay private and are ignored by Git. `.factory/.env` is loaded automatically, without overriding variables already set in the shell; runtimes, MCP servers and commands inherit the environment. `factory run` executes the code of `.factory/`: trust it as you trust `npm run`. The dashboard shows the same data to any local process that can reach `127.0.0.1`.
+
+Tokens and costs are the figures each runtime announces, never recomputed: Claude Code announces at the end of a call its session's total, earlier calls included, and its tokens during a call are provisional; Pi announces each response with its cost. A run's total is the sum of its sessions; a call without figures makes it partial. The estimated cost is the runtime's public-price estimate, not a bill.
+
+## Limits
+
+Not in this version: resuming a run, detached runs, logs `--follow` and stop, local settings or profile overrides, actions or graph drawing in the dashboard, runs of several repositories, `factory new`, a shared stage library, a test harness for workflows, CI, cron or Git hook triggers, notifications, Windows.
+
+## Develop the core
+
+```sh
+npm ci
+npm run check        # lint, format, typecheck, tests with coverage, build
+npm run build
+npm pack             # then, in a test repository: npm install --no-save --prefix .factory /path/to/clemrig-factory-0.1.0.tgz
+```
+
+`npm link` in this repository provides a global `factory` built from it; a test repository still runs the core installed in its `.factory/`. See [AGENTS.md](AGENTS.md), [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md), [docs/DEVELOPMENT.md](docs/DEVELOPMENT.md) and the [decisions](docs/decisions/README.md) (in French).
+
+## License
+
+[MIT](LICENSE)

package/dist/app/doctor.d.ts

@@ -0,0 +1,20 @@
+import type { Runtime } from "../engine/profiles.js";
+import type { Workflow } from "../engine/types.js";
+import { type AgentProblem, type RuntimeStatus } from "../system/runtimes/inspect.js";
+export type { AgentProblem, RuntimeStatus, } from "../system/runtimes/inspect.js";
+/** What `factory doctor` found, without any provider request. */
+export interface Diagnosis {
+    ok: boolean;
+    node: RuntimeStatus;
+    factory: RuntimeStatus;
+    /** Each loaded workflow, with the reason its prompts cannot be read. */
+    workflows: {
+        workflow: Workflow;
+        error?: string;
+    }[];
+    runtimes: Partial<Record<Runtime, RuntimeStatus>>;
+    /** Missing runtimes, by `<workflow>.<stage>`. */
+    problems: AgentProblem[];
+}
+/** Node, the factory and its workflows' prompts, then each runtime in use. */
+export declare function diagnose(factoryDir: string): Promise<Diagnosis>;

package/dist/app/doctor.js

@@ -0,0 +1,38 @@
+import { loadLocalEnvironment } from "../system/environment.js";
+import { loadFactory, loadPrompts } from "../system/factory.js";
+import { inspectNode, inspectRuntimes, } from "../system/runtimes/inspect.js";
+const message = (error) => error instanceof Error ? error.message : String(error);
+/** Node, the factory and its workflows' prompts, then each runtime in use. */
+export async function diagnose(factoryDir) {
+    loadLocalEnvironment(factoryDir);
+    const node = inspectNode();
+    let factory;
+    let loaded;
+    try {
+        factory = await loadFactory(factoryDir);
+        loaded = { ok: true, detail: `Factory ${factoryDir}` };
+    }
+    catch (error) {
+        loaded = { ok: false, detail: `Factory: ${message(error)}` };
+    }
+    const workflows = [];
+    const agents = {};
+    for (const workflow of factory?.workflows.values() ?? []) {
+        try {
+            await loadPrompts(factoryDir, workflow);
+            workflows.push({ workflow });
+        }
+        catch (error) {
+            workflows.push({ workflow, error: message(error) });
+        }
+        for (const [stage, declared] of Object.entries(workflow.agents))
+            agents[`${workflow.name}.${stage}`] = declared;
+    }
+    const { runtimes, problems } = await inspectRuntimes(agents);
+    const ok = node.ok &&
+        loaded.ok &&
+        workflows.every(({ error }) => error === undefined) &&
+        problems.length === 0;
+    return { ok, node, factory: loaded, workflows, runtimes, problems };
+}
+//# sourceMappingURL=doctor.js.map

package/dist/app/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../src/app/doctor.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAgB,WAAW,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC9E,OAAO,EAEL,WAAW,EACX,eAAe,GAEhB,MAAM,+BAA+B,CAAC;AAmBvC,MAAM,OAAO,GAAG,CAAC,KAAc,EAAE,EAAE,CACjC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAEzD,8EAA8E;AAC9E,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,UAAkB;IAC/C,oBAAoB,CAAC,UAAU,CAAC,CAAC;IACjC,MAAM,IAAI,GAAG,WAAW,EAAE,CAAC;IAC3B,IAAI,OAA4B,CAAC;IACjC,IAAI,MAAqB,CAAC;IAC1B,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,WAAW,CAAC,UAAU,CAAC,CAAC;QACxC,MAAM,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,UAAU,EAAE,EAAE,CAAC;IACzD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,OAAO,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;IAC/D,CAAC;IACD,MAAM,SAAS,GAA2B,EAAE,CAAC;IAC7C,MAAM,MAAM,GAA+B,EAAE,CAAC;IAC9C,KAAK,MAAM,QAAQ,IAAI,OAAO,EAAE,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC;QACzD,IAAI,CAAC;YACH,MAAM,WAAW,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;YACxC,SAAS,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC/B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACtD,CAAC;QACD,KAAK,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;YAC7D,MAAM,CAAC,GAAG,QAAQ,CAAC,IAAI,IAAI,KAAK,EAAE,CAAC,GAAG,QAAQ,CAAC;IACnD,CAAC;IACD,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,MAAM,eAAe,CAAC,MAAM,CAAC,CAAC;IAC7D,MAAM,EAAE,GACN,IAAI,CAAC,EAAE;QACP,MAAM,CAAC,EAAE;QACT,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC;QACnD,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC;IACxB,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;AACtE,CAAC"}

package/dist/app/factory.d.ts

@@ -0,0 +1,12 @@
+import { type Factory } from "../system/factory.js";
+export type { Factory } from "../system/factory.js";
+/** Loads `.factory/.env` without overriding the shell, then the repository's workflows. */
+export declare function openFactory(factoryDir: string): Promise<Factory>;
+/**
+ * The factory to read runs with: while `factory.ts` cannot load, its runs stay
+ * readable with the default rendering, and `error` says why.
+ */
+export declare function openFactoryForReading(factoryDir: string): Promise<{
+    factory: Factory;
+    error?: string;
+}>;

package/dist/app/factory.js

@@ -0,0 +1,22 @@
+import { loadLocalEnvironment } from "../system/environment.js";
+import { emptyFactory, loadFactory } from "../system/factory.js";
+const message = (error) => error instanceof Error ? error.message : String(error);
+/** Loads `.factory/.env` without overriding the shell, then the repository's workflows. */
+export async function openFactory(factoryDir) {
+    loadLocalEnvironment(factoryDir);
+    return loadFactory(factoryDir);
+}
+/**
+ * The factory to read runs with: while `factory.ts` cannot load, its runs stay
+ * readable with the default rendering, and `error` says why.
+ */
+export async function openFactoryForReading(factoryDir) {
+    loadLocalEnvironment(factoryDir);
+    try {
+        return { factory: await loadFactory(factoryDir) };
+    }
+    catch (error) {
+        return { factory: emptyFactory(factoryDir), error: message(error) };
+    }
+}
+//# sourceMappingURL=factory.js.map

package/dist/app/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../src/app/factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,YAAY,EAAgB,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAI/E,MAAM,OAAO,GAAG,CAAC,KAAc,EAAE,EAAE,CACjC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAEzD,2FAA2F;AAC3F,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,UAAkB;IAClD,oBAAoB,CAAC,UAAU,CAAC,CAAC;IACjC,OAAO,WAAW,CAAC,UAAU,CAAC,CAAC;AACjC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,UAAkB;IAElB,oBAAoB,CAAC,UAAU,CAAC,CAAC;IACjC,IAAI,CAAC;QACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC,UAAU,CAAC,EAAE,CAAC;IACpD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;IACtE,CAAC;AACH,CAAC"}

package/dist/app/init.d.ts

@@ -0,0 +1,6 @@
+export { createFromTemplates as createFactory } from "../system/templates.js";
+/** Installs `.factory/`'s dependencies; `output` explains a failure. */
+export declare function installFactory(factoryDir: string): Promise<{
+    ok: boolean;
+    output: string;
+}>;

package/dist/app/init.js

@@ -0,0 +1,15 @@
+import { runProcess } from "../system/process.js";
+export { createFromTemplates as createFactory } from "../system/templates.js";
+/** Installs `.factory/`'s dependencies; `output` explains a failure. */
+export async function installFactory(factoryDir) {
+    const install = await runProcess(["npm", "install", "--no-audit", "--no-fund"], factoryDir, 600_000).catch((error) => ({
+        exitCode: 1,
+        stdout: "",
+        stderr: error instanceof Error ? error.message : String(error),
+    }));
+    return {
+        ok: install.exitCode === 0,
+        output: install.stderr || install.stdout,
+    };
+}
+//# sourceMappingURL=init.js.map

package/dist/app/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/app/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD,OAAO,EAAE,mBAAmB,IAAI,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE9E,wEAAwE;AACxE,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,UAAkB;IAElB,MAAM,OAAO,GAAG,MAAM,UAAU,CAC9B,CAAC,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,CAAC,EAC7C,UAAU,EACV,OAAO,CACR,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE,CAAC,CAAC;QAC3B,QAAQ,EAAE,CAAC;QACX,MAAM,EAAE,EAAE;QACV,MAAM,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;KAC/D,CAAC,CAAC,CAAC;IACJ,OAAO;QACL,EAAE,EAAE,OAAO,CAAC,QAAQ,KAAK,CAAC;QAC1B,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM;KACzC,CAAC;AACJ,CAAC"}

package/dist/app/run.d.ts

@@ -0,0 +1,24 @@
+import type { RunEvent, RunState } from "../engine/types.js";
+import { type Factory } from "../system/factory.js";
+import { type RuntimeStatus } from "../system/runtimes/inspect.js";
+export interface RunHooks {
+    /** Each stage, journal and agent event, once recorded. */
+    onEvent(event: RunEvent): void;
+}
+/** A created run, executing in the foreground. */
+export interface StartedRun {
+    state: Readonly<RunState>;
+    /** Each runtime the run uses: version, executable and connection. */
+    runtimes: RuntimeStatus[];
+    /** Settles with the run once it completed or failed. */
+    done: Promise<RunState>;
+    /** Fails the run with `reason` before its next stage. */
+    stop(reason: Error): void;
+    /** Kills the child process groups still running, before quitting at once. */
+    kill(): void;
+}
+/**
+ * Checks input, budget, prompts and runtimes before creating the run, then runs
+ * it in the repository that contains `.factory/`, whatever the working directory.
+ */
+export declare function startRun(factory: Factory, name: string, options: Record<string, string | boolean>, hooks: RunHooks): Promise<StartedRun>;

package/dist/app/run.js

@@ -0,0 +1,100 @@
+import { budgetProblem, emptyMetrics, recordUsage } from "../engine/metrics.js";
+import { executeWorkflow } from "../engine/runner.js";
+import { parseInput } from "../engine/workflow.js";
+import { loadPrompts, workflowOf } from "../system/factory.js";
+import { inDirectory, killProcessGroups } from "../system/process.js";
+import { AgentRuntime } from "../system/runtimes/agent-runtime.js";
+import { inspectRuntimes, } from "../system/runtimes/inspect.js";
+import { FileRunStore, newRunId } from "../system/store.js";
+/** `--max-cost-usd`: the run's budget instead of the workflow's. */
+function parseBudget(value) {
+    const budget = Number(value);
+    if (typeof value !== "string" || !Number.isFinite(budget) || budget <= 0)
+        throw new Error(`Invalid --max-cost-usd ${String(value)}: expected a positive number of USD`);
+    return budget;
+}
+/**
+ * Checks input, budget, prompts and runtimes before creating the run, then runs
+ * it in the repository that contains `.factory/`, whatever the working directory.
+ */
+export async function startRun(factory, name, options, hooks) {
+    const workflow = workflowOf(factory, name);
+    const { "max-cost-usd": budget, ...inputOptions } = options;
+    const maxCostUsd = budget === undefined ? workflow.maxCostUsd : parseBudget(budget);
+    const input = parseInput(workflow, inputOptions);
+    const prompts = await loadPrompts(factory.factoryDir, workflow);
+    const { runtimes, problems, executables } = await inspectRuntimes(workflow.agents);
+    if (problems.length)
+        throw new Error(`Missing prerequisites: ${problems.map(({ stage, runtime, reason }) => `stage ${stage} (${runtime}): ${reason}`).join("; ")}`);
+    const now = new Date().toISOString();
+    const state = {
+        version: 4,
+        id: newRunId(),
+        workflow: name,
+        input,
+        stage: workflow.initial,
+        status: "running",
+        data: {},
+        createdAt: now,
+        updatedAt: now,
+        metrics: emptyMetrics(),
+        runtimes: Object.fromEntries(Object.entries(runtimes).map(([runtime, { detail }]) => [
+            runtime,
+            detail,
+        ])),
+    };
+    const store = new FileRunStore(factory.runsDir, state.id);
+    const agent = new AgentRuntime({
+        dir: factory.dir,
+        factoryDir: factory.factoryDir,
+        prompts,
+        onUsage: async (report) => {
+            if (state.metrics)
+                recordUsage(state.metrics, report);
+            await store.save(state);
+        },
+        run: { id: state.id, directory: store.directory },
+        executables,
+    });
+    await store.save(state);
+    const controller = new AbortController();
+    /**
+     * Past its budget, the run stops: the abort fails it at its next stage
+     * boundary even if workflow code catches the error, and no call starts.
+     */
+    const overBudget = () => {
+        const problem = maxCostUsd === undefined || !state.metrics
+            ? undefined
+            : budgetProblem(state.metrics, maxCostUsd);
+        if (problem)
+            controller.abort(new Error(problem));
+        return problem;
+    };
+    // Checked before each agent call and after it, failed or not, on the figures its runtime announced.
+    const budgeted = {
+        async execute(request, record) {
+            const refused = overBudget();
+            if (refused)
+                throw new Error(refused);
+            const value = await agent
+                .execute(request, record)
+                .finally(() => overBudget());
+            const exceeded = overBudget();
+            if (exceeded)
+                throw new Error(exceeded);
+            return value;
+        },
+    };
+    const done = inDirectory(factory.dir, () => executeWorkflow(workflow, state, { agent: budgeted, dir: factory.dir }, store, {
+        onEvent: hooks.onEvent,
+        signal: controller.signal,
+    }));
+    return {
+        state,
+        runtimes: Object.values(runtimes),
+        done,
+        stop: (reason) => controller.abort(reason),
+        kill: killProcessGroups,
+    };
+}
+//# sourceMappingURL=run.js.map

package/dist/app/run.js.map

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

package/dist/app/runs.d.ts

@@ -0,0 +1,36 @@
+import type { RunEvent, RunState } from "../engine/types.js";
+import type { Factory } from "../system/factory.js";
+export { UnknownRunError } from "../system/store.js";
+/** A run, or why it cannot be read. */
+export type RunEntry = {
+    id: string;
+    state: RunState;
+} | {
+    id: string;
+    error: string;
+};
+/** The repository's runs in creation order; an unreadable run comes with its error. */
+export declare function listRuns(factory: Factory): Promise<RunEntry[]>;
+/** A run as a list shows it; a cost no agent announced is unknown (`null`), not zero. */
+export declare function summarizeRun(state: RunState): {
+    id: string;
+    workflow: string;
+    status: "completed" | "failed" | "running";
+    stage: string;
+    durationMs: number | null;
+    costUsd: number | null;
+    /** Some agent call announced no usage. */
+    partial: boolean;
+    updatedAt: string;
+};
+/** One run's state; an unknown ID is refused. */
+export declare function loadRun(factory: Factory, id: string): Promise<RunState>;
+/** One run's stage and journal events, in order. */
+export declare function loadRunEvents(factory: Factory, id: string): Promise<RunEvent[]>;
+/**
+ * A run's result lines: its workflow's rendering, or its validated data when the
+ * workflow left `factory.ts`. A failing rendering becomes the explanation.
+ */
+export declare function presentResult(factory: Factory, state: Readonly<RunState>): string[];
+/** Each correction route's maximum, keyed `<stage>.<outcome>` like a run's counters. */
+export declare function retryMaximums(factory: Factory, workflow: string): Map<string, number>;

package/dist/app/runs.js

@@ -0,0 +1,66 @@
+import { elapsedMs } from "../engine/metrics.js";
+import { presentData } from "../engine/workflow.js";
+import { FileRunStore } from "../system/store.js";
+export { UnknownRunError } from "../system/store.js";
+const message = (error) => error instanceof Error ? error.message : String(error);
+/** The repository's runs in creation order; an unreadable run comes with its error. */
+export async function listRuns(factory) {
+    const entries = [];
+    for (const id of await FileRunStore.list(factory.runsDir))
+        try {
+            entries.push({
+                id,
+                state: await new FileRunStore(factory.runsDir, id).load(),
+            });
+        }
+        catch (error) {
+            entries.push({ id, error: message(error) });
+        }
+    return entries;
+}
+/** A run as a list shows it; a cost no agent announced is unknown (`null`), not zero. */
+export function summarizeRun(state) {
+    const usage = state.metrics?.usage;
+    return {
+        id: state.id,
+        workflow: state.workflow,
+        status: state.status,
+        stage: state.stage,
+        durationMs: elapsedMs(state),
+        costUsd: usage?.responses ? usage.costUsd : null,
+        /** Some agent call announced no usage. */
+        partial: Boolean(usage?.missing),
+        updatedAt: state.updatedAt,
+    };
+}
+/** One run's state; an unknown ID is refused. */
+export async function loadRun(factory, id) {
+    return new FileRunStore(factory.runsDir, id).load();
+}
+/** One run's stage and journal events, in order. */
+export async function loadRunEvents(factory, id) {
+    return new FileRunStore(factory.runsDir, id).events();
+}
+/**
+ * A run's result lines: its workflow's rendering, or its validated data when the
+ * workflow left `factory.ts`. A failing rendering becomes the explanation.
+ */
+export function presentResult(factory, state) {
+    try {
+        const workflow = factory.workflows.get(state.workflow);
+        return workflow ? workflow.presentResult(state) : presentData(state);
+    }
+    catch (error) {
+        return [`Result unavailable: ${message(error)}`];
+    }
+}
+/** Each correction route's maximum, keyed `<stage>.<outcome>` like a run's counters. */
+export function retryMaximums(factory, workflow) {
+    const found = new Map();
+    for (const [name, node] of Object.entries(factory.workflows.get(workflow)?.nodes ?? {}))
+        for (const [outcome, edge] of Object.entries(node.on))
+            if (edge && typeof edge === "object")
+                found.set(`${name}.${outcome}`, edge.max);
+    return found;
+}
+//# sourceMappingURL=runs.js.map

package/dist/app/runs.js.map

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

package/dist/cli/application.d.ts

@@ -0,0 +1,6 @@
+/**
+ * The command run by the core installed in `.factory/`: the global `factory`
+ * calls it with the arguments it received and the `.factory/` it found. This
+ * contract only changes with a major version.
+ */
+export declare function main(argv: string[], directory: string): Promise<number>;