@burtson-labs/host-kit 0.3.1

package/dist/checkpoints.js

@@ -0,0 +1,227 @@
+"use strict";
+/**
+ * Checkpoint store — snapshots every tool-driven file edit so the user
+ * can rewind after the fact. One entry per successful write_file /
+ * apply_edit; stores the full `before` text (plus metadata about the
+ * edit) under `.bandit/checkpoints/<turnId>/<id>.json`, and maintains
+ * a small flat index at `.bandit/checkpoints/index.json` for fast
+ * listing without walking the directory.
+ *
+ * Honest scope:
+ *   - Only reverts edits the agent made through write_file / apply_edit / replace_range / apply_patch.
+ *     Manual saves the user made between turns are NOT captured.
+ *   - Not a replacement for git. Meant for in-session undo when an
+ *     edit goes sideways and the user wants the previous state back
+ *     without hand-unwinding.
+ *
+ * Storage format is deliberately simple (plain JSON, one file per
+ * checkpoint) so it's inspectable with cat/jq when debugging.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CheckpointStore = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const INDEX_FILE = 'index.json';
+const DEFAULT_MAX_INDEX = 200;
+function lineCountDiff(before, after) {
+    if (before === after)
+        return { plus: 0, minus: 0 };
+    const a = before.split('\n');
+    const b = after.split('\n');
+    const m = a.length;
+    const n = b.length;
+    // Bounded LCS — same algorithm the extension uses for diff summaries.
+    if (m * n > 40000) {
+        // Fallback: approximate as full replacement. Rare in practice.
+        return { plus: b.length, minus: a.length };
+    }
+    const table = Array.from({ length: m + 1 }, () => new Array(n + 1).fill(0));
+    for (let i = 1; i <= m; i++) {
+        for (let j = 1; j <= n; j++) {
+            table[i][j] = a[i - 1] === b[j - 1] ? table[i - 1][j - 1] + 1 : Math.max(table[i - 1][j], table[i][j - 1]);
+        }
+    }
+    let i = m;
+    let j = n;
+    let plus = 0;
+    let minus = 0;
+    while (i > 0 && j > 0) {
+        if (a[i - 1] === b[j - 1]) {
+            i--;
+            j--;
+        }
+        else if (table[i][j - 1] >= table[i - 1][j]) {
+            plus++;
+            j--;
+        }
+        else {
+            minus++;
+            i--;
+        }
+    }
+    plus += j;
+    minus += i;
+    return { plus, minus };
+}
+function describeEdit(entry) {
+    if (entry.isNewFile)
+        return '(new file)';
+    // First non-empty line that differs — a reasonable hint of what the
+    // edit did. Guards against blank leading lines throwing the heading.
+    const afterLines = entry.after.split('\n');
+    const beforeLines = entry.before.split('\n');
+    for (let i = 0; i < afterLines.length; i++) {
+        if (afterLines[i] !== beforeLines[i]) {
+            const raw = (afterLines[i] ?? '').trim();
+            if (raw)
+                return raw.length > 80 ? raw.slice(0, 77) + '…' : raw;
+        }
+    }
+    return '(whitespace-only edit)';
+}
+class CheckpointStore {
+    constructor(options) {
+        this.counter = 0;
+        this.workspaceRoot = options.workspaceRoot;
+        this.dir = path.join(options.workspaceRoot, '.bandit', 'checkpoints');
+        this.maxIndexEntries = options.maxIndexEntries ?? DEFAULT_MAX_INDEX;
+    }
+    /** Create a checkpoint entry, persist it, and update the index. */
+    async create(input) {
+        await fs.promises.mkdir(path.join(this.dir, input.turnId), { recursive: true });
+        this.counter++;
+        const id = `chk-${input.turnId.split('-').pop() ?? 'x'}-${String(this.counter).padStart(3, '0')}`;
+        const relPath = path.relative(this.workspaceRoot, input.absolutePath) || input.absolutePath;
+        const isNewFile = input.before.length === 0;
+        const entry = {
+            id,
+            turnId: input.turnId,
+            timestamp: Date.now(),
+            tool: input.tool,
+            path: input.absolutePath,
+            relPath,
+            before: input.before,
+            after: input.after,
+            isNewFile,
+            iteration: input.iteration,
+            description: describeEdit({ before: input.before, after: input.after, isNewFile })
+        };
+        const entryFile = path.join(this.dir, input.turnId, `${id}.json`);
+        await fs.promises.writeFile(entryFile, JSON.stringify(entry, null, 2));
+        await this.appendToIndex(entry);
+        return entry;
+    }
+    /** Return the most recent N index entries (newest first). */
+    async list(limit = 20) {
+        const index = await this.readIndex();
+        return index.slice(0, limit);
+    }
+    /** Load a full checkpoint by id. Returns null when not found. */
+    async get(id) {
+        const index = await this.readIndex();
+        const hit = index.find((e) => e.id === id);
+        if (!hit)
+            return null;
+        const file = path.join(this.dir, hit.turnId, `${id}.json`);
+        try {
+            const raw = await fs.promises.readFile(file, 'utf-8');
+            return JSON.parse(raw);
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Restore the file to its pre-edit state. Returns the resolved entry
+     * on success, or null when the id wasn't found / couldn't be applied.
+     * New-file checkpoints are handled by unlinking the file (the file
+     * DIDN'T exist before, so that's the correct reverse operation).
+     */
+    async rewind(id) {
+        const entry = await this.get(id);
+        if (!entry)
+            return null;
+        try {
+            if (entry.isNewFile) {
+                await fs.promises.unlink(entry.path).catch(() => undefined);
+            }
+            else {
+                await fs.promises.mkdir(path.dirname(entry.path), { recursive: true });
+                await fs.promises.writeFile(entry.path, entry.before);
+            }
+            return entry;
+        }
+        catch {
+            return null;
+        }
+    }
+    async readIndex() {
+        const file = path.join(this.dir, INDEX_FILE);
+        try {
+            const raw = await fs.promises.readFile(file, 'utf-8');
+            const parsed = JSON.parse(raw);
+            return Array.isArray(parsed) ? parsed : [];
+        }
+        catch {
+            return [];
+        }
+    }
+    async writeIndex(entries) {
+        await fs.promises.mkdir(this.dir, { recursive: true });
+        const file = path.join(this.dir, INDEX_FILE);
+        await fs.promises.writeFile(file, JSON.stringify(entries, null, 2));
+    }
+    async appendToIndex(entry) {
+        const { plus, minus } = lineCountDiff(entry.before, entry.after);
+        const indexEntry = {
+            id: entry.id,
+            turnId: entry.turnId,
+            timestamp: entry.timestamp,
+            tool: entry.tool,
+            relPath: entry.relPath,
+            iteration: entry.iteration,
+            description: entry.description,
+            plus,
+            minus
+        };
+        const current = await this.readIndex();
+        current.unshift(indexEntry);
+        const trimmed = current.slice(0, this.maxIndexEntries);
+        await this.writeIndex(trimmed);
+    }
+}
+exports.CheckpointStore = CheckpointStore;
+//# sourceMappingURL=checkpoints.js.map

package/dist/checkpoints.js.map

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

package/dist/hooks.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Hooks — shell commands triggered at specific points in the agent lifecycle.
+ *
+ * Config format (.bandit/settings.json):
+ * {
+ *   "hooks": {
+ *     "PreToolUse":  [{ "match": "write_file", "command": "./scripts/guard.sh {{name}}" }],
+ *     "PostToolUse": [{ "match": ".*",         "command": "echo ${name} took ${duration}ms" }],
+ *     "Stop":        [{ "command": "./scripts/notify-done.sh" }]
+ *   }
+ * }
+ *
+ * - `match` is a regex applied against the tool name. Omit to match all.
+ * - `{{placeholder}}` tokens in `command` are substituted at runtime.
+ *   PreToolUse / PostToolUse provide: name, primary (first param value), duration (ms, Post only).
+ * - A non-zero exit code from a PreToolUse hook aborts the tool call.
+ */
+export type HookEvent = 'PreToolUse' | 'PostToolUse' | 'Stop';
+export interface HookRule {
+    match?: string;
+    command: string;
+    timeout?: number;
+}
+export interface PermissionsBlock {
+    allow?: string[];
+    deny?: string[];
+    ask?: string[];
+}
+export interface HookSettings {
+    hooks?: Partial<Record<HookEvent, HookRule[]>>;
+    permissions?: PermissionsBlock;
+}
+export declare function loadHookSettings(cwd: string): Promise<HookSettings>;
+/**
+ * Persist an entry in the workspace settings.json permissions.allow list.
+ * Called when the user picks "Always allow" in a permission prompt and wants
+ * the choice to survive restarts. Creates .bandit/settings.json if missing.
+ */
+export declare function persistAllowEntry(cwd: string, entry: string): Promise<void>;
+export interface HookContext {
+    toolName?: string;
+    primary?: string;
+    durationMs?: number;
+}
+export interface HookResult {
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+}
+export declare function runHooks(event: HookEvent, settings: HookSettings, ctx: HookContext, cwd: string): Promise<HookResult[]>;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH,MAAM,MAAM,SAAS,GAAG,YAAY,GAAG,aAAa,GAAG,MAAM,CAAC;AAE9D,MAAM,WAAW,QAAQ;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;IAC/C,WAAW,CAAC,EAAE,gBAAgB,CAAC;CAChC;AAID,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAyBzE;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBjF;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,QAAQ,CAC5B,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,YAAY,EACtB,GAAG,EAAE,WAAW,EAChB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,UAAU,EAAE,CAAC,CAYvB"}

package/dist/hooks.js

@@ -0,0 +1,152 @@
+"use strict";
+/**
+ * Hooks — shell commands triggered at specific points in the agent lifecycle.
+ *
+ * Config format (.bandit/settings.json):
+ * {
+ *   "hooks": {
+ *     "PreToolUse":  [{ "match": "write_file", "command": "./scripts/guard.sh {{name}}" }],
+ *     "PostToolUse": [{ "match": ".*",         "command": "echo ${name} took ${duration}ms" }],
+ *     "Stop":        [{ "command": "./scripts/notify-done.sh" }]
+ *   }
+ * }
+ *
+ * - `match` is a regex applied against the tool name. Omit to match all.
+ * - `{{placeholder}}` tokens in `command` are substituted at runtime.
+ *   PreToolUse / PostToolUse provide: name, primary (first param value), duration (ms, Post only).
+ * - A non-zero exit code from a PreToolUse hook aborts the tool call.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadHookSettings = loadHookSettings;
+exports.persistAllowEntry = persistAllowEntry;
+exports.runHooks = runHooks;
+const cp = __importStar(require("child_process"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const DEFAULT_TIMEOUT_MS = 10000;
+async function loadHookSettings(cwd) {
+    const candidates = [
+        path.resolve(cwd, '.bandit/settings.json'),
+        path.resolve(cwd, '.bandit/settings.local.json')
+    ];
+    const merged = { hooks: {}, permissions: { allow: [], deny: [], ask: [] } };
+    for (const p of candidates) {
+        try {
+            const raw = await fs.promises.readFile(p, 'utf-8');
+            const parsed = JSON.parse(raw);
+            if (parsed.hooks) {
+                for (const ev of Object.keys(parsed.hooks)) {
+                    merged.hooks[ev] = [...(merged.hooks[ev] ?? []), ...(parsed.hooks[ev] ?? [])];
+                }
+            }
+            if (parsed.permissions) {
+                merged.permissions.allow = [...(merged.permissions.allow ?? []), ...(parsed.permissions.allow ?? [])];
+                merged.permissions.deny = [...(merged.permissions.deny ?? []), ...(parsed.permissions.deny ?? [])];
+                merged.permissions.ask = [...(merged.permissions.ask ?? []), ...(parsed.permissions.ask ?? [])];
+            }
+        }
+        catch {
+            // Missing / invalid — skip silently.
+        }
+    }
+    return merged;
+}
+/**
+ * Persist an entry in the workspace settings.json permissions.allow list.
+ * Called when the user picks "Always allow" in a permission prompt and wants
+ * the choice to survive restarts. Creates .bandit/settings.json if missing.
+ */
+async function persistAllowEntry(cwd, entry) {
+    const dir = path.resolve(cwd, '.bandit');
+    const file = path.resolve(dir, 'settings.json');
+    await fs.promises.mkdir(dir, { recursive: true });
+    let existing = {};
+    try {
+        const raw = await fs.promises.readFile(file, 'utf-8');
+        existing = JSON.parse(raw);
+    }
+    catch {
+        // File didn't exist or was invalid — start fresh.
+    }
+    existing.permissions = existing.permissions ?? {};
+    existing.permissions.allow = existing.permissions.allow ?? [];
+    if (!existing.permissions.allow.includes(entry)) {
+        existing.permissions.allow.push(entry);
+    }
+    await fs.promises.writeFile(file, JSON.stringify(existing, null, 2) + '\n', 'utf-8');
+}
+async function runHooks(event, settings, ctx, cwd) {
+    const rules = settings.hooks?.[event] ?? [];
+    if (rules.length === 0)
+        return [];
+    const results = [];
+    for (const rule of rules) {
+        if (rule.match && ctx.toolName && !new RegExp(rule.match).test(ctx.toolName)) {
+            continue;
+        }
+        const cmd = expand(rule.command, ctx);
+        results.push(await runShell(cmd, cwd, rule.timeout ?? DEFAULT_TIMEOUT_MS));
+    }
+    return results;
+}
+function expand(template, ctx) {
+    return template
+        .replace(/\{\{\s*name\s*\}\}/g, shellEscape(ctx.toolName ?? ''))
+        .replace(/\{\{\s*primary\s*\}\}/g, shellEscape(ctx.primary ?? ''))
+        .replace(/\{\{\s*duration\s*\}\}/g, String(ctx.durationMs ?? ''));
+}
+function shellEscape(value) {
+    return `'${value.replace(/'/g, `'\\''`)}'`;
+}
+function runShell(command, cwd, timeoutMs) {
+    return new Promise((resolve) => {
+        let stdout = '';
+        let stderr = '';
+        const proc = cp.spawn(command, { cwd, shell: true, env: { ...process.env } });
+        const timer = setTimeout(() => { proc.kill('SIGTERM'); }, timeoutMs);
+        proc.stdout?.on('data', d => { stdout += d.toString(); });
+        proc.stderr?.on('data', d => { stderr += d.toString(); });
+        proc.on('close', code => {
+            clearTimeout(timer);
+            resolve({ exitCode: code ?? 0, stdout, stderr });
+        });
+        proc.on('error', err => {
+            clearTimeout(timer);
+            resolve({ exitCode: 1, stdout: '', stderr: err.message });
+        });
+    });
+}
+//# sourceMappingURL=hooks.js.map

package/dist/hooks.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+export { loadMemory, loadCombinedMemory, appendMemory, type MemoryBundle } from './memory';
+export { loadMemoryIndex, renderMemoryIndexBlock, MAX_INDEX_BYTES, MAX_MEMORY_FILE_BYTES, MEMORY_DIR, MEMORY_INDEX_FILE, type MemoryIndex, type MemoryIndexEntry, type MemoryWarnFn } from './memoryIndex';
+export { buildReadMemoryTool } from './tools/readMemoryTool';
+export { loadMcpServersConfig, registerMcpServersFromDisk, globalMcpServersPath, persistMcpActivation, addMcpServerToConfig } from './mcp';
+export { buildGitHubServerConfig, looksLikeGitHubToken, buildSlackServerConfig, looksLikeSlackToken, looksLikeSlackTeamId, buildGitLabServerConfig, looksLikeGitLabToken, buildGmailServerConfig, looksLikeGmailCredentialsPath, buildCustomServerConfig } from './mcpConnectors';
+export { loadApprovedMcpFingerprints, approveMcpFingerprint, revokeMcpFingerprint, mcpTrustPath } from './mcpTrust';
+export { loadMcpToolCache, saveMcpToolEntry, pruneMcpToolCache, mcpToolCachePath } from './mcpToolCache';
+export { loadHookSettings, persistAllowEntry, runHooks, type HookEvent, type HookRule, type HookSettings, type HookContext, type HookResult, type PermissionsBlock } from './hooks';
+export { expandMentions, type ExpandedPrompt } from './mentions';
+export { TodoStore, buildTodoWriteTool, buildWebFetchTool, buildWebSearchTool, type WebSearchToolOptions, buildRememberTool } from './tools/extraTools';
+export { buildTaskTool, buildCheckTaskTool, buildListTasksTool, type TaskToolOptions } from './tools/taskTool';
+export { buildTestRunTool, detectTestFramework, buildTestCommand, parseTestOutput, type TestFramework, type ParsedTestSummary } from './tools/testRunTool';
+export { computeInsights, renderInsightsHtml, writeInsightsReport, buildAiInput, buildInsightsAiCallback, type InsightsData, type WorkHighlight, type WorkTheme, type AiSummary, type AiSummaryInput, type AiSummaryFn, type OneShotChatFn } from './insights';
+export { InMemoryBackgroundTaskStore, type BackgroundTaskStore, type BackgroundTaskRecord, type BackgroundTaskStatus, type BackgroundTaskProgress } from './backgroundTasks';
+export { evaluatePermission, emptyPolicy, mergePolicies, SessionPermissionStore, type PermissionPolicy, type PermissionDecision } from './permissions';
+export { openTurnLog, previewText, listTurnTraceFiles, listTurnTraces, readTurnTrace, readTurnTraceById, parseTurnLog, summarizeTurnTrace, formatTurnTraceMarkdown, type TurnLogger, type TurnLogEvent, type TurnTrace, type TurnTraceSummary, type TurnTraceListOptions, type TurnTraceScope } from './turnLog';
+export { listInstalledOllamaModels, suggestOllamaMatch, isChatCapable, type OllamaModelInfo } from './ollamaModels';
+export { CheckpointStore, type CheckpointEntry, type CheckpointIndexEntry, type CheckpointStoreOptions } from './checkpoints';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,UAAU,CAAC;AAC3F,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,eAAe,EACf,qBAAqB,EACrB,UAAU,EACV,iBAAiB,EACjB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EAClB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EACL,oBAAoB,EACpB,0BAA0B,EAC1B,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACrB,MAAM,OAAO,CAAC;AACf,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,sBAAsB,EACtB,mBAAmB,EACnB,oBAAoB,EACpB,uBAAuB,EACvB,oBAAoB,EACpB,sBAAsB,EACtB,6BAA6B,EAC7B,uBAAuB,EACxB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,2BAA2B,EAC3B,qBAAqB,EACrB,oBAAoB,EACpB,YAAY,EACb,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,QAAQ,EACR,KAAK,SAAS,EACd,KAAK,QAAQ,EACb,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,gBAAgB,EACtB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,EACL,SAAS,EACT,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,KAAK,oBAAoB,EACzB,iBAAiB,EAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAC/G,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,EACf,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACvB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,YAAY,EACZ,uBAAuB,EACvB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,aAAa,EACnB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,2BAA2B,EAC3B,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC5B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,aAAa,EACb,sBAAsB,EACtB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACxB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,WAAW,EACX,WAAW,EACX,kBAAkB,EAClB,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,EAClB,uBAAuB,EACvB,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACpB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,yBAAyB,EACzB,kBAAkB,EAClB,aAAa,EACb,KAAK,eAAe,EACrB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,eAAe,EACf,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC5B,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeInsights = exports.parseTestOutput = exports.buildTestCommand = exports.detectTestFramework = exports.buildTestRunTool = exports.buildListTasksTool = exports.buildCheckTaskTool = exports.buildTaskTool = exports.buildRememberTool = exports.buildWebSearchTool = exports.buildWebFetchTool = exports.buildTodoWriteTool = exports.TodoStore = exports.expandMentions = exports.runHooks = exports.persistAllowEntry = exports.loadHookSettings = exports.mcpToolCachePath = exports.pruneMcpToolCache = exports.saveMcpToolEntry = exports.loadMcpToolCache = exports.mcpTrustPath = exports.revokeMcpFingerprint = exports.approveMcpFingerprint = exports.loadApprovedMcpFingerprints = exports.buildCustomServerConfig = exports.looksLikeGmailCredentialsPath = exports.buildGmailServerConfig = exports.looksLikeGitLabToken = exports.buildGitLabServerConfig = exports.looksLikeSlackTeamId = exports.looksLikeSlackToken = exports.buildSlackServerConfig = exports.looksLikeGitHubToken = exports.buildGitHubServerConfig = exports.addMcpServerToConfig = exports.persistMcpActivation = exports.globalMcpServersPath = exports.registerMcpServersFromDisk = exports.loadMcpServersConfig = exports.buildReadMemoryTool = exports.MEMORY_INDEX_FILE = exports.MEMORY_DIR = exports.MAX_MEMORY_FILE_BYTES = exports.MAX_INDEX_BYTES = exports.renderMemoryIndexBlock = exports.loadMemoryIndex = exports.appendMemory = exports.loadCombinedMemory = exports.loadMemory = void 0;
+exports.CheckpointStore = exports.isChatCapable = exports.suggestOllamaMatch = exports.listInstalledOllamaModels = exports.formatTurnTraceMarkdown = exports.summarizeTurnTrace = exports.parseTurnLog = exports.readTurnTraceById = exports.readTurnTrace = exports.listTurnTraces = exports.listTurnTraceFiles = exports.previewText = exports.openTurnLog = exports.SessionPermissionStore = exports.mergePolicies = exports.emptyPolicy = exports.evaluatePermission = exports.InMemoryBackgroundTaskStore = exports.buildInsightsAiCallback = exports.buildAiInput = exports.writeInsightsReport = exports.renderInsightsHtml = void 0;
+var memory_1 = require("./memory");
+Object.defineProperty(exports, "loadMemory", { enumerable: true, get: function () { return memory_1.loadMemory; } });
+Object.defineProperty(exports, "loadCombinedMemory", { enumerable: true, get: function () { return memory_1.loadCombinedMemory; } });
+Object.defineProperty(exports, "appendMemory", { enumerable: true, get: function () { return memory_1.appendMemory; } });
+var memoryIndex_1 = require("./memoryIndex");
+Object.defineProperty(exports, "loadMemoryIndex", { enumerable: true, get: function () { return memoryIndex_1.loadMemoryIndex; } });
+Object.defineProperty(exports, "renderMemoryIndexBlock", { enumerable: true, get: function () { return memoryIndex_1.renderMemoryIndexBlock; } });
+Object.defineProperty(exports, "MAX_INDEX_BYTES", { enumerable: true, get: function () { return memoryIndex_1.MAX_INDEX_BYTES; } });
+Object.defineProperty(exports, "MAX_MEMORY_FILE_BYTES", { enumerable: true, get: function () { return memoryIndex_1.MAX_MEMORY_FILE_BYTES; } });
+Object.defineProperty(exports, "MEMORY_DIR", { enumerable: true, get: function () { return memoryIndex_1.MEMORY_DIR; } });
+Object.defineProperty(exports, "MEMORY_INDEX_FILE", { enumerable: true, get: function () { return memoryIndex_1.MEMORY_INDEX_FILE; } });
+var readMemoryTool_1 = require("./tools/readMemoryTool");
+Object.defineProperty(exports, "buildReadMemoryTool", { enumerable: true, get: function () { return readMemoryTool_1.buildReadMemoryTool; } });
+var mcp_1 = require("./mcp");
+Object.defineProperty(exports, "loadMcpServersConfig", { enumerable: true, get: function () { return mcp_1.loadMcpServersConfig; } });
+Object.defineProperty(exports, "registerMcpServersFromDisk", { enumerable: true, get: function () { return mcp_1.registerMcpServersFromDisk; } });
+Object.defineProperty(exports, "globalMcpServersPath", { enumerable: true, get: function () { return mcp_1.globalMcpServersPath; } });
+Object.defineProperty(exports, "persistMcpActivation", { enumerable: true, get: function () { return mcp_1.persistMcpActivation; } });
+Object.defineProperty(exports, "addMcpServerToConfig", { enumerable: true, get: function () { return mcp_1.addMcpServerToConfig; } });
+var mcpConnectors_1 = require("./mcpConnectors");
+Object.defineProperty(exports, "buildGitHubServerConfig", { enumerable: true, get: function () { return mcpConnectors_1.buildGitHubServerConfig; } });
+Object.defineProperty(exports, "looksLikeGitHubToken", { enumerable: true, get: function () { return mcpConnectors_1.looksLikeGitHubToken; } });
+Object.defineProperty(exports, "buildSlackServerConfig", { enumerable: true, get: function () { return mcpConnectors_1.buildSlackServerConfig; } });
+Object.defineProperty(exports, "looksLikeSlackToken", { enumerable: true, get: function () { return mcpConnectors_1.looksLikeSlackToken; } });
+Object.defineProperty(exports, "looksLikeSlackTeamId", { enumerable: true, get: function () { return mcpConnectors_1.looksLikeSlackTeamId; } });
+Object.defineProperty(exports, "buildGitLabServerConfig", { enumerable: true, get: function () { return mcpConnectors_1.buildGitLabServerConfig; } });
+Object.defineProperty(exports, "looksLikeGitLabToken", { enumerable: true, get: function () { return mcpConnectors_1.looksLikeGitLabToken; } });
+Object.defineProperty(exports, "buildGmailServerConfig", { enumerable: true, get: function () { return mcpConnectors_1.buildGmailServerConfig; } });
+Object.defineProperty(exports, "looksLikeGmailCredentialsPath", { enumerable: true, get: function () { return mcpConnectors_1.looksLikeGmailCredentialsPath; } });
+Object.defineProperty(exports, "buildCustomServerConfig", { enumerable: true, get: function () { return mcpConnectors_1.buildCustomServerConfig; } });
+var mcpTrust_1 = require("./mcpTrust");
+Object.defineProperty(exports, "loadApprovedMcpFingerprints", { enumerable: true, get: function () { return mcpTrust_1.loadApprovedMcpFingerprints; } });
+Object.defineProperty(exports, "approveMcpFingerprint", { enumerable: true, get: function () { return mcpTrust_1.approveMcpFingerprint; } });
+Object.defineProperty(exports, "revokeMcpFingerprint", { enumerable: true, get: function () { return mcpTrust_1.revokeMcpFingerprint; } });
+Object.defineProperty(exports, "mcpTrustPath", { enumerable: true, get: function () { return mcpTrust_1.mcpTrustPath; } });
+var mcpToolCache_1 = require("./mcpToolCache");
+Object.defineProperty(exports, "loadMcpToolCache", { enumerable: true, get: function () { return mcpToolCache_1.loadMcpToolCache; } });
+Object.defineProperty(exports, "saveMcpToolEntry", { enumerable: true, get: function () { return mcpToolCache_1.saveMcpToolEntry; } });
+Object.defineProperty(exports, "pruneMcpToolCache", { enumerable: true, get: function () { return mcpToolCache_1.pruneMcpToolCache; } });
+Object.defineProperty(exports, "mcpToolCachePath", { enumerable: true, get: function () { return mcpToolCache_1.mcpToolCachePath; } });
+var hooks_1 = require("./hooks");
+Object.defineProperty(exports, "loadHookSettings", { enumerable: true, get: function () { return hooks_1.loadHookSettings; } });
+Object.defineProperty(exports, "persistAllowEntry", { enumerable: true, get: function () { return hooks_1.persistAllowEntry; } });
+Object.defineProperty(exports, "runHooks", { enumerable: true, get: function () { return hooks_1.runHooks; } });
+var mentions_1 = require("./mentions");
+Object.defineProperty(exports, "expandMentions", { enumerable: true, get: function () { return mentions_1.expandMentions; } });
+var extraTools_1 = require("./tools/extraTools");
+Object.defineProperty(exports, "TodoStore", { enumerable: true, get: function () { return extraTools_1.TodoStore; } });
+Object.defineProperty(exports, "buildTodoWriteTool", { enumerable: true, get: function () { return extraTools_1.buildTodoWriteTool; } });
+Object.defineProperty(exports, "buildWebFetchTool", { enumerable: true, get: function () { return extraTools_1.buildWebFetchTool; } });
+Object.defineProperty(exports, "buildWebSearchTool", { enumerable: true, get: function () { return extraTools_1.buildWebSearchTool; } });
+Object.defineProperty(exports, "buildRememberTool", { enumerable: true, get: function () { return extraTools_1.buildRememberTool; } });
+var taskTool_1 = require("./tools/taskTool");
+Object.defineProperty(exports, "buildTaskTool", { enumerable: true, get: function () { return taskTool_1.buildTaskTool; } });
+Object.defineProperty(exports, "buildCheckTaskTool", { enumerable: true, get: function () { return taskTool_1.buildCheckTaskTool; } });
+Object.defineProperty(exports, "buildListTasksTool", { enumerable: true, get: function () { return taskTool_1.buildListTasksTool; } });
+var testRunTool_1 = require("./tools/testRunTool");
+Object.defineProperty(exports, "buildTestRunTool", { enumerable: true, get: function () { return testRunTool_1.buildTestRunTool; } });
+Object.defineProperty(exports, "detectTestFramework", { enumerable: true, get: function () { return testRunTool_1.detectTestFramework; } });
+Object.defineProperty(exports, "buildTestCommand", { enumerable: true, get: function () { return testRunTool_1.buildTestCommand; } });
+Object.defineProperty(exports, "parseTestOutput", { enumerable: true, get: function () { return testRunTool_1.parseTestOutput; } });
+var insights_1 = require("./insights");
+Object.defineProperty(exports, "computeInsights", { enumerable: true, get: function () { return insights_1.computeInsights; } });
+Object.defineProperty(exports, "renderInsightsHtml", { enumerable: true, get: function () { return insights_1.renderInsightsHtml; } });
+Object.defineProperty(exports, "writeInsightsReport", { enumerable: true, get: function () { return insights_1.writeInsightsReport; } });
+Object.defineProperty(exports, "buildAiInput", { enumerable: true, get: function () { return insights_1.buildAiInput; } });
+Object.defineProperty(exports, "buildInsightsAiCallback", { enumerable: true, get: function () { return insights_1.buildInsightsAiCallback; } });
+var backgroundTasks_1 = require("./backgroundTasks");
+Object.defineProperty(exports, "InMemoryBackgroundTaskStore", { enumerable: true, get: function () { return backgroundTasks_1.InMemoryBackgroundTaskStore; } });
+var permissions_1 = require("./permissions");
+Object.defineProperty(exports, "evaluatePermission", { enumerable: true, get: function () { return permissions_1.evaluatePermission; } });
+Object.defineProperty(exports, "emptyPolicy", { enumerable: true, get: function () { return permissions_1.emptyPolicy; } });
+Object.defineProperty(exports, "mergePolicies", { enumerable: true, get: function () { return permissions_1.mergePolicies; } });
+Object.defineProperty(exports, "SessionPermissionStore", { enumerable: true, get: function () { return permissions_1.SessionPermissionStore; } });
+var turnLog_1 = require("./turnLog");
+Object.defineProperty(exports, "openTurnLog", { enumerable: true, get: function () { return turnLog_1.openTurnLog; } });
+Object.defineProperty(exports, "previewText", { enumerable: true, get: function () { return turnLog_1.previewText; } });
+Object.defineProperty(exports, "listTurnTraceFiles", { enumerable: true, get: function () { return turnLog_1.listTurnTraceFiles; } });
+Object.defineProperty(exports, "listTurnTraces", { enumerable: true, get: function () { return turnLog_1.listTurnTraces; } });
+Object.defineProperty(exports, "readTurnTrace", { enumerable: true, get: function () { return turnLog_1.readTurnTrace; } });
+Object.defineProperty(exports, "readTurnTraceById", { enumerable: true, get: function () { return turnLog_1.readTurnTraceById; } });
+Object.defineProperty(exports, "parseTurnLog", { enumerable: true, get: function () { return turnLog_1.parseTurnLog; } });
+Object.defineProperty(exports, "summarizeTurnTrace", { enumerable: true, get: function () { return turnLog_1.summarizeTurnTrace; } });
+Object.defineProperty(exports, "formatTurnTraceMarkdown", { enumerable: true, get: function () { return turnLog_1.formatTurnTraceMarkdown; } });
+var ollamaModels_1 = require("./ollamaModels");
+Object.defineProperty(exports, "listInstalledOllamaModels", { enumerable: true, get: function () { return ollamaModels_1.listInstalledOllamaModels; } });
+Object.defineProperty(exports, "suggestOllamaMatch", { enumerable: true, get: function () { return ollamaModels_1.suggestOllamaMatch; } });
+Object.defineProperty(exports, "isChatCapable", { enumerable: true, get: function () { return ollamaModels_1.isChatCapable; } });
+var checkpoints_1 = require("./checkpoints");
+Object.defineProperty(exports, "CheckpointStore", { enumerable: true, get: function () { return checkpoints_1.CheckpointStore; } });
+//# 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,mCAA2F;AAAlF,oGAAA,UAAU,OAAA;AAAE,4GAAA,kBAAkB,OAAA;AAAE,sGAAA,YAAY,OAAA;AACrD,6CAUuB;AATrB,8GAAA,eAAe,OAAA;AACf,qHAAA,sBAAsB,OAAA;AACtB,8GAAA,eAAe,OAAA;AACf,oHAAA,qBAAqB,OAAA;AACrB,yGAAA,UAAU,OAAA;AACV,gHAAA,iBAAiB,OAAA;AAKnB,yDAA6D;AAApD,qHAAA,mBAAmB,OAAA;AAC5B,6BAMe;AALb,2GAAA,oBAAoB,OAAA;AACpB,iHAAA,0BAA0B,OAAA;AAC1B,2GAAA,oBAAoB,OAAA;AACpB,2GAAA,oBAAoB,OAAA;AACpB,2GAAA,oBAAoB,OAAA;AAEtB,iDAWyB;AAVvB,wHAAA,uBAAuB,OAAA;AACvB,qHAAA,oBAAoB,OAAA;AACpB,uHAAA,sBAAsB,OAAA;AACtB,oHAAA,mBAAmB,OAAA;AACnB,qHAAA,oBAAoB,OAAA;AACpB,wHAAA,uBAAuB,OAAA;AACvB,qHAAA,oBAAoB,OAAA;AACpB,uHAAA,sBAAsB,OAAA;AACtB,8HAAA,6BAA6B,OAAA;AAC7B,wHAAA,uBAAuB,OAAA;AAEzB,uCAKoB;AAJlB,uHAAA,2BAA2B,OAAA;AAC3B,iHAAA,qBAAqB,OAAA;AACrB,gHAAA,oBAAoB,OAAA;AACpB,wGAAA,YAAY,OAAA;AAEd,+CAKwB;AAJtB,gHAAA,gBAAgB,OAAA;AAChB,gHAAA,gBAAgB,OAAA;AAChB,iHAAA,iBAAiB,OAAA;AACjB,gHAAA,gBAAgB,OAAA;AAElB,iCAUiB;AATf,yGAAA,gBAAgB,OAAA;AAChB,0GAAA,iBAAiB,OAAA;AACjB,iGAAA,QAAQ,OAAA;AAQV,uCAAiE;AAAxD,0GAAA,cAAc,OAAA;AACvB,iDAO4B;AAN1B,uGAAA,SAAS,OAAA;AACT,gHAAA,kBAAkB,OAAA;AAClB,+GAAA,iBAAiB,OAAA;AACjB,gHAAA,kBAAkB,OAAA;AAElB,+GAAA,iBAAiB,OAAA;AAEnB,6CAA+G;AAAtG,yGAAA,aAAa,OAAA;AAAE,8GAAA,kBAAkB,OAAA;AAAE,8GAAA,kBAAkB,OAAA;AAC9D,mDAO6B;AAN3B,+GAAA,gBAAgB,OAAA;AAChB,kHAAA,mBAAmB,OAAA;AACnB,+GAAA,gBAAgB,OAAA;AAChB,8GAAA,eAAe,OAAA;AAIjB,uCAaoB;AAZlB,2GAAA,eAAe,OAAA;AACf,8GAAA,kBAAkB,OAAA;AAClB,+GAAA,mBAAmB,OAAA;AACnB,wGAAA,YAAY,OAAA;AACZ,mHAAA,uBAAuB,OAAA;AASzB,qDAM2B;AALzB,8HAAA,2BAA2B,OAAA;AAM7B,6CAOuB;AANrB,iHAAA,kBAAkB,OAAA;AAClB,0GAAA,WAAW,OAAA;AACX,4GAAA,aAAa,OAAA;AACb,qHAAA,sBAAsB,OAAA;AAIxB,qCAgBmB;AAfjB,sGAAA,WAAW,OAAA;AACX,sGAAA,WAAW,OAAA;AACX,6GAAA,kBAAkB,OAAA;AAClB,yGAAA,cAAc,OAAA;AACd,wGAAA,aAAa,OAAA;AACb,4GAAA,iBAAiB,OAAA;AACjB,uGAAA,YAAY,OAAA;AACZ,6GAAA,kBAAkB,OAAA;AAClB,kHAAA,uBAAuB,OAAA;AAQzB,+CAKwB;AAJtB,yHAAA,yBAAyB,OAAA;AACzB,kHAAA,kBAAkB,OAAA;AAClB,6GAAA,aAAa,OAAA;AAGf,6CAKuB;AAJrB,8GAAA,eAAe,OAAA"}