@usine/orchestrator 0.1.0 → 0.2.1

package/dist/operator/board.d.ts

@@ -0,0 +1,119 @@
+import { Schema } from "effect";
+import { RunView } from "./run.ts";
+/** Identifies a lane within a Project's Board for operator moves. */
+export declare const BoardLaneId: Schema.brand<Schema.NonEmptyString, "BoardLaneId">;
+export type BoardLaneId = typeof BoardLaneId.Type;
+/** Whether a lane came from authored settings, a proposal, or default grouping. */
+export declare const BoardLaneOrigin: Schema.Literals<readonly ["authored", "proposed", "fallback"]>;
+export type BoardLaneOrigin = typeof BoardLaneOrigin.Type;
+declare const BoardItemLink_base: Schema.Class<BoardItemLink, Schema.Struct<{
+    readonly itemKey: Schema.brand<Schema.NonEmptyString, "ItemKey">;
+    readonly kind: Schema.Literals<readonly ["issue", "pr"]>;
+    readonly number: Schema.brand<Schema.Int, "ItemNumber">;
+    readonly title: Schema.String;
+    readonly url: Schema.NonEmptyString;
+}>, {}>;
+/** An Item linked to a Task, with its own title and external destination. */
+export declare class BoardItemLink extends BoardItemLink_base {
+}
+declare const BoardTaskView_base: Schema.Class<BoardTaskView, Schema.Struct<{
+    readonly itemKey: Schema.brand<Schema.NonEmptyString, "ItemKey">;
+    readonly kind: Schema.Literals<readonly ["issue", "pr"]>;
+    readonly number: Schema.brand<Schema.Int, "ItemNumber">;
+    readonly title: Schema.String;
+    readonly url: Schema.NonEmptyString;
+    readonly state: Schema.Literals<readonly ["issue-open", "issue-closed", "pr-open", "pr-closed", "pr-merged"]>;
+    readonly labels: Schema.$Array<Schema.brand<Schema.String, "GitHubLabelName">>;
+    readonly items: Schema.$Array<typeof BoardItemLink>;
+    /** Every saved Run for the visible Items, ordered from earliest to latest. */
+    readonly runs: Schema.$Array<typeof RunView>;
+    readonly run: Schema.NullOr<typeof RunView>;
+    readonly needsYou: Schema.Boolean;
+}>, {}>;
+/** A Task projected from linked Items. The current Item determines the key, lane, labels, and move destination; the first issue supplies the Task title. */
+export declare class BoardTaskView extends BoardTaskView_base {
+}
+declare const WritableBoardLaneView_base: Schema.Class<WritableBoardLaneView, Schema.TaggedStruct<"WritableBoardLane", {
+    readonly id: Schema.brand<Schema.NonEmptyString, "BoardLaneId">;
+    readonly name: Schema.brand<Schema.String, "LaneName">;
+    readonly sources: Schema.$Array<Schema.Union<readonly [typeof import("@usine/config/board").LabelLaneSource, typeof import("@usine/config/board").StateLaneSource]>>;
+    readonly items: Schema.$Array<typeof BoardTaskView>;
+    readonly origin: Schema.Literal<"authored">;
+    readonly labels: Schema.$Array<Schema.brand<Schema.String, "GitHubLabelName">>;
+}>, {}>;
+/** An authored lane the operator can move Items into by applying its configured GitHub labels. */
+export declare class WritableBoardLaneView extends WritableBoardLaneView_base {
+}
+declare const ReadOnlyBoardLaneView_base: Schema.Class<ReadOnlyBoardLaneView, Schema.TaggedStruct<"ReadOnlyBoardLane", {
+    readonly id: Schema.brand<Schema.NonEmptyString, "BoardLaneId">;
+    readonly name: Schema.brand<Schema.String, "LaneName">;
+    readonly sources: Schema.$Array<Schema.Union<readonly [typeof import("@usine/config/board").LabelLaneSource, typeof import("@usine/config/board").StateLaneSource]>>;
+    readonly origin: Schema.Literals<readonly ["authored", "proposed", "fallback"]>;
+    readonly items: Schema.$Array<typeof BoardTaskView>;
+}>, {}>;
+/** A lane that groups Items without accepting label-based moves. */
+export declare class ReadOnlyBoardLaneView extends ReadOnlyBoardLaneView_base {
+}
+/** A displayed lane whose variant determines whether operator moves are supported. */
+export declare const BoardLaneView: Schema.Union<readonly [typeof WritableBoardLaneView, typeof ReadOnlyBoardLaneView]>;
+export type BoardLaneView = typeof BoardLaneView.Type;
+declare const BoardProjectionError_base: Schema.Class<BoardProjectionError, Schema.TaggedStruct<"BoardProjectionError", {
+    readonly repository: Schema.brand<Schema.String, "RepositoryName">;
+    readonly itemKey: Schema.brand<Schema.NonEmptyString, "ItemKey">;
+    readonly message: Schema.NonEmptyString;
+}>, import("effect/Cause").YieldableError>;
+/** An Item projection could not produce a Board card; other Items remain available. */
+export declare class BoardProjectionError extends BoardProjectionError_base {
+}
+declare const BoardView_base: Schema.Class<BoardView, Schema.Struct<{
+    readonly lanes: Schema.$Array<Schema.Union<readonly [typeof WritableBoardLaneView, typeof ReadOnlyBoardLaneView]>>;
+    readonly failures: Schema.$Array<typeof BoardProjectionError>;
+}>, {}>;
+/** The Project's lanes and the Item failures encountered while constructing their cards. */
+export declare class BoardView extends BoardView_base {
+}
+declare const LabelView_base: Schema.Class<LabelView, Schema.Struct<{
+    readonly name: Schema.brand<Schema.String, "GitHubLabelName">;
+    readonly color: Schema.NullOr<Schema.String>;
+    readonly description: Schema.NullOr<Schema.String>;
+}>, {}>;
+/** A repository label as GitHub shows it. Color is null for catalogs stored before colors were kept. */
+export declare class LabelView extends LabelView_base {
+}
+declare const BoardMove_base: Schema.Class<BoardMove, Schema.Struct<{
+    readonly repository: Schema.brand<Schema.String, "RepositoryName">;
+    readonly item: Schema.brand<Schema.Int, "ItemNumber">;
+    readonly toLane: Schema.brand<Schema.NonEmptyString, "BoardLaneId">;
+}>, {}>;
+/** An operator request to move one Project Item into a destination lane. */
+export declare class BoardMove extends BoardMove_base {
+}
+declare const BoardProjectNotFoundError_base: Schema.Class<BoardProjectNotFoundError, Schema.TaggedStruct<"BoardProjectNotFoundError", {
+    readonly repository: Schema.brand<Schema.String, "RepositoryName">;
+}>, import("effect/Cause").YieldableError>;
+/** The requested Project is absent from the operator overview. */
+export declare class BoardProjectNotFoundError extends BoardProjectNotFoundError_base {
+}
+declare const BoardItemNotFoundError_base: Schema.Class<BoardItemNotFoundError, Schema.TaggedStruct<"BoardItemNotFoundError", {
+    readonly repository: Schema.brand<Schema.String, "RepositoryName">;
+    readonly item: Schema.brand<Schema.Int, "ItemNumber">;
+}>, import("effect/Cause").YieldableError>;
+/** The requested Item is absent from the Project's Board. */
+export declare class BoardItemNotFoundError extends BoardItemNotFoundError_base {
+}
+declare const BoardLaneNotFoundError_base: Schema.Class<BoardLaneNotFoundError, Schema.TaggedStruct<"BoardLaneNotFoundError", {
+    readonly repository: Schema.brand<Schema.String, "RepositoryName">;
+    readonly lane: Schema.brand<Schema.NonEmptyString, "BoardLaneId">;
+}>, import("effect/Cause").YieldableError>;
+/** The requested destination lane is absent from the Project's Board. */
+export declare class BoardLaneNotFoundError extends BoardLaneNotFoundError_base {
+}
+declare const BoardLaneReadOnlyError_base: Schema.Class<BoardLaneReadOnlyError, Schema.TaggedStruct<"BoardLaneReadOnlyError", {
+    readonly repository: Schema.brand<Schema.String, "RepositoryName">;
+    readonly lane: Schema.brand<Schema.NonEmptyString, "BoardLaneId">;
+}>, import("effect/Cause").YieldableError>;
+/** The requested destination lane does not accept label-based moves. */
+export declare class BoardLaneReadOnlyError extends BoardLaneReadOnlyError_base {
+}
+export {};
+//# sourceMappingURL=board.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"board.d.ts","sourceRoot":"","sources":["../../src/operator/board.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAEnC,qEAAqE;AACrE,eAAO,MAAM,WAAW,oDAA0D,CAAC;AACnF,MAAM,MAAM,WAAW,GAAG,OAAO,WAAW,CAAC,IAAI,CAAC;AAElD,mFAAmF;AACnF,eAAO,MAAM,eAAe,gEAAwD,CAAC;AACrF,MAAM,MAAM,eAAe,GAAG,OAAO,eAAe,CAAC,IAAI,CAAC;;;;;;;;AAE1D,6EAA6E;AAC7E,qBAAa,aAAc,SAAQ,kBAQlC;CAAG;;;;;;;;;;IASA,8EAA8E;;;;;AAPlF,4JAA4J;AAC5J,qBAAa,aAAc,SAAQ,kBAWlC;CAAG;;;;;;;;;AAUJ,kGAAkG;AAClG,qBAAa,qBAAsB,SAAQ,0BAMzC;CAAG;;;;;;;;AAEL,oEAAoE;AACpE,qBAAa,qBAAsB,SAAQ,0BAEA;CAAG;AAE9C,sFAAsF;AACtF,eAAO,MAAM,aAAa,qFAA+D,CAAC;AAC1F,MAAM,MAAM,aAAa,GAAG,OAAO,aAAa,CAAC,IAAI,CAAC;;;;;;AAEtD,uFAAuF;AACvF,qBAAa,oBAAqB,SAAQ,yBAMxC;CAAG;;;;;AAEL,4FAA4F;AAC5F,qBAAa,SAAU,SAAQ,cAG7B;CAAG;;;;;;AAEL,wGAAwG;AACxG,qBAAa,SAAU,SAAQ,cAI7B;CAAG;;;;;;AAEL,4EAA4E;AAC5E,qBAAa,SAAU,SAAQ,cAI7B;CAAG;;;;AAEL,kEAAkE;AAClE,qBAAa,yBAA0B,SAAQ,8BAI7C;CAAG;;;;;AAEL,6DAA6D;AAC7D,qBAAa,sBAAuB,SAAQ,2BAK1C;CAAG;;;;;AAEL,yEAAyE;AACzE,qBAAa,sBAAuB,SAAQ,2BAK1C;CAAG;;;;;AAEL,wEAAwE;AACxE,qBAAa,sBAAuB,SAAQ,2BAK1C;CAAG"}

