@yoda.digital/iris-gateway 1.13.3

package/dist/plugins/loader.js

@@ -0,0 +1,108 @@
+import { existsSync, readdirSync } from "node:fs";
+import { writeFile, mkdir } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import { createJiti } from "jiti";
+import { PluginRegistry } from "./registry.js";
+import { SecurityScanner } from "../security/scanner.js";
+export class PluginLoader {
+    logger;
+    scanner = new SecurityScanner();
+    constructor(logger) {
+        this.logger = logger;
+    }
+    async loadAll(config, stateDir) {
+        const registry = new PluginRegistry();
+        const paths = this.discoverPaths(config, stateDir);
+        for (const pluginPath of paths) {
+            try {
+                // Security scan before loading
+                const scanResult = await this.scanner.scanDirectory(resolve(pluginPath));
+                if (!scanResult.safe) {
+                    this.logger.warn({ path: pluginPath, critical: scanResult.critical }, "Plugin blocked by security scanner");
+                    continue;
+                }
+                const mod = await this.loadModule(pluginPath);
+                const plugin = this.resolveExport(mod);
+                if (!plugin) {
+                    this.logger.warn({ path: pluginPath }, "Plugin has no valid export");
+                    continue;
+                }
+                const api = registry.createApi(plugin.id, config, this.logger, stateDir);
+                await plugin.register(api);
+                this.logger.info({ plugin: plugin.id, name: plugin.name }, "Plugin loaded");
+            }
+            catch (err) {
+                this.logger.error({ err, path: pluginPath }, "Failed to load plugin");
+            }
+        }
+        // Write manifest for OpenCode plugin
+        await this.writeManifest(registry, stateDir);
+        return registry;
+    }
+    discoverPaths(config, stateDir) {
+        const paths = [];
+        // Explicit config paths
+        if (config.plugins) {
+            for (const p of config.plugins)
+                paths.push(resolve(p));
+        }
+        // Convention directories
+        const localPlugins = join(process.cwd(), "plugins");
+        const userPlugins = join(stateDir, "plugins");
+        for (const dir of [localPlugins, userPlugins]) {
+            if (existsSync(dir)) {
+                try {
+                    for (const entry of readdirSync(dir, { withFileTypes: true })) {
+                        if (entry.isDirectory() && !entry.name.startsWith(".")) {
+                            paths.push(join(dir, entry.name));
+                        }
+                    }
+                }
+                catch {
+                    // Skip unreadable directories
+                }
+            }
+        }
+        return paths;
+    }
+    async loadModule(pluginPath) {
+        const jiti = createJiti(pluginPath, {
+            interopDefault: true,
+            moduleCache: false,
+        });
+        // Try index.ts, then index.js
+        for (const name of ["index.ts", "index.js", "index.mjs"]) {
+            const full = join(pluginPath, name);
+            if (existsSync(full)) {
+                return jiti.import(full);
+            }
+        }
+        // Try loading the path directly (if it's a file)
+        return jiti.import(pluginPath);
+    }
+    resolveExport(mod) {
+        if (!mod || typeof mod !== "object")
+            return null;
+        const obj = mod;
+        // Check default export
+        if (obj.default && typeof obj.default === "object") {
+            const def = obj.default;
+            if (typeof def.id === "string" && typeof def.register === "function") {
+                return def;
+            }
+        }
+        // Check module itself
+        if (typeof obj.id === "string" && typeof obj.register === "function") {
+            return obj;
+        }
+        return null;
+    }
+    async writeManifest(registry, stateDir) {
+        const manifest = registry.getManifest();
+        if (Object.keys(manifest.tools).length === 0)
+            return;
+        await mkdir(stateDir, { recursive: true });
+        await writeFile(join(stateDir, "plugin-tools.json"), JSON.stringify(manifest, null, 2));
+    }
+}
+//# sourceMappingURL=loader.js.map

package/dist/plugins/loader.js.map

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

