github-issue-tower-defence-management 1.139.1 → 1.140.0

package/types/domain/usecases/TokenExhaustionHandoverUseCase.d.ts

@@ -0,0 +1,50 @@
+import { TokenExhaustionHandoverState } from '../entities/TokenExhaustionHandoverState';
+import { ClaudeHandoverSessionRepository } from './adapter-interfaces/ClaudeHandoverSessionRepository';
+import { ProcessSignalRepository } from './adapter-interfaces/ProcessSignalRepository';
+import { TmuxSessionRepository } from './adapter-interfaces/TmuxSessionRepository';
+import { TokenRateLimitSnapshotRepository } from './adapter-interfaces/TokenRateLimitSnapshotRepository';
+export declare const DEFAULT_TOKEN_EXHAUSTION_HANDOVER_MESSAGE = "TOKEN NEAR EXHAUSTION. Within 2 minutes, write a CHECKPOINT to your assigned task issue: the in-flight subagents and what each is doing, their durable refs (branch and pull request URLs), the working directory and branch, the single concrete next action to resume, and the reason (token near exhaustion). Do this WITHOUT waiting for long-running or CI-watching subagents. Then self-kill your own tmux session with `tmux kill-session`.";
+export declare const DEFAULT_TOKEN_EXHAUSTION_HANDOVER_MESSAGE_BARE_NAME_LEADER = "TOKEN NEAR EXHAUSTION. You are a resident leader with no assigned task issue. Within 2 minutes, write a CHECKPOINT for every in-flight subagent (what each is doing and its durable refs = branch and pull request URLs, plus the single concrete next action to resume and the working directory and branch) into the GitHub issue that each subagent is working on, WITHOUT waiting for long-running or CI-watching subagents. Then stop and stay idle; do NOT self-kill. This session will be terminated and relaunched on a token that still has quota so its work is preserved.";
+export declare const DEFAULT_TOKEN_EXHAUSTION_GRACE_PERIOD_SECONDS = 180;
+export declare const TOKEN_EXHAUSTION_SNAPSHOT_STALE_THRESHOLD_SECONDS = 900;
+export declare const TOKEN_EXHAUSTION_SNAPSHOT_HARD_STALE_THRESHOLD_SECONDS = 3600;
+export declare const TOKEN_EXHAUSTION_FIVE_HOUR_FREE_THRESHOLD = 0.1;
+export declare const TOKEN_EXHAUSTION_SEVEN_DAY_FREE_THRESHOLD = 0.05;
+export declare const TOKEN_EXHAUSTION_FIVE_HOUR_WARNING_FREE_THRESHOLD = 0.25;
+export declare const TOKEN_EXHAUSTION_SEVEN_DAY_WARNING_FREE_THRESHOLD = 0.15;
+export type TokenExhaustionHandoverInput = {
+    enabled: boolean;
+    issueUrlLeaderMessage: string;
+    bareNameLeaderMessage: string;
+    gracePeriodSeconds: number;
+    state: TokenExhaustionHandoverState;
+    now: Date;
+};
+export type TokenExhaustionHandoverResult = {
+    newlyHandoverSentSessionNames: string[];
+    killedSessionNames: string[];
+    terminatedPids: number[];
+    relaunchedLeaderNames: string[];
+    leftAliveSessionNames: string[];
+    state: TokenExhaustionHandoverState;
+};
+export declare class TokenExhaustionHandoverUseCase {
+    private readonly handoverSessionRepository;
+    private readonly snapshotRepository;
+    private readonly tmuxSessionRepository;
+    private readonly processSignalRepository;
+    constructor(handoverSessionRepository: Pick<ClaudeHandoverSessionRepository, 'listHandoverSessions'>, snapshotRepository: Pick<TokenRateLimitSnapshotRepository, 'listSnapshots'>, tmuxSessionRepository: Pick<TmuxSessionRepository, 'sendKeys' | 'killSession' | 'listLiveSessionNames' | 'launchBareNameLeaderSession'>, processSignalRepository: ProcessSignalRepository);
+    run: (input: TokenExhaustionHandoverInput) => Promise<TokenExhaustionHandoverResult>;
+    private needsRelaunch;
+    private relaunchBareNameLeader;
+    private sendHandover;
+    private forceKill;
+    private stateKeyFor;
+    private displayName;
+    private isFresherTokenAvailable;
+    private evaluateSnapshot;
+    private freeRatio;
+    private clamp01;
+    private isWeeklyCapped;
+}
+//# sourceMappingURL=TokenExhaustionHandoverUseCase.d.ts.map

