@osolmaz/pi-workflows 0.1.0 → 0.3.0

package/README.md

@@ -29,8 +29,16 @@ Or try the npm package without installing it:
 pi -e npm:@osolmaz/pi-workflows
 ```
 
-The `pi-workflows` viewer binary is part of the same package. To get it on
-your PATH, clone the repo and run `npm install && npm run build && npm link`,
+Install the interactive terminal viewer separately from crates.io. The crate
+is named `pi-workflows`; its command is `piw`:
+
+```bash
+cargo install pi-workflows
+piw
+```
+
+The npm package also includes the simpler `pi-workflows` snapshot viewer. To
+link that command from a clone, run `npm install && npm run build && npm link`,
 or run it in place with `npx tsx src/viewer/cli.ts`.
 
 ## Quick start
@@ -63,16 +71,16 @@ Then, from any pi conversation:
 ```
 
 `/workflow` with no arguments lists discovered workflows. `/workflow pause`
-lets the current step finish and then holds the run before the next node —
-useful when you want to interject in the conversation mid-workflow —
-and `/workflow resume` continues it. Pressing escape to interrupt a turn
+lets the current step finish and then holds the run before the next node. This
+is useful when you want to interject in the conversation mid-workflow.
+`/workflow resume` continues it. Pressing escape to interrupt a turn
 pauses the workflow automatically, so the run never nudges the model while
 you have taken the conversation back; `/workflow resume` re-delivers the
 pending step prompt. `/workflow cancel` stops the active run; if the last run
 already ended (for example parked at a checkpoint), it clears the leftover
 widget instead. Trailing text becomes `{ task: "..." }`; pass arbitrary input
-with `--input-json {"key": "value"}`. The names `cancel`, `list`, `pause`,
-and `resume` are reserved and rejected as workflow names.
+with `--input-json {"key": "value"}`. The names `answer`, `cancel`, `list`, `pause`, `resume`, and `status` are
+reserved and rejected as workflow names.
 
 While a run is on screen, the footer status bar shows a compact
 `wf <name> [status] <node>` indicator alongside the widget.
@@ -82,6 +90,26 @@ structured run ends to request one normal, human-readable assistant response.
 Workflows without it remain silent after their final structured output, which
 keeps shell-only and machine-consumed workflows model-free.
 
+## Agent-managed workflows
+
+The model can use the same `workflow` tool to list, start, inspect, pause,
+resume, cancel, and answer workflows. Step contracts use the tool's `submit`
+action. Slash commands and model actions share one lifecycle implementation.
+
+Pi Workflows includes a `monitor` workflow for plain-language requests such as:
+
+> Monitor PR 123 every 30 minutes. Report failed checks. Stop when it is merged or closed.
+
+The monitor checks immediately, reports only the states requested by the user,
+waits with a normal shell action, and loops until its stop condition or check
+limit. Its input supports `task`, `everyMinutes`, `reportWhen`, `stopWhen`, and
+`maxChecks`. Project and global workflows can replace the built-in `monitor`
+by using the same file name.
+
+A monitor occupies the session's one active workflow slot. If its Pi runner
+stops during the shell wait, the run parks and repeats that wait node when a
+runner resumes it.
+
 Because the workflow runs in your current conversation, you can have a long
 discussion first and then trigger a workflow that builds on it. The
 `elegant-solution` example does exactly that. It asks the model for the most
@@ -105,30 +133,37 @@ pi-workflows view --once   # print a snapshot and exit (good for scripts)
 ```
 
 The run detail view draws the workflow as a boxed graph, like the acpx replay
-viewer: every node sits in a box (heavy border for the active node), branches
-carry their case labels, the taken path is highlighted, and loops route
-through a gutter on the right back into their target from above. `←/→` scrubs
+viewer. Every card has a centered step-name header and a divider above its
+structured metadata. Border characters keep the graph background, the body
+surface begins inside the border, and the header interior uses a separate
+surface. Node type, status, attempts, and timing use compact symbol rows; start
+and terminal markers sit outside the card. Node types have distinct
+semantic colors, active cards use a heavy border, branches carry their case
+labels, the taken path is highlighted, and loops route through a gutter on the
+right back into their target from above. `←/→` scrubs
 backwards and forwards through the recorded steps and re-derives every node's
 status as of that step, with the selected step's full output shown below;
 scrubbing to the end snaps back to following the run live.
 
+The Rust `piw` viewer under `tui/` adds a Catppuccin interface, selectable
+themes, centered active-node following, draggable browser and inspector sizes,
+detailed trace and conversation inspection, temporal replay, and reconnecting
+remote viewing. Full cards have one fixed graph-wide size, so streaming,
+selection, timer ticks, and replay never move nodes or edges. Live conversation
+capture shows text, thinking, tool calls, and tool execution as they happen,
+then reconciles settled messages to verbatim Pi entries. See
+[the piw guide](docs/tui-viewer.md).
+
 ```
