comisai 1.0.18 → 1.0.22

package/node_modules/@comis/daemon/dist/observability/log-level-manager.d.ts

@@ -1,23 +0,0 @@
-import { type ComisLogger } from "@comis/infra";
-/**
- * Log level manager: per-module child loggers with runtime level control.
- *
- * Modules obtain their logger via getLogger(module), which returns a cached
- * Pino child logger. Levels can be changed at runtime per-module or globally
- * via the daemon.setLogLevel RPC (OBS-04).
- */
-export interface LogLevelManager {
-    /** Get or create a child logger for a named module. Cached on first call. */
-    getLogger(module: string): ComisLogger;
-    /** Change the log level for a specific module's logger. */
-    setLevel(module: string, level: string): void;
-    /** Change the root logger's level (affects all modules that haven't been individually overridden). */
-    setGlobalLevel(level: string): void;
-}
-/**
- * Create a log level manager that maintains a registry of per-module child loggers.
- *
- * @param rootLogger - The root Pino logger from which child loggers are derived
- * @returns A LogLevelManager instance
- */
-export declare function createLogLevelManager(rootLogger: ComisLogger): LogLevelManager;

package/node_modules/@comis/daemon/dist/observability/log-level-manager.js

@@ -1,34 +0,0 @@
-import { isValidLogLevel } from "@comis/infra";
-/**
- * Create a log level manager that maintains a registry of per-module child loggers.
- *
- * @param rootLogger - The root Pino logger from which child loggers are derived
- * @returns A LogLevelManager instance
- */
-export function createLogLevelManager(rootLogger) {
-    const loggers = new Map();
-    const manager = {
-        getLogger(module) {
-            let logger = loggers.get(module);
-            if (!logger) {
-                logger = rootLogger.child({ module });
-                loggers.set(module, logger);
-            }
-            return logger;
-        },
-        setLevel(module, level) {
-            if (!isValidLogLevel(level))
-                return; // CRED-05: silently reject invalid levels
-            const logger = loggers.get(module);
-            if (logger) {
-                logger.level = level;
-            }
-        },
-        setGlobalLevel(level) {
-            if (!isValidLogLevel(level))
-                return; // CRED-05: silently reject invalid levels
-            rootLogger.level = level;
-        },
-    };
-    return manager;
-}

package/node_modules/@comis/daemon/dist/observability/log-transport.d.ts

@@ -1,44 +0,0 @@
-/**
- * Log transport factory: constructs pino multi-target transport config
- * for simultaneous file rotation (pino-roll) and stdout output.
- *
- * INFRA-02: File rotation transport.
- * INFRA-03: Dual file + stdout output.
- * INFRA-04: removeOtherLogFiles cleanup.
- *
- * @module
- */
-import type { LoggingConfig } from "@comis/core";
-import type pino from "pino";
-/**
- * Expand leading tilde to os.homedir().
- * pino-roll does NOT expand tildes, so this must be called before
- * passing filePath to the transport.
- */
-export declare function expandTilde(filePath: string): string;
-/**
- * Detect whether the process is running under pm2.
- *
- * pm2 sets the `PM2_HOME` environment variable for all managed processes.
- * When running under pm2, stdout is already captured to pm2's own log files
- * (`~/.pm2/logs/`), so the pino-roll file transport would be a byte-for-byte
- * duplicate.
- */
-export declare function isPm2Managed(): boolean;
-/**
- * Create a pino multi-target transport config from LoggingConfig.
- *
- * LI-1: PM2-aware transport selection.
- * - File transport (pino-roll): always active -- canonical log location.
- * - Stdout: skipped under pm2 (PM2_HOME set) to avoid byte-for-byte
- *   duplication with pm2's own log capture in ~/.pm2/logs/.
- *
- * Note: node-llama-cpp native module warnings write directly to stderr and
- * cannot be captured by Pino transports. This is a known limitation.
- *
- * @param config - Logging config from DaemonConfigSchema.logging
- * @param level - Log level to apply to each target (Pino multi-transport
- *   targets default to "info" unless explicitly set)
- * @returns Transport config to pass as LoggerOptions.transport
- */
-export declare function createFileTransport(config: LoggingConfig, level?: string): pino.TransportMultiOptions;

