@backendkit-labs/agent-core 0.14.0

package/dist/checkpoint/index.js

@@ -0,0 +1,207 @@
+"use strict";
+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.createCheckpoint = createCheckpoint;
+exports.listCheckpoints = listCheckpoints;
+exports.getLatestCheckpoints = getLatestCheckpoints;
+exports.readCheckpoint = readCheckpoint;
+exports.extractSessionFromCheckpoint = extractSessionFromCheckpoint;
+exports.compactSession = compactSession;
+exports.compactSessionContent = compactSessionContent;
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+// ── Constants ─────────────────────────────────────────────────────────────────
+const SESSION_MAX_BYTES = 8192;
+// ── Filename helpers ──────────────────────────────────────────────────────────
+function buildCheckpointFilename(featureName) {
+    const now = new Date();
+    const date = now.toISOString().slice(0, 10);
+    const time = now.toTimeString().slice(0, 5).replace(':', '');
+    if (!featureName)
+        return `checkpoint-${date}-${time}.md`;
+    const safeName = featureName.replace(/[^\w\s-]/g, '').replace(/\s+/g, '-').toLowerCase();
+    return `checkpoint-${safeName}-${date}-${time}.md`;
+}
+function parseCheckpointFilename(filename) {
+    if (!filename.startsWith('checkpoint-') || !filename.endsWith('.md'))
+        return null;
+    const base = filename.slice('checkpoint-'.length, -'.md'.length);
+    // New format: {feature?}-YYYY-MM-DD-HHmm
+    const newFmt = base.match(/^(.*?)(\d{4}-\d{2}-\d{2})-(\d{4})$/);
+    if (newFmt) {
+        const feature = (newFmt[1] ?? '').replace(/-$/, '');
+        return { date: newFmt[2] ?? '', time: newFmt[3] ?? '', feature };
+    }
+    // Old format: YYYY-MM-DD-{feature} — parse for backwards compatibility
+    const oldFmt = base.match(/^(\d{4}-\d{2}-\d{2})-(.*)$/);
+    if (oldFmt) {
+        return { date: oldFmt[1] ?? '', time: '0000', feature: oldFmt[2] ?? '' };
+    }
+    return null;
+}
+// ── Checkpoint CRUD ───────────────────────────────────────────────────────────
+async function createCheckpoint(projectDir, featureName, description, sessionContent) {
+    const now = new Date();
+    const date = now.toISOString().slice(0, 10);
+    const timeDisplay = now.toTimeString().slice(0, 5);
+    const label = featureName || '(unnamed)';
+    const cpFile = path.join(projectDir, 'checkpoints', buildCheckpointFilename(featureName));
+    const content = [
+        '---',
+        `tags: [memory, checkpoint${featureName ? `, ${featureName.replace(/\s+/g, '-').toLowerCase()}` : ''}]`,
+        `date: ${date}`,
+        `time: ${timeDisplay}`,
+        `feature: "${featureName}"`,
+        '---',
+        '',
+        `# Checkpoint: ${label}`,
+        '',
+        `**Date:** ${date} ${timeDisplay}`,
+        description ? `**Description:** ${description}` : '',
+        '',
+        '---',
+        '',
+        '## Session state at checkpoint creation',
+        '',
+        sessionContent || '*(session.md is empty)*',
+    ].filter(l => l !== null).join('\n');
+    await fs.mkdir(path.dirname(cpFile), { recursive: true });
+    await fs.writeFile(cpFile, content, 'utf-8');
+    const logFile = path.join(projectDir, 'project-log.md');
+    try {
+        const log = await fs.readFile(logFile, 'utf-8');
+        const row = `| ${date} ${timeDisplay} | ${label} | Checkpoint |`;
+        if (log.includes('## Project Milestones')) {
+            const updated = log.replace(/(## Project Milestones[\s\S]*?\|---.*?\n)/, `$1${row}\n`);
+            await fs.writeFile(logFile, updated, 'utf-8');
+        }
+    }
+    catch { /* no log file */ }
+    return cpFile;
+}
+async function listCheckpoints(projectDir) {
+    const dir = path.join(projectDir, 'checkpoints');
+    try {
+        const files = await fs.readdir(dir);
+        return files
+            .filter(f => f.startsWith('checkpoint-') && f.endsWith('.md'))
+            .map(f => {
+            const parsed = parseCheckpointFilename(f);
+            if (!parsed)
+                return null;
+            return { filename: f, date: parsed.date, time: parsed.time, feature: parsed.feature, path: path.join(dir, f) };
+        })
+            .filter((x) => x !== null)
+            .sort((a, b) => `${b.date}-${b.time}`.localeCompare(`${a.date}-${a.time}`));
+    }
+    catch {
+        return [];
+    }
+}
+/** Returns the most recent checkpoint per unique feature name. */
+function getLatestCheckpoints(checkpoints) {
+    const seen = new Map();
+    for (const cp of checkpoints) {
+        const key = cp.feature || '__unnamed__';
+        if (!seen.has(key))
+            seen.set(key, cp);
+    }
+    return Array.from(seen.values());
+}
+async function readCheckpoint(projectDir, filename) {
+    try {
+        return await fs.readFile(path.join(projectDir, 'checkpoints', filename), 'utf-8');
+    }
+    catch {
+        return null;
+    }
+}
+/** Extracts only the session state body from a checkpoint file (strips frontmatter + headers). */
+function extractSessionFromCheckpoint(content) {
+    const marker = '## Session state at checkpoint creation';
+    const idx = content.indexOf(marker);
+    if (idx === -1)
+        return content;
+    return content.slice(idx + marker.length).trim();
+}
+// ── Session compaction ────────────────────────────────────────────────────────
+async function compactSession(projectDir, featureName, checkpointRef) {
+    const date = new Date().toISOString().slice(0, 10);
+    const sessionFile = path.join(projectDir, 'memory', 'session.md');
+    let content;
+    try {
+        content = await fs.readFile(sessionFile, 'utf-8');
+    }
+    catch {
+        return;
+    }
+    content = compactSessionContent(content);
+    content = content.replace(/^updated_at: .+$/m, `updated_at: ${date}`);
+    if (/^last_checkpoint:/m.test(content)) {
+        content = content.replace(/^last_checkpoint: .+$/m, `last_checkpoint: "${featureName}"`);
+    }
+    else {
+        content = content.replace(/^(updated_at: .+)$/m, `$1\nlast_checkpoint: "${featureName}"`);
+    }
+    content = content.replace(/\*(?:Created|Updated|Compacted) by .+ on .+\*/, `*Compacted on ${date} (checkpoint: ${checkpointRef})*`);
+    await fs.writeFile(sessionFile, content, 'utf-8');
+}
+function compactSessionContent(content) {
+    content = truncateSectionItems(content, 'Decisions', 5, 'bullet');
+    content = truncateSectionItems(content, 'Active Issues', 5, 'numbered');
+    if (Buffer.byteLength(content, 'utf-8') > SESSION_MAX_BYTES) {
+        content = truncateSectionItems(content, 'Engine Learnings', 3, 'bullet');
+    }
+    return content;
+}
+function truncateSectionItems(content, title, maxItems, style) {
+    const escaped = title.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    const re = new RegExp(`## ${escaped}\\n([\\s\\S]*?)(?=\\n---\\s*\\n|\\n## |$)`);
+    const match = re.exec(content);
+    if (!match)
+        return content;
+    const body = match[1] ?? '';
+    const pattern = style === 'bullet' ? /^-\s+.+$/gm : /^\d+\.\s+.+$/gm;
+    const items = body.match(pattern) ?? [];
+    if (items.length <= maxItems)
+        return content;
+    const kept = items.slice(-maxItems);
+    const newBody = style === 'numbered'
+        ? kept.map((line, i) => `${i + 1}. ${line.replace(/^\d+\.\s*/, '')}`).join('\n')
+        : kept.join('\n');
+    const sectionRe = new RegExp(`(## ${escaped}\\n)[\\s\\S]*?(?=\\n---\\s*\\n|\\n## |$)`);
+    return content.replace(sectionRe, `$1${newBody}\n`);
+}
+//# sourceMappingURL=index.js.map

package/dist/checkpoint/index.js.map

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

package/dist/commands/SlashCommandRegistry.d.ts

@@ -0,0 +1,98 @@
+export interface CommandAgentInfo {
+    id: string;
+    name: string;
+    icon?: string;
+    description: string;
+}
+export interface CommandSkillInfo {
+    name: string;
+    description: string;
+    triggers: string[];
+    language?: string[];
+    scope?: string;
+}
+export interface CommandContext {
+    /** Full original input string (e.g. "/agent coder"). */
+    rawInput: string;
+    /** Everything after the command name, trimmed. */
+    args: string;
+    /** Send text output back to the user. */
+    emit: (text: string) => void;
+    agents?: CommandAgentInfo[];
+    skills?: CommandSkillInfo[];
+    effectiveAgentId?: string;
+    model?: string;
+    /** Absolute path to the active project memory directory (for checkpoint commands). */
+    projectDir?: string;
+    /** Current content of memory/session.md (snapshotted into checkpoints). */
+    sessionContent?: string;
+    /** App name used to locate ~/.{appName}/ (for workspace commands). */
+    appName?: string;
+    /** Inject a message into the agent's active context window. */
+    injectContext?: (message: string) => void;
+    /** Called by /workspace switch when the active project changes. App handles the actual cwd/engine reload. */
+    onCwdChange?: (cwd: string) => void;
+    /** Run the LLM engine with a given prompt. Used by commands that need AI interpretation (e.g. /help). */
+    runEngine?: (prompt: string) => Promise<void>;
+    /**
+     * Solicita input interactivo al usuario.
+     * El agente conecta su propia implementación (Terminal.filteredSelect, web modal, etc.)
+     * Cuando no está presente, el comando hace fallback a ctx.emit() con texto plano.
+     *
+     * @param question  Pregunta a mostrar
+     * @param options   Si se proveen, el usuario elige entre estas opciones.
+     *                  Si no, es entrada de texto libre.
+     * @returns El valor elegido/escrito, o null si el usuario cancela.
+     */
+    prompt?: (question: string, options?: Array<{
+        label: string;
+        value: string;
+    }>) => Promise<string | null>;
+    /** Change the engine's iteration mode at runtime. */
+    setIterationMode?: (mode: 'interactive' | 'auto' | 'step-by-step') => void;
+    /** Returns the current iteration mode. */
+    getIterationMode?: () => 'interactive' | 'auto' | 'step-by-step';
+    /** Returns info about configured MCP servers and their connection status. */
+    mcpList?: () => Promise<Array<{
+        name: string;
+        url?: string;
+        connected: boolean;
+        toolCount: number;
+    }>>;
+    /** Add a new MCP server config at runtime. */
+    mcpAdd?: (config: unknown) => Promise<void>;
+    /** Remove an MCP server by name at runtime. */
+    mcpRemove?: (name: string) => Promise<void>;
+    /**
+     * Raw LLM call for commands that need AI-generated content (e.g. /skills generate).
+     * Not available in all host environments — commands must degrade gracefully when absent.
+     */
+    llm?: (prompt: string) => Promise<string>;
+    /**
+     * Reloads skills from disk into the engine and refreshes the command-context cache.
+     * Call after installing, creating, or generating skills so they take effect immediately.
+     * Not available in all host environments — commands must degrade gracefully when absent.
+     */
+    reloadSkills?: () => Promise<void>;
+}
+export type SlashCommandHandler = (ctx: CommandContext) => Promise<void>;
+export interface SlashCommand {
+    name: string;
+    description: string;
+    handler: SlashCommandHandler;
+}
+export declare class SlashCommandRegistry {
+    private readonly commands;
+    register(name: string, description: string, handler: SlashCommandHandler): this;
+    unregister(name: string): this;
+    /** Returns true if the input starts with a registered command name. */
+    isCommand(input: string): boolean;
+    /**
+     * Dispatches the input to the matching command handler.
+     * Returns true if a command was found and executed, false otherwise.
+     */
+    dispatch(input: string, ctx: Omit<CommandContext, 'args' | 'rawInput'>): Promise<boolean>;
+    getAll(): SlashCommand[];
+    private parseName;
+}
+//# sourceMappingURL=SlashCommandRegistry.d.ts.map

package/dist/commands/SlashCommandRegistry.d.ts.map

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

package/dist/commands/SlashCommandRegistry.js

@@ -0,0 +1,41 @@
+"use strict";
+// ── Types ─────────────────────────────────────────────────────────────────────
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SlashCommandRegistry = void 0;
+// ── Registry ──────────────────────────────────────────────────────────────────
+class SlashCommandRegistry {
+    commands = new Map();
+    register(name, description, handler) {
+        this.commands.set(name, { name, description, handler });
+        return this;
+    }
+    unregister(name) {
+        this.commands.delete(name);
+        return this;
+    }
+    /** Returns true if the input starts with a registered command name. */
+    isCommand(input) {
+        return this.commands.has(this.parseName(input));
+    }
+    /**
+     * Dispatches the input to the matching command handler.
+     * Returns true if a command was found and executed, false otherwise.
+     */
+    async dispatch(input, ctx) {
+        const name = this.parseName(input);
+        const cmd = this.commands.get(name);
+        if (!cmd)
+            return false;
+        const args = input.slice(name.length).trim();
+        await cmd.handler({ ...ctx, rawInput: input, args });
+        return true;
+    }
+    getAll() {
+        return [...this.commands.values()].sort((a, b) => a.name.localeCompare(b.name));
+    }
+    parseName(input) {
+        return input.trim().split(/\s+/)[0];
+    }
+}
+exports.SlashCommandRegistry = SlashCommandRegistry;
+//# sourceMappingURL=SlashCommandRegistry.js.map

package/dist/commands/SlashCommandRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SlashCommandRegistry.js","sourceRoot":"","sources":["../../src/commands/SlashCommandRegistry.ts"],"names":[],"mappings":";AAAA,iFAAiF;;;AAkFjF,iFAAiF;AAEjF,MAAa,oBAAoB;IACZ,QAAQ,GAAG,IAAI,GAAG,EAAwB,CAAC;IAE5D,QAAQ,CAAC,IAAY,EAAE,WAAmB,EAAE,OAA4B;QACpE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC;QACxD,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,UAAU,CAAC,IAAY;QACnB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC3B,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,uEAAuE;IACvE,SAAS,CAAC,KAAa;QACnB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IACpD,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,QAAQ,CACV,KAAa,EACb,GAA8C;QAE9C,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACnC,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,CAAC,GAAG;YAAE,OAAO,KAAK,CAAC;QACvB,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QAC7C,MAAM,GAAG,CAAC,OAAO,CAAC,EAAE,GAAG,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACrD,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,MAAM;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACpF,CAAC;IAEO,SAAS,CAAC,KAAa;QAC3B,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACxC,CAAC;CACJ;AAzCD,oDAyCC"}

package/dist/commands/builtin.d.ts

@@ -0,0 +1,7 @@
+import { SlashCommandRegistry } from './SlashCommandRegistry';
+/**
+ * Registers the framework's built-in slash commands into the given registry.
+ * Call this once when bootstrapping the app — before registering app-specific commands.
+ */
+export declare function registerBuiltinCommands(registry: SlashCommandRegistry): void;
+//# sourceMappingURL=builtin.d.ts.map

package/dist/commands/builtin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtin.d.ts","sourceRoot":"","sources":["../../src/commands/builtin.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AA2D9D;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI,CA+mB5E"}