package/dist/operator/board.js

@@ -0,0 +1,101 @@
+import { ItemKey, ItemNumber } from "@usine/core/item";
+import { RepositoryName } from "@usine/core/repository";
+import { GitHubLabelName } from "@usine/config/label";
+import { LaneItemState, LaneName, LaneSource } from "@usine/config/board";
+import { Schema } from "effect";
+import { RunView } from "./run.js";
+/** Identifies a lane within a Project's Board for operator moves. */
+export const BoardLaneId = Schema.NonEmptyString.pipe(Schema.brand("BoardLaneId"));
+/** Whether a lane came from authored settings, a proposal, or default grouping. */
+export const BoardLaneOrigin = Schema.Literals(["authored", "proposed", "fallback"]);
+/** An Item linked to a Task, with its own title and external destination. */
+export class BoardItemLink extends Schema.Class("@usine/orchestrator/BoardItemLink")({
+    itemKey: ItemKey,
+    kind: Schema.Literals(["issue", "pr"]),
+    number: ItemNumber,
+    title: Schema.String,
+    url: Schema.NonEmptyString,
+}) {
+}
+/** A Task projected from linked Items. The current Item determines the key, lane, labels, and move destination; the first issue supplies the Task title. */
+export class BoardTaskView extends Schema.Class("@usine/orchestrator/BoardTaskView")({
+    ...BoardItemLink.fields,
+    state: LaneItemState,
+    labels: Schema.Array(GitHubLabelName),
+    items: Schema.Array(BoardItemLink).check(Schema.isNonEmpty()),
+    /** Every saved Run for the visible Items, ordered from earliest to latest. */
+    runs: Schema.Array(RunView),
+    run: Schema.NullOr(RunView),
+    needsYou: Schema.Boolean,
+}) {
+}
+const BoardLaneViewFields = {
+    id: BoardLaneId,
+    name: LaneName,
+    sources: Schema.Array(LaneSource),
+    origin: BoardLaneOrigin,
+    items: Schema.Array(BoardTaskView),
+};
+/** An authored lane the operator can move Items into by applying its configured GitHub labels. */
+export class WritableBoardLaneView extends Schema.TaggedClass("@usine/orchestrator/WritableBoardLaneView")("WritableBoardLane", {
+    ...BoardLaneViewFields,
+    origin: Schema.Literal("authored"),
+    labels: Schema.Array(GitHubLabelName).check(Schema.isNonEmpty()),
+}) {
+}
+/** A lane that groups Items without accepting label-based moves. */
+export class ReadOnlyBoardLaneView extends Schema.TaggedClass("@usine/orchestrator/ReadOnlyBoardLaneView")("ReadOnlyBoardLane", BoardLaneViewFields) {
+}
+/** A displayed lane whose variant determines whether operator moves are supported. */
+export const BoardLaneView = Schema.Union([WritableBoardLaneView, ReadOnlyBoardLaneView]);
+/** An Item projection could not produce a Board card; other Items remain available. */
+export class BoardProjectionError extends Schema.TaggedError("@usine/orchestrator/BoardProjectionError")("BoardProjectionError", {
+    repository: RepositoryName,
+    itemKey: ItemKey,
+    message: Schema.NonEmptyString,
+}) {
+}
+/** The Project's lanes and the Item failures encountered while constructing their cards. */
+export class BoardView extends Schema.Class("@usine/orchestrator/BoardView")({
+    lanes: Schema.Array(BoardLaneView),
+    failures: Schema.Array(BoardProjectionError),
+}) {
+}
+/** A repository label as GitHub shows it. Color is null for catalogs stored before colors were kept. */
+export class LabelView extends Schema.Class("@usine/orchestrator/LabelView")({
+    name: GitHubLabelName,
+    color: Schema.NullOr(Schema.String),
+    description: Schema.NullOr(Schema.String),
+}) {
+}
+/** An operator request to move one Project Item into a destination lane. */
+export class BoardMove extends Schema.Class("@usine/orchestrator/BoardMove")({
+    repository: RepositoryName,
+    item: ItemNumber,
+    toLane: BoardLaneId,
+}) {
+}
+/** The requested Project is absent from the operator overview. */
+export class BoardProjectNotFoundError extends Schema.TaggedError("@usine/orchestrator/BoardProjectNotFoundError")("BoardProjectNotFoundError", {
+    repository: RepositoryName,
+}) {
+}
+/** The requested Item is absent from the Project's Board. */
+export class BoardItemNotFoundError extends Schema.TaggedError("@usine/orchestrator/BoardItemNotFoundError")("BoardItemNotFoundError", {
+    repository: RepositoryName,
+    item: ItemNumber,
+}) {
+}
+/** The requested destination lane is absent from the Project's Board. */
+export class BoardLaneNotFoundError extends Schema.TaggedError("@usine/orchestrator/BoardLaneNotFoundError")("BoardLaneNotFoundError", {
+    repository: RepositoryName,
+    lane: BoardLaneId,
+}) {
+}
+/** The requested destination lane does not accept label-based moves. */
+export class BoardLaneReadOnlyError extends Schema.TaggedError("@usine/orchestrator/BoardLaneReadOnlyError")("BoardLaneReadOnlyError", {
+    repository: RepositoryName,
+    lane: BoardLaneId,
+}) {
+}
+//# sourceMappingURL=board.js.map

