im-hub-pro 0.2.29

package/dist/core/event-bus.js

@@ -0,0 +1,62 @@
+// im-hub event bus — fan-out for cross-cutting state changes that the
+// dashboard / future plugins want to observe in real time.
+//
+// Why a dedicated bus instead of just exposing each module's
+// EventEmitter?
+//
+//   1. Type uniformity. Subscribers want to handle *any* event with one
+//      handler shape; otherwise tasks.html ends up wiring six different
+//      EventEmitters by hand.
+//   2. Cross-module decoupling. audit-log / approval-bus / job-board
+//      should not know that a Web SSE consumer exists. They emit on the
+//      bus; whoever wants to listen does.
+//   3. Backpressure / fan-out. The /events SSE endpoint multiplexes a
+//      single bus subscription out to N browser clients. If a single
+//      client is slow we don't want to drag the entire process; the bus
+//      only does fan-out, per-connection write-buffering is the SSE
+//      handler's responsibility.
+//
+// IMPORTANT: emit is best-effort. Never throw out of an emit() — the
+// caller (audit-log.logInvocation, approvalBus.handleApproval, etc.) is
+// in a hot path. We swallow listener errors here so a buggy subscriber
+// can't break the originating action.
+import { EventEmitter } from 'events';
+class ImhubEventBus extends EventEmitter {
+    /** Bounded recent-event log so a freshly-connected SSE client can
+     *  catch up on what happened in the last few seconds without needing
+     *  a separate REST poll. Cap at 200 entries — enough for the dashboard
+     *  to show a meaningful "what just happened" feed without bloating
+     *  process memory. */
+    recent = [];
+    static RECENT_CAP = 200;
+    constructor() {
+        super();
+        // EventEmitter defaults to 10 listeners before warning; we expect one
+        // handler per SSE connection plus a few internal subscribers, so 100
+        // is a comfortable cap that still flags accidental leaks.
+        this.setMaxListeners(100);
+    }
+    /**
+     * Publish a typed event. Listeners are called synchronously inside
+     * EventEmitter.emit; errors thrown from a listener are caught here so
+     * a bad subscriber can't break audit-log / approval-bus / job-board.
+     */
+    publish(event) {
+        this.recent.push(event);
+        while (this.recent.length > ImhubEventBus.RECENT_CAP)
+            this.recent.shift();
+        try {
+            this.emit('event', event);
+        }
+        catch {
+            // EventEmitter normally rethrows — caller is in a hot path so we swallow.
+        }
+    }
+    /** Snapshot of the recent ring buffer. Used by SSE handler on
+     *  connection to replay the last N events to a fresh client. */
+    getRecent() {
+        return this.recent.slice();
+    }
+}
+export const eventBus = new ImhubEventBus();
+//# sourceMappingURL=event-bus.js.map

package/dist/core/event-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.js","sourceRoot":"","sources":["../../src/core/event-bus.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,2DAA2D;AAC3D,EAAE;AACF,6DAA6D;AAC7D,gBAAgB;AAChB,EAAE;AACF,wEAAwE;AACxE,wEAAwE;AACxE,8BAA8B;AAC9B,qEAAqE;AACrE,wEAAwE;AACxE,0CAA0C;AAC1C,sEAAsE;AACtE,qEAAqE;AACrE,wEAAwE;AACxE,oEAAoE;AACpE,iCAAiC;AACjC,EAAE;AACF,qEAAqE;AACrE,wEAAwE;AACxE,uEAAuE;AACvE,sCAAsC;AAEtC,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA;AAgErC,MAAM,aAAc,SAAQ,YAAY;IACtC;;;;0BAIsB;IACd,MAAM,GAAiB,EAAE,CAAA;IACzB,MAAM,CAAU,UAAU,GAAG,GAAG,CAAA;IAExC;QACE,KAAK,EAAE,CAAA;QACP,sEAAsE;QACtE,qEAAqE;QACrE,0DAA0D;QAC1D,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAAA;IAC3B,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,KAAiB;QACvB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACvB,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,aAAa,CAAC,UAAU;YAAE,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAA;QACzE,IAAI,CAAC;YACH,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;QAC3B,CAAC;QAAC,MAAM,CAAC;YACP,0EAA0E;QAC5E,CAAC;IACH,CAAC;IAED;oEACgE;IAChE,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAA;IAC5B,CAAC;;AAGH,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,aAAa,EAAE,CAAA"}

