@made-by-moonlight/athene-core 0.9.1

package/dist/recovery/actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../src/recovery/actions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,kBAAkB,EAClB,cAAc,EAGf,MAAM,aAAa,CAAC;AAWrB,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AA0CtF,wBAAsB,cAAc,CAClC,UAAU,EAAE,kBAAkB,EAC9B,MAAM,EAAE,kBAAkB,EAC1B,QAAQ,EAAE,cAAc,EACxB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,cAAc,CAAC,CAkHzB;AAED,wBAAsB,cAAc,CAClC,UAAU,EAAE,kBAAkB,EAC9B,MAAM,EAAE,kBAAkB,EAC1B,QAAQ,EAAE,cAAc,EACxB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,cAAc,CAAC,CAyEzB;AAED,wBAAsB,eAAe,CACnC,UAAU,EAAE,kBAAkB,EAC9B,MAAM,EAAE,kBAAkB,EAC1B,SAAS,EAAE,cAAc,EACzB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,cAAc,CAAC,CAsDzB;AAED,wBAAsB,aAAa,CACjC,UAAU,EAAE,kBAAkB,EAC9B,MAAM,EAAE,kBAAkB,EAC1B,QAAQ,EAAE,cAAc,EACxB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,cAAc,CAAC,CAgBzB"}

package/dist/recovery/index.d.ts

@@ -0,0 +1,8 @@
+export type { RecoveryClassification, RecoveryAction, RecoveryAssessment, RecoveryResult, RecoveryReport, RecoveryLogEntry, RecoveryConfig, RecoveryContext, } from "./types.js";
+export { DEFAULT_RECOVERY_CONFIG } from "./types.js";
+export { scanAllSessions, getRecoveryLogPath, type ScannedSession } from "./scanner.js";
+export { validateSession, classifySession, determineAction } from "./validator.js";
+export { recoverSession, cleanupSession, escalateSession, executeAction } from "./actions.js";
+export { writeRecoveryLog, createLogEntry, formatRecoveryReport, createEmptyReport, } from "./logger.js";
+export { runRecovery, recoverSessionById, type RecoveryManagerOptions, type RecoveryRunResult, } from "./manager.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/recovery/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/recovery/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,sBAAsB,EACtB,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAErD,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAExF,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEnF,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE9F,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,GACvB,MAAM,cAAc,CAAC"}

package/dist/recovery/logger.d.ts

@@ -0,0 +1,12 @@
+import type { SessionId, SessionStatus } from "../types.js";
+import type { RecoveryLogEntry, RecoveryReport } from "./types.js";
+export declare function writeRecoveryLog(logPath: string, entry: RecoveryLogEntry): void;
+export declare function createLogEntry(sessionId: SessionId, action: RecoveryLogEntry["action"], options?: {
+    previousStatus?: SessionStatus;
+    reason?: string;
+    error?: string;
+    details?: Record<string, unknown>;
+}): RecoveryLogEntry;
+export declare function formatRecoveryReport(report: RecoveryReport): string;
+export declare function createEmptyReport(): RecoveryReport;
+//# sourceMappingURL=logger.d.ts.map

package/dist/recovery/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/recovery/logger.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEnE,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAO/E;AAED,wBAAgB,cAAc,CAC5B,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,gBAAgB,CAAC,QAAQ,CAAC,EAClC,OAAO,CAAC,EAAE;IACR,cAAc,CAAC,EAAE,aAAa,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC,GACA,gBAAgB,CAOlB;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAgCnE;AAED,wBAAgB,iBAAiB,IAAI,cAAc,CAWlD"}

package/dist/recovery/manager.d.ts

@@ -0,0 +1,24 @@
+import type { OrchestratorConfig, PluginRegistry, Session } from "../types.js";
+import { type RecoveryReport, type RecoveryResult, type RecoveryAssessment, type RecoveryConfig } from "./types.js";
+export interface RecoveryManagerOptions {
+    config: OrchestratorConfig;
+    registry: PluginRegistry;
+    recoveryConfig?: Partial<RecoveryConfig>;
+    dryRun?: boolean;
+    projectFilter?: string;
+    /**
+     * Called after each metadata mutation performed by recovery actions.
+     * Pass `sessionManager.invalidateCache` when wiring recovery into a
+     * surface that also reads from listCached() (dashboard, SSE).
+     */
+    invalidateCache?: () => void;
+}
+export interface RecoveryRunResult {
+    report: RecoveryReport;
+    assessments: RecoveryAssessment[];
+    results: RecoveryResult[];
+    recoveredSessions: Session[];
+}
+export declare function runRecovery(options: RecoveryManagerOptions): Promise<RecoveryRunResult>;
+export declare function recoverSessionById(sessionId: string, options: RecoveryManagerOptions): Promise<RecoveryResult | null>;
+//# sourceMappingURL=manager.d.ts.map