-              │ ┌──────────────────┐
-              ▼ ▼                  │
-  ┌──────────────────────────┐     │
-  │ ✓ verify [action] 8.0s ×2 │    │
-  └──────────────────────────┘     │
-              │                    │
-              ▼                    │
-  ┏━━━━━━━━━━━━━━━━━━━━━━━━━━┓     │
-  ┃ ◐ review [agent] 12s ×2  ┃     │
-  ┗━━━━━━━━━━━━━━━━━━━━━━━━━━┛     │
-     ┌─ clean ─┘ └─ issues ─┐      │
-     ▼                      ▼      │
-┌───────────┐    ┌───────────────┐ │
-│ · done    │    │ ✓ fix [agent] │ │
-└───────────┘    └───────────────┘ │
-                        └──────────┘
+  ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
+  ┃            review            ┃
+  ┣━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┫
+  ┃ ● agent            ◐ running ┃
+  ┃ ↻ 2                    ◷ 12s ┃
+  ┃ ◇ clean                     ┃
+  ┃ ◇ issues_found              ┃
+  ┃ … reviewing implementation  ┃
+  ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
 ```
 
 Inside pi, a widget above the editor shows the same boxed graph while a
@@ -153,6 +188,48 @@ the model to pick from a fixed set of choices and validates the answer, and
 See [docs/workflows.md](docs/workflows.md) for the full authoring reference
 and [docs/run-bundles.md](docs/run-bundles.md) for the on-disk run format.
 
+## Controllers
+
+Controllers keep long-running automation aligned with current external state. They store desired state in `spec`, report observed state through conditions and `status`, and reconcile a deduplicated resource key whenever an event or retry makes it ready.
+
+Put `*.controller.ts` files in `.pi/controllers/` or `~/.pi/agent/controllers/`. Import the API from `@osolmaz/pi-workflows/controllers`:
+
+```typescript
+import { conditionTrue, defineController } from "@osolmaz/pi-workflows/controllers";
+
+export default defineController({
+  name: "example",
+  initialStatus: () => ({ phase: "new" }),
+  reconcile: (ctx, resource) =>
+    ctx.settled({
+      controllerStatus: { phase: "done" },
+      conditions: [conditionTrue("Ready", "Complete")],
+    }),
+});
+```
+
+Apply and inspect resources from Pi:
+
+```text
+/controller apply example item-1 {"enabled":true}
+/controller get example item-1
+/controller reconcile example item-1
+```
+
+The standalone CLI provides read-only views with `pi-workflows controllers` and `pi-workflows controller <controller> <key>`. See [docs/CONTROLLERS.md](docs/CONTROLLERS.md) for reconciliation, queue, effect, and child workflow semantics.
+
+## Always-on workflows
+
+Runs do not depend on the Pi window. Every `/workflow` run is claimed through a durable queue, so closing Pi mid-run **parks** the run instead of cancelling it, and any runner can **resume** it later at the node it stopped on. Reopening Pi resumes parked runs itself and catches the session up through the shared event feed; a checkpointed run waits durably until you answer it with `/workflow answer <json>`, which continues the graph in a linked run.
+
+For runs that must continue while Pi is closed, keep the standalone host running:
+
+```bash
+pi-workflows host --project /path/to/project
+```
+
+The host claims parked runs and reconciles controllers without a Pi session. Conversation nodes execute in headless `pi --mode rpc` children that expose the same `workflow` tool contract. It is a foreground process — stop it with Ctrl-C; a crashed host's leftovers are reaped by the next one. See [docs/workflows.md](docs/workflows.md#durable-runs-parking-and-resume) for the model and [docs/run-bundles.md](docs/run-bundles.md) for the on-disk rules.
+
 ## Examples
 
 The [examples/workflows/](examples/workflows/) directory mirrors the acpx
@@ -177,6 +254,10 @@ example set. Copy any of them into `.pi/workflows/` to use them:
   result plateaus or a diverse generation all fails, then conclusions are
   written before the winner is promoted out of the loop directory.
 
+The controller example at `examples/controllers/pull-request.controller.ts`
+shows child repair work and check polling. It also uses expected-head guards
+and recoverable merge effects.
+
 ## License
 
 [MIT](LICENSE)

package/dist/builtins/monitor.workflow.d.ts

@@ -0,0 +1,71 @@
+declare const _default: {
+    name: string;
+    title: ({ input }: {
+        input: unknown;
+        workflowName: string;
+    }) => string;
+    presentationPrompt: ({ finalOutput }: import("../workflows/types.js").WorkflowPresentationContext) => string | undefined;
+    startAt: string;
+    maxSteps: number;
+    nodes: {
+        prepare: import("../workflows/types.js").ComputeNodeDefinition;
+        guard: import("../workflows/types.js").ComputeNodeDefinition;
+        continue_guard: import("../workflows/types.js").ComputeNodeDefinition;
+        check: import("../workflows/types.js").AgentNodeDefinition;
+        report_continue: import("../workflows/types.js").AgentNodeDefinition;
+        report_stop: import("../workflows/types.js").AgentNodeDefinition;
+        sleep: import("../workflows/types.js").ShellActionNodeDefinition;
+        finish: import("../workflows/types.js").ComputeNodeDefinition;
+    };
+    edges: ({
+        from: string;
+        to: string;
+        switch?: never;
+    } | {
+        to?: never;
+        from: string;
+        switch: {
+            on: string;
+            cases: {
+                check: string;
+                stop: string;
+                continue_quiet?: never;
+                continue_report?: never;
+                stop_quiet?: never;
+                stop_report?: never;
+                sleep?: never;
+            };
+        };
+    } | {
+        to?: never;
+        from: string;
+        switch: {
+            on: string;
+            cases: {
+                check?: never;
+                continue_quiet: string;
+                continue_report: string;
+                stop_quiet: string;
+                stop_report: string;
+                sleep?: never;
+                stop?: never;
+            };
+        };
+    } | {
+        to?: never;
+        from: string;
+        switch: {
+            on: string;
+            cases: {
+                check?: never;
+                continue_quiet?: never;
+                continue_report?: never;
+                stop_quiet?: never;
+                stop_report?: never;
+                sleep: string;
+                stop: string;
+            };
+        };
+    })[];
+};
+export default _default;

package/dist/builtins/monitor.workflow.js

@@ -0,0 +1,234 @@
+import { agent, compute, defineWorkflow, shell } from "../workflows/index.js";
+const MIN_INTERVAL_MINUTES = 1;
+const MAX_INTERVAL_MINUTES = 24 * 60;
+const DEFAULT_MAX_CHECKS = 1_000;
+const MAX_CHECKS = 1_000;
+const MAX_OBSERVATION_CHARS = 8_000;
+const MAX_REPORT_CHARS = 4_000;
+const MAX_REASON_CHARS = 2_000;
+const SLEEP_TIMEOUT_MARGIN_MS = 60_000;
+const NODE_TIMEOUT_MARGIN_MS = 2 * 60_000;
+const MONITOR_ROUTES = new Set([
+    "continue_quiet",
+    "continue_report",
+    "stop_quiet",
+    "stop_report",
+]);
+function requireRecord(value, label) {
+    if (value === null || typeof value !== "object" || Array.isArray(value)) {
+        throw new Error(`${label} must be an object`);
+    }
+    return value;
+}
+function requireBoundedString(value, label, maxChars) {
+    if (typeof value !== "string") {
+        throw new Error(`${label} must be a string`);
+    }
+    const trimmed = value.trim();
+    if (trimmed.length === 0) {
+        throw new Error(`${label} must not be empty`);
+    }
+    if (trimmed.length > maxChars) {
+        throw new Error(`${label} must be at most ${maxChars} characters`);
+    }
+    return trimmed;
+}
+function prepareInput(input) {
+    const value = requireRecord(input, "monitor input");
+    const task = requireBoundedString(value.task, "task", 8_000);
+    if (typeof value.everyMinutes !== "number" ||
+        !Number.isInteger(value.everyMinutes) ||
+        value.everyMinutes < MIN_INTERVAL_MINUTES ||
+        value.everyMinutes > MAX_INTERVAL_MINUTES) {
+        throw new Error(`everyMinutes must be an integer from ${MIN_INTERVAL_MINUTES} through ${MAX_INTERVAL_MINUTES}`);
+    }
+    const maxChecks = value.maxChecks ?? DEFAULT_MAX_CHECKS;
+    if (!Number.isInteger(maxChecks) || maxChecks <= 0 || maxChecks > MAX_CHECKS) {
+        throw new Error(`maxChecks must be an integer from 1 through ${MAX_CHECKS}`);
+    }
+    return {
+        task,
+        everyMinutes: value.everyMinutes,
+        reportWhen: value.reportWhen === undefined
+            ? "The observed state changes materially or needs the user's attention."
+            : requireBoundedString(value.reportWhen, "reportWhen", 4_000),
+        stopWhen: value.stopWhen === undefined
+            ? "The user cancels the monitor or it reaches its maximum check count."
+            : requireBoundedString(value.stopWhen, "stopWhen", 4_000),
+        maxChecks,
+    };
+}
+function configFrom(outputs) {
+    return outputs.prepare;
+}
+function completedChecks(context) {
+    return context.state.steps.filter((step) => step.nodeId === "check" && step.outcome === "ok")
+        .length;
+}
+function validateCheck(output) {
+    const value = requireRecord(output, "monitor check output");
+    if (typeof value.route !== "string" || !MONITOR_ROUTES.has(value.route)) {
+        throw new Error(`route must be one of ${[...MONITOR_ROUTES].join(", ")}`);
+    }
+    const route = value.route;
+    const observation = requireBoundedString(value.observation, "observation", MAX_OBSERVATION_CHARS);
+    const reason = requireBoundedString(value.reason, "reason", MAX_REASON_CHARS);
+    const reports = route === "continue_report" || route === "stop_report";
+    const report = value.report === undefined
+        ? undefined
+        : requireBoundedString(value.report, "report", MAX_REPORT_CHARS);
+    if (reports && report === undefined) {
+        throw new Error(`route ${route} requires a report`);
+    }
+    return {
+        route,
+        observation,
+        ...(report !== undefined ? { report } : {}),
+        reason,
+    };
+}
+function validateReportAck(output) {
+    const value = requireRecord(output, "report acknowledgement");
+    if (value.reported !== true) {
+        throw new Error("report acknowledgement must set reported to true");
+    }
+    return { reported: true };
+}
+function reportPrompt(outputs) {
+    const check = outputs.check;
+    return [
+        "Write one concise normal assistant message to the user with this monitoring update:",
+        check.report ?? check.observation,
+        "Do not add unrelated detail.",
+        "After writing the update, submit the acknowledgement required by the workflow step contract.",
+    ].join("\n\n");
+}
+export default defineWorkflow({
+    name: "monitor",
+    title: ({ input }) => {
+        try {
+            const task = prepareInput(input).task;
+            return `monitor: ${task.slice(0, 80)}`;
+        }
+        catch {
+            return "monitor";
+        }
+    },
+    presentationPrompt: ({ finalOutput }) => {
+        const result = requireRecord(finalOutput, "monitor result");
+        if (result.reported === true) {
+            return undefined;
+        }
+        return `Tell the user concisely why this monitor stopped: ${String(result.reason ?? "monitor ended")}`;
+    },
+    startAt: "prepare",
+    maxSteps: 5_010,
+    nodes: {
+        prepare: compute({
+            run: ({ input }) => prepareInput(input),
+        }),
+        guard: compute({
+            run: (context) => {
+                const config = configFrom(context.outputs);
+                const checks = completedChecks(context);
+                return checks >= config.maxChecks
+                    ? { route: "stop", checks, reason: `Reached the ${config.maxChecks}-check limit.` }
+                    : { route: "check", checks };
+            },
+        }),
+        continue_guard: compute({
+            run: (context) => {
+                const config = configFrom(context.outputs);
+                const checks = completedChecks(context);
+                return checks >= config.maxChecks
+                    ? { route: "stop", checks, reason: `Reached the ${config.maxChecks}-check limit.` }
+                    : { route: "sleep", checks };
+            },
+        }),
+        check: agent({
+            statusDetail: "checking monitored target",
+            prompt: (context) => {
+                const config = configFrom(context.outputs);
+                const previous = context.outputs.check;
+                const checkNumber = completedChecks(context) + 1;
+                return [
+                    `Perform monitoring check ${checkNumber} of at most ${config.maxChecks}.`,
+                    `Task: ${config.task}`,
+                    `Report when: ${config.reportWhen}`,
+                    `Stop when: ${config.stopWhen}`,
+                    previous === undefined
+                        ? "There is no previous observation. Report the initial state only when the report condition calls for it."
+                        : `Previous accepted observation: ${previous.observation}`,
+                    "Use available tools to inspect the current state. Observe only unless the task explicitly authorizes a mutation.",
+                    "Choose continue_quiet, continue_report, stop_quiet, or stop_report. A report route requires concise report text.",
+                ].join("\n\n");
+            },
+            expectedOutput: '{ "route": "continue_quiet" | "continue_report" | "stop_quiet" | "stop_report", "observation": "current factual state", "report": "required for report routes", "reason": "short reason" }',
+            validate: (output) => validateCheck(output),
+        }),
+        report_continue: agent({
+            statusDetail: "reporting monitor update",
+            prompt: ({ outputs }) => reportPrompt(outputs),
+            expectedOutput: '{ "reported": true }',
+            validate: (output) => validateReportAck(output),
+        }),
+        report_stop: agent({
+            statusDetail: "reporting final monitor update",
+            prompt: ({ outputs }) => reportPrompt(outputs),
+            expectedOutput: '{ "reported": true }',
+            validate: (output) => validateReportAck(output),
+        }),
+        sleep: shell({
+            statusDetail: "waiting for next monitor check",
+            timeoutMs: MAX_INTERVAL_MINUTES * 60_000 + NODE_TIMEOUT_MARGIN_MS,
+            exec: ({ outputs }) => {
+                const config = configFrom(outputs);
+                const sleepMs = config.everyMinutes * 60_000;
+                return {
+                    command: process.execPath,
+                    args: ["-e", "setTimeout(() => {}, Number(process.argv[1]))", String(sleepMs)],
+                    timeoutMs: sleepMs + SLEEP_TIMEOUT_MARGIN_MS,
+                    maxOutputChars: 1_024,
+                };
+            },
+            parse: (_result, { outputs }) => ({ waitedMinutes: configFrom(outputs).everyMinutes }),
+        }),
+        finish: compute({
+            run: ({ outputs }) => {
+                const check = outputs.check;
+                const guard = outputs.guard;
+                const continueGuard = outputs.continue_guard;
+                return {
+                    reason: continueGuard?.reason ?? guard?.reason ?? check?.reason ?? "Monitor finished.",
+                    observation: check?.observation ?? null,
+                    reported: outputs.report_stop !== undefined ||
+                        (check !== undefined && check.route === "stop_report"),
+                };
+            },
+        }),
+    },
+    edges: [
+        { from: "prepare", to: "guard" },
+        { from: "guard", switch: { on: "$.route", cases: { check: "check", stop: "finish" } } },
+        {
+            from: "check",
+            switch: {
+                on: "$.route",
+                cases: {
+                    continue_quiet: "continue_guard",
+                    continue_report: "report_continue",
+                    stop_quiet: "finish",
+                    stop_report: "report_stop",
+                },
+            },
+        },
+        { from: "report_continue", to: "continue_guard" },
+        { from: "report_stop", to: "finish" },
+        {
+            from: "continue_guard",
+            switch: { on: "$.route", cases: { sleep: "sleep", stop: "finish" } },
+        },
+        { from: "sleep", to: "guard" },
+    ],
+});
+//# sourceMappingURL=monitor.workflow.js.map

package/dist/builtins/monitor.workflow.js.map

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

package/dist/controllers/conditions.d.ts

@@ -0,0 +1,6 @@
+import type { ControllerCondition, ControllerConditionInput, ControllerResourceStatus, ControllerStatusPatch } from "./types.js";
+export declare function conditionTrue(type: string, reason: string, message?: string): ControllerConditionInput;
+export declare function conditionFalse(type: string, reason: string, message?: string): ControllerConditionInput;
+export declare function conditionUnknown(type: string, reason: string, message?: string): ControllerConditionInput;
+export declare function applyStatusPatch<TStatus>(current: ControllerResourceStatus<TStatus>, patch: ControllerStatusPatch<TStatus> | undefined, generation: number, now: string): ControllerResourceStatus<TStatus>;
+export declare function mergeConditions(current: ControllerCondition[], updates: ControllerConditionInput[], generation: number, now: string): ControllerCondition[];

package/dist/controllers/conditions.js

@@ -0,0 +1,68 @@
+export function conditionTrue(type, reason, message) {
+    return condition(type, true, reason, message);
+}
+export function conditionFalse(type, reason, message) {
+    return condition(type, false, reason, message);
+}
+export function conditionUnknown(type, reason, message) {
+    return condition(type, "unknown", reason, message);
+}
+export function applyStatusPatch(current, patch, generation, now) {
+    return {
+        observedGeneration: generation,
+        conditions: mergeConditions(current.conditions, patch?.conditions ?? [], generation, now),
+        controllerStatus: patch !== undefined && Object.hasOwn(patch, "controllerStatus")
+            ? patch.controllerStatus
+            : current.controllerStatus,
+        ...(patch?.workflowRun === null
+            ? {}
+            : patch?.workflowRun !== undefined
+                ? { workflowRun: patch.workflowRun }
+                : current.workflowRun !== undefined
+                    ? { workflowRun: current.workflowRun }
+                    : {}),
+    };
+}
+export function mergeConditions(current, updates, generation, now) {
+    const byType = new Map(current.map((item) => [item.type, item]));
+    const seen = new Set();
+    for (const update of updates) {
+        validateCondition(update);
+        if (seen.has(update.type)) {
+            throw new Error(`Condition ${JSON.stringify(update.type)} was updated more than once`);
+        }
+        seen.add(update.type);
+        const previous = byType.get(update.type);
+        const next = {
+            ...update,
+            observedGeneration: generation,
+            lastTransitionTime: previous !== undefined && previous.status === update.status
+                ? previous.lastTransitionTime
+                : now,
+        };
+        byType.set(update.type, next);
+    }
+    return [...byType.values()];
+}
+function condition(type, status, reason, message) {
+    const value = {
+        type,
+        status,
+        reason,
+        ...(message !== undefined ? { message } : {}),
+    };
+    validateCondition(value);
+    return value;
+}
+function validateCondition(value) {
+    if (value.type.trim().length === 0) {
+        throw new Error("Condition type must not be empty");
+    }
+    if (value.reason.trim().length === 0) {
+        throw new Error("Condition reason must not be empty");
+    }
+    if (value.status !== true && value.status !== false && value.status !== "unknown") {
+        throw new Error(`Invalid condition status for ${JSON.stringify(value.type)}`);
+    }
+}
+//# sourceMappingURL=conditions.js.map

package/dist/controllers/conditions.js.map

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

package/dist/controllers/definition.d.ts

@@ -0,0 +1,6 @@
+import type { AnyControllerDefinition, ControllerDefinition, ControllerResource } from "./types.js";
+export declare function defineController<TSpec, TStatus>(definition: ControllerDefinition<TSpec, TStatus>): ControllerDefinition<TSpec, TStatus>;
+export declare function isControllerDefinition(value: unknown): value is AnyControllerDefinition;
+export declare function assertValidControllerDefinition<TSpec, TStatus>(definition: ControllerDefinition<TSpec, TStatus>): void;
+export declare function asAnyControllerDefinition<TSpec, TStatus>(definition: ControllerDefinition<TSpec, TStatus>): AnyControllerDefinition;
+export declare function asTypedResource<TSpec, TStatus>(resource: ControllerResource): ControllerResource<TSpec, TStatus>;

package/dist/controllers/definition.js

@@ -0,0 +1,45 @@
+const CONTROLLER_DEFINITION_BRAND = Symbol.for("pi-workflows.controller-definition");
+const CONTROLLER_NAME_PATTERN = /^[a-z][a-z0-9-]*$/;
+export function defineController(definition) {
+    assertValidControllerDefinition(definition);
+    if (isControllerDefinition(definition)) {
+        return definition;
+    }
+    Object.defineProperty(definition, CONTROLLER_DEFINITION_BRAND, {
+        value: true,
+        enumerable: false,
+        configurable: false,
+        writable: false,
+    });
+    return definition;
+}
+export function isControllerDefinition(value) {
+    return (value !== null &&
+        typeof value === "object" &&
+        value[CONTROLLER_DEFINITION_BRAND] === true);
+}
+export function assertValidControllerDefinition(definition) {
+    if (definition === null || typeof definition !== "object") {
+        throw new Error("Invalid controller definition: expected an object");
+    }
+    if (!CONTROLLER_NAME_PATTERN.test(definition.name)) {
+        throw new Error(`Invalid controller definition: name ${JSON.stringify(definition.name)} must match ${CONTROLLER_NAME_PATTERN.source}`);
+    }
+    if (typeof definition.initialStatus !== "function") {
+        throw new Error("Invalid controller definition: initialStatus must be a function");
+    }
+    if (typeof definition.reconcile !== "function") {
+        throw new Error("Invalid controller definition: reconcile must be a function");
+    }
+    if (definition.timeoutMs !== undefined &&
+        (!Number.isSafeInteger(definition.timeoutMs) || definition.timeoutMs <= 0)) {
+        throw new Error("Invalid controller definition: timeoutMs must be a positive safe integer");
+    }
+}
+export function asAnyControllerDefinition(definition) {
+    return definition;
+}
+export function asTypedResource(resource) {
+    return resource;
+}
+//# sourceMappingURL=definition.js.map

package/dist/controllers/definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.js","sourceRoot":"","sources":["../../src/controllers/definition.ts"],"names":[],"mappings":"AAEA,MAAM,2BAA2B,GAAG,MAAM,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;AACrF,MAAM,uBAAuB,GAAG,mBAAmB,CAAC;AAEpD,MAAM,UAAU,gBAAgB,CAC9B,UAAgD;IAEhD,+BAA+B,CAAC,UAAU,CAAC,CAAC;IAC5C,IAAI,sBAAsB,CAAC,UAAU,CAAC,EAAE,CAAC;QACvC,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,MAAM,CAAC,cAAc,CAAC,UAAU,EAAE,2BAA2B,EAAE;QAC7D,KAAK,EAAE,IAAI;QACX,UAAU,EAAE,KAAK;QACjB,YAAY,EAAE,KAAK;QACnB,QAAQ,EAAE,KAAK;KAChB,CAAC,CAAC;IACH,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,KAAc;IACnD,OAAO,CACL,KAAK,KAAK,IAAI;QACd,OAAO,KAAK,KAAK,QAAQ;QACxB,KAAsC,CAAC,2BAA2B,CAAC,KAAK,IAAI,CAC9E,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,+BAA+B,CAC7C,UAAgD;IAEhD,IAAI,UAAU,KAAK,IAAI,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IACvE,CAAC;IACD,IAAI,CAAC,uBAAuB,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACnD,MAAM,IAAI,KAAK,CACb,uCAAuC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,eAAe,uBAAuB,CAAC,MAAM,EAAE,CACtH,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,UAAU,CAAC,aAAa,KAAK,UAAU,EAAE,CAAC;QACnD,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC;IACrF,CAAC;IACD,IAAI,OAAO,UAAU,CAAC,SAAS,KAAK,UAAU,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;IACjF,CAAC;IACD,IACE,UAAU,CAAC,SAAS,KAAK,SAAS;QAClC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,UAAU,CAAC,SAAS,IAAI,CAAC,CAAC,EAC1E,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,0EAA0E,CAAC,CAAC;IAC9F,CAAC;AACH,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,UAAgD;IAEhD,OAAO,UAA+D,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,QAA4B;IAE5B,OAAO,QAA8C,CAAC;AACxD,CAAC"}