@twelvehart/orcats 0.0.0-seed.0 → 0.2.3

package/dist/loop/io/source.d.ts

@@ -0,0 +1,64 @@
+import { type Result } from "neverthrow";
+import { type RuntimeError } from "../../model/index.ts";
+/** Bundled source kinds. A custom trigger reuses the closest kind or its own structural object. */
+export type SourceKind = "manual" | "cron" | "watch" | "webhook" | "queue" | "linear-issue" | "linear-agent";
+/** Handle returned by a started Source so the supervisor can stop the trigger. */
+export interface SourceSubscription {
+    stop(): Promise<Result<void, RuntimeError>>;
+}
+/** A loop trigger — the only loop-level entry boundary. */
+export interface Source<E = unknown> {
+    readonly kind: SourceKind;
+    start(handler: (event: E) => void): Promise<Result<SourceSubscription, RuntimeError>>;
+}
+export interface ManualSource<E = void> extends Source<E> {
+    readonly kind: "manual";
+    /** Push a trigger event to the started handler. No-op until started / after stop. */
+    fire(event: E): void;
+    /** Whether a handler is currently subscribed. */
+    isStarted(): boolean;
+}
+export declare function manual<E = void>(): ManualSource<E>;
+/** Schedules `fire` on the loop's cadence and returns a cancel handle. */
+export type CronScheduler = (fire: () => void) => () => void;
+export declare function cron(expression: string, scheduler?: CronScheduler): Source<void>;
+export interface WatchEvent {
+    readonly eventType: string;
+    readonly filename: string | null;
+    /** The watched path that produced the event. */
+    readonly path: string;
+}
+/** Opens a watcher on `path`, invoking `onEvent` per change; returns a close handle. */
+export type WatcherFactory = (path: string, onEvent: (eventType: string, filename: string | null) => void) => {
+    close(): void;
+};
+export interface WatchOptions {
+    readonly paths: readonly string[];
+    readonly watcherFactory?: WatcherFactory;
+}
+export declare function watch(options: WatchOptions): Source<WatchEvent>;
+export interface WebhookEvent {
+    readonly method: string;
+    readonly url: string;
+    readonly body: string;
+}
+/** Starts a listener that invokes `onRequest` per inbound request and returns a close handle. */
+export type ListenerFactory = (onRequest: (event: WebhookEvent) => void) => Promise<Result<{
+    close(): Promise<void>;
+}, RuntimeError>>;
+export interface WebhookOptions {
+    readonly port: number;
+    /** Only requests to this path fire the handler; default: any path. */
+    readonly path?: string;
+    readonly listenerFactory?: ListenerFactory;
+}
+export declare function webhook(options: WebhookOptions): Source<WebhookEvent>;
+export interface QueueConsumer<E> {
+    /** Subscribe to messages, delivering each; resolves to an unsubscribe handle. */
+    subscribe(deliver: (message: E) => void): Promise<Result<() => void, RuntimeError>>;
+}
+export interface QueueSourceOptions<E> {
+    readonly consumer: QueueConsumer<E>;
+}
+export declare function queueSource<E = unknown>(options: QueueSourceOptions<E>): Source<E>;
+//# sourceMappingURL=source.d.ts.map

package/dist/loop/io/source.d.ts.map

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

package/dist/loop/serve.d.ts

