@chozzz/vargos 2.0.4 → 2.0.6

package/dist/lib/async-handlers.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Generic async handler and callback type definitions.
+ * Reusable across services for consistent typing of async operations.
+ */
+/** Basic async handler: input → Promise<output> */
+export type AsyncHandler<I, O = void> = (input: I) => Promise<O>;
+/** Batch async handler: multiple inputs → Promise<output> */
+export type AsyncBatchHandler<I, O = void> = (batch: I[]) => Promise<O>;
+/** Optional async handler (may not be implemented) */
+export type OptionalAsyncHandler<I, O = void> = AsyncHandler<I, O> | undefined;
+/** Variadic async handler: any arguments → Promise<output> */
+export type AsyncFunction<O = void> = (...args: unknown[]) => Promise<O>;
+//# sourceMappingURL=async-handlers.d.ts.map

package/dist/lib/async-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-handlers.d.ts","sourceRoot":"","sources":["../../lib/async-handlers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,mDAAmD;AACnD,MAAM,MAAM,YAAY,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;AAEjE,6DAA6D;AAC7D,MAAM,MAAM,iBAAiB,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;AAExE,sDAAsD;AACtD,MAAM,MAAM,oBAAoB,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,IAAI,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,SAAS,CAAC;AAE/E,8DAA8D;AAC9D,MAAM,MAAM,aAAa,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC"}

package/dist/lib/async-handlers.js

@@ -0,0 +1,6 @@
+/**
+ * Generic async handler and callback type definitions.
+ * Reusable across services for consistent typing of async operations.
+ */
+export {};
+//# sourceMappingURL=async-handlers.js.map

package/dist/lib/async-handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-handlers.js","sourceRoot":"","sources":["../../lib/async-handlers.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/lib/error-store.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Centralized error store — append-only JSONL at ~/.vargos/errors.jsonl
+ * Persists classified errors for pattern analysis and self-healing.
+ */
+import { type ErrorClass } from './error.js';
+export interface ErrorRecord {
+    ts: string;
+    runId?: string;
+    sessionKey?: string;
+    tool?: string;
+    errorClass: ErrorClass | 'validation' | 'fatal';
+    message: string;
+    model?: string;
+    resolved?: boolean;
+}
+export declare function appendError(entry: Omit<ErrorRecord, 'ts' | 'errorClass'> & {
+    errorClass?: ErrorClass | 'validation' | 'fatal';
+}): Promise<void>;
+//# sourceMappingURL=error-store.d.ts.map

package/dist/lib/error-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-store.d.ts","sourceRoot":"","sources":["../../lib/error-store.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAAgC,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAE3E,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,UAAU,GAAG,YAAY,GAAG,OAAO,CAAC;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,wBAAsB,WAAW,CAC/B,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,GAAG,YAAY,CAAC,GAAG;IAAE,UAAU,CAAC,EAAE,UAAU,GAAG,YAAY,GAAG,OAAO,CAAA;CAAE,GACnG,OAAO,CAAC,IAAI,CAAC,CASf"}

package/dist/lib/error-store.js

@@ -0,0 +1,19 @@
+/**
+ * Centralized error store — append-only JSONL at ~/.vargos/errors.jsonl
+ * Persists classified errors for pattern analysis and self-healing.
+ */
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { getDataPaths } from './paths.js';
+import { sanitizeError, classifyError } from './error.js';
+export async function appendError(entry) {
+    const full = {
+        ts: new Date().toISOString(),
+        errorClass: entry.errorClass ?? classifyError(entry.message),
+        ...entry,
+        message: sanitizeError(entry.message),
+    };
+    const filePath = path.join(getDataPaths().dataDir, 'errors.jsonl');
+    await fs.appendFile(filePath, JSON.stringify(full) + '\n', 'utf-8');
+}
+//# sourceMappingURL=error-store.js.map

package/dist/lib/error-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-store.js","sourceRoot":"","sources":["../../lib/error-store.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,aAAa,EAAmB,MAAM,YAAY,CAAC;AAa3E,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,KAAoG;IAEpG,MAAM,IAAI,GAAgB;QACxB,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QAC5B,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC;QAC5D,GAAG,KAAK;QACR,OAAO,EAAE,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC;KACtC,CAAC;IACF,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;IACnE,MAAM,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;AACtE,CAAC"}

