@clemrig/factory 0.1.0 → 0.2.1

package/dist/engine/workflow.d.ts

@@ -1,18 +0,0 @@
-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

@@ -1,196 +0,0 @@
-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

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

package/dist/system/process.d.ts

@@ -1,21 +0,0 @@
-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;
-}>;

package/dist/system/process.js

@@ -1,238 +0,0 @@
-import { spawn } from "node:child_process";
-const MAX_CAPTURE_BYTES = 2 * 1024 * 1024;
-const MAX_LINE_BYTES = 32 * 1024 * 1024;
-const KILL_GRACE_MS = 1_000;
-export class ProcessStartError extends Error {
-    constructor(executable, cause) {
-        super(`Could not start ${executable}: ${cause.message}`, { cause });
-        this.name = "ProcessStartError";
-    }
-}
-export class ProcessInterruptedError extends Error {
-    constructor(signal, executable) {
-        super(`Process interrupted by ${signal}: ${executable}`);
-        this.name = "ProcessInterruptedError";
-    }
-}
-class BoundedCapture {
-    #chunks = [];
-    #length = 0;
-    #dropped = false;
-    append(chunk) {
-        if (chunk.length === 0)
-            return;
-        if (chunk.length >= MAX_CAPTURE_BYTES) {
-            this.#dropped ||= this.#length > 0 || chunk.length > MAX_CAPTURE_BYTES;
-            this.#chunks = [chunk.subarray(chunk.length - MAX_CAPTURE_BYTES)];
-            this.#length = MAX_CAPTURE_BYTES;
-            return;
-        }
-        this.#chunks.push(chunk);
-        this.#length += chunk.length;
-        while (this.#length > MAX_CAPTURE_BYTES) {
-            const first = this.#chunks.shift();
-            if (!first)
-                break;
-            this.#length -= first.length;
-            this.#dropped = true;
-        }
-    }
-    get truncated() {
-        return this.#dropped;
-    }
-    text() {
-        const prefix = this.#dropped ? "[earlier process output truncated]\n" : "";
-        return prefix + Buffer.concat(this.#chunks, this.#length).toString("utf8");
-    }
-}
-function signalGroup(child, signal) {
-    if (!child.pid)
-        return;
-    if (process.platform !== "win32") {
-        try {
-            process.kill(-child.pid, signal);
-            return;
-        }
-        catch {
-            // The process group can already be gone.
-        }
-    }
-    try {
-        child.kill(signal);
-    }
-    catch {
-        // The child can already be gone.
-    }
-}
-function groupStillExists(child) {
-    if (process.platform === "win32" || !child.pid)
-        return false;
-    try {
-        process.kill(-child.pid, 0);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-/** Children still running, so that a forced exit does not leave them behind. */
-const running = new Set();
-/** Kills every running child's process group at once, before a forced exit. */
-export function killProcessGroups() {
-    for (const child of running)
-        signalGroup(child, "SIGKILL");
-}
-/** Runs `work` with `dir` as the process's working directory, then restores the previous one. */
-export async function inDirectory(dir, work) {
-    const previous = process.cwd();
-    process.chdir(dir);
-    try {
-        return await work();
-    }
-    finally {
-        process.chdir(previous);
-    }
-}
-/**
- * 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 async function runProcess(command, cwd, timeoutMs, onLine, stdin) {
-    if (command.length === 0 || !command[0])
-        throw new Error("Process command must include an executable");
-    if (!Number.isFinite(timeoutMs) || timeoutMs <= 0)
-        throw new Error("Process timeout must be positive");
-    const executable = command[0];
-    return new Promise((resolve, reject) => {
-        const child = spawn(executable, command.slice(1), {
-            cwd,
-            detached: process.platform !== "win32",
-            shell: false,
-            stdio: [stdin === undefined ? "ignore" : "pipe", "pipe", "pipe"],
-        });
-        running.add(child);
-        const stdout = new BoundedCapture();
-        const stderr = new BoundedCapture();
-        let pending = Buffer.alloc(0);
-        let failure;
-        let closeResult;
-        let terminating = false;
-        let killSent = false;
-        let killTimer;
-        let settled = false;
-        const onParentSignal = (signal) => {
-            requestTermination(new ProcessInterruptedError(signal, executable));
-        };
-        const cleanup = () => {
-            running.delete(child);
-            clearTimeout(timeout);
-            if (killTimer)
-                clearTimeout(killTimer);
-            process.removeListener("SIGINT", onParentSignal);
-            process.removeListener("SIGTERM", onParentSignal);
-        };
-        const settle = () => {
-            if (settled || !closeResult || (terminating && !killSent))
-                return;
-            settled = true;
-            cleanup();
-            if (failure) {
-                reject(failure);
-                return;
-            }
-            resolve({
-                exitCode: closeResult.code ?? (closeResult.signal ? 1 : 0),
-                stdout: stdout.text(),
-                stderr: stderr.text(),
-                stdoutTruncated: stdout.truncated,
-                stderrTruncated: stderr.truncated,
-            });
-        };
-        const sendKill = () => {
-            killTimer = undefined;
-            killSent = true;
-            signalGroup(child, "SIGKILL");
-            settle();
-        };
-        const requestTermination = (error) => {
-            if (!failure || error instanceof ProcessInterruptedError)
-                failure = error;
-            if (terminating)
-                return;
-            terminating = true;
-            signalGroup(child, "SIGTERM");
-            killTimer = setTimeout(sendKill, KILL_GRACE_MS);
-        };
-        const timeout = setTimeout(() => {
-            requestTermination(new Error(`Process timed out after ${timeoutMs}ms: ${executable}`));
-        }, timeoutMs);
-        timeout.unref();
-        process.once("SIGINT", onParentSignal);
-        process.once("SIGTERM", onParentSignal);
-        child.once("error", (error) => {
-            requestTermination(new ProcessStartError(executable, error));
-        });
-        if (stdin !== undefined) {
-            if (!child.stdin)
-                requestTermination(new Error("Process stdin is unavailable"));
-            else {
-                child.stdin.once("error", (error) => {
-                    requestTermination(new Error(`Could not write process stdin: ${error.message}`, {
-                        cause: error,
-                    }));
-                });
-                child.stdin.end(stdin);
-            }
-        }
-        if (!child.stdout || !child.stderr)
-            requestTermination(new Error("Process output streams are unavailable"));
-        child.stdout?.on("data", (chunk) => {
-            stdout.append(chunk);
-            if (!onLine || failure)
-                return;
-            pending = Buffer.concat([pending, chunk]);
-            while (!failure) {
-                const newline = pending.indexOf(0x0a);
-                if (newline < 0)
-                    break;
-                const line = pending
-                    .subarray(0, newline)
-                    .toString("utf8")
-                    .replace(/\r$/, "");
-                pending = pending.subarray(newline + 1);
-                if (Buffer.byteLength(line) > MAX_LINE_BYTES) {
-                    requestTermination(new Error(`Process output line exceeded ${MAX_LINE_BYTES} byte limit`));
-                    break;
-                }
-                try {
-                    onLine(line);
-                }
-                catch (error) {
-                    requestTermination(error instanceof Error ? error : new Error(String(error)));
-                }
-            }
-            if (!failure && pending.length > MAX_LINE_BYTES)
-                requestTermination(new Error(`Process output line exceeded ${MAX_LINE_BYTES} byte limit`));
-        });
-        child.stderr?.on("data", (chunk) => stderr.append(chunk));
-        child.once("close", (code, signal) => {
-            closeResult = { code, signal };
-            if (!failure && groupStillExists(child))
-                requestTermination(new Error(`Process group remained after ${executable} exited`));
-            if (!failure && onLine && pending.length > 0) {
-                if (pending.length > MAX_LINE_BYTES)
-                    requestTermination(new Error(`Process output line exceeded ${MAX_LINE_BYTES} byte limit`));
-                else {
-                    try {
-                        onLine(pending.toString("utf8").replace(/\r$/, ""));
-                    }
-                    catch (error) {
-                        requestTermination(error instanceof Error ? error : new Error(String(error)));
-                    }
-                }
-            }
-            settle();
-        });
-    });
-}
-//# sourceMappingURL=process.js.map

package/dist/system/process.js.map

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

package/dist/system/runtimes/adapter.d.ts

@@ -1,90 +0,0 @@
-import type { z } from "zod";
-import type { AgentUsage, TokenCounts } from "../../engine/metrics.js";
-import type { ResolvedProfile, Runtime } from "../../engine/profiles.js";
-/** A runtime's profile, with its defaults applied. */
-export type ProfileOf<R extends Runtime> = Extract<ResolvedProfile, {
-    runtime: R;
-}>;
-/** One agent call, as a runtime prepares it. */
-export interface RuntimeCall<R extends Runtime> {
-    profile: ProfileOf<R>;
-    /** The workflow's prompt, appended to the runtime's own system prompt. */
-    systemPrompt: string;
-    /** The conversation within the run. */
-    session: string;
-    /** The run, and the directory where it keeps this runtime's sessions. */
-    sessions: {
-        runId: string;
-        directory: string;
-    };
-}
-/** What an output line of a runtime means for the call, the same for every runtime. */
-export type RuntimeEvent = {
-    type: "tool";
-    id: string;
-    name: string;
-    status: "started" | "completed" | "failed";
-}
-/** A model response's tokens as the call goes, before the figures announced at its end. */
- | {
-    type: "response";
-    tokens: TokenCounts;
-}
-/**
- * A measure as the runtime announces it: one response's final figures, or its
- * session's total so far; `undefined` when nothing measurable was announced.
- */
- | {
-    type: "usage";
-    scope: "response" | "session";
-    usage: AgentUsage | undefined;
-}
-/** A customization of the session that does not change what the agent can do. */
- | {
-    type: "warning";
-    message: string;
-}
-/** The runtime reported that the call failed: it stops there. */
- | {
-    type: "failure";
-    message: string;
-}
-/** The agent's final text. */
- | {
-    type: "result";
-    text: string;
-};
-/** A prepared call: the arguments after the executable, and the reader of its output. */
-export interface RuntimeProcess {
-    args: string[];
-    /** Reads one parsed output line; throws on output the adapter cannot rely on. */
-    read(event: unknown): RuntimeEvent[];
-}
-/** The connection a profile would use: connected or not, and which one, never the account. */
-export interface Connection {
-    connected: boolean;
-    detail: string;
-}
-/** What factory needs from an agent runtime. */
-export interface RuntimeAdapter<R extends Runtime> {
-    name: R;
-    /** As the operator reads it. */
-    label: string;
-    /** Found in the PATH. */
-    executable: string;
-    /** The oldest version validated by a real call; `--version` prints it first. */
-    minimumVersion: string;
-    /** The command that reports a profile's connection without a provider request, and how to read its output. */
-    connection(profile: ProfileOf<R>): {
-        args: string[];
-        read(stdout: string): Connection;
-    };
-    /** The model a call is recorded with. */
-    model(profile: ProfileOf<R>): string;
-    start(call: RuntimeCall<R>): Promise<RuntimeProcess>;
-}
-/**
- * An output event the adapter relies on, validated: a missing or malformed field
- * stops the call with the event and the field, rather than being misread.
- */
-export declare function parseEvent<T>(label: string, schema: z.ZodType<T>, event: unknown): T;

package/dist/system/runtimes/adapter.js

@@ -1,20 +0,0 @@
-/**
- * An output event the adapter relies on, validated: a missing or malformed field
- * stops the call with the event and the field, rather than being misread.
- */
-export function parseEvent(label, schema, event) {
-    const parsed = schema.safeParse(event);
-    if (parsed.success)
-        return parsed.data;
-    const type = typeof event === "object" &&
-        event !== null &&
-        "type" in event &&
-        typeof event.type === "string"
-        ? `${event.type} `
-        : "";
-    const issues = parsed.error.issues
-        .map(({ path, message }) => `${path.join(".") || "value"}: ${message}`)
-        .join("; ");
-    throw new Error(`${label} emitted an unexpected ${type}event: ${issues}`);
-}
-//# sourceMappingURL=adapter.js.map

package/dist/system/runtimes/adapter.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../src/system/runtimes/adapter.ts"],"names":[],"mappings":"AA+EA;;;GAGG;AACH,MAAM,UAAU,UAAU,CACxB,KAAa,EACb,MAAoB,EACpB,KAAc;IAEd,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACvC,IAAI,MAAM,CAAC,OAAO;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC;IACvC,MAAM,IAAI,GACR,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,MAAM,IAAI,KAAK;QACf,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;QAC5B,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,GAAG;QAClB,CAAC,CAAC,EAAE,CAAC;IACT,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM;SAC/B,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;SACtE,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,0BAA0B,IAAI,UAAU,MAAM,EAAE,CAAC,CAAC;AAC5E,CAAC"}