package/node_modules/@comis/daemon/dist/observability/log-transport.js

@@ -1,74 +0,0 @@
-/**
- * Log transport factory: constructs pino multi-target transport config
- * for simultaneous file rotation (pino-roll) and stdout output.
- *
- * INFRA-02: File rotation transport.
- * INFRA-03: Dual file + stdout output.
- * INFRA-04: removeOtherLogFiles cleanup.
- *
- * @module
- */
-import os from "node:os";
-/**
- * Expand leading tilde to os.homedir().
- * pino-roll does NOT expand tildes, so this must be called before
- * passing filePath to the transport.
- */
-export function expandTilde(filePath) {
-    return filePath.replace(/^~(?=\/|$)/, os.homedir());
-}
-/**
- * Detect whether the process is running under pm2.
- *
- * pm2 sets the `PM2_HOME` environment variable for all managed processes.
- * When running under pm2, stdout is already captured to pm2's own log files
- * (`~/.pm2/logs/`), so the pino-roll file transport would be a byte-for-byte
- * duplicate.
- */
-export function isPm2Managed() {
-    return typeof process.env.PM2_HOME === "string" && process.env.PM2_HOME.length > 0;
-}
-/**
- * Create a pino multi-target transport config from LoggingConfig.
- *
- * LI-1: PM2-aware transport selection.
- * - File transport (pino-roll): always active -- canonical log location.
- * - Stdout: skipped under pm2 (PM2_HOME set) to avoid byte-for-byte
- *   duplication with pm2's own log capture in ~/.pm2/logs/.
- *
- * Note: node-llama-cpp native module warnings write directly to stderr and
- * cannot be captured by Pino transports. This is a known limitation.
- *
- * @param config - Logging config from DaemonConfigSchema.logging
- * @param level - Log level to apply to each target (Pino multi-transport
- *   targets default to "info" unless explicitly set)
- * @returns Transport config to pass as LoggerOptions.transport
- */
-export function createFileTransport(config, level) {
-    const expandedPath = expandTilde(config.filePath);
-    const pm2Detected = isPm2Managed();
-    const targets = [];
-    // File transport: always active -- ~/.comis/logs/ is the canonical log location
-    targets.push({
-        target: "pino-roll",
-        options: {
-            file: expandedPath,
-            size: config.maxSize,
-            mkdir: true,
-            limit: {
-                count: config.maxFiles,
-                removeOtherLogFiles: true,
-            },
-        },
-        ...(level ? { level } : {}),
-    });
-    // Stdout: skip under pm2 (pm2 captures stdout to ~/.pm2/logs/, so it would be a duplicate)
-    if (!pm2Detected) {
-        targets.push({
-            target: "pino/file",
-            options: { destination: 1 }, // stdout
-            ...(level ? { level } : {}),
-        });
-    }
-    return { targets };
-}

package/node_modules/@comis/daemon/dist/observability/obs-write-buffer.d.ts

