aiden-runtime 4.0.1 → 4.1.0

package/dist/core/channels/discord.js

@@ -20,21 +20,27 @@ exports.DiscordAdapter = void 0;
 //   - Graceful degradation: missing token → disabled, no crash
 const discord_js_1 = require("discord.js");
 const gateway_1 = require("../gateway");
+const logger_1 = require("../v4/logger");
 class DiscordAdapter {
     constructor() {
         this.name = 'discord';
         this.client = null;
         this.healthy = false;
+        // Phase v4.1-1.3a — diagnostics route through the channel scope
+        // logger; ChannelManager.register injects it. Default noop keeps
+        // pre-attach calls silent.
+        this.log = (0, logger_1.noopLogger)();
         this.token = process.env.DISCORD_BOT_TOKEN ?? '';
         const rawGuilds = process.env.DISCORD_ALLOWED_GUILDS ?? '';
         const rawChannels = process.env.DISCORD_ALLOWED_CHANNELS ?? '';
         this.allowedGuilds = rawGuilds ? new Set(rawGuilds.split(',').map(s => s.trim()).filter(Boolean)) : new Set();
         this.allowedChannels = rawChannels ? new Set(rawChannels.split(',').map(s => s.trim()).filter(Boolean)) : new Set();
     }
+    attachLogger(logger) { this.log = logger; }
     // ── Lifecycle ──────────────────────────────────────────────
     async start() {
         if (!this.token) {
-            console.log('[Discord] Disabled — set DISCORD_BOT_TOKEN to enable');
+            this.log.info('Disabled — set DISCORD_BOT_TOKEN to enable');
             return;
         }
         this.client = new discord_js_1.Client({
@@ -46,14 +52,14 @@ class DiscordAdapter {
             ],
         });
         this.client.once(discord_js_1.Events.ClientReady, async (c) => {
-            console.log(`[Discord] Connected as ${c.user.tag}`);
+            this.log.info(`Connected as ${c.user.tag}`);
             this.healthy = true;
             // Register outbound delivery so gateway.deliver() and broadcast() work
             gateway_1.gateway.registerChannel('discord', async (msg) => {
                 return this.deliverToChannel(msg.channelId, msg.text);
             });
             // Register slash commands globally (takes ~1h to propagate on first run)
-            await this.registerSlashCommands(c.user.id).catch((e) => console.warn('[Discord] Slash command registration failed:', e.message));
+            await this.registerSlashCommands(c.user.id).catch((e) => this.log.warn(`Slash command registration failed: ${e.message}`));
         });
         this.client.on(discord_js_1.Events.MessageCreate, async (message) => {
             if (!this.shouldHandle(message.author.id, message.guildId, message.channelId, message.author.bot))
@@ -63,7 +69,7 @@ class DiscordAdapter {
             }
             catch { }
             const response = await this.processMessage(message.channelId, message.author.id, message.content);
-            await message.reply(response.substring(0, 2000)).catch((e) => console.error('[Discord] Reply error:', e.message));
+            await message.reply(response.substring(0, 2000)).catch((e) => this.log.error(`Reply error: ${e.message}`));
         });
         this.client.on(discord_js_1.Events.InteractionCreate, async (interaction) => {
             if (!interaction.isChatInputCommand())
@@ -84,7 +90,7 @@ class DiscordAdapter {
                 const prompt = interaction.options.getString('prompt', true);
                 await interaction.deferReply();
                 const response = await this.processMessage(channelId, userId, prompt);
-                await interaction.editReply(response.substring(0, 2000)).catch((e) => console.error('[Discord] editReply error:', e.message));
+                await interaction.editReply(response.substring(0, 2000)).catch((e) => this.log.error(`editReply error: ${e.message}`));
             }
             else if (interaction.commandName === 'aiden-help') {
                 await interaction.reply({
@@ -97,7 +103,7 @@ class DiscordAdapter {
             await this.client.login(this.token);
         }
         catch (e) {
-            console.error('[Discord] Login failed:', e.message);
+            this.log.error(`Login failed: ${e.message}`);
             this.healthy = false;
         }
     }
@@ -108,7 +114,7 @@ class DiscordAdapter {
             await this.client.destroy();
             this.client = null;
         }
-        console.log('[Discord] Disconnected');
+        this.log.info('Disconnected');
     }
     async send(channelId, message) {
         await this.deliverToChannel(channelId, message);
@@ -135,7 +141,7 @@ class DiscordAdapter {
             });
         }
         catch (e) {
-            console.error('[Discord] routeMessage error:', e.message);
+            this.log.error(`routeMessage error: ${e.message}`);
             return '❌ Something went wrong. Try again.';
         }
     }
@@ -149,7 +155,7 @@ class DiscordAdapter {
             return false;
         }
         catch (e) {
-            console.error('[Discord] Delivery error:', e.message);
+            this.log.error(`Delivery error: ${e.message}`);
             return false;
         }
     }
@@ -167,7 +173,7 @@ class DiscordAdapter {
                 .toJSON(),
         ];
         await rest.put(discord_js_1.Routes.applicationCommands(appId), { body: commands });
-        console.log('[Discord] Slash commands registered globally');
+        this.log.info('Slash commands registered globally');
     }
 }
 exports.DiscordAdapter = DiscordAdapter;