package/types/domain/usecases/TokenExhaustionHandoverUseCase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TokenExhaustionHandoverUseCase.d.ts","sourceRoot":"","sources":["../../../src/domain/usecases/TokenExhaustionHandoverUseCase.ts"],"names":[],"mappings":"AACA,OAAO,EACL,4BAA4B,EAE7B,MAAM,0CAA0C,CAAC;AAClD,OAAO,EAAE,+BAA+B,EAAE,MAAM,sDAAsD,CAAC;AACvG,OAAO,EAAE,uBAAuB,EAAE,MAAM,8CAA8C,CAAC;AACvF,OAAO,EAAE,qBAAqB,EAAE,MAAM,4CAA4C,CAAC;AACnF,OAAO,EAGL,gCAAgC,EACjC,MAAM,uDAAuD,CAAC;AAE/D,eAAO,MAAM,yCAAyC,ubACgY,CAAC;AAEvb,eAAO,MAAM,0DAA0D,yjBACif,CAAC;AAEzjB,eAAO,MAAM,6CAA6C,MAAM,CAAC;AACjE,eAAO,MAAM,iDAAiD,MAAM,CAAC;AACrE,eAAO,MAAM,sDAAsD,OAAO,CAAC;AAC3E,eAAO,MAAM,yCAAyC,MAAM,CAAC;AAC7D,eAAO,MAAM,yCAAyC,OAAO,CAAC;AAC9D,eAAO,MAAM,iDAAiD,OAAO,CAAC;AACtE,eAAO,MAAM,iDAAiD,OAAO,CAAC;AAYtE,MAAM,MAAM,4BAA4B,GAAG;IACzC,OAAO,EAAE,OAAO,CAAC;IACjB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,KAAK,EAAE,4BAA4B,CAAC;IACpC,GAAG,EAAE,IAAI,CAAC;CACX,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG;IAC1C,6BAA6B,EAAE,MAAM,EAAE,CAAC;IACxC,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,KAAK,EAAE,4BAA4B,CAAC;CACrC,CAAC;AAEF,qBAAa,8BAA8B;IAEvC,OAAO,CAAC,QAAQ,CAAC,yBAAyB;IAI1C,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IAInC,OAAO,CAAC,QAAQ,CAAC,qBAAqB;IAOtC,OAAO,CAAC,QAAQ,CAAC,uBAAuB;gBAfvB,yBAAyB,EAAE,IAAI,CAC9C,+BAA+B,EAC/B,sBAAsB,CACvB,EACgB,kBAAkB,EAAE,IAAI,CACvC,gCAAgC,EAChC,eAAe,CAChB,EACgB,qBAAqB,EAAE,IAAI,CAC1C,qBAAqB,EACnB,UAAU,GACV,aAAa,GACb,sBAAsB,GACtB,6BAA6B,CAChC,EACgB,uBAAuB,EAAE,uBAAuB;IAGnE,GAAG,GACD,OAAO,4BAA4B,KAClC,OAAO,CAAC,6BAA6B,CAAC,CAuIvC;IAEF,OAAO,CAAC,aAAa,CACwC;IAE7D,OAAO,CAAC,sBAAsB,CAS5B;IAEF,OAAO,CAAC,YAAY,CAgBlB;IAEF,OAAO,CAAC,SAAS,CAoBf;IAEF,OAAO,CAAC,WAAW,CAGiC;IAEpD,OAAO,CAAC,WAAW,CAC2B;IAE9C,OAAO,CAAC,uBAAuB,CAe7B;IAEF,OAAO,CAAC,gBAAgB,CAgFtB;IAEF,OAAO,CAAC,SAAS,CASf;IAEF,OAAO,CAAC,OAAO,CAQb;IAEF,OAAO,CAAC,cAAc,CAcpB;CACH"}

package/types/domain/usecases/adapter-interfaces/ClaudeHandoverSessionRepository.d.ts

@@ -0,0 +1,5 @@
+import { ClaudeHandoverSession } from '../../entities/ClaudeHandoverSession';
+export interface ClaudeHandoverSessionRepository {
+    listHandoverSessions: () => ClaudeHandoverSession[];
+}
+//# sourceMappingURL=ClaudeHandoverSessionRepository.d.ts.map

package/types/domain/usecases/adapter-interfaces/ClaudeHandoverSessionRepository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClaudeHandoverSessionRepository.d.ts","sourceRoot":"","sources":["../../../../src/domain/usecases/adapter-interfaces/ClaudeHandoverSessionRepository.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAE7E,MAAM,WAAW,+BAA+B;IAC9C,oBAAoB,EAAE,MAAM,qBAAqB,EAAE,CAAC;CACrD"}

package/types/domain/usecases/adapter-interfaces/ProcessSignalRepository.d.ts

@@ -0,0 +1,6 @@
+export interface ProcessSignalRepository {
+    isProcessAlive: (pid: number) => boolean;
+    terminateProcess: (pid: number) => void;
+    killProcess: (pid: number) => void;
+}
+//# sourceMappingURL=ProcessSignalRepository.d.ts.map

