harnery 0.15.0 → 0.17.0

package/dist/core/supervisor/service-read.js

@@ -0,0 +1,127 @@
+import { existsSync, readFileSync, statSync } from "node:fs";
+import { hostname } from "node:os";
+import { join, resolve } from "node:path";
+const MAX_FILE_BYTES = 512 * 1024;
+const MAX_GOALS = 100;
+const FOREIGN_STATUS_STALE_MS = 30_000;
+export function readSupervisorServiceConfig(coordRootRaw) {
+    const coordRoot = resolve(coordRootRaw);
+    const config = readBoundedJson(join(serviceDir(coordRoot), "config.json"), "supervisor service configuration");
+    if (config.schema_version !== 1 ||
+        !validTimestamp(config.created_at) ||
+        !Array.isArray(config.goal_ids) ||
+        config.goal_ids.length < 1 ||
+        config.goal_ids.length > MAX_GOALS ||
+        config.goal_ids.some((goalId) => typeof goalId !== "string" || !goalId.trim()) ||
+        !positive(config.wake_interval_ms) ||
+        !positive(config.heartbeat_interval_ms) ||
+        !positive(config.error_backoff_base_ms) ||
+        !positive(config.error_backoff_max_ms) ||
+        config.error_backoff_max_ms < config.error_backoff_base_ms ||
+        !config.engine ||
+        typeof config.engine !== "object" ||
+        typeof config.engine.subscription_only !== "boolean" ||
+        typeof config.engine.allow_api_billing !== "boolean") {
+        throw new Error("supervisor service configuration has an unsupported schema");
+    }
+    return config;
+}
+export function readSupervisorServiceRuntime(coordRootRaw) {
+    const coordRoot = resolve(coordRootRaw);
+    const path = join(serviceDir(coordRoot), "runtime.json");
+    if (!existsSync(path))
+        return undefined;
+    const runtime = readBoundedJson(path, "supervisor service runtime");
+    if (runtime.schema_version !== 1 ||
+        !validTimestamp(runtime.config_created_at) ||
+        !validTimestamp(runtime.updated_at) ||
+        !runtime.goals ||
+        typeof runtime.goals !== "object" ||
+        Array.isArray(runtime.goals)) {
+        throw new Error("supervisor service runtime has an unsupported schema");
+    }
+    return runtime;
+}
+export function readSupervisorServiceStatus(coordRootRaw) {
+    const coordRoot = resolve(coordRootRaw);
+    const record = readStatusRecord(coordRoot);
+    let config;
+    let runtime;
+    try {
+        config = readSupervisorServiceConfig(coordRoot);
+    }
+    catch {
+        // Unconfigured or corrupt service state is represented without throwing.
+    }
+    try {
+        runtime = readSupervisorServiceRuntime(coordRoot);
+    }
+    catch {
+        // Runtime is recoverable and must not make the dashboard unreadable.
+    }
+    if (!record)
+        return { running: false, stale: false, config, runtime };
+    const running = statusOwnerIsLive(record);
+    return { running, stale: !running && record.state !== "stopped", record, config, runtime };
+}
+export function supervisorServiceLogPath(coordRoot) {
+    return join(serviceDir(resolve(coordRoot)), "service.log");
+}
+function readStatusRecord(coordRoot) {
+    const path = join(serviceDir(coordRoot), "status.json");
+    if (!existsSync(path))
+        return undefined;
+    try {
+        const value = readBoundedJson(path, "supervisor service status");
+        if (value.schema_version !== 1 ||
+            !Number.isSafeInteger(value.pid) ||
+            value.pid < 1 ||
+            typeof value.host !== "string" ||
+            typeof value.nonce !== "string" ||
+            !validTimestamp(value.started_at) ||
+            !validTimestamp(value.heartbeat_at)) {
+            return undefined;
+        }
+        return value;
+    }
+    catch {
+        return undefined;
+    }
+}
+function statusOwnerIsLive(record) {
+    if (record.state === "stopped")
+        return false;
+    if (record.host === hostname()) {
+        try {
+            process.kill(record.pid, 0);
+            return true;
+        }
+        catch (error) {
+            return error.code === "EPERM";
+        }
+    }
+    const age = Date.now() - Date.parse(record.heartbeat_at);
+    return Number.isFinite(age) && age < FOREIGN_STATUS_STALE_MS;
+}
+function readBoundedJson(path, label) {
+    if (!existsSync(path))
+        throw new Error(`${label} does not exist`);
+    const size = statSync(path).size;
+    if (size <= 0 || size > MAX_FILE_BYTES)
+        throw new Error(`${label} has invalid size ${size}`);
+    try {
+        return JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch (error) {
+        throw new Error(`cannot parse ${label}: ${error.message}`);
+    }
+}
+function serviceDir(coordRoot) {
+    return join(coordRoot, ".harnery", "supervisor-service");
+}
+function positive(value) {
+    return Number.isSafeInteger(value) && value > 0;
+}
+function validTimestamp(value) {
+    return typeof value === "string" && value.length <= 40 && Number.isFinite(Date.parse(value));
+}

package/dist/core/supervisor/service.d.ts

@@ -0,0 +1,114 @@
+import { type NormalizedPolicy, type PolicyIsolation } from "../policy/index.js";
+import type { RunWorkItemInput } from "../work/index.js";
+import { type SupervisorRunReport, type SupervisorStopReason } from "./runner.js";
+import { type SupervisorRecord } from "./state.js";
+export declare const SUPERVISOR_SERVICE_CONFIG_SCHEMA_VERSION: 1;
+export declare const SUPERVISOR_SERVICE_RUNTIME_SCHEMA_VERSION: 1;
+export declare const SUPERVISOR_SERVICE_STATUS_SCHEMA_VERSION: 1;
+export interface SupervisorServiceEngineConfig {
+    default_harness?: string;
+    cwd?: string;
+    subscription_only: boolean;
+    allow_api_billing: boolean;
+    policy?: NormalizedPolicy;
+    isolation?: PolicyIsolation;
+    approval_addressee?: string;
+}
+export interface SupervisorServiceConfig {
+    schema_version: typeof SUPERVISOR_SERVICE_CONFIG_SCHEMA_VERSION;
+    goal_ids: string[];
+    wake_interval_ms: number;
+    heartbeat_interval_ms: number;
+    error_backoff_base_ms: number;
+    error_backoff_max_ms: number;
+    engine: SupervisorServiceEngineConfig;
+    created_at: string;
+}
+export interface ConfigureSupervisorServiceInput {
+    coordRoot: string;
+    goalIds: readonly string[];
+    wakeIntervalMs?: number;
+    heartbeatIntervalMs?: number;
+    errorBackoffBaseMs?: number;
+    errorBackoffMaxMs?: number;
+    engine?: Partial<SupervisorServiceEngineConfig>;
+}
+export type SupervisorServiceGoalState = "idle" | "backoff" | "awaiting_change";
+export interface SupervisorServiceGoalRuntime {
+    state: SupervisorServiceGoalState;
+    consecutive_errors: number;
+    observed_fingerprint?: string;
+    next_wake_at?: string;
+    last_tick_at?: string;
+    last_stop_reason?: SupervisorStopReason;
+    last_error?: string;
+}
+export interface SupervisorServiceRuntime {
+    schema_version: typeof SUPERVISOR_SERVICE_RUNTIME_SCHEMA_VERSION;
+    config_created_at: string;
+    updated_at: string;
+    goals: Record<string, SupervisorServiceGoalRuntime>;
+}
+export type SupervisorServiceProcessState = "starting" | "running" | "stopping" | "stopped";
+export interface SupervisorServiceStatusRecord {
+    schema_version: typeof SUPERVISOR_SERVICE_STATUS_SCHEMA_VERSION;
+    pid: number;
+    host: string;
+    nonce: string;
+    state: SupervisorServiceProcessState;
+    started_at: string;
+    heartbeat_at: string;
+    config_created_at: string;
+    sweep_count: number;
+    active_goal_id?: string;
+    last_sweep_at?: string;
+    next_wake_at?: string;
+    last_error?: string;
+    stopped_at?: string;
+}
+export interface SupervisorServiceStatus {
+    running: boolean;
+    stale: boolean;
+    record?: SupervisorServiceStatusRecord;
+    config?: SupervisorServiceConfig;
+    runtime?: SupervisorServiceRuntime;
+}
+export interface SupervisorServiceSweepOutcome {
+    goal_id: string;
+    action: "tick" | "skip" | "backoff";
+    reason: string;
+    stop_reason?: SupervisorStopReason;
+    next_wake_at?: string;
+}
+export interface SupervisorServiceSweepReport {
+    started_at: string;
+    ended_at: string;
+    outcomes: SupervisorServiceSweepOutcome[];
+}
+export interface RunSupervisorServiceSweepInput {
+    coordRoot: string;
+    config: SupervisorServiceConfig;
+    engine?: Omit<RunWorkItemInput["engine"], "maxAgents" | "concurrency" | "specialists">;
+    actor?: string;
+    now?: () => number;
+    readGoal?: (coordRoot: string, goalId: string) => SupervisorRecord;
+    runGoal?: (goalId: string) => Promise<SupervisorRunReport>;
+    onGoalStart?: (goalId: string) => void;
+}
+export interface RunSupervisorServiceDaemonInput {
+    coordRoot: string;
+    engine: Omit<RunWorkItemInput["engine"], "maxAgents" | "concurrency" | "specialists">;
+    actor?: string;
+    maxSweeps?: number;
+    onLog?: (line: string) => void;
+}
+export declare function configureSupervisorService(input: ConfigureSupervisorServiceInput): SupervisorServiceConfig;
+export declare function readSupervisorServiceConfig(coordRootRaw: string): SupervisorServiceConfig;
+export declare function readSupervisorServiceRuntime(coordRootRaw: string): SupervisorServiceRuntime | undefined;
+export declare function readSupervisorServiceStatus(coordRootRaw: string): SupervisorServiceStatus;
+export declare function spawnSupervisorService(coordRootRaw: string): Promise<SupervisorServiceStatus>;
+export declare function requestSupervisorServiceStop(coordRootRaw: string): SupervisorServiceStatus;
+export declare function runSupervisorServiceSweep(input: RunSupervisorServiceSweepInput): Promise<SupervisorServiceSweepReport>;
+export declare function runSupervisorServiceDaemon(input: RunSupervisorServiceDaemonInput): Promise<SupervisorServiceStatusRecord>;
+export declare function supervisorServiceLogPath(coordRoot: string): string;
+//# sourceMappingURL=service.d.ts.map

package/dist/core/supervisor/service.d.ts.map

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