@viewportai/daemon 0.1.0

package/dist/server/ws-server.js

@@ -0,0 +1,290 @@
+/**
+ * WebSocket server — real-time protocol for monitoring and controlling sessions.
+ *
+ * Implements the Viewport wire protocol (plan/03_protocol.md):
+ * - hello, launch, kill, prompt, respond-permission
+ * - subscribe/unsubscribe with reconnect replay via ring buffer
+ * - session-update with sequence numbers
+ * - rollback, branch-retry, squash-merge
+ * - ack responses for all client commands
+ */
+import { logger } from '../core/logger.js';
+import { RingBuffer } from './ring-buffer.js';
+import { RateLimiter } from './rate-limiter.js';
+import { IncomingMessageSchema } from './ws-protocol.js';
+import { sendHello } from './hello-builder.js';
+import { ViewportError } from '../core/errors.js';
+import { createWsCommandHandlers } from './ws-command-handlers.js';
+import { metrics } from '../core/metrics.js';
+import { registerWsDaemonEventBridge } from './ws-daemon-event-bridge.js';
+import { extractTokenFromRequest } from './auth.js';
+import { isHostAllowed, isOriginAllowed } from './security.js';
+import { ErrorCodes } from '../core/error-codes.js';
+import { resolveMaxWsClients } from './ws-limits.js';
+const log = logger.child({ module: 'ws-server' });
+const MAX_WS_MESSAGE_BYTES = 1_048_576;
+const MAX_CLIENT_PENDING_BYTES = 4 * 1_048_576;
+const COMMAND_TIMEOUT_MS = 60_000;
+export function registerWsServer(app, daemon, registry, wsOptions) {
+    const hookRouter = wsOptions?.hookRouter;
+    const supervision = wsOptions?.supervision;
+    const auth = wsOptions?.auth;
+    const securityProfile = wsOptions?.securityProfile;
+    const ringBuffers = new Map();
+    const clients = new Set();
+    const rateLimiter = new RateLimiter();
+    let clientIdCounter = 0;
+    const maxWsClients = resolveMaxWsClients(wsOptions?.maxClients);
+    // Streaming state tracking: per-session flag for whether chunks are flowing
+    const sessionStreaming = new Map();
+    // Backpressure: drop non-critical updates for slow clients
+    const HIGH_WATERMARK_BYTES = 1024 * 1024;
+    function getOrCreateBuffer(sessionId) {
+        let buffer = ringBuffers.get(sessionId);
+        if (!buffer) {
+            buffer = new RingBuffer();
+            ringBuffers.set(sessionId, buffer);
+        }
+        return buffer;
+    }
+    function broadcastUpdate(sessionId, update) {
+        const buffer = getOrCreateBuffer(sessionId);
+        const entry = buffer.push(sessionId, update);
+        const msg = JSON.stringify({
+            type: 'session-update',
+            sessionId,
+            seq: entry.seq,
+            update,
+        });
+        const isDroppable = update.updateType === 'agent-thought-chunk' || update.updateType === 'agent-message-chunk';
+        for (const client of clients) {
+            if (client.subscriptions.has(sessionId)) {
+                if (isDroppable && client.pendingBytes > HIGH_WATERMARK_BYTES) {
+                    log.debug({ sessionId, pendingBytes: client.pendingBytes }, 'Dropping chunk for slow client');
+                    continue;
+                }
+                client.send(msg);
+            }
+        }
+        metrics.increment('ws.updates.broadcast');
+    }
+    function sendAck(client, requestId, status, error, extra) {
+        if (!requestId)
+            return;
+        const msg = { type: 'ack', requestId, status };
+        if (error)
+            msg.error = error;
+        if (extra)
+            Object.assign(msg, extra);
+        client.send(JSON.stringify(msg));
+    }
+    const cleanupBridge = registerWsDaemonEventBridge({
+        daemon,
+        registry,
+        clients,
+        ringBuffers,
+        sessionStreaming,
+        broadcastUpdate,
+        hookRouter,
+        supervision,
+    });
+    // ---------------------------------------------------------------------------
+    // Message handlers + dispatch
+    // ---------------------------------------------------------------------------
+    const handlers = createWsCommandHandlers({
+        daemon,
+        hookRouter,
+        supervision,
+        sendAck,
+        getOrCreateBuffer,
+    });
+    async function handleMessage(client, msg) {
+        try {
+            const handler = handlers[msg.type];
+            await withTimeout(handler(client, msg), COMMAND_TIMEOUT_MS);
+        }
+        catch (err) {
+            log.error({ type: msg.type, err }, 'WS handler error');
+            if (isTimeoutError(err)) {
+                metrics.increment('ws.messages.handler_timeout');
+            }
+            const errorCode = err instanceof ViewportError ? err.code : 'INTERNAL_ERROR';
+            const effectiveErrorCode = isTimeoutError(err) ? ErrorCodes.COMMAND_TIMEOUT : errorCode;
+            sendAck(client, msg.requestId, 'error', err instanceof Error ? err.message : 'Unknown error', { errorCode: effectiveErrorCode });
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // WebSocket route
+    // ---------------------------------------------------------------------------
+    app.get('/ws', { websocket: true }, async (socketRaw, request) => {
+        const socket = socketRaw;
+        if (clients.size >= maxWsClients) {
+            metrics.increment('ws.connections.rejected.max_clients');
+            socket.terminate();
+            return;
+        }
+        if (securityProfile) {
+            const hostHeader = request.headers.host;
+            const originHeader = typeof request.headers.origin === 'string' ? request.headers.origin : undefined;
+            const hostAllowed = isHostAllowed(hostHeader, securityProfile);
+            const originAllowed = isOriginAllowed(originHeader, securityProfile);
+            if (!hostAllowed || !originAllowed) {
+                metrics.increment('ws.connections.rejected.security_profile');
+                socket.terminate();
+                return;
+            }
+        }
+        if (auth) {
+            const token = extractTokenFromRequest({
+                authorization: typeof request.headers.authorization === 'string'
+                    ? request.headers.authorization
+                    : undefined,
+                url: request.url,
+                allowQueryToken: true,
+            });
+            if (!token || !(await auth.validate(token))) {
+                metrics.increment('ws.connections.rejected.unauthorized');
+                socket.terminate();
+                return;
+            }
+        }
+        const clientId = String(++clientIdCounter);
+        const client = {
+            send: (data) => {
+                try {
+                    if (client.pendingBytes > MAX_CLIENT_PENDING_BYTES) {
+                        log.warn({ clientId, pendingBytes: client.pendingBytes }, 'Terminating slow client due to sustained backpressure');
+                        socket.terminate();
+                        return;
+                    }
+                    const bytes = Buffer.byteLength(data);
+                    if (bytes > MAX_WS_MESSAGE_BYTES) {
+                        metrics.increment('ws.messages.rejected_outbound_too_large');
+                        log.warn({ clientId, bytes, limit: MAX_WS_MESSAGE_BYTES }, 'Dropping oversized outbound WS payload');
+                        return;
+                    }
+                    client.pendingBytes += bytes;
+                    socket.send(data, () => {
+                        client.pendingBytes -= bytes;
+                    });
+                }
+                catch (err) {
+                    log.debug({ clientId, err }, 'WS send failed (client may have disconnected)');
+                }
+            },
+            subscriptions: new Set(),
+            watchedDiscoveredSessions: new Set(),
+            pendingBytes: 0,
+        };
+        clients.add(client);
+        metrics.increment('ws.connections.total');
+        metrics.gauge('ws.clients.connected', clients.size);
+        sendHello(client, daemon, registry);
+        // Keepalive: ping every 30s, terminate if pong not received
+        let alive = true;
+        const pingInterval = setInterval(() => {
+            if (!alive) {
+                log.debug({ clientId }, 'Client failed pong — terminating');
+                socket.terminate();
+                return;
+            }
+            alive = false;
+            socket.ping();
+        }, 30_000);
+        socket.on('pong', () => {
+            alive = true;
+        });
+        socket.on('message', async (raw) => {
+            const rawSize = typeof raw === 'string' ? Buffer.byteLength(raw) : raw.length;
+            metrics.increment('ws.messages.received');
+            metrics.gauge('ws.last_message_bytes', rawSize);
+            if (rawSize > MAX_WS_MESSAGE_BYTES) {
+                metrics.increment('ws.messages.rejected_too_large');
+                client.send(JSON.stringify({
+                    type: 'ack',
+                    status: 'error',
+                    error: `Payload exceeds ${MAX_WS_MESSAGE_BYTES} byte limit`,
+                    errorCode: ErrorCodes.PAYLOAD_TOO_LARGE,
+                }));
+                return;
+            }
+            let parsed;
+            try {
+                parsed = JSON.parse(typeof raw === 'string' ? raw : raw.toString('utf-8'));
+            }
+            catch {
+                metrics.increment('ws.messages.invalid_json');
+                client.send(JSON.stringify({
+                    type: 'ack',
+                    status: 'error',
+                    error: 'Invalid JSON',
+                    errorCode: ErrorCodes.INVALID_JSON,
+                }));
+                return;
+            }
+            if (parsed &&
+                typeof parsed === 'object' &&
+                typeof parsed['type'] === 'string' &&
+                typeof parsed['requestId'] !== 'string') {
+                metrics.increment('ws.messages.missing_request_id');
+                client.send(JSON.stringify({
+                    type: 'ack',
+                    status: 'error',
+                    error: 'Missing required requestId',
+                    errorCode: ErrorCodes.MISSING_REQUEST_ID,
+                }));
+                return;
+            }
+            const result = IncomingMessageSchema.safeParse(parsed);
+            if (!result.success) {
+                metrics.increment('ws.messages.invalid_schema');
+                const reqId = parsed?.requestId;
+                sendAck(client, typeof reqId === 'string' ? reqId : undefined, 'error', `Invalid message: ${result.error.issues[0]?.message ?? 'validation failed'}`, { errorCode: ErrorCodes.INVALID_MESSAGE });
+                return;
+            }
+            // Rate limit check
+            if (!rateLimiter.check(clientId, result.data.type)) {
+                metrics.increment('ws.messages.rate_limited');
+                sendAck(client, result.data.requestId, 'error', `Rate limited: too many ${result.data.type} requests`, { errorCode: ErrorCodes.RATE_LIMITED });
+                return;
+            }
+            await handleMessage(client, result.data);
+        });
+        socket.on('close', () => {
+            clearInterval(pingInterval);
+            clients.delete(client);
+            metrics.gauge('ws.clients.connected', clients.size);
+            rateLimiter.removeClient(clientId);
+            // Release supervision — if this was the last supervisor for a session,
+            // any pending hook permission requests will fall through to the terminal.
+            if (supervision) {
+                const released = supervision.removeClient(client);
+                for (const sessionId of released) {
+                    hookRouter?.releaseSession(sessionId);
+                }
+            }
+        });
+    });
+    // Clean up intervals when Fastify shuts down
+    app.addHook('onClose', () => {
+        cleanupBridge();
+    });
+}
+function withTimeout(promise, timeoutMs) {
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => {
+            reject(new Error(`Command timed out after ${timeoutMs}ms`));
+        }, timeoutMs);
+        promise.then((value) => {
+            clearTimeout(timer);
+            resolve(value);
+        }, (err) => {
+            clearTimeout(timer);
+            reject(err);
+        });
+    });
+}
+function isTimeoutError(err) {
+    return err instanceof Error && err.message.startsWith('Command timed out after ');
+}
+//# sourceMappingURL=ws-server.js.map

