@backendkit-labs/agent-core 0.14.0

package/dist/agent-discovery/AgentPackageLoader.d.ts

@@ -0,0 +1,14 @@
+import type { AgentProfile } from '../types';
+/**
+ * Load agent definitions from a directory.
+ *
+ * Supports two layouts:
+ *   <dir>/my-agent.yaml           ← single-file agent
+ *   <dir>/my-agent/agent.yaml     ← package-directory agent
+ */
+export declare function loadAgentsFromDir(dir: string, source: AgentProfile['source']): AgentProfile[];
+/** Returns the global agents directory: ~/.{appName}/agents/ */
+export declare function globalAgentsDir(appName: string): string;
+/** Returns the project-local agents directory: {cwd}/.{appName}/agents/ */
+export declare function projectAgentsDir(cwd: string, appName: string): string;
+//# sourceMappingURL=AgentPackageLoader.d.ts.map

package/dist/agent-discovery/AgentPackageLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentPackageLoader.d.ts","sourceRoot":"","sources":["../../src/agent-discovery/AgentPackageLoader.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAK7C;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC7B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,GAC/B,YAAY,EAAE,CAyBhB;AAED,gEAAgE;AAChE,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,2EAA2E;AAC3E,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAErE"}

package/dist/agent-discovery/AgentPackageLoader.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadAgentsFromDir = loadAgentsFromDir;
+exports.globalAgentsDir = globalAgentsDir;
+exports.projectAgentsDir = projectAgentsDir;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const os_1 = require("os");
+const yaml_1 = require("yaml");
+const REQUIRED_FIELDS = ['id', 'name', 'description', 'systemPrompt', 'allowedTools'];
+/**
+ * Load agent definitions from a directory.
+ *
+ * Supports two layouts:
+ *   <dir>/my-agent.yaml           ← single-file agent
+ *   <dir>/my-agent/agent.yaml     ← package-directory agent
+ */
+function loadAgentsFromDir(dir, source) {
+    if (!(0, fs_1.existsSync)(dir))
+        return [];
+    const agents = [];
+    for (const entry of (0, fs_1.readdirSync)(dir, { withFileTypes: true })) {
+        // Skip the registry cache sub-directory
+        if (entry.name === 'registry')
+            continue;
+        let filePath = null;
+        if (entry.isFile() && isYamlOrJson(entry.name)) {
+            filePath = (0, path_1.join)(dir, entry.name);
+        }
+        else if (entry.isDirectory()) {
+            const nested = (0, path_1.join)(dir, entry.name, 'agent.yaml');
+            if ((0, fs_1.existsSync)(nested))
+                filePath = nested;
+        }
+        if (!filePath)
+            continue;
+        const agent = parseAgentFile(filePath, source);
+        if (agent)
+            agents.push(agent);
+    }
+    return agents;
+}
+/** Returns the global agents directory: ~/.{appName}/agents/ */
+function globalAgentsDir(appName) {
+    return (0, path_1.join)((0, os_1.homedir)(), `.${appName}`, 'agents');
+}
+/** Returns the project-local agents directory: {cwd}/.{appName}/agents/ */
+function projectAgentsDir(cwd, appName) {
+    return (0, path_1.join)(cwd, `.${appName}`, 'agents');
+}
+// ── Private ───────────────────────────────────────────────────────────────────
+function parseAgentFile(filePath, source) {
+    try {
+        const content = (0, fs_1.readFileSync)(filePath, 'utf-8');
+        const raw = (0, path_1.extname)(filePath) === '.json'
+            ? JSON.parse(content)
+            : (0, yaml_1.parse)(content);
+        if (!validate(raw)) {
+            console.warn(`[AgentDiscovery] Missing required fields in ${filePath} — skipped`);
+            return null;
+        }
+        return { ...raw, source: raw.source ?? source };
+    }
+    catch (err) {
+        console.warn(`[AgentDiscovery] Failed to parse ${filePath}: ${err.message}`);
+        return null;
+    }
+}
+function validate(raw) {
+    if (!raw || typeof raw !== 'object')
+        return false;
+    const r = raw;
+    return REQUIRED_FIELDS.every(f => f in r) && Array.isArray(r.allowedTools);
+}
+function isYamlOrJson(name) {
+    return /\.(yaml|yml|json)$/.test(name);
+}
+//# sourceMappingURL=AgentPackageLoader.js.map

