@clemrig/factory 0.0.0-stage → 0.1.0

package/dist/engine/types.d.ts

@@ -0,0 +1,194 @@
+import type { z } from "zod";
+import type { AgentUsage, RunMetrics, TokenCounts } from "./metrics.js";
+import type { AgentProfile, ResolvedProfile, Runtime } from "./profiles.js";
+export type StageKind = "AGENT" | "CODE" | "GATE";
+/** What an agent stage asks of the agent runtime. */
+export interface AgentRequest {
+    /** The stage's profile as declared; the runtime validates it and applies its defaults. */
+    profile: AgentProfile;
+    /** Name of the prompt file the runtime appends to its system prompt. */
+    prompt: string;
+    /** The run-local conversation the request continues. */
+    session: string;
+    context: unknown;
+    schema: Record<string, unknown>;
+}
+/** Adds a message to the run journal: events.jsonl, terminal and --json. */
+export type Log = (message: string, data?: Record<string, unknown>) => void;
+/** What an agent call does, as its runtime reports it; never the messages themselves. */
+export type AgentActivity = {
+    kind: "call";
+    status: "started";
+    runtime: Runtime;
+    model: string;
+    session: string;
+} | {
+    kind: "call";
+    status: "completed" | "failed";
+    runtime: Runtime;
+    /** As the runtime announced it at the end of the call: the call's own, or its session's total. */
+    usage?: AgentUsage;
+    scope?: "call" | "session";
+} | {
+    kind: "tool";
+    id: string;
+    name: string;
+    status: "started";
+} | {
+    kind: "tool";
+    id: string;
+    name: string;
+    status: "completed" | "failed";
+    durationMs: number;
+} | {
+    kind: "response";
+    tokens: TokenCounts;
+    costUsd?: number;
+    /** Reported while the call runs and replaced by the figures announced at its end. */
+    provisional: boolean;
+} | {
+    kind: "warning";
+    message: string;
+};
+/** Records an agent call's activity under the calling stage. */
+export type RecordActivity = (activity: AgentActivity) => void;
+/** Agent execution managed by the core runtime; `record` journals its activity under the calling stage. */
+export interface AgentPort {
+    execute(request: AgentRequest, record?: RecordActivity): Promise<unknown>;
+}
+export interface RunState {
+    /** 4 since workflows declare their inputs, agent profiles and retry maximums. */
+    version: 4;
+    id: string;
+    workflow: string;
+    /** Options validated by the workflow's input object. */
+    input: Record<string, unknown>;
+    stage: string;
+    status: "running" | "completed" | "failed";
+    /** Validated values written by the workflow's stages. */
+    data: Record<string, unknown>;
+    /** Owned by the engine: untrusted output of the last agent, cleared when a gate accepts. */
+    output?: unknown;
+    /** Owned by the engine: correction routed by the last retry edge, cleared when a gate accepts. */
+    feedback?: unknown;
+    /** Corrections taken per retry edge, keyed `<stage>.<outcome>`. */
+    retries?: Record<string, number>;
+    error?: string;
+    createdAt: string;
+    updatedAt: string;
+    metrics?: RunMetrics;
+    /** Each runtime the run used, with its version and connection, as checked before it started. */
+    runtimes?: Partial<Record<Runtime, string>>;
+}
+export interface WorkflowDecision {
+    verdict: "accepted" | "correction";
+    reason: string;
+    destination: string | null;
+}
+/** What a stage receives: its run, the agent runtime, the run journal and the repository. */
+export interface StageContext {
+    state: Readonly<RunState>;
+    agent: AgentPort;
+    log: Log;
+    /** The repository the workflow works in: the directory that contains `.factory/`. */
+    dir: string;
+}
+/** A stage reports a named outcome; the workflow graph decides where it leads. */
+export interface StageResult<O extends string = string> {
+    outcome: O;
+    /** Why this outcome was chosen; becomes the decision reason. */
+    reason?: string;
+    /** Correction carried by a retry edge to the next stage; defaults to the reason. */
+    feedback?: unknown;
+    /** Validated values merged into the run's data. */
+    data?: Record<string, unknown>;
+    /** Untrusted agent output, kept for the next gate. */
+    output?: unknown;
+    detail?: string;
+}
+/** What an agent stage declares, checked by `defineWorkflow`. */
+export interface AgentDeclaration {
+    profile: AgentProfile;
+    /** Prompt file `prompts/<prompt>.md`; defaults to the stage name. */
+    prompt?: string;
+    /** Conversation name; defaults to the stage name. */
+    session?: string | ((state: Readonly<RunState>) => string);
+}
+export interface Stage<O extends string = string> {
+    kind: StageKind;
+    outcomes: readonly O[];
+    agent?: AgentDeclaration;
+    run: (context: StageContext) => Promise<StageResult<O>>;
+}
+/** A correction route, taken at most `max` times per run. */
+export interface RetryEdge {
+    to: string;
+    max: number;
+}
+/** Next stage name, END (null) or a bounded correction route. */
+export type Edge = string | null | RetryEdge;
+export interface WorkflowNode<O extends string = string> {
+    stage: Stage<O>;
+    on: Record<O, Edge>;
+}
+/** What a workflow author writes: inputs, graph and an optional rendering. */
+export interface WorkflowDefinition {
+    /** Also names the workflow's folder, which holds its `prompts/`. */
+    name: string;
+    /** Each field becomes a `--<name>` option of `factory run`. */
+    input?: z.ZodObject;
+    initial: string;
+    nodes: Record<string, WorkflowNode>;
+    /** Fails a run once its agents' announced cost exceeds it; `--max-cost-usd` replaces it for a run. */
+    maxCostUsd?: number;
+    /** Result lines; by default the run's validated data as JSON. */
+    presentResult?(state: Readonly<RunState>): string[];
+}
+/** An agent stage as `defineWorkflow` resolves it. */
+export interface AgentStage {
+    profile: ResolvedProfile;
+    prompt: string;
+}
+/** A workflow validated by `defineWorkflow`. */
+export interface Workflow extends WorkflowDefinition {
+    /** Agent stages by stage name. */
+    agents: Record<string, AgentStage>;
+    presentResult(state: Readonly<RunState>): string[];
+}
+export interface RetryContext {
+    /** The retry edge, `<stage>.<outcome>`. */
+    key: string;
+    count: number;
+    max: number;
+}
+interface EventBase {
+    runId: string;
+    stage: string;
+    kind: StageKind;
+    at: string;
+}
+/** Recorded by the engine when a stage starts and when it ends. */
+export interface StageEvent extends EventBase {
+    type: "stage";
+    status: "started" | "passed" | "failed" | "completed";
+    retry?: RetryContext;
+    decision?: WorkflowDecision;
+    detail?: string;
+}
+/** Recorded by a stage, or by the agent runtime on its behalf, while it runs. */
+export interface LogEvent extends EventBase {
+    type: "log";
+    message: string;
+    data?: Record<string, unknown>;
+}
+/** Recorded by the agent runtime for the calling stage while it runs. */
+export interface AgentEvent extends EventBase {
+    type: "agent";
+    activity: AgentActivity;
+}
+export type RunEvent = StageEvent | LogEvent | AgentEvent;
+export interface RunStore {
+    save(state: RunState): Promise<void>;
+    event(event: RunEvent): Promise<void>;
+}
+export {};