package/dist/server/ws-server.js.map

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

package/dist/startup-agents.d.ts

@@ -0,0 +1,6 @@
+import type { Daemon } from './core/daemon.js';
+import { AgentRegistry } from './core/agent-registry.js';
+export declare function loadAgents(daemon: Daemon): Promise<AgentRegistry>;
+export declare function decodeAutoRegisterEntry(entry: string): string;
+export declare function autoRegisterDirectories(daemon: Daemon, registry: AgentRegistry): Promise<void>;
+//# sourceMappingURL=startup-agents.d.ts.map

package/dist/startup-agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup-agents.d.ts","sourceRoot":"","sources":["../src/startup-agents.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAKzD,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CA4DvE;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,aAAa,GACtB,OAAO,CAAC,IAAI,CAAC,CAgCf"}

package/dist/startup-agents.js

@@ -0,0 +1,97 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { logger } from './core/output.js';
+import { AgentRegistry } from './core/agent-registry.js';
+import { decodeProjectDir } from './discovery/jsonl-reader.js';
+import { BUILT_IN_AGENTS } from './agents/built-in.js';
+import { loadPluginAgents } from './plugins/loader.js';
+export async function loadAgents(daemon) {
+    const registry = new AgentRegistry();
+    for (const def of BUILT_IN_AGENTS) {
+        registry.register(def);
+    }
+    try {
+        const plugins = await loadPluginAgents({ projectDir: process.cwd() });
+        for (const plugin of plugins) {
+            registry.register(plugin.definition);
+            logger.log(`Plugin ${plugin.manifest.name}: loaded (${plugin.definition.id})`);
+        }
+    }
+    catch (err) {
+        logger.warn('Plugin load failed:', err);
+    }
+    daemon.configManager.setAgentRegistry(registry);
+    const availability = await registry.detectAvailable();
+    for (const def of registry.getAll()) {
+        const available = availability.get(def.id) ?? false;
+        const discoveryIndependent = def.id === 'codex';
+        let discoveryRegistered = false;
+        if (def.createDiscovery && (available || discoveryIndependent)) {
+            try {
+                const discovery = await def.createDiscovery();
+                if (discovery) {
+                    daemon.registerDiscovery(discovery);
+                    discoveryRegistered = true;
+                }
+            }
+            catch (err) {
+                logger.error(`  Failed to create discovery for ${def.id}:`, err);
+            }
+        }
+        if (!available) {
+            logger.log(`Agent ${def.displayName}: not available (${def.detection.description})`);
+            if (def.id === 'codex' && discoveryRegistered) {
+                logger.log('  Codex discovery is active; install @openai/codex-sdk@latest (or @openai/codex@latest) to enable launching/resuming sessions.');
+            }
+            continue;
+        }
+        logger.log(`Agent ${def.displayName}: available`);
+        try {
+            const adapter = await def.createAdapter();
+            if (adapter) {
+                daemon.registerAdapter(adapter);
+            }
+        }
+        catch (err) {
+            logger.error(`  Failed to create adapter for ${def.id}:`, err);
+        }
+    }
+    return registry;
+}
+export function decodeAutoRegisterEntry(entry) {
+    return entry.startsWith('-') ? decodeProjectDir(entry) : decodeProjectDir(`-${entry}`);
+}
+export async function autoRegisterDirectories(daemon, registry) {
+    const watchDirs = registry.getAllWatchDirs();
+    for (const watchDir of watchDirs) {
+        try {
+            const entries = await fs.readdir(watchDir);
+            for (const entry of entries) {
+                const projectDir = path.join(watchDir, entry);
+                try {
+                    const stat = await fs.stat(projectDir);
+                    if (!stat.isDirectory())
+                        continue;
+                    const candidate = decodeAutoRegisterEntry(entry);
+                    try {
+                        await fs.access(candidate);
+                    }
+                    catch {
+                        continue;
+                    }
+                    if (!daemon.directoryManager.getByPath(candidate)) {
+                        await daemon.directoryManager.register(candidate);
+                        logger.log(`Auto-registered: ${candidate}`);
+                    }
+                }
+                catch {
+                    // Skip invalid entries.
+                }
+            }
+        }
+        catch {
+            // Watch dir doesn't exist — not an error.
+        }
+    }
+}
+//# sourceMappingURL=startup-agents.js.map