@@ -0,0 +1,97 @@
+import { type Result } from "neverthrow";
+import { type RuntimeError } from "../model/index.ts";
+import type { LoopOutcome, LoopRunError } from "./builder/index.ts";
+import { type ChildHandle, type ChildSpawner } from "./firing.ts";
+import type { Sink, Source } from "./io/index.ts";
+export { exitCodeForRun, exitCodeForStop, } from "./firing.ts";
+export type { ChildHandle, ChildSpec, ChildSpawner, } from "./firing.ts";
+/** A registered loop: its trigger `Source`, output `Sink`, and a one-shot runner. */
+export interface LoopDefinition<E = unknown, A = unknown, S = unknown> {
+    readonly name: string;
+    readonly source: Source<E>;
+    readonly sink: Sink<A>;
+    /** Run the loop once for a trigger event, emit its output to the sink, resolve to the stop outcome. */
+    run(event: E): Promise<Result<LoopOutcome<S>, LoopRunError>>;
+}
+/** What one loop firing produces: the stop outcome plus the value to emit to the sink. */
+export interface LoopEmission<A = unknown, S = unknown> {
+    readonly outcome: LoopOutcome<S>;
+    readonly output: A;
+}
+/** Authoring config for `defineLoop`. `onTrigger` runs the loop; the sink emit is wired for you. */
+export interface LoopConfig<E = unknown, A = unknown, S = unknown> {
+    readonly name: string;
+    readonly source: Source<E>;
+    readonly sink: Sink<A>;
+    /** Execute the loop once for `event`; return the stop outcome and the value to emit. */
+    readonly onTrigger: (event: E) => Promise<Result<LoopEmission<A, S>, LoopRunError>>;
+}
+/**
+ * Package a loop with its Source + Sink into a discoverable definition. A loop module exports the
+ * result; importing the module only registers it (no Source fires, no backend runs, no Sink emits)
+ * so `orcats loops` discovery is side-effect-free. `run` folds the sink emit into one Result so the
+ * CLI and the `serve` child share identical output behavior.
+ */
+export declare function defineLoop<E = unknown, A = unknown, S = unknown>(config: LoopConfig<E, A, S>): LoopDefinition<E, A, S>;
+/** Structural guard: an object with a name, a `run`, and Source/Sink-shaped seams. */
+export declare function isLoopDefinition(value: unknown): value is LoopDefinition;
+/** Imports a module by absolute path, returning its export namespace. */
+export type ModuleImporter = (absolutePath: string) => Promise<Record<string, unknown>>;
+/** Lists candidate loop-module files under a directory. */
+export type FileLister = (dir: string) => Promise<string[]>;
+/** Scan imported module namespaces for exported LoopDefinitions, keyed by loop name. */
+export declare function collectDefinitions(modules: Iterable<Record<string, unknown>>): Map<string, LoopDefinition>;
+export interface DiscoverOptions {
+    readonly dir: string;
+    readonly list?: FileLister;
+    readonly import?: ModuleImporter;
+}
+/**
+ * Discover loop definitions under `dir` (by convention `.orca/loops`, holding export-only loop
+ * modules — NOT self-executing flow scripts). Import-only: constructing a definition via
+ * `defineLoop` fires no Source, backend, or Sink, so discovery has no side effects.
+ */
+export declare function discoverLoops(options: DiscoverOptions): Promise<Result<Map<string, LoopDefinition>, RuntimeError>>;
+export interface LoadOptions {
+    readonly cwd: string;
+    readonly import?: ModuleImporter;
+    readonly list?: FileLister;
+    /** Directory scanned when the target is a registered name; default `<cwd>/.orca/loops`. */
+    readonly loopsDir?: string;
+}
+/**
+ * Resolve a loop by module path OR registered name (spec distribution). A path imports that one
+ * module; a name discovers the `.orca/loops` directory and looks it up. Import-only: no firing.
+ */
+export declare function loadDefinition(target: string, options: LoadOptions): Promise<Result<LoopDefinition, RuntimeError>>;
+export interface LoopListing {
+    readonly name: string;
+    readonly source: string;
+    readonly sink: string;
+}
+/** Project loop definitions to listing rows — reads `kind` metadata only, never `start`/`emit`/`run`. */
+export declare function listLoops(definitions: Iterable<LoopDefinition>): LoopListing[];
+/** Render the loop listing as text for `orcats loops`. */
+export declare function formatLoopListing(rows: readonly LoopListing[]): string;
+export interface ServeOptions {
+    /** Spawn an ephemeral child per firing; default re-invokes `orcats run <loop>` as a subprocess. */
+    readonly spawn?: ChildSpawner;
+    /** What the child runs: a loop name or path. Default: the definition name. */
+    readonly loopRef?: string;
+}
+/** Live supervisor handle: owns the trigger and the in-flight children, not the loop runs. */
+export interface Supervisor {
+    /** In-flight child handles, one per firing not yet exited. */
+    children(): readonly ChildHandle[];
+    /** Stop the trigger and `SIGKILL` any in-flight children. */
+    stop(): Promise<Result<void, RuntimeError>>;
+}
+/**
+ * The thin `serve` supervisor (design D8): a long-lived process owning ONLY the trigger. Each
+ * firing spawns an ephemeral child that runs the loop and exits — the loop never runs in the
+ * supervisor, so one loop's crash/OOM cannot take down the supervisor or its siblings, and a
+ * runaway child is killable at the OS level. Cross-loop coordination is via the shared manifest
+ * store (L05), not shared process memory.
+ */
+export declare function serve(definition: LoopDefinition, options?: ServeOptions): Promise<Result<Supervisor, RuntimeError>>;
+//# sourceMappingURL=serve.d.ts.map

