@telora/daemon-core 0.2.5

package/dist/activity-tracker.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Activity tracker -- writes activity snapshots via a configurable flush callback.
+ *
+ * Maintains a local snapshot of what the agent is currently doing and flushes
+ * it via the provided callback. Uses dirty-checking (JSON.stringify comparison)
+ * to avoid redundant calls.
+ *
+ * Designed to be attached to a StreamJsonParser for a single agent session.
+ * Every flush is wrapped in try/catch -- a failed activity write must NEVER
+ * crash the process.
+ */
+import type { StreamJsonParser } from './stream-json.js';
+export interface ActivitySnapshot {
+    /** Name of the tool currently being invoked (e.g. "Edit", "Bash", "Read"). */
+    currentTool: string | null;
+    /** File path extracted from tool input, if any. */
+    currentFile: string | null;
+    /** Last text output from the assistant, truncated to 200 chars. */
+    lastText: string | null;
+    /** Number of completed turns (result events). */
+    turnCount: number;
+    /** Cumulative input + output tokens. */
+    totalTokens: number;
+    /** Cumulative cost in USD. */
+    totalCostUsd: number;
+    /** ISO timestamp of the last flush. */
+    updatedAt: string;
+}
+export declare class ActivityTracker {
+    private sessionId;
+    private snapshot;
+    private lastFlushedJson;
+    private flushInProgress;
+    private onNarrationCallback;
+    private flushCallback;
+    constructor(sessionId: string, flushCallback: (snapshot: ActivitySnapshot) => Promise<void>);
+    /**
+     * Set a callback for narration updates (called when lastText changes).
+     */
+    onNarration(callback: (text: string) => void): void;
+    /**
+     * Attach the tracker to a StreamJsonParser.
+     * Listens for assistant messages and result events.
+     */
+    attach(parser: StreamJsonParser): void;
+    /**
+     * Process an assistant message.
+     * - tool_use blocks: update currentTool/currentFile and flush immediately.
+     * - text blocks: update lastText (dirty, no immediate flush).
+     */
+    private handleAssistantMessage;
+    /**
+     * Process a result event.
+     * Increments turn count, updates token/cost totals, flushes.
+     */
+    private handleResult;
+    /**
+     * Final flush -- called when the session ends.
+     * Clears transient fields and writes one last snapshot.
+     */
+    finalFlush(): Promise<void>;
+    /**
+     * Write the current snapshot via the flush callback if it has changed.
+     * Dirty-checking via JSON.stringify comparison.
+     * Wrapped in try/catch -- failures are logged but never thrown.
+     */
+    private flush;
+}
+//# sourceMappingURL=activity-tracker.d.ts.map

package/dist/activity-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity-tracker.d.ts","sourceRoot":"","sources":["../src/activity-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAyE,MAAM,kBAAkB,CAAC;AAIhI,MAAM,WAAW,gBAAgB;IAC/B,8EAA8E;IAC9E,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,mDAAmD;IACnD,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,mEAAmE;IACnE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;CACnB;AA8BD,qBAAa,eAAe;IAC1B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAmB;IACnC,OAAO,CAAC,eAAe,CAAM;IAC7B,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,mBAAmB,CAAyC;IACpE,OAAO,CAAC,aAAa,CAAgD;gBAGnE,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC;IAe9D;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAInD;;;OAGG;IACH,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI;IAUtC;;;;OAIG;IACH,OAAO,CAAC,sBAAsB;IAwB9B;;;OAGG;IACH,OAAO,CAAC,YAAY;IAiBpB;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAMjC;;;;OAIG;YACW,KAAK;CAwBpB"}

package/dist/activity-tracker.js

