oh-my-claude-sisyphus 3.6.3 → 3.7.2

package/dist/hooks/setup/index.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Setup Hook Module
+ *
+ * Handles OMC initialization and maintenance tasks.
+ * Triggers:
+ * - init: Create directory structure, validate configs, set environment
+ * - maintenance: Prune old state files, cleanup orphaned state, vacuum SQLite
+ */
+export interface SetupInput {
+    session_id: string;
+    transcript_path: string;
+    cwd: string;
+    permission_mode: string;
+    hook_event_name: 'Setup';
+    trigger: 'init' | 'maintenance';
+}
+export interface SetupResult {
+    directories_created: string[];
+    configs_validated: string[];
+    errors: string[];
+    env_vars_set: string[];
+}
+export interface HookOutput {
+    continue: boolean;
+    hookSpecificOutput: {
+        hookEventName: 'Setup';
+        additionalContext: string;
+    };
+}
+/**
+ * Ensure all required directories exist
+ */
+export declare function ensureDirectoryStructure(directory: string): string[];
+/**
+ * Validate that config files exist and are readable
+ */
+export declare function validateConfigFiles(directory: string): string[];
+/**
+ * Set environment variables for OMC initialization
+ */
+export declare function setEnvironmentVariables(): string[];
+/**
+ * Process setup init trigger
+ */
+export declare function processSetupInit(input: SetupInput): Promise<HookOutput>;
+/**
+ * Prune old state files from .omc/state directory
+ */
+export declare function pruneOldStateFiles(directory: string, maxAgeDays?: number): number;
+/**
+ * Clean up orphaned state files (state files without corresponding active sessions)
+ */
+export declare function cleanupOrphanedState(directory: string): number;
+/**
+ * Run VACUUM on swarm SQLite database if it exists
+ */
+export declare function vacuumSwarmDb(directory: string): boolean;
+/**
+ * Process setup maintenance trigger
+ */
+export declare function processSetupMaintenance(input: SetupInput): Promise<HookOutput>;
+/**
+ * Process setup hook based on trigger type
+ */
+export declare function processSetup(input: SetupInput): Promise<HookOutput>;
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/setup/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/setup/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,OAAO,CAAC;IACzB,OAAO,EAAE,MAAM,GAAG,aAAa,CAAC;CACjC;AAED,MAAM,WAAW,WAAW;IAC1B,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,OAAO,CAAC;IAClB,kBAAkB,EAAE;QAClB,aAAa,EAAE,OAAO,CAAC;QACvB,iBAAiB,EAAE,MAAM,CAAC;KAC3B,CAAC;CACH;AAwBD;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAgBpE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAiB/D;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,EAAE,CAgBlD;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAsC7E;AAMD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,GAAE,MAAmC,GAAG,MAAM,CAgD7G;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAsC9D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAsBxD;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CA6CpF;AAMD;;GAEG;AACH,wBAAsB,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAczE"}

package/dist/hooks/setup/index.js

