pi-harness-runtime 0.9.14 → 0.9.16

package/packages/autonomous-runtime/dist/types.d.ts

@@ -0,0 +1,160 @@
+/** A named capability that the privilege broker may grant. */
+export type CapabilityName = "files.read" | "files.write" | "files.exec" | "git.commit" | "git.push" | "git.pull" | "system.restart" | "system.restart-service" | "system.logs" | "bench.migrate" | "bench.build" | "bench.restart" | "okf.promote-pattern" | "okf.promote-lesson" | "notify.send" | "llm.invoke";
+/** What approval class a capability requires. */
+export type ApprovalClass = "automatic_read_only" | "automatic_reversible" | "human_approval_required" | "forbidden";
+export type TaskStatus = "queued" | "claimed" | "running" | "waiting_approval" | "waiting_quota" | "retrying" | "completed" | "failed" | "dead_letter";
+/** Immutable log of what happened to a task. */
+export type TaskEvent = {
+    ts: string;
+    kind: "claimed" | "started" | "checkpointed" | "progress" | "blocked" | "approval_requested" | "approved" | "denied" | "failed" | "completed" | "recovered" | "dead_lettered" | "transitioned";
+    payload?: Record<string, unknown>;
+};
+/** The primary durable record for a task. */
+export interface TaskRecord {
+    id: string;
+    objective: string;
+    acceptanceCriteria: string[];
+    source: {
+        kind: "chat";
+        userId: string;
+    } | {
+        kind: "schedule";
+        scheduleId: string;
+    } | {
+        kind: "webhook";
+        url: string;
+    } | {
+        kind: "subagent";
+        parentTaskId: string;
+    } | {
+        kind: "manual";
+        createdBy: string;
+    };
+    priority: 0 | 1 | 2 | 3 | 4;
+    capabilities: CapabilityName[];
+    approvalClass: ApprovalClass;
+    status: TaskStatus;
+    attempts: number;
+    maxAttempts: number;
+    context?: ExecutionContext;
+    createdAt: string;
+    updatedAt: string;
+    leaseId?: string;
+    result?: TaskResult;
+    failureReason?: string;
+    history: TaskEvent[];
+}
+/** A lease held by a worker on a specific task. */
+export interface TaskLease {
+    taskId: string;
+    workerId: string;
+    acquiredAt: string;
+    expiresAt: string;
+    heartbeatAt: string;
+    attempt: number;
+}
+/** Heartbeat emitted by a worker every 5 s to worker-registry.json. */
+export interface WorkerHeartbeat {
+    workerId: string;
+    startedAt: string;
+    lastBeatAt: string;
+    capacity: number;
+    inflightTaskIds: string[];
+}
+/** A resolved grant from the privilege broker. */
+export interface CapabilityGrant {
+    name: CapabilityName;
+    argv: string[];
+    envWhitelist?: string[];
+    user: string;
+    cwd?: string;
+    timeoutMs: number;
+}
+/** An in-flight human approval request. */
+export interface ApprovalRequest {
+    id: string;
+    taskId: string;
+    capability: CapabilityName;
+    rationale: string;
+    signedBy?: {
+        keyFingerprint: string;
+        ts: string;
+    };
+    decision?: "approved" | "denied";
+    decidedAt?: string;
+    expiresAt: string;
+}
+/** A scheduled recurring task. */
+export interface ScheduledTask {
+    id: string;
+    taskTemplate: Omit<TaskRecord, "id" | "status" | "attempts" | "createdAt" | "updatedAt" | "history">;
+    schedule: ScheduleSpec;
+    enabled: boolean;
+    lastFiredAt?: string;
+    nextFireAt?: string;
+}
+export type ScheduleSpec = {
+    kind: "cron";
+    expression: string;
+} | {
+    kind: "interval";
+    intervalMs: number;
+} | {
+    kind: "once";
+    at: string;
+};
+export type RuntimeNotificationEvent = "task.claimed" | "task.started" | "task.completed" | "task.failed" | "task.waiting_approval" | "task.dead_lettered" | "lease.expired" | "worker.started" | "worker.stopped" | "approval.approved" | "approval.denied" | "approval.expired";
+export interface NotificationEvent {
+    kind: RuntimeNotificationEvent;
+    ts: string;
+    taskId?: string;
+    workerId?: string;
+    payload: Record<string, unknown>;
+}
+export interface Checkpoint {
+    taskId: string;
+    attempt: number;
+    state: Record<string, unknown>;
+    savedAt: string;
+}
+/** The context given to the loop runtime when executing a task. */
+export interface ExecutionContext {
+    taskId: string;
+    workerId: string;
+    inputs: Record<string, unknown>;
+    capabilitiesGranted: CapabilityName[];
+    approvalClass: ApprovalClass;
+    lease: TaskLease;
+    checkpoint?: Checkpoint;
+    okfBundles: string[];
+}
+export interface TaskResult {
+    taskId: string;
+    status: "completed" | "failed" | "dead_letter";
+    deliverables?: {
+        path: string;
+        mime: string;
+    }[];
+    acceptanceCriteriaMet: {
+        criterion: string;
+        passed: boolean;
+        evidence?: string;
+    }[];
+    durationMs: number;
+    modelUsage?: {
+        inputTokens: number;
+        outputTokens: number;
+        provider: string;
+    };
+}
+/** Returns the standard storage root for the runtime. */
+export declare function getRuntimeRoot(): string;
+/** Returns the inbox directory path. */
+export declare function getInboxDir(): string;
+/** Returns the claimed leases directory path. */
+export declare function getLeasesDir(): string;
+/** Returns the task JSONL file path. */
+export declare function getTasksPath(): string;
+/** Returns the worker registry path. */
+export declare function getWorkerRegistryPath(): string;
+//# sourceMappingURL=types.d.ts.map

