@usine/orchestrator 0.3.0 → 0.4.0

package/dist/operator/statistics/view.d.ts

@@ -0,0 +1,302 @@
+import { BrainSpec } from "@usine/core/agent/brain";
+import { Schema } from "effect";
+/** The span the statistics cover: today and the 6 or 29 UTC days before it, or every stored Run. */
+export declare const StatisticsWindow: Schema.Literals<readonly ["7d", "30d", "all"]>;
+export type StatisticsWindow = typeof StatisticsWindow.Type;
+/** The length of the periods in a time series: a UTC day, or a UTC week from Monday. */
+export declare const StatisticsBucket: Schema.Literals<readonly ["day", "week"]>;
+export type StatisticsBucket = typeof StatisticsBucket.Type;
+declare const TaskDoneView_base: Schema.Class<TaskDoneView, Schema.Struct<{
+    readonly repository: Schema.brand<Schema.String, "RepositoryName">;
+    /** The task's first issue, or its first pull request if it has no issue. */
+    readonly number: Schema.brand<Schema.Int, "ItemNumber">;
+    readonly mergedAt: Schema.String;
+    readonly durationMillis: Schema.Int;
+}>, {}>;
+/**
+ * A task whose pull request merged in the window. `durationMillis` runs from the opening of the
+ * task's first Run to the close of its last Run, or to the merge if a Run was open at the merge or
+ * closed after it. The wait between the last Run and the merge is left out.
+ */
+export declare class TaskDoneView extends TaskDoneView_base {
+}
+declare const TaskPeriodView_base: Schema.Class<TaskPeriodView, Schema.Struct<{
+    readonly start: Schema.String;
+    readonly tasks: Schema.Int;
+    readonly medianMillis: Schema.NullOr<Schema.Int>;
+    readonly firstTimeRight: Schema.Int;
+    readonly operatorActions: Schema.Int;
+}>, {}>;
+/** The tasks done in one period. `medianMillis` is null if there are none. */
+export declare class TaskPeriodView extends TaskPeriodView_base {
+}
+declare const LoopShareView_base: Schema.Class<LoopShareView, Schema.Struct<{
+    readonly loop: Schema.brand<Schema.NonEmptyString, "LoopName">;
+    readonly share: Schema.Finite;
+}>, {}>;
+/** A Loop's share of the measured tasks' time or tokens, averaged over the tasks. */
+export declare class LoopShareView extends LoopShareView_base {
+}
+declare const LoopRunTimeView_base: Schema.Class<LoopRunTimeView, Schema.Struct<{
+    readonly loop: Schema.brand<Schema.NonEmptyString, "LoopName">;
+    readonly runs: Schema.Int;
+    readonly medianMillis: Schema.Int;
+}>, {}>;
+/** The median wall time of a Loop's closed Runs on the measured tasks, summed over Attempts. */
+export declare class LoopRunTimeView extends LoopRunTimeView_base {
+}
+declare const TaskTimeView_base: Schema.Class<TaskTimeView, Schema.Struct<{
+    readonly tasks: Schema.Int;
+    readonly loops: Schema.$Array<typeof LoopShareView>;
+    readonly waiting: Schema.Finite;
+    readonly runs: Schema.$Array<typeof LoopRunTimeView>;
+}>, {}>;
+/**
+ * The time of the tasks done whose Attempts all have a recorded end. Each share is the part of a
+ * task's duration that the Loop's Attempts ran, or that no Attempt ran (`waiting`: approval, queue,
+ * and the time between Runs), averaged over the tasks.
+ */
+export declare class TaskTimeView extends TaskTimeView_base {
+}
+declare const TaskCostView_base: Schema.Class<TaskCostView, Schema.Struct<{
+    readonly tasks: Schema.Int;
+    readonly medianUsd: Schema.brand<Schema.Finite, "UsdAmount">;
+    readonly estimate: Schema.Boolean;
+}>, {}>;
+/**
+ * The median cost of the priced tasks: those whose sessions all have a price. `estimate` is true if
+ * a session of a priced task is in the Claude or ChatGPT plan.
+ */
+export declare class TaskCostView extends TaskCostView_base {
+}
+declare const TaskTokensView_base: Schema.Class<TaskTokensView, Schema.Struct<{
+    readonly tasks: Schema.Int;
+    readonly medianTokens: Schema.brand<Schema.Int, "TokenCount">;
+    readonly loops: Schema.$Array<typeof LoopShareView>;
+    readonly cost: Schema.NullOr<typeof TaskCostView>;
+}>, {}>;
+/**
+ * The tokens of the tasks done whose Runs with an Attempt all reported tokens, with each Loop's
+ * share. `cost` is null if no such task is priced.
+ */
+export declare class TaskTokensView extends TaskTokensView_base {
+}
+declare const UntimedTasksView_base: Schema.Class<UntimedTasksView, Schema.Struct<{
+    readonly tasks: Schema.Int;
+    readonly before: Schema.String;
+}>, {}>;
+/**
+ * The tasks done with an Attempt that ended before usine recorded end times, left out of `time`.
+ * Each such Attempt started before `before`.
+ */
+export declare class UntimedTasksView extends UntimedTasksView_base {
+}
+declare const StatisticsView_base: Schema.Class<StatisticsView, Schema.Struct<{
+    readonly window: Schema.Literals<readonly ["7d", "30d", "all"]>;
+    /** The window's start: midnight UTC of its first day. */
+    readonly from: Schema.String;
+    /** The time the statistics were computed. */
+    readonly to: Schema.String;
+    readonly bucket: Schema.Literals<readonly ["day", "week"]>;
+    /**
+     * The Loops of the window's tasks in the order they first run in a task: by mean rank, from 0
+     * for a task's first Loop to 1 for its last, then by name. `time` and `tokens` follow it.
+     */
+    readonly loops: Schema.$Array<Schema.brand<Schema.NonEmptyString, "LoopName">>;
+    /** By merge time, oldest first. */
+    readonly tasks: Schema.$Array<typeof TaskDoneView>;
+    /** The median of the tasks' `durationMillis`, or null without a task. */
+    readonly medianMillis: Schema.NullOr<Schema.Int>;
+    /** One period per bucket from `from` to `to`, oldest first. */
+    readonly periods: Schema.$Array<typeof TaskPeriodView>;
+    /** The tasks with no Loop that succeeded twice on one of their Items. */
+    readonly firstTimeRight: Schema.Int;
+    /**
+     * The approvals, operator retries, failures marked resolved, and cycle-budget resets on the
+     * tasks' Runs and Items.
+     */
+    readonly operatorActions: Schema.Int;
+    readonly time: Schema.NullOr<typeof TaskTimeView>;
+    readonly tokens: Schema.NullOr<typeof TaskTokensView>;
+    readonly untimed: Schema.NullOr<typeof UntimedTasksView>;
+    /** The tasks with a Run that has an Attempt but no token report, left out of `tokens`. */
+    readonly unmetered: Schema.Int;
+}>, {}>;
+/**
+ * The tasks done in `window`: a task is done when its pull request merges, and counts if it has a
+ * Run. Runs that a newer Event or an Item change canceled before an Attempt are left out.
+ */
+export declare class StatisticsView extends StatisticsView_base {
+}
+declare const DurationSummaryView_base: Schema.Class<DurationSummaryView, Schema.Struct<{
+    readonly count: Schema.Int;
+    readonly medianMillis: Schema.Int;
+}>, {}>;
+/** The median of at least one duration. */
+export declare class DurationSummaryView extends DurationSummaryView_base {
+}
+declare const OutcomeCountsView_base: Schema.Class<OutcomeCountsView, Schema.Struct<{
+    readonly succeeded: Schema.Int;
+    readonly failed: Schema.Int;
+    readonly canceled: Schema.Int;
+}>, {}>;
+/** Closed Runs or ended Attempts counted by outcome. */
+export declare class OutcomeCountsView extends OutcomeCountsView_base {
+}
+declare const PoolTokensView_base: Schema.Class<PoolTokensView, Schema.Struct<{
+    readonly pool: Schema.Literals<readonly ["apiKeys", "claudePlan", "chatgptPlan"]>;
+    readonly tokens: Schema.brand<Schema.Int, "TokenCount">;
+}>, {}>;
+/** The tokens used in one billing pool. */
+export declare class PoolTokensView extends PoolTokensView_base {
+}
+declare const CostSummaryView_base: Schema.Class<CostSummaryView, Schema.Struct<{
+    readonly usd: Schema.brand<Schema.Finite, "UsdAmount">;
+    readonly meanUsd: Schema.brand<Schema.Finite, "UsdAmount">;
+    readonly estimate: Schema.Boolean;
+    readonly priced: Schema.Int;
+}>, {}>;
+/**
+ * The cost of the priced Runs or Attempts: those with a price for each session. `estimate` is true
+ * if a priced session is in the Claude or ChatGPT plan.
+ */
+export declare class CostSummaryView extends CostSummaryView_base {
+}
+declare const UsageSummaryView_base: Schema.Class<UsageSummaryView, Schema.Struct<{
+    readonly measured: Schema.Int;
+    readonly tokens: Schema.brand<Schema.Int, "TokenCount">;
+    readonly meanTokens: Schema.NullOr<Schema.brand<Schema.Int, "TokenCount">>;
+    /** In the order API keys, Claude plan, ChatGPT plan; unused pools are absent. */
+    readonly pools: Schema.$Array<typeof PoolTokensView>;
+    readonly cost: Schema.NullOr<typeof CostSummaryView>;
+}>, {}>;
+/**
+ * The tokens and cost of the Runs or Attempts with at least one Attempt. `meanTokens` is null if
+ * none has one, and `cost` is null if none is priced.
+ */
+export declare class UsageSummaryView extends UsageSummaryView_base {
+}
+declare const LoopStatisticsView_base: Schema.Class<LoopStatisticsView, Schema.Struct<{
+    readonly outcomes: typeof OutcomeCountsView;
+    readonly time: Schema.NullOr<typeof DurationSummaryView>;
+    readonly usage: typeof UsageSummaryView;
+    readonly loop: Schema.brand<Schema.NonEmptyString, "LoopName">;
+}>, {}>;
+/** The closed Runs of one Loop. */
+export declare class LoopStatisticsView extends LoopStatisticsView_base {
+}
+declare const AgentStatisticsView_base: Schema.Class<AgentStatisticsView, Schema.Struct<{
+    readonly outcomes: typeof OutcomeCountsView;
+    readonly time: Schema.NullOr<typeof DurationSummaryView>;
+    readonly usage: typeof UsageSummaryView;
+    readonly agent: Schema.brand<Schema.String, "AgentName">;
+}>, {}>;
+/** The closed Runs whose effective Agent is `agent`. */
+export declare class AgentStatisticsView extends AgentStatisticsView_base {
+}
+declare const BrainStatisticsView_base: Schema.Class<BrainStatisticsView, Schema.Struct<{
+    readonly outcomes: typeof OutcomeCountsView;
+    readonly time: Schema.NullOr<typeof DurationSummaryView>;
+    readonly usage: typeof UsageSummaryView;
+    readonly brain: typeof BrainSpec;
+}>, {}>;
+/** The ended Attempts of closed Runs that ran with one harness, model, and effort. */
+export declare class BrainStatisticsView extends BrainStatisticsView_base {
+}
+declare const ThroughputPeriodView_base: Schema.Class<ThroughputPeriodView, Schema.Struct<{
+    readonly succeeded: Schema.Int;
+    readonly failed: Schema.Int;
+    readonly canceled: Schema.Int;
+    readonly start: Schema.String;
+}>, {}>;
+/** The Runs that closed in one period, by outcome. */
+export declare class ThroughputPeriodView extends ThroughputPeriodView_base {
+}
+declare const WorkerQueueWaitView_base: Schema.Class<WorkerQueueWaitView, Schema.Struct<{
+    readonly worker: Schema.brand<Schema.String, "WorkerName">;
+    readonly wait: typeof DurationSummaryView;
+}>, {}>;
+/** The time from a Run's opening, or its approval, to its first Attempt's start on `worker`. */
+export declare class WorkerQueueWaitView extends WorkerQueueWaitView_base {
+}
+declare const AttemptCountView_base: Schema.Class<AttemptCountView, Schema.Struct<{
+    readonly attempts: Schema.Int;
+    readonly runs: Schema.Int;
+}>, {}>;
+/** The number of closed Runs that took `attempts` Attempts. */
+export declare class AttemptCountView extends AttemptCountView_base {
+}
+declare const WorkerUtilizationView_base: Schema.Class<WorkerUtilizationView, Schema.Struct<{
+    readonly worker: Schema.brand<Schema.String, "WorkerName">;
+    readonly slots: Schema.Int;
+    readonly occupiedMillis: Schema.Int;
+    readonly share: Schema.Finite;
+}>, {}>;
+/**
+ * The time a declared Worker's slots held Attempts in the window, as a share of `slots` times the
+ * window's length.
+ */
+export declare class WorkerUtilizationView extends WorkerUtilizationView_base {
+}
+declare const NeedsAttentionPeriodView_base: Schema.Class<NeedsAttentionPeriodView, Schema.Struct<{
+    readonly start: Schema.String;
+    readonly approvals: Schema.Int;
+    readonly failures: Schema.Int;
+}>, {}>;
+/** The Needs attention entries raised in one period. */
+export declare class NeedsAttentionPeriodView extends NeedsAttentionPeriodView_base {
+}
+declare const NeedsAttentionView_base: Schema.Class<NeedsAttentionView, Schema.Struct<{
+    readonly approvals: Schema.Int;
+    readonly failures: Schema.Int;
+    readonly periods: Schema.$Array<typeof NeedsAttentionPeriodView>;
+    readonly approvalWait: Schema.NullOr<typeof DurationSummaryView>;
+    readonly retryWait: Schema.NullOr<typeof DurationSummaryView>;
+    readonly resolutionWait: Schema.NullOr<typeof DurationSummaryView>;
+    readonly failureWait: Schema.NullOr<typeof DurationSummaryView>;
+}>, {}>;
+/**
+ * The approvals asked for and the failed Attempts that no automatic retry followed, with their
+ * waits: from a run's opening to its approval, and from a failure to its first recorded operator
+ * answer (retry or resolution). Each answered failure contributes once to `failureWait` and to
+ * either `retryWait` or `resolutionWait`. Older resolutions without a timestamp are excluded.
+ */
+export declare class NeedsAttentionView extends NeedsAttentionView_base {
+}
+declare const RunStatisticsView_base: Schema.Class<RunStatisticsView, Schema.Struct<{
+    readonly window: Schema.Literals<readonly ["7d", "30d", "all"]>;
+    /** The window's start: midnight UTC of its first day. */
+    readonly from: Schema.String;
+    /** The time the statistics were computed. */
+    readonly to: Schema.String;
+    readonly bucket: Schema.Literals<readonly ["day", "week"]>;
+    readonly runs: typeof OutcomeCountsView;
+    /** From each closed Run's opening to its close. */
+    readonly runTime: Schema.NullOr<typeof DurationSummaryView>;
+    /** From each ended Attempt's start to its recorded end. */
+    readonly attemptTime: Schema.NullOr<typeof DurationSummaryView>;
+    /** The ended Attempts closed before end times were recorded, left out of `attemptTime`. */
+    readonly unmeasuredAttempts: Schema.Int;
+    /** One period per bucket from `from` to `to`, oldest first. */
+    readonly throughput: Schema.$Array<typeof ThroughputPeriodView>;
+    /** By closed Run count, highest first. */
+    readonly loops: Schema.$Array<typeof LoopStatisticsView>;
+    readonly agents: Schema.$Array<typeof AgentStatisticsView>;
+    readonly brains: Schema.$Array<typeof BrainStatisticsView>;
+    /** For Runs whose first Attempt started in the window, by Worker name. */
+    readonly queueWait: Schema.$Array<typeof WorkerQueueWaitView>;
+    /** From one Attempt to the most any closed Run took, each count present. */
+    readonly attemptsPerRun: Schema.$Array<typeof AttemptCountView>;
+    /** For the Workers that `usine.yaml` declares, in declaration order. */
+    readonly utilization: Schema.$Array<typeof WorkerUtilizationView>;
+    readonly needsAttention: typeof NeedsAttentionView;
+}>, {}>;
+/**
+ * How the Runs went in `window`: closed Runs by outcome, Loop, Agent, and brain, with their time,
+ * tokens, and cost, and the Worker, retry, and Needs attention measures. Runs that a newer Event or
+ * an Item change canceled before an Attempt are left out.
+ */
+export declare class RunStatisticsView extends RunStatisticsView_base {
+}
+export {};
+//# sourceMappingURL=view.d.ts.map

