@osolmaz/pi-workflows 0.2.0 → 0.3.0

package/dist/controllers/effects.js

@@ -0,0 +1,104 @@
+import { jsonFingerprint } from "./json.js";
+export class ControllerEffectService {
+    store;
+    resource;
+    signal;
+    used = false;
+    constructor(store, resource, signal) {
+        this.store = store;
+        this.resource = resource;
+        this.signal = signal;
+    }
+    async ensure(definition) {
+        if (this.used) {
+            throw new Error("A reconciliation pass may ensure only one external effect");
+        }
+        this.used = true;
+        const requestFingerprint = jsonFingerprint(definition.request);
+        const reservation = this.store.reserveEffect({
+            key: definition.key,
+            resourceUid: this.resource.metadata.uid,
+            generation: this.resource.metadata.generation,
+            kind: definition.kind,
+            requestFingerprint,
+        });
+        if (reservation.record.state === "applied" || reservation.record.state === "rejected") {
+            return reservation.record;
+        }
+        if (!reservation.created) {
+            const observed = await this.observe(definition);
+            const recovered = this.applyObservation(definition.key, observed);
+            if (recovered !== undefined) {
+                return recovered;
+            }
+        }
+        return await this.apply(definition);
+    }
+    async observe(definition) {
+        try {
+            return await definition.observe(this.signal);
+        }
+        catch (error) {
+            this.recordEvent("effect_observe_failed", definition.key, {
+                error: boundedError(error),
+            });
+            throw error;
+        }
+    }
+    applyObservation(key, observation) {
+        if (observation.state === "not_applied") {
+            return undefined;
+        }
+        const record = this.store.updateEffect({
+            resourceUid: this.resource.metadata.uid,
+            key,
+            state: observation.state === "applied" ? "applied" : "indeterminate",
+            ...("externalRef" in observation && observation.externalRef !== undefined
+                ? { externalRef: observation.externalRef }
+                : {}),
+        });
+        this.recordEvent(observation.state === "applied" ? "effect_recovered" : "effect_indeterminate", key);
+        return record;
+    }
+    async apply(definition) {
+        let result;
+        try {
+            result = await definition.apply(this.signal);
+        }
+        catch (error) {
+            const message = boundedError(error);
+            const record = this.store.updateEffect({
+                resourceUid: this.resource.metadata.uid,
+                key: definition.key,
+                state: "indeterminate",
+                error: message,
+            });
+            this.recordEvent("effect_indeterminate", definition.key, { error: message });
+            return record;
+        }
+        const record = this.store.updateEffect({
+            resourceUid: this.resource.metadata.uid,
+            key: definition.key,
+            state: result.state,
+            ...(result.state === "applied" && result.externalRef !== undefined
+                ? { externalRef: result.externalRef }
+                : {}),
+            ...(result.state !== "applied" && result.error !== undefined ? { error: result.error } : {}),
+        });
+        this.recordEvent(`effect_${result.state}`, definition.key);
+        return record;
+    }
+    recordEvent(type, effectKey, extra = {}) {
+        this.store.recordEvent({
+            controller: this.resource.metadata.controller,
+            key: this.resource.metadata.key,
+            type,
+            payload: { effectKey, ...extra },
+        });
+    }
+}
+function boundedError(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return message.length <= 8_192 ? message : `${message.slice(0, 8_192)}…`;
+}
+//# sourceMappingURL=effects.js.map

package/dist/controllers/effects.js.map

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

package/dist/controllers/errors.d.ts

@@ -0,0 +1,12 @@
+export declare class ResourceConflictError extends Error {
+    constructor(controller: string, key: string);
+}
+export declare class ResourceNotFoundError extends Error {
+    constructor(controller: string, key: string);
+}
+export declare class EffectRequestConflictError extends Error {
+    constructor(key: string);
+}
+export declare class WorkflowRequestConflictError extends Error {
+    constructor(key: string);
+}

package/dist/controllers/errors.js