package/dist/core/intent-llm.d.ts

@@ -0,0 +1,27 @@
+import type { AgentAdapter } from './types.js';
+export interface LLMJudgeConfig {
+    /** Agent name used as the judge. Must already be registered. */
+    agentName: string;
+    /** Score threshold below which the LLM is consulted (default 1.0). */
+    threshold?: number;
+    /** Override the default 5s response timeout. */
+    timeoutMs?: number;
+}
+export declare function configureLLMJudge(cfg: LLMJudgeConfig | null): void;
+/** Read the judge configuration. Used by classifyIntent to know whether
+ *  to attempt a fallback at all. */
+export declare function getLLMJudge(): LLMJudgeConfig | null;
+/**
+ * Ask the judge agent which candidate to use. Returns null on any
+ * failure path (timeout, judge unavailable, malformed response) so
+ * the caller can keep its rule-based decision.
+ */
+export declare function classifyWithLLM(text: string, candidates: string[], resolveAgent: (name: string) => AgentAdapter | undefined): Promise<{
+    agent: string;
+    reason: string;
+} | null>;
+/** Test-only: clear cache so memoization doesn't leak between cases. */
+export declare function _clearLLMCache(): void;
+/** Test/diagnostic: current cache size. */
+export declare function _cacheSize(): number;
+//# sourceMappingURL=intent-llm.d.ts.map

package/dist/core/intent-llm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent-llm.d.ts","sourceRoot":"","sources":["../../src/core/intent-llm.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAsD9C,MAAM,WAAW,cAAc;IAC7B,gEAAgE;IAChE,SAAS,EAAE,MAAM,CAAA;IACjB,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAID,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI,GAAG,IAAI,CAGlE;AAED;oCACoC;AACpC,wBAAgB,WAAW,IAAI,cAAc,GAAG,IAAI,CAEnD;AAgDD;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAAE,EACpB,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,YAAY,GAAG,SAAS,GACvD,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAqDnD;AAED,wEAAwE;AACxE,wBAAgB,cAAc,IAAI,IAAI,CAErC;AAED,2CAA2C;AAC3C,wBAAgB,UAAU,IAAI,MAAM,CAAsB"}

package/dist/core/intent-llm.js