@@ -0,0 +1,155 @@
+/**
+ * Activity tracker -- writes activity snapshots via a configurable flush callback.
+ *
+ * Maintains a local snapshot of what the agent is currently doing and flushes
+ * it via the provided callback. Uses dirty-checking (JSON.stringify comparison)
+ * to avoid redundant calls.
+ *
+ * Designed to be attached to a StreamJsonParser for a single agent session.
+ * Every flush is wrapped in try/catch -- a failed activity write must NEVER
+ * crash the process.
+ */
+// -- File path extraction -----------------------------------------------------
+/** Keys in tool input that commonly contain file paths. */
+const FILE_PATH_KEYS = ['file_path', 'path', 'command', 'notebook_path'];
+/**
+ * Extract a file path from tool input, if present.
+ * Checks common keys first, then falls back to scanning string values
+ * that look like absolute paths.
+ */
+function extractFilePath(input) {
+    // Check well-known keys first
+    for (const key of FILE_PATH_KEYS) {
+        const val = input[key];
+        if (typeof val === 'string' && val.length > 0) {
+            // For 'command' key, try to extract a path from the command string
+            if (key === 'command') {
+                const pathMatch = val.match(/(?:^|\s)(\/[^\s'"]+)/);
+                return pathMatch ? pathMatch[1] : null;
+            }
+            return val;
+        }
+    }
+    return null;
+}
+// -- Tracker class ------------------------------------------------------------
+export class ActivityTracker {
+    sessionId;
+    snapshot;
+    lastFlushedJson = '';
+    flushInProgress = false;
+    onNarrationCallback = null;
+    flushCallback;
+    constructor(sessionId, flushCallback) {
+        this.sessionId = sessionId;
+        this.flushCallback = flushCallback;
+        this.snapshot = {
+            currentTool: null,
+            currentFile: null,
+            lastText: null,
+            turnCount: 0,
+            totalTokens: 0,
+            totalCostUsd: 0,
+            updatedAt: new Date().toISOString(),
+        };
+    }
+    /**
+     * Set a callback for narration updates (called when lastText changes).
+     */
+    onNarration(callback) {
+        this.onNarrationCallback = callback;
+    }
+    /**
+     * Attach the tracker to a StreamJsonParser.
+     * Listens for assistant messages and result events.
+     */
+    attach(parser) {
+        parser.on('assistant', (msg) => {
+            this.handleAssistantMessage(msg);
+        });
+        parser.on('result', (result) => {
+            this.handleResult(result);
+        });
+    }
+    /**
+     * Process an assistant message.
+     * - tool_use blocks: update currentTool/currentFile and flush immediately.
+     * - text blocks: update lastText (dirty, no immediate flush).
+     */
+    handleAssistantMessage(msg) {
+        let hasToolUse = false;
+        for (const block of msg.message.content) {
+            if (block.type === 'tool_use') {
+                const toolBlock = block;
+                this.snapshot.currentTool = toolBlock.name;
+                this.snapshot.currentFile = extractFilePath(toolBlock.input);
+                hasToolUse = true;
+            }
+            else if (block.type === 'text') {
+                const textBlock = block;
+                if (textBlock.text.length > 0) {
+                    this.snapshot.lastText = textBlock.text.slice(0, 200);
+                    this.onNarrationCallback?.(this.snapshot.lastText);
+                }
+            }
+        }
+        // Flush immediately on tool_use to show real-time activity
+        if (hasToolUse) {
+            this.flush();
+        }
+    }
+    /**
+     * Process a result event.
+     * Increments turn count, updates token/cost totals, flushes.
+     */
+    handleResult(result) {
+        this.snapshot.turnCount++;
+        if (result.usage) {
+            this.snapshot.totalTokens += (result.usage.input_tokens ?? 0) + (result.usage.output_tokens ?? 0);
+        }
+        if (result.total_cost_usd) {
+            this.snapshot.totalCostUsd += result.total_cost_usd;
+        }
+        // Clear current tool/file since the turn is complete
+        this.snapshot.currentTool = null;
+        this.snapshot.currentFile = null;
+        this.flush();
+    }
+    /**
+     * Final flush -- called when the session ends.
+     * Clears transient fields and writes one last snapshot.
+     */
+    async finalFlush() {
+        this.snapshot.currentTool = null;
+        this.snapshot.currentFile = null;
+        await this.flush();
+    }
+    /**
+     * Write the current snapshot via the flush callback if it has changed.
+     * Dirty-checking via JSON.stringify comparison.
+     * Wrapped in try/catch -- failures are logged but never thrown.
+     */
+    async flush() {
+        // Avoid concurrent flushes stacking up
+        if (this.flushInProgress)
+            return;
+        this.snapshot.updatedAt = new Date().toISOString();
+        const json = JSON.stringify(this.snapshot);
+        // Skip if nothing changed
+        if (json === this.lastFlushedJson)
+            return;
+        this.flushInProgress = true;
+        try {
+            await this.flushCallback(this.snapshot);
+            this.lastFlushedJson = json;
+        }
+        catch (err) {
+            // Activity writes must NEVER crash the process
+            console.warn(`[activity-tracker] Failed to flush activity for session ${this.sessionId}:`, err.message);
+        }
+        finally {
+            this.flushInProgress = false;
+        }
+    }
+}
+//# sourceMappingURL=activity-tracker.js.map

package/dist/activity-tracker.js.map

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

package/dist/api-client.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Shared API client infrastructure for Telora engines.
+ *
+ * Provides a factory function that creates an API client bound to a config
+ * and a set of per-concern circuit breakers. Both the daemon and factory
+ * engines use this to communicate with the product-api edge function.
+ *
+ * The action-to-concern circuit breaker mapping stays engine-specific
+ * (daemon has 4 concerns, factory has 3). This module provides the
+ * factory function; each engine provides its own concern mapping.
+ */
+import type { z } from 'zod';
+import { CircuitBreaker } from './resilience.js';
+/**
+ * Minimal configuration required by the API client.
+ *
+ * Both DaemonConfig and FactoryConfig are supersets of this interface --
+ * they include additional engine-specific fields (repoPath, worktreeDir, etc.)
+ * but the API client only needs the Telora URL and tracker ID.
+ */
+export interface BaseApiConfig {
+    /** Base URL of the Telora instance (e.g., http://127.0.0.1:54321). */
+    teloraUrl: string;
+    /** Tracker ID used as the Bearer token for API authentication. */
+    trackerId: string;
+}
+/**
+ * The API client returned by `createApiClient`.
+ *
+ * Provides four methods:
+ * - `callApi`: retry + circuit breaker protected API call
+ * - `callApiValidated`: same as callApi but validates response with Zod
+ * - `callApiOnce`: single-attempt API call (no retry, no circuit breaker)
+ * - `validateTrackerAuth`: lightweight auth check at startup
+ */
+export interface ApiClient {
+    /**
+     * Call the product-api edge function with retry and circuit breaker protection.
+     *
+     * The action string is mapped to a circuit breaker concern via the
+     * engine-specific `actionToConcern` function provided at creation time.
+     */
+    callApi<T>(action: string, params?: Record<string, unknown>): Promise<T>;
+    /**
+     * Call the product-api edge function with retry, circuit breaker,
+     * and Zod schema validation on the response.
+     *
+     * On validation failure, throws an error with the action name and Zod issue details.
+     */
+    callApiValidated<T>(action: string, schema: z.ZodType<T>, params?: Record<string, unknown>): Promise<T>;
+    /**
+     * Single attempt to call the product-api edge function.
+     * No retry logic, no circuit breaker -- used directly when the caller
+     * manages its own retry/resilience strategy.
+     *
+     * Throws ApiError with retryability classification on failure.
+     */
+    callApiOnce<T>(action: string, params?: Record<string, unknown>): Promise<T>;
+    /**
+     * Validate the configured tracker auth by calling a lightweight API endpoint.
+     * Should be called at engine startup before starting any polling loops.
+     * Throws immediately with a clear error message if auth is invalid.
+     */
+    validateTrackerAuth(): Promise<void>;
+}
+/**
+ * Create an API client bound to a config and circuit breaker topology.
+ *
+ * @param config - Base API config with teloraUrl and trackerId
+ * @param breakerMap - Map of concern names to CircuitBreaker instances.
+ *   Each engine creates its own breakers with appropriate thresholds.
+ * @param actionToConcern - Function that maps an API action name to a
+ *   circuit breaker concern key. Must always return a valid key in breakerMap
+ *   (the engine provides fallback logic).
+ *
+ * @example
+ * ```ts
+ * // In daemon:
+ * const breakers = {
+ *   heartbeat: new CircuitBreaker({ ... }),
+ *   polling: new CircuitBreaker({ ... }),
+ *   activity: new CircuitBreaker({ ... }),
+ *   delivery: new CircuitBreaker({ ... }),
+ * };
+ *
+ * const client = createApiClient(
+ *   daemonConfig,
+ *   breakers,
+ *   (action) => actionMap[action] ?? 'delivery',
+ * );
+ * ```
+ */
+export declare function createApiClient(config: BaseApiConfig, breakerMap: Record<string, CircuitBreaker>, actionToConcern: (action: string) => string): ApiClient;
+//# sourceMappingURL=api-client.d.ts.map

package/dist/api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,EAA2C,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAM1F;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,sEAAsE;IACtE,SAAS,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD;;;;;;;;GAQG;AACH,MAAM,WAAW,SAAS;IACxB;;;;;OAKG;IACH,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAEzE;;;;;OAKG;IACH,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAExG;;;;;;OAMG;IACH,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAE7E;;;;OAIG;IACH,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACtC;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,aAAa,EACrB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,EAC1C,eAAe,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GAC1C,SAAS,CA2IX"}

package/dist/api-client.js

@@ -0,0 +1,145 @@
+/**
+ * Shared API client infrastructure for Telora engines.
+ *
+ * Provides a factory function that creates an API client bound to a config
+ * and a set of per-concern circuit breakers. Both the daemon and factory
+ * engines use this to communicate with the product-api edge function.
+ *
+ * The action-to-concern circuit breaker mapping stays engine-specific
+ * (daemon has 4 concerns, factory has 3). This module provides the
+ * factory function; each engine provides its own concern mapping.
+ */
+import { withRetry, ApiError, classifyHttpStatus } from './resilience.js';
+// ---------------------------------------------------------------------------
+// Factory function
+// ---------------------------------------------------------------------------
+/**
+ * Create an API client bound to a config and circuit breaker topology.
+ *
+ * @param config - Base API config with teloraUrl and trackerId
+ * @param breakerMap - Map of concern names to CircuitBreaker instances.
+ *   Each engine creates its own breakers with appropriate thresholds.
+ * @param actionToConcern - Function that maps an API action name to a
+ *   circuit breaker concern key. Must always return a valid key in breakerMap
+ *   (the engine provides fallback logic).
+ *
+ * @example
+ * ```ts
+ * // In daemon:
+ * const breakers = {
+ *   heartbeat: new CircuitBreaker({ ... }),
+ *   polling: new CircuitBreaker({ ... }),
+ *   activity: new CircuitBreaker({ ... }),
+ *   delivery: new CircuitBreaker({ ... }),
+ * };
+ *
+ * const client = createApiClient(
+ *   daemonConfig,
+ *   breakers,
+ *   (action) => actionMap[action] ?? 'delivery',
+ * );
+ * ```
+ */
+export function createApiClient(config, breakerMap, actionToConcern) {
+    /**
+     * Resolve the circuit breaker for a given API action.
+     */
+    function getCircuitBreakerForAction(action) {
+        const concern = actionToConcern(action);
+        return breakerMap[concern];
+    }
+    /**
+     * Single attempt to call the product-api edge function.
+     * Throws ApiError with retryability classification.
+     */
+    async function callApiOnceImpl(action, params = {}) {
+        const url = `${config.teloraUrl}/functions/v1/product-api`;
+        let response;
+        try {
+            response = await fetch(url, {
+                method: 'POST',
+                headers: {
+                    Authorization: `Bearer ${config.trackerId}`,
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify({ action, ...params }),
+            });
+        }
+        catch (error) {
+            // Network-level errors (ECONNRESET, timeout, etc.) -- always retryable
+            throw Object.assign(error, { isRetryable: true });
+        }
+        const data = (await response.json());
+        if (!response.ok || !data.success) {
+            const classification = classifyHttpStatus(response.status);
+            throw new ApiError(data.error || `API error (${response.status})`, response.status, classification === 'retryable');
+        }
+        return data;
+    }
+    /**
+     * Call the product-api edge function with tracker authentication.
+     * Includes retry with exponential backoff and circuit breaker protection.
+     */
+    async function callApiImpl(action, params = {}) {
+        const breaker = getCircuitBreakerForAction(action);
+        return breaker.execute(() => withRetry(() => callApiOnceImpl(action, params), { maxAttempts: 3, baseDelayMs: 1000, label: `callApi(${action})` }));
+    }
+    /**
+     * Call the product-api edge function and validate the response with a Zod schema.
+     *
+     * On validation failure, throws an error with the action name and Zod issue details.
+     * The existing retry/circuit breaker catches the thrown error.
+     */
+    async function callApiValidatedImpl(action, schema, params = {}) {
+        const raw = await callApiImpl(action, params);
+        const result = schema.safeParse(raw);
+        if (!result.success) {
+            const issues = result.error.issues
+                .map((i) => `${i.path.join('.')}: ${i.message}`)
+                .join('; ');
+            throw new Error(`API response validation failed for ${action}: ${issues}`);
+        }
+        return result.data;
+    }
+    /**
+     * Validate the configured tracker auth by calling a lightweight API endpoint.
+     * Should be called at engine startup before starting any polling loops.
+     * Throws immediately with a clear error message if auth is invalid.
+     */
+    async function validateTrackerAuthImpl() {
+        const url = `${config.teloraUrl}/functions/v1/product-api`;
+        let response;
+        try {
+            response = await fetch(url, {
+                method: 'POST',
+                headers: {
+                    Authorization: `Bearer ${config.trackerId}`,
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify({ action: 'daemon_heartbeat_ping' }),
+            });
+        }
+        catch (error) {
+            throw new Error(`Cannot reach Telora API at ${config.teloraUrl}: ${error.message}. ` +
+                `Check TELORA_URL and network connectivity.`);
+        }
+        if (response.status === 401 || response.status === 403) {
+            throw new Error(`Tracker authentication failed (HTTP ${response.status}). ` +
+                `The configured TELORA_TRACKER_ID may be invalid, expired, or revoked. ` +
+                `Check your tracker in Telora Settings > AI Work Trackers.`);
+        }
+        // Any other non-server error is also a problem at startup
+        // (but 404 for the ping action is fine -- it means auth passed but action doesn't exist)
+        if (response.status >= 500) {
+            throw new Error(`Telora API returned server error (HTTP ${response.status}) during auth validation. ` +
+                `The service may be temporarily unavailable. Retry in a few minutes.`);
+        }
+    }
+    return {
+        callApi: callApiImpl,
+        callApiValidated: callApiValidatedImpl,
+        callApiOnce: callApiOnceImpl,
+        validateTrackerAuth: validateTrackerAuthImpl,
+    };
+}
+//# sourceMappingURL=api-client.js.map

package/dist/api-client.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Shared configuration infrastructure for Telora daemon and factory engines.
+ *
+ * Provides:
+ * - BaseConfig interface with fields common to both DaemonConfig and FactoryConfig
+ * - Generic config file loader (JSON from disk)
+ * - Base config resolver (env vars over file config)
+ * - Base config validator (collects errors without throwing)
+ *
+ * Each engine imports these and layers its own fields on top.
+ */
+/** Regex for UUID v1-v8 (loose check). */
+export declare const UUID_REGEX: RegExp;
+/**
+ * A single product entry in the multi-product configuration.
+ * Each entry scopes the daemon to one product + git repository.
+ */
+export interface ProductEntry {
+    /** Product UUID from Telora. */
+    id: string;
+    /** Absolute path to the product's git repository. */
+    repoPath: string;
+}
+/**
+ * Derive a short human-readable label for a product entry.
+ * Uses the basename of the product's repoPath (e.g., "/home/user/repos/telora" → "telora").
+ * Falls back to an 8-char ID slice if repoPath is empty.
+ */
+export declare function productLabel(product: ProductEntry): string;
+/**
+ * Configuration fields shared by both DaemonConfig and FactoryConfig.
+ *
+ * These are the fields that appear in both engine configs with compatible
+ * types and semantics. Engine-specific fields (e.g. worktreeDir, integrationBranch,
+ * factoryWorktreeDir, maxConcurrentInstances) belong in each engine's own config.
+ */
+export interface BaseConfig {
+    /** Telora API base URL (e.g. http://127.0.0.1:54321). */
+    teloraUrl: string;
+    /** Tracker ID for authentication. */
+    trackerId: string;
+    /** Organization UUID. */
+    organizationId: string;
+    /**
+     * Product UUID -- scopes this engine to a single product.
+     * @deprecated Use `products` array for multi-product support. Kept for
+     * backward compatibility and env-var override (TELORA_PRODUCT_ID).
+     * When `products` is set, this is the ID of the first product.
+     */
+    productId: string;
+    /**
+     * Absolute path to the git repository.
+     * @deprecated Use `products` array for multi-product support. Kept for
+     * backward compatibility and env-var override (TELORA_REPO_PATH).
+     * When `products` is set, this is the repoPath of the first product.
+     */
+    repoPath: string;
+    /**
+     * Multi-product configuration. Each entry maps a product UUID to a git
+     * repository path. The daemon iterates all products for polling and execution.
+     * Always populated at runtime -- single-product configs are normalized to
+     * a single-entry array.
+     */
+    products: ProductEntry[];
+    /** Path (or command name) for the Claude Code executable. */
+    claudeCodePath: string;
+    /** Directory for log files. */
+    logDir: string;
+    /** Session timeout in milliseconds. */
+    sessionTimeoutMs: number;
+    /** Optional path to MCP config file, or null if unset. */
+    mcpConfigPath: string | null;
+}
+/**
+ * Load a JSON config file from disk.
+ *
+ * Search order (when no explicit configPath):
+ * 1. ~/.telora/{defaultFilename} (global config, multi-product)
+ * 2. .telora/{defaultFilename} in cwd (repo-local, legacy)
+ *
+ * @param configPath  Explicit path to a config file, or undefined to use defaults.
+ * @param defaultFilename  Filename to look for inside `.telora/` (e.g. `daemon.json`).
+ * @returns Parsed JSON object, or an empty object if no config file is found.
+ * @throws If an explicit configPath is provided but the file does not exist,
+ *         or if the file cannot be parsed as JSON.
+ */
+export declare function loadConfigFile(configPath: string | undefined, defaultFilename: string): Record<string, unknown>;
+/**
+ * Resolve BaseConfig fields from a combination of file config and environment
+ * variables. Environment variables take priority over file config values.
+ *
+ * Returns a Partial<BaseConfig> so each engine can merge it with its own
+ * engine-specific fields. Fields that are not set in either source are omitted.
+ *
+ * Multi-product resolution:
+ * 1. If `products` array exists in config file, use it directly
+ * 2. If TELORA_PRODUCT_ID + TELORA_REPO_PATH env vars are set, they produce
+ *    a single-entry products array (useful for CI/testing)
+ * 3. If only legacy `productId` + `repoPath` in config, normalize to products array
+ * 4. `productId` and `repoPath` on the result always reflect the first product
+ *
+ * @param fileConfig  Parsed JSON from the config file (keys are camelCase field names).
+ * @param envOverrides  Environment variables -- typically pass `process.env`.
+ */
+export declare function resolveBaseConfig(fileConfig: Record<string, unknown>, envOverrides: Record<string, string | undefined>): Partial<BaseConfig>;
+/**
+ * Validate the shared BaseConfig fields.
+ *
+ * Returns an array of human-readable error messages (never throws).
+ * Engines should call this, then append their own engine-specific validation
+ * errors before deciding whether to throw.
+ *
+ * @param config  Partial base config to validate. Missing required fields
+ *                are reported as errors.
+ */
+export declare function validateBaseConfig(config: Partial<BaseConfig>): string[];
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAUH,0CAA0C;AAC1C,eAAO,MAAM,UAAU,QAAoE,CAAC;AAM5F;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,gCAAgC;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,qDAAqD;IACrD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAM1D;AAMD;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACzB,yDAAyD;IACzD,SAAS,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,yBAAyB;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB;;;;;OAKG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,6DAA6D;IAC7D,cAAc,EAAE,MAAM,CAAC;IACvB,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,gBAAgB,EAAE,MAAM,CAAC;IACzB,0DAA0D;IAC1D,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAMD;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAC5B,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,eAAe,EAAE,MAAM,GACtB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAgCzB;AA+FD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAC/C,OAAO,CAAC,UAAU,CAAC,CAqDrB;AAwDD;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,MAAM,EAAE,CA2ExE"}