@@ -1,53 +0,0 @@
-/**
- * Generic batched write buffer for observability persistence.
- *
- * Sits between event bus listeners and ObservabilityStore: listeners push items
- * into the buffer; the buffer flushes batches to SQLite periodically or when
- * the buffer reaches its size threshold.
- *
- * Design:
- *  - Plain array (not ring buffer) per research recommendation
- *  - Dual trigger: size threshold (default 50) OR timer interval (default 500ms)
- *  - Timer uses unref() so it does not prevent Node.js process exit
- *  - drain() provides synchronous final flush for clean shutdown
- *  - flushFn is synchronous (better-sqlite3 db.transaction() is sync)
- *
- * @module obs-write-buffer
- */
-/** Public interface for the write buffer. */
-export interface ObsWriteBuffer<T> {
-    /** Add an item to the buffer. Triggers flush if buffer hits maxSize. */
-    push(item: T): void;
-    /** Flush current buffer contents to the flush callback. No-op if empty. */
-    flush(): void;
-    /** Synchronous final flush for shutdown: flushes remaining items and clears the interval timer. */
-    drain(): void;
-    /** Number of items currently buffered. */
-    readonly pending: number;
-}
-/** Options for creating a write buffer. */
-export interface ObsWriteBufferOptions<T> {
-    /** Callback invoked with a batch of items when flushing. Must be synchronous (better-sqlite3 is sync). */
-    flushFn: (items: T[]) => void;
-    /** Maximum buffer size before triggering a flush. Default: 50. */
-    maxSize?: number;
-    /** Interval in ms between automatic flushes. Default: 500. */
-    intervalMs?: number;
-}
-/**
- * Create a generic batched write buffer.
- *
- * Usage:
- * ```ts
- * const buf = createObsWriteBuffer<TokenUsageRow>({
- *   flushFn: (items) => store.insertTokenUsageBatch(items),
- *   maxSize: 50,
- *   intervalMs: 500,
- * });
- *
- * eventBus.on("token:usage", (entry) => buf.push(toRow(entry)));
- * // On shutdown:
- * buf.drain();
- * ```
- */
-export declare function createObsWriteBuffer<T>(opts: ObsWriteBufferOptions<T>): ObsWriteBuffer<T>;

package/node_modules/@comis/daemon/dist/observability/obs-write-buffer.js

@@ -1,68 +0,0 @@
-/**
- * Generic batched write buffer for observability persistence.
- *
- * Sits between event bus listeners and ObservabilityStore: listeners push items
- * into the buffer; the buffer flushes batches to SQLite periodically or when
- * the buffer reaches its size threshold.
- *
- * Design:
- *  - Plain array (not ring buffer) per research recommendation
- *  - Dual trigger: size threshold (default 50) OR timer interval (default 500ms)
- *  - Timer uses unref() so it does not prevent Node.js process exit
- *  - drain() provides synchronous final flush for clean shutdown
- *  - flushFn is synchronous (better-sqlite3 db.transaction() is sync)
- *
- * @module obs-write-buffer
- */
-/**
- * Create a generic batched write buffer.
- *
- * Usage:
- * ```ts
- * const buf = createObsWriteBuffer<TokenUsageRow>({
- *   flushFn: (items) => store.insertTokenUsageBatch(items),
- *   maxSize: 50,
- *   intervalMs: 500,
- * });
- *
- * eventBus.on("token:usage", (entry) => buf.push(toRow(entry)));
- * // On shutdown:
- * buf.drain();
- * ```
- */
-export function createObsWriteBuffer(opts) {
-    const { flushFn, maxSize = 50, intervalMs = 500 } = opts;
-    let buffer = [];
-    // Start periodic flush timer. unref() ensures it does not keep the process alive.
-    const timer = setInterval(() => {
-        flush();
-    }, intervalMs);
-    timer.unref();
-    function flush() {
-        if (buffer.length === 0)
-            return;
-        // Swap-before-call: if flushFn throws, the batch is in the local variable,
-        // not lost back in the buffer. The caller of flushFn can decide recovery.
-        const batch = buffer;
-        buffer = [];
-        flushFn(batch);
-    }
-    function push(item) {
-        buffer.push(item);
-        if (buffer.length >= maxSize) {
-            flush();
-        }
-    }
-    function drain() {
-        clearInterval(timer);
-        flush();
-    }
-    return {
-        push,
-        flush,
-        drain,
-        get pending() {
-            return buffer.length;
-        },
-    };
-}

package/node_modules/@comis/daemon/dist/observability/types.d.ts

@@ -1,6 +0,0 @@
-import type { EventMap, EventHandler } from "@comis/core";
-/** Reference to a registered EventBus handler for cleanup. */
-export interface HandlerRef {
-    event: keyof EventMap;
-    handler: EventHandler<keyof EventMap>;
-}

