@backendkit-labs/agent-core 0.14.0

package/dist/agent-memory/tools.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildMemoryTools = buildMemoryTools;
+const defineTool_1 = require("../tools/defineTool");
+function buildMemoryTools(episodic, semantic, procedural) {
+    return [
+        (0, defineTool_1.defineTool)({
+            name: 'memory_remember',
+            description: 'Store an experience or observation in long-term episodic memory.',
+            input: defineTool_1.z.object({
+                content: defineTool_1.z.string().describe('What to remember'),
+                tags: defineTool_1.z.array(defineTool_1.z.string()).default([]).describe('Optional tags (e.g. ["deploy", "error", "pr-123"])'),
+            }),
+            execute: async ({ content, tags }) => {
+                const id = episodic.remember(content, tags);
+                return `Stored in episodic memory (id: ${id}). Total episodes: ${episodic.count()}.`;
+            },
+        }),
+        (0, defineTool_1.defineTool)({
+            name: 'memory_recall',
+            description: 'Search episodic memory for past experiences relevant to a query.',
+            input: defineTool_1.z.object({
+                query: defineTool_1.z.string().describe('What to search for'),
+                limit: defineTool_1.z.number().int().min(1).max(20).default(5),
+            }),
+            execute: async ({ query, limit }) => {
+                const episodes = episodic.recall(query, limit);
+                if (episodes.length === 0)
+                    return 'No relevant episodes found.';
+                return episodes.map(e => `[${e.createdAt.toISOString().slice(0, 10)}${e.tags.length ? ` #${e.tags.join(' #')}` : ''}] ${e.content}`).join('\n');
+            },
+        }),
+        (0, defineTool_1.defineTool)({
+            name: 'memory_save_knowledge',
+            description: 'Store a piece of knowledge or decision in semantic memory for future retrieval.',
+            input: defineTool_1.z.object({
+                content: defineTool_1.z.string().describe('Knowledge to store'),
+                metadata: defineTool_1.z.record(defineTool_1.z.string()).default({}).describe('Optional key-value metadata'),
+            }),
+            execute: async ({ content, metadata }) => {
+                const id = await semantic.index(content, metadata);
+                return `Stored in semantic memory (id: ${id}). Total entries: ${semantic.count()}.`;
+            },
+        }),
+        (0, defineTool_1.defineTool)({
+            name: 'memory_search_knowledge',
+            description: 'Search semantic memory for relevant knowledge or past decisions.',
+            input: defineTool_1.z.object({
+                query: defineTool_1.z.string().describe('What to search for'),
+                limit: defineTool_1.z.number().int().min(1).max(10).default(5),
+            }),
+            execute: async ({ query, limit }) => {
+                const results = await semantic.search(query, limit);
+                if (results.length === 0)
+                    return 'No relevant knowledge found.';
+                return results.map(k => `[score=${(k.score ?? 0).toFixed(2)}] ${k.content}`).join('\n');
+            },
+        }),
+        (0, defineTool_1.defineTool)({
+            name: 'memory_learn_pattern',
+            description: 'Record what worked or failed so future runs can use this knowledge.',
+            input: defineTool_1.z.object({
+                trigger: defineTool_1.z.string().describe('When this situation/context occurs'),
+                action: defineTool_1.z.string().describe('The action taken'),
+                outcome: defineTool_1.z.enum(['success', 'failure']).describe('Whether the action worked'),
+            }),
+            execute: async ({ trigger, action, outcome }) => {
+                procedural.learnPattern(trigger, action, outcome);
+                return `Pattern recorded: when "${trigger}" → "${action}" [${outcome}].`;
+            },
+        }),
+    ];
+}
+//# sourceMappingURL=tools.js.map

package/dist/agent-memory/tools.js.map

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

package/dist/agent-memory/types.d.ts

@@ -0,0 +1,75 @@
+export interface Episode {
+    id: string;
+    content: string;
+    tags: string[];
+    createdAt: Date;
+    score?: number;
+}
+export interface Knowledge {
+    id: string;
+    content: string;
+    metadata: Record<string, string>;
+    embedding?: number[];
+    createdAt: Date;
+    score?: number;
+}
+export interface Pattern {
+    id: string;
+    trigger: string;
+    action: string;
+    outcome: 'success' | 'failure';
+    occurrences: number;
+    lastSeen: Date;
+}
+/** Serializable record stored by any backend. */
+export interface StoredRecord {
+    id: string;
+    createdAt: string;
+    [key: string]: unknown;
+}
+export interface MemoryStoreBackend {
+    insert(record: StoredRecord): void;
+    upsert(id: string, record: StoredRecord): void;
+    getAll(): StoredRecord[];
+    deleteOldest(keepNewest: number): void;
+    count(): number;
+}
+/** Produces a vector embedding for a text. Inject to enable semantic similarity search. */
+export type EmbedFn = (text: string) => Promise<number[]>;
+/**
+ * Condenses a list of episodes into a single summary string.
+ * Inject to enable memory compaction (e.g., call an LLM).
+ */
+export type SummarizeFn = (episodes: Episode[]) => Promise<string>;
+export interface EpisodicConfig {
+    provider?: 'in-memory' | 'json';
+    /** File path for 'json' provider. */
+    path?: string;
+}
+export interface SemanticConfig {
+    provider?: 'in-memory' | 'json';
+    path?: string;
+    /** When provided, enables vector similarity search instead of keyword search. */
+    embedFn?: EmbedFn;
+}
+export interface ProceduralConfig {
+    provider?: 'in-memory' | 'json';
+    path?: string;
+}
+export interface RetentionConfig {
+    /** Maximum number of episodes to keep. Oldest are pruned when exceeded. */
+    maxEpisodes?: number;
+    /**
+     * After this many new episodes, trigger summarization (requires summarizeFn).
+     * The resulting summary is stored as a new episode tagged 'summary'.
+     */
+    summarizeAfter?: number;
+    summarizeFn?: SummarizeFn;
+}
+export interface MemorySystemConfig {
+    episodic?: EpisodicConfig;
+    semantic?: SemanticConfig;
+    procedural?: ProceduralConfig;
+    retention?: RetentionConfig;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/agent-memory/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/agent-memory/types.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,OAAO;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,EAAE,IAAI,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,IAAI,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,OAAO;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,SAAS,GAAG,SAAS,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,IAAI,CAAC;CAClB;AAID,iDAAiD;AACjD,MAAM,WAAW,YAAY;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IAC/B,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IACnC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IAC/C,MAAM,IAAI,YAAY,EAAE,CAAC;IACzB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,KAAK,IAAI,MAAM,CAAC;CACnB;AAID,2FAA2F;AAC3F,MAAM,MAAM,OAAO,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;AAE1D;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAInE,MAAM,WAAW,cAAc;IAC3B,QAAQ,CAAC,EAAE,WAAW,GAAG,MAAM,CAAC;IAChC,qCAAqC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC3B,QAAQ,CAAC,EAAE,WAAW,GAAG,MAAM,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iFAAiF;IACjF,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC7B,QAAQ,CAAC,EAAE,WAAW,GAAG,MAAM,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC5B,2EAA2E;IAC3E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,WAAW,CAAC;CAC7B;AAED,MAAM,WAAW,kBAAkB;IAC/B,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,SAAS,CAAC,EAAE,eAAe,CAAC;CAC/B"}

package/dist/agent-memory/types.js

@@ -0,0 +1,4 @@
+"use strict";
+// ── Records ───────────────────────────────────────────────────────────────────
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/agent-memory/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/agent-memory/types.ts"],"names":[],"mappings":";AAAA,iFAAiF"}

package/dist/bootstrap/GlobalSeed.d.ts

@@ -0,0 +1,46 @@
+import type { Skill } from '../skills/types';
+import type { AgentProfile } from '../types';
+export interface SeedResult {
+    createdConfig: boolean;
+    createdUserMd: boolean;
+    createdAgentMd: boolean;
+    createdDirs: string[];
+    seededAgents: string[];
+    seededSkills: number;
+}
+export interface GlobalSeedOptions {
+    /**
+     * Agents to seed as .json + .md pairs on first run so users can discover
+     * and customize them. Pass CODING_AGENTS here.
+     * Only writes files that don't already exist — safe to call on every startup.
+     */
+    agents?: AgentProfile[];
+    /**
+     * Skills to seed as YAML files on first run so users can discover and
+     * customize them. Pass all builtin skills (global + packs).
+     * The engine always loads skills from memory — seeding is optional UX scaffolding.
+     */
+    skills?: Skill[];
+}
+/**
+ * Idempotent initialization of the framework's global directory structure.
+ * Runs at app startup — creates dirs and files only if they don't exist.
+ *
+ * Creates:
+ *   ~/.{appName}/
+ *   ├── config.json
+ *   ├── USER.md
+ *   ├── workspaces.json
+ *   ├── agent-notes/
+ *   ├── agents/          ← seeded from options.agents
+ *   ├── skills/
+ *   │   ├── sources.json
+ *   │   ├── global/      ← global skills from options.skills
+ *   │   └── packs/       ← pack skills from options.skills (grouped by skill.pack)
+ *   └── projects/
+ *       └── {cwd-slug}/
+ *           ├── memory/
+ *           └── audits/
+ */
+export declare function runGlobalSeed(appName: string, cwd?: string, options?: GlobalSeedOptions): Promise<SeedResult>;
+//# sourceMappingURL=GlobalSeed.d.ts.map

package/dist/bootstrap/GlobalSeed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GlobalSeed.d.ts","sourceRoot":"","sources":["../../src/bootstrap/GlobalSeed.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAI7C,MAAM,WAAW,UAAU;IACvB,aAAa,EAAG,OAAO,CAAC;IACxB,aAAa,EAAG,OAAO,CAAC;IACxB,cAAc,EAAE,OAAO,CAAC;IACxB,WAAW,EAAK,MAAM,EAAE,CAAC;IACzB,YAAY,EAAI,MAAM,EAAE,CAAC;IACzB,YAAY,EAAI,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAC9B;;;;OAIG;IACH,MAAM,CAAC,EAAE,YAAY,EAAE,CAAC;IACxB;;;;OAIG;IACH,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;CACpB;AA4FD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,aAAa,CAC/B,OAAO,EAAE,MAAM,EACf,GAAG,GAAE,MAAsB,EAC3B,OAAO,GAAE,iBAAsB,GAChC,OAAO,CAAC,UAAU,CAAC,CA+JrB"}

package/dist/bootstrap/GlobalSeed.js

@@ -0,0 +1,285 @@
+"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.runGlobalSeed = runGlobalSeed;
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+const crypto_1 = require("crypto");
+const project_key_1 = require("../shared/utils/project-key");
+const config_1 = require("./config");
+const parse_md_skill_1 = require("../skills/parse-md-skill");
+// ── Helpers ───────────────────────────────────────────────────────────────────
+async function fileExists(p) {
+    return fs.access(p).then(() => true).catch(() => false);
+}
+async function ensureDir(dir, created) {
+    try {
+        await fs.mkdir(dir, { recursive: true });
+        created.push(dir);
+    }
+    catch { /* already exists */ }
+}
+// ── Templates ─────────────────────────────────────────────────────────────────
+function buildUserMdTemplate(appName) {
+    return `# Preferencias del Desarrollador
+
+> Editado por el usuario — el agente lee este archivo al arrancar.
+
+## Estilo de comunicacion
+- Respuestas concisas y directas
+- Sin resumen al final de cada respuesta
+- Codigo sin comentarios obvios
+
+## Stack preferido
+- <!-- Ej: Node.js + TypeScript, Python, Go -->
+
+## Convenciones
+- <!-- Ej: conventional commits, kebab-case para archivos -->
+
+## Lo que NO quiero
+- Emojis en el codigo
+- Feature flags para cambios directos
+- Manejo de errores especulativo
+
+## Notas adicionales
+- <!-- Cualquier preferencia especifica para ${appName} -->
+`;
+}
+function buildAgentMdTemplate(projectName) {
+    return `# ${projectName} — Instrucciones del Proyecto
+
+> Editado por el equipo — el agente lee este archivo en cada sesion.
+
+## Stack
+- <!-- Ej: Node.js 20, TypeScript 5.7, NestJS 11, PostgreSQL -->
+
+## Convenciones
+- <!-- Estructura de carpetas, patrones usados, nombres -->
+
+## Reglas de este proyecto
+- <!-- Lo que el agente DEBE y NO DEBE hacer aqui -->
+
+## Contexto de negocio
+- <!-- Dominio, entidades clave, flujos principales -->
+`;
+}
+const AGENTS_README = `# Custom Agents
+
+Place \`.json + .md\` file pairs here to define or override agents.
+
+## Format
+
+**{id}.json** — metadata:
+\`\`\`json
+{
+  "id": "my-agent",
+  "name": "My Agent",
+  "icon": "◇",
+  "description": "What this agent does",
+  "allowedTools": ["read_file", "write_file", "run_command"],
+  "delegatesTo": ["coder"]
+}
+\`\`\`
+
+**{id}.md** — system prompt (overrides the json systemPrompt field):
+\`\`\`
+You are a specialist agent for...
+\`\`\`
+
+## Override a builtin
+Drop only a \`.md\` file (no \`.json\`) to override just the system prompt
+of an existing builtin agent while keeping its metadata.
+`;
+// ── Public API ────────────────────────────────────────────────────────────────
+/**
+ * Idempotent initialization of the framework's global directory structure.
+ * Runs at app startup — creates dirs and files only if they don't exist.
+ *
+ * Creates:
+ *   ~/.{appName}/
+ *   ├── config.json
+ *   ├── USER.md
+ *   ├── workspaces.json
+ *   ├── agent-notes/
+ *   ├── agents/          ← seeded from options.agents
+ *   ├── skills/
+ *   │   ├── sources.json
+ *   │   ├── global/      ← global skills from options.skills
+ *   │   └── packs/       ← pack skills from options.skills (grouped by skill.pack)
+ *   └── projects/
+ *       └── {cwd-slug}/
+ *           ├── memory/
+ *           └── audits/
+ */
+async function runGlobalSeed(appName, cwd = process.cwd(), options = {}) {
+    const globalDir = (0, project_key_1.getFrameworkDir)(appName);
+    const agentsDir = path.join(globalDir, 'agents');
+    const agentNotesDir = path.join(globalDir, 'agent-notes');
+    const skillsDir = path.join(globalDir, 'skills');
+    const skillsGlobal = path.join(skillsDir, 'global');
+    const skillsPacks = path.join(skillsDir, 'packs');
+    const projectsDir = path.join(globalDir, 'projects');
+    const projectKey = (0, project_key_1.cwdToProjectKey)(cwd);
+    const projectDir = path.join(projectsDir, projectKey);
+    const projectName = path.basename(cwd);
+    const result = {
+        createdConfig: false,
+        createdUserMd: false,
+        createdAgentMd: false,
+        createdDirs: [],
+        seededAgents: [],
+        seededSkills: 0,
+    };
+    // ── 1. Core directory structure ───────────────────────────────────────────
+    const coreDirs = [
+        globalDir,
+        agentsDir,
+        agentNotesDir,
+        skillsDir,
+        skillsGlobal,
+        skillsPacks,
+        projectsDir,
+        projectDir,
+        path.join(projectDir, 'memory'),
+        path.join(projectDir, 'audits'),
+        path.join(projectDir, 'skills'),
+        path.join(projectDir, 'checkpoints'),
+    ];
+    await Promise.all(coreDirs.map(d => ensureDir(d, result.createdDirs)));
+    // ── 2. config.json ────────────────────────────────────────────────────────
+    const configPath = path.join(globalDir, 'config.json');
+    if (!(await fileExists(configPath))) {
+        await fs.writeFile(configPath, JSON.stringify(config_1.DEFAULT_CONFIG, null, 2), 'utf-8');
+        result.createdConfig = true;
+    }
+    // ── 3. USER.md ────────────────────────────────────────────────────────────
+    const userMdPath = path.join(globalDir, 'USER.md');
+    if (!(await fileExists(userMdPath))) {
+        await fs.writeFile(userMdPath, buildUserMdTemplate(appName), 'utf-8');
+        result.createdUserMd = true;
+    }
+    // ── 4. workspaces.json ────────────────────────────────────────────────────
+    const workspacesPath = path.join(globalDir, 'workspaces.json');
+    if (!(await fileExists(workspacesPath))) {
+        await fs.writeFile(workspacesPath, JSON.stringify({}, null, 2), 'utf-8');
+    }
+    // ── 5. agents/README.md ───────────────────────────────────────────────────
+    const agentsReadme = path.join(agentsDir, 'README.md');
+    if (!(await fileExists(agentsReadme))) {
+        await fs.writeFile(agentsReadme, AGENTS_README, 'utf-8');
+    }
+    // ── 6. AGENT.md in project root ───────────────────────────────────────────
+    const agentMdPath = path.join(cwd, 'AGENT.md');
+    if (!(await fileExists(agentMdPath))) {
+        await fs.writeFile(agentMdPath, buildAgentMdTemplate(projectName), 'utf-8');
+        result.createdAgentMd = true;
+    }
+    // ── 7. Seed agents (.json + .md pairs) ───────────────────────────────────
+    // Re-seeds builtin prompts when the framework updates them, but only if the
+    // user has not customized the file. Customization is detected by comparing
+    // the current file content hash against the hash stored at seed time
+    // (_builtinHash in the .json). If they match → factory default → safe to
+    // update. If they differ → user-modified → leave it alone.
+    const agentsToSeed = options.agents ?? [];
+    await Promise.all(agentsToSeed.map(async (agent) => {
+        const jsonPath = path.join(agentsDir, `${agent.id}.json`);
+        const mdPath = path.join(agentsDir, `${agent.id}.md`);
+        const builtinHash = (0, crypto_1.createHash)('sha256').update(agent.systemPrompt).digest('hex').slice(0, 16);
+        const [jsonExists, mdExists] = await Promise.all([
+            fileExists(jsonPath),
+            fileExists(mdPath),
+        ]);
+        // Read stored hash BEFORE overwriting .json
+        const storedHash = jsonExists
+            ? await fs.readFile(jsonPath, 'utf-8')
+                .then(raw => JSON.parse(raw)._builtinHash)
+                .catch(() => undefined)
+            : undefined;
+        // Always write/update metadata .json (never has user content)
+        const { systemPrompt, source, systemPromptAddition, ...meta } = agent;
+        await fs.writeFile(jsonPath, JSON.stringify({ ...meta, _builtinHash: builtinHash }, null, 2), 'utf-8');
+        if (!mdExists) {
+            // First seed — write prompt
+            await fs.writeFile(mdPath, agent.systemPrompt, 'utf-8');
+            result.seededAgents.push(agent.id);
+            return;
+        }
+        if (!storedHash) {
+            // Pre-hash seed (old install) — treat as factory default, update
+            await fs.writeFile(mdPath, agent.systemPrompt, 'utf-8');
+            result.seededAgents.push(agent.id);
+            return;
+        }
+        // Compare current file content hash against what was originally seeded
+        const currentContent = await fs.readFile(mdPath, 'utf-8');
+        const currentHash = (0, crypto_1.createHash)('sha256').update(currentContent).digest('hex').slice(0, 16);
+        if (currentHash === storedHash && storedHash !== builtinHash) {
+            // File is still factory default but builtin has changed — update
+            await fs.writeFile(mdPath, agent.systemPrompt, 'utf-8');
+            result.seededAgents.push(agent.id);
+        }
+        // else: user modified (currentHash !== storedHash) → leave it alone
+        //       or: already up to date (storedHash === builtinHash) → no-op
+    }));
+    // ── 8. Seed skills as YAML ────────────────────────────────────────────────
+    if (options.skills && options.skills.length > 0) {
+        await Promise.all(options.skills.map(async (skill) => {
+            const dir = skill.scope === 'pack' && skill.pack
+                ? path.join(skillsPacks, skill.pack)
+                : skillsGlobal;
+            await fs.mkdir(dir, { recursive: true });
+            const skillPath = path.join(dir, `${skill.name}.md`);
+            if (!(await fileExists(skillPath))) {
+                await fs.writeFile(skillPath, (0, parse_md_skill_1.skillToMd)(skill), 'utf-8');
+                result.seededSkills++;
+            }
+        }));
+        // ── 9. skills/sources.json — registry of installed packs ─────────────
+        const sourcesPath = path.join(skillsDir, 'sources.json');
+        if (!(await fileExists(sourcesPath))) {
+            const packs = [...new Set(options.skills
+                    .filter(s => s.scope === 'pack' && s.pack)
+                    .map(s => s.pack))];
+            const sources = packs.map(pack => ({
+                pack,
+                source: 'builtin',
+                installedAt: new Date().toISOString(),
+            }));
+            await fs.writeFile(sourcesPath, JSON.stringify(sources, null, 2), 'utf-8');
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=GlobalSeed.js.map

package/dist/bootstrap/GlobalSeed.js.map

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

package/dist/bootstrap/config.d.ts

@@ -0,0 +1,24 @@
+export interface ProviderConfig {
+    model: string;
+    apiKey?: string;
+    baseUrl?: string;
+}
+export interface FrameworkFeatures {
+    qa: boolean;
+    orchestration: boolean;
+    reflection: boolean;
+    delegation: boolean;
+}
+export interface FrameworkConfig {
+    version: string;
+    defaultProvider: string;
+    defaultModel: string;
+    defaultAgentId: string;
+    maxIterations: number;
+    maxParallelAgents: number;
+    providers: Record<string, ProviderConfig>;
+    features: FrameworkFeatures;
+}
+export declare const DEFAULT_CONFIG: FrameworkConfig;
+export declare function loadFrameworkConfig(appName: string): Promise<FrameworkConfig>;
+//# sourceMappingURL=config.d.ts.map

package/dist/bootstrap/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/bootstrap/config.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,cAAc;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAC9B,EAAE,EAAE,OAAO,CAAC;IACZ,aAAa,EAAE,OAAO,CAAC;IACvB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC1C,QAAQ,EAAE,iBAAiB,CAAC;CAC/B;AAED,eAAO,MAAM,cAAc,EAAE,eAkB5B,CAAC;AAIF,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAQnF"}

package/dist/bootstrap/config.js

@@ -0,0 +1,71 @@
+"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.DEFAULT_CONFIG = void 0;
+exports.loadFrameworkConfig = loadFrameworkConfig;
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+const project_key_1 = require("../shared/utils/project-key");
+exports.DEFAULT_CONFIG = {
+    version: '2.0.0',
+    defaultProvider: 'anthropic',
+    defaultModel: 'claude-sonnet-4-6',
+    defaultAgentId: 'general',
+    maxIterations: 100,
+    maxParallelAgents: 6,
+    providers: {
+        anthropic: { model: 'claude-sonnet-4-6' },
+        openai: { model: 'gpt-4o' },
+        deepseek: { model: 'deepseek-chat' },
+    },
+    features: {
+        qa: true,
+        orchestration: true,
+        reflection: true,
+        delegation: true,
+    },
+};
+// ── Loader ────────────────────────────────────────────────────────────────────
+async function loadFrameworkConfig(appName) {
+    const configPath = path.join((0, project_key_1.getFrameworkDir)(appName), 'config.json');
+    try {
+        const raw = await fs.readFile(configPath, 'utf-8');
+        return { ...exports.DEFAULT_CONFIG, ...JSON.parse(raw) };
+    }
+    catch {
+        return exports.DEFAULT_CONFIG;
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/bootstrap/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/bootstrap/config.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoDA,kDAQC;AA5DD,gDAAkC;AAClC,2CAA6B;AAC7B,6DAA8D;AA4BjD,QAAA,cAAc,GAAoB;IAC3C,OAAO,EAAE,OAAO;IAChB,eAAe,EAAE,WAAW;IAC5B,YAAY,EAAE,mBAAmB;IACjC,cAAc,EAAE,SAAS;IACzB,aAAa,EAAE,GAAG;IAClB,iBAAiB,EAAE,CAAC;IACpB,SAAS,EAAE;QACP,SAAS,EAAE,EAAE,KAAK,EAAE,mBAAmB,EAAE;QACzC,MAAM,EAAK,EAAE,KAAK,EAAE,QAAQ,EAAE;QAC9B,QAAQ,EAAG,EAAE,KAAK,EAAE,eAAe,EAAE;KACxC;IACD,QAAQ,EAAE;QACN,EAAE,EAAc,IAAI;QACpB,aAAa,EAAG,IAAI;QACpB,UAAU,EAAM,IAAI;QACpB,UAAU,EAAM,IAAI;KACvB;CACJ,CAAC;AAEF,iFAAiF;AAE1E,KAAK,UAAU,mBAAmB,CAAC,OAAe;IACrD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,IAAA,6BAAe,EAAC,OAAO,CAAC,EAAE,aAAa,CAAC,CAAC;IACtE,IAAI,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QACnD,OAAO,EAAE,GAAG,sBAAc,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAqB,CAAC;IACxE,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,sBAAc,CAAC;IAC1B,CAAC;AACL,CAAC"}

package/dist/checkpoint/index.d.ts

@@ -0,0 +1,17 @@
+export interface CheckpointSummary {
+    filename: string;
+    date: string;
+    time: string;
+    feature: string;
+    path: string;
+}
+export declare function createCheckpoint(projectDir: string, featureName: string, description: string, sessionContent: string): Promise<string>;
+export declare function listCheckpoints(projectDir: string): Promise<CheckpointSummary[]>;
+/** Returns the most recent checkpoint per unique feature name. */
+export declare function getLatestCheckpoints(checkpoints: CheckpointSummary[]): CheckpointSummary[];
+export declare function readCheckpoint(projectDir: string, filename: string): Promise<string | null>;
+/** Extracts only the session state body from a checkpoint file (strips frontmatter + headers). */
+export declare function extractSessionFromCheckpoint(content: string): string;
+export declare function compactSession(projectDir: string, featureName: string, checkpointRef: string): Promise<void>;
+export declare function compactSessionContent(content: string): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/checkpoint/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/checkpoint/index.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,iBAAiB;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CAChB;AAuCD,wBAAsB,gBAAgB,CAClC,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,GACvB,OAAO,CAAC,MAAM,CAAC,CA4CjB;AAED,wBAAsB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAgBtF;AAED,kEAAkE;AAClE,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,iBAAiB,EAAE,GAAG,iBAAiB,EAAE,CAO1F;AAED,wBAAsB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAMjG;AAED,kGAAkG;AAClG,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAKpE;AAID,wBAAsB,cAAc,CAChC,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,GACtB,OAAO,CAAC,IAAI,CAAC,CA8Bf;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAO7D"}