package/dist/loop/serve.d.ts.map

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

package/dist/loop/state/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./port.ts";
+export * from "./manifest.ts";
+export * from "./snapshot.ts";
+export * from "./sqlite.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/loop/state/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/loop/state/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC"}

package/dist/loop/state/manifest.d.ts

@@ -0,0 +1,36 @@
+import { type Result } from "neverthrow";
+import { z } from "zod";
+import { type RuntimeError } from "../../model/index.ts";
+/** A single atomic subtask; `passes` is the progress flag flipped by the loop. */
+export declare const ManifestTaskSchema: z.ZodObject<{
+    id: z.ZodString;
+    passes: z.ZodBoolean;
+}, z.core.$strip>;
+/** Typed loop manifest — the single progress/variant/monitor spine. */
+export declare const TaskManifestSchema: z.ZodObject<{
+    tasks: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        passes: z.ZodBoolean;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ManifestTask = z.infer<typeof ManifestTaskSchema>;
+export type TaskManifest = z.infer<typeof TaskManifestSchema>;
+/** Validate raw state against the manifest schema each cycle; a validation
+ * failure surfaces as `err(RuntimeError)` (`StructuredOutputValidationFailed`). */
+export declare function parseManifest(raw: unknown): Result<TaskManifest, RuntimeError>;
+/** The single shared projection: count of tasks not yet passing. The termination
+ * variant, reported progress, and the monitor signal all read this one value, so
+ * they always reflect the same number. */
+export declare function measure(manifest: TaskManifest): number;
+export interface ManifestProgress {
+    readonly total: number;
+    readonly passed: number;
+    readonly pending: number;
+    /** Fraction of tasks passing in `[0, 1]`; `1` for an empty manifest. */
+    readonly ratio: number;
+}
+/** Progress report derived from {@link measure} so it cannot drift from the variant. */
+export declare function progress(manifest: TaskManifest): ManifestProgress;
+/** Termination predicate: the manifest is complete when nothing is pending. */
+export declare function isComplete(manifest: TaskManifest): boolean;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/loop/state/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../../src/loop/state/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAyB,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAOhF,kFAAkF;AAClF,eAAO,MAAM,kBAAkB;;;iBAG7B,CAAC;AAEH,uEAAuE;AACvE,eAAO,MAAM,kBAAkB;;;;;iBAE7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;mFACmF;AACnF,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAAC,YAAY,EAAE,YAAY,CAAC,CAE9E;AAED;;0CAE0C;AAC1C,wBAAgB,OAAO,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAEtD;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,wEAAwE;IACxE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,wFAAwF;AACxF,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,YAAY,GAAG,gBAAgB,CAKjE;AAED,+EAA+E;AAC/E,wBAAgB,UAAU,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAE1D"}

package/dist/loop/state/port.d.ts

@@ -0,0 +1,33 @@
+import type { Result } from "neverthrow";
+import type { RuntimeError } from "../../model/index.ts";
+import type { TaskManifest } from "./manifest.ts";
+/** Content hash identifying a per-cycle state snapshot. */
+export type StateHash = string;
+/** Service-free-by-default adapters (design D4). `dbos`/`dolt` stay deferred but
+ * the port shape keeps them expressible. */
+export type StateAdapterId = "snapshot" | "sqlite";
+/** Fan-in merge: the ONLY place branch state combines (event-sourced/reduce,
+ * never shared-mutable). */
+export type StateReducer<S> = (states: readonly S[]) => S;
+/**
+ * StateStore port — `load / checkpoint / branch / merge / history`, all Result-typed
+ * over `RuntimeError`. Default state is the {@link TaskManifest}.
+ */
+export interface StateStore<S = TaskManifest> {
+    /** Read a snapshot by hash, or the most recent checkpoint when omitted. */
+    load(hash?: StateHash): Promise<Result<S, RuntimeError>>;
+    /** Validate and persist a cycle's state, returning its content hash. */
+    checkpoint(state: S): Promise<Result<StateHash, RuntimeError>>;
+    /** Fan-out: copy a snapshot into an isolated branch handle. */
+    branch(from: StateHash): Promise<Result<StateHash, RuntimeError>>;
+    /** Fan-in: combine branch snapshots through the reducer (the only merge point). */
+    merge(branches: readonly StateHash[], reducer: StateReducer<S>): Promise<Result<S, RuntimeError>>;
+    /** Monitoring: the ordered hashes of prior cycle snapshots. */
+    history(): Promise<Result<readonly StateHash[], RuntimeError>>;
+}
+/** Store capability required only by store-backed fan-out branch result persistence. */
+export interface BranchWritableStateStore<S = TaskManifest> extends StateStore<S> {
+    /** Persist isolated branch state without appending to the cycle history. */
+    saveBranch(branch: StateHash, state: S): Promise<Result<StateHash, RuntimeError>>;
+}
+//# sourceMappingURL=port.d.ts.map

package/dist/loop/state/port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"port.d.ts","sourceRoot":"","sources":["../../../src/loop/state/port.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAQlD,2DAA2D;AAC3D,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC;AAE/B;4CAC4C;AAC5C,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,QAAQ,CAAC;AAEnD;4BAC4B;AAC5B,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,KAAK,CAAC,CAAC;AAE1D;;;GAGG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC,GAAG,YAAY;IAC1C,2EAA2E;IAC3E,IAAI,CAAC,IAAI,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC;IACzD,wEAAwE;IACxE,UAAU,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC;IAC/D,+DAA+D;IAC/D,MAAM,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC;IAClE,mFAAmF;IACnF,KAAK,CAAC,QAAQ,EAAE,SAAS,SAAS,EAAE,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC;IAClG,+DAA+D;IAC/D,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,SAAS,SAAS,EAAE,EAAE,YAAY,CAAC,CAAC,CAAC;CAChE;AAED,wFAAwF;AACxF,MAAM,WAAW,wBAAwB,CAAC,CAAC,GAAG,YAAY,CAAE,SAAQ,UAAU,CAAC,CAAC,CAAC;IAC/E,4EAA4E;IAC5E,UAAU,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC;CACnF"}

package/dist/loop/state/snapshot.d.ts

@@ -0,0 +1,15 @@
+import { type FsTool } from "../../tools/index.ts";
+import { type TaskManifest } from "./manifest.ts";
+import type { BranchWritableStateStore, StateHash } from "./port.ts";
+export interface SnapshotStoreOptions {
+    /** Repo/working root; snapshots land under `<root>/.orca/`. */
+    readonly root: string;
+    /** Injectable filesystem for tests; defaults to the real adapter. */
+    readonly fsTool?: FsTool;
+}
+/** Content hash of a manifest — canonical JSON so equal manifests share a file. */
+export declare function stateHash(manifest: TaskManifest): StateHash;
+/** Per-cycle snapshot path: `<root>/.orca/state-<hash>.json`. */
+export declare function statePath(root: string, hash: StateHash): string;
+export declare function createSnapshotStore(options: SnapshotStoreOptions): BranchWritableStateStore;
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/loop/state/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../../src/loop/state/snapshot.ts"],"names":[],"mappings":"AAIA,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAiB,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,KAAK,EAAE,wBAAwB,EAAE,SAAS,EAAgB,MAAM,WAAW,CAAC;AAUnF,MAAM,WAAW,oBAAoB;IACnC,+DAA+D;IAC/D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,qEAAqE;IACrE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,mFAAmF;AACnF,wBAAgB,SAAS,CAAC,QAAQ,EAAE,YAAY,GAAG,SAAS,CAK3D;AAED,iEAAiE;AACjE,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,MAAM,CAE/D;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,wBAAwB,CA4F3F"}

package/dist/loop/state/sqlite.d.ts

@@ -0,0 +1,31 @@
+import { type Result } from "neverthrow";
+import type { RuntimeError } from "../../model/index.ts";
+import type { BranchWritableStateStore } from "./port.ts";
+export interface SqliteStoreOptions {
+    /** Database file path; durability and crash recovery require a real file
+     * (`:memory:` works but is lost on exit). */
+    readonly path: string;
+    /** Lease owner id for this runner; defaults to a random per-process id. */
+    readonly owner?: string;
+    /** A lease whose heartbeat is older than this many ms is treated as a crashed
+     * holder and reclaimed on open. */
+    readonly leaseTtlMs?: number;
+    /** Injectable clock (ms epoch) for deterministic lease tests; defaults to `Date.now`. */
+    readonly now?: () => number;
+}
+/**
+ * The `sqlite` adapter: a {@link StateStore} plus lease lifecycle controls. The
+ * extra members are NOT part of the port — loop code targets `StateStore` and never
+ * sees them, so swapping `snapshot` <-> `sqlite` needs no loop-definition change.
+ */
+export interface SqliteStore extends BranchWritableStateStore {
+    /** This runner's lease owner id. */
+    readonly owner: string;
+    /** Refresh the lease heartbeat mid-step so a long step keeps its lease;
+     * `err` once another runner has reclaimed a stale lease. */
+    heartbeat(): Result<void, RuntimeError>;
+    /** Release the lease and close the database (clean shutdown — not a crash). */
+    close(): void;
+}
+export declare function createSqliteStore(options: SqliteStoreOptions): Result<SqliteStore, RuntimeError>;
+//# sourceMappingURL=sqlite.d.ts.map

package/dist/loop/state/sqlite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../../../src/loop/state/sqlite.ts"],"names":[],"mappings":"AAEA,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGzD,OAAO,KAAK,EAAE,wBAAwB,EAA2B,MAAM,WAAW,CAAC;AA+BnF,MAAM,WAAW,kBAAkB;IACjC;iDAC6C;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,2EAA2E;IAC3E,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB;uCACmC;IACnC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,yFAAyF;IACzF,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CAC7B;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAY,SAAQ,wBAAwB;IAC3D,oCAAoC;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;gEAC4D;IAC5D,SAAS,IAAI,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IACxC,+EAA+E;IAC/E,KAAK,IAAI,IAAI,CAAC;CACf;AAiBD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CAAC,WAAW,EAAE,YAAY,CAAC,CAwLhG"}

package/dist/loop/termination-contract.d.ts

@@ -0,0 +1,28 @@
+import { type Result } from "neverthrow";
+import type { BackEdge, CycleReport, NodeId } from "./graph/index.ts";
+/**
+ * Predicate the contract queries per loop. L06 implements it by checking whether the back-edge's
+ * head node has a bound preset archetype or `.measure()` variant. Queried with the back-edge
+ * head (`BackEdge.to`) — the node a loop jumps back to.
+ */
+export type HasVariant = (node: NodeId) => boolean;
+export type CycleViolationKind = "unguarded-back-edge" | "accidental-cycle";
+export interface CycleViolation {
+    readonly kind: CycleViolationKind;
+    readonly backEdge: BackEdge;
+    /** The cycle's node path, used to name it in the message. */
+    readonly cycle: readonly NodeId[];
+}
+export interface TerminationContractError {
+    readonly _tag: "TerminationContractViolated";
+    readonly violations: readonly CycleViolation[];
+    /** Human-readable summary naming every offending cycle. */
+    readonly message: string;
+}
+/**
+ * Enforce the termination contract over an analyzed loop graph. Returns `ok` when every cycle is
+ * a declared loop back-edge whose head carries a variant; otherwise `err` naming each offending
+ * cycle. Collects ALL violations in one pass so the author sees every problem at once.
+ */
+export declare function enforceTerminationContract(report: CycleReport, hasVariant: HasVariant): Result<void, TerminationContractError>;
+//# sourceMappingURL=termination-contract.d.ts.map

package/dist/loop/termination-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"termination-contract.d.ts","sourceRoot":"","sources":["../../src/loop/termination-contract.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC;AAElD,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAEtE;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;AAEnD,MAAM,MAAM,kBAAkB,GAAG,qBAAqB,GAAG,kBAAkB,CAAC;AAE5E,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,6DAA6D;IAC7D,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,IAAI,EAAE,6BAA6B,CAAC;IAC7C,QAAQ,CAAC,UAAU,EAAE,SAAS,cAAc,EAAE,CAAC;IAC/C,2DAA2D;IAC3D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAoBD;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,WAAW,EACnB,UAAU,EAAE,UAAU,GACrB,MAAM,CAAC,IAAI,EAAE,wBAAwB,CAAC,CAmBxC"}

package/dist/loop/termination.d.ts

@@ -0,0 +1,33 @@
+import type { Usage } from "../model/index.ts";
+export interface FingerprintAction {
+    readonly identity: string;
+    readonly inputs: unknown;
+}
+export interface FingerprintDetectorOptions<T> {
+    readonly project: (value: T) => FingerprintAction | undefined;
+    /** Number of recent fingerprints retained for repeat detection. */
+    readonly windowSize?: number;
+    /** Repeated occurrences within the window required to declare stuck. */
+    readonly repeatThreshold?: number;
+}
+export type TokenUsageSummary = {
+    readonly kind: "known";
+    readonly total: number;
+    readonly budget?: number;
+} | {
+    readonly kind: "unknown";
+    readonly knownTotal: number;
+    readonly budget?: number;
+};
+export declare function usageTokens(usage: Usage): number;
+export declare class TokenBudgetCounter {
+    #private;
+    constructor(budget?: number);
+    record(usage: Usage | undefined): void;
+    get shouldReport(): boolean;
+    get exhausted(): boolean;
+    summary(): TokenUsageSummary;
+}
+export declare function makeFingerprintStuckDetector<T>(options: FingerprintDetectorOptions<T>): (value: T) => boolean;
+export declare function fingerprintAction(action: FingerprintAction): string;
+//# sourceMappingURL=termination.d.ts.map

package/dist/loop/termination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"termination.d.ts","sourceRoot":"","sources":["../../src/loop/termination.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE/C,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,0BAA0B,CAAC,CAAC;IAC3C,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,iBAAiB,GAAG,SAAS,CAAC;IAC9D,mEAAmE;IACnE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,wEAAwE;IACxE,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACnC;AAED,MAAM,MAAM,iBAAiB,GACzB;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5E;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAExF,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAEhD;AAED,qBAAa,kBAAkB;;gBAMjB,MAAM,CAAC,EAAE,MAAM;IAI3B,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,GAAG,IAAI;IAStC,IAAI,YAAY,IAAI,OAAO,CAE1B;IAED,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,OAAO,IAAI,iBAAiB;CAM7B;AAED,wBAAgB,4BAA4B,CAAC,CAAC,EAC5C,OAAO,EAAE,0BAA0B,CAAC,CAAC,CAAC,GACrC,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CA8BvB;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAEnE"}

package/dist/model/backend-config.d.ts

@@ -0,0 +1,30 @@
+import type { z } from "zod";
+import type { BackendTag, LlmResult } from "./schemas.ts";
+import type { SessionId } from "./brand.ts";
+export type BackendApprovalPolicy = "never" | "on-request" | "on-failure" | "granular" | "untrusted";
+export type BackendSandboxMode = "read-only" | "workspace-write" | "danger-full-access";
+export interface BackendRetryConfig {
+    readonly attempts: number;
+}
+export interface StructuredOutputConfig<Output = unknown> {
+    readonly schema: z.ZodType<Output>;
+    readonly name?: string;
+    readonly description?: string;
+}
+export interface BackendConfig<B extends BackendTag = BackendTag, Output = unknown> {
+    readonly model?: string;
+    readonly systemPrompt?: string;
+    readonly approvalPolicy?: BackendApprovalPolicy;
+    readonly readOnly?: boolean;
+    readonly sandbox?: BackendSandboxMode;
+    readonly selfManagedGit?: boolean;
+    readonly retry?: BackendRetryConfig;
+    readonly structuredOutput?: StructuredOutputConfig<Output>;
+    readonly resumeSessionId?: SessionId<B>;
+    readonly interactive?: boolean;
+}
+export type BackendResult<B extends BackendTag> = Omit<LlmResult, "backend" | "sessionId"> & {
+    readonly backend: B;
+    readonly sessionId: SessionId<B>;
+};
+//# sourceMappingURL=backend-config.d.ts.map

package/dist/model/backend-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend-config.d.ts","sourceRoot":"","sources":["../../src/model/backend-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,MAAM,qBAAqB,GAAG,OAAO,GAAG,YAAY,GAAG,YAAY,GAAG,UAAU,GAAG,WAAW,CAAC;AACrG,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,iBAAiB,GAAG,oBAAoB,CAAC;AAExF,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAsB,CAAC,MAAM,GAAG,OAAO;IACtD,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACnC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,aAAa,CAAC,CAAC,SAAS,UAAU,GAAG,UAAU,EAAE,MAAM,GAAG,OAAO;IAChF,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,CAAC,EAAE,qBAAqB,CAAC;IAChD,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,kBAAkB,CAAC;IACtC,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,kBAAkB,CAAC;IACpC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC3D,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IACxC,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,UAAU,IAAI,IAAI,CAAC,SAAS,EAAE,SAAS,GAAG,WAAW,CAAC,GAAG;IAC3F,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;CAClC,CAAC"}

package/dist/model/brand.d.ts

@@ -0,0 +1,9 @@
+import type { BackendTag } from "./schemas.ts";
+declare const brand: unique symbol;
+export type Brand<T, Name extends string> = T & {
+    readonly [brand]: Name;
+};
+export type SessionId<B extends BackendTag> = Brand<string, `SessionId:${B}`>;
+export declare function sessionId<B extends BackendTag>(backend: B, value: string): SessionId<B>;
+export {};
+//# sourceMappingURL=brand.d.ts.map

package/dist/model/brand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brand.d.ts","sourceRoot":"","sources":["../../src/model/brand.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,OAAO,CAAC,MAAM,KAAK,EAAE,OAAO,MAAM,CAAC;AAEnC,MAAM,MAAM,KAAK,CAAC,CAAC,EAAE,IAAI,SAAS,MAAM,IAAI,CAAC,GAAG;IAAE,QAAQ,CAAC,CAAC,KAAK,CAAC,EAAE,IAAI,CAAA;CAAE,CAAC;AAE3E,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,UAAU,IAAI,KAAK,CAAC,MAAM,EAAE,aAAa,CAAC,EAAE,CAAC,CAAC;AAE9E,wBAAgB,SAAS,CAAC,CAAC,SAAS,UAAU,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,CAEvF"}

package/dist/model/errors.d.ts

@@ -0,0 +1,11 @@
+import type { BackendTag, RuntimeError } from "./schemas.ts";
+type RuntimeErrorArgs<Tag extends RuntimeError["_tag"]> = Omit<Extract<RuntimeError, {
+    _tag: Tag;
+}>, "_tag">;
+export declare function unsupportedFeature(feature: string, reason: string): RuntimeError;
+export declare function backendFailed(backend: BackendTag, message: string): RuntimeError;
+export declare function commandFailed(args: RuntimeErrorArgs<"CommandFailed">): RuntimeError;
+export declare function structuredOutputValidationFailed(args: RuntimeErrorArgs<"StructuredOutputValidationFailed">): RuntimeError;
+export declare function ioFailed(seam: "source" | "sink" | "tool", kind: string, message: string): RuntimeError;
+export {};
+//# sourceMappingURL=errors.d.ts.map

package/dist/model/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/model/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE7D,KAAK,gBAAgB,CAAC,GAAG,SAAS,YAAY,CAAC,MAAM,CAAC,IAAI,IAAI,CAC5D,OAAO,CAAC,YAAY,EAAE;IAAE,IAAI,EAAE,GAAG,CAAA;CAAE,CAAC,EACpC,MAAM,CACP,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,CAEhF;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,YAAY,CAEhF;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,gBAAgB,CAAC,eAAe,CAAC,GAAG,YAAY,CAEnF;AAED,wBAAgB,gCAAgC,CAC9C,IAAI,EAAE,gBAAgB,CAAC,kCAAkC,CAAC,GACzD,YAAY,CAEd;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,YAAY,CAEtG"}

package/dist/model/index.d.ts

@@ -0,0 +1,8 @@
+export type * from "./backend-config.ts";
+export * from "./brand.ts";
+export * from "./errors.ts";
+export * from "./json-schema.ts";
+export * from "./result.ts";
+export * from "./schemas.ts";
+export * from "./structured.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/model/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/model/index.ts"],"names":[],"mappings":"AAAA,mBAAmB,qBAAqB,CAAC;AACzC,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC"}

package/dist/model/json-schema.d.ts

@@ -0,0 +1,4 @@
+import { z } from "zod";
+export declare function jsonSchemaFromZod(schema: z.ZodType): unknown;
+export declare function canonicalJsonSchemas(): Record<string, unknown>;
+//# sourceMappingURL=json-schema.d.ts.map

package/dist/model/json-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema.d.ts","sourceRoot":"","sources":["../../src/model/json-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,GAAG,OAAO,CAE5D;AAED,wBAAgB,oBAAoB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAM9D"}

package/dist/model/result.d.ts

@@ -0,0 +1,3 @@
+import type { Result } from "neverthrow";
+export declare function orThrow<T, E>(result: Result<T, E>): T;
+//# sourceMappingURL=result.d.ts.map

package/dist/model/result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../src/model/result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC,wBAAgB,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAUrD"}