package/node_modules/@comis/daemon/dist/observability/types.js

@@ -1 +0,0 @@
-export {};

package/node_modules/@comis/daemon/dist/wiring/seed-bundled-skills.d.ts

@@ -1,41 +0,0 @@
-/**
- * Idempotent seeding of bundled skills from the repo's skills/ directory
- * into the user data directory (~/.comis/skills/).
- *
- * On first startup, copies each skill directory that does not already exist
- * in the target. Existing user skills are never overwritten.
- *
- * @module
- */
-/** Minimal Pino-compatible logger for seeding diagnostics. */
-interface SeedLogger {
-    info(obj: Record<string, unknown>, msg: string): void;
-    debug(obj: Record<string, unknown>, msg: string): void;
-}
-/** Result of a seeding operation. */
-export interface SeedResult {
-    /** Skill directory names that were newly copied into targetDir. */
-    seeded: string[];
-    /** Skill directory names that already existed in targetDir and were skipped. */
-    skipped: string[];
-}
-/**
- * Seed bundled skills from sourceDir into targetDir (idempotent).
- *
- * For each subdirectory in sourceDir, checks whether a same-named directory
- * already exists in targetDir. If not, copies the entire directory tree
- * recursively. Existing skill directories are never overwritten.
- *
- * @param opts.sourceDir - Absolute path to the repo's skills/ directory.
- *                         If omitted, resolves from __dirname (../../../../skills).
- * @param opts.targetDir - Absolute path to the user data skills directory
- *                         (e.g., ~/.comis/skills/).
- * @param opts.logger    - Optional structured logger for diagnostics.
- * @returns SeedResult with seeded and skipped skill names.
- */
-export declare function seedBundledSkills(opts: {
-    sourceDir?: string;
-    targetDir: string;
-    logger?: SeedLogger;
-}): SeedResult;
-export {};

package/node_modules/@comis/daemon/dist/wiring/seed-bundled-skills.js