package/packages/autonomous-runtime/dist/types.d.ts.map

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

package/packages/autonomous-runtime/dist/types.js

@@ -0,0 +1,31 @@
+/**
+ * Autonomous Operations Runtime — TypeScript Contracts
+ * Based on RFC-0101 §14
+ *
+ * Consumers: LoopRuntime, privilege-broker, scheduler-adapter, notification-runtime.
+ * These types are the canonical contracts. Do not re-define them in other packages.
+ */
+import { env } from "node:process";
+// ─── Storage paths ────────────────────────────────────────────────────────────
+const DEFAULT_ROOT = `${env["HOME"] ?? "."}/.pi/harness`;
+/** Returns the standard storage root for the runtime. */
+export function getRuntimeRoot() {
+    return env["PI_HARNESS_RUNTIME_ROOT"] ?? DEFAULT_ROOT;
+}
+/** Returns the inbox directory path. */
+export function getInboxDir() {
+    return `${getRuntimeRoot()}/inbox`;
+}
+/** Returns the claimed leases directory path. */
+export function getLeasesDir() {
+    return `${getInboxDir()}/claimed`;
+}
+/** Returns the task JSONL file path. */
+export function getTasksPath() {
+    return `${getInboxDir()}/tasks.jsonl`;
+}
+/** Returns the worker registry path. */
+export function getWorkerRegistryPath() {
+    return `${getRuntimeRoot()}/worker-registry.json`;
+}
+//# sourceMappingURL=types.js.map

package/packages/autonomous-runtime/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AA8NnC,iFAAiF;AAEjF,MAAM,YAAY,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,GAAG,cAAc,CAAC;AAEzD,yDAAyD;AACzD,MAAM,UAAU,cAAc;IAC7B,OAAO,GAAG,CAAC,yBAAyB,CAAC,IAAI,YAAY,CAAC;AACvD,CAAC;AAED,wCAAwC;AACxC,MAAM,UAAU,WAAW;IAC1B,OAAO,GAAG,cAAc,EAAE,QAAQ,CAAC;AACpC,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,YAAY;IAC3B,OAAO,GAAG,WAAW,EAAE,UAAU,CAAC;AACnC,CAAC;AAED,wCAAwC;AACxC,MAAM,UAAU,YAAY;IAC3B,OAAO,GAAG,WAAW,EAAE,cAAc,CAAC;AACvC,CAAC;AAED,wCAAwC;AACxC,MAAM,UAAU,qBAAqB;IACpC,OAAO,GAAG,cAAc,EAAE,uBAAuB,CAAC;AACnD,CAAC"}