package/dist/operator/board.js.map

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

package/dist/operator/http.d.ts

@@ -0,0 +1,180 @@
+import { Schema } from "effect";
+import { HttpApi, HttpApiEndpoint, HttpApiGroup, HttpApiMiddleware } from "effect/unstable/httpapi";
+import { ColdTranscriptRequest, EarlierTranscriptRequest, TailTranscriptRequest } from "./transcript.ts";
+import { RunDetailView, EditAndRetry, SessionIntervention } from "./run.ts";
+declare const OperatorHttpError_base: Schema.Class<OperatorHttpError, Schema.Struct<{
+    readonly error: Schema.Literals<("AppPermissionError" | "AttemptCancellationError" | "BackendUnavailableError" | "BoardItemNotFoundError" | "BoardLaneNotFoundError" | "BoardLaneReadOnlyError" | "BoardProjectNotFoundError" | "CrossSiteRequestError" | "CycleBudgetResetRejectedError" | "EnginePersistenceError" | "GitHubApiError" | "GitHubRateLimitError" | "HttpBodyError" | "InstallationDiscoveryError" | "InvalidGitHubResponseError" | "InvalidRequestError" | "RosterAgentNotFoundError" | "RunInterventionRejectedError" | "RunNotFoundError" | "RunOperationRejectedError" | "SchemaError" | "TranscriptAttemptNotFoundError")[]>;
+    readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+/**
+ * An operator request that could not be fulfilled. `error` preserves the domain
+ * failure's identity and `message` is safe to show to the operator; persistence
+ * details, credentials, and defect causes never travel in this envelope.
+ */
+export declare class OperatorHttpError extends OperatorHttpError_base {
+    /** The existing HTTP status associated with this refusal or failure. */
+    get status(): 400 | 403 | 404 | 409 | 500 | 502 | 503;
+}
+declare const OperatorHttpPolicy_base: HttpApiMiddleware.ServiceClass<OperatorHttpPolicy, "@usine/orchestrator/OperatorHttpPolicy", {
+    requires: never;
+    provides: never;
+    error: Schema.decodeTo<Schema.declareConstructor<OperatorHttpError, {
+        readonly error: "AppPermissionError" | "AttemptCancellationError" | "BackendUnavailableError" | "BoardItemNotFoundError" | "BoardLaneNotFoundError" | "BoardLaneReadOnlyError" | "BoardProjectNotFoundError" | "CrossSiteRequestError" | "CycleBudgetResetRejectedError" | "EnginePersistenceError" | "GitHubApiError" | "GitHubRateLimitError" | "HttpBodyError" | "InstallationDiscoveryError" | "InvalidGitHubResponseError" | "InvalidRequestError" | "RosterAgentNotFoundError" | "RunInterventionRejectedError" | "RunNotFoundError" | "RunOperationRejectedError" | "SchemaError" | "TranscriptAttemptNotFoundError";
+        readonly message: string;
+    }, readonly [Schema.Struct<{
+        readonly error: Schema.Literals<("AppPermissionError" | "AttemptCancellationError" | "BackendUnavailableError" | "BoardItemNotFoundError" | "BoardLaneNotFoundError" | "BoardLaneReadOnlyError" | "BoardProjectNotFoundError" | "CrossSiteRequestError" | "CycleBudgetResetRejectedError" | "EnginePersistenceError" | "GitHubApiError" | "GitHubRateLimitError" | "HttpBodyError" | "InstallationDiscoveryError" | "InvalidGitHubResponseError" | "InvalidRequestError" | "RosterAgentNotFoundError" | "RunInterventionRejectedError" | "RunNotFoundError" | "RunOperationRejectedError" | "SchemaError" | "TranscriptAttemptNotFoundError")[]>;
+        readonly message: Schema.String;
+    }>], {
+        readonly error: "AppPermissionError" | "AttemptCancellationError" | "BackendUnavailableError" | "BoardItemNotFoundError" | "BoardLaneNotFoundError" | "BoardLaneReadOnlyError" | "BoardProjectNotFoundError" | "CrossSiteRequestError" | "CycleBudgetResetRejectedError" | "EnginePersistenceError" | "GitHubApiError" | "GitHubRateLimitError" | "HttpBodyError" | "InstallationDiscoveryError" | "InvalidGitHubResponseError" | "InvalidRequestError" | "RosterAgentNotFoundError" | "RunInterventionRejectedError" | "RunNotFoundError" | "RunOperationRejectedError" | "SchemaError" | "TranscriptAttemptNotFoundError";
+        readonly message: string;
+    }>, Schema.Struct<{
+        readonly error: Schema.Literals<("AppPermissionError" | "AttemptCancellationError" | "BackendUnavailableError" | "BoardItemNotFoundError" | "BoardLaneNotFoundError" | "BoardLaneReadOnlyError" | "BoardProjectNotFoundError" | "CrossSiteRequestError" | "CycleBudgetResetRejectedError" | "EnginePersistenceError" | "GitHubApiError" | "GitHubRateLimitError" | "HttpBodyError" | "InstallationDiscoveryError" | "InvalidGitHubResponseError" | "InvalidRequestError" | "RosterAgentNotFoundError" | "RunInterventionRejectedError" | "RunNotFoundError" | "RunOperationRejectedError" | "SchemaError" | "TranscriptAttemptNotFoundError")[]>;
+        readonly message: Schema.String;
+    }>, never, never>[];
+    clientError: never;
+    requiredForClient: false;
+    security: never;
+}, HttpApiMiddleware.HttpApiMiddleware<never, Schema.decodeTo<Schema.declareConstructor<OperatorHttpError, {
+    readonly error: "AppPermissionError" | "AttemptCancellationError" | "BackendUnavailableError" | "BoardItemNotFoundError" | "BoardLaneNotFoundError" | "BoardLaneReadOnlyError" | "BoardProjectNotFoundError" | "CrossSiteRequestError" | "CycleBudgetResetRejectedError" | "EnginePersistenceError" | "GitHubApiError" | "GitHubRateLimitError" | "HttpBodyError" | "InstallationDiscoveryError" | "InvalidGitHubResponseError" | "InvalidRequestError" | "RosterAgentNotFoundError" | "RunInterventionRejectedError" | "RunNotFoundError" | "RunOperationRejectedError" | "SchemaError" | "TranscriptAttemptNotFoundError";
+    readonly message: string;
+}, readonly [Schema.Struct<{
+    readonly error: Schema.Literals<("AppPermissionError" | "AttemptCancellationError" | "BackendUnavailableError" | "BoardItemNotFoundError" | "BoardLaneNotFoundError" | "BoardLaneReadOnlyError" | "BoardProjectNotFoundError" | "CrossSiteRequestError" | "CycleBudgetResetRejectedError" | "EnginePersistenceError" | "GitHubApiError" | "GitHubRateLimitError" | "HttpBodyError" | "InstallationDiscoveryError" | "InvalidGitHubResponseError" | "InvalidRequestError" | "RosterAgentNotFoundError" | "RunInterventionRejectedError" | "RunNotFoundError" | "RunOperationRejectedError" | "SchemaError" | "TranscriptAttemptNotFoundError")[]>;
+    readonly message: Schema.String;
+}>], {
+    readonly error: "AppPermissionError" | "AttemptCancellationError" | "BackendUnavailableError" | "BoardItemNotFoundError" | "BoardLaneNotFoundError" | "BoardLaneReadOnlyError" | "BoardProjectNotFoundError" | "CrossSiteRequestError" | "CycleBudgetResetRejectedError" | "EnginePersistenceError" | "GitHubApiError" | "GitHubRateLimitError" | "HttpBodyError" | "InstallationDiscoveryError" | "InvalidGitHubResponseError" | "InvalidRequestError" | "RosterAgentNotFoundError" | "RunInterventionRejectedError" | "RunNotFoundError" | "RunOperationRejectedError" | "SchemaError" | "TranscriptAttemptNotFoundError";
+    readonly message: string;
+}>, Schema.Struct<{
+    readonly error: Schema.Literals<("AppPermissionError" | "AttemptCancellationError" | "BackendUnavailableError" | "BoardItemNotFoundError" | "BoardLaneNotFoundError" | "BoardLaneReadOnlyError" | "BoardProjectNotFoundError" | "CrossSiteRequestError" | "CycleBudgetResetRejectedError" | "EnginePersistenceError" | "GitHubApiError" | "GitHubRateLimitError" | "HttpBodyError" | "InstallationDiscoveryError" | "InvalidGitHubResponseError" | "InvalidRequestError" | "RosterAgentNotFoundError" | "RunInterventionRejectedError" | "RunNotFoundError" | "RunOperationRejectedError" | "SchemaError" | "TranscriptAttemptNotFoundError")[]>;
+    readonly message: Schema.String;
+}>, never, never>[], never>>;
+/**
+ * Server policy for the operator transport: refuse cross-site origins before
+ * decoding or executing requests, and translate failures into operator envelopes.
+ * A server must supply this middleware; generated clients need no middleware layer.
+ */
+export declare class OperatorHttpPolicy extends OperatorHttpPolicy_base {
+}
+/**
+ * The operator's HTTP reads and interventions. Server handlers and generated
+ * clients derive URLs, request codecs, successful responses, and typed failures
+ * from this contract. Action acknowledgement means the request was accepted;
+ * subsequent observation reports execution and GitHub polling progress.
+ *
+ * This capability is platform-free (ADRs 0012 and 0020). Library consumers can
+ * continue using Operator directly without an HTTP server or client.
+ */
+export declare const OperatorApi: HttpApi.HttpApi<"OperatorApi", HttpApiGroup.HttpApiGroup<"operator", HttpApiEndpoint.HttpApiEndpoint<"agents", "GET", "/api/agents", never, never, never, never, Schema.toCodecJson<Schema.$Array<Schema.brand<Schema.String, "AgentName">>>, never, OperatorHttpPolicy, never> | HttpApiEndpoint.HttpApiEndpoint<"detail", "GET", "/api/runs/:runId", Schema.toCodecStringTree<Schema.Struct<{
+    runId: Schema.brand<Schema.NonEmptyString, "RunId">;
+}>>, Schema.toCodecStringTree<Schema.Union<readonly [Schema.decodeTo<Schema.toType<typeof ColdTranscriptRequest>, Schema.Struct<{
+    readonly after: Schema.optionalKey<Schema.Never>;
+    readonly before: Schema.optionalKey<Schema.Never>;
+    readonly attempt: Schema.optionalKey<Schema.Never>;
+}>, never, never>, Schema.decodeTo<Schema.toType<typeof TailTranscriptRequest>, Schema.Struct<{
+    readonly after: Schema.compose<Schema.brand<Schema.Int, "TranscriptSequence">, Schema.compose<Schema.FiniteFromString, Schema.Union<readonly [Schema.String, Schema.decodeTo<Schema.String, Schema.NonEmptyArray<Schema.String>, never, never>]>>>;
+    readonly before: Schema.optionalKey<Schema.Never>;
+    readonly attempt: Schema.optionalKey<Schema.Never>;
+}>, never, never>, Schema.decodeTo<Schema.toType<typeof EarlierTranscriptRequest>, Schema.Struct<{
+    readonly after: Schema.optionalKey<Schema.Never>;
+    readonly before: Schema.compose<Schema.brand<Schema.Int, "TranscriptSequence">, Schema.compose<Schema.FiniteFromString, Schema.Union<readonly [Schema.String, Schema.decodeTo<Schema.String, Schema.NonEmptyArray<Schema.String>, never, never>]>>>;
+    readonly attempt: Schema.compose<Schema.brand<Schema.NonEmptyString, "AttemptId">, Schema.Union<readonly [Schema.String, Schema.decodeTo<Schema.String, Schema.NonEmptyArray<Schema.String>, never, never>]>>;
+}>, never, never>]>>, never, never, Schema.toCodecJson<typeof RunDetailView>, never, OperatorHttpPolicy, never> | HttpApiEndpoint.HttpApiEndpoint<"overview", "GET", "/api/overview", never, never, never, never, Schema.toCodecJson<Schema.Union<readonly [typeof import("./overview.ts").ReadyOverview, typeof import("./overview.ts").NeedsSetupOverview]>>, never, OperatorHttpPolicy, never> | HttpApiEndpoint.HttpApiEndpoint<"approve", "POST", "/api/runs/:runId/approve", Schema.toCodecStringTree<Schema.Struct<{
+    runId: Schema.brand<Schema.NonEmptyString, "RunId">;
+}>>, never, never, never, Schema.toCodecJson<Schema.Struct<{
+    readonly ok: Schema.Literal<true>;
+}>>, never, OperatorHttpPolicy, never> | HttpApiEndpoint.HttpApiEndpoint<"cancel", "POST", "/api/runs/:runId/cancel", Schema.toCodecStringTree<Schema.Struct<{
+    runId: Schema.brand<Schema.NonEmptyString, "RunId">;
+}>>, never, never, never, Schema.toCodecJson<Schema.Struct<{
+    readonly ok: Schema.Literal<true>;
+}>>, never, OperatorHttpPolicy, never> | HttpApiEndpoint.HttpApiEndpoint<"pause", "POST", "/api/loops/:loop/pause", Schema.toCodecStringTree<Schema.Struct<{
+    loop: Schema.brand<Schema.NonEmptyString, "LoopName">;
+}>>, never, never, never, Schema.toCodecJson<Schema.Struct<{
+    readonly ok: Schema.Literal<true>;
+}>>, never, OperatorHttpPolicy, never> | HttpApiEndpoint.HttpApiEndpoint<"retry", "POST", "/api/runs/:runId/retry", Schema.toCodecStringTree<Schema.Struct<{
+    runId: Schema.brand<Schema.NonEmptyString, "RunId">;
+}>>, never, never, never, Schema.toCodecJson<Schema.Struct<{
+    readonly ok: Schema.Literal<true>;
+}>>, never, OperatorHttpPolicy, never> | HttpApiEndpoint.HttpApiEndpoint<"unpause", "POST", "/api/loops/:loop/unpause", Schema.toCodecStringTree<Schema.Struct<{
+    loop: Schema.brand<Schema.NonEmptyString, "LoopName">;
+}>>, never, never, never, Schema.toCodecJson<Schema.Struct<{
+    readonly ok: Schema.Literal<true>;
+}>>, never, OperatorHttpPolicy, never> | HttpApiEndpoint.HttpApiEndpoint<"resetCycleBudget", "POST", "/api/cycle-budgets/reset", never, never, Schema.toCodecJson<Schema.Struct<{
+    readonly askId: Schema.brand<Schema.brand<Schema.NonEmptyString, "EventId">, "CycleBudgetAskId">;
+}>>, never, Schema.toCodecJson<Schema.Struct<{
+    readonly ok: Schema.Literal<true>;
+}>>, never, OperatorHttpPolicy, never> | HttpApiEndpoint.HttpApiEndpoint<"moveBoardItem", "POST", "/api/projects/:owner/:repository/items/:item/lane", Schema.toCodecStringTree<Schema.Struct<{
+    owner: Schema.String;
+    repository: Schema.String;
+    item: Schema.compose<Schema.brand<Schema.Int, "ItemNumber">, Schema.FiniteFromString>;
+}>>, never, Schema.toCodecJson<Schema.Struct<{
+    readonly toLane: Schema.brand<Schema.NonEmptyString, "BoardLaneId">;
+}>>, never, Schema.toCodecJson<Schema.Struct<{
+    readonly ok: Schema.Literal<true>;
+}>>, never, OperatorHttpPolicy, never> | HttpApiEndpoint.HttpApiEndpoint<"editAndRetry", "POST", "/api/runs/:runId/edit-and-retry", Schema.toCodecStringTree<Schema.Struct<{
+    runId: Schema.brand<Schema.NonEmptyString, "RunId">;
+}>>, never, Schema.toCodecJson<Schema.decodeTo<Schema.declareConstructor<EditAndRetry, {
+    readonly task: string;
+    readonly agent: string;
+}, readonly [Schema.Struct<{
+    readonly task: Schema.brand<Schema.String, "AttemptTask">;
+    readonly agent: Schema.brand<Schema.String, "AgentName">;
+}>], {
+    readonly task: string & import("effect/Brand").Brand<"AttemptTask">;
+    readonly agent: string & import("effect/Brand").Brand<"AgentName">;
+}>, Schema.Struct<{
+    readonly task: Schema.brand<Schema.String, "AttemptTask">;
+    readonly agent: Schema.brand<Schema.String, "AgentName">;
+}>, never, never>>, never, Schema.toCodecJson<Schema.Struct<{
+    readonly ok: Schema.Literal<true>;
+}>>, never, OperatorHttpPolicy, never> | HttpApiEndpoint.HttpApiEndpoint<"intervene", "POST", "/api/runs/:runId/intervene", Schema.toCodecStringTree<Schema.Struct<{
+    runId: Schema.brand<Schema.NonEmptyString, "RunId">;
+}>>, never, Schema.toCodecJson<Schema.decodeTo<Schema.declareConstructor<SessionIntervention, {
+    readonly attemptId: string;
+    readonly target?: {
+        readonly _tag: "Parent";
+    } | {
+        readonly _tag: "Child";
+        readonly sessionId: string;
+    };
+    readonly action: {
+        readonly _tag: "Steer";
+        readonly message: string;
+    } | {
+        readonly _tag: "Interrupt";
+    } | {
+        readonly _tag: "OperatorMessage";
+        readonly message: string;
+    } | {
+        readonly _tag: "Release";
+    };
+}, readonly [Schema.Struct<{
+    readonly attemptId: Schema.brand<Schema.NonEmptyString, "AttemptId">;
+    readonly target: Schema.withDecodingDefaultKey<Schema.Union<readonly [typeof import("@usine/core/attempt/channel").ParentTarget, typeof import("@usine/core/attempt/channel").ChildTarget]>, never>;
+    readonly action: Schema.Union<readonly [typeof import("@usine/core/attempt/channel").Steer, typeof import("@usine/core/attempt/channel").Interrupt, typeof import("@usine/core/attempt/channel").OperatorMessage, typeof import("@usine/core/attempt/channel").Release]>;
+}>], {
+    readonly attemptId: string & import("effect/Brand").Brand<"AttemptId">;
+    readonly target: {
+        readonly _tag: "Parent";
+    } | {
+        readonly _tag: "Child";
+        readonly sessionId: string & import("effect/Brand").Brand<"AgentSessionId">;
+    };
+    readonly action: {
+        readonly _tag: "Steer";
+        readonly message: string;
+    } | {
+        readonly _tag: "Interrupt";
+    } | {
+        readonly _tag: "OperatorMessage";
+        readonly message: string;
+    } | {
+        readonly _tag: "Release";
+    };
+}>, Schema.Struct<{
+    readonly attemptId: Schema.brand<Schema.NonEmptyString, "AttemptId">;
+    readonly target: Schema.withDecodingDefaultKey<Schema.Union<readonly [typeof import("@usine/core/attempt/channel").ParentTarget, typeof import("@usine/core/attempt/channel").ChildTarget]>, never>;
+    readonly action: Schema.Union<readonly [typeof import("@usine/core/attempt/channel").Steer, typeof import("@usine/core/attempt/channel").Interrupt, typeof import("@usine/core/attempt/channel").OperatorMessage, typeof import("@usine/core/attempt/channel").Release]>;
+}>, never, never>>, never, Schema.toCodecJson<Schema.Struct<{
+    readonly ok: Schema.Literal<true>;
+}>>, never, OperatorHttpPolicy, never>, false>>;
+export {};
+//# sourceMappingURL=http.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/operator/http.ts"],"names":[],"mappings":"AAOA,OAAO,EAAU,MAAM,EAAwB,MAAM,QAAQ,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEpG,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,qBAAqB,EACtB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;;;;;AA2B5E;;;;GAIG;AACH,qBAAa,iBAAkB,SAAQ,sBAE0C;IAC/E,wEAAwE;IACxE,IAAI,MAAM,4CAET;CACF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAUD;;;;GAIG;AACH,qBAAa,kBAAmB,SAAQ,uBAGvC;CAAG;AAkEJ;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+CA2DvB,CAAC"}

package/dist/operator/http.js

@@ -0,0 +1,150 @@
+import { AttemptId } from "@usine/core/attempt";
+import { AgentName } from "@usine/core/agent";
+import { CycleBudgetAskId } from "@usine/core/cycle-budget";
+import { ItemNumber } from "@usine/core/item";
+import { LoopName } from "@usine/core/loop";
+import { RunId } from "@usine/core/run";
+import { TranscriptSequence } from "@usine/engine/transcript";
+import { Record, Schema, SchemaTransformation } from "effect";
+import { HttpApi, HttpApiEndpoint, HttpApiGroup, HttpApiMiddleware } from "effect/unstable/httpapi";
+import { BoardLaneId } from "./board.js";
+import { ColdTranscriptRequest, EarlierTranscriptRequest, TailTranscriptRequest, } from "./transcript.js";
+import { FactoryOverview } from "./overview.js";
+import { RunDetailView, EditAndRetry, SessionIntervention } from "./run.js";
+const errorStatuses = {
+    SchemaError: 400,
+    InvalidRequestError: 400,
+    CrossSiteRequestError: 403,
+    RunNotFoundError: 404,
+    TranscriptAttemptNotFoundError: 404,
+    BoardProjectNotFoundError: 404,
+    BoardItemNotFoundError: 404,
+    BoardLaneNotFoundError: 404,
+    RunOperationRejectedError: 409,
+    RunInterventionRejectedError: 409,
+    RosterAgentNotFoundError: 404,
+    CycleBudgetResetRejectedError: 409,
+    BoardLaneReadOnlyError: 409,
+    EnginePersistenceError: 500,
+    AttemptCancellationError: 500,
+    HttpBodyError: 500,
+    GitHubApiError: 502,
+    InvalidGitHubResponseError: 502,
+    BackendUnavailableError: 503,
+    InstallationDiscoveryError: 503,
+    AppPermissionError: 503,
+    GitHubRateLimitError: 503,
+};
+/**
+ * An operator request that could not be fulfilled. `error` preserves the domain
+ * failure's identity and `message` is safe to show to the operator; persistence
+ * details, credentials, and defect causes never travel in this envelope.
+ */
+export class OperatorHttpError extends Schema.Error("@usine/orchestrator/OperatorHttpError")({ error: Schema.Literals(Record.keys(errorStatuses)), message: Schema.String }) {
+    /** The existing HTTP status associated with this refusal or failure. */
+    get status() {
+        return errorStatuses[this.error];
+    }
+}
+// The established envelope uses `error` as its discriminator. Schema.Error keeps
+// that wire shape while giving browser callers an Error with a validated identity.
+const errors = [...new Set(Object.values(errorStatuses))].map((status) => OperatorHttpError.check(Schema.makeFilter((error) => error.status === status)).annotate({
+    httpApiStatus: status,
+}));
+/**
+ * Server policy for the operator transport: refuse cross-site origins before
+ * decoding or executing requests, and translate failures into operator envelopes.
+ * A server must supply this middleware; generated clients need no middleware layer.
+ */
+export class OperatorHttpPolicy extends HttpApiMiddleware.Service()("@usine/orchestrator/OperatorHttpPolicy", { error: errors }) {
+}
+const absent = Schema.optionalKey(Schema.Never);
+// URLSearchParams.get previously selected the first occurrence of a query key.
+// Preserve that convention when HttpApi supplies repeated keys as arrays.
+const queryValue = Schema.Union([
+    Schema.String,
+    Schema.NonEmptyArray(Schema.String).pipe(Schema.decodeTo(Schema.String, SchemaTransformation.transform({
+        decode: (values) => values[0],
+        encode: (value) => [value],
+    }))),
+]);
+const sequence = queryValue.pipe(Schema.decodeTo(Schema.FiniteFromString), Schema.decodeTo(TranscriptSequence));
+// Each wire variant rules out the other cursors before decoding into the existing
+// domain request. Unknown search keys remain ignored, as in the original API.
+const transcriptQuery = Schema.Union([
+    Schema.Struct({ after: absent, before: absent, attempt: absent }).pipe(Schema.decodeTo(Schema.toType(ColdTranscriptRequest), SchemaTransformation.transform({
+        decode: () => new ColdTranscriptRequest(),
+        encode: () => ({}),
+    }))),
+    Schema.Struct({ after: sequence, before: absent, attempt: absent }).pipe(Schema.decodeTo(Schema.toType(TailTranscriptRequest), SchemaTransformation.transform({
+        decode: ({ after }) => new TailTranscriptRequest({ after }),
+        encode: ({ after }) => ({ after }),
+    }))),
+    Schema.Struct({
+        after: absent,
+        before: sequence,
+        attempt: queryValue.pipe(Schema.decodeTo(AttemptId)),
+    }).pipe(Schema.decodeTo(Schema.toType(EarlierTranscriptRequest), SchemaTransformation.transform({
+        decode: ({ before, attempt }) => new EarlierTranscriptRequest({ before, attemptId: attempt }),
+        encode: ({ before, attemptId }) => ({ before, attempt: attemptId }),
+    }))),
+]);
+const repositoryPart = Schema.String.check(Schema.isPattern(/^[A-Za-z0-9_.-]+$/u, { message: "Expected a repository path segment" }));
+const acknowledged = Schema.Struct({ ok: Schema.Literal(true) });
+const runParams = { runId: RunId };
+const loopParams = { loop: LoopName };
+/**
+ * The operator's HTTP reads and interventions. Server handlers and generated
+ * clients derive URLs, request codecs, successful responses, and typed failures
+ * from this contract. Action acknowledgement means the request was accepted;
+ * subsequent observation reports execution and GitHub polling progress.
+ *
+ * This capability is platform-free (ADRs 0012 and 0020). Library consumers can
+ * continue using Operator directly without an HTTP server or client.
+ */
+export const OperatorApi = HttpApi.make("OperatorApi").add(HttpApiGroup.make("operator")
+    .add(HttpApiEndpoint.get("overview", "/api/overview", { success: FactoryOverview }), HttpApiEndpoint.get("agents", "/api/agents", { success: Schema.Array(AgentName) }), HttpApiEndpoint.post("editAndRetry", "/api/runs/:runId/edit-and-retry", {
+    params: runParams,
+    payload: EditAndRetry.annotate({ parseOptions: { onExcessProperty: "error" } }),
+    success: acknowledged,
+}), HttpApiEndpoint.post("intervene", "/api/runs/:runId/intervene", {
+    params: runParams,
+    payload: SessionIntervention.annotate({ parseOptions: { onExcessProperty: "error" } }),
+    success: acknowledged,
+}), HttpApiEndpoint.post("resetCycleBudget", "/api/cycle-budgets/reset", {
+    payload: Schema.Struct({ askId: CycleBudgetAskId }).annotate({
+        parseOptions: { onExcessProperty: "error" },
+    }),
+    success: acknowledged,
+}), HttpApiEndpoint.get("detail", "/api/runs/:runId", {
+    params: runParams,
+    query: transcriptQuery,
+    success: RunDetailView,
+}), HttpApiEndpoint.post("approve", "/api/runs/:runId/approve", {
+    params: runParams,
+    success: acknowledged,
+}), HttpApiEndpoint.post("retry", "/api/runs/:runId/retry", {
+    params: runParams,
+    success: acknowledged,
+}), HttpApiEndpoint.post("cancel", "/api/runs/:runId/cancel", {
+    params: runParams,
+    success: acknowledged,
+}), HttpApiEndpoint.post("moveBoardItem", "/api/projects/:owner/:repository/items/:item/lane", {
+    params: {
+        owner: repositoryPart,
+        repository: repositoryPart,
+        item: Schema.FiniteFromString.pipe(Schema.decodeTo(ItemNumber)),
+    },
+    payload: Schema.Struct({ toLane: BoardLaneId }).annotate({
+        parseOptions: { onExcessProperty: "error" },
+    }),
+    success: acknowledged,
+}), HttpApiEndpoint.post("pause", "/api/loops/:loop/pause", {
+    params: loopParams,
+    success: acknowledged,
+}), HttpApiEndpoint.post("unpause", "/api/loops/:loop/unpause", {
+    params: loopParams,
+    success: acknowledged,
+}))
+    .middleware(OperatorHttpPolicy));
+//# sourceMappingURL=http.js.map

package/dist/operator/http.js.map

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