package/dist/engine/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/engine/types.js.map

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

package/dist/engine/workflow.d.ts

@@ -0,0 +1,18 @@
+import { z } from "zod";
+import type { RunState, Workflow, WorkflowDefinition } from "./types.js";
+/** True for a workflow returned by `defineWorkflow`. */
+export declare function isWorkflow(value: unknown): value is Workflow;
+/** By default a run shows its validated data, never raw agent output. */
+export declare function presentData(state: Readonly<RunState>): string[];
+/**
+ * Validates a workflow when it is declared: graph, retry maximums, loops, agent
+ * stages and inputs. Agent profiles are returned with their defaults applied.
+ */
+export declare function defineWorkflow(definition: WorkflowDefinition): Workflow;
+/** Whether a field takes an option given alone: a boolean, possibly optional or defaulted. */
+export declare function isFlag(schema: z.ZodType): boolean;
+/**
+ * Validates `factory run` options against the workflow's input object. An option
+ * given without a value is `true`, accepted only by a boolean field.
+ */
+export declare function parseInput(workflow: Pick<Workflow, "name" | "input">, options: Record<string, string | boolean>): Record<string, unknown>;

package/dist/engine/workflow.js

@@ -0,0 +1,196 @@
+import { z } from "zod";
+import { profileSchema } from "./profiles.js";
+/** Workflow and prompt names name files and directories. */
+const FILE_NAME = /^[a-zA-Z0-9][a-zA-Z0-9_-]*$/;
+/** A session name is a segment of session file names: it starts and ends alphanumeric. */
+const SESSION = /^[a-zA-Z0-9](?:[a-zA-Z0-9_-]*[a-zA-Z0-9])?$/;
+const OPTION = /^[a-zA-Z][a-zA-Z0-9_-]*$/;
+const GLOBAL_OPTIONS = ["json", "help", "max-cost-usd"];
+const defined = new WeakSet();
+/** True for a workflow returned by `defineWorkflow`. */
+export function isWorkflow(value) {
+    return typeof value === "object" && value !== null && defined.has(value);
+}
+function graphProblems(definition) {
+    const { nodes, initial } = definition;
+    const problems = [];
+    const exists = (name) => Object.hasOwn(nodes, name);
+    if (!exists(initial))
+        problems.push(`initial stage ${initial} is not defined`);
+    for (const [name, node] of Object.entries(nodes)) {
+        // A correction counter is named `<stage>.<outcome>`.
+        if (name.includes("."))
+            problems.push(`stage ${name} must not contain "."`);
+        for (const outcome of node.stage.outcomes)
+            if (outcome.includes("."))
+                problems.push(`${name}: outcome ${outcome} must not contain "."`);
+        const routed = Object.keys(node.on);
+        for (const outcome of node.stage.outcomes)
+            if (!routed.includes(outcome))
+                problems.push(`${name}: outcome ${outcome} has no route`);
+        for (const outcome of routed) {
+            if (!node.stage.outcomes.includes(outcome))
+                problems.push(`${name}: route for unknown outcome ${outcome}`);
+            const edge = node.on[outcome];
+            if (edge === null || edge === undefined)
+                continue;
+            const target = typeof edge === "string" ? edge : edge.to;
+            if (!exists(target))
+                problems.push(`${name}.${outcome}: unknown target ${target}`);
+            if (typeof edge === "object" &&
+                !(Number.isInteger(edge.max) && edge.max >= 1 && edge.max <= 100))
+                problems.push(`${name}.${outcome}: retry maximum must be an integer from 1 to 100, got ${edge.max}`);
+        }
+    }
+    const loop = loopWithoutRetry(nodes);
+    if (loop)
+        problems.push(`loop without retry: ${loop.join(" → ")}`);
+    return problems;
+}
+/** A cycle of plain routes: nothing would bound how often it runs. */
+function loopWithoutRetry(nodes) {
+    const done = new Set();
+    const path = [];
+    const visit = (name) => {
+        if (done.has(name))
+            return undefined;
+        const start = path.indexOf(name);
+        if (start >= 0)
+            return [...path.slice(start), name];
+        path.push(name);
+        for (const edge of Object.values(nodes[name]?.on ?? {}))
+            if (typeof edge === "string" && Object.hasOwn(nodes, edge)) {
+                const loop = visit(edge);
+                if (loop)
+                    return loop;
+            }
+        path.pop();
+        done.add(name);
+        return undefined;
+    };
+    for (const name of Object.keys(nodes)) {
+        const loop = visit(name);
+        if (loop)
+            return loop;
+    }
+    return undefined;
+}
+/** Each agent stage: profile, prompt name and session name. */
+function agentProblems(definition, agents) {
+    const problems = [];
+    /** Stages by fixed session name, to keep each conversation on one runtime. */
+    const sessions = new Map();
+    for (const [name, node] of Object.entries(definition.nodes)) {
+        const declared = node.stage.agent;
+        if (!declared)
+            continue;
+        const prompt = declared.prompt ?? name;
+        if (!FILE_NAME.test(prompt))
+            problems.push(`${name}: prompt name ${prompt} must be letters, digits, - or _`);
+        const { session } = declared;
+        if (typeof session !== "function" && !SESSION.test(session ?? name))
+            problems.push(`${name}: session ${session ?? `${name} (the stage name by default)`} must start and end with a letter or digit and contain only letters, digits, - or _`);
+        const parsed = profileSchema.safeParse(declared.profile);
+        if (!parsed.success) {
+            for (const issue of parsed.error.issues)
+                problems.push(`${name}.profile${issue.path.map((key) => `.${String(key)}`).join("")}: ${issue.message}`);
+            continue;
+        }
+        agents[name] = { profile: parsed.data, prompt };
+        if (typeof session !== "function") {
+            const fixed = session ?? name;
+            sessions.set(fixed, [...(sessions.get(fixed) ?? []), name]);
+        }
+    }
+    for (const [session, stages] of sessions) {
+        const runtimes = new Set(stages.map((stage) => agents[stage]?.profile.runtime));
+        if (runtimes.size > 1)
+            problems.push(`session ${session} is used by stages on different runtimes: ${stages.map((stage) => `${stage} (${agents[stage]?.profile.runtime})`).join(", ")}`);
+    }
+    return problems;
+}
+function inputProblems(input) {
+    if (input === undefined)
+        return [];
+    if (!(input instanceof z.ZodObject))
+        return ["input must be a z.object"];
+    return Object.keys(input.shape).flatMap((name) => GLOBAL_OPTIONS.includes(name)
+        ? [`input ${name} conflicts with the global --${name} option`]
+        : OPTION.test(name)
+            ? []
+            : [`input ${name} is not a valid option name`]);
+}
+/** By default a run shows its validated data, never raw agent output. */
+export function presentData(state) {
+    return [JSON.stringify(state.data, null, 2)];
+}
+/**
+ * Validates a workflow when it is declared: graph, retry maximums, loops, agent
+ * stages and inputs. Agent profiles are returned with their defaults applied.
+ */
+export function defineWorkflow(definition) {
+    if (!FILE_NAME.test(definition.name))
+        throw new Error(`Invalid workflow ${definition.name}: name must be letters, digits, - or _`);
+    const agents = {};
+    const { maxCostUsd } = definition;
+    const problems = [
+        ...(maxCostUsd === undefined ||
+            (typeof maxCostUsd === "number" &&
+                Number.isFinite(maxCostUsd) &&
+                maxCostUsd > 0)
+            ? []
+            : [
+                `maxCostUsd must be a positive number of USD, got ${String(maxCostUsd)}`,
+            ]),
+        ...graphProblems(definition),
+        ...agentProblems(definition, agents),
+        ...inputProblems(definition.input),
+    ];
+    if (problems.length)
+        throw new Error(`Invalid workflow ${definition.name}: ${problems.join("; ")}`);
+    const workflow = {
+        ...definition,
+        agents,
+        presentResult: definition.presentResult ?? presentData,
+    };
+    defined.add(workflow);
+    return workflow;
+}
+/** Whether a field takes an option given alone: a boolean, possibly optional or defaulted. */
+export function isFlag(schema) {
+    let def = schema.def;
+    while (def.innerType &&
+        ["optional", "nullable", "default"].includes(def.type))
+        def = def.innerType.def;
+    return def.type === "boolean";
+}
+/**
+ * Validates `factory run` options against the workflow's input object. An option
+ * given without a value is `true`, accepted only by a boolean field.
+ */
+export function parseInput(workflow, options) {
+    const input = workflow.input ?? z.object({});
+    const shape = input.shape;
+    const valueless = Object.keys(options).filter((name) => {
+        const field = Object.hasOwn(shape, name) ? shape[name] : undefined;
+        return options[name] === true && field !== undefined && !isFlag(field);
+    });
+    const given = Object.fromEntries(Object.entries(options).filter(([name]) => !valueless.includes(name)));
+    const parsed = input.strict().safeParse(given);
+    if (parsed.success && !valueless.length)
+        return parsed.data;
+    const issues = parsed.success ? [] : parsed.error.issues;
+    const problems = valueless.map((name) => `--${name}: missing value`);
+    problems.push(...issues.flatMap((issue) => {
+        if (issue.code === "unrecognized_keys")
+            return issue.keys.map((key) => `unknown option --${key}`);
+        const name = String(issue.path[0] ?? "");
+        if (valueless.includes(name))
+            return [];
+        return Object.hasOwn(options, name)
+            ? [`--${name}: ${issue.message}`]
+            : [`missing option --${name}`];
+    }));
+    throw new Error(`Invalid input for ${workflow.name}: ${problems.join("; ")}`);
+}
+//# sourceMappingURL=workflow.js.map

