spidersan 0.20.1 → 0.20.2

package/dist/index.js

@@ -0,0 +1,8 @@
+/**
+ * Spidersan - Branch coordination for AI coding agents
+ */
+export * from './storage/index.js';
+export * from './commands/index.js';
+export * from './lib/ast.js';
+export * from './lib/security.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC"}

package/dist/lib/activity.d.ts

@@ -0,0 +1,53 @@
+export type ActivityEvent = 'register' | 'merge' | 'abandon' | 'conflict_detected' | 'sync' | 'cleanup' | 'ready_check_pass' | 'ready_check_fail' | 'session_start' | 'session_end';
+export interface ActivityRecord {
+    id: string;
+    repo: string;
+    branch: string | null;
+    agent: string | null;
+    machine: string | null;
+    event: ActivityEvent;
+    details: Record<string, unknown>;
+    created_at: string;
+}
+export interface LogActivityInput {
+    repo?: string;
+    branch?: string;
+    agent?: string;
+    machine?: string;
+    event: ActivityEvent;
+    details?: Record<string, unknown>;
+    createdAt?: Date;
+}
+export interface ActivityQuery {
+    branch?: string;
+    agent?: string;
+    repo?: string;
+    since?: Date;
+    limit?: number;
+}
+export interface ActivityQueryResult {
+    source: 'supabase' | 'local';
+    records: ActivityRecord[];
+}
+export interface ActivityFlushResult {
+    pending: number;
+    flushed: number;
+    remaining: number;
+    source: 'supabase' | 'local';
+}
+interface ActivityRuntime {
+    activityFilePath?: string;
+    flushStatePath?: string;
+    supabaseUrl?: string;
+    supabaseKey?: string;
+    fetchImpl?: typeof fetch;
+    now?: () => Date;
+    uuid?: () => string;
+    cwd?: string;
+}
+export declare function parseSince(input?: string, now?: Date): Date;
+export declare function logActivity(input: LogActivityInput, runtime?: ActivityRuntime): ActivityRecord;
+export declare function flushActivityLog(runtime?: ActivityRuntime): Promise<ActivityFlushResult>;
+export declare function queryActivityLog(query: ActivityQuery, runtime?: ActivityRuntime): Promise<ActivityQueryResult>;
+export {};
+//# sourceMappingURL=activity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"activity.d.ts","sourceRoot":"","sources":["../../src/lib/activity.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,aAAa,GACnB,UAAU,GACV,OAAO,GACP,SAAS,GACT,mBAAmB,GACnB,MAAM,GACN,SAAS,GACT,kBAAkB,GAClB,kBAAkB,GAClB,eAAe,GACf,aAAa,CAAC;AAEpB,MAAM,WAAW,cAAc;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,EAAE,aAAa,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,aAAa,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,SAAS,CAAC,EAAE,IAAI,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,IAAI,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAChC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC;IAC7B,OAAO,EAAE,cAAc,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,mBAAmB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC;CAChC;AAMD,UAAU,eAAe;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;CAChB;AAgJD,wBAAgB,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,GAAE,IAAiB,GAAG,IAAI,CAwBvE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,EAAE,OAAO,GAAE,eAAoB,GAAG,cAAc,CAYlG;AAED,wBAAsB,gBAAgB,CAAC,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CA2ClG;AAwDD,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAQxH"}

package/dist/lib/activity.js

