@rk0429/agentic-relay 20.1.1 → 21.1.0

package/dist/infrastructure/store/routine-runtime-projection-repository.js

@@ -0,0 +1,142 @@
+import { mkdir, readdir, readFile, rm, } from "node:fs/promises";
+import path from "node:path";
+import { ValidationError } from "../../core/errors.js";
+import { restoreRoutineRunId, } from "../../domain/routine-execution-state.js";
+import { isMissingFileError, writeJsonAtomic } from "./file-utils.js";
+export class RoutineRuntimeProjectionRepository {
+    store;
+    constructor(store) {
+        this.store = store;
+    }
+    async publish(name, projection) {
+        await this.ensureRoutinesDir();
+        await writeJsonAtomic(this.buildProjectionPath(name), serializeProjection(projection));
+        return this.buildProjectionPath(name);
+    }
+    async heartbeat(name, heartbeatAt = new Date()) {
+        const projection = await this.get(name);
+        if (projection === null) {
+            throw new ValidationError(`Runtime projection not found: ${name.value}`, {
+                recoveryHint: "Publish the runtime projection before updating its heartbeat.",
+            });
+        }
+        const updated = {
+            ...projection,
+            lastHeartbeatAt: heartbeatAt.toISOString(),
+        };
+        await writeJsonAtomic(this.buildProjectionPath(name), serializeProjection(updated));
+        return updated;
+    }
+    async get(name) {
+        try {
+            const raw = await readFile(this.buildProjectionPath(name), "utf8");
+            return parseProjection(JSON.parse(raw));
+        }
+        catch (error) {
+            if (isMissingFileError(error)) {
+                return null;
+            }
+            if (error instanceof SyntaxError) {
+                throw new ValidationError(`Invalid runtime projection JSON for "${name.value}": ${error.message}`, {
+                    recoveryHint: "Repair or delete the corrupted runtime projection file.",
+                });
+            }
+            throw error;
+        }
+    }
+    async list() {
+        try {
+            const entries = await readdir(this.routinesDir(), { withFileTypes: true });
+            const filenames = entries
+                .filter((entry) => entry.isFile() && entry.name.endsWith(".runtime.json"))
+                .map((entry) => entry.name)
+                .sort();
+            const projections = await Promise.all(filenames.map(async (filename) => {
+                const raw = await readFile(path.join(this.routinesDir(), filename), "utf8");
+                return {
+                    name: filename.replace(/\.runtime\.json$/, ""),
+                    projection: parseProjection(JSON.parse(raw)),
+                };
+            }));
+            return projections;
+        }
+        catch (error) {
+            if (isMissingFileError(error)) {
+                return [];
+            }
+            throw error;
+        }
+    }
+    async remove(name) {
+        await rm(this.buildProjectionPath(name), { force: true });
+    }
+    async ensureRoutinesDir() {
+        await mkdir(this.store.routinesDir(), { recursive: true });
+    }
+    routinesDir() {
+        return this.store.routinesDir();
+    }
+    buildProjectionPath(name) {
+        return path.join(this.routinesDir(), `${name.value}.runtime.json`);
+    }
+}
+function parseProjection(value) {
+    if (!isRecord(value)) {
+        throw new ValidationError("Invalid runtime projection: expected an object.", {
+            recoveryHint: "Repair or delete the corrupted runtime projection file.",
+        });
+    }
+    return {
+        routineRunId: restoreRoutineRunId(asNonEmptyString(value.routineRunId, "routineRunId")),
+        source: asSource(value.source),
+        startedAt: asIsoTimestamp(value.startedAt, "startedAt"),
+        lastHeartbeatAt: asIsoTimestamp(value.lastHeartbeatAt, "lastHeartbeatAt"),
+        pid: asPositiveInteger(value.pid, "pid"),
+    };
+}
+function serializeProjection(projection) {
+    return {
+        routineRunId: projection.routineRunId,
+        source: projection.source,
+        startedAt: projection.startedAt,
+        lastHeartbeatAt: projection.lastHeartbeatAt,
+        pid: projection.pid,
+    };
+}
+function asSource(value) {
+    if (value === "scheduled" || value === "manual" || value === "catch_up") {
+        return value;
+    }
+    throw new ValidationError(`Invalid source: ${String(value)}`, {
+        recoveryHint: "source must be scheduled, manual, or catch_up.",
+    });
+}
+function asPositiveInteger(value, field) {
+    if (typeof value !== "number" || !Number.isInteger(value) || value <= 0) {
+        throw new ValidationError(`Invalid ${field}: ${String(value)}`, {
+            recoveryHint: `${field} must be a positive integer.`,
+        });
+    }
+    return value;
+}
+function asNonEmptyString(value, field) {
+    if (typeof value !== "string" || value.length === 0) {
+        throw new ValidationError(`Invalid ${field}: ${String(value)}`, {
+            recoveryHint: `${field} must be a non-empty string.`,
+        });
+    }
+    return value;
+}
+function asIsoTimestamp(value, field) {
+    const timestamp = asNonEmptyString(value, field);
+    if (Number.isNaN(new Date(timestamp).getTime())) {
+        throw new ValidationError(`Invalid ${field}: ${timestamp}`, {
+            recoveryHint: `${field} must be an ISO 8601 timestamp.`,
+        });
+    }
+    return timestamp;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+//# sourceMappingURL=routine-runtime-projection-repository.js.map

package/dist/infrastructure/store/routine-runtime-projection-repository.js.map

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

package/dist/infrastructure/store/routine-state-repository.d.ts

@@ -0,0 +1,21 @@
+import { RoutineExecutionState } from "../../domain/routine-execution-state.js";
+import { RoutineName } from "../../domain/routine-name.js";
+import { RelayStore } from "./relay-store.js";
+export interface PersistedRoutineState {
+    workflowPath: string;
+    state: RoutineExecutionState;
+}
+export interface NamedPersistedRoutineState extends PersistedRoutineState {
+    name: RoutineName;
+}
+export declare class RoutineStateRepository {
+    private readonly store;
+    constructor(store: RelayStore);
+    save(name: RoutineName, workflowPath: string, state: RoutineExecutionState): Promise<string>;
+    load(name: RoutineName): Promise<PersistedRoutineState | null>;
+    delete(name: RoutineName): Promise<void>;
+    list(): Promise<NamedPersistedRoutineState[]>;
+    private ensureRoutinesDir;
+    private routinesDir;
+    private buildStatePath;
+}

package/dist/infrastructure/store/routine-state-repository.js

@@ -0,0 +1,139 @@
+import { mkdir, readFile, rm } from "node:fs/promises";
+import path from "node:path";
+import { ValidationError } from "../../core/errors.js";
+import { RoutineExecutionState, } from "../../domain/routine-execution-state.js";
+import { RoutineName } from "../../domain/routine-name.js";
+import { isMissingFileError, writeJsonAtomic } from "./file-utils.js";
+export class RoutineStateRepository {
+    store;
+    constructor(store) {
+        this.store = store;
+    }
+    async save(name, workflowPath, state) {
+        assertNonEmptyString(workflowPath, "workflowPath");
+        await this.ensureRoutinesDir();
+        const targetPath = this.buildStatePath(name);
+        await writeJsonAtomic(targetPath, {
+            routineName: name.value,
+            workflowPath,
+            ...state.toJSON(),
+        });
+        return targetPath;
+    }
+    async load(name) {
+        const targetPath = this.buildStatePath(name);
+        try {
+            const raw = await readFile(targetPath, "utf8");
+            return parsePersistedRoutineState(JSON.parse(raw), name);
+        }
+        catch (error) {
+            if (isMissingFileError(error)) {
+                return null;
+            }
+            if (error instanceof SyntaxError) {
+                throw new ValidationError(`Invalid routine state JSON for "${name.value}": ${error.message}`, {
+                    recoveryHint: "Repair or delete the corrupted routine state file.",
+                });
+            }
+            throw error;
+        }
+    }
+    async delete(name) {
+        await rm(this.buildStatePath(name), { force: true });
+    }
+    async list() {
+        try {
+            const entries = await import("node:fs/promises").then(({ readdir }) => readdir(this.store.routinesDir(), { withFileTypes: true }));
+            const files = entries
+                .filter((entry) => entry.isFile() && entry.name.endsWith(".state.json"))
+                .map((entry) => entry.name)
+                .sort();
+            const states = await Promise.all(files.map(async (filename) => {
+                const raw = await readFile(path.join(this.store.routinesDir(), filename), "utf8");
+                const name = new RoutineName(filename.replace(/\.state\.json$/, ""));
+                const persisted = parsePersistedRoutineState(JSON.parse(raw), name);
+                return {
+                    name,
+                    ...persisted,
+                };
+            }));
+            return states;
+        }
+        catch (error) {
+            if (isMissingFileError(error)) {
+                return [];
+            }
+            throw error;
+        }
+    }
+    async ensureRoutinesDir() {
+        await mkdir(this.store.routinesDir(), { recursive: true });
+    }
+    routinesDir() {
+        return this.store.routinesDir();
+    }
+    buildStatePath(name) {
+        return path.join(this.routinesDir(), `${name.value}.state.json`);
+    }
+}
+function parsePersistedRoutineState(value, expectedName) {
+    if (!isRecord(value)) {
+        throw new ValidationError("Invalid routine state file: expected an object.", {
+            recoveryHint: "Repair or delete the corrupted routine state file.",
+        });
+    }
+    const routineName = asNonEmptyString(value.routineName, "routineName");
+    assertNonEmptyString(value.workflowPath, "workflowPath");
+    if (expectedName && routineName !== expectedName.value) {
+        throw new ValidationError(`Invalid routineName: ${routineName}`, {
+            recoveryHint: `routineName must match the state filename (${expectedName.value}).`,
+        });
+    }
+    return {
+        workflowPath: value.workflowPath,
+        state: RoutineExecutionState.fromJSON({
+            lastExecutedAt: asNullableString(value.lastExecutedAt, "lastExecutedAt"),
+            lastScheduledAt: asNullableString(value.lastScheduledAt, "lastScheduledAt"),
+            nextScheduledAt: asNullableString(value.nextScheduledAt, "nextScheduledAt"),
+            lastStatus: asExecutionStatus(value.lastStatus),
+        }),
+    };
+}
+function asExecutionStatus(value) {
+    if (value === null) {
+        return null;
+    }
+    if (value === "completed" ||
+        value === "failed" ||
+        value === "skipped") {
+        return value;
+    }
+    throw new ValidationError(`Invalid lastStatus: ${String(value)}`, {
+        recoveryHint: "lastStatus must be completed, failed, skipped, or null.",
+    });
+}
+function asNullableString(value, field) {
+    if (value === null) {
+        return null;
+    }
+    return asNonEmptyString(value, field);
+}
+function asNonEmptyString(value, field) {
+    if (typeof value !== "string" || value.length === 0) {
+        throw new ValidationError(`Invalid ${field}: ${String(value)}`, {
+            recoveryHint: `${field} must be a non-empty string.`,
+        });
+    }
+    return value;
+}
+function assertNonEmptyString(value, field) {
+    if (typeof value !== "string" || value.trim().length === 0) {
+        throw new ValidationError(`Invalid ${field}: ${String(value)}`, {
+            recoveryHint: `${field} must be a non-empty string.`,
+        });
+    }
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+//# sourceMappingURL=routine-state-repository.js.map

package/dist/infrastructure/store/routine-state-repository.js.map

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

package/dist/interfaces/cli/loop-progress-renderer.js

@@ -80,7 +80,9 @@ function renderStepLine(step, state, now) {
     const icon = STATUS_ICONS[status];
     const meta = step.kind === "workflow"
         ? "sub-workflow"
-        : [step.backend, step.role].filter(Boolean).join(", ");
+        : step.kind === "command"
+            ? "command"
+            : [step.backend, step.role].filter(Boolean).join(", ");
     const durationText = status === "running"
         ? state.activeStepStartedAt
             ? formatDurationMs(Math.max(0, now.getTime() - new Date(state.activeStepStartedAt).getTime()))

package/dist/interfaces/cli/loop-progress-renderer.js.map

@@ -1 +1 @@
-{"version":3,"file":"loop-progress-renderer.js","sourceRoot":"","sources":["../../../src/interfaces/cli/loop-progress-renderer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"loop-progress-renderer.js","sourceRoot":"","sources":["../../../src/interfaces/cli/loop-progress-renderer.ts"],"names":[],"mappings":"AAmBA,MAAM,UAAU,8BAA8B,CAC5C,MAA0B;IAE1B,OAAO,uBAAuB,CAC5B;QACE,QAAQ,EAAE,MAAM,CAAC,QAAQ;KAC1B,EACD,MAAM,CACP,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,QAAkC,EAClC,MAA0B;IAE1B,MAAM,IAAI,GAA6B;QACrC,GAAG,QAAQ;QACX,QAAQ,EAAE,MAAM,CAAC,QAAQ;KAC1B,CAAC;IAEF,QAAQ,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAC1B,KAAK,QAAQ,CAAC;QACd,KAAK,mBAAmB;YACtB,OAAO;gBACL,GAAG,IAAI;gBACP,YAAY,EAAE,SAAS;gBACvB,mBAAmB,EAAE,SAAS;gBAC9B,qBAAqB,EAAE,SAAS;aACjC,CAAC;QACJ,KAAK,cAAc;YACjB,OAAO;gBACL,GAAG,IAAI;gBACP,YAAY,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM;gBACjC,mBAAmB,EAAE,MAAM,CAAC,KAAK,CAAC,SAAS;gBAC3C,qBAAqB,EAAE,SAAS;aACjC,CAAC;QACJ,KAAK,gBAAgB,CAAC;QACtB,KAAK,cAAc;YACjB,OAAO;gBACL,GAAG,IAAI;gBACP,YAAY,EACV,QAAQ,CAAC,YAAY,KAAK,MAAM,CAAC,KAAK,CAAC,MAAM;oBAC3C,CAAC,CAAC,SAAS;oBACX,CAAC,CAAC,QAAQ,CAAC,YAAY;gBAC3B,mBAAmB,EACjB,QAAQ,CAAC,YAAY,KAAK,MAAM,CAAC,KAAK,CAAC,MAAM;oBAC3C,CAAC,CAAC,SAAS;oBACX,CAAC,CAAC,QAAQ,CAAC,mBAAmB;gBAClC,qBAAqB,EACnB,QAAQ,CAAC,qBAAqB,KAAK,MAAM,CAAC,KAAK,CAAC,MAAM;oBACpD,CAAC,CAAC,SAAS;oBACX,CAAC,CAAC,QAAQ,CAAC,qBAAqB;aACrC,CAAC;QACJ,KAAK,aAAa;YAChB,OAAO;gBACL,GAAG,IAAI;gBACP,YAAY,EACV,QAAQ,CAAC,YAAY,KAAK,MAAM,CAAC,KAAK,CAAC,MAAM;oBAC3C,CAAC,CAAC,SAAS;oBACX,CAAC,CAAC,QAAQ,CAAC,YAAY;gBAC3B,mBAAmB,EACjB,QAAQ,CAAC,YAAY,KAAK,MAAM,CAAC,KAAK,CAAC,MAAM;oBAC3C,CAAC,CAAC,SAAS;oBACX,CAAC,CAAC,QAAQ,CAAC,mBAAmB;gBAClC,qBAAqB,EAAE,MAAM,CAAC,KAAK,CAAC,SAAS;oBAC3C,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM;oBACrB,CAAC,CAAC,SAAS;aACd,CAAC;QACJ,KAAK,gBAAgB;YACnB,OAAO;gBACL,GAAG,IAAI;gBACP,YAAY,EAAE,SAAS;gBACvB,mBAAmB,EAAE,SAAS;gBAC9B,qBAAqB,EAAE,SAAS;aACjC,CAAC;QACJ,KAAK,kBAAkB;YACrB,OAAO;gBACL,GAAG,IAAI;gBACP,YAAY,EAAE,SAAS;gBACvB,mBAAmB,EAAE,SAAS;aAC/B,CAAC;IACN,CAAC;AACH,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,KAA+B,EAC/B,GAAS;IAET,MAAM,eAAe,GACnB,KAAK,CAAC,QAAQ,CAAC,gBAAgB,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC;IAE5E,OAAO;QACL,GAAG,KAAK,CAAC,QAAQ,CAAC,YAAY,gBAAgB,eAAe,IAAI,KAAK,CAAC,QAAQ,CAAC,aAAa,MAAM,gBAAgB,CACjH,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC,CAC1E,EAAE;QACH,EAAE;QACF,QAAQ;QACR,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;KACxE,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CACrB,IAAsB,EACtB,KAA+B,EAC/B,GAAS;IAET,MAAM,MAAM,GAAG,wBAAwB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACrD,MAAM,IAAI,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IAClC,MAAM,IAAI,GACR,IAAI,CAAC,IAAI,KAAK,UAAU;QACtB,CAAC,CAAC,cAAc;QAChB,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS;YACvB,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE7D,MAAM,YAAY,GAChB,MAAM,KAAK,SAAS;QAClB,CAAC,CAAC,KAAK,CAAC,mBAAmB;YACzB,CAAC,CAAC,gBAAgB,CACd,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC,OAAO,EAAE,CAAC,CAC3E;YACH,CAAC,CAAC,SAAS;QACb,CAAC,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS;YAC3B,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC;YACjC,CAAC,CAAC,SAAS,CAAC;IAElB,OAAO;QACL,KAAK,IAAI,EAAE;QACX,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;QACzB,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE;QACvB,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE;KAC7C;SACE,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;SACjC,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAED,SAAS,wBAAwB,CAC/B,IAAsB,EACtB,KAA+B;IAE/B,IAAI,KAAK,CAAC,YAAY,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;QACvC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IACE,KAAK,CAAC,qBAAqB,KAAK,IAAI,CAAC,MAAM;QAC3C,IAAI,CAAC,MAAM,KAAK,SAAS,EACzB,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,OAAO,IAAI,CAAC,MAAM,CAAC;AACrB,CAAC;AAED,SAAS,gBAAgB,CAAC,EAAU;IAClC,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,YAAY,GAAG,EAAE,CAAC;IAClC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC;IACnD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IAE9C,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACd,OAAO,GAAG,KAAK,KAAK,OAAO,GAAG,CAAC;IACjC,CAAC;IAED,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;QAChB,OAAO,GAAG,OAAO,KAAK,OAAO,GAAG,CAAC;IACnC,CAAC;IAED,OAAO,GAAG,OAAO,GAAG,CAAC;AACvB,CAAC;AAED,SAAS,QAAQ,CAAC,KAAa,EAAE,KAAa;IAC5C,OAAO,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AAClE,CAAC;AAED,SAAS,OAAO,CAAC,KAAa,EAAE,KAAa;IAC3C,OAAO,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AACpE,CAAC;AAED,MAAM,YAAY,GAAsC;IACtD,SAAS,EAAE,GAAG;IACd,MAAM,EAAE,GAAG;IACX,OAAO,EAAE,GAAG;IACZ,OAAO,EAAE,GAAG;IACZ,OAAO,EAAE,GAAG;CACb,CAAC"}

package/dist/interfaces/cli/relay-cli-args.d.ts

@@ -1,7 +1,7 @@
 import { type BackendType } from "../../core/types.js";
 export type RelayCliCommand = {
     kind: "help";
-    topic?: "core-setup" | "core-update" | "core-remove";
+    topic?: "core-setup" | "core-update" | "core-remove" | "routine";
 } | {
     kind: "version";
 } | {
@@ -32,13 +32,30 @@ export type RelayCliCommand = {
     target?: "code" | "code-insiders" | "cursor";
     uninstall?: boolean;
 } | {
-    kind: "loop";
+    kind: "routine-run";
     workflowPath: string;
+    configDir?: string;
     resumeStateFile?: string;
     forceResume?: boolean;
     allowCommandRun?: boolean;
     dryRun?: boolean;
     vars?: Record<string, string>;
+} | {
+    kind: "routine-start";
+    configDir?: string;
+    daemon?: boolean;
+    allowCommandRun?: boolean;
+} | {
+    kind: "routine-stop";
+} | {
+    kind: "routine-list";
+    configDir?: string;
+    format?: "table" | "tsv" | "json";
+} | {
+    kind: "routine-status";
+    name?: string;
+    configDir?: string;
+    limit?: number;
 } | {
     kind: "relay";
     backend?: BackendType;

package/dist/interfaces/cli/relay-cli-args.js

@@ -36,67 +36,198 @@ export function parseRelayCliArgs(argv) {
             ...(uninstall ? { uninstall } : {}),
         };
     }
-    if (argv[0] === "loop") {
-        const workflowPath = argv[1];
-        if (workflowPath === "-h" || workflowPath === "--help") {
-            return { kind: "help" };
-        }
-        if (!workflowPath) {
-            throw new ValidationError("Usage: relay loop <workflow.yaml> [--var key=value ...] [--dry-run] [--resume-state <state_file>] [--force-resume] [--allow-command-run]");
+    if (argv[0] === "routine") {
+        const subcommand = argv[1];
+        if (!subcommand || subcommand === "-h" || subcommand === "--help") {
+            return { kind: "help", topic: "routine" };
         }
-        const args = argv.slice(2);
-        let resumeStateFile;
-        let forceResume = false;
-        let allowCommandRun = false;
-        let dryRun = false;
-        const vars = {};
-        for (let index = 0; index < args.length; index += 1) {
-            const current = args[index];
-            if (current === "-h" || current === "--help") {
-                return { kind: "help" };
+        if (subcommand === "run") {
+            const workflowPath = argv[2];
+            if (workflowPath === "-h" || workflowPath === "--help") {
+                return { kind: "help", topic: "routine" };
             }
-            if (current === "--resume-state") {
-                resumeStateFile = readOptionValue(args, ++index, current);
-                continue;
+            if (!workflowPath) {
+                throw new ValidationError("Usage: relay routine run <workflow.yaml> [--config <dir>] [--var key=value ...] [--dry-run] [--resume-state <state_file>] [--force-resume] [--allow-command-run]");
             }
-            if (current === "--force-resume") {
-                forceResume = true;
-                continue;
+            const args = argv.slice(3);
+            let configDir;
+            let resumeStateFile;
+            let forceResume = false;
+            let allowCommandRun = false;
+            let dryRun = false;
+            const vars = {};
+            for (let index = 0; index < args.length; index += 1) {
+                const current = args[index];
+                if (current === "-h" || current === "--help") {
+                    return { kind: "help", topic: "routine" };
+                }
+                if (current === "--config") {
+                    configDir = readOptionValue(args, ++index, current);
+                    continue;
+                }
+                if (current === "--resume-state") {
+                    resumeStateFile = readOptionValue(args, ++index, current);
+                    continue;
+                }
+                if (current === "--force-resume") {
+                    forceResume = true;
+                    continue;
+                }
+                if (current === "--allow-command-run") {
+                    allowCommandRun = true;
+                    continue;
+                }
+                if (current === "--dry-run") {
+                    dryRun = true;
+                    continue;
+                }
+                if (current === "--var") {
+                    const pair = readOptionValue(args, ++index, current);
+                    const eqIndex = pair.indexOf("=");
+                    if (eqIndex < 1) {
+                        throw new ValidationError(`--var requires key=value format, got: "${pair}"`);
+                    }
+                    vars[pair.slice(0, eqIndex)] = pair.slice(eqIndex + 1);
+                    continue;
+                }
+                if (current?.startsWith("-")) {
+                    throw new ValidationError(`Unknown option: ${current}`);
+                }
+                throw new ValidationError(`Unknown command or argument: ${current}`);
             }
-            if (current === "--allow-command-run") {
-                allowCommandRun = true;
-                continue;
+            if (forceResume && !resumeStateFile) {
+                throw new ValidationError("--force-resume requires --resume-state <state_file>.");
             }
-            if (current === "--dry-run") {
-                dryRun = true;
-                continue;
+            return {
+                kind: "routine-run",
+                workflowPath,
+                ...(configDir ? { configDir } : {}),
+                ...(resumeStateFile ? { resumeStateFile } : {}),
+                ...(forceResume ? { forceResume } : {}),
+                ...(allowCommandRun ? { allowCommandRun } : {}),
+                ...(dryRun ? { dryRun } : {}),
+                ...(Object.keys(vars).length > 0 ? { vars } : {}),
+            };
+        }
+        if (subcommand === "start") {
+            const args = argv.slice(2);
+            let configDir;
+            let daemon = false;
+            let allowCommandRun = false;
+            for (let index = 0; index < args.length; index += 1) {
+                const current = args[index];
+                if (current === "-h" || current === "--help") {
+                    return { kind: "help", topic: "routine" };
+                }
+                if (current === "--config") {
+                    configDir = readOptionValue(args, ++index, current);
+                    continue;
+                }
+                if (current === "--daemon") {
+                    daemon = true;
+                    continue;
+                }
+                if (current === "--allow-command-run") {
+                    allowCommandRun = true;
+                    continue;
+                }
+                if (current?.startsWith("-")) {
+                    throw new ValidationError(`Unknown option: ${current}`);
+                }
+                throw new ValidationError(`Unknown command or argument: ${current}`);
             }
-            if (current === "--var") {
-                const pair = readOptionValue(args, ++index, current);
-                const eqIndex = pair.indexOf("=");
-                if (eqIndex < 1) {
-                    throw new ValidationError(`--var requires key=value format, got: "${pair}"`);
+            return {
+                kind: "routine-start",
+                ...(configDir ? { configDir } : {}),
+                ...(daemon ? { daemon } : {}),
+                ...(allowCommandRun ? { allowCommandRun } : {}),
+            };
+        }
+        if (subcommand === "stop") {
+            const args = argv.slice(2);
+            for (const current of args) {
+                if (current === "-h" || current === "--help") {
+                    return { kind: "help", topic: "routine" };
                 }
-                vars[pair.slice(0, eqIndex)] = pair.slice(eqIndex + 1);
-                continue;
+                if (current?.startsWith("-")) {
+                    throw new ValidationError(`Unknown option: ${current}`);
+                }
+                throw new ValidationError(`Unknown command or argument: ${current}`);
             }
-            if (current?.startsWith("-")) {
-                throw new ValidationError(`Unknown option: ${current}`);
+            return { kind: "routine-stop" };
+        }
+        if (subcommand === "list") {
+            const args = argv.slice(2);
+            let configDir;
+            let format;
+            for (let index = 0; index < args.length; index += 1) {
+                const current = args[index];
+                if (current === "-h" || current === "--help") {
+                    return { kind: "help", topic: "routine" };
+                }
+                if (current === "--config") {
+                    configDir = readOptionValue(args, ++index, current);
+                    continue;
+                }
+                if (current === "--format") {
+                    const value = readOptionValue(args, ++index, current);
+                    if (!isRoutineListFormat(value)) {
+                        throw new ValidationError(`--format must be one of: table, tsv, json. Got: "${value}"`);
+                    }
+                    format = value;
+                    continue;
+                }
+                if (current?.startsWith("-")) {
+                    throw new ValidationError(`Unknown option: ${current}`);
+                }
+                throw new ValidationError(`Unknown command or argument: ${current}`);
             }
-            throw new ValidationError(`Unknown command or argument: ${current}`);
+            return {
+                kind: "routine-list",
+                ...(configDir ? { configDir } : {}),
+                ...(format ? { format } : {}),
+            };
         }
-        if (forceResume && !resumeStateFile) {
-            throw new ValidationError("--force-resume requires --resume-state <state_file>.");
+        if (subcommand === "status") {
+            const args = argv.slice(2);
+            let name;
+            let configDir;
+            let limit;
+            for (let index = 0; index < args.length; index += 1) {
+                const current = args[index];
+                if (current === "-h" || current === "--help") {
+                    return { kind: "help", topic: "routine" };
+                }
+                if (current === "--config") {
+                    configDir = readOptionValue(args, ++index, current);
+                    continue;
+                }
+                if (current === "--limit") {
+                    const raw = readOptionValue(args, ++index, current);
+                    const parsed = Number.parseInt(raw, 10);
+                    if (!Number.isInteger(parsed) || parsed <= 0) {
+                        throw new ValidationError(`--limit must be a positive integer. Got: "${raw}"`);
+                    }
+                    limit = parsed;
+                    continue;
+                }
+                if (current?.startsWith("-")) {
+                    throw new ValidationError(`Unknown option: ${current}`);
+                }
+                if (!name) {
+                    name = current;
+                    continue;
+                }
+                throw new ValidationError(`Unknown command or argument: ${current}`);
+            }
+            return {
+                kind: "routine-status",
+                ...(name ? { name } : {}),
+                ...(configDir ? { configDir } : {}),
+                ...(limit !== undefined ? { limit } : {}),
+            };
         }
-        return {
-            kind: "loop",
-            workflowPath,
-            ...(resumeStateFile ? { resumeStateFile } : {}),
-            ...(forceResume ? { forceResume } : {}),
-            ...(allowCommandRun ? { allowCommandRun } : {}),
-            ...(dryRun ? { dryRun } : {}),
-            ...(Object.keys(vars).length > 0 ? { vars } : {}),
-        };
+        throw new ValidationError(`Unknown routine subcommand: ${subcommand}. Expected one of: run, start, stop, list, status.`);
     }
     if (argv[0] === "core") {
         const subcommand = argv[1];
@@ -247,6 +378,9 @@ function isBackendType(value) {
 function isVscodeTarget(value) {
     return value === "code" || value === "code-insiders" || value === "cursor";
 }
+function isRoutineListFormat(value) {
+    return value === "table" || value === "tsv" || value === "json";
+}
 function readOptionValue(args, index, option) {
     const value = args[index];
     if (!value) {