package/dist/agent-discovery/AgentPackageLoader.js.map

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

package/dist/agent-discovery/RemoteAgentRegistry.d.ts

@@ -0,0 +1,31 @@
+import type { AgentProfile } from '../types';
+import type { RemoteRegistryIndex } from './types';
+/**
+ * Fetches and caches agent packages from a remote registry.
+ *
+ * Registry index format (served at registryUrl):
+ * {
+ *   "version": "1",
+ *   "agents": [
+ *     { "name": "@bk/agent-devops-aws", "version": "1.0.0",
+ *       "description": "...", "downloadUrl": "https://..." }
+ *   ]
+ * }
+ *
+ * Each downloadUrl must return a valid agent.yaml body.
+ */
+export declare class RemoteAgentRegistry {
+    private readonly registryUrl;
+    private readonly cacheDir;
+    constructor(registryUrl: string, cacheDir: string);
+    /** Fetch the registry index (cached for 1 hour). */
+    fetchIndex(): Promise<RemoteRegistryIndex>;
+    /**
+     * Download and cache a package by name.
+     * Returns null and logs a warning if the package is not found or invalid.
+     */
+    installPackage(packageName: string): Promise<AgentProfile | null>;
+    private downloadAndCache;
+    private parseYamlAgent;
+}
+//# sourceMappingURL=RemoteAgentRegistry.d.ts.map

package/dist/agent-discovery/RemoteAgentRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RemoteAgentRegistry.d.ts","sourceRoot":"","sources":["../../src/agent-discovery/RemoteAgentRegistry.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,KAAK,EAAE,mBAAmB,EAAwB,MAAM,SAAS,CAAC;AAIzE;;;;;;;;;;;;;GAaG;AACH,qBAAa,mBAAmB;IAExB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBADR,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM;IAKrC,oDAAoD;IAC9C,UAAU,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAsBhD;;;OAGG;IACG,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;YA6BzD,gBAAgB;IAiB9B,OAAO,CAAC,cAAc;CAazB"}

