@clemrig/factory 0.0.0-stage → 0.1.0

package/dist/system/runtimes/pi.js

@@ -0,0 +1,235 @@
+import { z } from "zod";
+import { runtimeLabels } from "../../engine/profiles.js";
+import { parseEvent, } from "./adapter.js";
+import { agentSessionName } from "./protocol.js";
+const label = runtimeLabels.pi;
+const anyEvent = z.looseObject({ type: z.string() });
+const message = z.looseObject({
+    role: z.string(),
+    // Text content is one text part; a text part holds its text.
+    content: z
+        .preprocess((content) => typeof content === "string"
+        ? [{ type: "text", text: content }]
+        : content, z.array(z
+        .looseObject({ type: z.string(), text: z.unknown().optional() })
+        .superRefine((part, context) => {
+        if (part.type === "text" && typeof part.text !== "string")
+            context.addIssue({
+                code: "custom",
+                path: ["text"],
+                message: "expected a string",
+            });
+    })))
+        .optional(),
+    stopReason: z.string().optional(),
+    /** Only explains a failure: its shape never hides it. */
+    errorMessage: z.unknown().optional(),
+    usage: z.unknown().optional(),
+});
+const messageEnd = z.looseObject({ message });
+const compactionEnd = z.looseObject({
+    aborted: z.boolean().optional(),
+    result: z
+        .looseObject({ usage: z.unknown().optional() })
+        .nullable()
+        .optional(),
+});
+const toolStart = z.looseObject({
+    toolCallId: z.string(),
+    toolName: z.string(),
+});
+const toolEnd = toolStart.extend({
+    isError: z.boolean(),
+    result: z
+        .looseObject({ usage: z.unknown().optional() })
+        .nullable()
+        .optional(),
+});
+const agentEnd = z.looseObject({ messages: z.array(message) });
+const agentSettled = z.looseObject({ aborted: z.boolean() });
+/** Pi's usage of one response; measured on a best-effort basis. */
+const usage = z.looseObject({
+    input: z.number().nonnegative(),
+    output: z.number().nonnegative(),
+    cacheRead: z.number().nonnegative(),
+    cacheWrite: z.number().nonnegative(),
+    cost: z.looseObject({ total: z.number().nonnegative() }),
+});
+function measure(value) {
+    const parsed = usage.safeParse(value);
+    const measured = parsed.success
+        ? {
+            input: parsed.data.input,
+            output: parsed.data.output,
+            cacheRead: parsed.data.cacheRead,
+            cacheWrite: parsed.data.cacheWrite,
+            costUsd: parsed.data.cost.total,
+        }
+        : undefined;
+    return { type: "usage", scope: "response", usage: measured };
+}
+const textOf = (response) => (response.content ?? [])
+    .map((part) => (part.type === "text" ? String(part.text) : ""))
+    .join("");
+/** The final response once Pi has settled: its text, or why there is none. */
+function finalEvent(response) {
+    if (!response)
+        return {
+            type: "failure",
+            message: `${label} completed without an assistant response`,
+        };
+    if (response.stopReason === "error" || response.stopReason === "aborted")
+        return {
+            type: "failure",
+            message: `${label} provider ${response.stopReason}: ${typeof response.errorMessage === "string" ? response.errorMessage : "no detail provided"}`,
+        };
+    if (response.stopReason !== "stop")
+        return {
+            type: "failure",
+            message: `${label} final response ended with stop reason ${response.stopReason ?? "missing"}`,
+        };
+    return { type: "result", text: textOf(response) };
+}
+/** `pi auth check --json`: whether a provider's credentials are ready, never the credentials. */
+const authCheck = z.looseObject({
+    status: z.string(),
+    provider: z.string().optional(),
+    authType: z.string().optional(),
+    reason: z.string().optional(),
+});
+const authTypes = {
+    oauth: "OAuth",
+    api_key: "API key",
+};
+function readAuthCheck(provider, stdout) {
+    let check;
+    try {
+        check = authCheck.parse(JSON.parse(stdout));
+    }
+    catch {
+        return {
+            connected: false,
+            detail: `${label} connection check is unreadable`,
+        };
+    }
+    return check.status === "ready"
+        ? {
+            connected: true,
+            detail: `${provider} ${authTypes[check.authType ?? ""] ?? check.authType ?? "credentials"}`,
+        }
+        : {
+            connected: false,
+            detail: `${label} is not connected to ${provider}: ${check.reason ?? check.status}`,
+        };
+}
+function profileArgs(profile, systemPrompt) {
+    return [
+        "--provider",
+        profile.provider,
+        "--model",
+        profile.model,
+        "--thinking",
+        profile.thinking,
+        "--append-system-prompt",
+        systemPrompt,
+        // Nothing from the machine: only the profile's tools, skills and extensions.
+        "--no-extensions",
+        "--no-skills",
+        "--no-context-files",
+        "--no-mcp",
+        ...(profile.tools.length
+            ? ["--tools", profile.tools.join(",")]
+            : ["--no-tools"]),
+        ...profile.skills.flatMap((skill) => ["--skill", skill]),
+        ...profile.extensions.flatMap((extension) => ["--extension", extension]),
+    ];
+}
+/**
+ * Pi in JSON mode (its documented event stream), its session named after the run.
+ * Every response is measured, retried ones included; the answer is the last
+ * response once Pi has settled, after its own retries.
+ */
+export const pi = {
+    name: "pi",
+    label,
+    executable: "pi",
+    minimumVersion: "1.1.0",
+    // --no-refresh: an expired token is reported, never refreshed.
+    connection: ({ provider }) => ({
+        args: ["auth", "check", "--provider", provider, "--json", "--no-refresh"],
+        read: (stdout) => readAuthCheck(provider, stdout),
+    }),
+    model: (profile) => `${profile.provider}/${profile.model}`,
+    async start({ profile, systemPrompt, session, sessions }) {
+        let final;
+        return {
+            args: [
+                "--mode",
+                "json",
+                "--print",
+                ...profileArgs(profile, systemPrompt),
+                "--session-id",
+                agentSessionName(sessions.runId, session),
+                "--session-dir",
+                sessions.directory,
+                "--name",
+                `${sessions.runId}:${session}`,
+                "--",
+                "Read and obey the complete factory request supplied through standard input. Return only the required JSON.",
+            ],
+            read(raw) {
+                const { type } = parseEvent(label, anyEvent, raw);
+                switch (type) {
+                    case "message_end": {
+                        const ended = parseEvent(label, messageEnd, raw).message;
+                        return ended.role === "assistant" ? [measure(ended.usage)] : [];
+                    }
+                    case "compaction_end": {
+                        const compaction = parseEvent(label, compactionEnd, raw);
+                        return compaction.aborted
+                            ? []
+                            : [measure(compaction.result?.usage)];
+                    }
+                    case "tool_execution_start": {
+                        const tool = parseEvent(label, toolStart, raw);
+                        return [
+                            {
+                                type: "tool",
+                                id: tool.toolCallId,
+                                name: tool.toolName,
+                                status: "started",
+                            },
+                        ];
+                    }
+                    case "tool_execution_end": {
+                        const tool = parseEvent(label, toolEnd, raw);
+                        // A tool that called a model reports that usage with its result.
+                        return [
+                            ...(tool.result?.usage === undefined
+                                ? []
+                                : [measure(tool.result.usage)]),
+                            {
+                                type: "tool",
+                                id: tool.toolCallId,
+                                name: tool.toolName,
+                                status: tool.isError ? "failed" : "completed",
+                            },
+                        ];
+                    }
+                    case "agent_end": {
+                        // After its own retries, Pi settles on the last run's response.
+                        final = parseEvent(label, agentEnd, raw).messages.findLast(({ role }) => role === "assistant");
+                        return [];
+                    }
+                    case "agent_settled":
+                        return parseEvent(label, agentSettled, raw).aborted
+                            ? [{ type: "failure", message: `${label} run was aborted` }]
+                            : [finalEvent(final)];
+                    default:
+                        return [];
+                }
+            },
+        };
+    },
+};
+//# sourceMappingURL=pi.js.map

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

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

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

