@telora/daemon 0.12.33

package/dist/guard-evaluator.js

@@ -0,0 +1,193 @@
+/**
+ * Core condition tree evaluation logic for the guard engine.
+ *
+ * Contains the main evaluateGuardConditionTree function that traverses
+ * AND/OR/NOT trees and dispatches to leaf condition evaluators, plus the
+ * high-level guard evaluation orchestrator (evaluateGuardsAtTransition).
+ *
+ * Extracted from guard-engine.ts to improve maintainability.
+ */
+import { buildEvaluationContext } from './evaluation-context.js';
+import { evaluateLeafCondition } from './condition-evaluators.js';
+import { fetchTransitionGuards, createTransitionEvaluation, } from './queries/guards.js';
+import { withRetry } from '@telora/daemon-core';
+// ============================================
+// Guard Evaluation Error
+// ============================================
+/**
+ * Error thrown when guard evaluation fails.
+ * Carries the fetched guards (if available) so callers can determine
+ * failure mode based on enforcement levels.
+ */
+export class GuardEvaluationError extends Error {
+    cause;
+    fetchedGuards;
+    constructor(message, cause, 
+    /** Guards that were successfully fetched before the error, if any. */
+    fetchedGuards) {
+        super(message);
+        this.cause = cause;
+        this.fetchedGuards = fetchedGuards;
+        this.name = 'GuardEvaluationError';
+    }
+    /** Whether any fetched guard has hard enforcement. */
+    get hasHardEnforcementGuards() {
+        return this.fetchedGuards?.some(g => g.enforcement === 'hard') ?? false;
+    }
+    /** Names of fetched guards (for error messages). */
+    get guardNames() {
+        return this.fetchedGuards?.map(g => g.name) ?? [];
+    }
+}
+// ============================================
+// Condition Tree Evaluator
+// ============================================
+/**
+ * Evaluate a single condition tree node recursively.
+ *
+ * Accumulates leaf evaluation results into `details` and uses
+ * `nodeCounter` (passed by reference as a wrapper) to assign stable IDs.
+ * Extracted from evaluateGuardConditionTree to eliminate mutable closure state.
+ */
+function evaluateConditionNode(node, ctx, details, nodeCounter) {
+    const children = node.children ?? [];
+    if (children.length > 0) {
+        // Group node -- evaluate children with this node's logical operator
+        const operator = node.logical_operator ?? 'AND';
+        const childResults = children.map(child => evaluateConditionNode(child, ctx, details, nodeCounter));
+        return operator === 'AND'
+            ? childResults.every(r => r)
+            : childResults.some(r => r);
+    }
+    // Leaf node -- evaluate the condition and record the result
+    const nodeId = `cond-${nodeCounter.value++}`;
+    const evalResult = evaluateLeafCondition(node, nodeId, ctx);
+    details.push(evalResult);
+    return evalResult.passed;
+}
+/**
+ * Evaluate a JSONB condition tree for a guard.
+ *
+ * The JSONB tree uses nested children arrays rather than
+ * parent_condition_id references. Root-level nodes are combined
+ * with AND by default.
+ */
+export function evaluateGuardConditionTree(conditions, ctx) {
+    if (conditions.length === 0) {
+        return { passed: true, details: [] };
+    }
+    const details = [];
+    const nodeCounter = { value: 0 };
+    const rootResults = conditions.map(node => evaluateConditionNode(node, ctx, details, nodeCounter));
+    const passed = rootResults.every(r => r);
+    return { passed, details };
+}
+// ============================================
+// Guard Evaluation Orchestrator
+// ============================================
+/**
+ * Evaluate all guards at a workflow transition.
+ *
+ * Returns a TransitionGuardResult indicating whether the transition
+ * should proceed and what triggers need to be executed.
+ */
+export async function evaluateGuardsAtTransition(deliveryId, organizationId, transitionId, lastExitCode) {
+    let guards;
+    let triggers;
+    try {
+        const resolved = await withRetry(() => fetchTransitionGuards(transitionId), { label: 'guard-fetch' });
+        guards = resolved.guards;
+        triggers = resolved.triggers;
+    }
+    catch (err) {
+        throw new GuardEvaluationError(`Failed to fetch guards: ${err.message}`, err, null);
+    }
+    if (guards.length === 0) {
+        // No guards -- collect on_enter triggers and proceed
+        const enterTriggers = triggers.filter(t => t.trigger_event === 'on_enter');
+        return {
+            should_proceed: true,
+            evaluations: [],
+            triggers_to_execute: enterTriggers.map(t => ({ trigger: t, guard: null, eval_result: null })),
+            warnings: [],
+            blocks: [],
+        };
+    }
+    let ctx;
+    try {
+        ctx = await withRetry(() => buildEvaluationContext(deliveryId, lastExitCode), { label: 'guard-context' });
+    }
+    catch (err) {
+        throw new GuardEvaluationError(`Failed to build evaluation context: ${err.message}`, err, guards);
+    }
+    // Evaluate each guard's conditions
+    const evaluations = [];
+    const triggersToExecute = [];
+    const warnings = [];
+    const blocks = [];
+    for (const guard of guards) {
+        const { passed, details } = evaluateGuardConditionTree(guard.conditions, ctx);
+        const evalResult = {
+            guard_id: guard.id,
+            guard_name: guard.name,
+            enforcement: guard.enforcement,
+            passed,
+            condition_details: details,
+        };
+        evaluations.push(evalResult);
+        if (!passed) {
+            // Collect on_guard_fail triggers for this guard
+            const failTriggers = triggers.filter(t => t.trigger_event === 'on_guard_fail');
+            for (const trigger of failTriggers) {
+                triggersToExecute.push({ trigger, guard, eval_result: evalResult });
+            }
+            if (guard.enforcement === 'hard') {
+                blocks.push(evalResult);
+            }
+            else {
+                warnings.push(evalResult);
+            }
+        }
+        else {
+            // Collect on_guard_pass triggers
+            const passTriggers = triggers.filter(t => t.trigger_event === 'on_guard_pass');
+            for (const trigger of passTriggers) {
+                triggersToExecute.push({ trigger, guard, eval_result: evalResult });
+            }
+        }
+        // Record evaluation in audit trail
+        const evaluationRecord = {
+            organization_id: organizationId,
+            entity_type: 'delivery',
+            entity_id: deliveryId,
+            transition_id: transitionId,
+            guard_id: guard.id,
+            result: passed ? 'passed' : 'failed',
+            blocked: !passed && guard.enforcement === 'hard',
+            enforcement_level: guard.enforcement,
+            evaluation_details: { conditions: details },
+        };
+        try {
+            await createTransitionEvaluation(evaluationRecord);
+        }
+        catch (err) {
+            console.warn(`Failed to record guard evaluation for "${guard.name}":`, err.message);
+        }
+    }
+    // Collect on_enter triggers if proceeding
+    const shouldProceed = blocks.length === 0;
+    if (shouldProceed) {
+        const enterTriggers = triggers.filter(t => t.trigger_event === 'on_enter');
+        for (const trigger of enterTriggers) {
+            triggersToExecute.push({ trigger, guard: null, eval_result: null });
+        }
+    }
+    return {
+        should_proceed: shouldProceed,
+        evaluations,
+        triggers_to_execute: triggersToExecute,
+        warnings,
+        blocks,
+    };
+}
+//# sourceMappingURL=guard-evaluator.js.map

