@treeseed/agent 0.8.5

package/dist/services/workday-report.d.ts

@@ -0,0 +1,238 @@
+#!/usr/bin/env node
+export declare function runWorkdayReport(): Promise<{
+    ok: boolean;
+    mode: "reconcile";
+    managerId: string;
+    projectId: string;
+    environment: "local" | "staging" | "prod";
+    insideWorkWindow: boolean;
+    workPolicy: import("@treeseed/sdk").WorkdayPolicy;
+    workDay: null;
+    prioritySnapshot: null;
+    seededTasks: never[];
+    queuedCount: number;
+    activeLeases: number;
+    desiredWorkers: number;
+    scaleResult: {
+        applied: boolean;
+        provider: string;
+        desiredWorkers: number;
+        metadata: {
+            reason: string;
+        };
+    };
+    workdaySummary: null;
+} | {
+    ok: boolean;
+    mode: "reconcile";
+    managerId: string;
+    projectId: string;
+    environment: "local" | "staging" | "prod";
+    insideWorkWindow: boolean;
+    workPolicy: import("@treeseed/sdk").WorkdayPolicy;
+    workDay: Record<string, unknown>;
+    prioritySnapshot: import("@treeseed/sdk").PrioritySnapshot | null;
+    seededTasks: {
+        [x: string]: unknown;
+    }[];
+    queuedCount: number;
+    activeLeases: number;
+    desiredWorkers: number;
+    scaleResult: import("@treeseed/sdk").WorkerPoolScaleResult;
+    workdaySummary: Record<string, unknown> | null;
+} | {
+    ok: boolean;
+    created: boolean;
+    workDay: Record<string, unknown>;
+    skipped?: undefined;
+    reason?: undefined;
+    prioritySnapshot?: undefined;
+} | {
+    ok: boolean;
+    created: boolean;
+    skipped: boolean;
+    reason: string;
+    workDay?: undefined;
+    prioritySnapshot?: undefined;
+} | {
+    ok: boolean;
+    created: boolean;
+    workDay: import("@treeseed/sdk").SdkWorkDayEntity | null;
+    prioritySnapshot: import("@treeseed/sdk").PrioritySnapshot | null;
+    skipped?: undefined;
+    reason?: undefined;
+} | {
+    ok: boolean;
+    skipped: boolean;
+    reason: string;
+    workDay?: undefined;
+    summary?: undefined;
+    scale?: undefined;
+} | {
+    ok: boolean;
+    workDay: import("@treeseed/sdk").SdkWorkDayEntity | null;
+    summary: {
+        contentSnapshot: {
+            relativePath: string;
+            slug: string;
+            reportVersion: string;
+            title: string;
+        };
+        capacity: {
+            providerSplit: {
+                providerId: string;
+                laneId: string;
+                state: import("@treeseed/sdk/types").CapacityReservationState;
+                reservedCredits: number;
+                consumedCredits: number;
+                reservedProviderUnits: number | null;
+                consumedProviderUnits: number | null;
+                reservedUsd: number | null;
+                consumedUsd: number | null;
+            }[];
+            grantedDailyCredits: number;
+            reservedCredits: number;
+            consumedCredits: number;
+            remainingDailyCredits: number | null;
+            providerCount: number;
+            laneCount: number;
+            grantCount: number;
+        } | null;
+        projectId: string;
+        environment: "local" | "staging" | "prod";
+        workDayId: string;
+        state: string;
+        totalTasks: number;
+        completedTasks: number;
+        failedTasks: number;
+        queuedTasks: number;
+        activeTasks: number;
+        dailyTaskCreditBudget: number;
+        usedTaskCredits: number;
+        remainingTaskCredits: number;
+        creditLedgerEntries: number;
+        prioritySnapshotId: string | null;
+        priorityItemCount: number;
+        priorityItems: import("@treeseed/sdk").PrioritySnapshotItem[];
+        taskItems: {
+            id: string;
+            agentId: string | undefined;
+            type: string | undefined;
+            state: string | undefined;
+            priority: number | undefined;
+            idempotencyKey: string | undefined;
+            createdAt: string | null;
+            startedAt: string | null;
+            completedAt: string | null;
+            lastErrorCode: string | null;
+            lastErrorMessage: string | null;
+            lastEventKind: string | null;
+            outputCount: number;
+            changedFiles: string[];
+        }[];
+        changedFiles: string[];
+        releases: {
+            id: string | undefined;
+            deploymentKind: string;
+            status: string;
+            releaseTag: string | null;
+            commitSha: string | null;
+            sourceRef: string | null;
+            startedAt: string | null;
+            finishedAt: string | null;
+            createdAt: string | null;
+        }[];
+        scaleDecision: import("@treeseed/sdk").ScaleDecision;
+        scaleResult: import("@treeseed/sdk").WorkerPoolScaleResult;
+        generatedAt: string;
+    };
+    scale: import("@treeseed/sdk").WorkerPoolScaleResult;
+    skipped?: undefined;
+    reason?: undefined;
+} | {
+    ok: boolean;
+    skipped: boolean;
+    reason: string;
+    workDayId?: undefined;
+    summary?: undefined;
+} | {
+    ok: boolean;
+    workDayId: unknown;
+    summary: {
+        contentSnapshot: {
+            relativePath: string;
+            slug: string;
+            reportVersion: string;
+            title: string;
+        };
+        capacity: {
+            providerSplit: {
+                providerId: string;
+                laneId: string;
+                state: import("@treeseed/sdk/types").CapacityReservationState;
+                reservedCredits: number;
+                consumedCredits: number;
+                reservedProviderUnits: number | null;
+                consumedProviderUnits: number | null;
+                reservedUsd: number | null;
+                consumedUsd: number | null;
+            }[];
+            grantedDailyCredits: number;
+            reservedCredits: number;
+            consumedCredits: number;
+            remainingDailyCredits: number | null;
+            providerCount: number;
+            laneCount: number;
+            grantCount: number;
+        } | null;
+        projectId: string;
+        environment: "local" | "staging" | "prod";
+        workDayId: string;
+        state: string;
+        totalTasks: number;
+        completedTasks: number;
+        failedTasks: number;
+        queuedTasks: number;
+        activeTasks: number;
+        dailyTaskCreditBudget: number;
+        usedTaskCredits: number;
+        remainingTaskCredits: number;
+        creditLedgerEntries: number;
+        prioritySnapshotId: string | null;
+        priorityItemCount: number;
+        priorityItems: import("@treeseed/sdk").PrioritySnapshotItem[];
+        taskItems: {
+            id: string;
+            agentId: string | undefined;
+            type: string | undefined;
+            state: string | undefined;
+            priority: number | undefined;
+            idempotencyKey: string | undefined;
+            createdAt: string | null;
+            startedAt: string | null;
+            completedAt: string | null;
+            lastErrorCode: string | null;
+            lastErrorMessage: string | null;
+            lastEventKind: string | null;
+            outputCount: number;
+            changedFiles: string[];
+        }[];
+        changedFiles: string[];
+        releases: {
+            id: string | undefined;
+            deploymentKind: string;
+            status: string;
+            releaseTag: string | null;
+            commitSha: string | null;
+            sourceRef: string | null;
+            startedAt: string | null;
+            finishedAt: string | null;
+            createdAt: string | null;
+        }[];
+        scaleDecision: import("@treeseed/sdk").ScaleDecision;
+        scaleResult: import("@treeseed/sdk").WorkerPoolScaleResult;
+        generatedAt: string;
+    };
+    skipped?: undefined;
+    reason?: undefined;
+}>;

