@paperclipai/server 2026.817.0 → 2026.818.0-beta.1

package/dist/services/workspace-git-operation-scheduler.d.ts

@@ -0,0 +1,135 @@
+import { HttpError } from "../errors.js";
+export declare const WORKSPACE_GIT_SCAN_ERROR_CODES: {
+    readonly saturated: "workspace_git_scan_saturated";
+    readonly timeout: "workspace_git_scan_timeout";
+    readonly cancelled: "workspace_git_scan_cancelled";
+    readonly outputLimit: "workspace_git_scan_output_limit";
+    readonly failed: "workspace_git_scan_failed";
+};
+export type WorkspaceGitScanErrorCode = (typeof WORKSPACE_GIT_SCAN_ERROR_CODES)[keyof typeof WORKSPACE_GIT_SCAN_ERROR_CODES];
+export declare class WorkspaceGitScanError extends HttpError {
+    readonly code: WorkspaceGitScanErrorCode;
+    constructor(code: WorkspaceGitScanErrorCode, message: string, details?: Record<string, unknown>);
+}
+export declare function isWorkspaceGitScanError(error: unknown): error is WorkspaceGitScanError;
+export interface WorkspaceGitScanResult {
+    stdout: string;
+    stderr: string;
+    canonicalWorkspacePath: string;
+    workspaceHash: string;
+    cacheHit: boolean;
+    singleFlightJoined: boolean;
+}
+export interface WorkspaceGitScanInput {
+    workspacePath: string;
+    args: readonly string[];
+    operation: string;
+    /**
+     * Stable, non-secret scheduling dimensions. Jobs sharing any recently-served
+     * dimension are deprioritized, so changing issue ids cannot bypass fairness
+     * for the same company, actor, or repository.
+     */
+    fairnessKeys?: readonly string[];
+    signal?: AbortSignal;
+    /** Successful-result cache duration. Use zero for correctness-sensitive guards. */
+    cacheTtlMs?: number;
+    /** Per-operation wall-clock deadline. Defaults to the process-wide setting. */
+    timeoutMs?: number;
+    env?: NodeJS.ProcessEnv;
+    maxStdoutBytes?: number;
+    maxStderrBytes?: number;
+}
+export interface WorkspaceGitSchedulerSnapshot {
+    activeCount: number;
+    queuedCount: number;
+    inFlightCount: number;
+    cacheEntryCount: number;
+    cacheBytes: number;
+    totals: {
+        started: number;
+        succeeded: number;
+        failed: number;
+        timedOut: number;
+        cancelled: number;
+        saturated: number;
+        cacheHits: number;
+        singleFlightJoins: number;
+    };
+}
+export interface WorkspaceGitRunnerInput {
+    canonicalWorkspacePath: string;
+    args: readonly string[];
+    env?: NodeJS.ProcessEnv;
+    signal: AbortSignal;
+    timeoutMs: number;
+    killGraceMs: number;
+    maxStdoutBytes: number;
+    maxStderrBytes: number;
+}
+export interface WorkspaceGitRunnerResult {
+    stdout: string;
+    stderr: string;
+}
+export type WorkspaceGitRunner = (input: WorkspaceGitRunnerInput) => Promise<WorkspaceGitRunnerResult>;
+export interface WorkspaceGitOperationSchedulerOptions {
+    concurrency?: number;
+    queueCapacity?: number;
+    timeoutMs?: number;
+    killGraceMs?: number;
+    defaultCacheTtlMs?: number;
+    maxCacheEntries?: number;
+    maxCacheBytes?: number;
+    maxStdoutBytes?: number;
+    maxStderrBytes?: number;
+    warningIntervalMs?: number;
+    gitBinary?: string;
+    gitArgsPrefix?: readonly string[];
+    runner?: WorkspaceGitRunner;
+    now?: () => number;
+}
+export declare function workspaceGitSchedulerOptionsFromEnv(env?: NodeJS.ProcessEnv): Required<Pick<WorkspaceGitOperationSchedulerOptions, "concurrency" | "queueCapacity" | "timeoutMs" | "defaultCacheTtlMs">>;
+export declare class WorkspaceGitOperationScheduler {
+    private readonly concurrency;
+    private readonly queueCapacity;
+    private readonly timeoutMs;
+    private readonly killGraceMs;
+    private readonly defaultCacheTtlMs;
+    private readonly maxCacheEntries;
+    private readonly maxCacheBytes;
+    private readonly maxStdoutBytes;
+    private readonly maxStderrBytes;
+    private readonly warningIntervalMs;
+    private readonly runner;
+    private readonly now;
+    private readonly inFlight;
+    private readonly queue;
+    private readonly cache;
+    private readonly lastServedByFairnessKey;
+    private readonly warningBuckets;
+    private cacheBytes;
+    private activeCount;
+    private serviceSequence;
+    private readonly totals;
+    constructor(options?: WorkspaceGitOperationSchedulerOptions);
+    snapshot(): WorkspaceGitSchedulerSnapshot;
+    run(input: WorkspaceGitScanInput): Promise<WorkspaceGitScanResult>;
+    private addWaiter;
+    private removeWaiter;
+    private drain;
+    private nextFairQueueIndex;
+    private start;
+    private finishSuccess;
+    private finishFailure;
+    private detachWaiter;
+    private release;
+    private pruneFairnessState;
+    private readCache;
+    private writeCache;
+    private deleteCacheEntry;
+    private pruneExpiredCache;
+    private warnRateLimited;
+}
+export declare function createWorkspaceGitOperationScheduler(options?: WorkspaceGitOperationSchedulerOptions): WorkspaceGitOperationScheduler;
+export declare const workspaceGitOperationScheduler: WorkspaceGitOperationScheduler;
+export declare function getWorkspaceGitOperationSchedulerSnapshot(): WorkspaceGitSchedulerSnapshot;
+//# sourceMappingURL=workspace-git-operation-scheduler.d.ts.map

package/dist/services/workspace-git-operation-scheduler.d.ts.map

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