package/dist/operator/statistics/view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view.d.ts","sourceRoot":"","sources":["../../../src/operator/statistics/view.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAMpD,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAWhC,oGAAoG;AACpG,eAAO,MAAM,gBAAgB,gDAAwC,CAAC;AACtE,MAAM,MAAM,gBAAgB,GAAG,OAAO,gBAAgB,CAAC,IAAI,CAAC;AAE5D,wFAAwF;AACxF,eAAO,MAAM,gBAAgB,2CAAmC,CAAC;AACjE,MAAM,MAAM,gBAAgB,GAAG,OAAO,gBAAgB,CAAC,IAAI,CAAC;;;IAS1D,4EAA4E;;;;;AAP9E;;;;GAIG;AACH,qBAAa,YAAa,SAAQ,iBAMhC;CAAG;;;;;;;;AAEL,8EAA8E;AAC9E,qBAAa,cAAe,SAAQ,mBAQlC;CAAG;;;;;AAEL,qFAAqF;AACrF,qBAAa,aAAc,SAAQ,kBAElC;CAAG;;;;;;AAEJ,gGAAgG;AAChG,qBAAa,eAAgB,SAAQ,oBAEiC;CAAG;;;;;;;AAEzE;;;;GAIG;AACH,qBAAa,YAAa,SAAQ,iBAKhC;CAAG;;;;;;AAEL;;;GAGG;AACH,qBAAa,YAAa,SAAQ,iBAIhC;CAAG;;;;;;;AAEL;;;GAGG;AACH,qBAAa,cAAe,SAAQ,mBAOlC;CAAG;;;;;AAEL;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,qBAEK;CAAG;;;IAU5C,yDAAyD;;IAEzD,6CAA6C;;;IAG7C;;;OAGG;;IAEH,mCAAmC;;IAEnC,yEAAyE;;IAEzE,+DAA+D;;IAE/D,yEAAyE;;IAEzE;;;OAGG;;;;;IAKH,0FAA0F;;;AAlC5F;;;GAGG;AACH,qBAAa,cAAe,SAAQ,mBAgClC;CAAG;;;;;AAEL,2CAA2C;AAC3C,qBAAa,mBAAoB,SAAQ,wBAEc;CAAG;;;;;;AAE1D,wDAAwD;AACxD,qBAAa,iBAAkB,SAAQ,sBAEgB;CAAG;;;;;AAE1D,2CAA2C;AAC3C,qBAAa,cAAe,SAAQ,mBAEQ;CAAG;;;;;;;AAE/C;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,oBAOnC;CAAG;;;;;IAYH,iFAAiF;;;;AAVnF;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,qBASpC;CAAG;;;;;;;AASL,mCAAmC;AACnC,qBAAa,kBAAmB,SAAQ,uBAEH;CAAG;;;;;;;AAExC,wDAAwD;AACxD,qBAAa,mBAAoB,SAAQ,wBAEF;CAAG;;;;;;;AAE1C,sFAAsF;AACtF,qBAAa,mBAAoB,SAAQ,wBAEF;CAAG;;;;;;;AAE1C,sDAAsD;AACtD,qBAAa,oBAAqB,SAAQ,yBAEO;CAAG;;;;;AAEpD,gGAAgG;AAChG,qBAAa,mBAAoB,SAAQ,wBAEW;CAAG;;;;;AAEvD,+DAA+D;AAC/D,qBAAa,gBAAiB,SAAQ,qBAEK;CAAG;;;;;;;AAE9C;;;GAGG;AACH,qBAAa,qBAAsB,SAAQ,0BAOzC;CAAG;;;;;;AAEL,wDAAwD;AACxD,qBAAa,wBAAyB,SAAQ,6BAES;CAAG;;;;;;;;;;AAE1D;;;;;GAKG;AACH,qBAAa,kBAAmB,SAAQ,uBAUtC;CAAG;;;IAWH,yDAAyD;;IAEzD,6CAA6C;;;;IAI7C,mDAAmD;;IAEnD,2DAA2D;;IAE3D,2FAA2F;;IAE3F,+DAA+D;;IAE/D,0CAA0C;;;;IAI1C,0EAA0E;;IAE1E,4EAA4E;;IAE5E,wEAAwE;;;;AA/B1E;;;;GAIG;AACH,qBAAa,iBAAkB,SAAQ,sBA6BrC;CAAG"}