package/dist/recovery/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/recovery/manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAM/E,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACpB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,QAAQ,EAAE,cAAc,CAAC;IACzB,cAAc,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACzC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,cAAc,CAAC;IACvB,WAAW,EAAE,kBAAkB,EAAE,CAAC;IAClC,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,iBAAiB,EAAE,OAAO,EAAE,CAAC;CAC9B;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAmG7F;AA6CD,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CA8ChC"}

package/dist/recovery/scanner.d.ts

@@ -0,0 +1,11 @@
+import type { SessionId, OrchestratorConfig, ProjectConfig } from "../types.js";
+export interface ScannedSession {
+    sessionId: SessionId;
+    projectId: string;
+    project: ProjectConfig;
+    sessionsDir: string;
+    rawMetadata: Record<string, string>;
+}
+export declare function scanAllSessions(config: OrchestratorConfig, projectIdFilter?: string): ScannedSession[];
+export declare function getRecoveryLogPath(_configPath: string, projectId?: string): string;
+//# sourceMappingURL=scanner.d.ts.map

package/dist/recovery/scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../../src/recovery/scanner.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAIhF,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,SAAS,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,aAAa,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC;AAED,wBAAgB,eAAe,CAC7B,MAAM,EAAE,kBAAkB,EAC1B,eAAe,CAAC,EAAE,MAAM,GACvB,cAAc,EAAE,CAwBlB;AAED,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAMlF"}

package/dist/recovery/types.d.ts