package/dist/guard-evaluator.js.map

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

package/dist/heartbeat.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Heartbeat module — periodically reports daemon presence and work status to Telora.
+ *
+ * Sends an initial heartbeat on startup, then every HEARTBEAT_INTERVAL_MS.
+ * On shutdown, sends a disconnect signal (best-effort).
+ *
+ * Counters are bootstrapped from the DB on startup so the heartbeat
+ * reflects cumulative history rather than resetting to zero.
+ *
+ * Also provides activity tracking and event loop watchdog metrics
+ * for stuck daemon detection.
+ */
+import type { DaemonConfig } from './types.js';
+/**
+ * Update the narration for a strategy. Called by ActivityTracker callback.
+ */
+export declare function setNarration(strategyId: string, text: string): void;
+/**
+ * Clear narration for a strategy (called when team shuts down).
+ */
+export declare function clearNarration(strategyId: string): void;
+/**
+ * Record daemon activity. Call this whenever meaningful work occurs
+ * (spawning agents, completing sessions, polling, merges, etc.).
+ */
+export declare function recordActivity(): void;
+/**
+ * Get the last activity timestamp (for diagnostics/testing).
+ */
+export declare function getLastActivityAt(): Date;
+/**
+ * Get the current event loop lag (p99) in milliseconds and reset the histogram.
+ */
+export declare function getEventLoopLagMs(): number;
+/**
+ * Initialize the heartbeat module.
+ * Bootstraps counters from the DB (single query, graceful fallback).
+ * Initializes event loop monitoring.
+ */
+export declare function initHeartbeat(daemonConfig: DaemonConfig): Promise<void>;
+/**
+ * Get the current daemon and factory versions (loaded at init time).
+ */
+export declare function getVersions(): {
+    daemon: string;
+    factory: string;
+};
+/**
+ * Store the latest available version from the npm registry.
+ * Called by the version check module after a successful registry query.
+ */
+export declare function setLatestAvailableVersion(version: string): void;
+/**
+ * Store the latest available factory version from the npm registry.
+ */
+export declare function setLatestAvailableFactoryVersion(version: string): void;
+/**
+ * Record a completed session (called by spawner when an agent finishes).
+ */
+export declare function recordSessionCompleted(tokens: number, cost: number): void;
+/**
+ * Record a completed issue (called when an issue transitions to Done).
+ */
+export declare function recordIssueCompleted(): void;
+/**
+ * Start sending periodic heartbeats. Sends one immediately.
+ */
+export declare function startHeartbeat(): Promise<void>;
+/**
+ * Stop heartbeats and send a disconnect signal (best-effort).
+ */
+export declare function stopHeartbeat(): Promise<void>;
+//# sourceMappingURL=heartbeat.d.ts.map