package/dist/operator/statistics/view.js

@@ -0,0 +1,243 @@
+import { AgentName } from "@usine/core/agent";
+import { BrainSpec } from "@usine/core/agent/brain";
+import { BillingPool, TokenCount, UsdAmount } from "@usine/core/agent/session";
+import { ItemNumber } from "@usine/core/item";
+import { LoopName } from "@usine/core/loop";
+import { RepositoryName } from "@usine/core/repository";
+import { WorkerName } from "@usine/core/worker";
+import { Schema } from "effect";
+const Count = Schema.Int.check(Schema.isGreaterThanOrEqualTo(0));
+const PositiveCount = Schema.Int.check(Schema.isGreaterThanOrEqualTo(1));
+const Milliseconds = Schema.Int.check(Schema.isGreaterThanOrEqualTo(0));
+const Share = Schema.Finite.check(Schema.isBetween({ minimum: 0, maximum: 1 }));
+/** A UTC calendar day, such as `2026-10-25`. */
+const UtcDay = Schema.String.check(Schema.isPattern(/^\d{4}-\d{2}-\d{2}$/u, { message: "Expected a UTC day as YYYY-MM-DD" }));
+/** The span the statistics cover: today and the 6 or 29 UTC days before it, or every stored Run. */
+export const StatisticsWindow = Schema.Literals(["7d", "30d", "all"]);
+/** The length of the periods in a time series: a UTC day, or a UTC week from Monday. */
+export const StatisticsBucket = Schema.Literals(["day", "week"]);
+/**
+ * A task whose pull request merged in the window. `durationMillis` runs from the opening of the
+ * task's first Run to the close of its last Run, or to the merge if a Run was open at the merge or
+ * closed after it. The wait between the last Run and the merge is left out.
+ */
+export class TaskDoneView extends Schema.Class("@usine/orchestrator/TaskDoneView")({
+    repository: RepositoryName,
+    /** The task's first issue, or its first pull request if it has no issue. */
+    number: ItemNumber,
+    mergedAt: Schema.String,
+    durationMillis: Milliseconds,
+}) {
+}
+/** The tasks done in one period. `medianMillis` is null if there are none. */
+export class TaskPeriodView extends Schema.Class("@usine/orchestrator/TaskPeriodView")({
+    start: UtcDay,
+    tasks: Count,
+    medianMillis: Schema.NullOr(Milliseconds),
+    firstTimeRight: Count,
+    operatorActions: Count,
+}) {
+}
+/** A Loop's share of the measured tasks' time or tokens, averaged over the tasks. */
+export class LoopShareView extends Schema.Class("@usine/orchestrator/LoopShareView")({ loop: LoopName, share: Share }) {
+}
+/** The median wall time of a Loop's closed Runs on the measured tasks, summed over Attempts. */
+export class LoopRunTimeView extends Schema.Class("@usine/orchestrator/LoopRunTimeView")({ loop: LoopName, runs: PositiveCount, medianMillis: Milliseconds }) {
+}
+/**
+ * The time of the tasks done whose Attempts all have a recorded end. Each share is the part of a
+ * task's duration that the Loop's Attempts ran, or that no Attempt ran (`waiting`: approval, queue,
+ * and the time between Runs), averaged over the tasks.
+ */
+export class TaskTimeView extends Schema.Class("@usine/orchestrator/TaskTimeView")({
+    tasks: PositiveCount,
+    loops: Schema.Array(LoopShareView),
+    waiting: Share,
+    runs: Schema.Array(LoopRunTimeView),
+}) {
+}
+/**
+ * The median cost of the priced tasks: those whose sessions all have a price. `estimate` is true if
+ * a session of a priced task is in the Claude or ChatGPT plan.
+ */
+export class TaskCostView extends Schema.Class("@usine/orchestrator/TaskCostView")({
+    tasks: PositiveCount,
+    medianUsd: UsdAmount,
+    estimate: Schema.Boolean,
+}) {
+}
+/**
+ * The tokens of the tasks done whose Runs with an Attempt all reported tokens, with each Loop's
+ * share. `cost` is null if no such task is priced.
+ */
+export class TaskTokensView extends Schema.Class("@usine/orchestrator/TaskTokensView")({
+    tasks: PositiveCount,
+    medianTokens: TokenCount,
+    loops: Schema.Array(LoopShareView),
+    cost: Schema.NullOr(TaskCostView),
+}) {
+}
+/**
+ * The tasks done with an Attempt that ended before usine recorded end times, left out of `time`.
+ * Each such Attempt started before `before`.
+ */
+export class UntimedTasksView extends Schema.Class("@usine/orchestrator/UntimedTasksView")({ tasks: PositiveCount, before: UtcDay }) {
+}
+/**
+ * The tasks done in `window`: a task is done when its pull request merges, and counts if it has a
+ * Run. Runs that a newer Event or an Item change canceled before an Attempt are left out.
+ */
+export class StatisticsView extends Schema.Class("@usine/orchestrator/StatisticsView")({
+    window: StatisticsWindow,
+    /** The window's start: midnight UTC of its first day. */
+    from: Schema.String,
+    /** The time the statistics were computed. */
+    to: Schema.String,
+    bucket: StatisticsBucket,
+    /**
+     * The Loops of the window's tasks in the order they first run in a task: by mean rank, from 0
+     * for a task's first Loop to 1 for its last, then by name. `time` and `tokens` follow it.
+     */
+    loops: Schema.Array(LoopName),
+    /** By merge time, oldest first. */
+    tasks: Schema.Array(TaskDoneView),
+    /** The median of the tasks' `durationMillis`, or null without a task. */
+    medianMillis: Schema.NullOr(Milliseconds),
+    /** One period per bucket from `from` to `to`, oldest first. */
+    periods: Schema.Array(TaskPeriodView),
+    /** The tasks with no Loop that succeeded twice on one of their Items. */
+    firstTimeRight: Count,
+    /**
+     * The approvals, operator retries, failures marked resolved, and cycle-budget resets on the
+     * tasks' Runs and Items.
+     */
+    operatorActions: Count,
+    time: Schema.NullOr(TaskTimeView),
+    tokens: Schema.NullOr(TaskTokensView),
+    untimed: Schema.NullOr(UntimedTasksView),
+    /** The tasks with a Run that has an Attempt but no token report, left out of `tokens`. */
+    unmetered: Count,
+}) {
+}
+/** The median of at least one duration. */
+export class DurationSummaryView extends Schema.Class("@usine/orchestrator/DurationSummaryView")({ count: PositiveCount, medianMillis: Milliseconds }) {
+}
+/** Closed Runs or ended Attempts counted by outcome. */
+export class OutcomeCountsView extends Schema.Class("@usine/orchestrator/OutcomeCountsView")({ succeeded: Count, failed: Count, canceled: Count }) {
+}
+/** The tokens used in one billing pool. */
+export class PoolTokensView extends Schema.Class("@usine/orchestrator/PoolTokensView")({ pool: BillingPool, tokens: TokenCount }) {
+}
+/**
+ * The cost of the priced Runs or Attempts: those with a price for each session. `estimate` is true
+ * if a priced session is in the Claude or ChatGPT plan.
+ */
+export class CostSummaryView extends Schema.Class("@usine/orchestrator/CostSummaryView")({
+    usd: UsdAmount,
+    meanUsd: UsdAmount,
+    estimate: Schema.Boolean,
+    priced: PositiveCount,
+}) {
+}
+/**
+ * The tokens and cost of the Runs or Attempts with at least one Attempt. `meanTokens` is null if
+ * none has one, and `cost` is null if none is priced.
+ */
+export class UsageSummaryView extends Schema.Class("@usine/orchestrator/UsageSummaryView")({
+    measured: Count,
+    tokens: TokenCount,
+    meanTokens: Schema.NullOr(TokenCount),
+    /** In the order API keys, Claude plan, ChatGPT plan; unused pools are absent. */
+    pools: Schema.Array(PoolTokensView),
+    cost: Schema.NullOr(CostSummaryView),
+}) {
+}
+const groupFields = {
+    outcomes: OutcomeCountsView,
+    /** Run time for a Loop or Agent, Attempt time for a brain; null without a measured one. */
+    time: Schema.NullOr(DurationSummaryView),
+    usage: UsageSummaryView,
+};
+/** The closed Runs of one Loop. */
+export class LoopStatisticsView extends Schema.Class("@usine/orchestrator/LoopStatisticsView")({ loop: LoopName, ...groupFields }) {
+}
+/** The closed Runs whose effective Agent is `agent`. */
+export class AgentStatisticsView extends Schema.Class("@usine/orchestrator/AgentStatisticsView")({ agent: AgentName, ...groupFields }) {
+}
+/** The ended Attempts of closed Runs that ran with one harness, model, and effort. */
+export class BrainStatisticsView extends Schema.Class("@usine/orchestrator/BrainStatisticsView")({ brain: BrainSpec, ...groupFields }) {
+}
+/** The Runs that closed in one period, by outcome. */
+export class ThroughputPeriodView extends Schema.Class("@usine/orchestrator/ThroughputPeriodView")({ start: UtcDay, ...OutcomeCountsView.fields }) {
+}
+/** The time from a Run's opening, or its approval, to its first Attempt's start on `worker`. */
+export class WorkerQueueWaitView extends Schema.Class("@usine/orchestrator/WorkerQueueWaitView")({ worker: WorkerName, wait: DurationSummaryView }) {
+}
+/** The number of closed Runs that took `attempts` Attempts. */
+export class AttemptCountView extends Schema.Class("@usine/orchestrator/AttemptCountView")({ attempts: PositiveCount, runs: Count }) {
+}
+/**
+ * The time a declared Worker's slots held Attempts in the window, as a share of `slots` times the
+ * window's length.
+ */
+export class WorkerUtilizationView extends Schema.Class("@usine/orchestrator/WorkerUtilizationView")({
+    worker: WorkerName,
+    slots: PositiveCount,
+    occupiedMillis: Milliseconds,
+    share: Share,
+}) {
+}
+/** The Needs attention entries raised in one period. */
+export class NeedsAttentionPeriodView extends Schema.Class("@usine/orchestrator/NeedsAttentionPeriodView")({ start: UtcDay, approvals: Count, failures: Count }) {
+}
+/**
+ * The approvals asked for and the failed Attempts that no automatic retry followed, with their
+ * waits: from a run's opening to its approval, and from a failure to its first recorded operator
+ * answer (retry or resolution). Each answered failure contributes once to `failureWait` and to
+ * either `retryWait` or `resolutionWait`. Older resolutions without a timestamp are excluded.
+ */
+export class NeedsAttentionView extends Schema.Class("@usine/orchestrator/NeedsAttentionView")({
+    approvals: Count,
+    failures: Count,
+    periods: Schema.Array(NeedsAttentionPeriodView),
+    approvalWait: Schema.NullOr(DurationSummaryView),
+    retryWait: Schema.NullOr(DurationSummaryView),
+    resolutionWait: Schema.NullOr(DurationSummaryView),
+    failureWait: Schema.NullOr(DurationSummaryView),
+}) {
+}
+/**
+ * How the Runs went in `window`: closed Runs by outcome, Loop, Agent, and brain, with their time,
+ * tokens, and cost, and the Worker, retry, and Needs attention measures. Runs that a newer Event or
+ * an Item change canceled before an Attempt are left out.
+ */
+export class RunStatisticsView extends Schema.Class("@usine/orchestrator/RunStatisticsView")({
+    window: StatisticsWindow,
+    /** The window's start: midnight UTC of its first day. */
+    from: Schema.String,
+    /** The time the statistics were computed. */
+    to: Schema.String,
+    bucket: StatisticsBucket,
+    runs: OutcomeCountsView,
+    /** From each closed Run's opening to its close. */
+    runTime: Schema.NullOr(DurationSummaryView),
+    /** From each ended Attempt's start to its recorded end. */
+    attemptTime: Schema.NullOr(DurationSummaryView),
+    /** The ended Attempts closed before end times were recorded, left out of `attemptTime`. */
+    unmeasuredAttempts: Count,
+    /** One period per bucket from `from` to `to`, oldest first. */
+    throughput: Schema.Array(ThroughputPeriodView),
+    /** By closed Run count, highest first. */
+    loops: Schema.Array(LoopStatisticsView),
+    agents: Schema.Array(AgentStatisticsView),
+    brains: Schema.Array(BrainStatisticsView),
+    /** For Runs whose first Attempt started in the window, by Worker name. */
+    queueWait: Schema.Array(WorkerQueueWaitView),
+    /** From one Attempt to the most any closed Run took, each count present. */
+    attemptsPerRun: Schema.Array(AttemptCountView),
+    /** For the Workers that `usine.yaml` declares, in declaration order. */
+    utilization: Schema.Array(WorkerUtilizationView),
+    needsAttention: NeedsAttentionView,
+}) {
+}
+//# sourceMappingURL=view.js.map

