@cogitator-ai/channels 0.2.4 → 0.3.0

package/dist/middleware/pairing.js.map

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

package/dist/middleware/rate-limit.d.ts

@@ -6,9 +6,11 @@ export interface RateLimitConfig {
 export declare class RateLimitMiddleware implements GatewayMiddleware {
     private readonly config;
     readonly name = "rate-limit";
-    private buckets;
+    private readonly buckets;
+    private lastSweep;
     constructor(config: RateLimitConfig);
     handle(msg: ChannelMessage, ctx: MiddlewareContext, next: () => Promise<void>): Promise<void>;
+    private sweep;
 }
 export declare function rateLimit(config: RateLimitConfig): GatewayMiddleware;
 //# sourceMappingURL=rate-limit.d.ts.map

package/dist/middleware/rate-limit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rate-limit.d.ts","sourceRoot":"","sources":["../../src/middleware/rate-limit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAEhG,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAMD,qBAAa,mBAAoB,YAAW,iBAAiB;IAI/C,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHnC,QAAQ,CAAC,IAAI,gBAAgB;IAC7B,OAAO,CAAC,OAAO,CAAiC;gBAEnB,MAAM,EAAE,eAAe;IAE9C,MAAM,CACV,GAAG,EAAE,cAAc,EACnB,GAAG,EAAE,iBAAiB,EACtB,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GACxB,OAAO,CAAC,IAAI,CAAC;CAwBjB;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,iBAAiB,CAEpE"}
+{"version":3,"file":"rate-limit.d.ts","sourceRoot":"","sources":["../../src/middleware/rate-limit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAEhG,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AASD,qBAAa,mBAAoB,YAAW,iBAAiB;IAK/C,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJnC,QAAQ,CAAC,IAAI,gBAAgB;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiC;IACzD,OAAO,CAAC,SAAS,CAAK;gBAEO,MAAM,EAAE,eAAe;IAE9C,MAAM,CACV,GAAG,EAAE,cAAc,EACnB,GAAG,EAAE,iBAAiB,EACtB,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GACxB,OAAO,CAAC,IAAI,CAAC;IA8BhB,OAAO,CAAC,KAAK;CASd;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,iBAAiB,CAEpE"}

package/dist/middleware/rate-limit.js

@@ -1,29 +1,44 @@
+const WINDOW_MS = 60_000;
 export class RateLimitMiddleware {
     config;
     name = 'rate-limit';
     buckets = new Map();
+    lastSweep = 0;
     constructor(config) {
         this.config = config;
     }
     async handle(msg, ctx, next) {
         const userKey = `${msg.channelType}:${msg.userId}`;
         const now = Date.now();
-        const windowMs = 60_000;
+        this.sweep(now);
         let bucket = this.buckets.get(userKey);
         if (!bucket) {
-            bucket = { timestamps: [] };
+            bucket = { timestamps: [], notified: false };
             this.buckets.set(userKey, bucket);
         }
-        bucket.timestamps = bucket.timestamps.filter((t) => now - t < windowMs);
+        bucket.timestamps = bucket.timestamps.filter((t) => now - t < WINDOW_MS);
         if (bucket.timestamps.length >= this.config.maxPerMinute) {
-            const replyText = this.config.message ??
-                `Rate limit exceeded. Please wait a moment before sending another message.`;
-            await ctx.channel.sendText(msg.channelId, replyText);
+            if (!bucket.notified) {
+                bucket.notified = true;
+                await ctx.channel.sendText(msg.channelId, this.config.message ??
+                    'Rate limit exceeded. Please wait a moment before sending another message.');
+            }
             return;
         }
+        bucket.notified = false;
         bucket.timestamps.push(now);
         await next();
     }
+    sweep(now) {
+        if (now - this.lastSweep < WINDOW_MS)
+            return;
+        this.lastSweep = now;
+        for (const [key, bucket] of this.buckets) {
+            if (bucket.timestamps.every((t) => now - t >= WINDOW_MS)) {
+                this.buckets.delete(key);
+            }
+        }
+    }
 }
 export function rateLimit(config) {
     return new RateLimitMiddleware(config);

package/dist/middleware/rate-limit.js.map

@@ -1 +1 @@
-{"version":3,"file":"rate-limit.js","sourceRoot":"","sources":["../../src/middleware/rate-limit.ts"],"names":[],"mappings":"AAWA,MAAM,OAAO,mBAAmB;IAID;IAHpB,IAAI,GAAG,YAAY,CAAC;IACrB,OAAO,GAAG,IAAI,GAAG,EAAsB,CAAC;IAEhD,YAA6B,MAAuB;QAAvB,WAAM,GAAN,MAAM,CAAiB;IAAG,CAAC;IAExD,KAAK,CAAC,MAAM,CACV,GAAmB,EACnB,GAAsB,EACtB,IAAyB;QAEzB,MAAM,OAAO,GAAG,GAAG,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;QACnD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,QAAQ,GAAG,MAAM,CAAC;QAExB,IAAI,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACvC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,GAAG,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;YAC5B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACpC,CAAC;QAED,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC;QAExE,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;YACzD,MAAM,SAAS,GACb,IAAI,CAAC,MAAM,CAAC,OAAO;gBACnB,2EAA2E,CAAC;YAC9E,MAAM,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YACrD,OAAO;QACT,CAAC;QAED,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC5B,MAAM,IAAI,EAAE,CAAC;IACf,CAAC;CACF;AAED,MAAM,UAAU,SAAS,CAAC,MAAuB;IAC/C,OAAO,IAAI,mBAAmB,CAAC,MAAM,CAAC,CAAC;AACzC,CAAC"}
+{"version":3,"file":"rate-limit.js","sourceRoot":"","sources":["../../src/middleware/rate-limit.ts"],"names":[],"mappings":"AAYA,MAAM,SAAS,GAAG,MAAM,CAAC;AAEzB,MAAM,OAAO,mBAAmB;IAKD;IAJpB,IAAI,GAAG,YAAY,CAAC;IACZ,OAAO,GAAG,IAAI,GAAG,EAAsB,CAAC;IACjD,SAAS,GAAG,CAAC,CAAC;IAEtB,YAA6B,MAAuB;QAAvB,WAAM,GAAN,MAAM,CAAiB;IAAG,CAAC;IAExD,KAAK,CAAC,MAAM,CACV,GAAmB,EACnB,GAAsB,EACtB,IAAyB;QAEzB,MAAM,OAAO,GAAG,GAAG,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;QACnD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAEhB,IAAI,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACvC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,GAAG,EAAE,UAAU,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;YAC7C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACpC,CAAC;QAED,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC;QAEzE,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;YACzD,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;gBACrB,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC;gBACvB,MAAM,GAAG,CAAC,OAAO,CAAC,QAAQ,CACxB,GAAG,CAAC,SAAS,EACb,IAAI,CAAC,MAAM,CAAC,OAAO;oBACjB,2EAA2E,CAC9E,CAAC;YACJ,CAAC;YACD,OAAO;QACT,CAAC;QAED,MAAM,CAAC,QAAQ,GAAG,KAAK,CAAC;QACxB,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC5B,MAAM,IAAI,EAAE,CAAC;IACf,CAAC;IAEO,KAAK,CAAC,GAAW;QACvB,IAAI,GAAG,GAAG,IAAI,CAAC,SAAS,GAAG,SAAS;YAAE,OAAO;QAC7C,IAAI,CAAC,SAAS,GAAG,GAAG,CAAC;QACrB,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACzC,IAAI,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,IAAI,SAAS,CAAC,EAAE,CAAC;gBACzD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC3B,CAAC;QACH,CAAC;IACH,CAAC;CACF;AAED,MAAM,UAAU,SAAS,CAAC,MAAuB;IAC/C,OAAO,IAAI,mBAAmB,CAAC,MAAM,CAAC,CAAC;AACzC,CAAC"}

package/dist/runtime-builder.d.ts

@@ -17,16 +17,27 @@ export interface RuntimeBuilderOpts {
         stringifyYaml: (o: unknown) => string;
         validateConfig: (o: unknown) => unknown;
     };
+    /**
+     * Invoked when the assistant needs to restart (config change, `/restart`).
+     * Defaults to exiting the process with code 78, which `cogitator up` treats as a restart request.
+     */
+    onRestart?: () => void;
 }
+export declare const RESTART_EXIT_CODE = 78;
 export declare class RuntimeBuilder {
     private config;
     private env;
     private opts?;
     constructor(config: AssistantConfig, env: Record<string, string | undefined>, opts?: RuntimeBuilderOpts | undefined);
     build(): Promise<BuiltRuntime>;
+    private requestRestart;
+    private collectOwnerIds;
+    private resolveFileSystemRoots;
+    private buildMemoryBackends;
     private createExtractorBackend;
     private wireBrowser;
     private ensurePlaywright;
+    private playwrightCacheDir;
     private wireRAG;
     private wireMCPServers;
     private resolveEmbeddingConfig;

package/dist/runtime-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-builder.d.ts","sourceRoot":"","sources":["../src/runtime-builder.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,EACL,SAAS,EAUV,MAAM,oBAAoB,CAAC;AAY5B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAkBjD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAEhE,MAAM,MAAM,eAAe,GAAG,qBAAqB,CAAC;AAEpD,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,KAAK,CAAC;IACb,SAAS,EAAE,SAAS,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACrC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAOD,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE;QACd,SAAS,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;QAClC,aAAa,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,MAAM,CAAC;QACtC,cAAc,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC;KACzC,CAAC;CACH;AAED,qBAAa,cAAc;IAEvB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,GAAG;IACX,OAAO,CAAC,IAAI,CAAC;gBAFL,MAAM,EAAE,eAAe,EACvB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EACvC,IAAI,CAAC,EAAE,kBAAkB,YAAA;IAG7B,KAAK,IAAI,OAAO,CAAC,YAAY,CAAC;IA6PpC,OAAO,CAAC,sBAAsB;YAqBhB,WAAW;YAiEX,gBAAgB;YAchB,OAAO;YAqDP,cAAc;IA6B5B,OAAO,CAAC,sBAAsB;IAkC9B,OAAO,KAAK,WAAW,GAItB;IAED,OAAO,CAAC,cAAc;IAyBtB,OAAO,CAAC,aAAa;IAuCrB,OAAO,CAAC,cAAc;IActB,OAAO,CAAC,iBAAiB;IA+FzB,OAAO,CAAC,gBAAgB;YAaV,kBAAkB;IAgBhC,OAAO,CAAC,eAAe;CAOxB"}
+{"version":3,"file":"runtime-builder.d.ts","sourceRoot":"","sources":["../src/runtime-builder.ts"],"names":[],"mappings":"AAYA,OAAO,EACL,KAAK,EACL,SAAS,EAUV,MAAM,oBAAoB,CAAC;AAe5B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAkBjD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAEhE,MAAM,MAAM,eAAe,GAAG,qBAAqB,CAAC;AAEpD,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,KAAK,CAAC;IACb,SAAS,EAAE,SAAS,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACrC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAgBD,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE;QACd,SAAS,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;QAClC,aAAa,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,MAAM,CAAC;QACtC,cAAc,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC;KACzC,CAAC;IACF;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;CACxB;AAED,eAAO,MAAM,iBAAiB,KAAK,CAAC;AA2BpC,qBAAa,cAAc;IAEvB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,GAAG;IACX,OAAO,CAAC,IAAI,CAAC;gBAFL,MAAM,EAAE,eAAe,EACvB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EACvC,IAAI,CAAC,EAAE,kBAAkB,YAAA;IAG7B,KAAK,IAAI,OAAO,CAAC,YAAY,CAAC;IA6SpC,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,sBAAsB;YAMhB,mBAAmB;IAoDjC,OAAO,CAAC,sBAAsB;YAqBhB,WAAW;YAiEX,gBAAgB;IAQ9B,OAAO,CAAC,kBAAkB;YAeZ,OAAO;YA4DP,cAAc;IAoC5B,OAAO,CAAC,sBAAsB;IAkC9B,OAAO,KAAK,WAAW,GAItB;IAED,OAAO,CAAC,cAAc;IAyBtB,OAAO,CAAC,aAAa;IAuCrB,OAAO,CAAC,cAAc;IAoBtB,OAAO,CAAC,iBAAiB;IA0FzB,OAAO,CAAC,gBAAgB;YAaV,kBAAkB;IAgBhC,OAAO,CAAC,eAAe;CAOxB"}

package/dist/runtime-builder.js

@@ -1,9 +1,12 @@
+import { existsSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { join } from 'node:path';
 import { Agent, Cogitator, builtinTools, createMemoryTools, createSchedulerTools, createCapabilitiesTool, createDeviceTools, createSelfTools, loadCustomTools, parseModel, tool as createTool, } from '@cogitator-ai/core';
-import { SQLiteAdapter, SQLiteGraphAdapter, CoreFactsStore, LLMEntityExtractor, createEmbeddingService, InMemoryEmbeddingAdapter, } from '@cogitator-ai/memory';
+import { SQLiteAdapter, SQLiteGraphAdapter, PostgresAdapter, PostgresGraphAdapter, CoreFactsStore, LLMEntityExtractor, createEmbeddingService, InMemoryEmbeddingAdapter, } from '@cogitator-ai/memory';
 import { createSelfConfigTools } from './tools/self-config.js';
+import { restrictFileTools } from './tools/path-guard.js';
 import { Gateway } from './gateway.js';
+import { getNextCronMs } from './cron.js';
 import { HeartbeatScheduler } from './heartbeat.js';
 import { SimpleTimerStore } from './simple-timer-store.js';
 import { telegramChannel } from './channels/telegram.js';
@@ -13,13 +16,37 @@ import { terminalChannel } from './channels/terminal.js';
 import { ownerCommands } from './middleware/owner-commands.js';
 import { rateLimit } from './middleware/rate-limit.js';
 import { autoExtract } from './middleware/auto-extract.js';
-import { dmPolicy } from './middleware/dm-policy.js';
+import { DmPolicyMiddleware } from './middleware/dm-policy.js';
 import { generateCapabilitiesDoc } from './capabilities.js';
 import { MediaProcessor } from './media/media-processor.js';
 import { LocalWhisper } from './media/whisper-local.js';
 import { createWhisperDownloadTool } from './media/whisper-tool.js';
 import { GroqSttProvider, OpenAISttProvider } from './media/whisper-api.js';
 import { DeepgramSttProvider } from './media/deepgram-stt.js';
+export const RESTART_EXIT_CODE = 78;
+const MODULE_NOT_FOUND_CODES = new Set(['ERR_MODULE_NOT_FOUND', 'MODULE_NOT_FOUND']);
+function isModuleNotFound(err, specifier) {
+    if (!(err instanceof Error))
+        return false;
+    const code = err.code;
+    return !!code && MODULE_NOT_FOUND_CODES.has(code) && err.message.includes(specifier);
+}
+function expandHome(path) {
+    return path.startsWith('~') ? path.replace(/^~/, homedir()) : path;
+}
+function localIsoDate(date) {
+    const pad = (n) => String(n).padStart(2, '0');
+    return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}`;
+}
+function formatDuration(ms) {
+    const minutes = Math.floor(ms / 60_000);
+    if (minutes < 60)
+        return `${minutes}m`;
+    const hours = Math.floor(minutes / 60);
+    if (hours < 24)
+        return `${hours}h ${minutes % 60}m`;
+    return `${Math.floor(hours / 24)}d ${hours % 24}h`;
+}
 export class RuntimeBuilder {
     config;
     env;
@@ -32,17 +59,9 @@ export class RuntimeBuilder {
     async build() {
         const cogitator = this.buildCogitator();
         const cleanupResources = { mcpClients: [] };
-        const memoryPath = this.config.memory.path ?? '~/.cogitator/memory.db';
-        const resolvedPath = memoryPath.replace(/^~/, homedir());
-        const memoryAdapter = new SQLiteAdapter({ provider: 'sqlite', path: resolvedPath });
-        await memoryAdapter.connect();
+        const { memoryAdapter, graphAdapter, coreFactsPath } = await this.buildMemoryBackends(cleanupResources);
         cogitator.memory = memoryAdapter;
-        let graphAdapter = null;
-        if (this.config.memory.knowledgeGraph !== false) {
-            graphAdapter = new SQLiteGraphAdapter({ path: resolvedPath });
-            await graphAdapter.initialize();
-        }
-        const coreFacts = new CoreFactsStore({ path: resolvedPath });
+        const coreFacts = new CoreFactsStore({ path: coreFactsPath });
         await coreFacts.initialize();
         const tools = [];
         if (this.config.capabilities.webSearch) {
@@ -53,8 +72,10 @@ export class RuntimeBuilder {
                     tools.push(found);
             }
         }
-        if (this.config.capabilities.fileSystem) {
-            tools.push(...builtinTools.filter((t) => t.name.startsWith('file_')));
+        const fsCfg = this.config.capabilities.fileSystem;
+        if (fsCfg) {
+            const fileTools = builtinTools.filter((t) => t.name.startsWith('file_'));
+            tools.push(...restrictFileTools(fileTools, this.resolveFileSystemRoots()));
         }
         if (this.config.capabilities.github) {
             const found = builtinTools.find((t) => t.name === 'github_api');
@@ -73,28 +94,29 @@ export class RuntimeBuilder {
         if (this.config.capabilities.scheduler) {
             timerStore = new SimpleTimerStore({
                 persistPath: join(homedir(), '.cogitator', 'timers.json'),
+                resolveCronFiresAt: (cron, timezone) => getNextCronMs(cron, Date.now(), timezone),
             });
-            const channelEntries = Object.entries(this.config.channels ?? {});
-            const firstChannel = channelEntries[0];
-            const firstOwnerId = firstChannel
-                ? firstChannel[1]?.ownerIds?.[0]
-                : undefined;
+            const [firstChannelName, firstChannel] = Object.entries(this.config.channels).find(([, value]) => value !== undefined) ?? [undefined, undefined];
             tools.push(...createSchedulerTools({
                 store: timerStore,
-                defaultChannel: firstChannel?.[0] ?? 'system',
-                defaultUserId: firstOwnerId,
+                defaultChannel: firstChannelName ?? 'system',
+                defaultUserId: firstChannel?.ownerIds?.[0],
             }));
         }
         if (this.config.capabilities.deviceTools) {
             tools.push(...createDeviceTools());
         }
+        const ownerIds = this.collectOwnerIds();
+        const isOwner = (caller) => caller.channelType === 'terminal' ||
+            (!!caller.channelType && !!caller.userId && ownerIds[caller.channelType] === caller.userId);
         if (this.config.capabilities.selfConfig && this.opts?.configPath && this.opts.configHelpers) {
             tools.push(...createSelfConfigTools({
                 configPath: this.opts.configPath,
                 ...this.opts.configHelpers,
+                authorize: isOwner,
                 onConfigUpdated: () => {
                     console.log(`[${this.config.name}] Config updated, restarting...`);
-                    process.exit(78);
+                    this.requestRestart();
                 },
             }));
         }
@@ -117,47 +139,98 @@ export class RuntimeBuilder {
         await this.wireBrowser(tools, cleanupResources);
         await this.wireRAG(tools);
         await this.wireMCPServers(tools, cleanupResources);
-        const coreFactsText = await coreFacts.formatForPrompt();
         const channels = this.buildChannels();
         const capDoc = generateCapabilitiesDoc({
             tools: tools.map((t) => ({ name: t.name, description: t.description })),
             channels: channels.map((c) => c.type),
         });
         tools.push(createCapabilitiesTool(capDoc));
-        const instructions = this.buildInstructions(coreFactsText);
         const agent = new Agent({
             name: this.config.name,
             model: this.fullModelId,
-            instructions,
+            instructions: this.buildInstructions(await coreFacts.formatForPrompt(), new Date()),
             tools,
             maxIterations: 15,
         });
+        const modelOverrides = new Map();
+        let globalModel = this.fullModelId;
+        const agentForUser = async (user) => {
+            const model = modelOverrides.get(`${user.channelType}:${user.id}`) ??
+                modelOverrides.get(user.id) ??
+                globalModel;
+            const instructions = this.buildInstructions(await coreFacts.formatForPrompt(), new Date());
+            return new Agent({ ...agent.config, id: agent.id, model, instructions });
+        };
         const middleware = [];
-        const ownerIds = {};
-        if (this.config.channels.telegram?.ownerIds?.[0]) {
-            ownerIds.telegram = this.config.channels.telegram.ownerIds[0];
-        }
-        if (this.config.channels.discord?.ownerIds?.[0]) {
-            ownerIds.discord = this.config.channels.discord.ownerIds[0];
-        }
-        if (this.config.channels.slack?.ownerIds?.[0]) {
-            ownerIds.slack = this.config.channels.slack.ownerIds[0];
-        }
+        let gatewayRef = null;
+        let dmPolicyMiddleware = null;
         if (this.config.security) {
-            middleware.push(dmPolicy({
+            dmPolicyMiddleware = new DmPolicyMiddleware({
                 mode: this.config.security.dmPolicy,
                 allowlist: this.config.security.allowlist,
                 groupPolicy: this.config.security.groupPolicy,
                 groupAllowlist: this.config.security.groupAllowlist,
-                storePath: this.config.security.storePath,
+                storePath: this.config.security.storePath
+                    ? expandHome(this.config.security.storePath)
+                    : undefined,
                 ownerIds,
-            }));
+            });
+            middleware.push(dmPolicyMiddleware);
         }
         if (Object.keys(ownerIds).length > 0) {
             middleware.push(ownerCommands({
                 ownerIds,
                 authorizedUserIds: this.config.security?.commandAccess?.authorized,
                 publicCommands: this.config.security?.commandAccess?.publicCommands,
+                onStatus: () => {
+                    if (!gatewayRef)
+                        return 'Gateway is not running';
+                    const stats = gatewayRef.stats;
+                    return [
+                        `Assistant: ${this.config.name}`,
+                        `Model: ${globalModel}`,
+                        `Uptime: ${formatDuration(stats.uptime)}`,
+                        `Sessions: ${stats.activeSessions} active / ${stats.totalSessions} total`,
+                        `Messages today: ${stats.messagesToday}`,
+                        `Channels: ${stats.connectedChannels.join(', ')}`,
+                    ].join('\n');
+                },
+                onSessions: () => {
+                    const sessions = gatewayRef?.getSessions() ?? [];
+                    if (sessions.length === 0)
+                        return 'No sessions yet';
+                    return sessions
+                        .slice(0, 20)
+                        .map((s) => `${s.active ? '●' : '○'} ${s.threadId}${s.userName ? ` (${s.userName})` : ''} — ${s.messageCount} msg, ${formatDuration(Date.now() - s.lastActiveAt)} ago`)
+                        .join('\n');
+                },
+                onUsers: () => {
+                    const owners = Object.entries(ownerIds).map(([type, id]) => `${type}:${id} (owner)`);
+                    const approved = dmPolicyMiddleware
+                        ? dmPolicyMiddleware
+                            .getApprovedUsers()
+                            .filter((key) => !owners.some((o) => o.startsWith(`${key} `)))
+                        : [];
+                    return [...owners, ...approved].join('\n') || 'No users';
+                },
+                onCompact: async (target, threadId) => {
+                    if (!gatewayRef)
+                        return 'Gateway is not running';
+                    return gatewayRef.compactThread(target === 'current' ? threadId : target);
+                },
+                onModel: (model, forUser) => {
+                    const fullModel = model.includes('/') ? model : `${this.config.llm.provider}/${model}`;
+                    if (forUser) {
+                        const key = forUser.replace(/^@/, '');
+                        modelOverrides.set(key, fullModel);
+                        return `Model for ${key} set to: ${fullModel}`;
+                    }
+                    globalModel = fullModel;
+                    return `Model set to: ${fullModel}`;
+                },
+                onRestart: async () => {
+                    setTimeout(() => this.requestRestart(), 500);
+                },
             }));
         }
         if (this.config.rateLimit) {
@@ -192,14 +265,12 @@ export class RuntimeBuilder {
                 coreFacts,
             }));
         }
-        const streamConfig = this.config.stream
-            ? {
-                flushInterval: this.config.stream.flushInterval ?? 600,
-                minChunkSize: this.config.stream.minChunkSize ?? 30,
-            }
-            : { flushInterval: 600, minChunkSize: 30 };
+        const streamConfig = {
+            flushInterval: this.config.stream?.flushInterval ?? 600,
+            minChunkSize: this.config.stream?.minChunkSize ?? 30,
+        };
         const gateway = new Gateway({
-            agent,
+            agent: agentForUser,
             cogitator,
             channels,
             middleware,
@@ -219,6 +290,7 @@ export class RuntimeBuilder {
                 console.error(`[${this.config.name}] Error for ${msg.userId}:`, err.message);
             },
         });
+        gatewayRef = gateway;
         const scheduler = this.buildScheduler(timerStore, gateway);
         if (scheduler)
             scheduler.start();
@@ -227,9 +299,11 @@ export class RuntimeBuilder {
                 scheduler.stop();
             await gateway.stop();
             await coreFacts.close();
-            if (graphAdapter)
+            if (graphAdapter?.close)
                 await graphAdapter.close();
             await memoryAdapter.disconnect();
+            if (cleanupResources.pgPool)
+                await cleanupResources.pgPool.end().catch(() => { });
             if (cleanupResources.browserSession) {
                 await cleanupResources.browserSession.close().catch(() => { });
             }
@@ -240,6 +314,66 @@ export class RuntimeBuilder {
         };
         return { agent, cogitator, gateway, scheduler, cleanup };
     }
+    requestRestart() {
+        if (this.opts?.onRestart) {
+            this.opts.onRestart();
+            return;
+        }
+        process.exit(RESTART_EXIT_CODE);
+    }
+    collectOwnerIds() {
+        const ownerIds = {};
+        for (const [channel, cfg] of Object.entries(this.config.channels)) {
+            const owner = cfg?.ownerIds?.[0];
+            if (owner)
+                ownerIds[channel] = owner;
+        }
+        return ownerIds;
+    }
+    resolveFileSystemRoots() {
+        const fsCfg = this.config.capabilities.fileSystem;
+        const paths = fsCfg?.paths.length ? fsCfg.paths : [homedir()];
+        return paths.map(expandHome);
+    }
+    async buildMemoryBackends(resources) {
+        const memory = this.config.memory;
+        const sqlitePath = expandHome(memory.path ?? '~/.cogitator/memory.db');
+        const useGraph = memory.knowledgeGraph !== false;
+        if (memory.adapter === 'postgres') {
+            const connectionString = memory.connectionString ?? this.env.DATABASE_URL ?? this.env.POSTGRES_URL;
+            if (!connectionString) {
+                throw new Error('memory.adapter "postgres" requires memory.connectionString or DATABASE_URL in env');
+            }
+            const memoryAdapter = new PostgresAdapter({ provider: 'postgres', connectionString });
+            const connected = await memoryAdapter.connect();
+            if (!connected.success) {
+                throw new Error(`Failed to connect to Postgres: ${connected.error}`);
+            }
+            let graphAdapter = null;
+            if (useGraph) {
+                const pg = (await import('pg'));
+                const Pool = pg.Pool ?? pg.default?.Pool;
+                if (!Pool)
+                    throw new Error('The "pg" package does not export Pool');
+                const pool = new Pool({ connectionString });
+                resources.pgPool = pool;
+                graphAdapter = new PostgresGraphAdapter({ pool });
+                await graphAdapter.initialize();
+            }
+            return { memoryAdapter, graphAdapter, coreFactsPath: sqlitePath };
+        }
+        const memoryAdapter = new SQLiteAdapter({ provider: 'sqlite', path: sqlitePath });
+        const connected = await memoryAdapter.connect();
+        if (connected && !connected.success) {
+            throw new Error(`Failed to open SQLite memory at ${sqlitePath}: ${connected.error}`);
+        }
+        let graphAdapter = null;
+        if (useGraph) {
+            graphAdapter = new SQLiteGraphAdapter({ path: sqlitePath });
+            await graphAdapter.initialize();
+        }
+        return { memoryAdapter, graphAdapter, coreFactsPath: sqlitePath };
+    }
     createExtractorBackend(cogitator) {
         const llmBackend = cogitator.getLLMBackend(this.fullModelId);
         const modelName = parseModel(this.fullModelId).model;
@@ -310,15 +444,24 @@ export class RuntimeBuilder {
         }
     }
     async ensurePlaywright() {
-        const { existsSync } = await import('node:fs');
-        const { join } = await import('node:path');
-        const cacheDir = process.env.PLAYWRIGHT_BROWSERS_PATH ?? join(homedir(), 'Library', 'Caches', 'ms-playwright');
-        if (existsSync(cacheDir))
+        if (existsSync(this.playwrightCacheDir()))
             return;
         console.log('[RuntimeBuilder] Installing Playwright chromium...');
         const { execSync } = await import('node:child_process');
         execSync('npx playwright install chromium', { stdio: 'inherit' });
     }
+    playwrightCacheDir() {
+        if (process.env.PLAYWRIGHT_BROWSERS_PATH)
+            return process.env.PLAYWRIGHT_BROWSERS_PATH;
+        switch (process.platform) {
+            case 'darwin':
+                return join(homedir(), 'Library', 'Caches', 'ms-playwright');
+            case 'win32':
+                return join(process.env.LOCALAPPDATA ?? join(homedir(), 'AppData', 'Local'), 'ms-playwright');
+            default:
+                return join(process.env.XDG_CACHE_HOME ?? join(homedir(), '.cache'), 'ms-playwright');
+        }
+    }
     async wireRAG(tools) {
         if (!this.config.capabilities.rag)
             return;
@@ -356,8 +499,12 @@ export class RuntimeBuilder {
                 execute: ingestTool.execute,
             }));
         }
-        catch {
-            console.warn('[RuntimeBuilder] RAG capability requires @cogitator-ai/rag package');
+        catch (err) {
+            if (isModuleNotFound(err, '@cogitator-ai/rag')) {
+                console.warn('[RuntimeBuilder] RAG capability requires @cogitator-ai/rag package');
+                return;
+            }
+            console.warn('[RuntimeBuilder] RAG capability failed:', err instanceof Error ? err.message : String(err));
         }
     }
     async wireMCPServers(tools, resources) {
@@ -382,8 +529,12 @@ export class RuntimeBuilder {
                 }
             }
         }
-        catch {
-            console.warn('[RuntimeBuilder] MCP servers require @cogitator-ai/mcp package');
+        catch (err) {
+            if (isModuleNotFound(err, '@cogitator-ai/mcp')) {
+                console.warn('[RuntimeBuilder] MCP servers require @cogitator-ai/mcp package');
+                return;
+            }
+            console.warn('[RuntimeBuilder] MCP setup failed:', err instanceof Error ? err.message : String(err));
         }
     }
     resolveEmbeddingConfig() {
@@ -488,11 +639,13 @@ export class RuntimeBuilder {
                 await gateway.injectMessage(msg);
             },
             pollInterval: 30_000,
+            onError: (err, entry) => {
+                console.error(`[${this.config.name}] Scheduler error${entry ? ` for ${entry.id}` : ''}:`, err.message);
+            },
         });
     }
-    buildInstructions(coreFactsText) {
+    buildInstructions(coreFactsText, now) {
         let instructions = this.config.personality;
-        const now = new Date();
         const dateStr = now.toLocaleDateString('en-US', {
             weekday: 'long',
             year: 'numeric',
@@ -505,11 +658,8 @@ export class RuntimeBuilder {
             instructions += `\n\n## What I know about the user\n${coreFactsText}`;
         }
         instructions += `\n\nIMPORTANT: Use your tools when relevant. Don't guess answers when tools can provide accurate data.`;
-        const fsCfg = this.config.capabilities.fileSystem;
-        if (fsCfg) {
-            const paths = typeof fsCfg === 'object' && 'paths' in fsCfg
-                ? fsCfg.paths.map((p) => p.replace(/^~/, homedir()))
-                : [homedir()];
+        if (this.config.capabilities.fileSystem) {
+            const paths = this.resolveFileSystemRoots();
             instructions += `\nYou have filesystem access. Allowed paths: ${paths.join(', ')}. Use file_read, file_write, file_list tools. Always use absolute paths.`;
         }
         if (this.config.capabilities.browser) {
@@ -532,7 +682,7 @@ When to use — IMMEDIATELY call schedule_task when the user:
 Examples:
 - "Remind me to check Slack in 5 min" → schedule_task({description: "Check Slack", delay: "5m"})
 - "Every morning at 9" → schedule_task({description: "Morning briefing", cron: "0 9 * * *"})
-- "At 3pm today" → schedule_task({description: "...", at: "${new Date().toISOString().split('T')[0]}T15:00:00"})
+- "At 3pm today" → schedule_task({description: "...", at: "${localIsoDate(now)}T15:00:00"})
 
 The channel and userId are filled automatically from the current conversation — do NOT pass them manually.
 When the task fires, you will execute it — describe what to DO, not just what to say.