@@ -0,0 +1,25 @@
+export class ResourceConflictError extends Error {
+    constructor(controller, key) {
+        super(`Controller resource ${controller}/${key} changed during reconciliation`);
+        this.name = "ResourceConflictError";
+    }
+}
+export class ResourceNotFoundError extends Error {
+    constructor(controller, key) {
+        super(`Controller resource not found: ${controller}/${key}`);
+        this.name = "ResourceNotFoundError";
+    }
+}
+export class EffectRequestConflictError extends Error {
+    constructor(key) {
+        super(`Effect key ${JSON.stringify(key)} was reused with a different request`);
+        this.name = "EffectRequestConflictError";
+    }
+}
+export class WorkflowRequestConflictError extends Error {
+    constructor(key) {
+        super(`Workflow request key ${JSON.stringify(key)} was reused with different input`);
+        this.name = "WorkflowRequestConflictError";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/controllers/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/controllers/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC9C,YAAY,UAAkB,EAAE,GAAW;QACzC,KAAK,CAAC,uBAAuB,UAAU,IAAI,GAAG,gCAAgC,CAAC,CAAC;QAChF,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AAED,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC9C,YAAY,UAAkB,EAAE,GAAW;QACzC,KAAK,CAAC,kCAAkC,UAAU,IAAI,GAAG,EAAE,CAAC,CAAC;QAC7D,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AAED,MAAM,OAAO,0BAA2B,SAAQ,KAAK;IACnD,YAAY,GAAW;QACrB,KAAK,CAAC,cAAc,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC;QAC/E,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;IAC3C,CAAC;CACF;AAED,MAAM,OAAO,4BAA6B,SAAQ,KAAK;IACrD,YAAY,GAAW;QACrB,KAAK,CAAC,wBAAwB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;QACrF,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAC;IAC7C,CAAC;CACF"}

package/dist/controllers/index.d.ts

@@ -0,0 +1,13 @@
+export { assertValidControllerDefinition, defineController, isControllerDefinition, } from "./definition.js";
+export { applyStatusPatch, conditionFalse, conditionTrue, conditionUnknown, mergeConditions, } from "./conditions.js";
+export { EffectRequestConflictError, ResourceConflictError, ResourceNotFoundError, WorkflowRequestConflictError, } from "./errors.js";
+export { ControllerEffectService } from "./effects.js";
+export { canonicalJson, jsonFingerprint } from "./json.js";
+export { ControllerManager, type ControllerManagerOptions } from "./manager.js";
+export { createResultHelpers, requeue, requeueAfter, settled } from "./results.js";
+export { SqliteControllerStore, type RunEventRecord, type WorkflowRunQueueRecord, } from "./sqlite.js";
+export { CONTROLLER_STORE_SCHEMA, controllerProjectScope, controllerStoreBaseDir, controllerStorePath, projectControllerStoreBaseDir, projectControllerStorePath, type ControllerStore, type EffectReservation, type QueueItem, type QueueRequeueOptions, type WorkflowRecordUpdate, type WorkflowReservation, } from "./store.js";
+export { controllerFileStem, controllerSearchDirs, discoverControllers, loadControllerFile, loadDiscoveredControllers, type DiscoveredController, } from "./loader.js";
+export { WorkflowEngineScheduler, type ResolvedChildWorkflow, type WorkflowEngineSchedulerOptions, } from "./workflow-engine-scheduler.js";
+export { ControllerWorkflowCoordinator, type ControllerWorkflowScheduler, type WorkflowSchedulerRequest, type WorkflowSchedulerResult, } from "./workflows.js";
+export type { AnyControllerDefinition, ChildWorkflowRecord, ChildWorkflowReference, ChildWorkflowRequest, ChildWorkflowState, ControllerCondition, ControllerConditionInput, ControllerConditionStatus, ControllerDefinition, ControllerEffects, ControllerEvent, ControllerQueueClaim, ControllerResource, ControllerResourceRef, ControllerResourceStatus, ControllerStatusPatch, ControllerWorkflows, EffectApplication, EffectDefinition, EffectObservation, EffectRecord, EffectState, JsonObject, JsonPrimitive, JsonValue, MaybePromise, ReconcileContext, ReconcileResult, } from "./types.js";

package/dist/controllers/index.js

@@ -0,0 +1,13 @@
+export { assertValidControllerDefinition, defineController, isControllerDefinition, } from "./definition.js";
+export { applyStatusPatch, conditionFalse, conditionTrue, conditionUnknown, mergeConditions, } from "./conditions.js";
+export { EffectRequestConflictError, ResourceConflictError, ResourceNotFoundError, WorkflowRequestConflictError, } from "./errors.js";
+export { ControllerEffectService } from "./effects.js";
+export { canonicalJson, jsonFingerprint } from "./json.js";
+export { ControllerManager } from "./manager.js";
+export { createResultHelpers, requeue, requeueAfter, settled } from "./results.js";
+export { SqliteControllerStore, } from "./sqlite.js";
+export { CONTROLLER_STORE_SCHEMA, controllerProjectScope, controllerStoreBaseDir, controllerStorePath, projectControllerStoreBaseDir, projectControllerStorePath, } from "./store.js";
+export { controllerFileStem, controllerSearchDirs, discoverControllers, loadControllerFile, loadDiscoveredControllers, } from "./loader.js";
+export { WorkflowEngineScheduler, } from "./workflow-engine-scheduler.js";
+export { ControllerWorkflowCoordinator, } from "./workflows.js";
+//# sourceMappingURL=index.js.map

package/dist/controllers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/controllers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,+BAA+B,EAC/B,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,eAAe,GAChB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,0BAA0B,EAC1B,qBAAqB,EACrB,qBAAqB,EACrB,4BAA4B,GAC7B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAiC,MAAM,cAAc,CAAC;AAChF,OAAO,EAAE,mBAAmB,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACnF,OAAO,EACL,qBAAqB,GAGtB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,EACnB,6BAA6B,EAC7B,0BAA0B,GAO3B,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,yBAAyB,GAE1B,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,uBAAuB,GAGxB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,6BAA6B,GAI9B,MAAM,gBAAgB,CAAC"}

package/dist/controllers/json.d.ts

@@ -0,0 +1,5 @@
+import type { JsonValue } from "./types.js";
+export declare function assertJsonValue(value: unknown, description: string): asserts value is JsonValue;
+export declare function canonicalJson(value: unknown, description?: string): string;
+export declare function jsonFingerprint(value: unknown): string;
+export declare function parseStoredJson<T>(value: string, description: string): T;

package/dist/controllers/json.js

@@ -0,0 +1,57 @@
+import { createHash } from "node:crypto";
+export function assertJsonValue(value, description) {
+    normalizeJson(value, description, new Set());
+}
+export function canonicalJson(value, description = "value") {
+    return JSON.stringify(normalizeJson(value, description, new Set()));
+}
+export function jsonFingerprint(value) {
+    return createHash("sha256").update(canonicalJson(value)).digest("hex");
+}
+export function parseStoredJson(value, description) {
+    let parsed;
+    try {
+        parsed = JSON.parse(value);
+    }
+    catch (error) {
+        throw new Error(`${description} contains invalid JSON: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    assertJsonValue(parsed, description);
+    return parsed;
+}
+function normalizeJson(value, path, seen) {
+    if (value === null || typeof value === "string" || typeof value === "boolean") {
+        return value;
+    }
+    if (typeof value === "number") {
+        if (!Number.isFinite(value)) {
+            throw new Error(`${path} contains a non-finite number`);
+        }
+        return value;
+    }
+    if (typeof value !== "object") {
+        throw new Error(`${path} is not JSON-serializable`);
+    }
+    if (seen.has(value)) {
+        throw new Error(`${path} contains a cycle`);
+    }
+    seen.add(value);
+    try {
+        if (Array.isArray(value)) {
+            return value.map((item, index) => normalizeJson(item, `${path}[${index}]`, seen));
+        }
+        const prototype = Object.getPrototypeOf(value);
+        if (prototype !== Object.prototype && prototype !== null) {
+            throw new Error(`${path} must contain only plain objects and arrays`);
+        }
+        const result = {};
+        for (const key of Object.keys(value).sort()) {
+            result[key] = normalizeJson(value[key], `${path}.${key}`, seen);
+        }
+        return result;
+    }
+    finally {
+        seen.delete(value);
+    }
+}
+//# sourceMappingURL=json.js.map

package/dist/controllers/json.js.map

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

package/dist/controllers/loader.d.ts

@@ -0,0 +1,23 @@
+import type { AnyControllerDefinition } from "./types.js";
+export type DiscoveredController = {
+    name: string;
+    path: string;
+    source: "project" | "global";
+};
+export declare function controllerSearchDirs(options: {
+    cwd: string;
+    homeDir?: string;
+}): {
+    dir: string;
+    source: DiscoveredController["source"];
+}[];
+export declare function controllerFileStem(filePath: string): string;
+export declare function loadControllerFile(filePath: string): Promise<AnyControllerDefinition>;
+export declare function discoverControllers(options: {
+    cwd: string;
+    homeDir?: string;
+}): Promise<DiscoveredController[]>;
+export declare function loadDiscoveredControllers(options: {
+    cwd: string;
+    homeDir?: string;
+}): Promise<AnyControllerDefinition[]>;

package/dist/controllers/loader.js

@@ -0,0 +1,74 @@
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+import { createJiti } from "jiti";
+import { isControllerDefinition } from "./definition.js";
+const CONTROLLER_FILE_SUFFIXES = [
+    ".controller.ts",
+    ".controller.js",
+    ".controller.mts",
+    ".controller.mjs",
+];
+export function controllerSearchDirs(options) {
+    const homeDir = options.homeDir ?? os.homedir();
+    return [
+        { dir: path.join(options.cwd, ".pi", "controllers"), source: "project" },
+        { dir: path.join(homeDir, ".pi", "agent", "controllers"), source: "global" },
+    ];
+}
+export function controllerFileStem(filePath) {
+    const base = path.basename(filePath);
+    const suffix = CONTROLLER_FILE_SUFFIXES.find((candidate) => base.endsWith(candidate));
+    return suffix === undefined ? base : base.slice(0, -suffix.length);
+}
+const CONTROLLER_ENTRY = path.join(path.dirname(fileURLToPath(import.meta.url)), "index");
+const WORKFLOW_ENTRY = path.join(path.dirname(fileURLToPath(import.meta.url)), "../workflows/index");
+export async function loadControllerFile(filePath) {
+    const absolutePath = path.resolve(filePath);
+    const jiti = createJiti(pathToFileURL(absolutePath).href, {
+        interopDefault: true,
+        moduleCache: false,
+        alias: {
+            "@osolmaz/pi-workflows/controllers": CONTROLLER_ENTRY,
+            "@osolmaz/pi-workflows": WORKFLOW_ENTRY,
+        },
+    });
+    const loaded = (await jiti.import(absolutePath, { default: true }));
+    if (!isControllerDefinition(loaded)) {
+        throw new Error(`Controller module must default-export defineController(...): ${absolutePath}`);
+    }
+    return loaded;
+}
+export async function discoverControllers(options) {
+    const discovered = [];
+    const seen = new Set();
+    for (const { dir, source } of controllerSearchDirs(options)) {
+        for (const filePath of await listControllerFiles(dir)) {
+            const name = controllerFileStem(filePath);
+            if (seen.has(name)) {
+                continue;
+            }
+            seen.add(name);
+            discovered.push({ name, path: filePath, source });
+        }
+    }
+    return discovered;
+}
+export async function loadDiscoveredControllers(options) {
+    return await Promise.all((await discoverControllers(options)).map(async (entry) => await loadControllerFile(entry.path)));
+}
+async function listControllerFiles(dir) {
+    let entries;
+    try {
+        entries = await fs.readdir(dir, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+    return entries
+        .filter((entry) => entry.isFile() && CONTROLLER_FILE_SUFFIXES.some((suffix) => entry.name.endsWith(suffix)))
+        .map((entry) => path.join(dir, entry.name))
+        .sort();
+}
+//# sourceMappingURL=loader.js.map

package/dist/controllers/loader.js.map

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

package/dist/controllers/manager.d.ts

@@ -0,0 +1,58 @@
+import type { ControllerStore } from "./store.js";
+import type { AnyControllerDefinition, ControllerDefinition, ControllerResource, ControllerResourceRef } from "./types.js";
+import { ControllerWorkflowCoordinator, type ControllerWorkflowScheduler } from "./workflows.js";
+export type ControllerManagerOptions = {
+    store: ControllerStore;
+    controllers: AnyControllerDefinition[];
+    workflowScheduler?: ControllerWorkflowScheduler;
+    maxConcurrent?: number;
+    controllerConcurrency?: Record<string, number>;
+    defaultTimeoutMs?: number;
+    leaseMs?: number;
+    pollIntervalMs?: number;
+    baseBackoffMs?: number;
+    maxBackoffMs?: number;
+    jitterRatio?: number;
+    now?: () => Date;
+    random?: () => number;
+};
+export declare class ControllerManager {
+    readonly store: ControllerStore;
+    private readonly definitions;
+    private readonly workflowCoordinator;
+    private readonly maxConcurrent;
+    private readonly controllerConcurrency;
+    private readonly defaultTimeoutMs;
+    private readonly leaseMs;
+    private readonly pollIntervalMs;
+    private readonly baseBackoffMs;
+    private readonly maxBackoffMs;
+    private readonly jitterRatio;
+    private readonly now;
+    private readonly random;
+    private readonly activeByController;
+    private readonly activeReconciles;
+    private runAbort;
+    private workerTasks;
+    constructor(options: ControllerManagerOptions);
+    putResource<TSpec, TStatus>(definition: ControllerDefinition<TSpec, TStatus>, key: string, spec: TSpec): ControllerResource<TSpec, TStatus>;
+    putResourceByName(controller: string, key: string, spec: unknown): ControllerResource;
+    requestDeletion(ref: ControllerResourceRef): ControllerResource;
+    enqueue(ref: ControllerResourceRef, afterMs?: number): void;
+    start(): void;
+    stop(): Promise<void>;
+    runOne(): Promise<boolean>;
+    runUntilIdle(maxReconciles?: number): Promise<number>;
+    get workflowRequests(): ControllerWorkflowCoordinator;
+    private workerLoop;
+    private claimNext;
+    private eligibleControllers;
+    private processClaim;
+    private reconcileClaim;
+    private callReconciler;
+    private finishSuccessfulClaim;
+    private finishFailedClaim;
+    private backoffMs;
+    private readyQueueExists;
+    private recordEvent;
+}