package/dist/heartbeat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat.d.ts","sourceRoot":"","sources":["../src/heartbeat.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAQH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AA4B/C;;GAEG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAEnE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAEvD;AAMD;;;GAGG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAErC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAmBD;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAM1C;AAyFD;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ7E;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAEjE;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE/D;AAED;;GAEG;AACH,wBAAgB,gCAAgC,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEtE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAIzE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C;AA0ED;;GAEG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAcpD;AAED;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAanD"}

package/dist/heartbeat.js

@@ -0,0 +1,306 @@
+/**
+ * Heartbeat module — periodically reports daemon presence and work status to Telora.
+ *
+ * Sends an initial heartbeat on startup, then every HEARTBEAT_INTERVAL_MS.
+ * On shutdown, sends a disconnect signal (best-effort).
+ *
+ * Counters are bootstrapped from the DB on startup so the heartbeat
+ * reflects cumulative history rather than resetting to zero.
+ *
+ * Also provides activity tracking and event loop watchdog metrics
+ * for stuck daemon detection.
+ */
+import { readFileSync } from 'node:fs';
+import { hostname as osHostname } from 'node:os';
+import { join, dirname, basename } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { monitorEventLoopDelay } from 'node:perf_hooks';
+import { sendHeartbeat, sendDisconnect, getCompletedSessionAggregates } from './supabase.js';
+import { getRunningAgents } from './spawner.js';
+import { safeInterval } from '@telora/daemon-core';
+import { computeBranchStatus } from './branch-status.js';
+const HEARTBEAT_INTERVAL_MS = 60_000; // 60 seconds
+const INACTIVITY_THRESHOLD_MS = 600_000; // 10 minutes
+const EVENT_LOOP_LAG_WARNING_MS = 30_000; // 30 seconds
+let config = null;
+let heartbeatInterval = null;
+let completedSessionCount = 0;
+let completedIssueCount = 0;
+let totalTokensUsed = 0;
+let totalCost = 0;
+let daemonVersion = 'unknown';
+let factoryVersion = 'unknown';
+let daemonCommitSha = 'unknown';
+let latestAvailableVersion = null;
+let latestAvailableFactoryVersion = null;
+const daemonStartedAt = new Date().toISOString();
+// ── Narration store (in-memory only) ─────────────────────────────────
+/** Strategy ID -> latest narration text from team lead. */
+const narrations = new Map();
+/**
+ * Update the narration for a strategy. Called by ActivityTracker callback.
+ */
+export function setNarration(strategyId, text) {
+    narrations.set(strategyId, text);
+}
+/**
+ * Clear narration for a strategy (called when team shuts down).
+ */
+export function clearNarration(strategyId) {
+    narrations.delete(strategyId);
+}
+// ── Activity tracking ────────────────────────────────────────────────
+let lastActivityAt = new Date();
+/**
+ * Record daemon activity. Call this whenever meaningful work occurs
+ * (spawning agents, completing sessions, polling, merges, etc.).
+ */
+export function recordActivity() {
+    lastActivityAt = new Date();
+}
+/**
+ * Get the last activity timestamp (for diagnostics/testing).
+ */
+export function getLastActivityAt() {
+    return lastActivityAt;
+}
+// ── Event loop watchdog ──────────────────────────────────────────────
+let eventLoopHistogram = null;
+/**
+ * Initialize the event loop delay monitor.
+ * Uses perf_hooks.monitorEventLoopDelay() for passive, low-overhead measurement.
+ */
+function initEventLoopMonitor() {
+    try {
+        eventLoopHistogram = monitorEventLoopDelay({ resolution: 20 });
+        eventLoopHistogram.enable();
+    }
+    catch {
+        console.warn('Event loop delay monitoring not available on this runtime');
+    }
+}
+/**
+ * Get the current event loop lag (p99) in milliseconds and reset the histogram.
+ */
+export function getEventLoopLagMs() {
+    if (!eventLoopHistogram)
+        return 0;
+    // Histogram values are in nanoseconds
+    const p99Ns = eventLoopHistogram.percentile(99);
+    eventLoopHistogram.reset();
+    return Math.round(p99Ns / 1_000_000); // Convert ns to ms
+}
+/**
+ * Check event loop lag and log a warning if it exceeds the threshold.
+ */
+function checkEventLoopLag(lagMs) {
+    if (lagMs > EVENT_LOOP_LAG_WARNING_MS) {
+        console.error(`[watchdog] CRITICAL: Event loop lag ${lagMs}ms exceeds ${EVENT_LOOP_LAG_WARNING_MS}ms threshold. ` +
+            `The daemon may have been blocked. Stack: ${new Error().stack}`);
+    }
+}
+/**
+ * Load daemon version from package.json and commit SHA from build-info.json.
+ */
+function loadVersionInfo() {
+    let version = 'unknown';
+    let factoryVer = 'unknown';
+    let sha = 'unknown';
+    const thisDir = dirname(fileURLToPath(import.meta.url));
+    try {
+        const pkgPath = join(thisDir, '..', 'package.json');
+        const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+        version = pkg.version || 'unknown';
+    }
+    catch (e) {
+        console.debug('[heartbeat] Failed to load daemon version from package.json:', e.message);
+    }
+    try {
+        const factoryPkgPath = join(thisDir, '..', 'node_modules', '@telora', 'factory', 'package.json');
+        const factoryPkg = JSON.parse(readFileSync(factoryPkgPath, 'utf-8'));
+        factoryVer = factoryPkg.version || 'unknown';
+    }
+    catch (e) {
+        console.debug('[heartbeat] Failed to load factory version:', e.message);
+    }
+    try {
+        const buildInfoPath = join(thisDir, '..', 'build-info.json');
+        const buildInfo = JSON.parse(readFileSync(buildInfoPath, 'utf-8'));
+        sha = buildInfo.commitSha || 'unknown';
+    }
+    catch {
+        // build-info.json not present in dev — only stamped at publish time
+    }
+    return { version, factoryVer, commitSha: sha };
+}
+/**
+ * Bootstrap counters from the database.
+ *
+ * Queries completed session aggregates for this product so the heartbeat
+ * starts with cumulative totals instead of zero. Falls back gracefully
+ * to zero on any error.
+ */
+async function bootstrapCountersFromDb(daemonConfig) {
+    try {
+        // Aggregate across all configured products
+        let totalCompleted = 0;
+        let totalTokens = 0;
+        let totalCostAgg = 0;
+        for (const product of daemonConfig.products) {
+            const aggregates = await getCompletedSessionAggregates(product.id);
+            totalCompleted += aggregates.completedCount;
+            totalTokens += aggregates.totalTokens;
+            totalCostAgg += aggregates.totalCost;
+        }
+        completedSessionCount = totalCompleted;
+        totalTokensUsed = totalTokens;
+        totalCost = totalCostAgg;
+        console.log(`Bootstrapped heartbeat counters from DB (${daemonConfig.products.length} products): ` +
+            `${completedSessionCount} sessions, ` +
+            `${totalTokensUsed} tokens, ` +
+            `$${totalCost.toFixed(2)} cost`);
+    }
+    catch (err) {
+        console.warn(`Failed to bootstrap heartbeat counters from DB (starting at zero): ` +
+            `${err.message}`);
+        // Counters remain at 0 — same as previous behavior
+    }
+}
+/**
+ * Initialize the heartbeat module.
+ * Bootstraps counters from the DB (single query, graceful fallback).
+ * Initializes event loop monitoring.
+ */
+export async function initHeartbeat(daemonConfig) {
+    config = daemonConfig;
+    const info = loadVersionInfo();
+    daemonVersion = info.version;
+    factoryVersion = info.factoryVer;
+    daemonCommitSha = info.commitSha;
+    await bootstrapCountersFromDb(daemonConfig);
+    initEventLoopMonitor();
+}
+/**
+ * Get the current daemon and factory versions (loaded at init time).
+ */
+export function getVersions() {
+    return { daemon: daemonVersion, factory: factoryVersion };
+}
+/**
+ * Store the latest available version from the npm registry.
+ * Called by the version check module after a successful registry query.
+ */
+export function setLatestAvailableVersion(version) {
+    latestAvailableVersion = version;
+}
+/**
+ * Store the latest available factory version from the npm registry.
+ */
+export function setLatestAvailableFactoryVersion(version) {
+    latestAvailableFactoryVersion = version;
+}
+/**
+ * Record a completed session (called by spawner when an agent finishes).
+ */
+export function recordSessionCompleted(tokens, cost) {
+    completedSessionCount++;
+    totalTokensUsed += tokens;
+    totalCost += cost;
+}
+/**
+ * Record a completed issue (called when an issue transitions to Done).
+ */
+export function recordIssueCompleted() {
+    completedIssueCount++;
+}
+/**
+ * Gather current counters and send a heartbeat.
+ */
+async function doHeartbeat() {
+    if (!config)
+        return;
+    const runningAgents = getRunningAgents();
+    // Event loop watchdog: measure and check lag
+    const eventLoopLagMs = getEventLoopLagMs();
+    checkEventLoopLag(eventLoopLagMs);
+    // Inactivity detection: warn if no activity for 10+ minutes
+    const inactivityMs = Date.now() - lastActivityAt.getTime();
+    if (inactivityMs > INACTIVITY_THRESHOLD_MS) {
+        console.warn(`[watchdog] Daemon inactive for ${Math.round(inactivityMs / 1000)}s. ` +
+            `Running agents: ${runningAgents.size}. ` +
+            `Last activity: ${lastActivityAt.toISOString()}`);
+    }
+    // Build metadata with version observability fields
+    const metadata = {};
+    if (daemonCommitSha !== 'unknown') {
+        metadata.commitSha = daemonCommitSha;
+    }
+    if (factoryVersion !== 'unknown') {
+        metadata.factoryVersion = factoryVersion;
+    }
+    if (latestAvailableVersion) {
+        metadata.latestAvailableVersion = latestAvailableVersion;
+    }
+    if (latestAvailableFactoryVersion) {
+        metadata.latestAvailableFactoryVersion = latestAvailableFactoryVersion;
+    }
+    try {
+        metadata.branchStatus = computeBranchStatus(config);
+    }
+    catch { /* non-fatal */ }
+    if (narrations.size > 0) {
+        metadata.narrations = Object.fromEntries(narrations);
+    }
+    try {
+        await sendHeartbeat(process.pid, osHostname(), basename(config.repoPath), daemonVersion, {
+            activeSessions: runningAgents.size,
+            completedSessions: completedSessionCount,
+            plannedIssues: 0, // Could be enriched later by querying ready deliveries
+            inProgressIssues: runningAgents.size,
+            completedIssues: completedIssueCount,
+            totalTokensUsed,
+            totalCost,
+            daemonStartedAt,
+            lastActivityAt: lastActivityAt.toISOString(),
+            eventLoopLagMs,
+            productId: config.productId,
+            productIds: config.products.map(p => p.id),
+        }, Object.keys(metadata).length > 0 ? metadata : undefined);
+    }
+    catch (error) {
+        console.error('Heartbeat failed:', error.message);
+    }
+}
+/**
+ * Start sending periodic heartbeats. Sends one immediately.
+ */
+export async function startHeartbeat() {
+    if (!config) {
+        throw new Error('Heartbeat not initialized. Call initHeartbeat first.');
+    }
+    // Send initial heartbeat immediately
+    await doHeartbeat();
+    // Start periodic heartbeats with error boundary
+    heartbeatInterval = safeInterval(() => {
+        return doHeartbeat();
+    }, HEARTBEAT_INTERVAL_MS, 'heartbeat');
+    console.log(`Started heartbeat (every ${HEARTBEAT_INTERVAL_MS / 1000}s)`);
+}
+/**
+ * Stop heartbeats and send a disconnect signal (best-effort).
+ */
+export async function stopHeartbeat() {
+    if (heartbeatInterval) {
+        clearInterval(heartbeatInterval);
+        heartbeatInterval = null;
+    }
+    // Best-effort disconnect — don't block shutdown
+    try {
+        await sendDisconnect(process.pid);
+        console.log('Sent disconnect signal');
+    }
+    catch (error) {
+        console.error('Failed to send disconnect (non-fatal):', error.message);
+    }
+}
+//# sourceMappingURL=heartbeat.js.map