package/dist/agent-discovery/RemoteAgentRegistry.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RemoteAgentRegistry = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const yaml_1 = require("yaml");
+const atomic_write_1 = require("../shared/utils/atomic-write");
+const INDEX_CACHE_TTL_MS = 60 * 60 * 1000; // 1 hour
+/**
+ * Fetches and caches agent packages from a remote registry.
+ *
+ * Registry index format (served at registryUrl):
+ * {
+ *   "version": "1",
+ *   "agents": [
+ *     { "name": "@bk/agent-devops-aws", "version": "1.0.0",
+ *       "description": "...", "downloadUrl": "https://..." }
+ *   ]
+ * }
+ *
+ * Each downloadUrl must return a valid agent.yaml body.
+ */
+class RemoteAgentRegistry {
+    registryUrl;
+    cacheDir;
+    constructor(registryUrl, cacheDir) {
+        this.registryUrl = registryUrl;
+        this.cacheDir = cacheDir;
+        (0, fs_1.mkdirSync)(cacheDir, { recursive: true });
+    }
+    /** Fetch the registry index (cached for 1 hour). */
+    async fetchIndex() {
+        const cachePath = (0, path_1.join)(this.cacheDir, '_index.json');
+        if ((0, fs_1.existsSync)(cachePath)) {
+            const wrapper = JSON.parse((0, fs_1.readFileSync)(cachePath, 'utf-8'));
+            if (Date.now() - wrapper.fetchedAt < INDEX_CACHE_TTL_MS) {
+                return wrapper.data;
+            }
+        }
+        const resp = await fetch(this.registryUrl, { headers: { Accept: 'application/json' } });
+        if (!resp.ok) {
+            throw new Error(`Registry fetch failed ${resp.status}: ${resp.statusText}`);
+        }
+        const data = await resp.json();
+        (0, atomic_write_1.atomicWriteSync)(cachePath, JSON.stringify({ fetchedAt: Date.now(), data }, null, 2));
+        return data;
+    }
+    /**
+     * Download and cache a package by name.
+     * Returns null and logs a warning if the package is not found or invalid.
+     */
+    async installPackage(packageName) {
+        const safeName = packageName.replace(/[@/]/g, '_');
+        const packageDir = (0, path_1.join)(this.cacheDir, safeName);
+        const agentPath = (0, path_1.join)(packageDir, 'agent.yaml');
+        // Use cached version if available
+        if ((0, fs_1.existsSync)(agentPath)) {
+            return this.parseYamlAgent(agentPath, packageName);
+        }
+        let pkg;
+        try {
+            const index = await this.fetchIndex();
+            pkg = index.agents.find(a => a.name === packageName);
+        }
+        catch (err) {
+            console.warn(`[AgentDiscovery] Registry unavailable for "${packageName}": ${err.message}`);
+            return null;
+        }
+        if (!pkg) {
+            console.warn(`[AgentDiscovery] Package "${packageName}" not found in registry`);
+            return null;
+        }
+        return this.downloadAndCache(pkg, packageDir, agentPath);
+    }
+    // ── Private ────────────────────────────────────────────────────────────────
+    async downloadAndCache(pkg, packageDir, agentPath) {
+        const resp = await fetch(pkg.downloadUrl);
+        if (!resp.ok) {
+            throw new Error(`Download failed for "${pkg.name}" (${resp.status}): ${resp.statusText}`);
+        }
+        const content = await resp.text();
+        (0, fs_1.mkdirSync)(packageDir, { recursive: true });
+        (0, atomic_write_1.atomicWriteSync)(agentPath, content);
+        console.log(`[AgentDiscovery] Installed "${pkg.name}@${pkg.version}" → ${agentPath}`);
+        return this.parseYamlAgent(agentPath, pkg.name);
+    }
+    parseYamlAgent(filePath, packageName) {
+        try {
+            const raw = (0, yaml_1.parse)((0, fs_1.readFileSync)(filePath, 'utf-8'));
+            if (!raw?.id || !raw?.systemPrompt || !Array.isArray(raw?.allowedTools)) {
+                console.warn(`[AgentDiscovery] Invalid agent.yaml for package "${packageName}"`);
+                return null;
+            }
+            return { ...raw, source: 'registry' };
+        }
+        catch (err) {
+            console.warn(`[AgentDiscovery] Parse error for "${packageName}": ${err.message}`);
+            return null;
+        }
+    }
+}
+exports.RemoteAgentRegistry = RemoteAgentRegistry;
+//# sourceMappingURL=RemoteAgentRegistry.js.map

package/dist/agent-discovery/RemoteAgentRegistry.js.map

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

package/dist/agent-discovery/discoverAgents.d.ts

@@ -0,0 +1,18 @@
+import type { AgentProfile } from '../types';
+import type { AgentDiscoveryConfig } from './types';
+/**
+ * Discover agents from local directories and/or a remote registry.
+ *
+ * Local layout (appName = 'bk-agent'):
+ *   ~/.bk-agent/agents/                    ← global agents (shared across projects)
+ *   {workingDir}/.bk-agent/agents/         ← project-local agents (git-tracked)
+ *
+ * Remote:
+ *   Fetch the registry index, download requested packages, cache locally.
+ *   Re-running is fast — cached packages are reused until deleted.
+ *
+ * Deduplication: if the same agent id appears in multiple sources,
+ * the first occurrence wins (global → project → registry → static agents).
+ */
+export declare function discoverAgents(config: AgentDiscoveryConfig): Promise<AgentProfile[]>;
+//# sourceMappingURL=discoverAgents.d.ts.map

package/dist/agent-discovery/discoverAgents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discoverAgents.d.ts","sourceRoot":"","sources":["../../src/agent-discovery/discoverAgents.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAMpD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CA4C1F"}