package/dist/operator/statistics/view.js.map

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

package/dist/operator/statistics/window.d.ts

@@ -0,0 +1,24 @@
+import type { RunSummary } from "@usine/engine/run-reader";
+import { DateTime, Option } from "effect";
+import type { StatisticsBucket, StatisticsWindow } from "./view.ts";
+export declare const DAY = 86400000;
+export declare const epoch: (self: DateTime.DateTime) => number;
+export declare const startOfUtcDay: (epochMillis: number) => number;
+/** Returns the start of `window`, or `None` for `all`, whose start depends on the stored Runs. */
+export declare const windowStart: (window: StatisticsWindow, now: DateTime.Utc) => Option.Option<DateTime.Utc>;
+/** Returns the period length for a span: days up to 62 days, else weeks. */
+export declare const spanBucket: (from: number, to: number) => StatisticsBucket;
+export declare const utcDay: (epochMillis: number) => string;
+/** Returns the start of the period that holds `epochMillis`. Weeks start on Monday. */
+export declare const periodStart: (bucket: StatisticsBucket, epochMillis: number) => number;
+/** Returns the start of each period from `from` to `to`, oldest first. */
+export declare const periodStarts: (bucket: StatisticsBucket, from: number, to: number) => ReadonlyArray<number>;
+export declare const sum: (values: ReadonlyArray<number>) => number;
+/** Returns the median of `values`, the mean of the two middle values for an even count. */
+export declare const median: (values: ReadonlyArray<number>) => Option.Option<number>;
+/**
+ * Whether the engine canceled the Run before any Attempt because a newer Event or an Item change
+ * replaced it.
+ */
+export declare const replacedBeforeStart: ({ run, attempts }: RunSummary) => boolean;
+//# sourceMappingURL=window.d.ts.map

