@usine/orchestrator 0.2.1 → 0.3.0

package/dist/operator/configuration.d.ts

@@ -0,0 +1,258 @@
+import { ConfigFileError } from "@usine/config/file";
+import type { LoadedInstance } from "@usine/config/instance";
+import type { EnginePersistenceError } from "@usine/engine/engine";
+import { LoopControl } from "@usine/engine/loop-control";
+import { RepositoryLabelProjectionReader } from "@usine/engine/repository-label-projection";
+import { Context, Effect, Layer, Schema } from "effect";
+import { LabelPreflightFinding } from "../label-reconciler.ts";
+import { PollingTriggers } from "../polling-triggers.ts";
+import { type PreflightCheck, WorkerStatus } from "../worker-status.ts";
+declare const LoopSelectorView_base: Schema.Class<LoopSelectorView, Schema.Struct<{
+    readonly repos: Schema.NullOr<Schema.$Array<Schema.brand<Schema.String, "RepositoryName">>>;
+    readonly tags: Schema.NullOr<Schema.$Array<Schema.brand<Schema.String, "RegistryTag">>>;
+}>, {}>;
+/** A Loop's selector as written: the repositories and registry tags. */
+export declare class LoopSelectorView extends LoopSelectorView_base {
+}
+declare const LoopFileView_base: Schema.Class<LoopFileView, Schema.Struct<{
+    readonly name: Schema.brand<Schema.NonEmptyString, "LoopName">;
+    readonly file: Schema.brand<Schema.NonEmptyString, "InstancePath">;
+    /** The trigger's `on:` stream. */
+    readonly stream: Schema.Literals<readonly ["issue", "pr", "schedule"]>;
+    /** The trigger's `if:` expression as written. */
+    readonly condition: Schema.brand<Schema.String, "ExpressionSource">;
+    /** A schedule trigger's cron and time zone, or null for the other streams. */
+    readonly cron: Schema.NullOr<Schema.brand<Schema.String, "Cron">>;
+    readonly timeZone: Schema.NullOr<Schema.brand<Schema.String, "TimeZone">>;
+    /** Null if the file has no selector, so the Loop applies to every registered repository. */
+    readonly selector: Schema.NullOr<typeof LoopSelectorView>;
+    /** The registered repositories the selector selects, in `usine.yaml` order. */
+    readonly repositories: Schema.$Array<Schema.brand<Schema.String, "RepositoryName">>;
+    readonly approval: Schema.Literals<readonly ["none", "required"]>;
+    readonly maxCycles: Schema.brand<Schema.Int, "CycleLimit">;
+    readonly permissions: Schema.Literals<readonly ["write", "read"]>;
+    readonly step: Schema.brand<Schema.NonEmptyString, "StepName">;
+    readonly agent: Schema.brand<Schema.String, "AgentName">;
+    /** The Markdown prompt template, with its `{{ }}` expressions as written. */
+    readonly prompt: Schema.brand<Schema.String, "PromptTemplate">;
+    readonly paused: Schema.Boolean;
+    /** Labels the trigger compares against that `usine.yaml` doesn't declare in `labels`. */
+    readonly undeclaredLabels: Schema.$Array<Schema.brand<Schema.String, "GitHubLabelName">>;
+}>, {}>;
+/** A parsed Loop file with its runtime pause state. */
+export declare class LoopFileView extends LoopFileView_base {
+}
+declare const QuarantinedLoopView_base: Schema.Class<QuarantinedLoopView, Schema.Struct<{
+    /** The file name without its folder and `.md` extension. */
+    readonly name: Schema.NonEmptyString;
+    readonly file: Schema.brand<Schema.NonEmptyString, "InstancePath">;
+    readonly error: typeof ConfigFileError;
+}>, {}>;
+/** A Loop file that failed to load and opens no Runs, with the failed stage and reason. */
+export declare class QuarantinedLoopView extends QuarantinedLoopView_base {
+}
+declare const AgentFileView_base: Schema.Class<AgentFileView, Schema.Struct<{
+    readonly name: Schema.brand<Schema.String, "AgentName">;
+    readonly file: Schema.brand<Schema.NonEmptyString, "InstancePath">;
+    readonly harness: Schema.Literals<readonly ["claude", "codex", "pi"]>;
+    readonly model: Schema.brand<Schema.String, "ModelId">;
+    readonly effort: Schema.Literals<readonly ["off", "minimal", "low", "medium", "high", "xhigh", "max"]>;
+    /** The file's own parent model and effort, or null if it sets none. */
+    readonly parentModel: Schema.NullOr<Schema.brand<Schema.String, "ModelId">>;
+    readonly parentEffort: Schema.NullOr<Schema.Literals<readonly ["off", "minimal", "low", "medium", "high", "xhigh", "max"]>>;
+    /** The file's parent model, else `settings.parent_model`. If null, Pi chooses. */
+    readonly resolvedParentModel: Schema.NullOr<Schema.brand<Schema.String, "ModelId">>;
+    /** The file's parent effort, else `settings.parent_effort`, else `effort`. */
+    readonly resolvedParentEffort: Schema.Literals<readonly ["off", "minimal", "low", "medium", "high", "xhigh", "max"]>;
+    readonly persona: Schema.brand<Schema.String, "AgentPersona">;
+    /** The loaded Loops that use this Agent. */
+    readonly loops: Schema.$Array<Schema.brand<Schema.NonEmptyString, "LoopName">>;
+}>, {}>;
+/** A parsed rostered Agent file with the Loops that use it. */
+export declare class AgentFileView extends AgentFileView_base {
+}
+declare const InvalidAgentView_base: Schema.Class<InvalidAgentView, Schema.Struct<{
+    /** The file name without its folder and `.md` extension. */
+    readonly name: Schema.NonEmptyString;
+    readonly file: Schema.brand<Schema.NonEmptyString, "InstancePath">;
+    readonly error: typeof ConfigFileError;
+}>, {}>;
+/**
+ * An Agent file that failed to load and is left out of the roster, with the failed stage and
+ * reason.
+ */
+export declare class InvalidAgentView extends InvalidAgentView_base {
+}
+declare const GatewayView_base: Schema.Class<GatewayView, Schema.Struct<{
+    readonly domain: Schema.brand<Schema.String, "GatewayDomain">;
+    readonly destination: Schema.brand<Schema.String, "SshDestination">;
+    readonly adminPort: Schema.brand<Schema.Int, "GatewayAdminPort">;
+    readonly adminTokenEnv: Schema.NonEmptyString;
+    readonly llmProviders: Schema.$Array<Schema.Literals<readonly ["anthropic"]>>;
+}>, {}>;
+/**
+ * The Gateway in front of an SSH Worker. Includes only the name of the environment variable with
+ * its admin token.
+ */
+export declare class GatewayView extends GatewayView_base {
+}
+declare const WorkerSlotsView_base: Schema.Class<WorkerSlotsView, Schema.Struct<{
+    /** The number of slots for Attempts: `max_concurrent_attempts` once a reload applied it. */
+    readonly capacity: Schema.Int;
+    readonly leased: Schema.Int;
+}>, {}>;
+/** The current slot usage of a Worker. */
+export declare class WorkerSlotsView extends WorkerSlotsView_base {
+}
+declare const PassedCheckView_base: Schema.Class<PassedCheckView, Schema.TaggedStruct<"Passed", {
+    readonly checkedAt: Schema.String;
+}>, {}>;
+/** A passed preflight check, at an ISO instant. */
+export declare class PassedCheckView extends PassedCheckView_base {
+}
+declare const FailedCheckView_base: Schema.Class<FailedCheckView, Schema.TaggedStruct<"Failed", {
+    readonly checkedAt: Schema.String;
+    /** Null when the check itself failed, such as a timed-out probe. */
+    readonly capability: Schema.NullOr<Schema.Literals<readonly ["machine", "toolchain", "memory", "harness-login", "credentials", "gateway"]>>;
+    readonly message: Schema.String;
+}>, {}>;
+/** A preflight check that found a missing prerequisite or couldn't run, at an ISO instant. */
+export declare class FailedCheckView extends FailedCheckView_base {
+}
+export declare const PreflightCheckView: Schema.Union<readonly [typeof PassedCheckView, typeof FailedCheckView]>;
+export type PreflightCheckView = typeof PreflightCheckView.Type;
+declare const HarnessPreflightView_base: Schema.Class<HarnessPreflightView, Schema.Struct<{
+    readonly harness: Schema.Literals<readonly ["claude", "codex", "pi"]>;
+    readonly check: Schema.Union<readonly [typeof PassedCheckView, typeof FailedCheckView]>;
+}>, {}>;
+/** The last preflight of one harness on a Worker. */
+export declare class HarnessPreflightView extends HarnessPreflightView_base {
+}
+declare const WorkerConfigurationView_base: Schema.Class<WorkerConfigurationView, Schema.Struct<{
+    readonly name: Schema.brand<Schema.String, "WorkerName">;
+    readonly kind: Schema.Literals<readonly ["local", "exe.dev", "ssh"]>;
+    readonly maxConcurrentAttempts: Schema.Int;
+    /** An SSH Worker's connection and root, or null for the other kinds. */
+    readonly destination: Schema.NullOr<Schema.brand<Schema.String, "SshDestination">>;
+    readonly port: Schema.NullOr<Schema.brand<Schema.Int, "SshPort">>;
+    readonly identityFile: Schema.NullOr<Schema.brand<Schema.String, "SshIdentityFile">>;
+    readonly root: Schema.NullOr<Schema.brand<Schema.String, "WorkerRoot">>;
+    readonly gateway: Schema.NullOr<typeof GatewayView>;
+    /** Null while the scheduler runs no Attempts, as in setup mode. */
+    readonly slots: Schema.NullOr<typeof WorkerSlotsView>;
+    /**
+     * The Worker's own prerequisites: machine, Git, memory, Gateway, and credentials. Null before any
+     * preflight.
+     */
+    readonly prerequisites: Schema.NullOr<Schema.Union<readonly [typeof PassedCheckView, typeof FailedCheckView]>>;
+    /** In harness name order; empty before any harness check. */
+    readonly harnesses: Schema.$Array<typeof HarnessPreflightView>;
+}>, {}>;
+/** A Worker as declared in `usine.yaml`, with its slot usage and last preflight. */
+export declare class WorkerConfigurationView extends WorkerConfigurationView_base {
+}
+declare const RemovedWorkerView_base: Schema.Class<RemovedWorkerView, Schema.Struct<{
+    readonly name: Schema.brand<Schema.String, "WorkerName">;
+    readonly running: Schema.Int;
+}>, {}>;
+/** A Worker removed by a reload that still runs Attempts. It's removed when the last one ends. */
+export declare class RemovedWorkerView extends RemovedWorkerView_base {
+}
+declare const LabelStateView_base: Schema.Class<LabelStateView, Schema.Struct<{
+    readonly name: Schema.brand<Schema.String, "GitHubLabelName">;
+    /** Null until polling has read the repository's labels. */
+    readonly onGitHub: Schema.NullOr<Schema.Boolean>;
+    /** The repository's label color, else the color declared in `labels`, as six hex digits. */
+    readonly color: Schema.NullOr<Schema.String>;
+    readonly description: Schema.NullOr<Schema.String>;
+    /** Whether `labels` in `usine.yaml` declares the label, so usine creates it if missing. */
+    readonly declared: Schema.Boolean;
+    /** The reason usine couldn't create or confirm the label at the last poll. */
+    readonly failure: Schema.NullOr<typeof LabelPreflightFinding>;
+}>, {}>;
+/** A GitHub label in one repository, as of the last label poll. */
+export declare class LabelStateView extends LabelStateView_base {
+}
+declare const LabelLaneSourceView_base: Schema.Class<LabelLaneSourceView, Schema.TaggedStruct<"Label", {
+    readonly label: typeof LabelStateView;
+}>, {}>;
+/** A lane source that routes Items by label. */
+export declare class LabelLaneSourceView extends LabelLaneSourceView_base {
+}
+declare const StateLaneSourceView_base: Schema.Class<StateLaneSourceView, Schema.TaggedStruct<"State", {
+    readonly state: Schema.Literals<readonly ["issue-open", "issue-closed", "pr-open", "pr-closed", "pr-merged"]>;
+}>, {}>;
+/** A lane source that routes Items by issue or pull request state. */
+export declare class StateLaneSourceView extends StateLaneSourceView_base {
+}
+export declare const LaneSourceView: Schema.Union<readonly [typeof LabelLaneSourceView, typeof StateLaneSourceView]>;
+export type LaneSourceView = typeof LaneSourceView.Type;
+declare const LaneConfigurationView_base: Schema.Class<LaneConfigurationView, Schema.Struct<{
+    readonly name: Schema.brand<Schema.String, "LaneName">;
+    readonly sources: Schema.$Array<Schema.Union<readonly [typeof LabelLaneSourceView, typeof StateLaneSourceView]>>;
+}>, {}>;
+/** One lane declared in `repos[].lanes`, with its sources in file order. */
+export declare class LaneConfigurationView extends LaneConfigurationView_base {
+}
+declare const RepositoryConfigurationView_base: Schema.Class<RepositoryConfigurationView, Schema.Struct<{
+    readonly name: Schema.brand<Schema.String, "RepositoryName">;
+    readonly tags: Schema.$Array<Schema.brand<Schema.String, "RegistryTag">>;
+    /** Empty if `usine.yaml` declares no lanes, so the Board proposes lanes from the labels. */
+    readonly lanes: Schema.$Array<typeof LaneConfigurationView>;
+    /** The labels declared in `usine.yaml`, as this repository has them. */
+    readonly declaredLabels: Schema.$Array<typeof LabelStateView>;
+    /** The loaded Loops whose selector selects this repository. */
+    readonly loops: Schema.$Array<Schema.brand<Schema.NonEmptyString, "LoopName">>;
+}>, {}>;
+/** A registered repository with its lanes in Board order, declared labels, and Loops. */
+export declare class RepositoryConfigurationView extends RepositoryConfigurationView_base {
+}
+declare const SettingsView_base: Schema.Class<SettingsView, Schema.Struct<{
+    readonly pollInterval: Schema.Int;
+    readonly maxChildren: Schema.Int;
+    readonly maxAttemptMinutes: Schema.NullOr<Schema.Int>;
+    readonly maxAttemptTokens: Schema.NullOr<Schema.Int>;
+    readonly parentModel: Schema.NullOr<Schema.brand<Schema.String, "ModelId">>;
+    readonly parentEffort: Schema.NullOr<Schema.Literals<readonly ["off", "minimal", "low", "medium", "high", "xhigh", "max"]>>;
+    readonly operator: Schema.NullOr<Schema.brand<Schema.String, "OperatorLogin">>;
+    readonly webhooks: Schema.Literals<readonly ["off", "deliveries", "endpoint"]>;
+    /** The public URL for `endpoint` webhooks, or null for the other modes. */
+    readonly webhooksPublicUrl: Schema.NullOr<Schema.String>;
+}>, {}>;
+/** The `settings`, `operator`, and webhooks mode of `usine.yaml`, with defaults applied. */
+export declare class SettingsView extends SettingsView_base {
+}
+declare const ConfigurationView_base: Schema.Class<ConfigurationView, Schema.Struct<{
+    readonly loops: Schema.$Array<typeof LoopFileView>;
+    readonly quarantinedLoops: Schema.$Array<typeof QuarantinedLoopView>;
+    readonly agents: Schema.$Array<typeof AgentFileView>;
+    readonly invalidAgents: Schema.$Array<typeof InvalidAgentView>;
+    readonly workers: Schema.$Array<typeof WorkerConfigurationView>;
+    readonly removedWorkers: Schema.$Array<typeof RemovedWorkerView>;
+    readonly repositories: Schema.$Array<typeof RepositoryConfigurationView>;
+    readonly settings: typeof SettingsView;
+}>, {}>;
+/**
+ * The parsed instance folder (Loops, Agents, Workers, repositories, and settings), the files that
+ * failed to load, and the runtime state of each.
+ */
+export declare class ConfigurationView extends ConfigurationView_base {
+}
+/** Returns the operator API view of a preflight check. */
+export declare const checkView: (check: PreflightCheck) => PreflightCheckView;
+declare const OperatorConfiguration_base: Context.ServiceClass<OperatorConfiguration, "@usine/orchestrator/OperatorConfiguration", {
+    /**
+     * Returns the instance's configuration view with runtime state. Contains no secrets: a
+     * Gateway's admin token appears only as its environment variable name.
+     */
+    readonly view: (instance: LoadedInstance) => Effect.Effect<ConfigurationView, EnginePersistenceError>;
+}>;
+/**
+ * The operator's view of the parsed instance folder and its runtime state. Reads only memory and
+ * the runtime store, never the files.
+ */
+export declare class OperatorConfiguration extends OperatorConfiguration_base {
+    static readonly layer: Layer.Layer<OperatorConfiguration, never, LoopControl | PollingTriggers | RepositoryLabelProjectionReader | WorkerStatus>;
+}
+export {};
+//# sourceMappingURL=configuration.d.ts.map

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

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