package/dist/agent-discovery/discoverAgents.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.discoverAgents = discoverAgents;
+const path_1 = require("path");
+const os_1 = require("os");
+const AgentPackageLoader_1 = require("./AgentPackageLoader");
+const RemoteAgentRegistry_1 = require("./RemoteAgentRegistry");
+const DEFAULT_APP_NAME = 'bk-agent';
+/**
+ * Discover agents from local directories and/or a remote registry.
+ *
+ * Local layout (appName = 'bk-agent'):
+ *   ~/.bk-agent/agents/                    ← global agents (shared across projects)
+ *   {workingDir}/.bk-agent/agents/         ← project-local agents (git-tracked)
+ *
+ * Remote:
+ *   Fetch the registry index, download requested packages, cache locally.
+ *   Re-running is fast — cached packages are reused until deleted.
+ *
+ * Deduplication: if the same agent id appears in multiple sources,
+ * the first occurrence wins (global → project → registry → static agents).
+ */
+async function discoverAgents(config) {
+    const appName = config.appName ?? DEFAULT_APP_NAME;
+    const cwd = config.workingDir ?? process.cwd();
+    const agents = [];
+    const seen = new Set();
+    const add = (incoming) => {
+        for (const a of incoming) {
+            if (!seen.has(a.id)) {
+                seen.add(a.id);
+                agents.push(a);
+            }
+        }
+    };
+    // 1. Local: global agents
+    if (config.local !== false) {
+        add((0, AgentPackageLoader_1.loadAgentsFromDir)((0, AgentPackageLoader_1.globalAgentsDir)(appName), 'global'));
+        add((0, AgentPackageLoader_1.loadAgentsFromDir)((0, AgentPackageLoader_1.projectAgentsDir)(cwd, appName), 'project'));
+    }
+    // 2. Remote: install packages
+    if (config.install?.length) {
+        const cacheDir = config.cacheDir ?? (0, path_1.join)((0, os_1.homedir)(), `.${appName}`, 'agents', 'registry');
+        const registryUrl = config.remote ?? 'https://registry.backendkit.dev/agents';
+        const registry = new RemoteAgentRegistry_1.RemoteAgentRegistry(registryUrl, cacheDir);
+        const results = await Promise.allSettled(config.install.map(name => registry.installPackage(name)));
+        for (let i = 0; i < results.length; i++) {
+            const result = results[i];
+            if (result.status === 'fulfilled' && result.value) {
+                add([result.value]);
+            }
+            else if (result.status === 'rejected') {
+                console.warn(`[AgentDiscovery] Failed to install "${config.install[i]}": ${result.reason.message}`);
+            }
+        }
+    }
+    return agents;
+}
+//# sourceMappingURL=discoverAgents.js.map

package/dist/agent-discovery/discoverAgents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discoverAgents.js","sourceRoot":"","sources":["../../src/agent-discovery/discoverAgents.ts"],"names":[],"mappings":";;AAuBA,wCA4CC;AAnED,+BAA4B;AAC5B,2BAA6B;AAG7B,6DAA4F;AAC5F,+DAA4D;AAE5D,MAAM,gBAAgB,GAAG,UAAU,CAAC;AAEpC;;;;;;;;;;;;;GAaG;AACI,KAAK,UAAU,cAAc,CAAC,MAA4B;IAC7D,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,gBAAgB,CAAC;IACnD,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAC/C,MAAM,MAAM,GAAmB,EAAE,CAAC;IAClC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,MAAM,GAAG,GAAG,CAAC,QAAwB,EAAE,EAAE;QACrC,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACvB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;gBAClB,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBACf,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACnB,CAAC;QACL,CAAC;IACL,CAAC,CAAC;IAEF,0BAA0B;IAC1B,IAAI,MAAM,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;QACzB,GAAG,CAAC,IAAA,sCAAiB,EAAC,IAAA,oCAAe,EAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC3D,GAAG,CAAC,IAAA,sCAAiB,EAAC,IAAA,qCAAgB,EAAC,GAAG,EAAE,OAAO,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC;IACtE,CAAC;IAED,8BAA8B;IAC9B,IAAI,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,IAAA,WAAI,EAAC,IAAA,YAAO,GAAE,EAAE,IAAI,OAAO,EAAE,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;QACzF,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,IAAI,wCAAwC,CAAC;QAC9E,MAAM,QAAQ,GAAG,IAAI,yCAAmB,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QAEhE,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CACpC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAC5D,CAAC;QAEF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;YAC1B,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;gBAChD,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YACxB,CAAC;iBAAM,IAAI,MAAM,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;gBACtC,OAAO,CAAC,IAAI,CACR,uCAAuC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAO,MAAM,CAAC,MAAgB,CAAC,OAAO,EAAE,CACnG,CAAC;YACN,CAAC;QACL,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC;AAClB,CAAC"}