package/dist/services/workday-report.js

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+import { fileURLToPath } from "node:url";
+import { runManagerAction } from "./manager.js";
+async function runWorkdayReport() {
+  return runManagerAction({
+    mode: "report-workday"
+  });
+}
+const currentFile = fileURLToPath(import.meta.url);
+const entryFile = process.argv[1] ?? "";
+if (entryFile === currentFile) {
+  process.stdout.write(`${JSON.stringify(await runWorkdayReport(), null, 2)}
+`);
+}
+export {
+  runWorkdayReport
+};

package/dist/services/workday-start.d.ts

@@ -0,0 +1,238 @@
+#!/usr/bin/env node
+export declare function runWorkdayStart(): Promise<{
+    ok: boolean;
+    mode: "reconcile";
+    managerId: string;
+    projectId: string;
+    environment: "local" | "staging" | "prod";
+    insideWorkWindow: boolean;
+    workPolicy: import("@treeseed/sdk").WorkdayPolicy;
+    workDay: null;
+    prioritySnapshot: null;
+    seededTasks: never[];
+    queuedCount: number;
+    activeLeases: number;
+    desiredWorkers: number;
+    scaleResult: {
+        applied: boolean;
+        provider: string;
+        desiredWorkers: number;
+        metadata: {
+            reason: string;
+        };
+    };
+    workdaySummary: null;
+} | {
+    ok: boolean;
+    mode: "reconcile";
+    managerId: string;
+    projectId: string;
+    environment: "local" | "staging" | "prod";
+    insideWorkWindow: boolean;
+    workPolicy: import("@treeseed/sdk").WorkdayPolicy;
+    workDay: Record<string, unknown>;
+    prioritySnapshot: import("@treeseed/sdk").PrioritySnapshot | null;
+    seededTasks: {
+        [x: string]: unknown;
+    }[];
+    queuedCount: number;
+    activeLeases: number;
+    desiredWorkers: number;
+    scaleResult: import("@treeseed/sdk").WorkerPoolScaleResult;
+    workdaySummary: Record<string, unknown> | null;
+} | {
+    ok: boolean;
+    created: boolean;
+    workDay: Record<string, unknown>;
+    skipped?: undefined;
+    reason?: undefined;
+    prioritySnapshot?: undefined;
+} | {
+    ok: boolean;
+    created: boolean;
+    skipped: boolean;
+    reason: string;
+    workDay?: undefined;
+    prioritySnapshot?: undefined;
+} | {
+    ok: boolean;
+    created: boolean;
+    workDay: import("@treeseed/sdk").SdkWorkDayEntity | null;
+    prioritySnapshot: import("@treeseed/sdk").PrioritySnapshot | null;
+    skipped?: undefined;
+    reason?: undefined;
+} | {
+    ok: boolean;
+    skipped: boolean;
+    reason: string;
+    workDay?: undefined;
+    summary?: undefined;
+    scale?: undefined;
+} | {
+    ok: boolean;
+    workDay: import("@treeseed/sdk").SdkWorkDayEntity | null;
+    summary: {
+        contentSnapshot: {
+            relativePath: string;
+            slug: string;
+            reportVersion: string;
+            title: string;
+        };
+        capacity: {
+            providerSplit: {
+                providerId: string;
+                laneId: string;
+                state: import("@treeseed/sdk/types").CapacityReservationState;
+                reservedCredits: number;
+                consumedCredits: number;
+                reservedProviderUnits: number | null;
+                consumedProviderUnits: number | null;
+                reservedUsd: number | null;
+                consumedUsd: number | null;
+            }[];
+            grantedDailyCredits: number;
+            reservedCredits: number;
+            consumedCredits: number;
+            remainingDailyCredits: number | null;
+            providerCount: number;
+            laneCount: number;
+            grantCount: number;
+        } | null;
+        projectId: string;
+        environment: "local" | "staging" | "prod";
+        workDayId: string;
+        state: string;
+        totalTasks: number;
+        completedTasks: number;
+        failedTasks: number;
+        queuedTasks: number;
+        activeTasks: number;
+        dailyTaskCreditBudget: number;
+        usedTaskCredits: number;
+        remainingTaskCredits: number;
+        creditLedgerEntries: number;
+        prioritySnapshotId: string | null;
+        priorityItemCount: number;
+        priorityItems: import("@treeseed/sdk").PrioritySnapshotItem[];
+        taskItems: {
+            id: string;
+            agentId: string | undefined;
+            type: string | undefined;
+            state: string | undefined;
+            priority: number | undefined;
+            idempotencyKey: string | undefined;
+            createdAt: string | null;
+            startedAt: string | null;
+            completedAt: string | null;
+            lastErrorCode: string | null;
+            lastErrorMessage: string | null;
+            lastEventKind: string | null;
+            outputCount: number;
+            changedFiles: string[];
+        }[];
+        changedFiles: string[];
+        releases: {
+            id: string | undefined;
+            deploymentKind: string;
+            status: string;
+            releaseTag: string | null;
+            commitSha: string | null;
+            sourceRef: string | null;
+            startedAt: string | null;
+            finishedAt: string | null;
+            createdAt: string | null;
+        }[];
+        scaleDecision: import("@treeseed/sdk").ScaleDecision;
+        scaleResult: import("@treeseed/sdk").WorkerPoolScaleResult;
+        generatedAt: string;
+    };
+    scale: import("@treeseed/sdk").WorkerPoolScaleResult;
+    skipped?: undefined;
+    reason?: undefined;
+} | {
+    ok: boolean;
+    skipped: boolean;
+    reason: string;
+    workDayId?: undefined;
+    summary?: undefined;
+} | {
+    ok: boolean;
+    workDayId: unknown;
+    summary: {
+        contentSnapshot: {
+            relativePath: string;
+            slug: string;
+            reportVersion: string;
+            title: string;
+        };
+        capacity: {
+            providerSplit: {
+                providerId: string;
+                laneId: string;
+                state: import("@treeseed/sdk/types").CapacityReservationState;
+                reservedCredits: number;
+                consumedCredits: number;
+                reservedProviderUnits: number | null;
+                consumedProviderUnits: number | null;
+                reservedUsd: number | null;
+                consumedUsd: number | null;
+            }[];
+            grantedDailyCredits: number;
+            reservedCredits: number;
+            consumedCredits: number;
+            remainingDailyCredits: number | null;
+            providerCount: number;
+            laneCount: number;
+            grantCount: number;
+        } | null;
+        projectId: string;
+        environment: "local" | "staging" | "prod";
+        workDayId: string;
+        state: string;
+        totalTasks: number;
+        completedTasks: number;
+        failedTasks: number;
+        queuedTasks: number;
+        activeTasks: number;
+        dailyTaskCreditBudget: number;
+        usedTaskCredits: number;
+        remainingTaskCredits: number;
+        creditLedgerEntries: number;
+        prioritySnapshotId: string | null;
+        priorityItemCount: number;
+        priorityItems: import("@treeseed/sdk").PrioritySnapshotItem[];
+        taskItems: {
+            id: string;
+            agentId: string | undefined;
+            type: string | undefined;
+            state: string | undefined;
+            priority: number | undefined;
+            idempotencyKey: string | undefined;
+            createdAt: string | null;
+            startedAt: string | null;
+            completedAt: string | null;
+            lastErrorCode: string | null;
+            lastErrorMessage: string | null;
+            lastEventKind: string | null;
+            outputCount: number;
+            changedFiles: string[];
+        }[];
+        changedFiles: string[];
+        releases: {
+            id: string | undefined;
+            deploymentKind: string;
+            status: string;
+            releaseTag: string | null;
+            commitSha: string | null;
+            sourceRef: string | null;
+            startedAt: string | null;
+            finishedAt: string | null;
+            createdAt: string | null;
+        }[];
+        scaleDecision: import("@treeseed/sdk").ScaleDecision;
+        scaleResult: import("@treeseed/sdk").WorkerPoolScaleResult;
+        generatedAt: string;
+    };
+    skipped?: undefined;
+    reason?: undefined;
+}>;