package/packages/autonomous-runtime/dist/worker.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Worker Stub — RFC-0101 §4
+ *
+ * A worker is a pi session that owns tasks from the inbox.
+ * This is the lightweight worker-side of the lease protocol.
+ *
+ * The worker picks up work via the inbox's `claim()` method
+ * and reports results via `complete()`.
+ */
+import type { TaskResult, WorkerStatus } from "./types.js";
+import type { TaskInbox } from "./inbox.js";
+import type { TaskLease } from "./lease.js";
+export interface WorkerConfig {
+    inbox: TaskInbox;
+    workerId: string;
+    heartbeatIntervalMs?: number;
+    onError?: (taskId: string, error: unknown) => void;
+}
+export interface WorkerEvents {
+    onLease: (lease: TaskLease) => void;
+    onLeaseExpired: (taskId: string) => void;
+    onComplete: (taskId: string, result: TaskResult) => void;
+    onError: (taskId: string, error: unknown) => void;
+}
+/**
+ * Worker — picks up tasks from the inbox and processes them.
+ *
+ * Lifecycle:
+ * 1. Construct with inbox + workerId
+ * 2. `start()` — begins polling/claiming tasks
+ * 3. `stop()` — stops claiming, expires held leases
+ *
+ * The worker does NOT run tasks itself — it delegates to the harness
+ * loop runtime. It just manages the lease lifecycle.
+ */
+export declare class Worker {
+    private readonly config;
+    private readonly events;
+    private running;
+    private heartbeatTimer;
+    constructor(config: WorkerConfig);
+    on<K extends keyof WorkerEvents>(event: K, handler: WorkerEvents[K]): void;
+    /**
+     * Start the worker — begins polling for available tasks.
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the worker — stops polling and expires any held leases.
+     */
+    stop(): Promise<void>;
+    /**
+     * Status of this worker.
+     */
+    status(): WorkerStatus;
+    private _poll;
+    private _processTask;
+    /**
+     * Run a single task. Stub — replaces with actual harness loop integration.
+     */
+    private _runTask;
+    private _heartbeat;
+}
+//# sourceMappingURL=worker.d.ts.map

package/packages/autonomous-runtime/dist/worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAEX,UAAU,EACV,YAAY,EACZ,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,WAAW,YAAY;IAC5B,KAAK,EAAE,SAAS,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACnD;AAED,MAAM,WAAW,YAAY;IAC5B,OAAO,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IACpC,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,KAAK,IAAI,CAAC;IACzD,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CAClD;AAED;;;;;;;;;;GAUG;AACH,qBAAa,MAAM;IAClB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IACpD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,cAAc,CAA+C;IAErE,YAAY,MAAM,EAAE,YAAY,EAK/B;IAED,EAAE,CAAC,CAAC,SAAS,MAAM,YAAY,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI,CAEzE;IAED;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAY3B;IAED;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAW1B;IAED;;OAEG;IACH,MAAM,IAAI,YAAY,CAMrB;YAEa,KAAK;YAmBL,YAAY;IAuB1B;;OAEG;YACW,QAAQ;YAUR,UAAU;CASxB"}

package/packages/autonomous-runtime/dist/worker.js