@@ -0,0 +1,9 @@
+/** The complete request every runtime receives through standard input. */
+export declare function agentPrompt(request: {
+    context: unknown;
+    schema: Record<string, unknown>;
+}): string;
+/** Accepts exact JSON or a single fenced JSON block, never prose surrounding a result. */
+export declare function parseAgentJson(text: string): unknown;
+/** One session per run and session name: `<run>.<session>`. */
+export declare function agentSessionName(runId: string, session: string): string;

package/dist/system/runtimes/protocol.js

@@ -0,0 +1,38 @@
+/** Output protocol shared by every runtime, sent before the factory request. */
+const outputProtocol = `# Response format
+
+- Return exactly one JSON value matching the requested schema.
+- Do not use Markdown or add prose.`;
+/** The complete request every runtime receives through standard input. */
+export function agentPrompt(request) {
+    return [
+        outputProtocol,
+        "Factory request:",
+        JSON.stringify({ context: request.context, outputSchema: request.schema }),
+    ].join("\n\n");
+}
+/** Accepts exact JSON or a single fenced JSON block, never prose surrounding a result. */
+export function parseAgentJson(text) {
+    const trimmed = text.trim();
+    const fenced = /^```(?:json)?\s*\n([\s\S]*?)\n```$/i.exec(trimmed);
+    const candidate = fenced ? (fenced[1] ?? "").trim() : trimmed;
+    if (!candidate)
+        throw new Error("Agent returned an empty final response");
+    try {
+        return JSON.parse(candidate);
+    }
+    catch (error) {
+        throw new Error(`Agent final response is not a single JSON value: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/** A session name segment: never contains the `.` separator, starts and ends alphanumeric. */
+const segment = /^[a-zA-Z0-9](?:[a-zA-Z0-9_-]*[a-zA-Z0-9])?$/;
+/** One session per run and session name: `<run>.<session>`. */
+export function agentSessionName(runId, session) {
+    if (!segment.test(runId))
+        throw new Error("Invalid run ID for agent session");
+    if (typeof session !== "string" || !segment.test(session))
+        throw new Error(`Invalid agent session name: ${String(session)}`);
+    return `${runId}.${session}`;
+}
+//# sourceMappingURL=protocol.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../../src/system/runtimes/protocol.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,MAAM,cAAc,GAAG;;;oCAGa,CAAC;AAErC,0EAA0E;AAC1E,MAAM,UAAU,WAAW,CAAC,OAG3B;IACC,OAAO;QACL,cAAc;QACd,kBAAkB;QAClB,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;KAC3E,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACjB,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,MAAM,MAAM,GAAG,qCAAqC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACnE,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;IAC9D,IAAI,CAAC,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC1E,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC/B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,oDAAoD,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAC7G,CAAC;IACJ,CAAC;AACH,CAAC;AAED,8FAA8F;AAC9F,MAAM,OAAO,GAAG,6CAA6C,CAAC;AAE9D,+DAA+D;AAC/D,MAAM,UAAU,gBAAgB,CAAC,KAAa,EAAE,OAAe;IAC7D,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IAC9E,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;QACvD,MAAM,IAAI,KAAK,CAAC,+BAA+B,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACpE,OAAO,GAAG,KAAK,IAAI,OAAO,EAAE,CAAC;AAC/B,CAAC"}

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

@@ -0,0 +1,5 @@
+/** Every runtime a profile can select, by name. */
+export declare const runtimes: {
+    readonly "claude-code": import("./adapter.js").RuntimeAdapter<"claude-code">;
+    readonly pi: import("./adapter.js").RuntimeAdapter<"pi">;
+};

package/dist/system/runtimes/registry.js

@@ -0,0 +1,5 @@
+import { claudeCode } from "./claude-code.js";
+import { pi } from "./pi.js";
+/** Every runtime a profile can select, by name. */
+export const runtimes = { "claude-code": claudeCode, pi };
+//# sourceMappingURL=registry.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/system/runtimes/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAE7B,mDAAmD;AACnD,MAAM,CAAC,MAAM,QAAQ,GAAG,EAAE,aAAa,EAAE,UAAU,EAAE,EAAE,EAAW,CAAC"}

package/dist/system/store.d.ts

@@ -0,0 +1,20 @@
+import type { RunEvent, RunState, RunStore } from "../engine/types.js";
+/** No run has this ID, or none can: unlike a read error, asking again will not find it. */
+export declare class UnknownRunError extends Error {
+    constructor(message: string);
+}
+/** A new run ID: its creation time, then a random suffix, so that IDs sort in creation order. */
+export declare function newRunId(): string;
+/** One run's directory: `state.json` and its `events.jsonl` journal. */
+export declare class FileRunStore implements RunStore {
+    readonly directory: string;
+    readonly runId: string;
+    constructor(runsDir: string, runId: string);
+    /** Run IDs in order: they start with their creation time. */
+    static list(runsDir: string): Promise<string[]>;
+    save(state: RunState): Promise<void>;
+    load(): Promise<RunState>;
+    event(event: RunEvent): Promise<void>;
+    /** Recorded events; a last line still being written is ignored. */
+    events(): Promise<RunEvent[]>;
+}

package/dist/system/store.js

@@ -0,0 +1,126 @@
+import { randomUUID } from "node:crypto";
+import { appendFile, mkdir, readdir, readFile, rename, rm, writeFile, } from "node:fs/promises";
+import { join } from "node:path";
+const isRecord = (value) => !!value && typeof value === "object" && !Array.isArray(value);
+function isRetryCounts(value) {
+    return (isRecord(value) &&
+        Object.values(value).every((count) => Number.isSafeInteger(count) && count >= 1));
+}
+const finiteNonnegative = (n) => typeof n === "number" && Number.isFinite(n) && n >= 0;
+const isUsage = (value) => isRecord(value) &&
+    ["input", "output", "cacheRead", "cacheWrite", "costUsd"].every((key) => finiteNonnegative(value[key]));
+function isRunMetrics(value) {
+    if (!isRecord(value) || !isUsage(value.usage))
+        return false;
+    const counts = value.usage;
+    return (["responses", "missing"].every((key) => Number.isSafeInteger(counts[key]) && finiteNonnegative(counts[key])) &&
+        (value.sessions === undefined ||
+            (isRecord(value.sessions) &&
+                Object.values(value.sessions).every(isUsage))));
+}
+/** Each runtime's version and connection, as text. */
+const isRuntimes = (value) => isRecord(value) &&
+    Object.values(value).every((detail) => typeof detail === "string");
+/** No run has this ID, or none can: unlike a read error, asking again will not find it. */
+export class UnknownRunError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "UnknownRunError";
+    }
+}
+/** A new run ID: its creation time, then a random suffix, so that IDs sort in creation order. */
+export function newRunId() {
+    return `${Date.now()}-${randomUUID().slice(0, 8)}`;
+}
+/** One run's directory: `state.json` and its `events.jsonl` journal. */
+export class FileRunStore {
+    directory;
+    runId;
+    constructor(runsDir, runId) {
+        if (!/^[a-zA-Z0-9][a-zA-Z0-9_-]{0,127}$/.test(runId))
+            throw new UnknownRunError("Invalid run ID");
+        this.runId = runId;
+        this.directory = join(runsDir, runId);
+    }
+    /** Run IDs in order: they start with their creation time. */
+    static async list(runsDir) {
+        try {
+            return (await readdir(runsDir, { withFileTypes: true }))
+                .filter((entry) => entry.isDirectory())
+                .map((entry) => entry.name)
+                .sort();
+        }
+        catch (error) {
+            if (error.code === "ENOENT")
+                return [];
+            throw error;
+        }
+    }
+    async save(state) {
+        if (state.id !== this.runId)
+            throw new Error("Run state ID does not match store");
+        await mkdir(this.directory, { recursive: true });
+        const temporary = join(this.directory, `state-${randomUUID()}.tmp`);
+        try {
+            await writeFile(temporary, `${JSON.stringify(state, null, 2)}\n`, {
+                mode: 0o600,
+            });
+            await rename(temporary, join(this.directory, "state.json"));
+        }
+        finally {
+            await rm(temporary, { force: true });
+        }
+    }
+    async load() {
+        let text;
+        try {
+            text = await readFile(join(this.directory, "state.json"), "utf8");
+        }
+        catch (error) {
+            if (error.code === "ENOENT")
+                throw new UnknownRunError(`Unknown run ${this.runId}`);
+            throw error;
+        }
+        const state = JSON.parse(text);
+        if (state?.version !== 4 ||
+            state.id !== this.runId ||
+            typeof state.workflow !== "string" ||
+            !state.workflow.trim() ||
+            !["running", "completed", "failed"].includes(state.status) ||
+            typeof state.stage !== "string" ||
+            typeof state.createdAt !== "string" ||
+            typeof state.updatedAt !== "string" ||
+            !isRecord(state.input) ||
+            !isRecord(state.data) ||
+            (state.retries !== undefined && !isRetryCounts(state.retries)) ||
+            (state.metrics !== undefined && !isRunMetrics(state.metrics)) ||
+            (state.runtimes !== undefined && !isRuntimes(state.runtimes)))
+            throw new Error("Unsupported or mismatched persisted run; runs created by earlier factory versions are not readable");
+        return state;
+    }
+    async event(event) {
+        if (event.runId !== this.runId)
+            throw new Error("Event run ID does not match store");
+        await mkdir(this.directory, { recursive: true });
+        await appendFile(join(this.directory, "events.jsonl"), `${JSON.stringify(event)}\n`, { mode: 0o600 });
+    }
+    /** Recorded events; a last line still being written is ignored. */
+    async events() {
+        let text;
+        try {
+            text = await readFile(join(this.directory, "events.jsonl"), "utf8");
+        }
+        catch (error) {
+            if (error.code === "ENOENT")
+                return [];
+            throw error;
+        }
+        const lines = text.split("\n");
+        // Only lines ended by a newline are complete.
+        lines.pop();
+        return lines
+            .filter((line) => line.trim())
+            .map((line) => JSON.parse(line));
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/system/store.js.map

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

package/dist/system/templates.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Creates `.factory/` in `cwd` from the package's templates, its `package.json`
+ * pinned to this core version. An existing `.factory/` is refused untouched.
+ */
+export declare function createFromTemplates(cwd: string): Promise<{
+    factoryDir: string;
+    version: string;
+}>;

package/dist/system/templates.js

@@ -0,0 +1,30 @@
+import { cp, mkdir, readFile, rename, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+/** Both `src/system/` and `dist/system/` sit two levels below the package root. */
+const root = new URL("../../", import.meta.url);
+/**
+ * Creates `.factory/` in `cwd` from the package's templates, its `package.json`
+ * pinned to this core version. An existing `.factory/` is refused untouched.
+ */
+export async function createFromTemplates(cwd) {
+    const factoryDir = join(cwd, ".factory");
+    try {
+        await mkdir(factoryDir);
+    }
+    catch (error) {
+        if (error.code === "EEXIST")
+            throw new Error(`${factoryDir} already exists`);
+        throw error;
+    }
+    const { version } = JSON.parse(await readFile(new URL("package.json", root), "utf8"));
+    await cp(new URL("templates/init/", root), factoryDir, { recursive: true });
+    // npm pack drops files named .gitignore: the template has no dot.
+    await rename(join(factoryDir, "gitignore"), join(factoryDir, ".gitignore"));
+    await writeFile(join(factoryDir, "package.json"), `${JSON.stringify({
+        private: true,
+        type: "module",
+        dependencies: { "@clemrig/factory": version },
+    }, null, 2)}\n`);
+    return { factoryDir, version };
+}
+//# sourceMappingURL=templates.js.map

package/dist/system/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/system/templates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,mFAAmF;AACnF,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,QAAQ,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;AAEhD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,GAAW;IAEX,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IACzC,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,UAAU,CAAC,CAAC;IAC1B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;YACpD,MAAM,IAAI,KAAK,CAAC,GAAG,UAAU,iBAAiB,CAAC,CAAC;QAClD,MAAM,KAAK,CAAC;IACd,CAAC;IACD,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,CAC5B,MAAM,QAAQ,CAAC,IAAI,GAAG,CAAC,cAAc,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAC/B,CAAC;IACzB,MAAM,EAAE,CAAC,IAAI,GAAG,CAAC,iBAAiB,EAAE,IAAI,CAAC,EAAE,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5E,kEAAkE;IAClE,MAAM,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,EAAE,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC;IAC5E,MAAM,SAAS,CACb,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,EAChC,GAAG,IAAI,CAAC,SAAS,CACf;QACE,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,QAAQ;QACd,YAAY,EAAE,EAAE,kBAAkB,EAAE,OAAO,EAAE;KAC9C,EACD,IAAI,EACJ,CAAC,CACF,IAAI,CACN,CAAC;IACF,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC;AACjC,CAAC"}

package/dist/ui/server.d.ts

@@ -0,0 +1,8 @@
+import { type Server } from "node:http";
+import type { Factory } from "../app/factory.js";
+/** A read-only view of the repository's runs on 127.0.0.1, on `port` or one chosen by the system. */
+export declare function startDashboard(factory: Factory, listen?: number): Promise<{
+    url: string;
+    server: Server;
+    close(): Promise<void>;
+}>;

package/dist/ui/server.js

@@ -0,0 +1,111 @@
+import { readFile } from "node:fs/promises";
+import { createServer, } from "node:http";
+import { basename } from "node:path";
+import { listRuns, loadRun, loadRunEvents, presentResult, retryMaximums, summarizeRun, UnknownRunError, } from "../app/runs.js";
+/** The runs, newest first; an unreadable run with its error. */
+async function runs(factory) {
+    return {
+        repository: basename(factory.dir),
+        runs: (await listRuns(factory))
+            .reverse()
+            .map((entry) => ("state" in entry ? summarizeRun(entry.state) : entry)),
+    };
+}
+/** A run with its events from the `after`-th: the page asks only for what it has not received. */
+async function detail(factory, id, after) {
+    const state = await loadRun(factory, id);
+    const events = await loadRunEvents(factory, id);
+    const max = retryMaximums(factory, state.workflow);
+    return {
+        run: summarizeRun(state),
+        runtimes: state.runtimes ?? {},
+        error: state.error ?? null,
+        events: events.slice(after),
+        next: events.length,
+        corrections: Object.entries(state.retries ?? {}).map(([key, count]) => ({
+            key,
+            count,
+            max: max.get(key) ?? null,
+        })),
+        result: presentResult(factory, state),
+    };
+}
+/** The page's files, served as they are: no script or style is ever inline. */
+const pageFiles = {
+    "/": ["index.html", "text/html; charset=utf-8"],
+    "/style.css": ["style.css", "text/css; charset=utf-8"],
+    "/dashboard.js": ["dashboard.js", "text/javascript; charset=utf-8"],
+    "/timeline.js": ["timeline.js", "text/javascript; charset=utf-8"],
+    "/follow.js": ["follow.js", "text/javascript; charset=utf-8"],
+};
+async function loadPage() {
+    const page = new Map();
+    for (const [path, [file, type]] of Object.entries(pageFiles))
+        page.set(path, {
+            body: await readFile(new URL(`./static/${file}`, import.meta.url), "utf8"),
+            type,
+        });
+    return page;
+}
+function send(response, status, body, type = "text/plain; charset=utf-8") {
+    response.writeHead(status, {
+        "content-type": type,
+        "cache-control": "no-store",
+        "x-content-type-options": "nosniff",
+        "content-security-policy": "default-src 'none'; script-src 'self'; style-src 'self'; connect-src 'self'; base-uri 'none'; form-action 'none'; frame-ancestors 'none'",
+    });
+    response.end(body);
+}
+/** A read-only view of the repository's runs on 127.0.0.1, on `port` or one chosen by the system. */
+export async function startDashboard(factory, listen = 0) {
+    let port = 0;
+    const page = await loadPage();
+    const handle = async (request, response) => {
+        // Another Host means another site reached this port (DNS rebinding).
+        if (request.headers.host !== `127.0.0.1:${port}` &&
+            request.headers.host !== `localhost:${port}`)
+            return send(response, 403, "Forbidden");
+        if (request.method !== "GET")
+            return send(response, 405, "Method Not Allowed");
+        const url = new URL(request.url ?? "/", "http://127.0.0.1");
+        const file = page.get(url.pathname);
+        if (file)
+            return send(response, 200, file.body, file.type);
+        if (url.pathname === "/api/runs")
+            return send(response, 200, JSON.stringify(await runs(factory)), "application/json");
+        const id = /^\/api\/runs\/([^/]+)$/.exec(url.pathname)?.[1];
+        if (id === undefined)
+            return send(response, 404, "Not Found");
+        const after = url.searchParams.get("after") ?? "0";
+        if (!/^\d+$/.test(after))
+            return send(response, 400, "Bad Request");
+        let body;
+        try {
+            body = await detail(factory, decodeURIComponent(id), Number(after));
+        }
+        catch (error) {
+            // A run that cannot be read now may be read at the next request.
+            return error instanceof UnknownRunError
+                ? send(response, 404, "Not Found")
+                : send(response, 500, error instanceof Error ? error.message : String(error));
+        }
+        return send(response, 200, JSON.stringify(body), "application/json");
+    };
+    const server = createServer((request, response) => {
+        handle(request, response).catch((error) => send(response, 500, error instanceof Error ? error.message : String(error)));
+    });
+    await new Promise((resolve, reject) => {
+        server.once("error", reject);
+        server.listen(listen, "127.0.0.1", () => resolve());
+    });
+    port = server.address().port;
+    return {
+        url: `http://127.0.0.1:${port}/`,
+        server,
+        close: () => new Promise((resolve, reject) => {
+            server.close((error) => (error ? reject(error) : resolve()));
+            server.closeAllConnections();
+        }),
+    };
+}
+//# sourceMappingURL=server.js.map