@chozzz/vargos 2.0.4 → 2.0.6

package/dist/lib/strip-markdown.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Strip markdown formatting for plain-text channels (WhatsApp, Telegram).
+ * Preserves content, removes syntax characters.
+ */
+/** Remove markdown formatting, preserving readable plain text. */
+export declare function stripMarkdown(text: string): string;
+//# sourceMappingURL=strip-markdown.d.ts.map

package/dist/lib/strip-markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strip-markdown.d.ts","sourceRoot":"","sources":["../../lib/strip-markdown.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,kEAAkE;AAClE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAyBlD"}

package/dist/lib/strip-markdown.js

@@ -0,0 +1,32 @@
+/**
+ * Strip markdown formatting for plain-text channels (WhatsApp, Telegram).
+ * Preserves content, removes syntax characters.
+ */
+/** Remove markdown formatting, preserving readable plain text. */
+export function stripMarkdown(text) {
+    return text
+        // Headers: "## Heading" → "Heading"
+        .replace(/^#{1,6}\s+/gm, '')
+        // Bold/italic: **text**, __text__, *text*, _text_
+        .replace(/(\*{1,3}|_{1,3})(.+?)\1/g, '$2')
+        // Strikethrough: ~~text~~
+        .replace(/~~(.+?)~~/g, '$1')
+        // Code blocks: ```lang\ncode\n``` → code (must come before inline code)
+        .replace(/```[\w]*\n?([\s\S]*?)```/g, '$1')
+        // Inline code: `code`
+        .replace(/`([^`]+)`/g, '$1')
+        // Links: [text](url) → text (url)
+        .replace(/\[([^\]]+)\]\(([^)]+)\)/g, '$1 ($2)')
+        // Images: ![alt](url) → alt
+        .replace(/!\[([^\]]*)\]\([^)]+\)/g, '$1')
+        // Horizontal rules
+        .replace(/^[-*_]{3,}\s*$/gm, '')
+        // Unordered list markers: "- item" or "* item" → "• item"
+        .replace(/^[\t ]*[-*+]\s+/gm, '• ')
+        // Blockquotes: "> text" → "text"
+        .replace(/^>\s?/gm, '')
+        // Collapse 3+ newlines to 2
+        .replace(/\n{3,}/g, '\n\n')
+        .trim();
+}
+//# sourceMappingURL=strip-markdown.js.map

package/dist/lib/strip-markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strip-markdown.js","sourceRoot":"","sources":["../../lib/strip-markdown.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,kEAAkE;AAClE,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,IAAI;QACT,oCAAoC;SACnC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC;QAC5B,kDAAkD;SACjD,OAAO,CAAC,0BAA0B,EAAE,IAAI,CAAC;QAC1C,0BAA0B;SACzB,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC;QAC5B,wEAAwE;SACvE,OAAO,CAAC,2BAA2B,EAAE,IAAI,CAAC;QAC3C,sBAAsB;SACrB,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC;QAC5B,kCAAkC;SACjC,OAAO,CAAC,0BAA0B,EAAE,SAAS,CAAC;QAC/C,4BAA4B;SAC3B,OAAO,CAAC,yBAAyB,EAAE,IAAI,CAAC;QACzC,mBAAmB;SAClB,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC;QAChC,0DAA0D;SACzD,OAAO,CAAC,mBAAmB,EAAE,IAAI,CAAC;QACnC,iCAAiC;SAChC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC;QACvB,4BAA4B;SAC3B,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC;SAC1B,IAAI,EAAE,CAAC;AACZ,CAAC"}

package/dist/lib/subagent.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Pure session key helpers — no domain dependencies.
+ */
+export declare function cronSessionKey(taskId: string): string;
+export declare function webhookSessionKey(hookId: string): string;
+export declare function parseSessionKey(key: string): {
+    type: string;
+    id: string;
+};
+export declare function parseChannelTarget(target: string): {
+    channel: string;
+    userId: string;
+} | null;
+//# sourceMappingURL=subagent.d.ts.map

package/dist/lib/subagent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent.d.ts","sourceRoot":"","sources":["../../lib/subagent.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAExD;AASD,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAGzE;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAG7F"}

package/dist/lib/subagent.js

@@ -0,0 +1,25 @@
+/**
+ * Pure session key helpers — no domain dependencies.
+ */
+export function cronSessionKey(taskId) {
+    return `cron:${taskId}:${new Date().toISOString().slice(0, 10)}`;
+}
+export function webhookSessionKey(hookId) {
+    return `webhook:${hookId}:${Date.now()}`;
+}
+/** Parse "type:id" format from a string, extracting first component. */
+function parseTypeIdFormat(str) {
+    const sep = str.indexOf(':');
+    if (sep === -1)
+        return { type: str, id: '' };
+    return { type: str.slice(0, sep), id: str.slice(sep + 1) };
+}
+export function parseSessionKey(key) {
+    const root = key.split(':subagent')[0];
+    return parseTypeIdFormat(root);
+}
+export function parseChannelTarget(target) {
+    const { type: channel, id: userId } = parseTypeIdFormat(target);
+    return userId ? { channel, userId } : null;
+}
+//# sourceMappingURL=subagent.js.map

package/dist/lib/subagent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent.js","sourceRoot":"","sources":["../../lib/subagent.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,OAAO,QAAQ,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC9C,OAAO,WAAW,MAAM,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;AAC3C,CAAC;AAED,wEAAwE;AACxE,SAAS,iBAAiB,CAAC,GAAW;IACpC,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,GAAG,KAAK,CAAC,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC;IAC7C,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IACvC,OAAO,iBAAiB,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC/C,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAChE,OAAO,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7C,CAAC"}

package/dist/lib/templates.d.ts

@@ -0,0 +1,8 @@
+/** Walk up from this module to locate `.templates/vargos/`. Works in both dev and dist layouts. */
+export declare function findTemplatesRoot(): string | null;
+/** Seed `dataDir` from `.templates/vargos/` — recursively copies any missing files. User edits are preserved; user deletes will be re-seeded on next boot. */
+export declare function seedDataDir(dataDir: string, logger: {
+    info: (s: string) => void;
+    warn: (s: string) => void;
+}): Promise<void>;
+//# sourceMappingURL=templates.d.ts.map

package/dist/lib/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../lib/templates.ts"],"names":[],"mappings":"AAIA,mGAAmG;AACnG,wBAAgB,iBAAiB,IAAI,MAAM,GAAG,IAAI,CAQjD;AAqBD,8JAA8J;AAC9J,wBAAsB,WAAW,CAC/B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE;IAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,GAC/D,OAAO,CAAC,IAAI,CAAC,CAOf"}

package/dist/lib/templates.js

@@ -0,0 +1,39 @@
+import { promises as fs, existsSync } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+/** Walk up from this module to locate `.templates/vargos/`. Works in both dev and dist layouts. */
+export function findTemplatesRoot() {
+    let dir = path.dirname(fileURLToPath(import.meta.url));
+    while (dir !== path.dirname(dir)) {
+        const candidate = path.join(dir, '.templates', 'vargos');
+        if (existsSync(candidate))
+            return candidate;
+        dir = path.dirname(dir);
+    }
+    return null;
+}
+/** Walks both trees in parallel; copies only leaf files that don't exist on target. */
+async function copyMissing(srcDir, destDir, logger) {
+    await fs.mkdir(destDir, { recursive: true });
+    for (const entry of await fs.readdir(srcDir, { withFileTypes: true })) {
+        const src = path.join(srcDir, entry.name);
+        const dest = path.join(destDir, entry.name);
+        if (entry.isDirectory()) {
+            await copyMissing(src, dest, logger);
+        }
+        else if (!existsSync(dest)) {
+            await fs.copyFile(src, dest);
+            logger.info(`seeded ${dest}`);
+        }
+    }
+}
+/** Seed `dataDir` from `.templates/vargos/` — recursively copies any missing files. User edits are preserved; user deletes will be re-seeded on next boot. */
+export async function seedDataDir(dataDir, logger) {
+    const root = findTemplatesRoot();
+    if (!root) {
+        logger.warn('.templates/vargos not found — skipping seed');
+        return;
+    }
+    await copyMissing(root, dataDir, logger);
+}
+//# sourceMappingURL=templates.js.map

package/dist/lib/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../lib/templates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrD,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,mGAAmG;AACnG,MAAM,UAAU,iBAAiB;IAC/B,IAAI,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACvD,OAAO,GAAG,KAAK,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACjC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC;QACzD,IAAI,UAAU,CAAC,SAAS,CAAC;YAAE,OAAO,SAAS,CAAC;QAC5C,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,uFAAuF;AACvF,KAAK,UAAU,WAAW,CACxB,MAAc,EACd,OAAe,EACf,MAAqC;IAErC,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QACtE,MAAM,GAAG,GAAI,IAAI,CAAC,IAAI,CAAC,MAAM,EAAG,KAAK,CAAC,IAAI,CAAC,CAAC;QAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,MAAM,WAAW,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QACvC,CAAC;aAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7B,MAAM,EAAE,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAC7B,MAAM,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;AACH,CAAC;AAED,8JAA8J;AAC9J,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,OAAe,EACf,MAAgE;IAEhE,MAAM,IAAI,GAAG,iBAAiB,EAAE,CAAC;IACjC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;QAC3D,OAAO;IACT,CAAC;IACD,MAAM,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;AAC3C,CAAC"}

package/dist/lib/timeout.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Execute a promise with timeout protection.
+ * Rejects with an error if the promise doesn't complete within the specified time.
+ */
+export declare function withTimeout<T>(promise: Promise<T>, timeoutMs: number, message?: string): Promise<T>;
+//# sourceMappingURL=timeout.d.ts.map

package/dist/lib/timeout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout.d.ts","sourceRoot":"","sources":["../../lib/timeout.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAMnG"}

package/dist/lib/timeout.js

@@ -0,0 +1,11 @@
+/**
+ * Execute a promise with timeout protection.
+ * Rejects with an error if the promise doesn't complete within the specified time.
+ */
+export function withTimeout(promise, timeoutMs, message) {
+    const timeoutPromise = new Promise((_resolve, reject) => {
+        setTimeout(() => reject(new Error(message ?? `Timeout after ${timeoutMs}ms`)), timeoutMs);
+    });
+    return Promise.race([promise, timeoutPromise]);
+}
+//# sourceMappingURL=timeout.js.map

package/dist/lib/timeout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout.js","sourceRoot":"","sources":["../../lib/timeout.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAI,OAAmB,EAAE,SAAiB,EAAE,OAAgB;IACrF,MAAM,cAAc,GAAG,IAAI,OAAO,CAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE;QAC7D,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,IAAI,iBAAiB,SAAS,IAAI,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IAC5F,CAAC,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC;AACjD,CAAC"}

package/dist/lib/truncate.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Truncate large text content using head/tail strategy.
+ * Keeps 70% from start, 20% from end, with ellipsis indicator in middle.
+ *
+ * Useful for: log entries, large files, prompt sections, debug output.
+ *
+ * Example:
+ *   truncate("very long text...", 100) → "start text...\n\n[...truncated...]\n\n...text"
+ */
+export declare function truncate(content: string, maxChars: number): string;
+//# sourceMappingURL=truncate.d.ts.map

package/dist/lib/truncate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"truncate.d.ts","sourceRoot":"","sources":["../../lib/truncate.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAOlE"}

package/dist/lib/truncate.js

@@ -0,0 +1,17 @@
+/**
+ * Truncate large text content using head/tail strategy.
+ * Keeps 70% from start, 20% from end, with ellipsis indicator in middle.
+ *
+ * Useful for: log entries, large files, prompt sections, debug output.
+ *
+ * Example:
+ *   truncate("very long text...", 100) → "start text...\n\n[...truncated...]\n\n...text"
+ */
+export function truncate(content, maxChars) {
+    if (content.length <= maxChars)
+        return content;
+    const headChars = Math.floor(maxChars * 0.7);
+    const tailChars = Math.floor(maxChars * 0.2);
+    return `${content.slice(0, headChars)}\n\n[...truncated...]\n\n${content.slice(-tailChars)}`;
+}
+//# sourceMappingURL=truncate.js.map

package/dist/lib/truncate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"truncate.js","sourceRoot":"","sources":["../../lib/truncate.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,UAAU,QAAQ,CAAC,OAAe,EAAE,QAAgB;IACxD,IAAI,OAAO,CAAC,MAAM,IAAI,QAAQ;QAAE,OAAO,OAAO,CAAC;IAE/C,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,GAAG,CAAC,CAAC;IAC7C,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,GAAG,CAAC,CAAC;IAE7C,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,4BAA4B,OAAO,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC;AAC/F,CAAC"}

package/dist/lib/url-expand.d.ts

@@ -0,0 +1,22 @@
+/**
+ * URL extraction and content fetching utilities.
+ * No domain imports — safe to use from any layer.
+ */
+/** Extract unique http/https URLs from text, up to maxUrls (default 3). */
+export declare function extractUrls(text: string, maxUrls?: number): string[];
+/** Return false for private/internal addresses, non-http schemes, or invalid URLs. */
+export declare function isAllowedUrl(url: string): boolean;
+export interface FetchedContent {
+    url: string;
+    title?: string;
+    text: string;
+}
+/**
+ * Fetch URL, convert HTML to readable text, truncate to maxChars.
+ * Returns null on any error — never throws.
+ */
+export declare function fetchUrlContent(url: string, opts?: {
+    maxChars?: number;
+    timeoutMs?: number;
+}): Promise<FetchedContent | null>;
+//# sourceMappingURL=url-expand.d.ts.map

package/dist/lib/url-expand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-expand.d.ts","sourceRoot":"","sources":["../../lib/url-expand.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,2EAA2E;AAC3E,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,SAAI,GAAG,MAAM,EAAE,CAgB/D;AAED,sFAAsF;AACtF,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAYjD;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,MAAM,EACX,IAAI,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GACnD,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAmChC"}

package/dist/lib/url-expand.js

@@ -0,0 +1,74 @@
+/**
+ * URL extraction and content fetching utilities.
+ * No domain imports — safe to use from any layer.
+ */
+import { stripHtml } from './html.js';
+const PRIVATE_HOSTNAME_RE = /^(localhost|127\.\d+\.\d+\.\d+|10\.\d+\.\d+\.\d+|172\.(1[6-9]|2\d|3[01])\.\d+\.\d+|192\.168\.\d+\.\d+|169\.254\.\d+\.\d+|\[::1\])$/i;
+/** Extract unique http/https URLs from text, up to maxUrls (default 3). */
+export function extractUrls(text, maxUrls = 3) {
+    const matches = text.match(/https?:\/\/[^\s<>[\]()]+/g) ?? [];
+    const seen = new Set();
+    const results = [];
+    for (const raw of matches) {
+        // Strip trailing punctuation that's almost never part of a URL
+        const url = raw.replace(/[.,;:!?]+$/, '');
+        if (!seen.has(url)) {
+            seen.add(url);
+            results.push(url);
+            if (results.length >= maxUrls)
+                break;
+        }
+    }
+    return results;
+}
+/** Return false for private/internal addresses, non-http schemes, or invalid URLs. */
+export function isAllowedUrl(url) {
+    let parsed;
+    try {
+        parsed = new URL(url);
+    }
+    catch {
+        return false;
+    }
+    if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:')
+        return false;
+    const hostname = parsed.hostname;
+    return !PRIVATE_HOSTNAME_RE.test(hostname);
+}
+/**
+ * Fetch URL, convert HTML to readable text, truncate to maxChars.
+ * Returns null on any error — never throws.
+ */
+export async function fetchUrlContent(url, opts = {}) {
+    const { maxChars = 8000, timeoutMs = 5000 } = opts;
+    try {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), timeoutMs);
+        let response;
+        try {
+            response = await fetch(url, { signal: controller.signal });
+        }
+        finally {
+            clearTimeout(timer);
+        }
+        if (!response.ok)
+            return null;
+        const contentType = response.headers.get('content-type') ?? '';
+        const isHtml = contentType.includes('text/html');
+        const isText = contentType.includes('text/plain') || contentType.includes('text/markdown');
+        if (!isHtml && !isText)
+            return null;
+        const raw = await response.text();
+        if (isHtml) {
+            const titleMatch = raw.match(/<title[^>]*>([^<]*)<\/title>/i);
+            const title = titleMatch ? titleMatch[1].trim() : undefined;
+            const text = stripHtml(raw).slice(0, maxChars);
+            return { url, title, text };
+        }
+        return { url, text: raw.slice(0, maxChars) };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=url-expand.js.map

package/dist/lib/url-expand.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chozzz/vargos",
-  "version": "2.0.4",
+  "version": "2.0.6",
   "description": "Self-hosted agent OS with persistent memory, multi-channel presence, tools, scheduling, and sub-agent orchestration",
   "license": "Apache-2.0",
   "author": "Vadi Taslim",
@@ -28,6 +28,7 @@
     "dist/cli.d.ts",
     "dist/cli.d.ts.map",
     "dist/cli/",
+    "dist/lib/",
     "dist/.templates/",
     "README.md",
     "LICENSE",