night-orch 0.1.0

package/dist/environment/env-file.js

@@ -0,0 +1,74 @@
+import { readFileSync, writeFileSync, existsSync, copyFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { logger } from '../utils/logger.js';
+import { parsePortRange, allocatePort } from './port.js';
+const MARKER_START = '# --- night-orch overrides ---';
+const MARKER_END = '# --- end night-orch overrides ---';
+/**
+ * Copy base .env and apply overrides with marked section.
+ * Inspired by the Vendis bin/worktree pattern.
+ */
+export function setupEnvFile(params) {
+    const { worktreePath, repoLocalPath, copyFrom, overrides, overrideFiles, usedPorts } = params;
+    const targetEnv = join(worktreePath, '.env');
+    // 1. Copy base .env
+    const baseEnv = join(repoLocalPath, copyFrom);
+    if (existsSync(baseEnv)) {
+        copyFileSync(baseEnv, targetEnv);
+        logger.debug({ from: baseEnv, to: targetEnv }, 'Copied base .env');
+    }
+    // 2. Apply additional override files
+    for (const overrideFile of overrideFiles) {
+        const filePath = join(repoLocalPath, overrideFile);
+        if (existsSync(filePath)) {
+            const content = readFileSync(filePath, 'utf-8');
+            appendToFile(targetEnv, content);
+        }
+    }
+    // 3. Process overrides — resolve {auto:min-max} tokens
+    let allocatedPort = null;
+    const resolvedOverrides = {};
+    for (const [key, value] of Object.entries(overrides)) {
+        const portRange = parsePortRange(value);
+        if (portRange) {
+            allocatedPort = allocatePort(portRange, usedPorts);
+            usedPorts.push(allocatedPort);
+            resolvedOverrides[key] = String(allocatedPort);
+        }
+        else {
+            resolvedOverrides[key] = value;
+        }
+    }
+    // 4. Write overrides in marked section
+    if (Object.keys(resolvedOverrides).length > 0) {
+        const overrideLines = Object.entries(resolvedOverrides)
+            .map(([k, v]) => `${k}=${v}`)
+            .join('\n');
+        const section = `\n${MARKER_START}\n${overrideLines}\n${MARKER_END}\n`;
+        // Remove existing marked section if present, then append
+        if (existsSync(targetEnv)) {
+            let content = readFileSync(targetEnv, 'utf-8');
+            const startIdx = content.indexOf(MARKER_START);
+            const endIdx = content.indexOf(MARKER_END);
+            if (startIdx !== -1 && endIdx !== -1) {
+                content = content.slice(0, startIdx) + content.slice(endIdx + MARKER_END.length);
+            }
+            writeFileSync(targetEnv, content + section, 'utf-8');
+        }
+        else {
+            writeFileSync(targetEnv, section, 'utf-8');
+        }
+        logger.debug({ overrides: resolvedOverrides }, 'Applied .env overrides');
+    }
+    return { envOverrides: resolvedOverrides, allocatedPort };
+}
+function appendToFile(filePath, content) {
+    if (existsSync(filePath)) {
+        const existing = readFileSync(filePath, 'utf-8');
+        writeFileSync(filePath, existing + '\n' + content, 'utf-8');
+    }
+    else {
+        writeFileSync(filePath, content, 'utf-8');
+    }
+}
+//# sourceMappingURL=env-file.js.map

package/dist/environment/env-file.js.map

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

package/dist/environment/manager.d.ts

@@ -0,0 +1,33 @@
+import type { RepoConfig } from '../config/schema.js';
+export type EnvironmentMode = 'shared' | 'dedicated';
+export interface EnvSetupResult {
+    mode: EnvironmentMode;
+    allocatedPort: number | null;
+    composeProjectName: string | null;
+    envOverrides: Record<string, string>;
+}
+/**
+ * Resolve the environment mode for an issue from labels and repo config.
+ */
+export declare function resolveEnvironmentMode(issueLabels: string[], repoConfig: RepoConfig): EnvironmentMode;
+/**
+ * Set up the environment for a worktree.
+ */
+export declare function setupEnvironment(params: {
+    worktreePath: string;
+    issueNumber: number;
+    repoConfig: RepoConfig;
+    mode: EnvironmentMode;
+    usedPorts: number[];
+}): Promise<EnvSetupResult>;
+/**
+ * Tear down the environment. No-op for shared mode.
+ */
+export declare function teardownEnvironment(params: {
+    worktreePath: string;
+    issueNumber: number;
+    repoConfig: RepoConfig;
+    mode: EnvironmentMode;
+    composeProjectName: string | null;
+}): Promise<void>;
+//# sourceMappingURL=manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/environment/manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAQrD,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,WAAW,CAAA;AAEpD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,eAAe,CAAA;IACrB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACrC;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,EAAE,EACrB,UAAU,EAAE,UAAU,GACrB,eAAe,CAIjB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE;IAC7C,YAAY,EAAE,MAAM,CAAA;IACpB,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,UAAU,CAAA;IACtB,IAAI,EAAE,eAAe,CAAA;IACrB,SAAS,EAAE,MAAM,EAAE,CAAA;CACpB,GAAG,OAAO,CAAC,cAAc,CAAC,CAqE1B;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE;IAChD,YAAY,EAAE,MAAM,CAAA;IACpB,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,UAAU,CAAA;IACtB,IAAI,EAAE,eAAe,CAAA;IACrB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAA;CAClC,GAAG,OAAO,CAAC,IAAI,CAAC,CAmBhB"}

package/dist/environment/manager.js

@@ -0,0 +1,113 @@
+import { validateSharedEnvironment } from './shared.js';
+import { startDedicatedStack, stopDedicatedStack } from './dedicated.js';
+import { setupEnvFile } from './env-file.js';
+import { runBootstrapCommands } from './bootstrap.js';
+import { logger } from '../utils/logger.js';
+/**
+ * Resolve the environment mode for an issue from labels and repo config.
+ */
+export function resolveEnvironmentMode(issueLabels, repoConfig) {
+    if (issueLabels.includes('env:dedicated'))
+        return 'dedicated';
+    if (issueLabels.includes('env:shared'))
+        return 'shared';
+    return repoConfig.environment?.defaultMode ?? 'shared';
+}
+/**
+ * Set up the environment for a worktree.
+ */
+export async function setupEnvironment(params) {
+    const { worktreePath, issueNumber, repoConfig, mode, usedPorts } = params;
+    const envConfig = repoConfig.environment;
+    if (mode === 'shared') {
+        // Validate shared environment
+        const shared = envConfig?.shared;
+        await validateSharedEnvironment(shared?.healthcheck, shared?.requireRunning ?? true);
+        // Run bootstrap commands
+        if (envConfig?.bootstrap) {
+            await runBootstrapCommands(worktreePath, envConfig.bootstrap, 'shared');
+        }
+        return { mode: 'shared', allocatedPort: null, composeProjectName: null, envOverrides: {} };
+    }
+    // Dedicated mode
+    const dedicated = envConfig?.dedicated;
+    if (!dedicated) {
+        throw new Error(`Dedicated mode requested but no dedicated config in repo ${repoConfig.repo}`);
+    }
+    // Set up .env file with overrides
+    const projectName = dedicated.compose.projectName.replace('{issue}', String(issueNumber));
+    const { envOverrides, allocatedPort } = setupEnvFile({
+        worktreePath,
+        repoLocalPath: repoConfig.localPath,
+        copyFrom: dedicated.env.copyFrom,
+        overrides: substituteIssue(dedicated.env.overrides, issueNumber),
+        overrideFiles: dedicated.env.overrideFiles,
+        usedPorts,
+    });
+    // Resolve healthcheck port
+    const healthcheck = substituteCommandToken(dedicated.healthcheck, '{port}', String(allocatedPort ?? ''));
+    // Start Docker Compose
+    let stackStarted = false;
+    try {
+        await startDedicatedStack({
+            worktreePath,
+            composeFile: dedicated.compose.file,
+            services: dedicated.compose.services,
+            projectName,
+            healthcheck,
+        });
+        stackStarted = true;
+        // Run bootstrap commands
+        if (envConfig?.bootstrap) {
+            await runBootstrapCommands(worktreePath, envConfig.bootstrap, 'dedicated');
+        }
+    }
+    catch (err) {
+        if (stackStarted) {
+            try {
+                await stopDedicatedStack(worktreePath, dedicated.compose.file, projectName);
+            }
+            catch (teardownErr) {
+                logger.warn({ projectName, err: teardownErr }, 'Failed to roll back dedicated environment after setup error');
+            }
+        }
+        throw err;
+    }
+    return { mode: 'dedicated', allocatedPort, composeProjectName: projectName, envOverrides };
+}
+/**
+ * Tear down the environment. No-op for shared mode.
+ */
+export async function teardownEnvironment(params) {
+    const { worktreePath, repoConfig, mode, composeProjectName } = params;
+    if (mode === 'shared')
+        return;
+    const dedicated = repoConfig.environment?.dedicated;
+    if (!dedicated || !composeProjectName)
+        return;
+    if (dedicated.teardownOnComplete) {
+        await stopDedicatedStack(worktreePath, dedicated.compose.file, composeProjectName);
+    }
+    // Run cleanup commands
+    const cleanupCmds = repoConfig.environment?.cleanup ?? [];
+    if (cleanupCmds.length > 0) {
+        await runBootstrapCommands(worktreePath, cleanupCmds, 'dedicated');
+    }
+    logger.info({ composeProjectName }, 'Dedicated environment torn down');
+}
+function substituteIssue(overrides, issueNumber) {
+    const result = {};
+    for (const [key, value] of Object.entries(overrides)) {
+        result[key] = value.replace('{issue}', String(issueNumber));
+    }
+    return result;
+}
+function substituteCommandToken(command, token, value) {
+    if (!command)
+        return undefined;
+    if (Array.isArray(command)) {
+        return command.map((part) => part.replaceAll(token, value));
+    }
+    return command.replaceAll(token, value);
+}
+//# sourceMappingURL=manager.js.map

package/dist/environment/manager.js.map

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

package/dist/environment/port.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Parse an "{auto:min-max}" port range string.
+ */
+export declare function parsePortRange(spec: string): {
+    min: number;
+    max: number;
+} | null;
+/**
+ * Allocate the first free port in a range, given already-used ports.
+ */
+export declare function allocatePort(range: {
+    min: number;
+    max: number;
+}, usedPorts: number[]): number;
+//# sourceMappingURL=port.d.ts.map

package/dist/environment/port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"port.d.ts","sourceRoot":"","sources":["../../src/environment/port.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAIhF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,CAM7F"}

package/dist/environment/port.js

@@ -0,0 +1,21 @@
+/**
+ * Parse an "{auto:min-max}" port range string.
+ */
+export function parsePortRange(spec) {
+    const match = spec.match(/^\{auto:(\d+)-(\d+)\}$/);
+    if (!match)
+        return null;
+    return { min: parseInt(match[1], 10), max: parseInt(match[2], 10) };
+}
+/**
+ * Allocate the first free port in a range, given already-used ports.
+ */
+export function allocatePort(range, usedPorts) {
+    const used = new Set(usedPorts);
+    for (let port = range.min; port <= range.max; port++) {
+        if (!used.has(port))
+            return port;
+    }
+    throw new Error(`Port range ${range.min}-${range.max} exhausted (${usedPorts.length} in use)`);
+}
+//# sourceMappingURL=port.js.map

package/dist/environment/port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"port.js","sourceRoot":"","sources":["../../src/environment/port.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAA;IAClD,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAA;IACvB,OAAO,EAAE,GAAG,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC,EAAE,CAAA;AACvE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,KAAmC,EAAE,SAAmB;IACnF,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAA;IAC/B,KAAK,IAAI,IAAI,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,IAAI,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC;QACrD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAA;IAClC,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,cAAc,KAAK,CAAC,GAAG,IAAI,KAAK,CAAC,GAAG,eAAe,SAAS,CAAC,MAAM,UAAU,CAAC,CAAA;AAChG,CAAC"}

package/dist/environment/shared.d.ts

@@ -0,0 +1,6 @@
+import { type CommandSpec } from '../utils/command.js';
+/**
+ * Validate that the shared dev environment is running by executing a healthcheck command.
+ */
+export declare function validateSharedEnvironment(healthcheck?: CommandSpec, requireRunning?: boolean): Promise<void>;
+//# sourceMappingURL=shared.d.ts.map

package/dist/environment/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/environment/shared.ts"],"names":[],"mappings":"AAEA,OAAO,EAAoB,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAGxE;;GAEG;AACH,wBAAsB,yBAAyB,CAAC,WAAW,CAAC,EAAE,WAAW,EAAE,cAAc,UAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAwB/G"}

package/dist/environment/shared.js

@@ -0,0 +1,30 @@
+import { execa } from 'execa';
+import { logger } from '../utils/logger.js';
+import { parseCommandSpec } from '../utils/command.js';
+import { buildBootstrapEnv } from '../workers/env.js';
+/**
+ * Validate that the shared dev environment is running by executing a healthcheck command.
+ */
+export async function validateSharedEnvironment(healthcheck, requireRunning = true) {
+    if (!healthcheck) {
+        logger.debug('No shared healthcheck configured, skipping');
+        return;
+    }
+    const commandLabel = Array.isArray(healthcheck) ? healthcheck.join(' ') : healthcheck;
+    const { binary, args } = parseCommandSpec(healthcheck);
+    try {
+        await execa(binary, args, {
+            timeout: 10_000,
+            extendEnv: false,
+            env: buildBootstrapEnv(),
+        });
+        logger.info({ healthcheck: commandLabel }, 'Shared environment healthcheck passed');
+    }
+    catch {
+        if (requireRunning) {
+            throw new Error(`Shared environment healthcheck failed: ${commandLabel}\nMake sure the dev stack is running.`);
+        }
+        logger.warn({ healthcheck: commandLabel }, 'Shared environment healthcheck failed (not required)');
+    }
+}
+//# sourceMappingURL=shared.js.map

package/dist/environment/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/environment/shared.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAA;AAC7B,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAC3C,OAAO,EAAE,gBAAgB,EAAoB,MAAM,qBAAqB,CAAA;AACxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAErD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,WAAyB,EAAE,cAAc,GAAG,IAAI;IAC9F,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,CAAC,KAAK,CAAC,4CAA4C,CAAC,CAAA;QAC1D,OAAM;IACR,CAAC;IAED,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAA;IACrF,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAA;IAEtD,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE;YACxB,OAAO,EAAE,MAAM;YACf,SAAS,EAAE,KAAK;YAChB,GAAG,EAAE,iBAAiB,EAAE;SACzB,CAAC,CAAA;QACF,MAAM,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,YAAY,EAAE,EAAE,uCAAuC,CAAC,CAAA;IACrF,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,cAAc,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CACb,0CAA0C,YAAY,uCAAuC,CAC9F,CAAA;QACH,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,YAAY,EAAE,EAAE,sDAAsD,CAAC,CAAA;IACpG,CAAC;AACH,CAAC"}

package/dist/events/bus.d.ts

@@ -0,0 +1,18 @@
+import type { AgentEvent } from './types.js';
+type EventHandler = (event: AgentEvent) => void;
+export declare class AgentEventBus {
+    private maxEventsPerRun;
+    private subscribers;
+    private history;
+    private nextId;
+    constructor(maxEventsPerRun?: number);
+    setRetentionLimit(limit: number): void;
+    subscribe(runId: string, handler: EventHandler): () => void;
+    emit(event: AgentEvent): AgentEvent;
+    getHistory(runId: string, limit?: number): AgentEvent[];
+    getSince(runId: string, sinceId: number, limit?: number): AgentEvent[];
+    clear(runId: string): void;
+}
+export declare const agentEventBus: AgentEventBus;
+export {};
+//# sourceMappingURL=bus.d.ts.map

package/dist/events/bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bus.d.ts","sourceRoot":"","sources":["../../src/events/bus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE5C,KAAK,YAAY,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAA;AAE/C,qBAAa,aAAa;IAKZ,OAAO,CAAC,eAAe;IAJnC,OAAO,CAAC,WAAW,CAAuC;IAC1D,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,MAAM,CAAI;gBAEE,eAAe,SAAM;IAEzC,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAStC,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,MAAM,IAAI;IAa3D,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU;IAuBnC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,UAAU,EAAE;IAMnD,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,UAAU,EAAE;IAOlE,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;CAI3B;AAED,eAAO,MAAM,aAAa,eAAsB,CAAA"}

package/dist/events/bus.js

@@ -0,0 +1,70 @@
+export class AgentEventBus {
+    maxEventsPerRun;
+    subscribers = new Map();
+    history = new Map();
+    nextId = 1;
+    constructor(maxEventsPerRun = 500) {
+        this.maxEventsPerRun = maxEventsPerRun;
+    }
+    setRetentionLimit(limit) {
+        if (!Number.isFinite(limit) || limit < 1)
+            return;
+        this.maxEventsPerRun = Math.floor(limit);
+        for (const [runId, events] of this.history.entries()) {
+            if (events.length <= this.maxEventsPerRun)
+                continue;
+            this.history.set(runId, events.slice(-this.maxEventsPerRun));
+        }
+    }
+    subscribe(runId, handler) {
+        const set = this.subscribers.get(runId) ?? new Set();
+        set.add(handler);
+        this.subscribers.set(runId, set);
+        return () => {
+            const handlers = this.subscribers.get(runId);
+            if (!handlers)
+                return;
+            handlers.delete(handler);
+            if (handlers.size === 0)
+                this.subscribers.delete(runId);
+        };
+    }
+    emit(event) {
+        const withId = {
+            ...event,
+            id: event.id ?? this.nextId++,
+        };
+        const runHistory = this.history.get(withId.runId) ?? [];
+        runHistory.push(withId);
+        if (runHistory.length > this.maxEventsPerRun) {
+            runHistory.splice(0, runHistory.length - this.maxEventsPerRun);
+        }
+        this.history.set(withId.runId, runHistory);
+        const handlers = this.subscribers.get(withId.runId);
+        if (handlers) {
+            for (const handler of handlers) {
+                handler(withId);
+            }
+        }
+        return withId;
+    }
+    getHistory(runId, limit = 50) {
+        const events = this.history.get(runId) ?? [];
+        if (limit <= 0)
+            return [];
+        return events.slice(-limit);
+    }
+    getSince(runId, sinceId, limit = 50) {
+        if (limit <= 0)
+            return [];
+        const events = this.history.get(runId) ?? [];
+        const filtered = events.filter((e) => (e.id ?? 0) > sinceId);
+        return filtered.slice(0, limit);
+    }
+    clear(runId) {
+        this.history.delete(runId);
+        this.subscribers.delete(runId);
+    }
+}
+export const agentEventBus = new AgentEventBus();
+//# sourceMappingURL=bus.js.map

package/dist/events/bus.js.map

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

package/dist/events/observability.d.ts

@@ -0,0 +1,32 @@
+import type Database from 'better-sqlite3';
+import type { Config } from '../config/schema.js';
+import type { AgentEvent } from './types.js';
+export declare class AgentObservability {
+    private db;
+    private config;
+    private pending;
+    private flushTimer;
+    private streams;
+    private insertEvents;
+    private options;
+    constructor(db: Database.Database, config: Config);
+    record(event: AgentEvent): void;
+    flush(): void;
+    close(): Promise<void>;
+    /**
+     * Release per-run resources: close any session log streams for the
+     * run and clear its entry from the in-memory event history. Called
+     * from the poller when a run reaches a terminal state so that the
+     * daemon does not accumulate map entries and open file descriptors
+     * for every run it has ever processed.
+     */
+    closeRun(runId: string): Promise<void>;
+    private ensureFlushTimer;
+    private writeSessionLog;
+    private openStreamAndWrite;
+    private closeStreams;
+}
+export declare function setActiveAgentObservability(instance: AgentObservability | null): void;
+export declare function flushActiveAgentObservability(): void;
+export declare function clearActiveAgentObservability(instance: AgentObservability): void;
+//# sourceMappingURL=observability.d.ts.map

package/dist/events/observability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability.d.ts","sourceRoot":"","sources":["../../src/events/observability.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAA;AAI1C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAGjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAK5C,qBAAa,kBAAkB;IAY3B,OAAO,CAAC,EAAE;IACV,OAAO,CAAC,MAAM;IAZhB,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,UAAU,CAA8B;IAChD,OAAO,CAAC,OAAO,CAAiC;IAChD,OAAO,CAAC,YAAY,CAAgC;IACpD,OAAO,CAAC,OAAO,CAId;gBAGS,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,MAAM,EAAE,MAAM;IAsBxB,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAkB/B,KAAK,IAAI,IAAI;IAeP,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B;;;;;;OAMG;IACG,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB5C,OAAO,CAAC,gBAAgB;IASxB,OAAO,CAAC,eAAe;YAYT,kBAAkB;YAuBlB,YAAY;CAO3B;AAqBD,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI,GAAG,IAAI,CAErF;AAED,wBAAgB,6BAA6B,IAAI,IAAI,CAEpD;AAED,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI,CAIhF"}

package/dist/events/observability.js

@@ -0,0 +1,155 @@
+import { createWriteStream } from 'node:fs';
+import { mkdir } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { logger } from '../utils/logger.js';
+import { agentEventBus } from './bus.js';
+const FLUSH_INTERVAL_MS = 2_000;
+const FLUSH_BATCH_SIZE = 50;
+export class AgentObservability {
+    db;
+    config;
+    pending = [];
+    flushTimer = null;
+    streams = new Map();
+    insertEvents;
+    options;
+    constructor(db, config) {
+        this.db = db;
+        this.config = config;
+        this.insertEvents = this.db.transaction((events) => {
+            const stmt = this.db.prepare(`INSERT INTO agent_events (run_id, phase, role, event_type, data, created_at)
+         VALUES (?, ?, ?, ?, ?, ?)`);
+            for (const event of events) {
+                stmt.run(event.runId, event.phase, event.role, event.type, JSON.stringify(event.data), event.timestamp);
+            }
+        });
+        this.options = normalizeObservabilityOptions(config);
+        agentEventBus.setRetentionLimit(this.options.eventRetention);
+    }
+    record(event) {
+        if (!this.options.agentStreaming)
+            return;
+        const emitted = agentEventBus.emit(event);
+        this.pending.push(emitted);
+        if (this.options.sessionLogs) {
+            this.writeSessionLog(emitted);
+        }
+        if (this.pending.length >= FLUSH_BATCH_SIZE) {
+            this.flush();
+            return;
+        }
+        this.ensureFlushTimer();
+    }
+    flush() {
+        if (this.flushTimer) {
+            clearTimeout(this.flushTimer);
+            this.flushTimer = null;
+        }
+        if (this.pending.length === 0)
+            return;
+        const batch = this.pending.splice(0, this.pending.length);
+        try {
+            this.insertEvents(batch);
+        }
+        catch (err) {
+            logger.warn({ err, events: batch.length }, 'Failed to persist agent events');
+        }
+    }
+    async close() {
+        this.flush();
+        await this.closeStreams();
+    }
+    /**
+     * Release per-run resources: close any session log streams for the
+     * run and clear its entry from the in-memory event history. Called
+     * from the poller when a run reaches a terminal state so that the
+     * daemon does not accumulate map entries and open file descriptors
+     * for every run it has ever processed.
+     */
+    async closeRun(runId) {
+        const toClose = [];
+        for (const [key, stream] of this.streams.entries()) {
+            if (key.startsWith(`${runId}:`)) {
+                toClose.push([key, stream]);
+            }
+        }
+        for (const [key] of toClose) {
+            this.streams.delete(key);
+        }
+        await Promise.all(toClose.map(([, stream]) => new Promise((resolve) => stream.end(() => resolve()))));
+        agentEventBus.clear(runId);
+    }
+    ensureFlushTimer() {
+        if (this.flushTimer)
+            return;
+        this.flushTimer = setTimeout(() => {
+            this.flushTimer = null;
+            this.flush();
+        }, FLUSH_INTERVAL_MS);
+        this.flushTimer.unref();
+    }
+    writeSessionLog(event) {
+        const key = `${event.runId}:${event.phase}`;
+        const existing = this.streams.get(key);
+        if (existing) {
+            existing.write(`${JSON.stringify(event)}\n`);
+            return;
+        }
+        // Lazy-open the stream asynchronously so mkdirSync does not block the
+        // event loop on every new run×phase combination.
+        void this.openStreamAndWrite(event, key);
+    }
+    async openStreamAndWrite(event, key) {
+        // Re-check after await to avoid double-open races
+        if (this.streams.has(key)) {
+            this.streams.get(key).write(`${JSON.stringify(event)}\n`);
+            return;
+        }
+        try {
+            const safePhase = sanitizeSegment(event.phase);
+            const dir = join(this.config.storage.logsRoot, event.runId);
+            const path = join(dir, `${safePhase}.jsonl`);
+            await mkdir(dirname(path), { recursive: true });
+            const stream = createWriteStream(path, { flags: 'a' });
+            stream.on('error', (err) => {
+                logger.warn({ err, runId: event.runId, phase: event.phase, path }, 'Session log stream error');
+            });
+            this.streams.set(key, stream);
+            stream.write(`${JSON.stringify(event)}\n`);
+        }
+        catch (err) {
+            logger.warn({ err, runId: event.runId, phase: event.phase }, 'Failed to open session log stream');
+        }
+    }
+    async closeStreams() {
+        const streams = [...this.streams.values()];
+        this.streams.clear();
+        await Promise.all(streams.map((stream) => new Promise((resolve) => {
+            stream.end(() => resolve());
+        })));
+    }
+}
+function sanitizeSegment(value) {
+    return value.replace(/[^a-zA-Z0-9._-]/g, '_');
+}
+function normalizeObservabilityOptions(config) {
+    const raw = config.observability;
+    return {
+        agentStreaming: raw?.agentStreaming ?? true,
+        eventRetention: raw?.eventRetention ?? 1000,
+        sessionLogs: raw?.sessionLogs ?? true,
+    };
+}
+let activeAgentObservability = null;
+export function setActiveAgentObservability(instance) {
+    activeAgentObservability = instance;
+}
+export function flushActiveAgentObservability() {
+    activeAgentObservability?.flush();
+}
+export function clearActiveAgentObservability(instance) {
+    if (activeAgentObservability === instance) {
+        activeAgentObservability = null;
+    }
+}
+//# sourceMappingURL=observability.js.map

package/dist/events/observability.js.map

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