cueline 0.1.0

package/dist/src/jobs/status.d.ts

@@ -0,0 +1,22 @@
+import type { JobExecution, JobResult, JobResultStatus } from "../runners/runner-adapter.js";
+export type JobStatusKind = "running" | JobResultStatus;
+export interface JobStatus {
+    jobId: string;
+    execution: JobExecution;
+    status: JobStatusKind;
+    startedAt: string;
+    finishedAt?: string;
+    result?: JobResult;
+    error?: string;
+}
+/**
+ * Stores one atomically replaced JSON status file per job. The write format is
+ * deliberately small so foreground and background work share the same view.
+ */
+export declare class JobStatusStore {
+    #private;
+    constructor(rootDirectory: string);
+    write(status: JobStatus): Promise<void>;
+    read(jobId: string): Promise<JobStatus | undefined>;
+    pathFor(jobId: string): string;
+}

package/dist/src/jobs/status.js

@@ -0,0 +1,53 @@
+import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { CueLineError } from "../core/errors.js";
+import { runtimePidTag } from "../core/runtime.js";
+function assertSafeJobId(jobId) {
+    if (!/^[A-Za-z0-9][A-Za-z0-9_-]*$/.test(jobId)) {
+        throw new CueLineError("JOB_ID_INVALID", "job id contains unsupported path characters", {
+            details: { jobId },
+        });
+    }
+}
+/**
+ * Stores one atomically replaced JSON status file per job. The write format is
+ * deliberately small so foreground and background work share the same view.
+ */
+export class JobStatusStore {
+    #directory;
+    constructor(rootDirectory) {
+        this.#directory = path.resolve(rootDirectory, "jobs");
+    }
+    async write(status) {
+        assertSafeJobId(status.jobId);
+        await mkdir(this.#directory, { recursive: true });
+        const target = this.pathFor(status.jobId);
+        const temporary = `${target}.${runtimePidTag()}.${Date.now()}.tmp`;
+        await writeFile(temporary, `${JSON.stringify(status)}\n`, "utf8");
+        await rename(temporary, target);
+    }
+    async read(jobId) {
+        assertSafeJobId(jobId);
+        try {
+            const source = await readFile(this.pathFor(jobId), "utf8");
+            return JSON.parse(source);
+        }
+        catch (error) {
+            if (isNotFound(error)) {
+                return undefined;
+            }
+            throw new CueLineError("JOB_STATUS_READ_FAILED", `unable to read job status: ${jobId}`, {
+                cause: error,
+                details: { jobId },
+            });
+        }
+    }
+    pathFor(jobId) {
+        assertSafeJobId(jobId);
+        return path.join(this.#directory, `${jobId}.json`);
+    }
+}
+function isNotFound(error) {
+    return typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT";
+}
+//# sourceMappingURL=status.js.map

package/dist/src/jobs/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../src/jobs/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAenD,SAAS,eAAe,CAAC,KAAa;IACpC,IAAI,CAAC,6BAA6B,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/C,MAAM,IAAI,YAAY,CAAC,gBAAgB,EAAE,6CAA6C,EAAE;YACtF,OAAO,EAAE,EAAE,KAAK,EAAE;SACnB,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,cAAc;IAChB,UAAU,CAAS;IAE5B,YAAY,aAAqB;QAC/B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IACxD,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,MAAiB;QAC3B,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC9B,MAAM,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAClD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC1C,MAAM,SAAS,GAAG,GAAG,MAAM,IAAI,aAAa,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC;QACnE,MAAM,SAAS,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAClE,MAAM,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,KAAa;QACtB,eAAe,CAAC,KAAK,CAAC,CAAC;QACvB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,CAAC;YAC3D,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAc,CAAC;QACzC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;gBACtB,OAAO,SAAS,CAAC;YACnB,CAAC;YACD,MAAM,IAAI,YAAY,CAAC,wBAAwB,EAAE,8BAA8B,KAAK,EAAE,EAAE;gBACtF,KAAK,EAAE,KAAK;gBACZ,OAAO,EAAE,EAAE,KAAK,EAAE;aACnB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,CAAC,KAAa;QACnB,eAAe,CAAC,KAAK,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,KAAK,OAAO,CAAC,CAAC;IACrD,CAAC;CACF;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC;AACnG,CAAC"}

package/dist/src/jobs/supervisor.d.ts

@@ -0,0 +1,22 @@
+import { type RunnerAdapter, type RunnerSpec } from "../runners/runner-adapter.js";
+import { JobLocks } from "./locks.js";
+import { JobStatusStore, type JobStatus } from "./status.js";
+export interface JobSupervisorOptions {
+    statusStore: JobStatusStore;
+    locks?: JobLocks;
+}
+/**
+ * Starts each job at most once. A background call returns its persisted
+ * running status; foreground calls wait for that exact same execution.
+ */
+export declare class JobSupervisor {
+    #private;
+    private readonly runner;
+    private readonly options;
+    constructor(runner: RunnerAdapter, options: JobSupervisorOptions);
+    start(spec: RunnerSpec): Promise<JobStatus>;
+    waitForCompletion(jobId: string): Promise<JobStatus>;
+    inspect(jobId: string): Promise<JobStatus>;
+    private completeOnce;
+    private withResult;
+}

package/dist/src/jobs/supervisor.js

@@ -0,0 +1,96 @@
+import { CueLineError } from "../core/errors.js";
+import { executionFor } from "../runners/runner-adapter.js";
+import { JobLocks } from "./locks.js";
+import { JobStatusStore } from "./status.js";
+function errorText(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+/**
+ * Starts each job at most once. A background call returns its persisted
+ * running status; foreground calls wait for that exact same execution.
+ */
+export class JobSupervisor {
+    runner;
+    options;
+    #locks;
+    #completions = new Map();
+    constructor(runner, options) {
+        this.runner = runner;
+        this.options = options;
+        this.#locks = options.locks ?? new JobLocks();
+    }
+    async start(spec) {
+        const lock = this.#locks.acquire(spec.jobId);
+        const running = {
+            jobId: spec.jobId,
+            execution: executionFor(spec),
+            status: "running",
+            startedAt: new Date().toISOString(),
+        };
+        try {
+            await this.options.statusStore.write(running);
+        }
+        catch (error) {
+            lock.release();
+            throw error;
+        }
+        const completion = this.completeOnce(spec, running, lock.release);
+        this.#completions.set(spec.jobId, completion);
+        if (spec.background === true) {
+            void completion.catch(() => undefined);
+            return running;
+        }
+        return completion;
+    }
+    async waitForCompletion(jobId) {
+        const completion = this.#completions.get(jobId);
+        if (completion !== undefined) {
+            return completion;
+        }
+        const persisted = await this.options.statusStore.read(jobId);
+        if (persisted !== undefined) {
+            return persisted;
+        }
+        throw new CueLineError("JOB_NOT_FOUND", `no job status exists for: ${jobId}`, { details: { jobId } });
+    }
+    async inspect(jobId) {
+        const persisted = await this.options.statusStore.read(jobId);
+        if (persisted !== undefined)
+            return persisted;
+        throw new CueLineError("JOB_NOT_FOUND", `no job status exists for: ${jobId}`, {
+            details: { jobId },
+        });
+    }
+    async completeOnce(spec, running, release) {
+        let terminal;
+        try {
+            const result = await this.runner.run(spec);
+            terminal = this.withResult(running, result);
+        }
+        catch (error) {
+            terminal = {
+                ...running,
+                status: "failed",
+                finishedAt: new Date().toISOString(),
+                error: errorText(error),
+            };
+        }
+        try {
+            await this.options.statusStore.write(terminal);
+            return terminal;
+        }
+        finally {
+            this.#completions.delete(spec.jobId);
+            release();
+        }
+    }
+    withResult(running, result) {
+        return {
+            ...running,
+            status: result.status,
+            finishedAt: result.finishedAt,
+            result,
+        };
+    }
+}
+//# sourceMappingURL=supervisor.js.map

package/dist/src/jobs/supervisor.js.map

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

package/dist/src/protocol/parse-command.d.ts

@@ -0,0 +1,2 @@
+import type { ControllerCommand, ExpectedControllerIdentity } from "./types.js";
+export declare function parseControllerCommand(text: string, expected: ExpectedControllerIdentity): ControllerCommand;

package/dist/src/protocol/parse-command.js

@@ -0,0 +1,23 @@
+import { CueLineError } from "../core/errors.js";
+import { validateControllerCommand } from "./validate-command.js";
+const CONTROL_ENVELOPE = /<CueLineControl>([\s\S]*?)<\/CueLineControl>/g;
+export function parseControllerCommand(text, expected) {
+    let body;
+    for (const match of text.matchAll(CONTROL_ENVELOPE)) {
+        body = match[1];
+    }
+    if (body === undefined) {
+        throw new CueLineError("CONTROL_ENVELOPE_MISSING", "No complete <CueLineControl> envelope was found.");
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(body.trim());
+    }
+    catch (error) {
+        throw new CueLineError("CONTROL_JSON_INVALID", "Control envelope contains invalid JSON.", {
+            cause: error,
+        });
+    }
+    return validateControllerCommand(parsed, expected);
+}
+//# sourceMappingURL=parse-command.js.map

package/dist/src/protocol/parse-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-command.js","sourceRoot":"","sources":["../../../src/protocol/parse-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAElE,MAAM,gBAAgB,GAAG,+CAA+C,CAAC;AAEzE,MAAM,UAAU,sBAAsB,CACpC,IAAY,EACZ,QAAoC;IAEpC,IAAI,IAAwB,CAAC;IAC7B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACpD,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,MAAM,IAAI,YAAY,CACpB,0BAA0B,EAC1B,kDAAkD,CACnD,CAAC;IACJ,CAAC;IAED,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACnC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,YAAY,CAAC,sBAAsB,EAAE,yCAAyC,EAAE;YACxF,KAAK,EAAE,KAAK;SACb,CAAC,CAAC;IACL,CAAC;IACD,OAAO,yBAAyB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AACrD,CAAC"}

package/dist/src/protocol/types.d.ts

@@ -0,0 +1,67 @@
+export declare const CUELINE_PROTOCOL: "cueline/0.1";
+export type JobMode = "advise" | "work";
+export type ControllerAction = "dispatch" | "wait" | "inspect" | "complete" | "blocked";
+export interface ExpectedControllerIdentity {
+    runId: string;
+    round: number;
+    requestId: string;
+}
+export interface ControllerJobSpec {
+    job_key: string;
+    lane: string;
+    mode: JobMode;
+    task: string;
+    required?: boolean;
+    timeout_ms?: number;
+    runner?: string;
+    workdir?: string;
+    background?: boolean;
+}
+interface ControllerCommandBase {
+    protocol: typeof CUELINE_PROTOCOL;
+    run_id: string;
+    round: number;
+    request_id: string;
+    action: ControllerAction;
+}
+export interface DispatchCommand extends ControllerCommandBase {
+    action: "dispatch";
+    jobs: ControllerJobSpec[];
+}
+export interface WaitCommand extends ControllerCommandBase {
+    action: "wait";
+    job_ids?: string[];
+    wait_ms?: number;
+}
+export interface InspectCommand extends ControllerCommandBase {
+    action: "inspect";
+    job_ids?: string[];
+}
+export interface CompleteCommand extends ControllerCommandBase {
+    action: "complete";
+    final_delivery_text: string;
+}
+export interface BlockedCommand extends ControllerCommandBase {
+    action: "blocked";
+    reason: string;
+    final_delivery_text?: string;
+}
+export type ControllerCommand = DispatchCommand | WaitCommand | InspectCommand | CompleteCommand | BlockedCommand;
+export interface JobObservation {
+    job_id: string;
+    job_key: string;
+    required: boolean;
+    status: "pending" | "running" | "succeeded" | "failed" | "timed_out" | "ambiguous";
+    output?: string;
+    error?: string;
+}
+export interface ControllerObservation {
+    protocol: typeof CUELINE_PROTOCOL;
+    run_id: string;
+    round: number;
+    request_id: string;
+    user_request: string;
+    jobs: JobObservation[];
+    notices: string[];
+}
+export {};

package/dist/src/protocol/types.js

@@ -0,0 +1,2 @@
+export const CUELINE_PROTOCOL = "cueline/0.1";
+//# sourceMappingURL=types.js.map

package/dist/src/protocol/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/protocol/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG,aAAsB,CAAC"}

package/dist/src/protocol/validate-command.d.ts

@@ -0,0 +1,2 @@
+import { type ControllerCommand, type ExpectedControllerIdentity } from "./types.js";
+export declare function validateControllerCommand(value: unknown, expected: ExpectedControllerIdentity): ControllerCommand;

package/dist/src/protocol/validate-command.js

@@ -0,0 +1,181 @@
+import { CueLineError } from "../core/errors.js";
+import { CUELINE_PROTOCOL, } from "./types.js";
+const JOB_KEY_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/;
+const LANE_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/;
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function fail(message, details) {
+    throw new CueLineError("CONTROL_COMMAND_INVALID", message, { details });
+}
+function requiredString(record, key) {
+    const value = record[key];
+    if (typeof value !== "string" || value.trim() === "") {
+        return fail(`'${key}' must be a non-empty string.`, { key });
+    }
+    return value;
+}
+function optionalString(record, key) {
+    const value = record[key];
+    if (value === undefined) {
+        return undefined;
+    }
+    if (typeof value !== "string" || value.trim() === "") {
+        return fail(`'${key}' must be a non-empty string when provided.`, { key });
+    }
+    return value;
+}
+function optionalBoolean(record, key) {
+    const value = record[key];
+    if (value === undefined) {
+        return undefined;
+    }
+    if (typeof value !== "boolean") {
+        return fail(`'${key}' must be a boolean when provided.`, { key });
+    }
+    return value;
+}
+function optionalPositiveInteger(record, key, maximum) {
+    const value = record[key];
+    if (value === undefined) {
+        return undefined;
+    }
+    if (!Number.isSafeInteger(value) || value < 1 || value > maximum) {
+        return fail(`'${key}' must be an integer from 1 to ${maximum}.`, { key });
+    }
+    return value;
+}
+function optionalStringArray(record, key) {
+    const value = record[key];
+    if (value === undefined) {
+        return undefined;
+    }
+    if (!Array.isArray(value) || value.some((item) => typeof item !== "string" || item === "")) {
+        return fail(`'${key}' must be an array of non-empty strings.`, { key });
+    }
+    return [...value];
+}
+function validateJob(value) {
+    if (!isRecord(value)) {
+        return fail("Each dispatch job must be an object.");
+    }
+    const jobKey = requiredString(value, "job_key");
+    if (!JOB_KEY_PATTERN.test(jobKey)) {
+        return fail("'job_key' contains unsupported characters.", { jobKey });
+    }
+    const lane = requiredString(value, "lane");
+    if (!LANE_PATTERN.test(lane)) {
+        return fail("'lane' contains unsupported characters.", { lane });
+    }
+    const mode = requiredString(value, "mode");
+    if (mode !== "advise" && mode !== "work") {
+        throw new CueLineError("CONTROL_MODE_INVALID", `Unsupported job mode '${mode}'.`, {
+            details: { mode },
+        });
+    }
+    const job = {
+        job_key: jobKey,
+        lane,
+        mode,
+        task: requiredString(value, "task"),
+    };
+    const required = optionalBoolean(value, "required");
+    const timeout = optionalPositiveInteger(value, "timeout_ms", 86_400_000);
+    const runner = optionalString(value, "runner");
+    const workdir = optionalString(value, "workdir");
+    const background = optionalBoolean(value, "background");
+    if (required !== undefined)
+        job.required = required;
+    if (timeout !== undefined)
+        job.timeout_ms = timeout;
+    if (runner !== undefined)
+        job.runner = runner;
+    if (workdir !== undefined)
+        job.workdir = workdir;
+    if (background !== undefined)
+        job.background = background;
+    return job;
+}
+function validateIdentity(record, expected) {
+    if (record.run_id !== expected.runId ||
+        record.round !== expected.round ||
+        record.request_id !== expected.requestId) {
+        throw new CueLineError("CONTROL_ID_MISMATCH", "Controller command identity does not match the pending request.", {
+            details: {
+                expected,
+                received: {
+                    runId: record.run_id,
+                    round: record.round,
+                    requestId: record.request_id,
+                },
+            },
+        });
+    }
+}
+export function validateControllerCommand(value, expected) {
+    if (!isRecord(value)) {
+        return fail("Controller command must be a JSON object.");
+    }
+    if (value.protocol !== CUELINE_PROTOCOL) {
+        return fail(`'protocol' must be '${CUELINE_PROTOCOL}'.`);
+    }
+    validateIdentity(value, expected);
+    const action = requiredString(value, "action");
+    const base = {
+        protocol: CUELINE_PROTOCOL,
+        run_id: expected.runId,
+        round: expected.round,
+        request_id: expected.requestId,
+    };
+    if (action === "dispatch") {
+        if (!Array.isArray(value.jobs) || value.jobs.length === 0) {
+            return fail("A dispatch command requires at least one job.");
+        }
+        const jobs = value.jobs.map(validateJob);
+        const seen = new Set();
+        for (const job of jobs) {
+            if (seen.has(job.job_key)) {
+                throw new CueLineError("CONTROL_DUPLICATE_JOB_KEY", `Duplicate job_key '${job.job_key}'.`, { details: { jobKey: job.job_key } });
+            }
+            seen.add(job.job_key);
+        }
+        return { ...base, action, jobs };
+    }
+    if (action === "wait") {
+        const command = { ...base, action };
+        const jobIds = optionalStringArray(value, "job_ids");
+        const waitMs = optionalPositiveInteger(value, "wait_ms", 300_000);
+        if (jobIds !== undefined)
+            command.job_ids = jobIds;
+        if (waitMs !== undefined)
+            command.wait_ms = waitMs;
+        return command;
+    }
+    if (action === "inspect") {
+        const command = { ...base, action };
+        const jobIds = optionalStringArray(value, "job_ids");
+        if (jobIds !== undefined)
+            command.job_ids = jobIds;
+        return command;
+    }
+    if (action === "complete") {
+        return {
+            ...base,
+            action,
+            final_delivery_text: requiredString(value, "final_delivery_text"),
+        };
+    }
+    if (action === "blocked") {
+        const command = {
+            ...base,
+            action,
+            reason: requiredString(value, "reason"),
+        };
+        const finalText = optionalString(value, "final_delivery_text");
+        if (finalText !== undefined)
+            command.final_delivery_text = finalText;
+        return command;
+    }
+    return fail(`Unsupported controller action '${action}'.`, { action });
+}
+//# sourceMappingURL=validate-command.js.map

package/dist/src/protocol/validate-command.js.map

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

package/dist/src/router/availability.d.ts

@@ -0,0 +1,3 @@
+import type { CandidateAvailabilityChecker } from "./types.js";
+export declare function findExecutable(command: string, environment?: NodeJS.ProcessEnv, cwd?: string): string | undefined;
+export declare function executableAvailability(environment?: NodeJS.ProcessEnv, cwd?: string): CandidateAvailabilityChecker;

package/dist/src/router/availability.js

@@ -0,0 +1,55 @@
+import { constants, accessSync } from "node:fs";
+import path from "node:path";
+import { runtimeCwd, runtimeEnvironment, runtimePlatform } from "../core/runtime.js";
+function executableNames(command, environment) {
+    if (runtimePlatform() !== "win32" || path.extname(command) !== "") {
+        return [command];
+    }
+    const extensions = (environment.PATHEXT ?? ".EXE;.CMD;.BAT;.COM")
+        .split(";")
+        .filter(Boolean);
+    return [command, ...extensions.map((extension) => `${command}${extension.toLowerCase()}`)];
+}
+function canExecute(filePath) {
+    try {
+        accessSync(filePath, runtimePlatform() === "win32" ? constants.F_OK : constants.X_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function findExecutable(command, environment = runtimeEnvironment(), cwd = runtimeCwd()) {
+    if (command.trim() === "")
+        return undefined;
+    if (command.includes(path.sep) || (path.sep === "\\" && command.includes("/"))) {
+        const candidate = path.resolve(cwd, command);
+        return canExecute(candidate) ? candidate : undefined;
+    }
+    const directories = (environment.PATH ?? "").split(path.delimiter).filter(Boolean);
+    for (const directory of directories) {
+        for (const name of executableNames(command, environment)) {
+            const candidate = path.join(directory, name);
+            if (canExecute(candidate))
+                return candidate;
+        }
+    }
+    return undefined;
+}
+export function executableAvailability(environment = runtimeEnvironment(), cwd = runtimeCwd()) {
+    const cache = new Map();
+    return {
+        isAvailable(candidate) {
+            const executable = candidate.argv[0];
+            if (executable === undefined)
+                return false;
+            const cached = cache.get(executable);
+            if (cached !== undefined)
+                return cached;
+            const available = findExecutable(executable, environment, cwd) !== undefined;
+            cache.set(executable, available);
+            return available;
+        },
+    };
+}
+//# sourceMappingURL=availability.js.map

package/dist/src/router/availability.js.map

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

package/dist/src/router/config-loader.d.ts

@@ -0,0 +1,3 @@
+import type { RoutingConfig } from "./types.js";
+export declare function parseRoutingConfig(value: unknown): RoutingConfig;
+export declare function loadRoutingConfig(filePath: string): Promise<RoutingConfig>;