package/dist/lib/error.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Error utilities — message extraction, sanitization, classification.
+ */
+/** Extract a human-readable message from an unknown error value. */
+export declare function toMessage(err: unknown): string;
+/** Scrub API keys, bearer tokens, and credentials from error strings. */
+export declare function sanitizeError(msg: string): string;
+export type ErrorClass = 'transient' | 'auth' | 'timeout' | 'rate_limit' | 'capability' | 'unknown';
+/** Classify an error message for user-facing display. */
+export declare function classifyError(msg: string): ErrorClass;
+//# sourceMappingURL=error.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../lib/error.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,oEAAoE;AACpE,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAE9C;AAED,yEAAyE;AACzE,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAUjD;AAED,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG,MAAM,GAAG,SAAS,GAAG,YAAY,GAAG,YAAY,GAAG,SAAS,CAAC;AAEpG,yDAAyD;AACzD,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAoBrD"}

package/dist/lib/error.js

@@ -0,0 +1,41 @@
+/**
+ * Error utilities — message extraction, sanitization, classification.
+ */
+/** Extract a human-readable message from an unknown error value. */
+export function toMessage(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+/** Scrub API keys, bearer tokens, and credentials from error strings. */
+export function sanitizeError(msg) {
+    return msg
+        // URL-embedded credentials (postgresql://user:pass@host)
+        .replace(/:\/\/([^:]+):([^@]+)@/g, '://$1:***@')
+        // Bearer tokens (including JWT with +/=)
+        .replace(/Bearer\s+[A-Za-z0-9_\-.+/=]+/gi, 'Bearer ***')
+        // Common API key formats (sk-..., xoxb-..., etc.)
+        .replace(/\b(sk|xoxb|xoxp|ghp|gho|ghu|ghs|ghr|glpat)-[A-Za-z0-9_-]{8,}/g, '$1-***')
+        // Generic key=value patterns for common secret field names
+        .replace(/(api[_-]?key|token|secret|password|authorization)[=:]\s*["']?[^\s"',}{]+/gi, '$1=***');
+}
+/** Classify an error message for user-facing display. */
+export function classifyError(msg) {
+    const lower = msg.toLowerCase();
+    if (/\b(401|403|unauthorized|forbidden|invalid.*auth|invalid.*key)\b/.test(lower)) {
+        return 'auth';
+    }
+    if (/\b(429|rate.?limit|too many requests|quota|billing)\b/.test(lower)) {
+        return 'rate_limit';
+    }
+    if (/\b(timeout|timed?\s*out|etimedout|deadline exceeded)\b/.test(lower)) {
+        return 'timeout';
+    }
+    if (/\b(502|503|529|econnreset|econnrefused|network|socket hang up|fetch failed|retry)\b/.test(lower)) {
+        return 'transient';
+    }
+    // Model capability mismatches — not retryable
+    if (/no endpoints found|not support|unsupported.*model|model.*not.*available/i.test(lower)) {
+        return 'capability';
+    }
+    return 'unknown';
+}
+//# sourceMappingURL=error.js.map

package/dist/lib/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../../lib/error.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,oEAAoE;AACpE,MAAM,UAAU,SAAS,CAAC,GAAY;IACpC,OAAO,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AAC1D,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,OAAO,GAAG;QACR,yDAAyD;SACxD,OAAO,CAAC,wBAAwB,EAAE,YAAY,CAAC;QAChD,yCAAyC;SACxC,OAAO,CAAC,gCAAgC,EAAE,YAAY,CAAC;QACxD,kDAAkD;SACjD,OAAO,CAAC,+DAA+D,EAAE,QAAQ,CAAC;QACnF,2DAA2D;SAC1D,OAAO,CAAC,4EAA4E,EAAE,QAAQ,CAAC,CAAC;AACrG,CAAC;AAID,yDAAyD;AACzD,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;IAEhC,IAAI,iEAAiE,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAClF,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IAAI,uDAAuD,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,IAAI,wDAAwD,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACzE,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,qFAAqF,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACtG,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,8CAA8C;IAC9C,IAAI,0EAA0E,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3F,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/lib/frontmatter.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Shared YAML frontmatter parser for markdown files.
+ * Supports the format:
+ *   ---
+ *   key: value
+ *   multiline:
+ *     - item1
+ *     - item2
+ *   ---
+ *   body content
+ */
+export interface FrontmatterResult<T = Record<string, unknown>> {
+    meta: T;
+    body: string;
+}
+/**
+ * Parse YAML-ish frontmatter. The optional generic `T` lets callers declare the expected
+ * meta shape — at runtime the parsed value is just cast (no validation), so callers should
+ * still treat fields as optional unless they validate downstream (Zod, manual checks).
+ */
+export declare function parseFrontmatter<T = Record<string, unknown>>(content: string): FrontmatterResult<T> | null;
+export declare function serializeFrontmatter(meta: Record<string, unknown>, body: string): string;
+//# sourceMappingURL=frontmatter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../lib/frontmatter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,iBAAiB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC5D,IAAI,EAAE,CAAC,CAAC;IACR,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAAC,CAAC,CAAC,GAAG,IAAI,CA+D1G;AAsBD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAOxF"}

package/dist/lib/frontmatter.js

@@ -0,0 +1,136 @@
+/**
+ * Shared YAML frontmatter parser for markdown files.
+ * Supports the format:
+ *   ---
+ *   key: value
+ *   multiline:
+ *     - item1
+ *     - item2
+ *   ---
+ *   body content
+ */
+/**
+ * Parse YAML-ish frontmatter. The optional generic `T` lets callers declare the expected
+ * meta shape — at runtime the parsed value is just cast (no validation), so callers should
+ * still treat fields as optional unless they validate downstream (Zod, manual checks).
+ */
+export function parseFrontmatter(content) {
+    if (!content || typeof content !== 'string') {
+        return null;
+    }
+    const match = content.match(/^---\n([\s\S]*?)\n?---\n?([\s\S]*)/);
+    if (!match) {
+        return null;
+    }
+    const meta = {};
+    const metaStr = match[1].trim();
+    const body = match[2]?.trim() ?? '';
+    // Empty frontmatter (e.g. `---\n---\n\n`) is valid — return empty meta + body so callers
+    // can distinguish "no frontmatter wrapper" (parse returns null) from "wrapper but empty".
+    if (!metaStr) {
+        return { meta: {}, body };
+    }
+    const lines = metaStr.split('\n');
+    let i = 0;
+    while (i < lines.length) {
+        const line = lines[i];
+        if (!line.trim()) {
+            i++;
+            continue;
+        }
+        const colonIdx = line.indexOf(':');
+        if (colonIdx === -1) {
+            i++;
+            continue;
+        }
+        const key = line.substring(0, colonIdx).trim();
+        if (!key) {
+            i++;
+            continue;
+        }
+        const rawValue = line.substring(colonIdx + 1).trim();
+        // Check if this is a multi-line array (next line starts with -)
+        if (!rawValue && i + 1 < lines.length && lines[i + 1].trim().startsWith('-')) {
+            const arrayItems = [];
+            i++;
+            while (i < lines.length && lines[i].trim().startsWith('-')) {
+                const item = lines[i].trim().substring(1).trim();
+                // Strip quotes from array items (e.g., "0 9 * * *" -> 0 9 * * *)
+                const unquoted = item.replace(/^["']|["']$/g, '');
+                arrayItems.push(unquoted);
+                i++;
+            }
+            meta[key] = arrayItems;
+        }
+        else {
+            meta[key] = parseFrontmatterValue(rawValue);
+            i++;
+        }
+    }
+    return { meta: meta, body };
+}
+function parseFrontmatterValue(value) {
+    if (value === 'true')
+        return true;
+    if (value === 'false')
+        return false;
+    if (value.startsWith('[') && value.endsWith(']')) {
+        try {
+            return JSON.parse(value);
+        }
+        catch {
+            return value;
+        }
+    }
+    // Try to parse as number (integer or float)
+    if (/^-?\d+(\.\d+)?$/.test(value)) {
+        return Number(value);
+    }
+    return value.replace(/^["']|["']$/g, '');
+}
+export function serializeFrontmatter(meta, body) {
+    const frontmatter = Object.entries(meta)
+        .filter(([, value]) => value !== undefined && value !== null)
+        .map(([key, value]) => formatEntry(key, value))
+        .join('\n');
+    return `---\n${frontmatter}\n---\n\n${body}\n`;
+}
+function formatEntry(key, value) {
+    if (Array.isArray(value)) {
+        if (value.length === 0)
+            return `${key}: []`;
+        if (value.every(v => typeof v === 'number')) {
+            return `${key}: [${value.join(', ')}]`;
+        }
+        return `${key}:\n${value.map(v => `  - ${formatScalar(v)}`).join('\n')}`;
+    }
+    return `${key}: ${formatScalar(value)}`;
+}
+function formatScalar(value) {
+    if (typeof value === 'boolean' || typeof value === 'number')
+        return String(value);
+    const s = String(value);
+    return needsQuotes(s) ? `"${s.replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"` : s;
+}
+function needsQuotes(s) {
+    if (s === '')
+        return true;
+    if (/^(true|false|null|yes|no|on|off|~)$/i.test(s))
+        return true;
+    if (/^-?\d+(\.\d+)?$/.test(s))
+        return true;
+    // Starts with a YAML-special character or whitespace
+    if (/^[\s!&*?|>%@`[\]{},#"'-]/.test(s))
+        return true;
+    // Contains ": ", " #", tab, or newline
+    if (/:\s|\s#|\t|\n/.test(s))
+        return true;
+    // Trailing whitespace
+    if (/\s$/.test(s))
+        return true;
+    // Contains chars conventionally quoted for safety (cron expressions, etc.)
+    if (/[*?&!|>%`]/.test(s))
+        return true;
+    return false;
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/lib/frontmatter.js.map

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

package/dist/lib/glob.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Match a string against a glob pattern. Only `*` wildcard is supported (matches any
+ * characters, zero or more). Patterns without `*` must match exactly. Other regex
+ * specials in the pattern are escaped.
+ *
+ * Examples:
+ *   matchesGlob('memory.*', 'memory.search')      // true
+ *   matchesGlob('memory.*', 'channel.send')       // false
+ *   matchesGlob('mcp.atlassian.*', 'mcp.atlassian.create_issue')  // true
+ *   matchesGlob('*', 'anything')                  // true
+ *   matchesGlob('exact', 'exact')                 // true
+ */
+export declare function matchesGlob(pattern: string, str: string): boolean;
+//# sourceMappingURL=glob.d.ts.map

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

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

package/dist/lib/glob.js

@@ -0,0 +1,22 @@
+/**
+ * Match a string against a glob pattern. Only `*` wildcard is supported (matches any
+ * characters, zero or more). Patterns without `*` must match exactly. Other regex
+ * specials in the pattern are escaped.
+ *
+ * Examples:
+ *   matchesGlob('memory.*', 'memory.search')      // true
+ *   matchesGlob('memory.*', 'channel.send')       // false
+ *   matchesGlob('mcp.atlassian.*', 'mcp.atlassian.create_issue')  // true
+ *   matchesGlob('*', 'anything')                  // true
+ *   matchesGlob('exact', 'exact')                 // true
+ */
+export function matchesGlob(pattern, str) {
+    if (!pattern.includes('*'))
+        return pattern === str;
+    const re = new RegExp('^' + pattern.split('*').map(escapeRegex).join('.*') + '$');
+    return re.test(str);
+}
+function escapeRegex(s) {
+    return s.replace(/[.+?^${}()|[\]\\]/g, '\\$&');
+}
+//# sourceMappingURL=glob.js.map

package/dist/lib/glob.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glob.js","sourceRoot":"","sources":["../../lib/glob.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe,EAAE,GAAW;IACtD,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,OAAO,KAAK,GAAG,CAAC;IACnD,MAAM,EAAE,GAAG,IAAI,MAAM,CACnB,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,CAC3D,CAAC;IACF,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACtB,CAAC;AAED,SAAS,WAAW,CAAC,CAAS;IAC5B,OAAO,CAAC,CAAC,OAAO,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC;AACjD,CAAC"}

package/dist/lib/heartbeat.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Heartbeat utilities — pure functions for heartbeat poll logic
+ */
+/**
+ * Returns true if HEARTBEAT.md content has no actionable tasks.
+ * Skips blank lines, markdown headers, empty list items, and HTML comments.
+ */
+export declare function isHeartbeatContentEffectivelyEmpty(content: string): boolean;
+/**
+ * Strip HEARTBEAT_OK token from response text.
+ * Returns null if the entire response was only the token (signal to skip delivery).
+ * Returns cleaned text otherwise.
+ */
+export declare function stripHeartbeatToken(text: string): string | null;
+/**
+ * Check if the current hour is within active hours.
+ * Returns true if no config (always active).
+ * Supports overnight ranges (e.g. 22→6).
+ *
+ * @param activeHours [startHour, endHour] (0–23). Interpreted in `timeZone` when set, else UTC.
+ */
+export declare function isWithinActiveHours(activeHours?: [number, number], timeZone?: string): boolean;
+//# sourceMappingURL=heartbeat.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat.d.ts","sourceRoot":"","sources":["../../lib/heartbeat.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,wBAAgB,kCAAkC,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAU3E;AAKD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAI/D;AAYD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAOT"}

package/dist/lib/heartbeat.js

@@ -0,0 +1,62 @@
+/**
+ * Heartbeat utilities — pure functions for heartbeat poll logic
+ */
+/**
+ * Returns true if HEARTBEAT.md content has no actionable tasks.
+ * Skips blank lines, markdown headers, empty list items, and HTML comments.
+ */
+export function isHeartbeatContentEffectivelyEmpty(content) {
+    for (const line of content.split('\n')) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        if (trimmed.startsWith('#'))
+            continue;
+        if (trimmed === '-' || trimmed === '- [ ]')
+            continue;
+        if (trimmed.startsWith('<!--') && trimmed.endsWith('-->'))
+            continue;
+        return false;
+    }
+    return true;
+}
+// Matches HEARTBEAT_OK with optional markdown wrapping (bold, backtick, strikethrough)
+const HEARTBEAT_TOKEN_RE = /(?:\*{1,2}|`|~~)?HEARTBEAT_OK(?:\*{1,2}|`|~~)?/g;
+/**
+ * Strip HEARTBEAT_OK token from response text.
+ * Returns null if the entire response was only the token (signal to skip delivery).
+ * Returns cleaned text otherwise.
+ */
+export function stripHeartbeatToken(text) {
+    const stripped = text.replace(HEARTBEAT_TOKEN_RE, '').trim();
+    if (!stripped)
+        return null;
+    return stripped;
+}
+function currentHourInZone(timeZone) {
+    const parts = new Intl.DateTimeFormat('en-GB', {
+        timeZone,
+        hour: 'numeric',
+        hour12: false,
+    }).formatToParts(new Date());
+    const hourPart = parts.find(p => p.type === 'hour');
+    return parseInt(hourPart?.value ?? '0', 10);
+}
+/**
+ * Check if the current hour is within active hours.
+ * Returns true if no config (always active).
+ * Supports overnight ranges (e.g. 22→6).
+ *
+ * @param activeHours [startHour, endHour] (0–23). Interpreted in `timeZone` when set, else UTC.
+ */
+export function isWithinActiveHours(activeHours, timeZone) {
+    if (!activeHours)
+        return true;
+    const [start, end] = activeHours;
+    const hour = timeZone ? currentHourInZone(timeZone) : new Date().getUTCHours();
+    if (start <= end)
+        return hour >= start && hour < end;
+    // Overnight: e.g. [22, 6] → active 22:00→06:00
+    return hour >= start || hour < end;
+}
+//# sourceMappingURL=heartbeat.js.map

package/dist/lib/heartbeat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat.js","sourceRoot":"","sources":["../../lib/heartbeat.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,MAAM,UAAU,kCAAkC,CAAC,OAAe;IAChE,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACvC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,OAAO;YAAE,SAAS;QACvB,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QACtC,IAAI,OAAO,KAAK,GAAG,IAAI,OAAO,KAAK,OAAO;YAAE,SAAS;QACrD,IAAI,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,SAAS;QACpE,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,uFAAuF;AACvF,MAAM,kBAAkB,GAAG,iDAAiD,CAAC;AAE7E;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7D,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3B,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,iBAAiB,CAAC,QAAgB;IACzC,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE;QAC7C,QAAQ;QACR,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,KAAK;KACd,CAAC,CAAC,aAAa,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IAC7B,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;IACpD,OAAO,QAAQ,CAAC,QAAQ,EAAE,KAAK,IAAI,GAAG,EAAE,EAAE,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CACjC,WAA8B,EAC9B,QAAiB;IAEjB,IAAI,CAAC,WAAW;QAAE,OAAO,IAAI,CAAC;IAC9B,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,GAAG,WAAW,CAAC;IACjC,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC/E,IAAI,KAAK,IAAI,GAAG;QAAE,OAAO,IAAI,IAAI,KAAK,IAAI,IAAI,GAAG,GAAG,CAAC;IACrD,+CAA+C;IAC/C,OAAO,IAAI,IAAI,KAAK,IAAI,IAAI,GAAG,GAAG,CAAC;AACrC,CAAC"}

package/dist/lib/html.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Shared HTML utilities backed by turndown.
+ * - stripHtml: simple tag stripping (for link expansion)
+ * - htmlToMarkdown: proper conversion preserving links, headings, lists (for web.fetch)
+ */
+export declare function htmlToMarkdown(html: string): string;
+export declare function stripHtml(html: string): string;
+//# sourceMappingURL=html.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"html.d.ts","sourceRoot":"","sources":["../../lib/html.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKnD;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAY9C"}

package/dist/lib/html.js

@@ -0,0 +1,28 @@
+/**
+ * Shared HTML utilities backed by turndown.
+ * - stripHtml: simple tag stripping (for link expansion)
+ * - htmlToMarkdown: proper conversion preserving links, headings, lists (for web.fetch)
+ */
+import TurndownService from 'turndown';
+const turndown = new TurndownService({ headingStyle: 'atx', bulletListMarker: '-' });
+turndown.remove(['script', 'style', 'noscript']);
+export function htmlToMarkdown(html) {
+    const titleMatch = html.match(/<title[^>]*>([\s\S]*?)<\/title>/i);
+    const title = titleMatch?.[1]?.trim();
+    const text = turndown.turndown(html).replace(/\n{3,}/g, '\n\n').trim();
+    return title ? `# ${title}\n\n${text}` : text;
+}
+export function stripHtml(html) {
+    return html
+        .replace(/<(script|style)[^>]*>[\s\S]*?<\/\1>/gi, ' ')
+        .replace(/<[^>]+>/g, ' ')
+        .replace(/&amp;/g, '&')
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/&quot;/g, '"')
+        .replace(/&#39;/g, "'")
+        .replace(/&nbsp;/g, ' ')
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+//# sourceMappingURL=html.js.map

package/dist/lib/html.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.js","sourceRoot":"","sources":["../../lib/html.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,eAAe,MAAM,UAAU,CAAC;AAEvC,MAAM,QAAQ,GAAG,IAAI,eAAe,CAAC,EAAE,YAAY,EAAE,KAAK,EAAE,gBAAgB,EAAE,GAAG,EAAE,CAAC,CAAC;AACrF,QAAQ,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC;AAEjD,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;IAClE,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;IACtC,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IACvE,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,IAAI;SACR,OAAO,CAAC,uCAAuC,EAAE,GAAG,CAAC;SACrD,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC;SACxB,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,IAAI,EAAE,CAAC;AACZ,CAAC"}

package/dist/lib/http-validate.d.ts

@@ -0,0 +1,12 @@
+/** HTTP response validation utilities */
+export interface HttpResponse {
+    ok: boolean;
+    status: number;
+    statusText?: string;
+}
+/**
+ * Validate HTTP response and throw with formatted error message.
+ * Extracts method/URL context from error message if available.
+ */
+export declare function validateHttpResponse(res: HttpResponse, context: string): void;
+//# sourceMappingURL=http-validate.d.ts.map

package/dist/lib/http-validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-validate.d.ts","sourceRoot":"","sources":["../../lib/http-validate.ts"],"names":[],"mappings":"AAAA,yCAAyC;AAEzC,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,YAAY,EACjB,OAAO,EAAE,MAAM,GACd,IAAI,CAIN"}

package/dist/lib/http-validate.js

@@ -0,0 +1,11 @@
+/** HTTP response validation utilities */
+/**
+ * Validate HTTP response and throw with formatted error message.
+ * Extracts method/URL context from error message if available.
+ */
+export function validateHttpResponse(res, context) {
+    if (!res.ok) {
+        throw new Error(`${context} failed: ${res.status} ${res.statusText || 'error'}`);
+    }
+}
+//# sourceMappingURL=http-validate.js.map

package/dist/lib/http-validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-validate.js","sourceRoot":"","sources":["../../lib/http-validate.ts"],"names":[],"mappings":"AAAA,yCAAyC;AAQzC;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,GAAiB,EACjB,OAAe;IAEf,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,GAAG,OAAO,YAAY,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,IAAI,OAAO,EAAE,CAAC,CAAC;IACnF,CAAC;AACH,CAAC"}

package/dist/lib/id.d.ts

@@ -0,0 +1,3 @@
+/** Generate a short unique ID with a prefix: `prefix-timestamp-random` */
+export declare function generateId(prefix: string): string;
+//# sourceMappingURL=id.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"id.d.ts","sourceRoot":"","sources":["../../lib/id.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEjD"}

package/dist/lib/id.js

@@ -0,0 +1,5 @@
+/** Generate a short unique ID with a prefix: `prefix-timestamp-random` */
+export function generateId(prefix) {
+    return `${prefix}-${Date.now()}-${Math.random().toString(36).slice(2, 7)}`;
+}
+//# sourceMappingURL=id.js.map

package/dist/lib/id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.js","sourceRoot":"","sources":["../../lib/id.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,MAAM,UAAU,UAAU,CAAC,MAAc;IACvC,OAAO,GAAG,MAAM,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AAC7E,CAAC"}

package/dist/lib/logger.d.ts

@@ -0,0 +1,12 @@
+import type { Bus } from '../gateway/bus.js';
+import type { Json } from '../gateway/events.js';
+/** Called once by LogService.boot() to wire the global logger to the bus. */
+export declare function setLoggerBus(bus: Bus): void;
+export declare function ts(): string;
+export declare function createLogger(service: string): {
+    debug: (msg: string, data?: Json) => void;
+    info: (msg: string, data?: Json) => void;
+    warn: (msg: string, data?: Json) => void;
+    error: (msg: string, data?: Json) => void;
+};
+//# sourceMappingURL=logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../lib/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAIjD,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAE3C;AAED,wBAAgB,EAAE,IAAI,MAAM,CAK3B;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM;iBAU3B,MAAM,SAAS,IAAI;gBACnB,MAAM,SAAS,IAAI;gBACnB,MAAM,SAAS,IAAI;iBACnB,MAAM,SAAS,IAAI;EAEnC"}

package/dist/lib/logger.js

@@ -0,0 +1,28 @@
+let _bus = null;
+/** Called once by LogService.boot() to wire the global logger to the bus. */
+export function setLoggerBus(bus) {
+    _bus = bus;
+}
+export function ts() {
+    const d = new Date();
+    const pad = (n) => String(n).padStart(2, '0');
+    return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())} ` +
+        `${pad(d.getHours())}:${pad(d.getMinutes())}:${pad(d.getSeconds())}.${Math.floor(d.getMilliseconds() / 100)}`;
+}
+export function createLogger(service) {
+    function write(level, message, data) {
+        if (_bus) {
+            _bus.emit('log.onLog', { level, service, message, ...(data !== undefined ? { data } : {}) });
+        }
+        else {
+            console.error(`${ts()} [${service}] ${level.toUpperCase()} ${message}`, data ?? '');
+        }
+    }
+    return {
+        debug: (msg, data) => write('debug', msg, data),
+        info: (msg, data) => write('info', msg, data),
+        warn: (msg, data) => write('warn', msg, data),
+        error: (msg, data) => write('error', msg, data),
+    };
+}
+//# sourceMappingURL=logger.js.map

package/dist/lib/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../lib/logger.ts"],"names":[],"mappings":"AAGA,IAAI,IAAI,GAAe,IAAI,CAAC;AAE5B,6EAA6E;AAC7E,MAAM,UAAU,YAAY,CAAC,GAAQ;IACnC,IAAI,GAAG,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,EAAE;IAChB,MAAM,CAAC,GAAG,IAAI,IAAI,EAAE,CAAC;IACrB,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACtD,OAAO,GAAG,CAAC,CAAC,WAAW,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,GAAG;QAClE,GAAG,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,eAAe,EAAE,GAAG,GAAG,CAAC,EAAE,CAAC;AACvH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,SAAS,KAAK,CAAC,KAA0C,EAAE,OAAe,EAAE,IAAW;QACrF,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QAC/F,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,KAAK,OAAO,KAAK,KAAK,CAAC,WAAW,EAAE,IAAI,OAAO,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;QACtF,CAAC;IACH,CAAC;IAED,OAAO;QACL,KAAK,EAAE,CAAC,GAAW,EAAE,IAAW,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC;QAC9D,IAAI,EAAG,CAAC,GAAW,EAAE,IAAW,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,EAAG,GAAG,EAAE,IAAI,CAAC;QAC9D,IAAI,EAAG,CAAC,GAAW,EAAE,IAAW,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,EAAG,GAAG,EAAE,IAAI,CAAC;QAC9D,KAAK,EAAE,CAAC,GAAW,EAAE,IAAW,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC;KAC/D,CAAC;AACJ,CAAC"}