@treeseed/core 0.4.10 → 0.4.12

package/dist/services/manager.d.ts

@@ -0,0 +1,247 @@
+#!/usr/bin/env node
+import { type ControlPlaneReporter, type PrioritySnapshot, type PrioritySnapshotItem, type ProjectEnvironmentName, type ScaleDecision, type WorkdayPolicy, type WorkdaySchedule, type WorkerPoolScaleResult, type WorkerPoolScaler } from '@treeseed/sdk';
+import { createServiceSdk } from './common.ts';
+import { type WorkerPoolScalerKind } from './worker-pool-scaler.ts';
+type ManagerSdk = ReturnType<typeof createServiceSdk>;
+type ManagerMode = 'reconcile' | 'open-workday' | 'close-workday' | 'report-workday' | 'loop';
+type ManagerConfig = ReturnType<typeof resolveManagerServiceConfig>;
+type TaskRecord = Record<string, unknown>;
+export declare function resolveManagerServiceConfig(): {
+    mode: ManagerMode;
+    managerId: string;
+    marketBaseUrl: string;
+    runnerToken: string;
+    projectId: string;
+    teamId: string;
+    environment: ProjectEnvironmentName | "local";
+    poolName: string;
+    serviceBaseUrl: string;
+    pollIntervalMs: number;
+    dailyTaskCreditBudget: number;
+    maxQueuedTasks: number;
+    maxQueuedCredits: number;
+    priorityModels: string[];
+    priorityLimitPerModel: number;
+    graphInvalidated: boolean;
+    defaultSchedule: WorkdaySchedule;
+    scalerKind: WorkerPoolScalerKind;
+    creditWeights: import("@treeseed/sdk").TaskCreditWeight[];
+    autoscale: {
+        minWorkers: number;
+        maxWorkers: number;
+        targetQueueDepth: number;
+        cooldownSeconds: number;
+    };
+    host: string;
+    port: number;
+    defaultCapacityBudget: number;
+};
+export declare function runManagerAction(options?: {
+    mode?: ManagerMode;
+    sdk?: ManagerSdk;
+    config?: ManagerConfig;
+    reporter?: ControlPlaneReporter;
+    scaler?: WorkerPoolScaler;
+    now?: Date;
+}): Promise<{
+    ok: boolean;
+    mode: "reconcile";
+    managerId: string;
+    projectId: string;
+    environment: "local" | "prod" | "staging";
+    insideWorkWindow: boolean;
+    workPolicy: WorkdayPolicy;
+    workDay: Record<string, unknown>;
+    prioritySnapshot: PrioritySnapshot;
+    seededTasks: TaskRecord[];
+    queuedCount: number;
+    activeLeases: number;
+    desiredWorkers: number;
+    scaleResult: WorkerPoolScaleResult;
+    workdaySummary: Record<string, unknown>;
+} | {
+    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;
+    prioritySnapshot: PrioritySnapshot;
+    skipped?: undefined;
+    reason?: undefined;
+} | {
+    ok: boolean;
+    skipped: boolean;
+    reason: string;
+    workDay?: undefined;
+    summary?: undefined;
+    scale?: undefined;
+} | {
+    ok: boolean;
+    workDay: import("@treeseed/sdk").SdkWorkDayEntity;
+    summary: {
+        contentSnapshot: {
+            relativePath: string;
+            slug: string;
+            reportVersion: string;
+            title: string;
+        };
+        projectId: string;
+        environment: "local" | "prod" | "staging";
+        workDayId: string;
+        state: string;
+        totalTasks: number;
+        completedTasks: number;
+        failedTasks: number;
+        queuedTasks: number;
+        activeTasks: number;
+        dailyTaskCreditBudget: number;
+        usedTaskCredits: number;
+        remainingTaskCredits: number;
+        creditLedgerEntries: number;
+        prioritySnapshotId: string;
+        priorityItemCount: number;
+        priorityItems: PrioritySnapshotItem[];
+        taskItems: {
+            id: string;
+            agentId: string;
+            type: string;
+            state: string;
+            priority: number;
+            idempotencyKey: string;
+            createdAt: string;
+            startedAt: string;
+            completedAt: string;
+            lastErrorCode: string;
+            lastErrorMessage: string;
+            lastEventKind: string;
+            outputCount: number;
+            changedFiles: string[];
+        }[];
+        changedFiles: string[];
+        releases: {
+            id: string;
+            deploymentKind: string;
+            status: string;
+            releaseTag: string;
+            commitSha: string;
+            sourceRef: string;
+            startedAt: string;
+            finishedAt: string;
+            createdAt: string;
+        }[];
+        scaleDecision: ScaleDecision;
+        scaleResult: WorkerPoolScaleResult;
+        generatedAt: string;
+    };
+    scale: 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;
+        };
+        projectId: string;
+        environment: "local" | "prod" | "staging";
+        workDayId: string;
+        state: string;
+        totalTasks: number;
+        completedTasks: number;
+        failedTasks: number;
+        queuedTasks: number;
+        activeTasks: number;
+        dailyTaskCreditBudget: number;
+        usedTaskCredits: number;
+        remainingTaskCredits: number;
+        creditLedgerEntries: number;
+        prioritySnapshotId: string;
+        priorityItemCount: number;
+        priorityItems: PrioritySnapshotItem[];
+        taskItems: {
+            id: string;
+            agentId: string;
+            type: string;
+            state: string;
+            priority: number;
+            idempotencyKey: string;
+            createdAt: string;
+            startedAt: string;
+            completedAt: string;
+            lastErrorCode: string;
+            lastErrorMessage: string;
+            lastEventKind: string;
+            outputCount: number;
+            changedFiles: string[];
+        }[];
+        changedFiles: string[];
+        releases: {
+            id: string;
+            deploymentKind: string;
+            status: string;
+            releaseTag: string;
+            commitSha: string;
+            sourceRef: string;
+            startedAt: string;
+            finishedAt: string;
+            createdAt: string;
+        }[];
+        scaleDecision: ScaleDecision;
+        scaleResult: WorkerPoolScaleResult;
+        generatedAt: string;
+    };
+    skipped?: undefined;
+    reason?: undefined;
+}>;
+export declare function runManagerCycle(options?: {
+    sdk?: ManagerSdk;
+    config?: ManagerConfig;
+    reporter?: ControlPlaneReporter;
+    scaler?: WorkerPoolScaler;
+    now?: Date;
+}): Promise<{
+    ok: boolean;
+    mode: "reconcile";
+    managerId: string;
+    projectId: string;
+    environment: "local" | "prod" | "staging";
+    insideWorkWindow: boolean;
+    workPolicy: WorkdayPolicy;
+    workDay: Record<string, unknown>;
+    prioritySnapshot: PrioritySnapshot;
+    seededTasks: TaskRecord[];
+    queuedCount: number;
+    activeLeases: number;
+    desiredWorkers: number;
+    scaleResult: WorkerPoolScaleResult;
+    workdaySummary: Record<string, unknown>;
+}>;
+export declare function startManagerLoop(options?: {
+    sdk?: ManagerSdk;
+    config?: ManagerConfig;
+    reporter?: ControlPlaneReporter;
+    scaler?: WorkerPoolScaler;
+}): Promise<void>;
+export {};