@runcore-sh/runcore 0.1.2

package/dist/scheduling/timer.js

@@ -0,0 +1,118 @@
+/**
+ * Background scheduling timer.
+ * Checks for upcoming/overdue blocks every 5 minutes.
+ * Follows src/google/calendar-timer.ts pattern: module-level state, idempotent start/stop.
+ *
+ * Behavior:
+ * 1. Blocks starting within 15 min → push notification
+ * 2. Blocks past end time + still planned → log activity (creates voltage)
+ * 3. Blocks 2+ hours overdue → auto-transition to skipped
+ * 4. Blocks whose start has arrived → auto-transition to active
+ */
+import { pushNotification } from "../goals/notifications.js";
+import { logActivity } from "../activity/log.js";
+import { getPressureIntegrator } from "../pulse/pressure.js";
+import { createLogger } from "../utils/logger.js";
+const log = createLogger("scheduling");
+const DEFAULT_INTERVAL_MS = 5 * 60 * 1000; // 5 minutes
+const SOON_THRESHOLD_MS = 15 * 60 * 1000; // 15 minutes
+const OVERDUE_SKIP_MS = 2 * 60 * 60 * 1000; // 2 hours
+let timer = null;
+const notifiedBlockIds = new Set();
+/**
+ * Start the scheduling timer. Idempotent.
+ */
+export function startSchedulingTimer(store, intervalMs) {
+    if (timer)
+        return;
+    const interval = intervalMs ?? DEFAULT_INTERVAL_MS;
+    timer = setInterval(async () => {
+        try {
+            await tick(store);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            logActivity({ source: "scheduling", summary: `Timer error: ${msg}` });
+        }
+    }, interval);
+    const mins = Math.round(interval / 60_000);
+    log.info(`Scheduling timer: every ${mins} min`);
+}
+async function tick(store) {
+    const now = Date.now();
+    // 1. Blocks whose start has arrived → activate
+    const readyToActivate = await store.getReadyToActivate();
+    for (const block of readyToActivate) {
+        await store.update(block.id, { status: "active" });
+        logActivity({ source: "scheduling", summary: `Block activated: ${block.title}` });
+    }
+    // 2. Upcoming blocks → notify
+    const upcoming = await store.getUpcoming(SOON_THRESHOLD_MS);
+    for (const block of upcoming) {
+        if (notifiedBlockIds.has(block.id))
+            continue;
+        notifiedBlockIds.add(block.id);
+        const startTime = new Date(block.start).getTime();
+        const minsAway = Math.round((startTime - now) / 60_000);
+        const msg = `Upcoming in ${minsAway} min: ${block.title}`;
+        pushNotification({
+            timestamp: new Date().toISOString(),
+            source: "scheduling",
+            message: msg,
+        });
+        logActivity({ source: "scheduling", summary: msg });
+    }
+    // 3. Overdue blocks → log activity (voltage) or auto-skip
+    const overdue = await store.getOverdue();
+    for (const block of overdue) {
+        const endTime = block.end
+            ? new Date(block.end).getTime()
+            : block.dueAt
+                ? new Date(block.dueAt).getTime()
+                : 0;
+        const overdueMs = now - endTime;
+        if (overdueMs >= OVERDUE_SKIP_MS) {
+            // 2+ hours overdue → auto-skip
+            await store.update(block.id, { status: "skipped" });
+            const msg = `Block auto-skipped (2h+ overdue): ${block.title}`;
+            logActivity({ source: "scheduling", summary: msg });
+            // Inject tension — missed scheduling creates voltage
+            const pulse = getPressureIntegrator();
+            if (pulse) {
+                pulse.addTension("scheduling", msg);
+            }
+        }
+        else {
+            // Just overdue — log it (may create voltage through pressure integrator)
+            const minsOverdue = Math.round(overdueMs / 60_000);
+            logActivity({
+                source: "scheduling",
+                summary: `Block overdue by ${minsOverdue} min: ${block.title}`,
+            });
+        }
+    }
+    // Clean up notified IDs for blocks that have passed
+    for (const id of notifiedBlockIds) {
+        const block = await store.get(id);
+        if (!block || block.status !== "planned") {
+            notifiedBlockIds.delete(id);
+        }
+    }
+}
+/**
+ * Stop the scheduling timer.
+ */
+export function stopSchedulingTimer() {
+    if (timer) {
+        clearInterval(timer);
+        timer = null;
+    }
+    notifiedBlockIds.clear();
+}
+/**
+ * Check if the scheduling timer is running.
+ */
+export function isSchedulingTimerRunning() {
+    return timer !== null;
+}
+//# sourceMappingURL=timer.js.map