package/types/domain/usecases/adapter-interfaces/ProcessSignalRepository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProcessSignalRepository.d.ts","sourceRoot":"","sources":["../../../../src/domain/usecases/adapter-interfaces/ProcessSignalRepository.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,uBAAuB;IACtC,cAAc,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IACzC,gBAAgB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,WAAW,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC"}

package/types/domain/usecases/adapter-interfaces/TmuxSessionRepository.d.ts

@@ -6,5 +6,7 @@ export interface TmuxSessionRepository {
     launchDetachedSession: (sessionName: string, launcherCommand: string, issueUrl: string) => Promise<void>;
     killSession: (sessionName: string) => Promise<void>;
     killOwnSession: () => Promise<void>;
+    sendKeys: (sessionName: string, literalText: string) => Promise<void>;
+    launchBareNameLeaderSession: (name: string) => Promise<void>;
 }
 //# sourceMappingURL=TmuxSessionRepository.d.ts.map

package/types/domain/usecases/adapter-interfaces/TmuxSessionRepository.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TmuxSessionRepository.d.ts","sourceRoot":"","sources":["../../../../src/domain/usecases/adapter-interfaces/TmuxSessionRepository.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEjE,MAAM,WAAW,qBAAqB;IACpC,oBAAoB,EAAE,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC9C,4BAA4B,EAAE,MAAM,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IAC/D,kCAAkC,EAAE,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5D,qBAAqB,EAAE,CACrB,WAAW,EAAE,MAAM,EACnB,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,MAAM,KACb,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,WAAW,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,cAAc,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC"}
+{"version":3,"file":"TmuxSessionRepository.d.ts","sourceRoot":"","sources":["../../../../src/domain/usecases/adapter-interfaces/TmuxSessionRepository.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEjE,MAAM,WAAW,qBAAqB;IACpC,oBAAoB,EAAE,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC9C,4BAA4B,EAAE,MAAM,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IAC/D,kCAAkC,EAAE,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5D,qBAAqB,EAAE,CACrB,WAAW,EAAE,MAAM,EACnB,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,MAAM,KACb,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,WAAW,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,cAAc,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,QAAQ,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtE,2BAA2B,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9D"}

package/types/domain/usecases/adapter-interfaces/TokenExhaustionHandoverStateRepository.d.ts

@@ -0,0 +1,6 @@
+import { TokenExhaustionHandoverState } from '../../entities/TokenExhaustionHandoverState';
+export interface TokenExhaustionHandoverStateRepository {
+    load: () => TokenExhaustionHandoverState;
+    save: (state: TokenExhaustionHandoverState) => void;
+}
+//# sourceMappingURL=TokenExhaustionHandoverStateRepository.d.ts.map

package/types/domain/usecases/adapter-interfaces/TokenExhaustionHandoverStateRepository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TokenExhaustionHandoverStateRepository.d.ts","sourceRoot":"","sources":["../../../../src/domain/usecases/adapter-interfaces/TokenExhaustionHandoverStateRepository.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,6CAA6C,CAAC;AAE3F,MAAM,WAAW,sCAAsC;IACrD,IAAI,EAAE,MAAM,4BAA4B,CAAC;IACzC,IAAI,EAAE,CAAC,KAAK,EAAE,4BAA4B,KAAK,IAAI,CAAC;CACrD"}

package/types/domain/usecases/adapter-interfaces/TokenRateLimitSnapshotRepository.d.ts

@@ -0,0 +1,21 @@
+export type TokenModelWeeklyLimit = {
+    rejected: boolean;
+    resetsAt: number;
+};
+export type TokenRateLimitSnapshot = {
+    token: string;
+    name: string;
+    fiveHourUtilization: number;
+    fiveHourReset: number;
+    sevenDayUtilization: number;
+    sevenDayReset: number;
+    blocked: boolean;
+    rejected: boolean;
+    blockedUntilEpoch: number;
+    modelWeeklyLimits: TokenModelWeeklyLimit[];
+    lastUpdatedEpoch: number;
+};
+export interface TokenRateLimitSnapshotRepository {
+    listSnapshots: () => TokenRateLimitSnapshot[];
+}
+//# sourceMappingURL=TokenRateLimitSnapshotRepository.d.ts.map

package/types/domain/usecases/adapter-interfaces/TokenRateLimitSnapshotRepository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TokenRateLimitSnapshotRepository.d.ts","sourceRoot":"","sources":["../../../../src/domain/usecases/adapter-interfaces/TokenRateLimitSnapshotRepository.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB,EAAE,MAAM,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,qBAAqB,EAAE,CAAC;IAC3C,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,MAAM,WAAW,gCAAgC;IAC/C,aAAa,EAAE,MAAM,sBAAsB,EAAE,CAAC;CAC/C"}