package/dist/operator/statistics/window.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"window.d.ts","sourceRoot":"","sources":["../../../src/operator/statistics/window.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAwB,QAAQ,EAAE,MAAM,EAAS,MAAM,QAAQ,CAAC;AACvE,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAEpE,eAAO,MAAM,GAAG,WAAa,CAAC;AAM9B,eAAO,MAAM,KAAK,qCAAyB,CAAC;AAE5C,eAAO,MAAM,aAAa,gBAAiB,MAAM,KAAG,MAA2C,CAAC;AAEhG,kGAAkG;AAClG,eAAO,MAAM,WAAW,WACd,gBAAgB,OACnB,QAAQ,CAAC,GAAG,KAChB,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAOtB,CAAC;AAER,4EAA4E;AAC5E,eAAO,MAAM,UAAU,SAAU,MAAM,MAAM,MAAM,KAAG,gBACoB,CAAC;AAE3E,eAAO,MAAM,MAAM,gBAAiB,MAAM,KAAG,MACK,CAAC;AAEnD,uFAAuF;AACvF,eAAO,MAAM,WAAW,WAAY,gBAAgB,eAAe,MAAM,KAAG,MAG3E,CAAC;AAEF,0EAA0E;AAC1E,eAAO,MAAM,YAAY,WACf,gBAAgB,QAClB,MAAM,MACR,MAAM,KACT,aAAa,CAAC,MAAM,CAKtB,CAAC;AAEF,eAAO,MAAM,GAAG,WAAY,aAAa,CAAC,MAAM,CAAC,KAAG,MACD,CAAC;AAEpD,2FAA2F;AAC3F,eAAO,MAAM,MAAM,WAAY,aAAa,CAAC,MAAM,CAAC,KAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAO1E,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,sBAAuB,UAAU,KAAG,OAGtB,CAAC"}