package/dist/scheduling/timer.js.map

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

package/dist/scheduling/types.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Types for the scheduling module — Core's internal time allocation.
+ */
+export type BlockType = "focus" | "deadline" | "milestone" | "admin" | "review" | "break";
+export type BlockStatus = "planned" | "active" | "completed" | "skipped" | "cancelled";
+export interface SchedulingBlock {
+    id: string;
+    type: BlockType;
+    title: string;
+    /** ISO 8601 start time (for time-range blocks). */
+    start?: string;
+    /** ISO 8601 end time (for time-range blocks). */
+    end?: string;
+    /** ISO 8601 due date (for deadlines/milestones instead of start/end). */
+    dueAt?: string;
+    /** Optional board item link (e.g. "DASH-112"). */
+    boardItemId?: string;
+    status: BlockStatus;
+    /** Optional note on completion. */
+    outcome?: string;
+    /** Optional categorization. */
+    tags?: string[];
+    createdAt: string;
+    updatedAt: string;
+}
+export interface DaySchedule {
+    date: string;
+    blocks: SchedulingBlock[];
+    stats: {
+        total: number;
+        planned: number;
+        active: number;
+        completed: number;
+        skipped: number;
+        cancelled: number;
+    };
+}
+export interface BlockFilter {
+    date?: string;
+    status?: BlockStatus;
+    type?: BlockType;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/scheduling/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,UAAU,GAAG,WAAW,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE1F,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAS,GAAG,WAAW,CAAC;AAEvF,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,WAAW,CAAC;IACpB,mCAAmC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+BAA+B;IAC/B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,KAAK,EAAE;QACL,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB"}

package/dist/scheduling/types.js

@@ -0,0 +1,5 @@
+/**
+ * Types for the scheduling module — Core's internal time allocation.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/scheduling/types.js.map

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

package/dist/search/brain-docs.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Brain document finder — auto-detects document references in user messages
+ * and resolves them to actual brain files.
+ *
+ * Parallels how calendar/email/board keywords trigger context injection.
+ * Scans brain/content/drafts, brain/knowledge/notes, brain/knowledge/research,
+ * and brain/knowledge/protocols for matching filenames.
+ */
+interface DocMatch {
+    path: string;
+    filename: string;
+    content: string;
+}
+/**
+ * Search brain document directories for files matching the user's message.
+ * Returns the best match (if any) with its content loaded.
+ */
+export declare function findBrainDocument(message: string): Promise<DocMatch | null>;
+export {};
+//# sourceMappingURL=brain-docs.d.ts.map

package/dist/search/brain-docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brain-docs.d.ts","sourceRoot":"","sources":["../../src/search/brain-docs.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAqBH,UAAU,QAAQ;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAuCD;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAwCjF"}

package/dist/search/brain-docs.js

@@ -0,0 +1,103 @@
+/**
+ * Brain document finder — auto-detects document references in user messages
+ * and resolves them to actual brain files.
+ *
+ * Parallels how calendar/email/board keywords trigger context injection.
+ * Scans brain/content/drafts, brain/knowledge/notes, brain/knowledge/research,
+ * and brain/knowledge/protocols for matching filenames.
+ */
+import { readdir } from "node:fs/promises";
+import { join, basename } from "node:path";
+import { readBrainFile } from "../lib/brain-io.js";
+import { resolveEnv } from "../instance.js";
+const BRAIN_DIR = resolveEnv("BRAIN_DIR") ?? join(process.cwd(), "brain");
+/** Directories to scan for documents the user might reference by description. */
+const DOC_DIRS = [
+    join(BRAIN_DIR, "content", "drafts"),
+    join(BRAIN_DIR, "knowledge", "notes"),
+    join(BRAIN_DIR, "knowledge", "research"),
+    join(BRAIN_DIR, "knowledge", "protocols"),
+];
+/** Does the message reference a document, paper, draft, note, or similar? */
+const DOC_REF_PATTERN = /\b(read|show|open|pull up|find|get|load|look at|check)\b.*\b(paper|draft|doc|document|note|post|thread|whitepaper|positioning|writeup|write-?up|article|research|report)\b/i;
+/**
+ * Tokenize a user message into searchable keywords.
+ * Strips common verbs/articles, returns lowercase stems.
+ */
+function extractKeywords(message) {
+    const stopWords = new Set([
+        "the", "a", "an", "my", "our", "that", "this", "it", "its",
+        "read", "show", "open", "pull", "up", "find", "get", "load",
+        "look", "at", "check", "can", "you", "me", "for", "about",
+        "please", "and", "or", "in", "on", "to", "of", "with",
+    ]);
+    return message
+        .toLowerCase()
+        .replace(/[^a-z0-9\s-]/g, " ")
+        .split(/\s+/)
+        .filter((w) => w.length > 2 && !stopWords.has(w));
+}
+/**
+ * Score how well a filename matches a set of keywords.
+ * Filename is split on hyphens/underscores/dots and compared to keywords.
+ */
+function scoreMatch(filename, keywords) {
+    const parts = basename(filename, ".md")
+        .toLowerCase()
+        .split(/[-_.]/)
+        .filter((p) => p.length > 2);
+    let score = 0;
+    for (const kw of keywords) {
+        for (const part of parts) {
+            if (part.includes(kw) || kw.includes(part))
+                score++;
+        }
+    }
+    return score;
+}
+/**
+ * Search brain document directories for files matching the user's message.
+ * Returns the best match (if any) with its content loaded.
+ */
+export async function findBrainDocument(message) {
+    // Only trigger on messages that reference a document
+    if (!DOC_REF_PATTERN.test(message))
+        return null;
+    const keywords = extractKeywords(message);
+    if (keywords.length === 0)
+        return null;
+    // Scan all doc directories, collect candidates
+    const candidates = [];
+    for (const dir of DOC_DIRS) {
+        try {
+            const files = await readdir(dir);
+            for (const file of files) {
+                if (!file.endsWith(".md"))
+                    continue;
+                const score = scoreMatch(file, keywords);
+                if (score > 0) {
+                    candidates.push({ path: join(dir, file), filename: file, score });
+                }
+            }
+        }
+        catch {
+            // Directory might not exist — skip
+        }
+    }
+    if (candidates.length === 0)
+        return null;
+    // Sort by score descending, take the best match
+    candidates.sort((a, b) => b.score - a.score);
+    const best = candidates[0];
+    // Require at least 2 keyword hits to avoid false positives
+    if (best.score < 2)
+        return null;
+    try {
+        const content = await readBrainFile(best.path);
+        return { path: best.path, filename: best.filename, content };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=brain-docs.js.map

package/dist/search/brain-docs.js.map

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

package/dist/search/browse.d.ts

@@ -0,0 +1,45 @@
+/**
+ * URL browse module for Core.
+ * Fetches a URL, strips HTML to readable text, and returns it for context injection.
+ * Zero external dependencies — uses native fetch and regex extraction.
+ *
+ * Never throws — returns null on any error.
+ */
+export interface BrowseResult {
+    url: string;
+    title: string;
+    text: string;
+    truncated: boolean;
+    llmsTxt?: string | null;
+}
+/**
+ * Extract the <title> content from raw HTML.
+ */
+export declare function extractTitle(html: string): string;
+/**
+ * Strip HTML to readable plain text.
+ * Removes scripts, styles, tags, decodes entities, and collapses whitespace.
+ */
+export declare function stripHtml(html: string): string;
+/**
+ * Extract llms.txt link hrefs from raw HTML.
+ * Looks for <a> tags whose href ends in /llms.txt or whose text mentions llms.txt.
+ */
+export declare function extractLlmsTxtLinks(html: string, baseUrl: string): string[];
+/**
+ * Fetch llms.txt from a site — tries root /llms.txt first, then follows
+ * any llms.txt links found in the page HTML as fallback.
+ * Convention: sites publish /llms.txt with AI-friendly content about the site.
+ * Returns the text content or null if not found.
+ */
+export declare function fetchLlmsTxt(url: string, html?: string): Promise<string | null>;
+/**
+ * Fetch a URL and extract readable text.
+ * Returns null on any error (timeout, network, non-HTML content, etc.).
+ */
+export declare function browseUrl(url: string): Promise<BrowseResult | null>;
+/**
+ * Detect the first URL in a message string.
+ */
+export declare function detectUrl(message: string): string | null;
+//# sourceMappingURL=browse.d.ts.map

package/dist/search/browse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browse.d.ts","sourceRoot":"","sources":["../../src/search/browse.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAWD;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGjD;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAmC9C;AAwED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAiB3E;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAoBxB;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CA6DzE;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGxD"}

package/dist/search/browse.js

@@ -0,0 +1,225 @@
+/**
+ * URL browse module for Core.
+ * Fetches a URL, strips HTML to readable text, and returns it for context injection.
+ * Zero external dependencies — uses native fetch and regex extraction.
+ *
+ * Never throws — returns null on any error.
+ */
+import { getInstanceName } from "../instance.js";
+/** Max chars of extracted text to keep (context budget). */
+const MAX_TEXT_LENGTH = 8000;
+/** Timeout for fetch requests in ms. */
+const FETCH_TIMEOUT_MS = 15_000;
+/** Content types we'll attempt to parse. */
+const ALLOWED_CONTENT_TYPES = ["text/html", "text/plain", "application/xhtml"];
+/**
+ * Extract the <title> content from raw HTML.
+ */
+export function extractTitle(html) {
+    const match = html.match(/<title[^>]*>([\s\S]*?)<\/title>/i);
+    return match ? decodeEntities(match[1].trim()) : "";
+}
+/**
+ * Strip HTML to readable plain text.
+ * Removes scripts, styles, tags, decodes entities, and collapses whitespace.
+ */
+export function stripHtml(html) {
+    let text = html;
+    // Remove script and style blocks entirely
+    text = text.replace(/<script[\s\S]*?<\/script>/gi, "");
+    text = text.replace(/<style[\s\S]*?<\/style>/gi, "");
+    text = text.replace(/<noscript[\s\S]*?<\/noscript>/gi, "");
+    // Remove HTML comments
+    text = text.replace(/<!--[\s\S]*?-->/g, "");
+    // Replace block-level tags with newlines for readability
+    text = text.replace(/<\/(p|div|h[1-6]|li|tr|br|blockquote|section|article|header|footer)>/gi, "\n");
+    text = text.replace(/<br\s*\/?>/gi, "\n");
+    text = text.replace(/<(p|div|h[1-6]|li|tr|blockquote|section|article|header|footer)\b[^>]*>/gi, "\n");
+    // Remove all remaining tags
+    text = text.replace(/<[^>]+>/g, "");
+    // Decode HTML entities
+    text = decodeEntities(text);
+    // Collapse whitespace: multiple spaces/tabs to single space, preserve newlines
+    text = text.replace(/[^\S\n]+/g, " ");
+    // Collapse multiple blank lines to at most two
+    text = text.replace(/\n{3,}/g, "\n\n");
+    // Trim each line
+    text = text
+        .split("\n")
+        .map((line) => line.trim())
+        .join("\n");
+    // Trim overall
+    text = text.trim();
+    return text;
+}
+/**
+ * Decode common HTML entities.
+ */
+function decodeEntities(text) {
+    const entities = {
+        "&amp;": "&",
+        "&lt;": "<",
+        "&gt;": ">",
+        "&quot;": '"',
+        "&#39;": "'",
+        "&apos;": "'",
+        "&nbsp;": " ",
+        "&mdash;": "—",
+        "&ndash;": "–",
+        "&hellip;": "…",
+        "&laquo;": "«",
+        "&raquo;": "»",
+        "&copy;": "©",
+        "&reg;": "®",
+        "&trade;": "™",
+    };
+    let result = text;
+    for (const [entity, char] of Object.entries(entities)) {
+        result = result.replaceAll(entity, char);
+    }
+    // Decode numeric entities (&#123; and &#x1a;)
+    result = result.replace(/&#(\d+);/g, (_, num) => String.fromCharCode(parseInt(num, 10)));
+    result = result.replace(/&#x([0-9a-fA-F]+);/g, (_, hex) => String.fromCharCode(parseInt(hex, 16)));
+    return result;
+}
+/**
+ * Fetch a plain-text URL and return its content (or null on failure).
+ * Rejects HTML responses to avoid returning 404 pages.
+ */
+async function fetchPlainText(textUrl) {
+    try {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), 5000);
+        const response = await fetch(textUrl, {
+            signal: controller.signal,
+            headers: { "User-Agent": `${getInstanceName()}/1.0 (personal AI agent)` },
+            redirect: "follow",
+        });
+        clearTimeout(timer);
+        if (!response.ok)
+            return null;
+        const contentType = response.headers.get("content-type") ?? "";
+        if (!contentType.includes("text/"))
+            return null;
+        const text = (await response.text()).trim();
+        // Sanity check: if it's HTML (404 page), reject it
+        if (text.startsWith("<!") || text.startsWith("<html"))
+            return null;
+        if (text.length < 5)
+            return null;
+        return text;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Extract llms.txt link hrefs from raw HTML.
+ * Looks for <a> tags whose href ends in /llms.txt or whose text mentions llms.txt.
+ */
+export function extractLlmsTxtLinks(html, baseUrl) {
+    const links = [];
+    const parsed = new URL(baseUrl);
+    // Match <a> tags with href containing llms.txt
+    const hrefPattern = /<a\s[^>]*href=["']([^"']*llms\.txt[^"']*)["'][^>]*>/gi;
+    let match;
+    while ((match = hrefPattern.exec(html)) !== null) {
+        const href = match[1];
+        try {
+            // Resolve relative URLs
+            const resolved = new URL(href, `${parsed.protocol}//${parsed.host}`).href;
+            if (!links.includes(resolved))
+                links.push(resolved);
+        }
+        catch {
+            // skip malformed URLs
+        }
+    }
+    return links;
+}
+/**
+ * Fetch llms.txt from a site — tries root /llms.txt first, then follows
+ * any llms.txt links found in the page HTML as fallback.
+ * Convention: sites publish /llms.txt with AI-friendly content about the site.
+ * Returns the text content or null if not found.
+ */
+export async function fetchLlmsTxt(url, html) {
+    const parsed = new URL(url);
+    const rootUrl = `${parsed.protocol}//${parsed.host}/llms.txt`;
+    // Try the root /llms.txt first (standard location)
+    const rootResult = await fetchPlainText(rootUrl);
+    if (rootResult)
+        return rootResult;
+    // Fallback: scan page HTML for llms.txt links and try each
+    if (html) {
+        const links = extractLlmsTxtLinks(html, url);
+        for (const link of links) {
+            // Skip if same as root (already tried)
+            if (link === rootUrl)
+                continue;
+            const result = await fetchPlainText(link);
+            if (result)
+                return result;
+        }
+    }
+    return null;
+}
+/**
+ * Fetch a URL and extract readable text.
+ * Returns null on any error (timeout, network, non-HTML content, etc.).
+ */
+export async function browseUrl(url) {
+    try {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
+        const response = await fetch(url, {
+            signal: controller.signal,
+            headers: {
+                "User-Agent": `${getInstanceName()}/1.0 (personal AI agent)`,
+                Accept: "text/html, text/plain;q=0.9, */*;q=0.1",
+            },
+            redirect: "follow",
+        });
+        clearTimeout(timer);
+        if (!response.ok) {
+            return null;
+        }
+        // Check content type — reject non-text responses
+        const contentType = response.headers.get("content-type") ?? "";
+        const isAllowed = ALLOWED_CONTENT_TYPES.some((t) => contentType.toLowerCase().includes(t));
+        if (!isAllowed) {
+            return null;
+        }
+        const html = await response.text();
+        const title = extractTitle(html);
+        // For plain text, skip HTML stripping
+        const isPlainText = contentType.toLowerCase().includes("text/plain");
+        let text = isPlainText ? html.trim() : stripHtml(html);
+        // Truncate to context budget
+        let truncated = false;
+        if (text.length > MAX_TEXT_LENGTH) {
+            text = text.slice(0, MAX_TEXT_LENGTH);
+            // Try to break at a word/sentence boundary
+            const lastBreak = Math.max(text.lastIndexOf("\n"), text.lastIndexOf(". "), text.lastIndexOf("? "), text.lastIndexOf("! "));
+            if (lastBreak > MAX_TEXT_LENGTH * 0.8) {
+                text = text.slice(0, lastBreak + 1);
+            }
+            text += "\n\n[Content truncated]";
+            truncated = true;
+        }
+        // Fetch llms.txt — tries root /llms.txt, then any links found in page HTML
+        const llmsTxt = await fetchLlmsTxt(url, html);
+        return { url, title, text, truncated, llmsTxt };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Detect the first URL in a message string.
+ */
+export function detectUrl(message) {
+    const match = message.match(/https?:\/\/\S+/);
+    return match ? match[0].replace(/[.,;:!?)]+$/, "") : null;
+}
+//# sourceMappingURL=browse.js.map

package/dist/search/browse.js.map

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

package/dist/search/classify.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Search-need classifier for Core.
+ * Determines whether a user message needs a web search and extracts the query.
+ *
+ * Three-tier approach:
+ * 1. Regex fast-path — explicit commands like "search for ...", "google ..."
+ * 2. Heuristic skip — short messages, greetings, obvious non-search patterns
+ * 3. LLM classifier — cheap model decides if web info would help
+ *
+ * Never throws — defaults to { needsSearch: false } on any error.
+ */
+import type { ProviderName } from "../llm/providers/types.js";
+export interface ClassifyResult {
+    needsSearch: boolean;
+    query: string;
+    trigger: "explicit" | "auto" | "none";
+}
+/**
+ * Classify whether a user message needs a web search.
+ * Never throws — returns { needsSearch: false } on any error.
+ */
+export declare function classifySearchNeed(message: string, provider: ProviderName, model?: string): Promise<ClassifyResult>;
+//# sourceMappingURL=classify.d.ts.map

package/dist/search/classify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify.d.ts","sourceRoot":"","sources":["../../src/search/classify.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAG9D,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,OAAO,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;CACvC;AA8GD;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,YAAY,EACtB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,cAAc,CAAC,CAsBzB"}