@@ -0,0 +1,170 @@
+/**
+ * Recovery Types — Session classification and recovery result types.
+ *
+ * Part of the orchestrator recovery automation system (Issue #356).
+ * These types define how sessions are classified and what actions are taken.
+ */
+import type { SessionId, SessionStatus, Session, RuntimeHandle, ActivityState } from "../types.js";
+/**
+ * Classification of a session's recoverability state.
+ *
+ * - live: Session is running normally, just needs to be re-registered
+ * - dead: Runtime is gone, needs cleanup
+ * - partial: Some components exist but session is incomplete
+ * - unrecoverable: Session is in a terminal state (merged, done) - skip
+ */
+export type RecoveryClassification = "live" | "dead" | "partial" | "unrecoverable";
+/**
+ * Action to take for a session during recovery.
+ *
+ * - recover: Restore session to in-memory state
+ * - cleanup: Remove runtime/workspace, archive metadata
+ * - escalate: Requires manual intervention
+ * - skip: No action needed
+ */
+export type RecoveryAction = "recover" | "cleanup" | "escalate" | "skip";
+/**
+ * Assessment of a session's state for recovery purposes.
+ */
+export interface RecoveryAssessment {
+    /** Session ID being assessed */
+    sessionId: SessionId;
+    /** Project ID this session belongs to */
+    projectId: string;
+    /** Overall classification */
+    classification: RecoveryClassification;
+    /** Recommended action */
+    action: RecoveryAction;
+    /** Human-readable reason for classification */
+    reason: string;
+    /** Whether the runtime probe itself succeeded */
+    runtimeProbeSucceeded: boolean;
+    /** Whether the process probe itself succeeded */
+    processProbeSucceeded: boolean;
+    /** Whether the signals disagree strongly enough to block cleanup */
+    signalDisagreement: boolean;
+    /** Whether recovery can proceed automatically, needs a human, or should be skipped */
+    recoveryRule: "auto" | "human" | "skip";
+    /** Whether the runtime (tmux/docker) is alive */
+    runtimeAlive: boolean;
+    /** Runtime handle if available */
+    runtimeHandle: RuntimeHandle | null;
+    /** Whether the workspace directory exists */
+    workspaceExists: boolean;
+    /** Workspace path if known */
+    workspacePath: string | null;
+    /** Whether the agent process appears to be running */
+    agentProcessRunning: boolean;
+    /** Detected agent activity state */
+    agentActivity: ActivityState | null;
+    /** Whether metadata file is valid/readable */
+    metadataValid: boolean;
+    /** Current status from metadata */
+    metadataStatus: SessionStatus;
+    /** Raw metadata key-value pairs */
+    rawMetadata: Record<string, string>;
+}
+/**
+ * Result of attempting to recover a single session.
+ */
+export interface RecoveryResult {
+    /** Whether the operation succeeded */
+    success: boolean;
+    /** Session ID that was processed */
+    sessionId: SessionId;
+    /** Action that was taken */
+    action: RecoveryAction;
+    /** Recovered session object (only for 'recover' action) */
+    session?: Session;
+    /** Whether manual intervention is required */
+    requiresManualIntervention?: boolean;
+    reason?: string;
+    /** Error message if operation failed */
+    error?: string;
+}
+/**
+ * Summary report of a recovery operation.
+ */
+export interface RecoveryReport {
+    /** When the recovery was run */
+    timestamp: Date;
+    /** Total sessions scanned */
+    totalScanned: number;
+    /** Sessions that were recovered (live, restored to memory) */
+    recovered: SessionId[];
+    /** Sessions that were cleaned up (dead, resources removed) */
+    cleanedUp: SessionId[];
+    /** Sessions that require manual intervention */
+    escalated: SessionId[];
+    /** Sessions that were skipped (no action needed) */
+    skipped: SessionId[];
+    /** Errors encountered during recovery */
+    errors: Array<{
+        sessionId: SessionId;
+        error: string;
+    }>;
+    /** Time taken for recovery in milliseconds */
+    durationMs: number;
+}
+/**
+ * Entry in the recovery log.
+ */
+export interface RecoveryLogEntry {
+    /** ISO timestamp */
+    timestamp: string;
+    /** Session ID */
+    sessionId: SessionId;
+    /** Action taken */
+    action: "recovered" | "cleaned_up" | "escalated" | "skipped" | "error";
+    /** Previous status (for recovered sessions) */
+    previousStatus?: SessionStatus;
+    /** Reason for action (for cleanup/escalate) */
+    reason?: string;
+    /** Error message (for error action) */
+    error?: string;
+    /** Additional details */
+    details?: Record<string, unknown>;
+}
+/**
+ * Configuration for recovery behavior.
+ */
+export interface RecoveryConfig {
+    /** Enable automatic recovery on orchestrator startup */
+    enabled: boolean;
+    /** Maximum time for recovery phase in milliseconds */
+    timeoutMs: number;
+    /** Number of concurrent validation tasks */
+    parallelValidation: number;
+    /** Path to recovery log file */
+    logPath: string;
+    /** Automatically cleanup dead sessions */
+    autoCleanup: boolean;
+    /** Escalate partial sessions (vs. auto-cleanup) */
+    escalatePartial: boolean;
+    /** Maximum recovery attempts before escalating */
+    maxRecoveryAttempts: number;
+}
+/**
+ * Default recovery configuration.
+ */
+export declare const DEFAULT_RECOVERY_CONFIG: RecoveryConfig;
+/**
+ * Context passed to recovery functions.
+ */
+export interface RecoveryContext {
+    /** Root config path for the orchestrator */
+    configPath: string;
+    /** Recovery configuration */
+    recoveryConfig: RecoveryConfig;
+    /** Whether this is a dry run (no actual changes) */
+    dryRun: boolean;
+    /**
+     * Invoked after every metadata mutation performed by recovery actions
+     * (recover/cleanup/escalate). Callers that rely on SessionManager's
+     * listCached() cache should pass `sessionManager.invalidateCache` here
+     * so the dashboard sees recovery results immediately instead of waiting
+     * for the 35s TTL. Optional — omitted callers get a no-op.
+     */
+    invalidateCache?: () => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/recovery/types.d.ts.map

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

package/dist/recovery/validator.d.ts

@@ -0,0 +1,8 @@
+import { type OrchestratorConfig, type PluginRegistry, type SessionStatus } from "../types.js";
+import type { ScannedSession } from "./scanner.js";
+import { type RecoveryAssessment, type RecoveryClassification, type RecoveryAction, type RecoveryConfig } from "./types.js";
+export declare function validateSession(scanned: ScannedSession, config: OrchestratorConfig, registry: PluginRegistry, recoveryConfigInput?: Partial<RecoveryConfig>): Promise<RecoveryAssessment>;
+declare function classifySession(runtimeAlive: boolean, workspaceExists: boolean, agentProcessRunning: boolean, metadataStatus: SessionStatus, runtimeProbeSucceeded: boolean, processProbeSucceeded: boolean, hasRuntimeHandle: boolean): RecoveryClassification;
+declare function determineAction(classification: RecoveryClassification, _metadataStatus: SessionStatus, recoveryConfig: RecoveryConfig, recoveryRule: "auto" | "human" | "skip"): RecoveryAction;
+export { classifySession, determineAction };
+//# sourceMappingURL=validator.d.ts.map

package/dist/recovery/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/recovery/validator.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,kBAAkB,EACvB,KAAK,cAAc,EAKnB,KAAK,aAAa,EAGnB,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,cAAc,EACnB,KAAK,cAAc,EACpB,MAAM,YAAY,CAAC;AAepB,wBAAsB,eAAe,CACnC,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,kBAAkB,EAC1B,QAAQ,EAAE,cAAc,EACxB,mBAAmB,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAC5C,OAAO,CAAC,kBAAkB,CAAC,CA6J7B;AAED,iBAAS,eAAe,CACtB,YAAY,EAAE,OAAO,EACrB,eAAe,EAAE,OAAO,EACxB,mBAAmB,EAAE,OAAO,EAC5B,cAAc,EAAE,aAAa,EAC7B,qBAAqB,EAAE,OAAO,EAC9B,qBAAqB,EAAE,OAAO,EAC9B,gBAAgB,EAAE,OAAO,GACxB,sBAAsB,CA8BxB;AAwBD,iBAAS,eAAe,CACtB,cAAc,EAAE,sBAAsB,EACtC,eAAe,EAAE,aAAa,EAC9B,cAAc,EAAE,cAAc,EAC9B,YAAY,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,GACtC,cAAc,CAmBhB;AA+BD,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,CAAC"}

package/dist/report-watcher.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Report Watcher — Background trigger system for agent reports (#140)
+ *
+ * Monitors agent reports and triggers actions when anomalies are detected:
+ * - No acknowledge timeout: agent didn't acknowledge task after spawn
+ * - Stale report: agent hasn't reported in a while
+ * - Agent blocked: agent reported blocked/needs_input state
+ *
+ * This module is designed to be called from the lifecycle-manager polling loop.
+ */
+import type { Session } from "./types.js";
+import { type AgentReport } from "./agent-report.js";
+/**
+ * Report watcher trigger types.
+ */
+export type ReportWatcherTrigger = "no_acknowledge" | "stale_report" | "agent_needs_input";
+/**
+ * Result of a report audit check.
+ */
+export interface ReportAuditResult {
+    /** Which trigger was activated, if any. */
+    trigger: ReportWatcherTrigger | null;
+    /** Human-readable description of the finding. */
+    message: string;
+    /** ISO timestamp when the check was performed. */
+    checkedAt: string;
+    /** The agent report that was checked (if available). */
+    report: AgentReport | null;
+    /** Time since spawn in milliseconds. */
+    timeSinceSpawnMs?: number;
+    /** Time since last report in milliseconds. */
+    timeSinceReportMs?: number;
+}
+/**
+ * Configuration for report watcher thresholds.
+ */
+export interface ReportWatcherConfig {
+    /** Time after spawn before triggering no-acknowledge (default: 10 minutes). */
+    acknowledgeTimeoutMs: number;
+    /** Time without reports before triggering stale report (default: 30 minutes). */
+    staleReportTimeoutMs: number;
+    /** Whether to check for acknowledge timeout. */
+    checkAcknowledge: boolean;
+    /** Whether to check for stale reports. */
+    checkStale: boolean;
+    /** Whether to check for blocked agents. */
+    checkBlocked: boolean;
+}
+/**
+ * Default report watcher configuration.
+ */
+export declare const DEFAULT_REPORT_WATCHER_CONFIG: ReportWatcherConfig;
+/**
+ * Check if a session should be audited for report issues.
+ * Note: spawning sessions are included so acknowledge timeout can fire.
+ */
+export declare function shouldAuditSession(session: Session): boolean;
+/**
+ * Check for acknowledge timeout: agent didn't acknowledge task within threshold.
+ */
+export declare function checkAcknowledgeTimeout(session: Session, report: AgentReport | null, now: Date, config: ReportWatcherConfig): ReportAuditResult | null;
+/**
+ * Check for stale report: agent hasn't reported in a while.
+ */
+export declare function checkStaleReport(session: Session, report: AgentReport | null, now: Date, config: ReportWatcherConfig): ReportAuditResult | null;
+/**
+ * Check for blocked agent: agent reported blocked or needs_input state.
+ */
+export declare function checkBlockedAgent(_session: Session, report: AgentReport | null, now: Date, config: ReportWatcherConfig): ReportAuditResult | null;
+/**
+ * Audit a session's agent reports for issues.
+ * Returns the first triggered audit result, or null if no issues found.
+ */
+export declare function auditAgentReports(session: Session, config?: Partial<ReportWatcherConfig>, now?: Date): ReportAuditResult | null;
+/**
+ * Get the reaction key for a report watcher trigger.
+ * Used to look up the reaction configuration.
+ */
+export declare function getReactionKeyForTrigger(trigger: ReportWatcherTrigger): string;
+/**
+ * Metadata keys for storing report watcher flags.
+ */
+export declare const REPORT_WATCHER_METADATA_KEYS: {
+    /** ISO timestamp of last audit */
+    readonly LAST_AUDITED_AT: "reportWatcherLastAuditedAt";
+    /** Current active trigger (if any) */
+    readonly ACTIVE_TRIGGER: "reportWatcherActiveTrigger";
+    /** ISO timestamp when trigger was first activated */
+    readonly TRIGGER_ACTIVATED_AT: "reportWatcherTriggerActivatedAt";
+    /** Number of times this trigger has fired */
+    readonly TRIGGER_COUNT: "reportWatcherTriggerCount";
+};
+//# sourceMappingURL=report-watcher.d.ts.map

package/dist/report-watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-watcher.d.ts","sourceRoot":"","sources":["../src/report-watcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAiB,MAAM,YAAY,CAAC;AACzD,OAAO,EAAmB,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEtE;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAC5B,gBAAgB,GAChB,cAAc,GACd,mBAAmB,CAAC;AAExB;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,2CAA2C;IAC3C,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACrC,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IAC3B,wCAAwC;IACxC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,8CAA8C;IAC9C,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,+EAA+E;IAC/E,oBAAoB,EAAE,MAAM,CAAC;IAC7B,iFAAiF;IACjF,oBAAoB,EAAE,MAAM,CAAC;IAC7B,gDAAgD;IAChD,gBAAgB,EAAE,OAAO,CAAC;IAC1B,0CAA0C;IAC1C,UAAU,EAAE,OAAO,CAAC;IACpB,2CAA2C;IAC3C,YAAY,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,eAAO,MAAM,6BAA6B,EAAE,mBAM3C,CAAC;AAcF;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAW5D;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,WAAW,GAAG,IAAI,EAC1B,GAAG,EAAE,IAAI,EACT,MAAM,EAAE,mBAAmB,GAC1B,iBAAiB,GAAG,IAAI,CAuB1B;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,WAAW,GAAG,IAAI,EAC1B,GAAG,EAAE,IAAI,EACT,MAAM,EAAE,mBAAmB,GAC1B,iBAAiB,GAAG,IAAI,CAuB1B;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,OAAO,EACjB,MAAM,EAAE,WAAW,GAAG,IAAI,EAC1B,GAAG,EAAE,IAAI,EACT,MAAM,EAAE,mBAAmB,GAC1B,iBAAiB,GAAG,IAAI,CAqB1B;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,OAAO,EAChB,MAAM,GAAE,OAAO,CAAC,mBAAmB,CAAM,EACzC,GAAG,GAAE,IAAiB,GACrB,iBAAiB,GAAG,IAAI,CAuB1B;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM,CAS9E;AAED;;GAEG;AACH,eAAO,MAAM,4BAA4B;IACvC,kCAAkC;;IAElC,sCAAsC;;IAEtC,qDAAqD;;IAErD,6CAA6C;;CAErC,CAAC"}

package/dist/report-watcher.js

@@ -0,0 +1,182 @@
+import { readAgentReport } from './agent-report.js';
+
+/**
+ * Report Watcher — Background trigger system for agent reports (#140)
+ *
+ * Monitors agent reports and triggers actions when anomalies are detected:
+ * - No acknowledge timeout: agent didn't acknowledge task after spawn
+ * - Stale report: agent hasn't reported in a while
+ * - Agent blocked: agent reported blocked/needs_input state
+ *
+ * This module is designed to be called from the lifecycle-manager polling loop.
+ */
+/**
+ * Default report watcher configuration.
+ */
+const DEFAULT_REPORT_WATCHER_CONFIG = {
+    acknowledgeTimeoutMs: 10 * 60 * 1000, // 10 minutes
+    staleReportTimeoutMs: 30 * 60 * 1000, // 30 minutes
+    checkAcknowledge: true,
+    checkStale: true,
+    checkBlocked: true,
+};
+/**
+ * Terminal statuses that should not be audited.
+ */
+const TERMINAL_STATUSES = new Set([
+    "done",
+    "terminated",
+    "killed",
+    "cleanup",
+    "merged",
+    "errored",
+]);
+/**
+ * Check if a session should be audited for report issues.
+ * Note: spawning sessions are included so acknowledge timeout can fire.
+ */
+function shouldAuditSession(session) {
+    // Skip terminal sessions
+    if (TERMINAL_STATUSES.has(session.status)) {
+        return false;
+    }
+    // Skip orchestrator sessions
+    if (session.lifecycle?.session.kind === "orchestrator") {
+        return false;
+    }
+    // Note: spawning sessions are NOT skipped — they need acknowledge timeout checks
+    return true;
+}
+/**
+ * Check for acknowledge timeout: agent didn't acknowledge task within threshold.
+ */
+function checkAcknowledgeTimeout(session, report, now, config) {
+    if (!config.checkAcknowledge)
+        return null;
+    // If we have any report (acknowledge or otherwise), the agent responded
+    if (report)
+        return null;
+    // Check time since spawn
+    const createdAt = session.createdAt ?? session.metadata["createdAt"];
+    if (!createdAt)
+        return null;
+    const spawnTime = typeof createdAt === "string" ? Date.parse(createdAt) : createdAt.getTime();
+    if (Number.isNaN(spawnTime))
+        return null;
+    const timeSinceSpawn = now.getTime() - spawnTime;
+    if (timeSinceSpawn < config.acknowledgeTimeoutMs)
+        return null;
+    return {
+        trigger: "no_acknowledge",
+        message: `Agent has not acknowledged task after ${Math.round(timeSinceSpawn / 60000)} minutes`,
+        checkedAt: now.toISOString(),
+        report: null,
+        timeSinceSpawnMs: timeSinceSpawn,
+    };
+}
+/**
+ * Check for stale report: agent hasn't reported in a while.
+ */
+function checkStaleReport(session, report, now, config) {
+    if (!config.checkStale)
+        return null;
+    // If no report, the acknowledge check handles it
+    if (!report)
+        return null;
+    // Check if the report is stale
+    const reportTime = Date.parse(report.timestamp);
+    if (Number.isNaN(reportTime))
+        return null;
+    const timeSinceReport = now.getTime() - reportTime;
+    if (timeSinceReport < config.staleReportTimeoutMs)
+        return null;
+    // Don't flag as stale if agent is in a waiting state (that's expected)
+    if (report.state === "waiting" || report.state === "needs_input")
+        return null;
+    return {
+        trigger: "stale_report",
+        message: `Agent report is stale (${Math.round(timeSinceReport / 60000)} minutes since last report)`,
+        checkedAt: now.toISOString(),
+        report,
+        timeSinceReportMs: timeSinceReport,
+    };
+}
+/**
+ * Check for blocked agent: agent reported blocked or needs_input state.
+ */
+function checkBlockedAgent(_session, report, now, config) {
+    if (!config.checkBlocked)
+        return null;
+    // If no report, nothing to check
+    if (!report)
+        return null;
+    if (report.state === "needs_input") {
+        const reportTime = Date.parse(report.timestamp);
+        const timeSinceReportMs = Number.isNaN(reportTime) ? undefined : now.getTime() - reportTime;
+        return {
+            trigger: "agent_needs_input",
+            message: `Agent needs input: ${report.note ?? "waiting for user decision"}`,
+            checkedAt: now.toISOString(),
+            report,
+            timeSinceReportMs,
+        };
+    }
+    // Note: "blocked" is not in the current AGENT_REPORTED_STATES but we check for it
+    // in case it gets added or for forward compatibility
+    return null;
+}
+/**
+ * Audit a session's agent reports for issues.
+ * Returns the first triggered audit result, or null if no issues found.
+ */
+function auditAgentReports(session, config = {}, now = new Date()) {
+    if (!shouldAuditSession(session)) {
+        return null;
+    }
+    const fullConfig = {
+        ...DEFAULT_REPORT_WATCHER_CONFIG,
+        ...config,
+    };
+    const report = readAgentReport(session.metadata);
+    // Check in priority order: blocked > no_acknowledge > stale
+    const blockedResult = checkBlockedAgent(session, report, now, fullConfig);
+    if (blockedResult)
+        return blockedResult;
+    const acknowledgeResult = checkAcknowledgeTimeout(session, report, now, fullConfig);
+    if (acknowledgeResult)
+        return acknowledgeResult;
+    const staleResult = checkStaleReport(session, report, now, fullConfig);
+    if (staleResult)
+        return staleResult;
+    return null;
+}
+/**
+ * Get the reaction key for a report watcher trigger.
+ * Used to look up the reaction configuration.
+ */
+function getReactionKeyForTrigger(trigger) {
+    switch (trigger) {
+        case "no_acknowledge":
+            return "report-no-acknowledge";
+        case "stale_report":
+            return "report-stale";
+        case "agent_needs_input":
+            return "report-needs-input";
+    }
+}
+/**
+ * Metadata keys for storing report watcher flags.
+ */
+const REPORT_WATCHER_METADATA_KEYS = {
+    /** ISO timestamp of last audit */
+    LAST_AUDITED_AT: "reportWatcherLastAuditedAt",
+    /** Current active trigger (if any) */
+    ACTIVE_TRIGGER: "reportWatcherActiveTrigger",
+    /** ISO timestamp when trigger was first activated */
+    TRIGGER_ACTIVATED_AT: "reportWatcherTriggerActivatedAt",
+    /** Number of times this trigger has fired */
+    TRIGGER_COUNT: "reportWatcherTriggerCount",
+};
+
+export { DEFAULT_REPORT_WATCHER_CONFIG, REPORT_WATCHER_METADATA_KEYS, auditAgentReports, checkAcknowledgeTimeout, checkBlockedAgent, checkStaleReport, getReactionKeyForTrigger, shouldAuditSession };
+//# sourceMappingURL=report-watcher.js.map

package/dist/report-watcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-watcher.js","sources":["../src/report-watcher.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/scm-webhook-utils.d.ts

@@ -0,0 +1,6 @@
+import type { SCMWebhookRequest } from "./types.js";
+export declare function getWebhookHeader(headers: SCMWebhookRequest["headers"], name: string): string | undefined;
+export declare function parseWebhookJsonObject(body: string): Record<string, unknown>;
+export declare function parseWebhookTimestamp(value: unknown): Date | undefined;
+export declare function parseWebhookBranchRef(ref: unknown): string | undefined;
+//# sourceMappingURL=scm-webhook-utils.d.ts.map

package/dist/scm-webhook-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scm-webhook-utils.d.ts","sourceRoot":"","sources":["../src/scm-webhook-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,iBAAiB,CAAC,SAAS,CAAC,EACrC,IAAI,EAAE,MAAM,GACX,MAAM,GAAG,SAAS,CAQpB;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAM5E;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,CAItE;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAKtE"}

package/dist/scm-webhook-utils.js

@@ -0,0 +1,36 @@
+function getWebhookHeader(headers, name) {
+    const target = name.toLowerCase();
+    for (const [key, value] of Object.entries(headers)) {
+        if (key.toLowerCase() !== target)
+            continue;
+        if (Array.isArray(value))
+            return value[0];
+        return value;
+    }
+    return undefined;
+}
+function parseWebhookJsonObject(body) {
+    const parsed = JSON.parse(body);
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+        throw new Error("Webhook payload must be a JSON object");
+    }
+    return parsed;
+}
+function parseWebhookTimestamp(value) {
+    if (typeof value !== "string")
+        return undefined;
+    const date = new Date(value);
+    return Number.isNaN(date.getTime()) ? undefined : date;
+}
+function parseWebhookBranchRef(ref) {
+    if (typeof ref !== "string" || ref.length === 0)
+        return undefined;
+    if (ref.startsWith("refs/heads/"))
+        return ref.slice("refs/heads/".length);
+    if (ref.startsWith("refs/"))
+        return undefined;
+    return ref;
+}
+
+export { getWebhookHeader, parseWebhookBranchRef, parseWebhookJsonObject, parseWebhookTimestamp };
+//# sourceMappingURL=scm-webhook-utils.js.map

package/dist/scm-webhook-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scm-webhook-utils.js","sources":["../src/scm-webhook-utils.ts"],"sourcesContent":[null],"names":[],"mappings":"AAEM,SAAU,gBAAgB,CAC9B,OAAqC,EACrC,IAAY,EAAA;AAEZ,IAAA,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,EAAE;AACjC,IAAA,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;AAClD,QAAA,IAAI,GAAG,CAAC,WAAW,EAAE,KAAK,MAAM;YAAE;AAClC,QAAA,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;AAAE,YAAA,OAAO,KAAK,CAAC,CAAC,CAAC;AACzC,QAAA,OAAO,KAAK;IACd;AACA,IAAA,OAAO,SAAS;AAClB;AAEM,SAAU,sBAAsB,CAAC,IAAY,EAAA;IACjD,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;AACxC,IAAA,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE;AAClE,QAAA,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC;IAC1D;AACA,IAAA,OAAO,MAAiC;AAC1C;AAEM,SAAU,qBAAqB,CAAC,KAAc,EAAA;IAClD,IAAI,OAAO,KAAK,KAAK,QAAQ;AAAE,QAAA,OAAO,SAAS;AAC/C,IAAA,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC;AAC5B,IAAA,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,GAAG,SAAS,GAAG,IAAI;AACxD;AAEM,SAAU,qBAAqB,CAAC,GAAY,EAAA;IAChD,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;AAAE,QAAA,OAAO,SAAS;AACjE,IAAA,IAAI,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC;QAAE,OAAO,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC;AACzE,IAAA,IAAI,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC;AAAE,QAAA,OAAO,SAAS;AAC7C,IAAA,OAAO,GAAG;AACZ;;;;"}

package/dist/session-manager.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Session Manager — CRUD for agent sessions.
+ *
+ * Orchestrates Runtime, Agent, and Workspace plugins to:
+ * - Spawn new sessions (create workspace → create runtime → launch agent)
+ * - List sessions (from metadata + live runtime checks)
+ * - Kill sessions (agent → runtime → workspace cleanup)
+ * - Cleanup completed sessions (PR merged / issue closed)
+ * - Send messages to running sessions
+ *
+ * Reference: scripts/claude-ao-session, scripts/send-to-session
+ */
+import { type OpenCodeSessionManager, type OrchestratorConfig, type PluginRegistry } from "./types.js";
+/** Re-export so existing core test-utils + session-manager call sites keep working. */
+export declare function resetOpenCodeSessionListCache(): void;
+export interface SessionManagerDeps {
+    config: OrchestratorConfig;
+    registry: PluginRegistry;
+}
+/** Create a SessionManager instance. */
+export declare function createSessionManager(deps: SessionManagerDeps): OpenCodeSessionManager;
+//# sourceMappingURL=session-manager.d.ts.map

package/dist/session-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-manager.d.ts","sourceRoot":"","sources":["../src/session-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAQH,OAAO,EAQL,KAAK,sBAAsB,EAW3B,KAAK,kBAAkB,EAQvB,KAAK,cAAc,EAKpB,MAAM,YAAY,CAAC;AAoGpB,uFAAuF;AACvF,wBAAgB,6BAA6B,IAAI,IAAI,CAEpD;AA0ND,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,QAAQ,EAAE,cAAc,CAAC;CAC1B;AAED,wCAAwC;AACxC,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,kBAAkB,GAAG,sBAAsB,CAixGrF"}