package/dist/operator/statistics/window.js

@@ -0,0 +1,47 @@
+import { Array as EffectArray, DateTime, Option, Order } from "effect";
+export const DAY = 86_400_000;
+const WEEK = 7 * DAY;
+/** The longest span, in days, that the time series still split into days. */
+const DAILY_SPAN_DAYS = 62;
+const WINDOW_DAYS = { "7d": 7, "30d": 30 };
+export const epoch = DateTime.toEpochMillis;
+export const startOfUtcDay = (epochMillis) => epochMillis - (epochMillis % DAY);
+/** Returns the start of `window`, or `None` for `all`, whose start depends on the stored Runs. */
+export const windowStart = (window, now) => window === "all"
+    ? Option.none()
+    : Option.some(DateTime.makeUnsafe(startOfUtcDay(DateTime.toEpochMillis(now)) - (WINDOW_DAYS[window] - 1) * DAY));
+/** Returns the period length for a span: days up to 62 days, else weeks. */
+export const spanBucket = (from, to) => (startOfUtcDay(to) - from) / DAY + 1 <= DAILY_SPAN_DAYS ? "day" : "week";
+export const utcDay = (epochMillis) => new Date(epochMillis).toISOString().slice(0, 10);
+/** Returns the start of the period that holds `epochMillis`. Weeks start on Monday. */
+export const periodStart = (bucket, epochMillis) => {
+    const day = startOfUtcDay(epochMillis);
+    return bucket === "day" ? day : day - ((new Date(day).getUTCDay() + 6) % 7) * DAY;
+};
+/** Returns the start of each period from `from` to `to`, oldest first. */
+export const periodStarts = (bucket, from, to) => {
+    const step = bucket === "day" ? DAY : WEEK;
+    const starts = [];
+    for (let start = periodStart(bucket, from); start <= to; start += step)
+        starts.push(start);
+    return starts;
+};
+export const sum = (values) => values.reduce((total, value) => total + value, 0);
+/** Returns the median of `values`, the mean of the two middle values for an even count. */
+export const median = (values) => {
+    if (!EffectArray.isReadonlyArrayNonEmpty(values))
+        return Option.none();
+    const sorted = EffectArray.sort(values, Order.Number);
+    const middle = (sorted.length - 1) / 2;
+    const lower = sorted[Math.floor(middle)] ?? sorted[0];
+    const upper = sorted[Math.ceil(middle)] ?? lower;
+    return Option.some((lower + upper) / 2);
+};
+/**
+ * Whether the engine canceled the Run before any Attempt because a newer Event or an Item change
+ * replaced it.
+ */
+export const replacedBeforeStart = ({ run, attempts }) => attempts.length === 0 &&
+    run.state._tag === "Canceled" &&
+    run.state.reason._tag !== "OperatorCanceled";
+//# sourceMappingURL=window.js.map

package/dist/operator/statistics/window.js.map

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