package/dist/core/channels/email.js

@@ -33,9 +33,12 @@ exports.EmailAdapter = void 0;
 //   EMAIL_POLL_INTERVAL     — polling interval in seconds (default 60)
 const nodemailer_1 = __importDefault(require("nodemailer"));
 const gateway_1 = require("../gateway");
+const logger_1 = require("../v4/logger");
 class EmailAdapter {
     constructor() {
         this.name = 'email';
+        // Phase v4.1-1.3a — diagnostics route through scope logger.
+        this.log = (0, logger_1.noopLogger)();
         this.healthy = false;
         this.pollTimer = null;
         this.processedIds = new Set();
@@ -52,14 +55,15 @@ class EmailAdapter {
         this.allowedSenders = raw ? new Set(raw.split(',').map(s => s.trim().toLowerCase()).filter(Boolean)) : new Set();
         this.pollIntervalMs = parseInt(process.env.EMAIL_POLL_INTERVAL ?? '60', 10) * 1000;
     }
+    attachLogger(logger) { this.log = logger; }
     // ── Lifecycle ──────────────────────────────────────────────
     async start() {
         if (!this.imapHost || !this.imapUser || !this.imapPassword) {
-            console.log('[Email] Disabled — set EMAIL_IMAP_HOST, EMAIL_IMAP_USER, EMAIL_IMAP_PASSWORD to enable');
+            this.log.info('Disabled — set EMAIL_IMAP_HOST, EMAIL_IMAP_USER, EMAIL_IMAP_PASSWORD to enable');
             return;
         }
         if (!this.smtpHost || !this.smtpUser || !this.smtpPassword) {
-            console.log('[Email] Disabled — set EMAIL_SMTP_HOST, EMAIL_SMTP_USER, EMAIL_SMTP_PASSWORD to enable');
+            this.log.info('Disabled — set EMAIL_SMTP_HOST, EMAIL_SMTP_USER, EMAIL_SMTP_PASSWORD to enable');
             return;
         }
         // Set up SMTP transporter
@@ -75,11 +79,11 @@ class EmailAdapter {
         // Verify SMTP connection
         const smtpOk = await this.transporter.verify().then(() => true).catch(() => false);
         if (!smtpOk) {
-            console.log('[Email] Disabled — SMTP connection failed. Check EMAIL_SMTP_* settings.');
+            this.log.info('Disabled — SMTP connection failed. Check EMAIL_SMTP_* settings.');
             return;
         }
         this.healthy = true;
-        console.log(`[Email] Ready — polling ${this.imapUser} every ${this.pollIntervalMs / 1000}s`);
+        this.log.info('Ready — polling ${this.imapUser} every ${this.pollIntervalMs / 1000}s');
         // Register outbound delivery
         gateway_1.gateway.registerChannel('email', async (msg) => {
             await this.send(msg.channelId, msg.text);
@@ -97,7 +101,7 @@ class EmailAdapter {
         }
         this.transporter = null;
         gateway_1.gateway.unregisterChannel('email');
-        console.log('[Email] Disconnected');
+        this.log.info('Disconnected');
     }
     async send(target, message) {
         if (!this.transporter)
@@ -112,7 +116,7 @@ class EmailAdapter {
             });
         }
         catch (e) {
-            console.error('[Email] send error:', e.message);
+            this.log.error(`send error:${e.message}`);
         }
     }
     isHealthy() { return this.healthy; }
@@ -191,7 +195,7 @@ class EmailAdapter {
         }
         catch (e) {
             if (this.healthy) {
-                console.error('[Email] poll error:', e.message);
+                this.log.error(`poll error:${e.message}`);
             }
         }
         finally {
@@ -217,7 +221,7 @@ class EmailAdapter {
             });
         }
         catch (e) {
-            console.error('[Email] reply error:', e.message);
+            this.log.error(`reply error:${e.message}`);
         }
     }
     extractText(raw) {
@@ -245,7 +249,7 @@ class EmailAdapter {
             });
         }
         catch (e) {
-            console.error('[Email] routeMessage error:', e.message);
+            this.log.error(`routeMessage error:${e.message}`);
             return 'Something went wrong processing your email. Please try again.';
         }
     }