package/dist/engine/workflow.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Public API for writing workflows. A repository's `.factory/` imports only this
+ * module; `z` is re-exported so workflows and the core share one Zod instance.
+ */
+export { z } from "zod";
+export type { AgentProfile } from "./engine/profiles.js";
+export { agent, type Check, code, END, gate, node, pick, retry, schemaGate, step, } from "./engine/primitives.js";
+export type { Log, RunState, Stage, StageContext, StageResult, WorkflowDefinition, } from "./engine/types.js";
+export { defineWorkflow } from "./engine/workflow.js";
+export { ProcessInterruptedError, runProcess } from "./system/process.js";

package/dist/index.js

@@ -0,0 +1,9 @@
+/**
+ * Public API for writing workflows. A repository's `.factory/` imports only this
+ * module; `z` is re-exported so workflows and the core share one Zod instance.
+ */
+export { z } from "zod";
+export { agent, code, END, gate, node, pick, retry, schemaGate, step, } from "./engine/primitives.js";
+export { defineWorkflow } from "./engine/workflow.js";
+export { ProcessInterruptedError, runProcess } from "./system/process.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EACL,KAAK,EAEL,IAAI,EACJ,GAAG,EACH,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,KAAK,EACL,UAAU,EACV,IAAI,GACL,MAAM,wBAAwB,CAAC;AAShC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,uBAAuB,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/main.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/main.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { launch } from "./cli/launcher.js";
+process.exitCode = await launch(process.argv.slice(2), process.cwd());
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,OAAO,CAAC,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC"}

