@usine/orchestrator 0.2.1 → 0.4.0

package/dist/operator/desk.d.ts

@@ -0,0 +1,206 @@
+import type { LoadedInstance } from "@usine/config/instance";
+import { CycleBudgetAsk } from "@usine/core/cycle-budget";
+import { CycleBudgets } from "@usine/engine/cycle-budget";
+import { ItemProjectionReader } from "@usine/engine/item-projection";
+import { LoopControl } from "@usine/engine/loop-control";
+import { type RunStoreError, UnconfirmedStops } from "@usine/engine/engine";
+import { RunReader } from "@usine/engine/run-reader";
+import { Context, Effect, Layer, Schema } from "effect";
+import { PollingTriggers } from "../polling-triggers.ts";
+import { WorkerStatus } from "../worker-status.ts";
+import { MachineView, ProvisioningPauseView } from "./machines.ts";
+import { AttemptView } from "./attempt.ts";
+import { BoardItemLink } from "./board.ts";
+import { WorkerSlotsView } from "./configuration.ts";
+import { RunView, UnconfirmedStopView } from "./run.ts";
+declare const WorkerSilentView_base: Schema.Class<WorkerSilentView, Schema.TaggedStruct<"WorkerSilent", {
+    readonly worker: Schema.brand<Schema.String, "WorkerName">;
+    readonly lastAnsweredAt: Schema.String;
+}>, {}>;
+/** The Attempt's Worker hasn't answered the executor's probe since `lastAnsweredAt`. */
+export declare class WorkerSilentView extends WorkerSilentView_base {
+}
+declare const ProviderRetryingView_base: Schema.Class<ProviderRetryingView, Schema.TaggedStruct<"ProviderRetrying", {
+    readonly agent: Schema.brand<Schema.String, "AgentName">;
+    readonly message: Schema.NonEmptyString;
+    readonly retries: Schema.brand<Schema.Int, "ProviderRetries">;
+    readonly since: Schema.String;
+}>, {}>;
+/**
+ * A session's harness is retrying its model provider: the retries in this turn, the latest report,
+ * and when the first unanswered retry was recorded.
+ */
+export declare class ProviderRetryingView extends ProviderRetryingView_base {
+}
+/**
+ * An open connectivity problem in an Attempt's transcript. It's a warning and never stops the
+ * Attempt (ADR 0013).
+ */
+export declare const ConnectivityWarningView: Schema.Union<readonly [typeof WorkerSilentView, typeof ProviderRetryingView]>;
+export type ConnectivityWarningView = typeof ConnectivityWarningView.Type;
+declare const RunningAttemptView_base: Schema.Class<RunningAttemptView, Schema.Struct<{
+    readonly run: typeof RunView;
+    readonly attempt: typeof AttemptView;
+    /**
+     * The Run's Item as its Board card links it, or null for a schedule Run or an Item the desk
+     * didn't read.
+     */
+    readonly item: Schema.NullOr<typeof BoardItemLink>;
+    /**
+     * When the Attempt's sessions last showed work, excluding Worker notices, pool meters, and
+     * provider retries. Null if the newest rows show none.
+     */
+    readonly lastActivityAt: Schema.NullOr<Schema.String>;
+    /** The connectivity problems still open after the newest rows. */
+    readonly warnings: Schema.$Array<Schema.Union<readonly [typeof WorkerSilentView, typeof ProviderRetryingView]>>;
+}>, {}>;
+/** A running Attempt with its Run, Item, and recent transcript activity. */
+export declare class RunningAttemptView extends RunningAttemptView_base {
+}
+declare const SuppressedForOperatorView_base: Schema.Class<SuppressedForOperatorView, Schema.TaggedStruct<"SuppressedForOperator", {
+    readonly run: typeof RunView;
+}>, {}>;
+/**
+ * An Agent's question or blocker that suppresses the Item for the Loop until the operator answers
+ * or resolves `run`, or the Item changes (ADR 0017).
+ */
+export declare class SuppressedForOperatorView extends SuppressedForOperatorView_base {
+}
+declare const ClosedUnchangedView_base: Schema.Class<ClosedUnchangedView, Schema.TaggedStruct<"ClosedUnchanged", {
+    readonly run: typeof RunView;
+}>, {}>;
+/**
+ * `run` succeeded or was canceled on the Item's current state, so the Loop opens no other Run until
+ * the state changes (ADR 0007).
+ */
+export declare class ClosedUnchangedView extends ClosedUnchangedView_base {
+}
+declare const RunFailedView_base: Schema.Class<RunFailedView, Schema.TaggedStruct<"RunFailed", {
+    readonly run: typeof RunView;
+}>, {}>;
+/** `run` failed on the Item's current state and waits for the operator to retry it. */
+export declare class RunFailedView extends RunFailedView_base {
+}
+declare const LoopPausedView_base: Schema.Class<LoopPausedView, Schema.TaggedStruct<"LoopPaused", {}>, {}>;
+/** The Loop is paused, so its trigger opens no Run. */
+export declare class LoopPausedView extends LoopPausedView_base {
+}
+declare const CycleBudgetUsedUpView_base: Schema.Class<CycleBudgetUsedUpView, Schema.TaggedStruct<"CycleBudgetUsedUp", {
+    readonly ask: typeof CycleBudgetAsk;
+}>, {}>;
+/** The Item used up its cycle budget; `ask` waits for the operator to reset it. */
+export declare class CycleBudgetUsedUpView extends CycleBudgetUsedUpView_base {
+}
+declare const AwaitingApprovalView_base: Schema.Class<AwaitingApprovalView, Schema.TaggedStruct<"AwaitingApproval", {
+    readonly run: typeof RunView;
+}>, {}>;
+/** `run` waits for the operator's approval. */
+export declare class AwaitingApprovalView extends AwaitingApprovalView_base {
+}
+declare const QueuedForWorkerView_base: Schema.Class<QueuedForWorkerView, Schema.TaggedStruct<"QueuedForWorker", {
+    readonly run: typeof RunView;
+    /**
+     * The fewest Runs that take a Worker slot before `run`, or null if the scheduler doesn't
+     * queue `run`: it hasn't asked for a slot yet, or this process runs no Attempts.
+     */
+    readonly ahead: Schema.NullOr<Schema.Int>;
+    /**
+     * The machine that a provisioned Worker creates for `run`'s next Attempt, or null if none is
+     * being created.
+     */
+    readonly creating: Schema.withConstructorDefault<Schema.NullOr<typeof MachineView>>;
+}>, {}>;
+/** `run` waits for a free Worker slot. */
+export declare class QueuedForWorkerView extends QueuedForWorkerView_base {
+}
+declare const WaitingForStopView_base: Schema.Class<WaitingForStopView, Schema.TaggedStruct<"WaitingForStop", {
+    readonly run: typeof RunView;
+    readonly stop: typeof UnconfirmedStopView;
+}>, {}>;
+/**
+ * `run` starts no Attempt until the parent task of the Attempt in `stop`, on the same Loop and
+ * Item, is confirmed stopped (#523).
+ */
+export declare class WaitingForStopView extends WaitingForStopView_base {
+}
+declare const AwaitingPollView_base: Schema.Class<AwaitingPollView, Schema.TaggedStruct<"AwaitingPoll", {}>, {}>;
+/** No Event of the Loop has a Run for the Item's current state yet. The next poll acts on it. */
+export declare class AwaitingPollView extends AwaitingPollView_base {
+}
+/** The reason a matched Item has no running Attempt. */
+export declare const StallReasonView: Schema.Union<readonly [typeof AwaitingApprovalView, typeof SuppressedForOperatorView, typeof CycleBudgetUsedUpView, typeof RunFailedView, typeof ClosedUnchangedView, typeof LoopPausedView, typeof WaitingForStopView, typeof QueuedForWorkerView, typeof AwaitingPollView]>;
+export type StallReasonView = typeof StallReasonView.Type;
+declare const StalledItemView_base: Schema.Class<StalledItemView, Schema.Struct<{
+    readonly repository: Schema.brand<Schema.String, "RepositoryName">;
+    readonly loop: Schema.brand<Schema.NonEmptyString, "LoopName">;
+    readonly item: typeof BoardItemLink;
+    readonly reason: Schema.Union<readonly [typeof AwaitingApprovalView, typeof SuppressedForOperatorView, typeof CycleBudgetUsedUpView, typeof RunFailedView, typeof ClosedUnchangedView, typeof LoopPausedView, typeof WaitingForStopView, typeof QueuedForWorkerView, typeof AwaitingPollView]>;
+}>, {}>;
+/** An Item that a Loop's trigger matches with no running Attempt, and the reason. */
+export declare class StalledItemView extends StalledItemView_base {
+}
+declare const ClosedRunView_base: Schema.Class<ClosedRunView, Schema.Struct<{
+    readonly run: typeof RunView;
+    /**
+     * The Run's Item as its Board card links it, or null for a schedule Run or an Item the desk
+     * didn't read.
+     */
+    readonly item: Schema.NullOr<typeof BoardItemLink>;
+    /** The Run's `closedAt`, set even for a Run canceled before any Attempt. */
+    readonly closedAt: Schema.String;
+}>, {}>;
+/** A closed Run with its Item and close time. */
+export declare class ClosedRunView extends ClosedRunView_base {
+}
+declare const WorkerView_base: Schema.Class<WorkerView, Schema.Struct<{
+    readonly name: Schema.brand<Schema.String, "WorkerName">;
+    /**
+     * The slots as the scheduler leases them. If the scheduler runs no Attempts (as in setup mode),
+     * the declared `max_concurrent_attempts` with none leased.
+     */
+    readonly slots: typeof WorkerSlotsView;
+    /**
+     * The newest failed check among the Worker's prerequisites and harnesses, or else its degraded
+     * prerequisites, or else the newest passed or deferred check. Null before the first preflight.
+     */
+    readonly preflight: Schema.NullOr<Schema.Union<readonly [typeof import("./configuration.ts").PassedCheckView, typeof import("./configuration.ts").DegradedCheckView, typeof import("./configuration.ts").DeferredCheckView, typeof import("./configuration.ts").FailedCheckView]>>;
+    /** A provisioned Worker's machines in flight, oldest first. */
+    readonly machines: Schema.withConstructorDefault<Schema.$Array<typeof MachineView>>;
+    /** A provisioned Worker's last failed machine creation, or null after a success. */
+    readonly provisioning: Schema.withConstructorDefault<Schema.NullOr<typeof ProvisioningPauseView>>;
+}>, {}>;
+/** One Worker on the desk's Workers line, with its slots and last preflight. */
+export declare class WorkerView extends WorkerView_base {
+}
+declare const RepositoryPollView_base: Schema.Class<RepositoryPollView, Schema.Struct<{
+    readonly repository: Schema.brand<Schema.String, "RepositoryName">;
+    readonly polledAt: Schema.NullOr<Schema.String>;
+}>, {}>;
+/**
+ * When the factory last finished polling a managed repository, or null before the first poll ends.
+ */
+export declare class RepositoryPollView extends RepositoryPollView_base {
+}
+declare const DeskView_base: Schema.Class<DeskView, Schema.Struct<{
+    readonly running: Schema.$Array<typeof RunningAttemptView>;
+    readonly notMoving: Schema.$Array<typeof StalledItemView>;
+    readonly lastOutcomes: Schema.$Array<typeof ClosedRunView>;
+    readonly workers: Schema.$Array<typeof WorkerView>;
+    readonly polls: Schema.$Array<typeof RepositoryPollView>;
+}>, {}>;
+/**
+ * The operator's desk: running Attempts, stalled matched Items, recently closed Runs, Worker slots,
+ * and poll times. Needs you comes from the overview.
+ */
+export declare class DeskView extends DeskView_base {
+}
+declare const OperatorDesk_base: Context.ServiceClass<OperatorDesk, "@usine/orchestrator/OperatorDesk", {
+    /** Returns the instance's desk, as described in `OperatorObservation.desk`. */
+    readonly desk: (instance: LoadedInstance) => Effect.Effect<DeskView, RunStoreError>;
+}>;
+/** Builds the operator's desk from the engine's stores, the Loop matches, and the scheduler's slots. */
+export declare class OperatorDesk extends OperatorDesk_base {
+    static readonly layer: Layer.Layer<OperatorDesk, never, CycleBudgets | import("@usine/expression/expression-engine").ExpressionEngine | ItemProjectionReader | LoopControl | PollingTriggers | RunReader | UnconfirmedStops | WorkerStatus>;
+}
+export {};
+//# sourceMappingURL=desk.d.ts.map

package/dist/operator/desk.d.ts.map

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