@@ -0,0 +1,170 @@
+// LLM-backed intent fallback (P2-H).
+//
+// When the rule-based classifier produces a low-confidence result we
+// ask a configured "judge agent" — itself one of the registered agents
+// — to pick the best agent. Opt-in via env (IM_HUB_LLM_JUDGE_AGENT)
+// or programmatic configureLLMJudge() so we never silently spend
+// tokens by default.
+//
+// Caching: identical prompt+candidate-list pairs are memoized within a
+// 10-minute window so repeated chat-room banter doesn't burn budget.
+import { createHash } from 'crypto';
+import { logger as rootLogger } from './logger.js';
+const log = rootLogger.child({ component: 'intent-llm' });
+const CACHE_TTL_MS = 10 * 60 * 1000;
+const CACHE_MAX_ENTRIES = 1000; // LRU upper bound prevents unbounded growth
+const RESPONSE_TIMEOUT_MS = 5_000;
+/**
+ * LRU cache: insertion-order Map; on access we delete + re-set to bump
+ * the entry to the end. When size exceeds max we evict the head (the
+ * oldest unused entry).
+ */
+class LRUCache {
+    maxSize;
+    ttlMs;
+    store = new Map();
+    constructor(maxSize, ttlMs) {
+        this.maxSize = maxSize;
+        this.ttlMs = ttlMs;
+    }
+    get(key) {
+        const v = this.store.get(key);
+        if (!v)
+            return undefined;
+        if (Date.now() - v.ts > this.ttlMs) {
+            this.store.delete(key);
+            return undefined;
+        }
+        // Touch — move to end of insertion order
+        this.store.delete(key);
+        this.store.set(key, v);
+        return v;
+    }
+    set(key, value) {
+        if (this.store.has(key))
+            this.store.delete(key);
+        this.store.set(key, value);
+        // Evict from the head until under cap
+        while (this.store.size > this.maxSize) {
+            const first = this.store.keys().next().value;
+            if (first === undefined)
+                break;
+            this.store.delete(first);
+        }
+    }
+    clear() { this.store.clear(); }
+    get size() { return this.store.size; }
+}
+const cache = new LRUCache(CACHE_MAX_ENTRIES, CACHE_TTL_MS);
+let config = null;
+export function configureLLMJudge(cfg) {
+    config = cfg;
+    cache.clear();
+}
+/** Read the judge configuration. Used by classifyIntent to know whether
+ *  to attempt a fallback at all. */
+export function getLLMJudge() {
+    return config;
+}
+/** Probe env on first import so common deployments get auto-config. */
+function autoFromEnv() {
+    const name = process.env.IM_HUB_LLM_JUDGE_AGENT;
+    if (name && !config) {
+        const threshold = parseFloat(process.env.IM_HUB_LLM_JUDGE_THRESHOLD || '1.0');
+        config = {
+            agentName: name,
+            threshold: Number.isFinite(threshold) && threshold > 0 ? threshold : 1.0,
+        };
+    }
+}
+autoFromEnv();
+/** Hard cap on the prompt portion of the LRU key. Past this length the
+ *  key collapses, which is fine for a memo cache (occasional re-call is
+ *  cheap and doesn't affect correctness — the LLM judge runs again). It
+ *  matters because the key was previously the full prompt concatenated
+ *  with `|`-joined candidates, so a 100KB prompt + many candidates blew
+ *  the LRU's per-entry memory cost. */
+const MAX_KEY_TEXT_LEN = 256;
+function makeKey(text, candidates) {
+    // Hash the candidate list so the key length is bounded regardless of
+    // how many ACP agents are registered. SHA-256/16-hex (64 bits) gives
+    // 1-in-2^64 collision probability across the LRU window — irrelevant.
+    const candHash = createHash('sha256')
+        .update(candidates.slice().sort().join('|'))
+        .digest('hex').slice(0, 16);
+    const textKey = text.length > MAX_KEY_TEXT_LEN ? text.slice(0, MAX_KEY_TEXT_LEN) : text;
+    return `${candHash}||${textKey}`;
+}
+function buildPrompt(text, candidates) {
+    return [
+        'You are a router that picks the most appropriate agent for a user request.',
+        'Reply with EXACTLY one agent name from the list — no explanation, no punctuation.',
+        '',
+        'Candidates:',
+        ...candidates.map((c) => `  - ${c}`),
+        '',
+        `User request: ${text}`,
+        '',
+        'Best agent:',
+    ].join('\n');
+}
+/**
+ * Ask the judge agent which candidate to use. Returns null on any
+ * failure path (timeout, judge unavailable, malformed response) so
+ * the caller can keep its rule-based decision.
+ */
+export async function classifyWithLLM(text, candidates, resolveAgent) {
+    if (!config)
+        return null;
+    if (candidates.length === 0)
+        return null;
+    const key = makeKey(text, candidates);
+    const cached = cache.get(key);
+    if (cached) {
+        return { agent: cached.agent, reason: `${cached.reason} (cached)` };
+    }
+    const judge = resolveAgent(config.agentName);
+    if (!judge) {
+        log.warn({ judge: config.agentName }, 'LLM judge agent not registered');
+        return null;
+    }
+    const timeoutMs = config.timeoutMs ?? RESPONSE_TIMEOUT_MS;
+    const prompt = buildPrompt(text, candidates);
+    try {
+        let acc = '';
+        const generator = judge.sendPrompt(`llm-judge`, prompt, []);
+        const collect = (async () => {
+            for await (const chunk of generator) {
+                acc += chunk;
+                if (acc.length > 4096)
+                    break; // guard runaway output
+            }
+        })();
+        const timeout = new Promise((_, reject) => setTimeout(() => reject(new Error('LLM judge timed out')), timeoutMs));
+        await Promise.race([collect, timeout]);
+        // Parse: take the first line, lowercase, strip punctuation, match
+        // against candidates case-insensitively.
+        const firstLine = acc.split('\n').map((s) => s.trim()).filter(Boolean)[0] || '';
+        const cleaned = firstLine.toLowerCase().replace(/[^a-z0-9_-]/g, '');
+        const match = candidates.find((c) => c.toLowerCase() === cleaned)
+            ?? candidates.find((c) => cleaned.includes(c.toLowerCase()));
+        if (!match) {
+            log.warn({ raw: firstLine, candidates }, 'LLM judge produced unrecognized output');
+            return null;
+        }
+        const decision = { agent: match, reason: `LLM judge picked ${match}` };
+        cache.set(key, { ...decision, ts: Date.now() });
+        return decision;
+    }
+    catch (err) {
+        log.warn({ err: err instanceof Error ? err.message : String(err) }, 'LLM judge call failed');
+        return null;
+    }
+}
+/** Test-only: clear cache so memoization doesn't leak between cases. */
+export function _clearLLMCache() {
+    cache.clear();
+}
+/** Test/diagnostic: current cache size. */
+export function _cacheSize() { return cache.size; }
+//# sourceMappingURL=intent-llm.js.map