package/dist/startup-agents.js.map

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

package/dist/startup-prereqs.d.ts

@@ -0,0 +1,29 @@
+interface PrereqSnapshot {
+    preferredAgents: Set<string>;
+    hasClaudeSessions: boolean;
+    hasCodexSessions: boolean;
+    claudeSdkInstalled: boolean;
+    codexSdkInstalled: boolean;
+    geminiCliInstalled: boolean;
+}
+export interface PrereqIssue {
+    id: 'claude-sdk' | 'codex-sdk' | 'gemini-cli';
+    autoInstall: boolean;
+    prompt: string;
+    packages?: readonly string[];
+    hint?: string;
+}
+export interface PrereqInstallResult {
+    id: PrereqIssue['id'];
+    ok: boolean;
+    error?: string;
+}
+export declare function detectPrereqIssues(snapshot: PrereqSnapshot): PrereqIssue[];
+export declare function assessAgentPrerequisites(): Promise<PrereqIssue[]>;
+export declare function installPrerequisites(issues: PrereqIssue[]): Promise<PrereqInstallResult[]>;
+export declare function maybeOfferAgentPrerequisites(options: {
+    silent: boolean;
+    asJson: boolean;
+}): Promise<void>;
+export {};
+//# sourceMappingURL=startup-prereqs.d.ts.map