@@ -0,0 +1,271 @@
+import { randomUUID } from 'crypto';
+import { appendFileSync, existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
+import { basename, dirname, join } from 'path';
+import { homedir, hostname } from 'os';
+import { resolveSupabaseEnv } from './supabase-credentials.js';
+const DEFAULT_ACTIVITY_DIR = join(homedir(), '.spidersan');
+const DEFAULT_ACTIVITY_FILE = join(DEFAULT_ACTIVITY_DIR, 'activity.jsonl');
+const DEFAULT_FLUSH_STATE_FILE = join(DEFAULT_ACTIVITY_DIR, 'activity.flush.json');
+const DEFAULT_LIMIT = 200;
+const SUPABASE_BATCH_SIZE = 100;
+function resolveActivityFilePath(runtime = {}) {
+    return runtime.activityFilePath || DEFAULT_ACTIVITY_FILE;
+}
+function resolveFlushStatePath(runtime = {}) {
+    return runtime.flushStatePath || DEFAULT_FLUSH_STATE_FILE;
+}
+function ensureParentDir(filePath) {
+    const dir = dirname(filePath);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+}
+function safeParseJson(raw) {
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+function resolveRepoName(cwd) {
+    return basename(cwd);
+}
+function resolveSupabaseConfig(runtime = {}) {
+    // Injected runtime config still wins; env resolution is shared so the
+    // scoped SPIDERSAN_SUPABASE_* names are honoured here too (tb-ly0b).
+    const env = resolveSupabaseEnv();
+    const url = runtime.supabaseUrl || env.url;
+    const key = runtime.supabaseKey || env.key;
+    if (!url || !key)
+        return null;
+    return { url, key };
+}
+function normalizeRecord(raw) {
+    if (!raw.id || !raw.repo || !raw.event || !raw.created_at) {
+        return null;
+    }
+    const details = typeof raw.details === 'object' && raw.details !== null
+        ? raw.details
+        : {};
+    return {
+        id: String(raw.id),
+        repo: String(raw.repo),
+        branch: raw.branch ? String(raw.branch) : null,
+        agent: raw.agent ? String(raw.agent) : null,
+        machine: raw.machine ? String(raw.machine) : null,
+        event: raw.event,
+        details,
+        created_at: String(raw.created_at),
+    };
+}
+function readLocalRecords(runtime = {}) {
+    const activityFilePath = resolveActivityFilePath(runtime);
+    if (!existsSync(activityFilePath))
+        return [];
+    const content = readFileSync(activityFilePath, 'utf-8');
+    const records = [];
+    for (const line of content.split('\n')) {
+        if (!line.trim())
+            continue;
+        const parsed = safeParseJson(line);
+        if (!parsed)
+            continue;
+        const normalized = normalizeRecord(parsed);
+        if (normalized) {
+            records.push(normalized);
+        }
+    }
+    return records;
+}
+function readFlushState(runtime = {}) {
+    const flushStatePath = resolveFlushStatePath(runtime);
+    if (!existsSync(flushStatePath)) {
+        return { lastFlushedLine: 0 };
+    }
+    const parsed = safeParseJson(readFileSync(flushStatePath, 'utf-8'));
+    if (!parsed || typeof parsed.lastFlushedLine !== 'number' || parsed.lastFlushedLine < 0) {
+        return { lastFlushedLine: 0 };
+    }
+    return { lastFlushedLine: parsed.lastFlushedLine };
+}
+function writeFlushState(state, runtime = {}) {
+    const flushStatePath = resolveFlushStatePath(runtime);
+    ensureParentDir(flushStatePath);
+    writeFileSync(flushStatePath, JSON.stringify(state, null, 2) + '\n', 'utf-8');
+}
+function buildRecord(input, runtime = {}) {
+    const now = (runtime.now || (() => new Date()))();
+    const cwd = runtime.cwd || process.cwd();
+    return {
+        id: (runtime.uuid || randomUUID)(),
+        repo: input.repo || resolveRepoName(cwd),
+        branch: input.branch || null,
+        agent: input.agent || null,
+        machine: input.machine || process.env.SPIDERSAN_MACHINE_ID || process.env.HOSTNAME || hostname(),
+        event: input.event,
+        details: input.details || {},
+        created_at: (input.createdAt || now).toISOString(),
+    };
+}
+async function pushToSupabase(records, runtime = {}) {
+    if (records.length === 0)
+        return;
+    const supabase = resolveSupabaseConfig(runtime);
+    if (!supabase) {
+        throw new Error('Supabase credentials are not configured');
+    }
+    const fetchImpl = runtime.fetchImpl || fetch;
+    const endpoint = `${supabase.url}/rest/v1/spider_activity_log?on_conflict=id`;
+    const response = await fetchImpl(endpoint, {
+        method: 'POST',
+        headers: {
+            'apikey': supabase.key,
+            'Authorization': `Bearer ${supabase.key}`,
+            'Content-Type': 'application/json',
+            'Prefer': 'resolution=ignore-duplicates,return=minimal',
+        },
+        body: JSON.stringify(records),
+    });
+    if (!response.ok) {
+        throw new Error(`Supabase activity write failed (${response.status})`);
+    }
+}
+export function parseSince(input, now = new Date()) {
+    if (!input) {
+        return new Date(now.getTime() - 24 * 60 * 60 * 1000);
+    }
+    const relative = input.trim().match(/^(\d+)\s*([mhdw])$/i);
+    if (relative) {
+        const value = parseInt(relative[1], 10);
+        const unit = relative[2].toLowerCase();
+        const multipliers = {
+            m: 60 * 1000,
+            h: 60 * 60 * 1000,
+            d: 24 * 60 * 60 * 1000,
+            w: 7 * 24 * 60 * 60 * 1000,
+        };
+        return new Date(now.getTime() - value * multipliers[unit]);
+    }
+    const parsed = new Date(input);
+    if (!Number.isNaN(parsed.getTime())) {
+        return parsed;
+    }
+    throw new Error(`Invalid --since value "${input}". Use 7d, 24h, 30m, or an ISO date.`);
+}
+export function logActivity(input, runtime = {}) {
+    const record = buildRecord(input, runtime);
+    const activityFilePath = resolveActivityFilePath(runtime);
+    ensureParentDir(activityFilePath);
+    appendFileSync(activityFilePath, JSON.stringify(record) + '\n', 'utf-8');
+    void pushToSupabase([record], runtime).catch(() => {
+        // Best-effort network write. Local JSONL remains canonical fallback queue.
+    });
+    return record;
+}
+export async function flushActivityLog(runtime = {}) {
+    const allRecords = readLocalRecords(runtime);
+    if (allRecords.length === 0) {
+        return { pending: 0, flushed: 0, remaining: 0, source: 'local' };
+    }
+    const state = readFlushState(runtime);
+    const start = Math.min(Math.max(state.lastFlushedLine, 0), allRecords.length);
+    const pending = allRecords.slice(start);
+    if (pending.length === 0) {
+        return { pending: 0, flushed: 0, remaining: 0, source: 'supabase' };
+    }
+    if (!resolveSupabaseConfig(runtime)) {
+        return {
+            pending: pending.length,
+            flushed: 0,
+            remaining: pending.length,
+            source: 'local',
+        };
+    }
+    let flushed = 0;
+    for (let i = 0; i < pending.length; i += SUPABASE_BATCH_SIZE) {
+        const batch = pending.slice(i, i + SUPABASE_BATCH_SIZE);
+        try {
+            await pushToSupabase(batch, runtime);
+            flushed += batch.length;
+        }
+        catch {
+            break;
+        }
+    }
+    if (flushed > 0) {
+        writeFlushState({ lastFlushedLine: start + flushed }, runtime);
+    }
+    return {
+        pending: pending.length,
+        flushed,
+        remaining: pending.length - flushed,
+        source: flushed > 0 ? 'supabase' : 'local',
+    };
+}
+function applyLocalFilters(records, query) {
+    return records
+        .filter((record) => {
+        if (query.repo && record.repo !== query.repo)
+            return false;
+        if (query.branch && record.branch !== query.branch)
+            return false;
+        if (query.agent && record.agent !== query.agent)
+            return false;
+        if (query.since && new Date(record.created_at).getTime() < query.since.getTime())
+            return false;
+        return true;
+    })
+        .sort((a, b) => new Date(b.created_at).getTime() - new Date(a.created_at).getTime())
+        .slice(0, query.limit || DEFAULT_LIMIT);
+}
+async function querySupabase(query, runtime = {}) {
+    const supabase = resolveSupabaseConfig(runtime);
+    if (!supabase) {
+        throw new Error('Supabase credentials are not configured');
+    }
+    const params = new URLSearchParams();
+    params.set('select', 'id,repo,branch,agent,machine,event,details,created_at');
+    params.set('order', 'created_at.desc');
+    params.set('limit', String(query.limit || DEFAULT_LIMIT));
+    if (query.repo)
+        params.set('repo', `eq.${query.repo}`);
+    if (query.branch)
+        params.set('branch', `eq.${query.branch}`);
+    if (query.agent)
+        params.set('agent', `eq.${query.agent}`);
+    if (query.since)
+        params.set('created_at', `gte.${query.since.toISOString()}`);
+    const fetchImpl = runtime.fetchImpl || fetch;
+    const endpoint = `${supabase.url}/rest/v1/spider_activity_log?${params.toString()}`;
+    const response = await fetchImpl(endpoint, {
+        headers: {
+            'apikey': supabase.key,
+            'Authorization': `Bearer ${supabase.key}`,
+            'Content-Type': 'application/json',
+        },
+    });
+    if (!response.ok) {
+        throw new Error(`Supabase query failed (${response.status})`);
+    }
+    const rows = await response.json();
+    const records = [];
+    for (const row of rows) {
+        const normalized = normalizeRecord(row);
+        if (normalized) {
+            records.push(normalized);
+        }
+    }
+    return records;
+}
+export async function queryActivityLog(query, runtime = {}) {
+    try {
+        const supabaseRecords = await querySupabase(query, runtime);
+        return { source: 'supabase', records: supabaseRecords };
+    }
+    catch {
+        const localRecords = applyLocalFilters(readLocalRecords(runtime), query);
+        return { source: 'local', records: localRecords };
+    }
+}
+//# sourceMappingURL=activity.js.map

package/dist/lib/activity.js.map

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

package/dist/lib/agent-errors.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Shared Agent Error Logging Utility
+ *
+ * Logs errors to ~/.agent-errors/ with rotation.
+ * Used by all Treebird agents for centralized error tracking.
+ *
+ * @module agent-errors
+ */
+export interface AgentError {
+    timestamp: string;
+    agent: string;
+    context: string;
+    error: string;
+    stack?: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Log an error to the agent errors directory
+ */
+export declare function logAgentError(agent: string, context: string, error: Error | string, metadata?: Record<string, unknown>): void;
+/**
+ * Read recent errors for an agent
+ */
+export declare function readAgentErrors(agent: string, limit?: number): AgentError[];
+/**
+ * Read all agent errors (summary)
+ */
+export declare function getAllAgentErrors(limit?: number): Record<string, AgentError[]>;
+/**
+ * Wrapper for MCP calls with error logging
+ */
+export declare function withErrorLogging<T>(agent: string, context: string, fn: () => Promise<T>, metadata?: Record<string, unknown>): Promise<T>;
+/**
+ * Get error log file path for an agent
+ */
+export declare function getErrorLogPath(agent: string): string;
+/**
+ * Clear all errors for an agent
+ */
+export declare function clearAgentErrors(agent: string): boolean;
+//# sourceMappingURL=agent-errors.d.ts.map

package/dist/lib/agent-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-errors.d.ts","sourceRoot":"","sources":["../../src/lib/agent-errors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH,MAAM,WAAW,UAAU;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAqCD;;GAEG;AACH,wBAAgB,aAAa,CACzB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,KAAK,GAAG,MAAM,EACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,IAAI,CAsBN;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,UAAU,EAAE,CAevE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,SAAI,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAkBzE;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,EACpC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,OAAO,CAAC,CAAC,CAAC,CAOZ;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGrD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAUvD"}

package/dist/lib/agent-errors.js

@@ -0,0 +1,145 @@
+/**
+ * Shared Agent Error Logging Utility
+ *
+ * Logs errors to ~/.agent-errors/ with rotation.
+ * Used by all Treebird agents for centralized error tracking.
+ *
+ * @module agent-errors
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import { validateAgentId } from './security.js';
+const AGENT_ERRORS_DIR = path.join(os.homedir(), '.agent-errors');
+const MAX_LOG_SIZE = 1024 * 1024; // 1MB per log file
+const MAX_LOG_FILES = 10; // Keep 10 rotated files
+/**
+ * Ensure the agent errors directory exists
+ */
+function ensureErrorsDir() {
+    if (!fs.existsSync(AGENT_ERRORS_DIR)) {
+        fs.mkdirSync(AGENT_ERRORS_DIR, { recursive: true });
+    }
+}
+/**
+ * Rotate log file if it exceeds MAX_LOG_SIZE
+ */
+function rotateLogIfNeeded(logPath) {
+    if (!fs.existsSync(logPath))
+        return;
+    const stats = fs.statSync(logPath);
+    if (stats.size < MAX_LOG_SIZE)
+        return;
+    // Rotate existing files
+    for (let i = MAX_LOG_FILES - 1; i >= 1; i--) {
+        const oldPath = `${logPath}.${i}`;
+        const newPath = `${logPath}.${i + 1}`;
+        if (fs.existsSync(oldPath)) {
+            if (i === MAX_LOG_FILES - 1) {
+                fs.unlinkSync(oldPath); // Delete oldest
+            }
+            else {
+                fs.renameSync(oldPath, newPath);
+            }
+        }
+    }
+    // Rotate current log
+    fs.renameSync(logPath, `${logPath}.1`);
+}
+/**
+ * Log an error to the agent errors directory
+ */
+export function logAgentError(agent, context, error, metadata) {
+    try {
+        ensureErrorsDir();
+        const logPath = getErrorLogPath(agent);
+        rotateLogIfNeeded(logPath);
+        const entry = {
+            timestamp: new Date().toISOString(),
+            agent,
+            context,
+            error: error instanceof Error ? error.message : error,
+            stack: error instanceof Error ? error.stack : undefined,
+            metadata
+        };
+        const line = JSON.stringify(entry) + '\n';
+        fs.appendFileSync(logPath, line);
+    }
+    catch {
+        // Silently fail - don't let error logging cause more errors
+        console.error(`[agent-errors] Failed to log error for ${agent}`);
+    }
+}
+/**
+ * Read recent errors for an agent
+ */
+export function readAgentErrors(agent, limit = 10) {
+    try {
+        const logPath = getErrorLogPath(agent);
+        if (!fs.existsSync(logPath))
+            return [];
+        const content = fs.readFileSync(logPath, 'utf-8');
+        const lines = content.trim().split('\n').filter(l => l);
+        return lines
+            .slice(-limit)
+            .map(line => JSON.parse(line))
+            .reverse();
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Read all agent errors (summary)
+ */
+export function getAllAgentErrors(limit = 5) {
+    try {
+        ensureErrorsDir();
+        const files = fs.readdirSync(AGENT_ERRORS_DIR)
+            .filter(f => f.endsWith('.log') && !f.includes('.log.'));
+        const result = {};
+        for (const file of files) {
+            const agent = file.replace('.log', '');
+            result[agent] = readAgentErrors(agent, limit);
+        }
+        return result;
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Wrapper for MCP calls with error logging
+ */
+export async function withErrorLogging(agent, context, fn, metadata) {
+    try {
+        return await fn();
+    }
+    catch (error) {
+        logAgentError(agent, context, error, metadata);
+        throw error;
+    }
+}
+/**
+ * Get error log file path for an agent
+ */
+export function getErrorLogPath(agent) {
+    const safeAgent = validateAgentId(agent);
+    return path.join(AGENT_ERRORS_DIR, `${safeAgent}.log`);
+}
+/**
+ * Clear all errors for an agent
+ */
+export function clearAgentErrors(agent) {
+    try {
+        const logPath = getErrorLogPath(agent);
+        if (fs.existsSync(logPath)) {
+            fs.unlinkSync(logPath);
+        }
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=agent-errors.js.map

package/dist/lib/agent-errors.js.map

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

package/dist/lib/ai/context-builder.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Spidersan AI Core — Context Builder
+ *
+ * Aggregates context from all sources into structured SpiderContext.
+ * Uses storage adapter (not raw file reads) and pure functions (no CLI shelling).
+ * Each source is best-effort — failures are reported, not fatal.
+ */
+import type { SpiderContext } from './types.js';
+export interface BuildContextOptions {
+    repoRoot?: string;
+    includeActivity?: boolean;
+    includeDaily?: boolean;
+    verbose?: boolean;
+}
+export declare function buildContext(options?: BuildContextOptions): Promise<SpiderContext>;
+//# sourceMappingURL=context-builder.d.ts.map

package/dist/lib/ai/context-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-builder.d.ts","sourceRoot":"","sources":["../../../src/lib/ai/context-builder.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,OAAO,KAAK,EAGV,aAAa,EAGd,MAAM,YAAY,CAAC;AAUpB,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AA2ND,wBAAsB,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,aAAa,CAAC,CAmD5F"}