package/dist/heartbeat.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+/**
+ * Telora Unified Daemon CLI
+ *
+ * Lifecycle management for the Telora daemon process.
+ *
+ * Usage:
+ *   telora-daemon start                # Start daemon in background
+ *   telora-daemon start --foreground   # Start daemon in foreground
+ *   telora-daemon stop                 # Graceful shutdown
+ *   telora-daemon restart              # Stop + start
+ *   telora-daemon status               # Report health and status
+ *   telora-daemon logs                 # Show recent daemon logs
+ *   telora-daemon logs --follow        # Tail daemon log output
+ *   telora-daemon init                 # Interactive setup wizard
+ *   telora-daemon check-update         # Check for newer version
+ *   telora-daemon run                  # Run in foreground (low-level)
+ *
+ * Environment Variables:
+ *   TELORA_URL                 - Telora API URL
+ *   TELORA_TRACKER_ID          - Tracker ID for authentication (required)
+ *   TELORA_ORGANIZATION_ID     - Organization to watch
+ *   TELORA_REPO_PATH           - Path to git repository (default: cwd)
+ *   CLAUDE_CODE_PATH           - Path to claude executable (default: 'claude')
+ *   MCP_CONFIG_PATH            - Path to MCP config file (optional)
+ *   TELORA_LOG_DIR             - Directory for agent logs
+ *   MAX_TOTAL_SESSIONS         - Max concurrent strategy agents (default: 5)
+ *   SESSION_TIMEOUT_MS         - Session timeout in ms (default: 3600000)
+ *   TELORA_MAX_GLOBAL_SESSIONS - Global concurrency limit across all engines
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG"}