package/dist/services/workday-start.js

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+import { fileURLToPath } from "node:url";
+import { runManagerAction } from "./manager.js";
+async function runWorkdayStart() {
+  return runManagerAction({
+    mode: "open-workday"
+  });
+}
+const currentFile = fileURLToPath(import.meta.url);
+const entryFile = process.argv[1] ?? "";
+if (entryFile === currentFile) {
+  process.stdout.write(`${JSON.stringify(await runWorkdayStart(), null, 2)}
+`);
+}
+export {
+  runWorkdayStart
+};

package/dist/services/worker-capacity.d.ts

@@ -0,0 +1,58 @@
+import type { AgentPoolAutoscalePolicy, AgentSdk, ProjectEnvironmentName, ScaleDecision, WorkerPoolScaleResult, WorkerPoolScaler } from '@treeseed/sdk';
+export interface TaskMetricsSnapshot {
+    queuedTasks: Array<Record<string, unknown>>;
+    activeTasks: Array<Record<string, unknown>>;
+    queuedCount: number;
+    activeLeases: number;
+    queuedCredits: number;
+}
+export interface WorkerPoolIdentity {
+    projectId: string;
+    environment: ProjectEnvironmentName | 'local';
+    poolName: string;
+}
+export interface CapacityAssuranceResult {
+    ok: true;
+    taskId: string;
+    queued: true;
+    workerState: 'warm' | 'cold_starting';
+    desiredWorkers: number;
+    scaleApplied: boolean;
+    scaleReason: string;
+    scaleDecision: ScaleDecision;
+    scaleResult: WorkerPoolScaleResult;
+    metrics: TaskMetricsSnapshot;
+}
+export declare function resolveAutoscalePolicyFromEnv(): AgentPoolAutoscalePolicy;
+export declare function resolveWorkerPoolIdentityFromEnv(projectId?: string): WorkerPoolIdentity;
+export declare function computeDesiredWorkerCount(autoscale: AgentPoolAutoscalePolicy, metrics: Pick<TaskMetricsSnapshot, 'queuedCount' | 'activeLeases'>): number;
+export declare function applyScaleCooldown(autoscale: AgentPoolAutoscalePolicy, latestDecision: ScaleDecision | null, nextDesired: number, now: Date): number;
+export declare function applyInteractiveWakeUpOverride(options: {
+    priorityClass?: 'interactive' | 'background';
+    queuedCount: number;
+    currentWorkers: number;
+    desiredWorkers: number;
+}): number;
+export declare function collectTaskMetrics(sdk: AgentSdk, workDayId?: string | null): Promise<TaskMetricsSnapshot>;
+export declare function enqueueTaskAndEnsureCapacity(sdk: AgentSdk, request: {
+    taskId: string;
+    actor?: string;
+    queueName?: string;
+    deliveryDelaySeconds?: number;
+    priorityClass?: 'interactive' | 'background';
+    projectId?: string;
+    identity?: WorkerPoolIdentity;
+    autoscale?: AgentPoolAutoscalePolicy;
+    scaler?: WorkerPoolScaler;
+    now?: Date;
+    enqueueTask: (sdk: AgentSdk, request: {
+        taskId: string;
+        queueName?: string;
+        deliveryDelaySeconds?: number;
+        actor?: string;
+    }) => Promise<{
+        ok: boolean;
+        taskId: string;
+        queued: boolean;
+    }>;
+}): Promise<CapacityAssuranceResult>;