@@ -0,0 +1,299 @@
+/**
+ * Setup Hook Module
+ *
+ * Handles OMC initialization and maintenance tasks.
+ * Triggers:
+ * - init: Create directory structure, validate configs, set environment
+ * - maintenance: Prune old state files, cleanup orphaned state, vacuum SQLite
+ */
+import { existsSync, mkdirSync, readdirSync, statSync, unlinkSync, readFileSync } from 'fs';
+import { join } from 'path';
+import { execSync } from 'child_process';
+// ============================================================================
+// Constants
+// ============================================================================
+const REQUIRED_DIRECTORIES = [
+    '.omc/state',
+    '.omc/logs',
+    '.omc/notepads',
+    '.omc/state/checkpoints',
+    '.omc/plans',
+];
+const CONFIG_FILES = [
+    '.omc-config.json',
+];
+const DEFAULT_STATE_MAX_AGE_DAYS = 7;
+// ============================================================================
+// Init Functions
+// ============================================================================
+/**
+ * Ensure all required directories exist
+ */
+export function ensureDirectoryStructure(directory) {
+    const created = [];
+    for (const dir of REQUIRED_DIRECTORIES) {
+        const fullPath = join(directory, dir);
+        if (!existsSync(fullPath)) {
+            try {
+                mkdirSync(fullPath, { recursive: true });
+                created.push(fullPath);
+            }
+            catch (err) {
+                // Will be reported in errors
+            }
+        }
+    }
+    return created;
+}
+/**
+ * Validate that config files exist and are readable
+ */
+export function validateConfigFiles(directory) {
+    const validated = [];
+    for (const configFile of CONFIG_FILES) {
+        const fullPath = join(directory, configFile);
+        if (existsSync(fullPath)) {
+            try {
+                // Try to read to ensure it's valid
+                readFileSync(fullPath, 'utf-8');
+                validated.push(fullPath);
+            }
+            catch {
+                // Silently skip if unreadable
+            }
+        }
+    }
+    return validated;
+}
+/**
+ * Set environment variables for OMC initialization
+ */
+export function setEnvironmentVariables() {
+    const envVars = [];
+    // Check if CLAUDE_ENV_FILE is available
+    if (process.env.CLAUDE_ENV_FILE) {
+        try {
+            const envContent = `export OMC_INITIALIZED=true\n`;
+            const { appendFileSync } = require('fs');
+            appendFileSync(process.env.CLAUDE_ENV_FILE, envContent);
+            envVars.push('OMC_INITIALIZED');
+        }
+        catch {
+            // Silently fail if can't write
+        }
+    }
+    return envVars;
+}
+/**
+ * Process setup init trigger
+ */
+export async function processSetupInit(input) {
+    const result = {
+        directories_created: [],
+        configs_validated: [],
+        errors: [],
+        env_vars_set: [],
+    };
+    try {
+        // Create directory structure
+        result.directories_created = ensureDirectoryStructure(input.cwd);
+        // Validate config files
+        result.configs_validated = validateConfigFiles(input.cwd);
+        // Set environment variables
+        result.env_vars_set = setEnvironmentVariables();
+    }
+    catch (err) {
+        result.errors.push(err instanceof Error ? err.message : String(err));
+    }
+    const context = [
+        `OMC initialized:`,
+        `- ${result.directories_created.length} directories created`,
+        `- ${result.configs_validated.length} configs validated`,
+        result.env_vars_set.length > 0 ? `- Environment variables set: ${result.env_vars_set.join(', ')}` : null,
+        result.errors.length > 0 ? `- Errors: ${result.errors.length}` : null,
+    ]
+        .filter(Boolean)
+        .join('\n');
+    return {
+        continue: true,
+        hookSpecificOutput: {
+            hookEventName: 'Setup',
+            additionalContext: context,
+        },
+    };
+}
+// ============================================================================
+// Maintenance Functions
+// ============================================================================
+/**
+ * Prune old state files from .omc/state directory
+ */
+export function pruneOldStateFiles(directory, maxAgeDays = DEFAULT_STATE_MAX_AGE_DAYS) {
+    const stateDir = join(directory, '.omc/state');
+    if (!existsSync(stateDir)) {
+        return 0;
+    }
+    const cutoffTime = Date.now() - maxAgeDays * 24 * 60 * 60 * 1000;
+    let deletedCount = 0;
+    try {
+        const files = readdirSync(stateDir);
+        for (const file of files) {
+            const filePath = join(stateDir, file);
+            try {
+                const stats = statSync(filePath);
+                // Skip directories
+                if (stats.isDirectory()) {
+                    continue;
+                }
+                // Check file age
+                if (stats.mtimeMs < cutoffTime) {
+                    // Skip certain critical state files
+                    if (file === 'autopilot-state.json' ||
+                        file === 'ultrapilot-state.json' ||
+                        file === 'ralph-state.json' ||
+                        file === 'ultrawork-state.json' ||
+                        file === 'swarm-state.json') {
+                        continue;
+                    }
+                    unlinkSync(filePath);
+                    deletedCount++;
+                }
+            }
+            catch {
+                // Skip files we can't read/delete
+            }
+        }
+    }
+    catch {
+        // Directory doesn't exist or can't be read
+    }
+    return deletedCount;
+}
+/**
+ * Clean up orphaned state files (state files without corresponding active sessions)
+ */
+export function cleanupOrphanedState(directory) {
+    const stateDir = join(directory, '.omc/state');
+    if (!existsSync(stateDir)) {
+        return 0;
+    }
+    let cleanedCount = 0;
+    try {
+        const files = readdirSync(stateDir);
+        // Look for session-specific state files (pattern: *-session-*.json)
+        const sessionFilePattern = /-session-[a-f0-9-]+\.json$/;
+        for (const file of files) {
+            if (sessionFilePattern.test(file)) {
+                const filePath = join(stateDir, file);
+                try {
+                    // Check if file is older than 24 hours (likely orphaned)
+                    const stats = statSync(filePath);
+                    const fileAge = Date.now() - stats.mtimeMs;
+                    const oneDayMs = 24 * 60 * 60 * 1000;
+                    if (fileAge > oneDayMs) {
+                        unlinkSync(filePath);
+                        cleanedCount++;
+                    }
+                }
+                catch {
+                    // Skip files we can't access
+                }
+            }
+        }
+    }
+    catch {
+        // Directory doesn't exist or can't be read
+    }
+    return cleanedCount;
+}
+/**
+ * Run VACUUM on swarm SQLite database if it exists
+ */
+export function vacuumSwarmDb(directory) {
+    const swarmDbPath = join(directory, '.omc/state/swarm.db');
+    if (!existsSync(swarmDbPath)) {
+        return false; // Database doesn't exist
+    }
+    try {
+        // Check if sqlite3 is available
+        execSync('which sqlite3', { stdio: 'pipe' });
+        // Run VACUUM
+        execSync(`sqlite3 "${swarmDbPath}" "VACUUM;"`, {
+            stdio: 'pipe',
+            timeout: 5000, // 5 second timeout
+        });
+        return true;
+    }
+    catch {
+        // sqlite3 not available or vacuum failed
+        return false;
+    }
+}
+/**
+ * Process setup maintenance trigger
+ */
+export async function processSetupMaintenance(input) {
+    const result = {
+        directories_created: [],
+        configs_validated: [],
+        errors: [],
+        env_vars_set: [],
+    };
+    let prunedFiles = 0;
+    let orphanedCleaned = 0;
+    let dbVacuumed = false;
+    try {
+        // Prune old state files
+        prunedFiles = pruneOldStateFiles(input.cwd, DEFAULT_STATE_MAX_AGE_DAYS);
+        // Cleanup orphaned state
+        orphanedCleaned = cleanupOrphanedState(input.cwd);
+        // Vacuum swarm database
+        dbVacuumed = vacuumSwarmDb(input.cwd);
+    }
+    catch (err) {
+        result.errors.push(err instanceof Error ? err.message : String(err));
+    }
+    const context = [
+        `OMC maintenance completed:`,
+        prunedFiles > 0 ? `- ${prunedFiles} old state files pruned` : null,
+        orphanedCleaned > 0 ? `- ${orphanedCleaned} orphaned state files cleaned` : null,
+        dbVacuumed ? `- Swarm database vacuumed` : null,
+        result.errors.length > 0 ? `- Errors: ${result.errors.length}` : null,
+        prunedFiles === 0 && orphanedCleaned === 0 && !dbVacuumed && result.errors.length === 0
+            ? '- No maintenance needed'
+            : null,
+    ]
+        .filter(Boolean)
+        .join('\n');
+    return {
+        continue: true,
+        hookSpecificOutput: {
+            hookEventName: 'Setup',
+            additionalContext: context,
+        },
+    };
+}
+// ============================================================================
+// Main Entry Point
+// ============================================================================
+/**
+ * Process setup hook based on trigger type
+ */
+export async function processSetup(input) {
+    if (input.trigger === 'init') {
+        return processSetupInit(input);
+    }
+    else if (input.trigger === 'maintenance') {
+        return processSetupMaintenance(input);
+    }
+    else {
+        return {
+            continue: true,
+            hookSpecificOutput: {
+                hookEventName: 'Setup',
+                additionalContext: `Unknown trigger: ${input.trigger}`,
+            },
+        };
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/hooks/setup/index.js.map

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

package/dist/hooks/setup/types.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Setup Hook Types
+ */
+export interface SetupInput {
+    session_id: string;
+    transcript_path: string;
+    cwd: string;
+    permission_mode: string;
+    hook_event_name: 'Setup';
+    trigger: 'init' | 'maintenance';
+}
+export interface SetupResult {
+    directories_created: string[];
+    configs_validated: string[];
+    errors: string[];
+    env_vars_set: string[];
+}
+export interface HookOutput {
+    continue: boolean;
+    hookSpecificOutput: {
+        hookEventName: 'Setup';
+        additionalContext: string;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/hooks/setup/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/hooks/setup/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,OAAO,CAAC;IACzB,OAAO,EAAE,MAAM,GAAG,aAAa,CAAC;CACjC;AAED,MAAM,WAAW,WAAW;IAC1B,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,OAAO,CAAC;IAClB,kBAAkB,EAAE;QAClB,aAAa,EAAE,OAAO,CAAC;QACvB,iBAAiB,EAAE,MAAM,CAAC;KAC3B,CAAC;CACH"}

package/dist/hooks/setup/types.js

@@ -0,0 +1,5 @@
+/**
+ * Setup Hook Types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/hooks/setup/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/hooks/setup/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/hooks/subagent-tracker/index.d.ts

@@ -1,83 +1,122 @@
 /**
- * Subagent Tracker Hook
+ * Subagent Tracker Hook Module
  *
- * Tracks SubagentStart and SubagentStop events to maintain state of active agents.
- * Useful for monitoring parallel execution in ultrapilot, swarm, and other multi-agent modes.
+ * Tracks SubagentStart and SubagentStop events for comprehensive agent monitoring.
+ * Features:
+ * - Track all spawned agents with parent mode context
+ * - Detect stuck/stale agents (>5 min without progress)
+ * - HUD integration for agent status display
+ * - Automatic cleanup of orphaned agent state
  */
 export interface SubagentInfo {
     agent_id: string;
     agent_type: string;
     started_at: string;
-    parent_mode?: string;
+    parent_mode: string;
     task_description?: string;
     file_ownership?: string[];
-}
-export interface CompletedSubagentInfo {
-    agent_id: string;
-    agent_type: string;
-    duration_ms: number;
-    success: boolean;
+    status: 'running' | 'completed' | 'failed';
+    completed_at?: string;
+    duration_ms?: number;
     output_summary?: string;
 }
 export interface SubagentTrackingState {
-    active_agents: Record<string, SubagentInfo>;
-    completed_agents: Record<string, CompletedSubagentInfo>;
+    agents: SubagentInfo[];
     total_spawned: number;
     total_completed: number;
+    total_failed: number;
+    last_updated: string;
 }
 export interface SubagentStartInput {
     session_id: string;
     transcript_path: string;
     cwd: string;
+    permission_mode: string;
     hook_event_name: 'SubagentStart';
     agent_id: string;
     agent_type: string;
+    prompt?: string;
+    model?: string;
 }
 export interface SubagentStopInput {
     session_id: string;
     transcript_path: string;
     cwd: string;
+    permission_mode: string;
     hook_event_name: 'SubagentStop';
-    stop_hook_active: boolean;
     agent_id: string;
-    agent_transcript_path: string;
+    agent_type: string;
+    output?: string;
+    success: boolean;
 }
 export interface HookOutput {
-    status: 'success' | 'error';
-    message?: string;
-    data?: unknown;
+    continue: boolean;
+    hookSpecificOutput?: {
+        hookEventName: string;
+        additionalContext?: string;
+        agent_count?: number;
+        stale_agents?: string[];
+    };
 }
 /**
- * Get the path to the subagent tracking state file.
+ * Get the state file path
  */
 export declare function getStateFilePath(directory: string): string;
 /**
- * Read the current subagent tracking state.
+ * Read tracking state from file
  */
-export declare function readTrackingState(directory: string): SubagentTrackingState | null;
+export declare function readTrackingState(directory: string): SubagentTrackingState;
 /**
- * Write subagent tracking state to disk.
+ * Write tracking state to file
  */
 export declare function writeTrackingState(directory: string, state: SubagentTrackingState): void;
 /**
- * Process SubagentStart event - track new agent spawn.
+ * Get list of stale agents (running for too long)
+ */
+export declare function getStaleAgents(state: SubagentTrackingState): SubagentInfo[];
+/**
+ * Process SubagentStart event
  */
 export declare function processSubagentStart(input: SubagentStartInput): HookOutput;
 /**
- * Process SubagentStop event - mark agent as completed.
+ * Process SubagentStop event
  */
 export declare function processSubagentStop(input: SubagentStopInput): HookOutput;
 /**
- * Remove agents that have been active for longer than maxAgeMs.
- * Useful for cleaning up stale agents that may have crashed.
+ * Cleanup stale agents (mark as failed)
  */
-export declare function cleanupStaleAgents(directory: string, maxAgeMs?: number): void;
+export declare function cleanupStaleAgents(directory: string): number;
 /**
- * Get the count of currently active agents.
+ * Get count of active (running) agents
  */
 export declare function getActiveAgentCount(directory: string): number;
 /**
- * Get a count of agents by type (both active and completed).
+ * Get agents by type
+ */
+export declare function getAgentsByType(directory: string, agentType: string): SubagentInfo[];
+/**
+ * Get all running agents
+ */
+export declare function getRunningAgents(directory: string): SubagentInfo[];
+/**
+ * Get tracking stats
+ */
+export declare function getTrackingStats(directory: string): {
+    running: number;
+    completed: number;
+    failed: number;
+    total: number;
+};
+/**
+ * Handle SubagentStart hook
+ */
+export declare function handleSubagentStart(input: SubagentStartInput): Promise<HookOutput>;
+/**
+ * Handle SubagentStop hook
+ */
+export declare function handleSubagentStop(input: SubagentStopInput): Promise<HookOutput>;
+/**
+ * Clear all tracking state (for testing or cleanup)
  */
-export declare function getAgentsByType(directory: string): Record<string, number>;
+export declare function clearTrackingState(directory: string): void;
 //# sourceMappingURL=index.d.ts.map

package/dist/hooks/subagent-tracker/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/subagent-tracker/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,qBAAqB;IACpC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC5C,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IACxD,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,eAAe,EAAE,eAAe,CAAC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,eAAe,EAAE,cAAc,CAAC;IAChC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAMD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,qBAAqB,GAAG,IAAI,CAcjF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,qBAAqB,GAC3B,IAAI,CAaN;AAwBD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,kBAAkB,GAAG,UAAU,CA4B1E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,iBAAiB,GAAG,UAAU,CAgDxE;AAMD;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,QAAQ,GAAE,MAAe,GACxB,IAAI,CAkCN;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAQ7D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAoBzE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/subagent-tracker/index.ts"],"names":[],"mappings":"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"}