package/dist/core/intent-llm.js.map

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

package/dist/core/intent.d.ts

@@ -0,0 +1,12 @@
+import type { Logger } from 'pino';
+export interface IntentResult {
+    agent: string;
+    score: number;
+    reason: string;
+    triggeredBy: 'explicit' | 'sticky' | 'keyword' | 'topic' | 'fallback';
+}
+/**
+ * Classify a user message and return the best agent to handle it.
+ */
+export declare function classifyIntent(text: string, stickyAgent?: string, logger?: Logger): IntentResult;
+//# sourceMappingURL=intent.d.ts.map

package/dist/core/intent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent.d.ts","sourceRoot":"","sources":["../../src/core/intent.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAA;AAgFlC,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,CAAA;CACtE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,WAAW,CAAC,EAAE,MAAM,EACpB,MAAM,CAAC,EAAE,MAAM,GACd,YAAY,CA4Hd"}

package/dist/core/intent.js

@@ -0,0 +1,187 @@
+// Intent classifier — rule-based agent routing
+//
+// Phase 2: keyword matching with sticky session bias.
+// Phase 2b (future): small LLM for topic classification.
+import { registry } from './registry.js';
+import { circuitBreaker } from './circuit-breaker.js';
+const PROFILES = {
+    'opencode': {
+        keywords: ['代码', 'code', '编程', 'refactor', '重构', 'bug', '修复', 'fix', 'git', 'commit', 'deploy', 'build',
+            'test', '测试', 'api', 'server', '后端', 'frontend', '前端', 'sql', '数据库', 'database',
+            'python', 'typescript', 'javascript', 'rust', 'go', 'java',
+            'shell', 'bash', '命令行', 'terminal', 'config', '配置', 'docker', 'container'],
+        // Was 1.2 — same keywords also match claude-code, so the 0.2 advantage
+        // would push routing to opencode whenever the message mentioned any coding
+        // term. With sticky now an absolute lock (see classifyIntent below) this
+        // weight only matters for the very first message on a fresh thread, but we
+        // keep weights neutral so ordering comes from topic rules + defaultAgent.
+        weight: 1.0,
+    },
+    'claude-code': {
+        keywords: ['代码', 'code', '编程', 'refactor', '分析', 'analyze', 'architecture', '架构',
+            'design', '设计', 'review', '审查', 'explain', '解释', '文档', 'documentation',
+            'reasoning', '推理', 'complex', '复杂', 'research', '研究'],
+        weight: 1.0,
+    },
+    'codex': {
+        keywords: ['代码', 'code', 'bug', 'fix', '修复', 'quick', '快速', 'small', '简单', 'simple'],
+        weight: 0.9,
+    },
+    'copilot': {
+        keywords: ['代码', 'code', 'suggest', '建议', 'autocomplete', '补全', 'copilot'],
+        weight: 0.8,
+    },
+};
+// `\b` only matches between ASCII word chars and other chars — it does
+// nothing for CJK. We split keywords into ASCII (uses \b) and CJK
+// (boundary-free includes). Both branches are OR'd into one regex so
+// callers still get a single .test() call.
+function isCJK(s) {
+    for (const ch of s) {
+        const cp = ch.codePointAt(0) || 0;
+        if (cp >= 0x3000)
+            return true;
+    }
+    return false;
+}
+function escapeReg(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+function topic(words, agent, description) {
+    const ascii = words.filter((w) => !isCJK(w)).map(escapeReg);
+    const cjk = words.filter((w) => isCJK(w)).map(escapeReg);
+    const parts = [];
+    if (ascii.length)
+        parts.push(`\\b(?:${ascii.join('|')})\\b`);
+    if (cjk.length)
+        parts.push(`(?:${cjk.join('|')})`);
+    return { pattern: new RegExp(parts.join('|'), 'iu'), agent, description };
+}
+const TOPIC_RULES = [
+    topic(['git', 'commit', 'push', 'pull', 'merge', 'rebase', 'branch', 'stash'], 'opencode', 'git operations'),
+    topic(['test', '测试', 'spec', 'coverage', 'mock', 'stub'], 'opencode', 'testing'),
+    topic(['docker', 'container', 'kubernetes', 'k8s', 'deploy', 'ci', 'cd'], 'opencode', 'devops'),
+    topic(['sql', 'database', 'db', '查询', 'select', 'insert', 'update', 'delete'], 'opencode', 'database'),
+    topic(['review', '审查', 'audit', '检查'], 'claude-code', 'code review'),
+    topic(['explain', '解释', 'what is', '为什么', 'how does', '怎么回事'], 'claude-code', 'explanation'),
+];
+/**
+ * Classify a user message and return the best agent to handle it.
+ */
+export function classifyIntent(text, stickyAgent, logger) {
+    const available = registry.listAgents().filter(a => !circuitBreaker.isOpen(a));
+    if (available.length === 0) {
+        throw new Error('No agents available');
+    }
+    // Sticky is an absolute lock: once a thread is bound to an agent, only an
+    // explicit /<agent> command (or /new) can change it. Without this, a single
+    // keyword in a long-running thread could outscore the sticky bonus and
+    // silently swap agents — the "agent drift" symptom users hit after long
+    // pauses or across days. See router.ts:default → classifyIntent caller.
+    if (stickyAgent && available.includes(stickyAgent)) {
+        logger?.debug({ event: 'intent.sticky_lock', agent: stickyAgent }, `[intent] sticky lock honored (no classification)`);
+        return {
+            agent: stickyAgent,
+            score: 0,
+            reason: 'sticky lock (no classification)',
+            triggeredBy: 'sticky',
+        };
+    }
+    // Score per agent. Agents missing from PROFILES (e.g. user-installed
+    // custom ACP agents) get a default neutral weight so they remain
+    // selectable when no explicit signal favors a profiled agent.
+    const DEFAULT_WEIGHT = 0.5;
+    const scores = new Map();
+    for (const a of available) {
+        const profile = PROFILES[a];
+        scores.set(a, {
+            score: 0,
+            reasons: profile ? [] : ['default weight (no profile)'],
+            weight: profile?.weight ?? DEFAULT_WEIGHT,
+        });
+    }
+    const lower = text.toLowerCase();
+    // 1. Topic rule matching
+    for (const rule of TOPIC_RULES) {
+        if (rule.pattern.test(text)) {
+            const s = scores.get(rule.agent);
+            if (s) {
+                s.score += 2;
+                s.reasons.push(`topic: ${rule.description}`);
+            }
+        }
+    }
+    // 2. Keyword matching (uses each agent's own weight; profile-less agents
+    // can't keyword-match because they have no keywords list, but they still
+    // earn their base weight below).
+    for (const [agent, profile] of Object.entries(PROFILES)) {
+        const s = scores.get(agent);
+        if (!s)
+            continue;
+        for (const kw of profile.keywords) {
+            if (lower.includes(kw.toLowerCase())) {
+                s.score += 1 * profile.weight;
+                s.reasons.push(`keyword: "${kw}"`);
+            }
+        }
+    }
+    // 3. Base weight per agent (so a profile-less custom agent has a non-zero
+    // floor and won't be permanently dominated).
+    for (const [, s] of scores) {
+        s.score += s.weight * 0.5;
+    }
+    // 4. Sticky session bias
+    if (stickyAgent && scores.has(stickyAgent)) {
+        const s = scores.get(stickyAgent);
+        s.score += 3;
+        s.reasons.push('sticky: last used agent');
+    }
+    // Tie-break order:
+    //   1. higher score wins
+    //   2. sticky agent (if present in scores)
+    //   3. PROFILES declaration order (preserves intentional priority)
+    //   4. alphabetical, for full determinism
+    const profileOrder = Object.keys(PROFILES);
+    const rankOf = (agent) => {
+        if (stickyAgent && agent === stickyAgent)
+            return -1;
+        const idx = profileOrder.indexOf(agent);
+        return idx === -1 ? profileOrder.length : idx;
+    };
+    let best = null;
+    for (const [agent, s] of scores) {
+        if (!best) {
+            best = { agent, score: s.score, reasons: s.reasons };
+            continue;
+        }
+        if (s.score > best.score) {
+            best = { agent, score: s.score, reasons: s.reasons };
+            continue;
+        }
+        if (s.score === best.score) {
+            const cmp = rankOf(agent) - rankOf(best.agent);
+            if (cmp < 0 || (cmp === 0 && agent < best.agent)) {
+                best = { agent, score: s.score, reasons: s.reasons };
+            }
+        }
+    }
+    if (!best) {
+        // fallback to first available
+        const agent = available[0];
+        return { agent, score: 0, reason: 'fallback (no matches)', triggeredBy: 'fallback' };
+    }
+    const isSticky = stickyAgent === best.agent && best.reasons.includes('sticky: last used agent');
+    const hasTopic = best.reasons.some(r => r.startsWith('topic:'));
+    const hasKeyword = best.reasons.some(r => r.startsWith('keyword:'));
+    const triggeredBy = hasTopic ? 'topic'
+        : hasKeyword ? 'keyword'
+            : isSticky ? 'sticky'
+                : 'fallback';
+    return {
+        agent: best.agent,
+        score: Math.round(best.score * 100) / 100,
+        reason: best.reasons.join(', ') || `base score ${best.score.toFixed(1)}`,
+        triggeredBy,
+    };
+}
+//# sourceMappingURL=intent.js.map

package/dist/core/intent.js.map

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

package/dist/core/job-board.d.ts

@@ -0,0 +1,84 @@
+import type Database from 'better-sqlite3';
+import type { Logger } from 'pino';
+export type JobStatus = 'pending' | 'running' | 'completed' | 'failed' | 'cancelled';
+export interface Job {
+    id: number;
+    status: JobStatus;
+    agent: string;
+    prompt: string;
+    result: string | null;
+    error: string | null;
+    created_at: string;
+    completed_at: string | null;
+    /** IM userId of the originating caller, or '' for legacy / system rows. */
+    creator_id: string;
+    /** Workspace this job was created under, or '' if unknown. */
+    workspace_id: string;
+}
+interface JobRunner {
+    (job: Job, logger: Logger, signal: AbortSignal): AsyncGenerator<string>;
+}
+/** Stop the retention sweep (used by tests + graceful shutdown). */
+export declare function stopJobRetentionSweep(): void;
+/** Close the underlying SQLite handle. Called by cli.ts on graceful
+ *  shutdown so the WAL is checkpointed before exit (L2). */
+export declare function closeJobBoardDb(): void;
+/**
+ * Filter / scoping options accepted by every owner-sensitive job-board API.
+ *
+ * - When `creatorId` is set, the query is scoped to rows whose `creator_id`
+ *   matches the caller OR whose `creator_id` is '' (legacy / ownerless).
+ *   This preserves visibility of pre-migration jobs while preventing one
+ *   user from poking at another's freshly-created ones.
+ * - When `creatorId` is unset (undefined), no ownership filter is applied
+ *   — used by REST / ACP / scheduler entry-points that are guarded by the
+ *   web token, not by per-user identity.
+ */
+export interface OwnerOpts {
+    creatorId?: string;
+    /** Optional agent-name filter. When set, only rows whose `agent` column
+     *  matches are returned. Used by the dashboard to give per-agent views
+     *  (claude-code / opencode / codex tabs); IM commands generally don't
+     *  pass it (they want the user's full job history). */
+    agent?: string;
+}
+export interface CreateJobOpts {
+    creatorId?: string;
+    workspaceId?: string;
+}
+export declare function createJob(agent: string, prompt: string, opts?: CreateJobOpts): number;
+export declare function getJob(id: number, opts?: OwnerOpts): Job | null;
+export declare function listJobs(limit?: number, status?: JobStatus, opts?: OwnerOpts): Job[];
+/**
+ * Acquire a job slot. Returns immediately when capacity available, otherwise
+ * queues the caller and returns a promise that resolves when a slot frees.
+ */
+declare function acquireSlot(): Promise<void>;
+declare function releaseSlot(): void;
+export declare function runJob(id: number, runner: JobRunner, logger: Logger): Promise<void>;
+/** Test/diagnostic accessor: how many runJob invocations are currently in flight. */
+export declare function _activeJobCount(): number;
+/** Test/diagnostic accessor: the wait queue depth. */
+export declare function _waitQueueDepth(): number;
+/** Test-only: directly exercise the concurrency gate without SQLite. */
+export declare const _testSlot: {
+    acquire: typeof acquireSlot;
+    release: typeof releaseSlot;
+};
+export declare function cancelJob(id: number, opts?: OwnerOpts): boolean;
+/**
+ * Delete jobs that finished (completed / failed / cancelled) more than
+ * `daysRetention` days ago. 'pending' / 'running' rows are never pruned —
+ * a stalled-but-resumable job is the operator's call. Returns the row
+ * count so callers / tests can assert.
+ */
+export declare function pruneOldJobs(d?: Database.Database, daysRetention?: number): number;
+export declare function getJobStats(): {
+    total: number;
+    pending: number;
+    running: number;
+    completed: number;
+    failed: number;
+};
+export {};
+//# sourceMappingURL=job-board.d.ts.map

package/dist/core/job-board.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-board.d.ts","sourceRoot":"","sources":["../../src/core/job-board.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAA;AAG1C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAA;AA8DlC,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAA;AAEpF,MAAM,WAAW,GAAG;IAClB,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,SAAS,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,2EAA2E;IAC3E,UAAU,EAAE,MAAM,CAAA;IAClB,8DAA8D;IAC9D,YAAY,EAAE,MAAM,CAAA;CACrB;AAED,UAAU,SAAS;IACjB,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,cAAc,CAAC,MAAM,CAAC,CAAA;CACxE;AA4ED,oEAAoE;AACpE,wBAAgB,qBAAqB,IAAI,IAAI,CAK5C;AAED;4DAC4D;AAC5D,wBAAgB,eAAe,IAAI,IAAI,CAEtC;AAMD;;;;;;;;;;GAUG;AACH,MAAM,WAAW,SAAS;IACxB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;2DAGuD;IACvD,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,aAAkB,GAAG,MAAM,CASzF;AAED,wBAAgB,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,GAAE,SAAc,GAAG,GAAG,GAAG,IAAI,CAQnE;AAED,wBAAgB,QAAQ,CAAC,KAAK,SAAK,EAAE,MAAM,CAAC,EAAE,SAAS,EAAE,IAAI,GAAE,SAAc,GAAG,GAAG,EAAE,CAepF;AAcD;;;GAGG;AACH,iBAAe,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAQ1C;AAED,iBAAS,WAAW,IAAI,IAAI,CAI3B;AAED,wBAAsB,MAAM,CAC1B,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CA6Df;AAED,qFAAqF;AACrF,wBAAgB,eAAe,IAAI,MAAM,CAAsB;AAC/D,sDAAsD;AACtD,wBAAgB,eAAe,IAAI,MAAM,CAA4B;AACrE,wEAAwE;AACxE,eAAO,MAAM,SAAS;;;CAAiD,CAAA;AAEvE,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,GAAE,SAAc,GAAG,OAAO,CAWnE;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,CAAC,GAAE,QAAQ,CAAC,QAAmB,EAAE,aAAa,GAAE,MAA+B,GAAG,MAAM,CAsBpH;AAED,wBAAgB,WAAW,IAAI;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAqBpH"}