package/dist/plugins/registry.d.ts

@@ -0,0 +1,13 @@
+import type { IrisConfig } from "../config/types.js";
+import type { Logger } from "../logging/logger.js";
+import type { IrisPluginApi, PluginToolDef, ChannelFactory, PluginService, PluginManifest } from "./types.js";
+import { HookBus } from "./hook-bus.js";
+export declare class PluginRegistry {
+    readonly tools: Map<string, PluginToolDef>;
+    readonly channels: Map<string, ChannelFactory>;
+    readonly services: Map<string, PluginService>;
+    readonly hookBus: HookBus;
+    createApi(pluginId: string, config: Readonly<IrisConfig>, logger: Logger, stateDir: string): IrisPluginApi;
+    getManifest(): PluginManifest;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/plugins/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/plugins/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EACb,cAAc,EACd,aAAa,EACb,cAAc,EAGf,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC,qBAAa,cAAc;IACzB,QAAQ,CAAC,KAAK,6BAAoC;IAClD,QAAQ,CAAC,QAAQ,8BAAqC;IACtD,QAAQ,CAAC,QAAQ,6BAAoC;IACrD,QAAQ,CAAC,OAAO,UAAiB;IAEjC,SAAS,CACP,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,EAC5B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,aAAa;IAchB,WAAW,IAAI,cAAc;CAW9B"}

package/dist/plugins/registry.js

@@ -0,0 +1,32 @@
+import { HookBus } from "./hook-bus.js";
+export class PluginRegistry {
+    tools = new Map();
+    channels = new Map();
+    services = new Map();
+    hookBus = new HookBus();
+    createApi(pluginId, config, logger, stateDir) {
+        return {
+            registerTool: (name, def) => { this.tools.set(name, def); },
+            registerChannel: (id, factory) => { this.channels.set(id, factory); },
+            registerService: (name, service) => { this.services.set(name, service); },
+            registerHook: (event, handler) => {
+                this.hookBus.on(event, handler);
+            },
+            config,
+            logger,
+            stateDir,
+        };
+    }
+    getManifest() {
+        const tools = {};
+        for (const [name, def] of this.tools) {
+            const args = {};
+            for (const [argName, zodType] of Object.entries(def.args)) {
+                args[argName] = String(zodType?._def?.typeName ?? "string");
+            }
+            tools[name] = { description: def.description, args };
+        }
+        return { tools };
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/plugins/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/plugins/registry.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC,MAAM,OAAO,cAAc;IAChB,KAAK,GAAG,IAAI,GAAG,EAAyB,CAAC;IACzC,QAAQ,GAAG,IAAI,GAAG,EAA0B,CAAC;IAC7C,QAAQ,GAAG,IAAI,GAAG,EAAyB,CAAC;IAC5C,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAEjC,SAAS,CACP,QAAgB,EAChB,MAA4B,EAC5B,MAAc,EACd,QAAgB;QAEhB,OAAO;YACL,YAAY,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;YAC3D,eAAe,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;YACrE,eAAe,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;YACzE,YAAY,EAAE,CAA0B,KAAQ,EAAE,OAAuB,EAAE,EAAE;gBAC3E,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAClC,CAAC;YACD,MAAM;YACN,MAAM;YACN,QAAQ;SACT,CAAC;IACJ,CAAC;IAED,WAAW;QACT,MAAM,KAAK,GAA4B,EAAE,CAAC;QAC1C,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACrC,MAAM,IAAI,GAA2B,EAAE,CAAC;YACxC,KAAK,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC1D,IAAI,CAAC,OAAO,CAAC,GAAG,MAAM,CAAE,OAA4C,EAAE,IAAI,EAAE,QAAQ,IAAI,QAAQ,CAAC,CAAC;YACpG,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC;QACvD,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,CAAC;IACnB,CAAC;CACF"}

package/dist/plugins/types.d.ts

@@ -0,0 +1,67 @@
+import type { z } from "zod";
+import type { ChannelAdapter } from "../channels/adapter.js";
+import type { ChannelAccountConfig } from "../config/types.js";
+import type { Logger } from "../logging/logger.js";
+import type { IrisConfig } from "../config/types.js";
+export interface IrisPlugin {
+    readonly id: string;
+    readonly name?: string;
+    readonly version?: string;
+    register(api: IrisPluginApi): void | Promise<void>;
+}
+export interface IrisPluginApi {
+    registerTool(name: string, def: PluginToolDef): void;
+    registerChannel(id: string, factory: ChannelFactory): void;
+    registerService(name: string, service: PluginService): void;
+    registerHook<K extends keyof HookMap>(event: K, handler: HookHandler<K>): void;
+    readonly config: Readonly<IrisConfig>;
+    readonly logger: Logger;
+    readonly stateDir: string;
+}
+export interface PluginToolDef {
+    readonly description: string;
+    readonly args: Record<string, z.ZodTypeAny>;
+    execute(args: Record<string, unknown>, ctx: ToolExecContext): Promise<unknown>;
+}
+export interface ToolExecContext {
+    readonly sessionId: string | null;
+    readonly senderId: string | null;
+    readonly channelId: string | null;
+    readonly logger: Logger;
+}
+export type ChannelFactory = (config: ChannelAccountConfig, signal: AbortSignal) => ChannelAdapter;
+export interface PluginService {
+    start(ctx: ServiceContext): Promise<void>;
+    stop(): Promise<void>;
+}
+export interface ServiceContext {
+    readonly config: Readonly<IrisConfig>;
+    readonly logger: Logger;
+    readonly stateDir: string;
+    readonly signal: AbortSignal;
+}
+export interface HookMap {
+    "message.inbound": {
+        message: {
+            channelId: string;
+            senderId: string;
+            text: string;
+        };
+    };
+    "message.outbound": {
+        channelId: string;
+        chatId: string;
+        text: string;
+    };
+    "gateway.ready": void;
+    "gateway.shutdown": void;
+}
+export type HookHandler<K extends keyof HookMap> = HookMap[K] extends void ? () => void | Promise<void> : (data: HookMap[K]) => void | Promise<void>;
+export interface PluginManifestTool {
+    readonly description: string;
+    readonly args: Record<string, string>;
+}
+export interface PluginManifest {
+    readonly tools: Record<string, PluginManifestTool>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/plugins/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/plugins/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpD;AAED,MAAM,WAAW,aAAa;IAC5B,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,GAAG,IAAI,CAAC;IACrD,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI,CAAC;IAC3D,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI,CAAC;IAC5D,YAAY,CAAC,CAAC,SAAS,MAAM,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAC/E,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC;IAC5C,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAChF;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,oBAAoB,EAAE,MAAM,EAAE,WAAW,KAAK,cAAc,CAAC;AAEnG,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;CAC9B;AAGD,MAAM,WAAW,OAAO;IACtB,iBAAiB,EAAE;QAAE,OAAO,EAAE;YAAE,SAAS,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;IACtF,kBAAkB,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACxE,eAAe,EAAE,IAAI,CAAC;IACtB,kBAAkB,EAAE,IAAI,CAAC;CAC1B;AAED,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,MAAM,OAAO,IAC7C,OAAO,CAAC,CAAC,CAAC,SAAS,IAAI,GACnB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAC1B,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEjD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;CACpD"}

package/dist/plugins/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/plugins/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/plugins/types.ts"],"names":[],"mappings":""}

package/dist/proactive/engine.d.ts

@@ -0,0 +1,46 @@
+import type { IntentStore } from "./store.js";
+import type { ProactiveConfig } from "./types.js";
+import type { OpenCodeBridge } from "../bridge/opencode-client.js";
+import type { MessageRouter } from "../bridge/message-router.js";
+import type { SessionMap } from "../bridge/session-map.js";
+import type { VaultStore } from "../vault/store.js";
+import type { ChannelRegistry } from "../channels/registry.js";
+import type { Logger } from "../logging/logger.js";
+import type { InstanceCoordinator } from "../instance/coordinator.js";
+interface PulseEngineDeps {
+    store: IntentStore;
+    bridge: OpenCodeBridge;
+    router: MessageRouter;
+    sessionMap: SessionMap;
+    vaultStore: VaultStore;
+    registry: ChannelRegistry;
+    logger: Logger;
+    config: ProactiveConfig;
+    coordinator?: InstanceCoordinator;
+}
+export declare class PulseEngine {
+    private readonly store;
+    private readonly bridge;
+    private readonly router;
+    private readonly sessionMap;
+    private readonly vaultStore;
+    private readonly registry;
+    private readonly logger;
+    private readonly config;
+    private fastTimer;
+    private slowTimer;
+    private readonly coordinator?;
+    constructor(deps: PulseEngineDeps);
+    start(): void;
+    stop(): void;
+    tick(): Promise<void>;
+    passiveScan(): Promise<void>;
+    private executeIntent;
+    private executeTrigger;
+    private executeProactive;
+    private buildIntentPrompt;
+    private buildTriggerPrompt;
+    private isQuietHours;
+}
+export {};
+//# sourceMappingURL=engine.d.ts.map

package/dist/proactive/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/proactive/engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAqC,MAAM,YAAY,CAAC;AACrF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEtE,UAAU,eAAe;IACvB,KAAK,EAAE,WAAW,CAAC;IACnB,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,EAAE,aAAa,CAAC;IACtB,UAAU,EAAE,UAAU,CAAC;IACvB,UAAU,EAAE,UAAU,CAAC;IACvB,QAAQ,EAAE,eAAe,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,eAAe,CAAC;IACxB,WAAW,CAAC,EAAE,mBAAmB,CAAC;CACnC;AAKD,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;IAC3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IAEzC,OAAO,CAAC,SAAS,CAA+C;IAChE,OAAO,CAAC,SAAS,CAA+C;IAChE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAsB;gBAEvC,IAAI,EAAE,eAAe;IAYjC,KAAK,IAAI,IAAI;IAoBb,IAAI,IAAI,IAAI;IAYN,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAkBrB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;YA4BpB,aAAa;YA2Cb,cAAc;YAuCd,gBAAgB;IAmD9B,OAAO,CAAC,iBAAiB;IA+BzB,OAAO,CAAC,kBAAkB;IAuB1B,OAAO,CAAC,YAAY;CAwBrB"}

package/dist/proactive/engine.js

@@ -0,0 +1,238 @@
+const SKIP_MARKER = "[SKIP]";
+const DEFER_REGEX = /^\[DEFER\s+(\d+)h\]$/i;
+export class PulseEngine {
+    store;
+    bridge;
+    router;
+    sessionMap;
+    vaultStore;
+    registry;
+    logger;
+    config;
+    fastTimer = null;
+    slowTimer = null;
+    coordinator;
+    constructor(deps) {
+        this.store = deps.store;
+        this.bridge = deps.bridge;
+        this.router = deps.router;
+        this.sessionMap = deps.sessionMap;
+        this.vaultStore = deps.vaultStore;
+        this.registry = deps.registry;
+        this.logger = deps.logger;
+        this.config = deps.config;
+        this.coordinator = deps.coordinator;
+    }
+    start() {
+        this.fastTimer = setInterval(() => {
+            this.tick().catch((err) => {
+                this.logger.error({ err }, "Pulse tick error");
+            });
+        }, this.config.pollIntervalMs);
+        this.fastTimer.unref();
+        if (this.config.dormancy.enabled) {
+            this.slowTimer = setInterval(() => {
+                this.passiveScan().catch((err) => {
+                    this.logger.error({ err }, "Passive scan error");
+                });
+            }, this.config.passiveScanIntervalMs);
+            this.slowTimer.unref();
+        }
+        this.logger.info("Proactive pulse engine started");
+    }
+    stop() {
+        if (this.fastTimer) {
+            clearInterval(this.fastTimer);
+            this.fastTimer = null;
+        }
+        if (this.slowTimer) {
+            clearInterval(this.slowTimer);
+            this.slowTimer = null;
+        }
+        this.logger.info("Proactive pulse engine stopped");
+    }
+    async tick() {
+        if (this.coordinator && !this.coordinator.leader)
+            return;
+        const purged = this.store.purgeExpired(this.config.intentDefaults.maxAgeMs);
+        if (purged > 0) {
+            this.logger.info({ purged }, "Purged expired proactive items");
+        }
+        const intents = this.store.listPendingIntents(10);
+        for (const intent of intents) {
+            await this.executeIntent(intent);
+        }
+        const triggers = this.store.listPendingTriggers(10);
+        for (const trigger of triggers) {
+            await this.executeTrigger(trigger);
+        }
+    }
+    async passiveScan() {
+        if (this.coordinator && !this.coordinator.leader)
+            return;
+        if (!this.config.dormancy.enabled)
+            return;
+        const dormant = this.store.listDormantUsers(this.config.dormancy.thresholdMs, 10);
+        for (const user of dormant) {
+            const daysInactive = Math.floor((Date.now() - user.lastSeen) / 86_400_000);
+            this.store.addTrigger({
+                type: "dormant_user",
+                channelId: user.channelId,
+                chatId: user.senderId,
+                senderId: user.senderId,
+                context: `User "${user.name ?? "unknown"}" inactive for ${daysInactive} days.`,
+                executeAt: Date.now() + 3_600_000,
+            });
+            this.logger.info({ senderId: user.senderId, daysInactive }, "Dormant user trigger created");
+        }
+    }
+    async executeIntent(intent) {
+        try {
+            if (intent.confidence < this.config.intentDefaults.confidenceThreshold) {
+                this.store.markIntentExecuted(intent.id, "low_confidence");
+                this.logger.debug({ id: intent.id, confidence: intent.confidence }, "Skipped low confidence intent");
+                return;
+            }
+            const quota = this.store.getQuotaStatus(intent.senderId, intent.channelId, this.config.softQuotas.perUserPerDay);
+            if (!quota.allowed) {
+                this.logger.debug({ id: intent.id, sentToday: quota.sentToday }, "Skipped: quota exceeded");
+                return;
+            }
+            if (this.store.getGlobalQuotaToday() >= this.config.softQuotas.globalPerDay) {
+                this.logger.debug({ id: intent.id }, "Skipped: global quota exceeded");
+                return;
+            }
+            // Intents are created during active conversations — don't gate by quiet hours.
+            // Quiet hours only apply to system-initiated triggers (dormancy, etc.).
+            const result = await this.executeProactive({
+                channelId: intent.channelId,
+                chatId: intent.chatId,
+                senderId: intent.senderId,
+                chatType: "dm",
+                prompt: this.buildIntentPrompt(intent, quota.engagementRate, quota.sentToday, quota.limit),
+                sourceId: intent.id,
+                sourceType: "intent",
+            });
+            this.store.markIntentExecuted(intent.id, result);
+        }
+        catch (err) {
+            this.logger.error({ err, id: intent.id }, "Intent execution failed");
+            this.store.markIntentExecuted(intent.id, "error");
+        }
+    }
+    async executeTrigger(trigger) {
+        try {
+            const quota = this.store.getQuotaStatus(trigger.senderId, trigger.channelId, this.config.softQuotas.perUserPerDay);
+            if (!quota.allowed) {
+                this.logger.debug({ id: trigger.id }, "Trigger skipped: quota exceeded");
+                return;
+            }
+            if (this.store.getGlobalQuotaToday() >= this.config.softQuotas.globalPerDay) {
+                this.logger.debug({ id: trigger.id }, "Trigger skipped: global quota exceeded");
+                return;
+            }
+            if (this.isQuietHours(trigger.senderId, trigger.channelId)) {
+                this.logger.debug({ id: trigger.id }, "Trigger skipped: quiet hours");
+                return;
+            }
+            const result = await this.executeProactive({
+                channelId: trigger.channelId,
+                chatId: trigger.chatId,
+                senderId: trigger.senderId,
+                chatType: "dm",
+                prompt: this.buildTriggerPrompt(trigger, quota.engagementRate, quota.sentToday, quota.limit),
+                sourceId: trigger.id,
+                sourceType: "trigger",
+            });
+            this.store.markTriggerExecuted(trigger.id, result);
+        }
+        catch (err) {
+            this.logger.error({ err, id: trigger.id }, "Trigger execution failed");
+            this.store.markTriggerExecuted(trigger.id, "error");
+        }
+    }
+    async executeProactive(params) {
+        const entry = await this.sessionMap.resolve(params.channelId, params.senderId, params.chatId, params.chatType, this.bridge);
+        const response = await this.bridge.sendAndWait(entry.openCodeSessionId, params.prompt);
+        if (!response || response.trim() === SKIP_MARKER) {
+            this.logger.info({ sourceId: params.sourceId }, "AI chose to skip");
+            return "skipped";
+        }
+        const deferMatch = response.trim().match(DEFER_REGEX);
+        if (deferMatch) {
+            const hours = parseInt(deferMatch[1], 10);
+            this.logger.info({ sourceId: params.sourceId, hours }, "AI deferred");
+            return "deferred";
+        }
+        await this.router.sendResponse(params.channelId, params.chatId, response);
+        this.store.logProactiveMessage({
+            senderId: params.senderId,
+            channelId: params.channelId,
+            type: params.sourceType,
+            sourceId: params.sourceId,
+        });
+        this.logger.info({ senderId: params.senderId, channelId: params.channelId, sourceType: params.sourceType }, "Proactive message sent");
+        return "sent";
+    }
+    buildIntentPrompt(intent, engagementRate, sentToday, limit) {
+        const elapsed = Date.now() - intent.createdAt;
+        const hoursAgo = Math.floor(elapsed / 3_600_000);
+        const timeAgo = hoursAgo >= 24
+            ? `${Math.floor(hoursAgo / 24)} days ago`
+            : `${hoursAgo} hours ago`;
+        const profile = this.vaultStore.getProfile(intent.senderId, intent.channelId);
+        const profileBlock = profile
+            ? `User: ${profile.name ?? "unknown"} | ${profile.timezone ?? "no timezone"} | ${profile.language ?? ""}`
+            : "User: unknown";
+        return `[PROACTIVE FOLLOW-UP]
+You registered an intent ${timeAgo}: "${intent.what}"
+${intent.why ? `Reason: "${intent.why}"` : ""}
+
+${profileBlock}
+Your quota: ${limit - sentToday}/${limit} proactive messages remaining today
+Your engagement rate: ${Math.round(engagementRate * 100)}% of proactive messages get replies
+
+Decide: Should you follow up now? If yes, compose a natural, helpful message.
+Use any tools you need (send_message, vault_remember, canvas_update, etc.).
+If not worth it, respond with just: [SKIP]
+If you want to try later, respond with: [DEFER Xh] (replace X with hours)`;
+    }
+    buildTriggerPrompt(trigger, engagementRate, sentToday, limit) {
+        const profile = this.vaultStore.getProfile(trigger.senderId, trigger.channelId);
+        const profileBlock = profile
+            ? `User: ${profile.name ?? "unknown"} | ${profile.timezone ?? "no timezone"} | ${profile.language ?? ""}`
+            : "User: unknown";
+        return `[PROACTIVE OUTREACH — ${trigger.type.replace(/_/g, " ").toUpperCase()}]
+${trigger.context}
+
+${profileBlock}
+Your quota: ${limit - sentToday}/${limit} proactive messages remaining today
+Your engagement rate: ${Math.round(engagementRate * 100)}% of proactive messages get replies
+
+Decide: Should you reach out? If yes, compose a natural, warm message.
+If not appropriate, respond with just: [SKIP]
+If you want to try later, respond with: [DEFER Xh]`;
+    }
+    isQuietHours(senderId, channelId) {
+        const profile = this.vaultStore.getProfile(senderId, channelId);
+        const tz = profile?.timezone;
+        let hour;
+        if (tz) {
+            try {
+                hour = parseInt(new Date().toLocaleString("en-US", { timeZone: tz, hour: "numeric", hour12: false }), 10);
+            }
+            catch {
+                hour = new Date().getHours();
+            }
+        }
+        else {
+            hour = new Date().getHours();
+        }
+        const { start, end } = this.config.quietHours;
+        if (start > end) {
+            return hour >= start || hour < end;
+        }
+        return hour >= start && hour < end;
+    }
+}
+//# sourceMappingURL=engine.js.map

package/dist/proactive/engine.js.map

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

package/dist/proactive/store.d.ts

@@ -0,0 +1,35 @@
+import type { VaultDB } from "../vault/db.js";
+import type { ProactiveIntent, ProactiveTrigger, QuotaStatus, DormantUser, AddIntentParams, AddTriggerParams } from "./types.js";
+interface LogParams {
+    readonly senderId: string;
+    readonly channelId: string;
+    readonly type: "intent" | "trigger";
+    readonly sourceId: string;
+}
+export declare class IntentStore {
+    private readonly db;
+    constructor(vaultDb: VaultDB);
+    addIntent(params: AddIntentParams): string;
+    listPendingIntents(limit?: number): ProactiveIntent[];
+    listAllPending(limit?: number): {
+        intents: ProactiveIntent[];
+        triggers: ProactiveTrigger[];
+    };
+    cancelIntent(id: string): boolean;
+    markIntentExecuted(id: string, result: string): void;
+    addTrigger(params: AddTriggerParams): string;
+    listPendingTriggers(limit?: number): ProactiveTrigger[];
+    hasPendingTrigger(senderId: string, type: string): boolean;
+    markTriggerExecuted(id: string, result: string): void;
+    logProactiveMessage(params: LogParams): string;
+    markEngaged(senderId: string, channelId: string): void;
+    getQuotaStatus(senderId: string, channelId: string, perUserPerDay: number): QuotaStatus;
+    getEngagementRate(senderId: string, channelId: string): number;
+    getGlobalQuotaToday(): number;
+    listDormantUsers(thresholdMs: number, limit: number): DormantUser[];
+    purgeExpired(maxAgeMs: number): number;
+    private toIntent;
+    private toTrigger;
+}
+export {};
+//# sourceMappingURL=store.d.ts.map

package/dist/proactive/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/proactive/store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,eAAe,EACf,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAEpB,UAAU,SAAS;IACjB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAER,OAAO,EAAE,OAAO;IAM5B,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM;IAwB1C,kBAAkB,CAAC,KAAK,SAAK,GAAG,eAAe,EAAE;IAWjD,cAAc,CAAC,KAAK,SAAK,GAAG;QAAE,OAAO,EAAE,eAAe,EAAE,CAAC;QAAC,QAAQ,EAAE,gBAAgB,EAAE,CAAA;KAAE;IAOxF,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAOjC,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAQpD,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM;IAY5C,mBAAmB,CAAC,KAAK,SAAK,GAAG,gBAAgB,EAAE;IAWnD,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO;IAS1D,mBAAmB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAQrD,mBAAmB,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM;IAW9C,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAatD,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,WAAW;IAsBvF,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM;IAa9D,mBAAmB,IAAI,MAAM;IAW7B,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,EAAE;IAuBnE,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAatC,OAAO,CAAC,QAAQ;IAkBhB,OAAO,CAAC,SAAS;CAalB"}