package/dist/system/environment.d.ts

@@ -0,0 +1,2 @@
+/** Optional `.factory/.env` secrets; existing shell variables retain precedence. */
+export declare function loadLocalEnvironment(factoryDir: string): void;

package/dist/system/environment.js

@@ -0,0 +1,13 @@
+import { join } from "node:path";
+import { loadEnvFile } from "node:process";
+/** Optional `.factory/.env` secrets; existing shell variables retain precedence. */
+export function loadLocalEnvironment(factoryDir) {
+    try {
+        loadEnvFile(join(factoryDir, ".env"));
+    }
+    catch (error) {
+        if (error.code !== "ENOENT")
+            throw new Error(`Cannot load .env from ${factoryDir}`);
+    }
+}
+//# sourceMappingURL=environment.js.map

package/dist/system/environment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.js","sourceRoot":"","sources":["../../src/system/environment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,oFAAoF;AACpF,MAAM,UAAU,oBAAoB,CAAC,UAAkB;IACrD,IAAI,CAAC;QACH,WAAW,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;IACxC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;YACpD,MAAM,IAAI,KAAK,CAAC,yBAAyB,UAAU,EAAE,CAAC,CAAC;IAC3D,CAAC;AACH,CAAC"}

package/dist/system/factory.d.ts