@@ -0,0 +1,133 @@
+/**
+ * Worker Stub — RFC-0101 §4
+ *
+ * A worker is a pi session that owns tasks from the inbox.
+ * This is the lightweight worker-side of the lease protocol.
+ *
+ * The worker picks up work via the inbox's `claim()` method
+ * and reports results via `complete()`.
+ */
+/**
+ * Worker — picks up tasks from the inbox and processes them.
+ *
+ * Lifecycle:
+ * 1. Construct with inbox + workerId
+ * 2. `start()` — begins polling/claiming tasks
+ * 3. `stop()` — stops claiming, expires held leases
+ *
+ * The worker does NOT run tasks itself — it delegates to the harness
+ * loop runtime. It just manages the lease lifecycle.
+ */
+export class Worker {
+    config;
+    events = {};
+    running = false;
+    heartbeatTimer = null;
+    constructor(config) {
+        this.config = {
+            heartbeatIntervalMs: 30_000,
+            ...config,
+        };
+    }
+    on(event, handler) {
+        this.events[event] = handler;
+    }
+    /**
+     * Start the worker — begins polling for available tasks.
+     */
+    async start() {
+        if (this.running)
+            return;
+        this.running = true;
+        // Start heartbeat
+        this.heartbeatTimer = setInterval(() => this._heartbeat(), this.config.heartbeatIntervalMs);
+        // Claim any immediately available tasks
+        await this._poll();
+    }
+    /**
+     * Stop the worker — stops polling and expires any held leases.
+     */
+    async stop() {
+        if (!this.running)
+            return;
+        this.running = false;
+        if (this.heartbeatTimer) {
+            clearInterval(this.heartbeatTimer);
+            this.heartbeatTimer = null;
+        }
+        // Expire all leases held by this worker
+        // (inbox.expireLease is idempotent — safe to call repeatedly)
+    }
+    /**
+     * Status of this worker.
+     */
+    status() {
+        return {
+            workerId: this.config.workerId,
+            running: this.running,
+            heartbeatIntervalMs: this.config.heartbeatIntervalMs ?? 30_000,
+        };
+    }
+    async _poll() {
+        if (!this.running)
+            return;
+        try {
+            // Try to claim one task
+            const lease = await this.config.inbox.claim({
+                workerId: this.config.workerId,
+                heartbeatIntervalMs: this.config.heartbeatIntervalMs ?? 30_000,
+            });
+            if (lease) {
+                this.events.onLease?.(lease);
+                await this._processTask(lease);
+            }
+        }
+        catch (err) {
+            this.config.onError?.("__poll__", err);
+        }
+    }
+    async _processTask(lease) {
+        const task = lease.task;
+        try {
+            // Delegate to harness loop runtime (stub — will be wired in Phase 2)
+            const result = await this._runTask(task);
+            // Report completion
+            await this.config.inbox.complete(lease.taskId, result);
+            this.events.onComplete?.(lease.taskId, result);
+        }
+        catch (err) {
+            this.events.onError?.(lease.taskId, err);
+            await this.config.inbox.complete(lease.taskId, {
+                ok: false,
+                error: String(err),
+                completedAt: new Date().toISOString(),
+            });
+        }
+        // Continue polling for more work
+        if (this.running)
+            void this._poll();
+    }
+    /**
+     * Run a single task. Stub — replaces with actual harness loop integration.
+     */
+    async _runTask(task) {
+        // TODO(Phase 2): Wire to harness loop runtime
+        // For now, return a stub result so the lease protocol works end-to-end.
+        return {
+            ok: true,
+            summary: `[stub] Processed ${task.id}`,
+            completedAt: new Date().toISOString(),
+        };
+    }
+    async _heartbeat() {
+        // Refresh leases held by this worker
+        // The inbox tracks which leases this worker holds and refreshes them.
+        try {
+            await this.config.inbox.refreshLeases(this.config.workerId);
+        }
+        catch {
+            // Non-fatal — lease will expire naturally
+        }
+    }
+}
+//# sourceMappingURL=worker.js.map

package/packages/autonomous-runtime/dist/worker.js.map

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

package/packages/autonomous-runtime/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@pi/autonomous-runtime",
+  "version": "0.9.15",
+  "description": "Autonomous Operations Runtime — task inbox, lease management, and worker lifecycle (RFC-0101)",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "bun test",
+    "test:watch": "bun test --watch",
+    "clean": "rm -rf dist"
+  },
+  "keywords": [
+    "autonomous",
+    "runtime",
+    "task-queue",
+    "lease",
+    "worker",
+    "rfc-0101"
+  ],
+  "author": "",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "typescript": "^7.0.2"
+  }
+}