@@ -1,84 +0,0 @@
-/**
- * Idempotent seeding of bundled skills from the repo's skills/ directory
- * into the user data directory (~/.comis/skills/).
- *
- * On first startup, copies each skill directory that does not already exist
- * in the target. Existing user skills are never overwritten.
- *
- * @module
- */
-import { existsSync, mkdirSync, readdirSync, cpSync, statSync } from "node:fs";
-import { resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-/**
- * Seed bundled skills from sourceDir into targetDir (idempotent).
- *
- * For each subdirectory in sourceDir, checks whether a same-named directory
- * already exists in targetDir. If not, copies the entire directory tree
- * recursively. Existing skill directories are never overwritten.
- *
- * @param opts.sourceDir - Absolute path to the repo's skills/ directory.
- *                         If omitted, resolves from __dirname (../../../../skills).
- * @param opts.targetDir - Absolute path to the user data skills directory
- *                         (e.g., ~/.comis/skills/).
- * @param opts.logger    - Optional structured logger for diagnostics.
- * @returns SeedResult with seeded and skipped skill names.
- */
-export function seedBundledSkills(opts) {
-    const seeded = [];
-    const skipped = [];
-    // Resolve source directory: either provided or derived from module location
-    const sourceDir = opts.sourceDir ?? resolveDefaultSourceDir();
-    // Handle missing source directory gracefully
-    if (!existsSync(sourceDir)) {
-        opts.logger?.debug({ sourceDir }, "Bundled skills source directory not found, skipping seed");
-        return { seeded, skipped };
-    }
-    // Ensure target directory exists
-    mkdirSync(opts.targetDir, { recursive: true });
-    // Enumerate skill directories in source
-    let entries;
-    try {
-        entries = readdirSync(sourceDir);
-    }
-    catch {
-        return { seeded, skipped };
-    }
-    for (const entry of entries) {
-        const srcPath = resolve(sourceDir, entry);
-        // Only process directories (skip files like README.md)
-        try {
-            if (!statSync(srcPath).isDirectory())
-                continue;
-        }
-        catch {
-            continue;
-        }
-        const destPath = resolve(opts.targetDir, entry);
-        if (existsSync(destPath)) {
-            skipped.push(entry);
-            opts.logger?.debug({ skill: entry }, "Bundled skill already exists in target, skipping");
-        }
-        else {
-            cpSync(srcPath, destPath, { recursive: true });
-            seeded.push(entry);
-            opts.logger?.debug({ skill: entry }, "Bundled skill seeded into target");
-        }
-    }
-    if (seeded.length > 0 || skipped.length > 0) {
-        opts.logger?.info({ seeded: seeded.length, skipped: skipped.length }, "Bundled skills seeded");
-    }
-    return { seeded, skipped };
-}
-// ---------------------------------------------------------------------------
-// Internal helpers
-// ---------------------------------------------------------------------------
-/**
- * Resolve the default bundled skills source directory relative to this module.
- * From packages/daemon/dist/wiring/ -> repo root skills/
- */
-function resolveDefaultSourceDir() {
-    const __filename = fileURLToPath(import.meta.url);
-    const __dirname = resolve(__filename, "..");
-    return resolve(__dirname, "../../../../skills");
-}

package/node_modules/@comis/daemon/dist/wiring/setup-delivery-mirror.d.ts

@@ -1,24 +0,0 @@
-/**
- * Delivery mirror wiring: adapter creation, hook-based recording, periodic prune.
- *
- * Phase 502: Session Mirroring.
- * @module
- */
-import type { AppConfig, DeliveryMirrorPort } from "@comis/core";
-import type { ComisLogger } from "@comis/infra";
-import type { PluginRegistry } from "@comis/core";
-export interface DeliveryMirrorResult {
-    /** The delivery mirror adapter (real or no-op), available immediately. */
-    deliveryMirror: DeliveryMirrorPort;
-    /** Starts the periodic prune timer. Call AFTER setupChannels. */
-    startPrune: () => void;
-    /** Clears the prune interval timer (call on shutdown). */
-    shutdown: () => void;
-}
-export declare function setupDeliveryMirror(deps: {
-    /** Raw better-sqlite3 database handle (typed as unknown to avoid cross-package type dep). */
-    db: unknown;
-    config: AppConfig;
-    pluginRegistry: PluginRegistry;
-    logger: ComisLogger;
-}): Promise<DeliveryMirrorResult>;

package/node_modules/@comis/daemon/dist/wiring/setup-delivery-mirror.js

@@ -1,88 +0,0 @@
-/**
- * Delivery mirror wiring: adapter creation, hook-based recording, periodic prune.
- *
- * Phase 502: Session Mirroring.
- * @module
- */
-import { createNoOpDeliveryMirror } from "@comis/core";
-import { createSqliteDeliveryMirror } from "@comis/memory";
-import { ok } from "@comis/shared";
-import { createHash } from "node:crypto";
-// ---------------------------------------------------------------------------
-// Idempotency key computation
-// ---------------------------------------------------------------------------
-/**
- * Compute an idempotency key for a mirror entry.
- * Uses session key + text hash + 1-second time bucket to deduplicate
- * repeated deliveries of the same text within the same second.
- */
-function computeIdempotencyKey(sessionKey, text, timestamp) {
-    const textHash = createHash("sha256").update(text).digest("hex").slice(0, 16);
-    const bucket = Math.floor(timestamp / 1000);
-    return `${sessionKey}:${textHash}:${bucket}`;
-}
-// ---------------------------------------------------------------------------
-// Setup function
-// ---------------------------------------------------------------------------
-export async function setupDeliveryMirror(deps) {
-    const { db, config, pluginRegistry, logger } = deps;
-    const mirrorConfig = config.deliveryMirror;
-    // 1. No-op when disabled
-    if (!mirrorConfig?.enabled) {
-        logger.debug("Delivery mirror disabled by config");
-        return {
-            deliveryMirror: createNoOpDeliveryMirror(),
-            startPrune: () => { },
-            shutdown: () => { },
-        };
-    }
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any -- db is better-sqlite3 Database; typed as unknown to avoid cross-package type dependency
-    const deliveryMirror = createSqliteDeliveryMirror(db);
-    logger.info({ retentionMs: mirrorConfig.retentionMs, maxEntriesPerInjection: mirrorConfig.maxEntriesPerInjection, maxCharsPerInjection: mirrorConfig.maxCharsPerInjection }, "Delivery mirror enabled");
-    // 2. Hook registration: record delivered text via after_delivery hook
-    pluginRegistry.register({
-        id: "comis:delivery-mirror",
-        name: "Delivery Mirror",
-        version: "1.0.0",
-        register(api) {
-            api.registerHook("after_delivery", async (event, ctx) => {
-                if (!ctx.sessionKey)
-                    return; // No session context -- skip (Pitfall 1)
-                const now = Date.now();
-                const idempotencyKey = computeIdempotencyKey(ctx.sessionKey, event.text, now);
-                const result = await deliveryMirror.record({
-                    sessionKey: ctx.sessionKey,
-                    text: event.text,
-                    mediaUrls: [], // Phase 502 baseline -- HookAfterDeliveryEvent has no mediaUrls field; media URL mirroring deferred
-                    channelType: event.channelType,
-                    channelId: event.channelId,
-                    origin: event.origin,
-                    idempotencyKey,
-                });
-                if (result.ok) {
-                    logger.debug({ sessionKey: ctx.sessionKey, channelType: event.channelType, idempotencyKey }, "Mirror entry recorded");
-                }
-                // Recording failures are silently tolerated (fire-and-forget hook)
-            });
-            return ok(undefined);
-        },
-    });
-    // 3. Prune timer
-    let pruneInterval;
-    const startPrune = () => {
-        pruneInterval = setInterval(async () => {
-            const result = await deliveryMirror.pruneOld(mirrorConfig.retentionMs);
-            if (result.ok && result.value > 0) {
-                logger.debug({ pruned: result.value }, "Delivery mirror pruned");
-            }
-        }, mirrorConfig.pruneIntervalMs);
-        pruneInterval.unref();
-    };
-    const shutdown = () => {
-        if (pruneInterval) {
-            clearInterval(pruneInterval);
-            pruneInterval = undefined;
-        }
-    };
-    return { deliveryMirror, startPrune, shutdown };
-}

package/node_modules/@comis/daemon/dist/wiring/setup-delivery-queue.d.ts

@@ -1,31 +0,0 @@
-/**
- * Delivery queue wiring: adapter creation, startup drain, periodic prune.
- *
- * Two-phase lifecycle resolves the circular dependency between the queue and
- * channel adapters:
- *   1. setupDeliveryQueue() creates the adapter immediately (before setupChannels).
- *   2. drainAndStartPrune() runs drain + starts prune timer AFTER setupChannels
- *      populates channelAdapters.
- *
- * Phase 499: Crash-Safe Delivery Queue.
- * @module
- */
-import type { AppConfig, TypedEventBus, DeliveryQueuePort } from "@comis/core";
-import { type DeliveryAdapter } from "@comis/channels";
-import type { ComisLogger } from "@comis/infra";
-export interface DeliveryQueueResult {
-    /** The delivery queue adapter (real or no-op), available immediately. */
-    deliveryQueue: DeliveryQueuePort;
-    /** Runs startup drain then starts periodic prune timer. Call AFTER setupChannels. */
-    drainAndStartPrune: () => Promise<void>;
-    /** Clears the prune interval timer (call on shutdown). */
-    shutdown: () => void;
-}
-export declare function setupDeliveryQueue(deps: {
-    /** Raw better-sqlite3 database handle (typed as unknown to avoid cross-package type dep). */
-    db: unknown;
-    config: AppConfig;
-    eventBus: TypedEventBus;
-    logger: ComisLogger;
-    channelAdapters: Map<string, DeliveryAdapter>;
-}): Promise<DeliveryQueueResult>;