@@ -0,0 +1,16 @@
+import type { Workflow } from "../engine/types.js";
+/** A repository's `.factory/`: its workflows, where they work and where runs are kept. */
+export interface Factory {
+    /** The repository: the directory that contains `.factory/`. */
+    dir: string;
+    factoryDir: string;
+    runsDir: string;
+    workflows: Map<string, Workflow>;
+}
+/** A factory without workflows, to read runs when `factory.ts` cannot load. */
+export declare function emptyFactory(factoryDir: string): Factory;
+/** Imports `.factory/factory.ts`, whose default export lists the repository's workflows. */
+export declare function loadFactory(factoryDir: string): Promise<Factory>;
+export declare function workflowOf(factory: Factory, name: string): Workflow;
+/** Reads `workflows/<workflow>/prompts/<name>.md` for each agent stage of the workflow, at every run. */
+export declare function loadPrompts(factoryDir: string, workflow: Workflow): Promise<Record<string, string>>;

package/dist/system/factory.js

@@ -0,0 +1,62 @@
+import { readFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { pathToFileURL } from "node:url";
+import { isWorkflow } from "../engine/workflow.js";
+/** A factory without workflows, to read runs when `factory.ts` cannot load. */
+export function emptyFactory(factoryDir) {
+    return {
+        dir: dirname(factoryDir),
+        factoryDir,
+        runsDir: join(factoryDir, "runs"),
+        workflows: new Map(),
+    };
+}
+/** Imports `.factory/factory.ts`, whose default export lists the repository's workflows. */
+export async function loadFactory(factoryDir) {
+    const module = (await import(pathToFileURL(join(factoryDir, "factory.ts")).href));
+    const exported = module.default;
+    if (!Array.isArray(exported))
+        throw new Error("factory.ts must export default an array of defineWorkflow(…) results");
+    const workflows = new Map();
+    for (const workflow of exported) {
+        if (!isWorkflow(workflow))
+            throw new Error("factory.ts must export default an array of defineWorkflow(…) results");
+        if (workflows.has(workflow.name))
+            throw new Error(`Duplicate workflow ${workflow.name} in factory.ts`);
+        workflows.set(workflow.name, workflow);
+    }
+    return { ...emptyFactory(factoryDir), workflows };
+}
+export function workflowOf(factory, name) {
+    const workflow = factory.workflows.get(name);
+    if (!workflow)
+        throw new Error(`Unknown workflow ${name}; workflows: ${[...factory.workflows.keys()].join(", ") || "none"}`);
+    return workflow;
+}
+/** Reads `workflows/<workflow>/prompts/<name>.md` for each agent stage of the workflow, at every run. */
+export async function loadPrompts(factoryDir, workflow) {
+    const prompts = {};
+    const problems = [];
+    for (const { prompt: name } of Object.values(workflow.agents)) {
+        if (Object.hasOwn(prompts, name))
+            continue;
+        const file = join(factoryDir, "workflows", workflow.name, "prompts", `${name}.md`);
+        let text;
+        try {
+            text = await readFile(file, "utf8");
+        }
+        catch (error) {
+            if (error.code !== "ENOENT")
+                throw error;
+            problems.push(`Missing prompt: ${file}`);
+            continue;
+        }
+        if (!text.trim())
+            problems.push(`Empty prompt: ${file}`);
+        prompts[name] = text.trimEnd();
+    }
+    if (problems.length)
+        throw new Error(problems.join("; "));
+    return prompts;
+}
+//# sourceMappingURL=factory.js.map

package/dist/system/factory.js.map

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

package/dist/system/process.d.ts

@@ -0,0 +1,21 @@
+export declare class ProcessStartError extends Error {
+    constructor(executable: string, cause: Error);
+}
+export declare class ProcessInterruptedError extends Error {
+    constructor(signal: NodeJS.Signals, executable: string);
+}
+/** Kills every running child's process group at once, before a forced exit. */
+export declare function killProcessGroups(): void;
+/** Runs `work` with `dir` as the process's working directory, then restores the previous one. */
+export declare function inDirectory<T>(dir: string, work: () => Promise<T>): Promise<T>;
+/**
+ * Runs an executable without a shell. A failure terminates the entire child group
+ * and settles only after the child closes and the TERM→KILL grace period finishes.
+ */
+export declare function runProcess(command: string[], cwd: string, timeoutMs: number, onLine?: (line: string) => void, stdin?: string): Promise<{
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+    stdoutTruncated: boolean;
+    stderrTruncated: boolean;
+}>;