package/dist/agent-discovery/index.d.ts

@@ -0,0 +1,5 @@
+export { discoverAgents } from './discoverAgents';
+export { RemoteAgentRegistry } from './RemoteAgentRegistry';
+export { loadAgentsFromDir, globalAgentsDir, projectAgentsDir } from './AgentPackageLoader';
+export type { AgentDiscoveryConfig, AgentPackageFile, RemotePackageListing, RemoteRegistryIndex, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/agent-discovery/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent-discovery/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC5F,YAAY,EACR,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,GACtB,MAAM,SAAS,CAAC"}

package/dist/agent-discovery/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.projectAgentsDir = exports.globalAgentsDir = exports.loadAgentsFromDir = exports.RemoteAgentRegistry = exports.discoverAgents = void 0;
+var discoverAgents_1 = require("./discoverAgents");
+Object.defineProperty(exports, "discoverAgents", { enumerable: true, get: function () { return discoverAgents_1.discoverAgents; } });
+var RemoteAgentRegistry_1 = require("./RemoteAgentRegistry");
+Object.defineProperty(exports, "RemoteAgentRegistry", { enumerable: true, get: function () { return RemoteAgentRegistry_1.RemoteAgentRegistry; } });
+var AgentPackageLoader_1 = require("./AgentPackageLoader");
+Object.defineProperty(exports, "loadAgentsFromDir", { enumerable: true, get: function () { return AgentPackageLoader_1.loadAgentsFromDir; } });
+Object.defineProperty(exports, "globalAgentsDir", { enumerable: true, get: function () { return AgentPackageLoader_1.globalAgentsDir; } });
+Object.defineProperty(exports, "projectAgentsDir", { enumerable: true, get: function () { return AgentPackageLoader_1.projectAgentsDir; } });
+//# sourceMappingURL=index.js.map

package/dist/agent-discovery/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agent-discovery/index.ts"],"names":[],"mappings":";;;AAAA,mDAAkD;AAAzC,gHAAA,cAAc,OAAA;AACvB,6DAA4D;AAAnD,0HAAA,mBAAmB,OAAA;AAC5B,2DAA4F;AAAnF,uHAAA,iBAAiB,OAAA;AAAE,qHAAA,eAAe,OAAA;AAAE,sHAAA,gBAAgB,OAAA"}

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

@@ -0,0 +1,42 @@
+import type { AgentProfile } from '../types';
+/** Raw structure of an agent.yaml / agent.json file. */
+export type AgentPackageFile = Omit<AgentProfile, 'source'> & {
+    source?: AgentProfile['source'];
+};
+export interface RemotePackageListing {
+    name: string;
+    version: string;
+    description: string;
+    /** URL to download the agent.yaml for this package. */
+    downloadUrl: string;
+}
+export interface RemoteRegistryIndex {
+    version: string;
+    agents: RemotePackageListing[];
+}
+export interface AgentDiscoveryConfig {
+    /**
+     * Application name used to locate global agent directories.
+     * Agents are looked up in ~/.{appName}/agents/.
+     * Defaults to 'bk-agent'.
+     */
+    appName?: string;
+    /**
+     * Load agents from the global (~/.{appName}/agents/) and
+     * project-local ({workingDir}/.{appName}/agents/) directories.
+     * Default: true.
+     */
+    local?: boolean;
+    /** Working directory for project-local agent loading. Defaults to process.cwd(). */
+    workingDir?: string;
+    /** Remote registry URL (e.g. 'https://registry.backendkit.dev/agents'). */
+    remote?: string;
+    /** Package names to install/cache from the remote registry. */
+    install?: string[];
+    /**
+     * Override the local cache directory for downloaded packages.
+     * Defaults to ~/.{appName}/agents/registry/.
+     */
+    cacheDir?: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/agent-discovery/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAI7C,wDAAwD;AACxD,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,GAAG;IAC1D,MAAM,CAAC,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC;CACnC,CAAC;AAIF,MAAM,WAAW,oBAAoB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,oBAAoB,EAAE,CAAC;CAClC;AAID,MAAM,WAAW,oBAAoB;IACjC;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,oFAAoF;IACpF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/dist/agent-discovery/types.js

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

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

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

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

@@ -0,0 +1,26 @@
+import type { Episode, EpisodicConfig, RetentionConfig } from './types';
+/**
+ * Episodic memory — a time-ordered log of agent experiences.
+ *
+ * Supports keyword-based recall and tag filtering. Retention limits and
+ * optional LLM-based summarization keep the store from growing unbounded.
+ */
+export declare class EpisodicMemory {
+    private readonly backend;
+    private readonly maxEpisodes;
+    private readonly summarizeAfter;
+    private readonly summarizeFn?;
+    private episodesSinceSummary;
+    constructor(episodicCfg?: EpisodicConfig, retentionCfg?: RetentionConfig);
+    /** Store an experience. Returns the new episode ID. */
+    remember(content: string, tags?: string[]): string;
+    /** Retrieve episodes most relevant to a text query (keyword overlap). */
+    recall(query: string, limit?: number): Episode[];
+    /** Retrieve episodes that carry a specific tag, newest first. */
+    recallByTag(tag: string, limit?: number): Episode[];
+    /** Return the N most recently stored episodes. */
+    recallRecent(n?: number): Episode[];
+    count(): number;
+    private runSummarization;
+}
+//# sourceMappingURL=EpisodicMemory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"EpisodicMemory.d.ts","sourceRoot":"","sources":["../../src/agent-memory/EpisodicMemory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAsB,eAAe,EAA6B,MAAM,SAAS,CAAC;AAUvH;;;;;GAKG;AACH,qBAAa,cAAc;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAc;IAC3C,OAAO,CAAC,oBAAoB,CAAK;gBAErB,WAAW,GAAE,cAAmB,EAAE,YAAY,GAAE,eAAoB;IAOhF,uDAAuD;IACvD,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,EAAO,GAAG,MAAM;IAkBtD,yEAAyE;IACzE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,EAAE;IAQ5C,iEAAiE;IACjE,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,EAAE;IAO/C,kDAAkD;IAClD,YAAY,CAAC,CAAC,SAAK,GAAG,OAAO,EAAE;IAM/B,KAAK,IAAI,MAAM;YAID,gBAAgB;CASjC"}

package/dist/agent-memory/EpisodicMemory.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EpisodicMemory = void 0;
+const crypto_1 = require("crypto");
+const InMemoryStore_1 = require("./stores/InMemoryStore");
+const JsonFileStore_1 = require("./stores/JsonFileStore");
+const scoring_1 = require("./scoring");
+/**
+ * Episodic memory — a time-ordered log of agent experiences.
+ *
+ * Supports keyword-based recall and tag filtering. Retention limits and
+ * optional LLM-based summarization keep the store from growing unbounded.
+ */
+class EpisodicMemory {
+    backend;
+    maxEpisodes;
+    summarizeAfter;
+    summarizeFn;
+    episodesSinceSummary = 0;
+    constructor(episodicCfg = {}, retentionCfg = {}) {
+        this.backend = makeBackend(episodicCfg);
+        this.maxEpisodes = retentionCfg.maxEpisodes ?? Infinity;
+        this.summarizeAfter = retentionCfg.summarizeAfter ?? Infinity;
+        this.summarizeFn = retentionCfg.summarizeFn;
+    }
+    /** Store an experience. Returns the new episode ID. */
+    remember(content, tags = []) {
+        const id = (0, crypto_1.randomUUID)();
+        this.backend.insert({ id, content, tags, createdAt: new Date().toISOString() });
+        this.episodesSinceSummary++;
+        if (this.maxEpisodes < Infinity && this.backend.count() > this.maxEpisodes) {
+            this.backend.deleteOldest(this.maxEpisodes);
+        }
+        if (this.summarizeFn && this.episodesSinceSummary >= this.summarizeAfter) {
+            this.episodesSinceSummary = 0;
+            void this.runSummarization();
+        }
+        return id;
+    }
+    /** Retrieve episodes most relevant to a text query (keyword overlap). */
+    recall(query, limit = 10) {
+        return this.backend.getAll()
+            .map(r => ({ ...toEpisode(r), score: (0, scoring_1.keywordScore)(query, `${r.content} ${r.tags.join(' ')}`) }))
+            .filter(e => (e.score ?? 0) > 0)
+            .sort((a, b) => (b.score ?? 0) - (a.score ?? 0))
+            .slice(0, limit);
+    }
+    /** Retrieve episodes that carry a specific tag, newest first. */
+    recallByTag(tag, limit = 10) {
+        return this.backend.getAll()
+            .filter(r => r.tags.includes(tag))
+            .slice(-limit)
+            .map(toEpisode);
+    }
+    /** Return the N most recently stored episodes. */
+    recallRecent(n = 10) {
+        return this.backend.getAll()
+            .slice(-n)
+            .map(toEpisode);
+    }
+    count() { return this.backend.count(); }
+    // ── Private ────────────────────────────────────────────────────────────────
+    async runSummarization() {
+        const oldest = this.backend.getAll()
+            .slice(0, this.summarizeAfter)
+            .map(toEpisode);
+        if (oldest.length === 0 || !this.summarizeFn)
+            return;
+        const summary = await this.summarizeFn(oldest);
+        this.remember(summary, ['summary']);
+    }
+}
+exports.EpisodicMemory = EpisodicMemory;
+// ── Helpers ───────────────────────────────────────────────────────────────────
+function toEpisode(r) {
+    return { id: r.id, content: r.content, tags: r.tags, createdAt: new Date(r.createdAt) };
+}
+function makeBackend(cfg) {
+    return cfg.provider === 'json' && cfg.path
+        ? new JsonFileStore_1.JsonFileStore(cfg.path)
+        : new InMemoryStore_1.InMemoryStore();
+}
+//# sourceMappingURL=EpisodicMemory.js.map

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

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

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

@@ -0,0 +1,40 @@
+import type { ToolDefinition } from '../types';
+import { EpisodicMemory } from './EpisodicMemory';
+import { SemanticMemory } from './SemanticMemory';
+import { ProceduralMemory } from './ProceduralMemory';
+import type { MemorySystemConfig } from './types';
+/**
+ * Unified facade for the three-tier agent memory system.
+ *
+ * - episodic:   time-ordered log of experiences (recall by keyword or tag)
+ * - semantic:   knowledge base (recall by keyword or vector similarity)
+ * - procedural: learned patterns from successes and failures
+ *
+ * Use buildContextBlock() to inject relevant memories into system prompts,
+ * and getTools() to register the memory tools with the agent engine.
+ *
+ * @example
+ * const memory = createMemorySystem({
+ *   episodic:   { provider: 'json', path: '~/.bk/memory/episodes.json' },
+ *   semantic:   { provider: 'json', path: '~/.bk/memory/knowledge.json', embedFn: myEmbedder },
+ *   procedural: { provider: 'json', path: '~/.bk/memory/patterns.json' },
+ *   retention:  { maxEpisodes: 1000, summarizeAfter: 100, summarizeFn: myLLMSummarizer },
+ * });
+ */
+export declare class MemorySystem {
+    private readonly config;
+    readonly episodic: EpisodicMemory;
+    readonly semantic: SemanticMemory;
+    readonly procedural: ProceduralMemory;
+    constructor(config?: MemorySystemConfig);
+    /**
+     * Build a markdown context block combining relevant memories from all three tiers.
+     * Inject the result into agent system prompts for in-context retrieval.
+     */
+    buildContextBlock(query: string): Promise<string>;
+    /** Returns pre-built ToolDefinitions to register with the agent engine. */
+    getTools(): ToolDefinition[];
+}
+/** Factory shorthand for MemorySystem. */
+export declare function createMemorySystem(config?: MemorySystemConfig): MemorySystem;
+//# sourceMappingURL=MemorySystem.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MemorySystem.d.ts","sourceRoot":"","sources":["../../src/agent-memory/MemorySystem.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElD;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,YAAY;IAKT,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJnC,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;gBAET,MAAM,GAAE,kBAAuB;IAM5D;;;OAGG;IACG,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA2BvD,2EAA2E;IAC3E,QAAQ,IAAI,cAAc,EAAE;CAG/B;AAED,0CAA0C;AAC1C,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,YAAY,CAE5E"}