package/dist/core/channels/imessage.js

@@ -26,9 +26,12 @@ exports.IMessageAdapter = void 0;
 const axios_1 = __importDefault(require("axios"));
 const ws_1 = require("ws");
 const gateway_1 = require("../gateway");
+const logger_1 = require("../v4/logger");
 class IMessageAdapter {
     constructor() {
         this.name = 'imessage';
+        // Phase v4.1-1.3a — diagnostics route through scope logger.
+        this.log = (0, logger_1.noopLogger)();
         this.healthy = false;
         this.ws = null;
         this.reconnectTimer = null;
@@ -37,20 +40,21 @@ class IMessageAdapter {
         const raw = process.env.BLUEBUBBLES_ALLOWED_NUMBERS ?? '';
         this.allowedNumbers = raw ? new Set(raw.split(',').map(s => s.trim()).filter(Boolean)) : new Set();
     }
+    attachLogger(logger) { this.log = logger; }
     // ── Lifecycle ──────────────────────────────────────────────
     async start() {
         if (!this.baseUrl || !this.password) {
-            console.log('[iMessage] Disabled — set BLUEBUBBLES_URL and BLUEBUBBLES_PASSWORD to enable');
+            this.log.info('Disabled — set BLUEBUBBLES_URL and BLUEBUBBLES_PASSWORD to enable');
             return;
         }
         // Verify BlueBubbles is reachable
         const reachable = await this.checkHealth();
         if (!reachable) {
-            console.log(`[iMessage] Disabled — BlueBubbles server not reachable at ${this.baseUrl}`);
+            this.log.info('Disabled — BlueBubbles server not reachable at ${this.baseUrl}');
             return;
         }
         this.healthy = true;
-        console.log(`[iMessage] Connected to BlueBubbles at ${this.baseUrl}`);
+        this.log.info('Connected to BlueBubbles at ${this.baseUrl}');
         // Register outbound delivery
         gateway_1.gateway.registerChannel('imessage', async (msg) => {
             await this.send(msg.channelId, msg.text);
@@ -70,7 +74,7 @@ class IMessageAdapter {
             this.ws = null;
         }
         gateway_1.gateway.unregisterChannel('imessage');
-        console.log('[iMessage] Disconnected');
+        this.log.info('Disconnected');
     }
     async send(target, message) {
         if (!this.healthy)
@@ -82,7 +86,7 @@ class IMessageAdapter {
             });
         }
         catch (e) {
-            console.error('[iMessage] send error:', e.message);
+            this.log.error(`send error:${e.message}`);
         }
     }
     isHealthy() { return this.healthy; }
@@ -105,7 +109,7 @@ class IMessageAdapter {
         const wsUrl = this.baseUrl.replace(/^http/, 'ws');
         this.ws = new ws_1.WebSocket(`${wsUrl}?password=${encodeURIComponent(this.password)}`);
         this.ws.on('open', () => {
-            console.log('[iMessage] WebSocket connected');
+            this.log.info('WebSocket connected');
         });
         this.ws.on('message', async (raw) => {
             try {
@@ -127,11 +131,11 @@ class IMessageAdapter {
                 await this.send(chatId || sender, response);
             }
             catch (e) {
-                console.error('[iMessage] message parse error:', e.message);
+                this.log.error(`message parse error:${e.message}`);
             }
         });
         this.ws.on('error', (e) => {
-            console.error('[iMessage] WebSocket error:', e.message);
+            this.log.error(`WebSocket error:${e.message}`);
         });
         this.ws.on('close', () => {
             if (this.healthy) {
@@ -156,7 +160,7 @@ class IMessageAdapter {
             });
         }
         catch (e) {
-            console.error('[iMessage] routeMessage error:', e.message);
+            this.log.error(`routeMessage error:${e.message}`);
             return '❌ Something went wrong. Try again.';
         }
     }

package/dist/core/channels/manager.js

@@ -5,15 +5,31 @@
 // ============================================================
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.channelManager = exports.ChannelManager = void 0;
-// ── ChannelManager ─────────────────────────────────────────
+const logger_1 = require("../v4/logger");
 class ChannelManager {
-    constructor() {
+    constructor(opts = {}) {
         this.adapters = new Map();
         this.lastActivity = new Map();
+        this.log = opts.logger ?? (0, logger_1.noopLogger)();
     }
-    /** Register an adapter — must be called before startAll() */
+    /**
+     * Phase v4.1-1.3a — late-binding logger setter. Lets the singleton
+     * pick up a real logger after construction (api/server.ts boot path
+     * imports the singleton; we can't change its constructor without
+     * breaking every existing import site).
+     */
+    attachLogger(logger) {
+        this.log = logger;
+    }
+    /** Register an adapter — must be called before startAll(). */
     register(adapter) {
         this.adapters.set(adapter.name, adapter);
+        // Phase v4.1-1.3a — hand the adapter a scoped child logger so its
+        // own diagnostics route through the same sink chain as the manager.
+        // Adapters that haven't been migrated yet skip silently (no method).
+        if (typeof adapter.attachLogger === 'function') {
+            adapter.attachLogger(this.log.child(adapter.name));
+        }
     }
     /**
      * Start all registered adapters.
@@ -29,11 +45,13 @@ class ChannelManager {
                 results.push({ name, status });
             }
             catch (error) {
-                console.error(`[ChannelManager] ${name} failed to start:`, error.message);
+                this.log.error(`${name} failed to start: ${error.message}`);
                 results.push({ name, status: 'failed', error: String(error.message) });
             }
         }
-        // Summary line
+        // Summary line — single info record so log files capture the
+        // boot snapshot. CLI mode: routes to file only (REPL stays clean).
+        // Serve mode: routes to NDJSON stdout for log aggregators.
         const summary = results
             .map(r => {
             if (r.status === 'started')
@@ -44,7 +62,7 @@ class ChannelManager {
         })
             .join(' | ');
         if (results.length > 0)
-            console.log(`[Channels] ${summary}`);
+            this.log.info(`startup: ${summary}`);
         return results;
     }
     /** Gracefully stop all adapters — called on SIGTERM / shutdown */
@@ -54,7 +72,7 @@ class ChannelManager {
                 await adapter.stop();
             }
             catch (e) {
-                console.error(`[ChannelManager] Error stopping ${adapter.name}:`, e.message);
+                this.log.error(`Error stopping ${adapter.name}: ${e.message}`);
             }
         }
     }

package/dist/core/channels/pdf-extract.js

@@ -0,0 +1,180 @@
+"use strict";
+// ============================================================
+// DevOS — Autonomous AI Execution System
+// Copyright (c) 2026 Shiva Deore. All rights reserved.
+// ============================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HARD_CHAR_CAP = exports.MAX_PDF_BYTES = void 0;
+exports.extractPdfForChannel = extractPdfForChannel;
+// core/channels/pdf-extract.ts — Phase v4.1-4.
+//
+// Channel-side adapter for inbound PDFs. Wraps the existing
+// `core/fileIngestion.ts` `extractPDF` function with the policies
+// the Telegram adapter cares about:
+//
+//   1. 20 MB pre-download size cap matching Telegram's documented
+//      Bot API getFile attachment limit. Refusing here keeps the
+//      polling loop from spending bandwidth on a payload Telegram
+//      would refuse to deliver anyway.
+//   2. Token-budget truncation. The agent loop has to fit the PDF
+//      content INSIDE the user turn alongside system prompts, prior
+//      history, and a reserve for the response. We cap injected text
+//      at the lesser of:
+//        - 50,000 characters (hard ceiling — keeps pathological
+//          200-page PDFs from blowing the budget on small models)
+//        - (modelContextWindow - 8K reserved-for-response) * 4
+//          chars/token (rough OpenAI heuristic, errs on the safe side)
+//      and report `{ truncated: true, originalChars }` so the channel
+//      adapter can append a "PDF truncated to fit context, original
+//      was N chars" note inside the agent annotation.
+//   3. Result-shape contract that maps onto the bracketed user-turn
+//      annotation the adapter emits. Failures return `success:false`
+//      with a human-readable `error` so the agent gets a directive
+//      ("[transcription failed: …. Apologize and ask them to send a
+//      shorter file.]") instead of an empty message.
+//
+// Logger comes from the v4.1-1.3a contract; defaults to a noop sink.
+const node_fs_1 = require("node:fs");
+const fileIngestion_1 = require("../fileIngestion");
+const logger_1 = require("../v4/logger");
+// 20 MiB. Telegram's documented Bot API attachment download limit.
+// Anything bigger would have been refused by getFile upstream, so
+// we reject here without spending bandwidth on the round-trip.
+exports.MAX_PDF_BYTES = 20 * 1024 * 1024;
+/** Hard ceiling on injected PDF text — protects small-context models. */
+exports.HARD_CHAR_CAP = 50000;
+/** Reserved tokens for the agent's response when computing context budget. */
+const RESPONSE_RESERVED_TOKENS = 8000;
+/** Conservative chars-per-token estimate for budget math. */
+const CHARS_PER_TOKEN = 4;
+/**
+ * Extract a PDF and return text bounded by the channel-layer's
+ * truncation policy. Never throws — failures land on
+ * `success: false` with a human-readable `error`.
+ */
+async function extractPdfForChannel(opts) {
+    const log = opts.logger ?? (0, logger_1.noopLogger)();
+    const cap = opts.maxBytesOverride ?? exports.MAX_PDF_BYTES;
+    // ── 1. Size precheck ────────────────────────────────────────────
+    let sizeBytes;
+    try {
+        const st = await node_fs_1.promises.stat(opts.filePath);
+        sizeBytes = st.size;
+    }
+    catch (e) {
+        log.warn('pdf file not readable', { path: opts.filePath, error: e?.message });
+        return { success: false, truncated: false, error: `pdf file not readable: ${e?.message ?? 'unknown error'}` };
+    }
+    if (sizeBytes > cap) {
+        log.warn('pdf file too large', { sizeBytes, cap });
+        return {
+            success: false,
+            truncated: false,
+            error: `PDF too large: ${(sizeBytes / (1024 * 1024)).toFixed(1)} MB ` +
+                `(cap is ${(cap / (1024 * 1024)).toFixed(0)} MB).`,
+        };
+    }
+    // ── 2. Hand off to the local extractor ──────────────────────────
+    const extractor = opts.extractFn ?? fileIngestion_1.extractPDF;
+    let extracted;
+    try {
+        extracted = await extractor(opts.filePath);
+    }
+    catch (e) {
+        log.error('pdf extraction threw', { error: e?.message ?? String(e) });
+        return {
+            success: false,
+            truncated: false,
+            error: `pdf extraction failed: ${e?.message ?? 'unknown error'}`,
+        };
+    }
+    const fullText = (extracted.text ?? '').trim();
+    if (!fullText) {
+        log.warn('pdf extracted empty text', { pageCount: extracted.pageCount });
+        return {
+            success: false,
+            truncated: false,
+            pageCount: extracted.pageCount,
+            error: 'pdf extraction returned empty text (scanned image PDF?)',
+        };
+    }
+    // ── 3. Truncation budget ────────────────────────────────────────
+    const charBudget = computeCharBudget(opts.modelContextWindow);
+    const originalChars = fullText.length;
+    if (originalChars <= charBudget) {
+        log.info('pdf extracted', {
+            pageCount: extracted.pageCount,
+            chars: originalChars,
+            truncated: false,
+        });
+        return {
+            success: true,
+            text: fullText,
+            truncated: false,
+            originalChars,
+            pageCount: extracted.pageCount,
+            wordCount: extracted.wordCount,
+        };
+    }
+    // Truncate to the budget — slice on a sentence/paragraph boundary
+    // when one's available within the last 1 KB of the budget so we
+    // don't mid-word the agent's view of the text.
+    const truncatedText = truncateOnBoundary(fullText, charBudget);
+    log.info('pdf extracted (truncated)', {
+        pageCount: extracted.pageCount,
+        originalChars,
+        finalChars: truncatedText.length,
+        budget: charBudget,
+    });
+    return {
+        success: true,
+        text: truncatedText,
+        truncated: true,
+        originalChars,
+        pageCount: extracted.pageCount,
+        wordCount: countWords(truncatedText),
+    };
+}
+/**
+ * Compute the truncation budget. When `modelContextWindow` is given,
+ * subtract 8K reserved-for-response tokens, multiply by 4 chars/token,
+ * and cap at the hard 50K ceiling. When not given, fall back to the
+ * hard ceiling. Always returns at least 4 KB so a tiny-context model
+ * doesn't end up with nothing.
+ */
+function computeCharBudget(modelContextWindow) {
+    if (typeof modelContextWindow !== 'number' || !Number.isFinite(modelContextWindow) || modelContextWindow <= 0) {
+        return exports.HARD_CHAR_CAP;
+    }
+    const usableTokens = Math.max(0, modelContextWindow - RESPONSE_RESERVED_TOKENS);
+    const usableChars = usableTokens * CHARS_PER_TOKEN;
+    const budget = Math.min(exports.HARD_CHAR_CAP, usableChars);
+    return Math.max(budget, 4000);
+}
+/**
+ * Slice `text` at `cap` characters but try to land on the last newline
+ * in the trailing 1 KB of the cap, falling back to the last sentence
+ * terminator, finally a hard cut.
+ */
+function truncateOnBoundary(text, cap) {
+    if (text.length <= cap)
+        return text;
+    const window = text.slice(0, cap);
+    const tailStart = Math.max(0, cap - 1024);
+    const lastNewline = window.lastIndexOf('\n', cap);
+    if (lastNewline >= tailStart)
+        return window.slice(0, lastNewline);
+    // Match common sentence terminators; English-centric but Devanagari
+    // and Latin punctuation both work since `.` is in the regex.
+    const terminator = window.slice(tailStart).search(/[.!?।]\s/);
+    if (terminator >= 0) {
+        const cutAt = tailStart + terminator + 1;
+        return window.slice(0, cutAt);
+    }
+    return window;
+}
+function countWords(text) {
+    if (!text)
+        return 0;
+    return text.trim().split(/\s+/).filter(Boolean).length;
+}