package/dist/startup-prereqs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup-prereqs.d.ts","sourceRoot":"","sources":["../src/startup-prereqs.ts"],"names":[],"mappings":"AAkBA,UAAU,cAAc;IACtB,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,YAAY,GAAG,WAAW,GAAG,YAAY,CAAC;IAC9C,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC;IACtB,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,cAAc,GAAG,WAAW,EAAE,CA0C1E;AAED,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAUvE;AAED,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAUhG;AA2GD,wBAAsB,4BAA4B,CAAC,OAAO,EAAE;IAC1D,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;CACjB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqChB"}

package/dist/startup-prereqs.js

@@ -0,0 +1,209 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { createInterface } from 'node:readline/promises';
+import { spawnSync } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+import { logger } from './core/output.js';
+import { loadConfig, BUILT_IN_DEFAULTS } from './core/config.js';
+import { claudeProjectsDir } from './discovery/jsonl-reader.js';
+import { codexSessionsDir } from './discovery/codex.js';
+import { resolveNpmInvocationFromNode } from './cli/runtime-toolchain.js';
+import { CODEX_SDK_PACKAGE_CANDIDATES, isCodexSdkAvailable } from './adapters/codex-sdk-loader.js';
+import { commandExists } from './agents/command-detection.js';
+const CLAUDE_SDK_PACKAGE_CANDIDATES = ['@anthropic-ai/claude-agent-sdk'];
+const PROMPT_TIMEOUT_MS = 15_000;
+const TIMED_OUT_TOKEN = '__VPD_INSTALL_PROMPT_TIMEOUT__';
+export function detectPrereqIssues(snapshot) {
+    const issues = [];
+    const wantsClaude = snapshot.preferredAgents.has('claude') ||
+        snapshot.hasClaudeSessions ||
+        snapshot.preferredAgents.size === 0;
+    const wantsCodex = snapshot.preferredAgents.has('codex') || snapshot.hasCodexSessions;
+    const wantsGemini = snapshot.preferredAgents.has('gemini');
+    if (wantsClaude && !snapshot.claudeSdkInstalled) {
+        issues.push({
+            id: 'claude-sdk',
+            autoInstall: true,
+            prompt: '\nClaude is configured or existing Claude sessions were detected, but @anthropic-ai/claude-agent-sdk is missing.\nInstall it now so daemon can launch/resume Claude sessions? [Y/n] ',
+            packages: CLAUDE_SDK_PACKAGE_CANDIDATES,
+            hint: 'npm install @anthropic-ai/claude-agent-sdk@latest',
+        });
+    }
+    if (wantsCodex && !snapshot.codexSdkInstalled) {
+        issues.push({
+            id: 'codex-sdk',
+            autoInstall: true,
+            prompt: '\nCodex is configured or existing Codex sessions were detected, but @openai/codex-sdk is missing.\nInstall it now so daemon can launch/resume Codex sessions? [Y/n] ',
+            packages: CODEX_SDK_PACKAGE_CANDIDATES,
+            hint: 'npm install @openai/codex-sdk@latest',
+        });
+    }
+    if (wantsGemini && !snapshot.geminiCliInstalled) {
+        issues.push({
+            id: 'gemini-cli',
+            autoInstall: false,
+            prompt: '\nGemini is configured, but the `gemini` CLI is not available on PATH.\nInstall Gemini CLI and re-run `vpd install` and `vpd start`.',
+            hint: 'Install Gemini CLI, then ensure `gemini` resolves from your PATH.',
+        });
+    }
+    return issues;
+}
+export async function assessAgentPrerequisites() {
+    const snapshot = {
+        preferredAgents: await resolvePreferredAgentsFromConfig(),
+        hasClaudeSessions: await hasJsonlFiles(claudeProjectsDir()),
+        hasCodexSessions: await hasJsonlFiles(codexSessionsDir()),
+        claudeSdkInstalled: await isClaudeSdkInstalled(),
+        codexSdkInstalled: await isCodexSdkAvailable(),
+        geminiCliInstalled: await commandExists('gemini'),
+    };
+    return detectPrereqIssues(snapshot);
+}
+export async function installPrerequisites(issues) {
+    const results = [];
+    for (const issue of issues) {
+        if (!issue.autoInstall || !issue.packages || issue.packages.length === 0) {
+            continue;
+        }
+        const result = installPackageCandidates(issue.packages);
+        results.push({ id: issue.id, ok: result.ok, error: result.error });
+    }
+    return results;
+}
+async function hasJsonlFiles(root, limit = 400) {
+    const queue = [root];
+    let scanned = 0;
+    while (queue.length > 0 && scanned < limit) {
+        const current = queue.shift();
+        if (!current)
+            continue;
+        let entries;
+        try {
+            entries = await fs.readdir(current, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const entry of entries) {
+            scanned += 1;
+            if (entry.isDirectory()) {
+                queue.push(path.join(current, entry.name));
+            }
+            else if (entry.isFile() && entry.name.endsWith('.jsonl')) {
+                return true;
+            }
+            if (scanned >= limit)
+                break;
+        }
+    }
+    return false;
+}
+async function resolvePreferredAgentsFromConfig() {
+    const preferred = new Set([BUILT_IN_DEFAULTS.agent ?? 'claude']);
+    const cfg = await loadConfig();
+    if (typeof cfg.defaults?.agent === 'string' && cfg.defaults.agent.trim()) {
+        preferred.add(cfg.defaults.agent.trim());
+    }
+    for (const entry of Object.values(cfg.directories ?? {})) {
+        const agent = entry?.config?.agent;
+        if (typeof agent === 'string' && agent.trim()) {
+            preferred.add(agent.trim());
+        }
+    }
+    return preferred;
+}
+async function isClaudeSdkInstalled() {
+    try {
+        await import('@anthropic-ai/claude-agent-sdk');
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function daemonPackageRoot() {
+    return path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+}
+function installPackageCandidates(packages) {
+    const daemonRoot = daemonPackageRoot();
+    const npmInvocation = (() => {
+        try {
+            return resolveNpmInvocationFromNode(process.execPath);
+        }
+        catch {
+            return { command: 'npm', argsPrefix: [] };
+        }
+    })();
+    let lastError;
+    for (const packageName of packages) {
+        const result = spawnSync(npmInvocation.command, [...npmInvocation.argsPrefix, 'install', `${packageName}@latest`], {
+            cwd: daemonRoot,
+            stdio: 'inherit',
+            env: process.env,
+        });
+        if (!result.error && (result.status ?? 1) === 0) {
+            return { ok: true };
+        }
+        lastError = result.error
+            ? result.error instanceof Error
+                ? result.error.message
+                : String(result.error)
+            : `${packageName} install exited with code ${result.status ?? 1}`;
+    }
+    return { ok: false, error: lastError };
+}
+async function promptInstall(question) {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    try {
+        const answer = await Promise.race([
+            rl.question(question),
+            new Promise((resolve) => setTimeout(() => resolve(TIMED_OUT_TOKEN), PROMPT_TIMEOUT_MS)),
+        ]);
+        if (answer === TIMED_OUT_TOKEN)
+            return null;
+        const normalized = answer.trim().toLowerCase();
+        return normalized.length === 0 || normalized === 'y' || normalized === 'yes';
+    }
+    finally {
+        rl.close();
+    }
+}
+export async function maybeOfferAgentPrerequisites(options) {
+    if (options.silent || options.asJson)
+        return;
+    if (process.env['VPD_SKIP_INTERACTIVE_INSTALL_PROMPTS'] === '1')
+        return;
+    if (process.env['TSX_WATCH'])
+        return;
+    const issues = await assessAgentPrerequisites();
+    if (issues.length === 0)
+        return;
+    for (const issue of issues) {
+        if (!issue.autoInstall) {
+            logger.warn(issue.prompt);
+            continue;
+        }
+        if (!process.stdin.isTTY || !process.stdout.isTTY) {
+            if (issue.hint)
+                logger.warn(`${issue.prompt}\n${issue.hint}`);
+            continue;
+        }
+        const decision = await promptInstall(issue.prompt);
+        if (decision === null) {
+            logger.log('\nDependency install prompt timed out; continuing startup.');
+            continue;
+        }
+        if (!decision)
+            continue;
+        if (!issue.packages || issue.packages.length === 0)
+            continue;
+        logger.log(`\nInstalling dependency (${issue.packages.join(' -> ')}) ...`);
+        const result = installPackageCandidates(issue.packages);
+        if (!result.ok) {
+            logger.warn(`Dependency install failed (${result.error ?? 'unknown error'}). ${issue.hint ?? 'Please install manually and retry.'}`);
+            continue;
+        }
+        logger.log('Dependency installed. Continuing daemon startup.\n');
+    }
+}
+//# sourceMappingURL=startup-prereqs.js.map