@vinhnt-sdk/core 0.1.0

package/dist/agent/agent-registry.js

@@ -0,0 +1,127 @@
+import { readFile } from "node:fs/promises";
+import { resolve } from "node:path";
+import { AgentConfigSchema } from "@vinhnt-sdk/schema";
+/**
+ * In-memory agent store with optional file loading (load/loadMultiple/reload).
+ */
+export class InMemoryAgentRegistry {
+    agents = new Map();
+    parentMap = new Map();
+    childrenMap = new Map();
+    loadedPaths = new Set();
+    pathToAgentId = new Map();
+    async register(config, parentId) {
+        const parsed = AgentConfigSchema.parse(config);
+        this.agents.set(parsed.id, parsed);
+        if (parentId) {
+            this.parentMap.set(parsed.id, parentId);
+            const existing = this.childrenMap.get(parentId) ?? [];
+            existing.push(parsed.id);
+            this.childrenMap.set(parentId, existing);
+        }
+    }
+    async get(id) {
+        return this.agents.get(id) ?? null;
+    }
+    async list() {
+        return [...this.agents.values()];
+    }
+    async findByCapability(key, value) {
+        return [...this.agents.values()].filter((a) => {
+            const caps = a.capabilities;
+            return caps[key] === value;
+        });
+    }
+    async unregister(id) {
+        this.agents.delete(id);
+        this.parentMap.delete(id);
+        this.childrenMap.delete(id);
+        for (const [parentId, children] of this.childrenMap) {
+            const idx = children.indexOf(id);
+            if (idx >= 0) {
+                children.splice(idx, 1);
+                this.childrenMap.set(parentId, children);
+                break;
+            }
+        }
+        for (const [absPath, agentId] of this.pathToAgentId) {
+            if (agentId === id) {
+                this.loadedPaths.delete(absPath);
+                this.pathToAgentId.delete(absPath);
+            }
+        }
+    }
+    async update(id, patch) {
+        const existing = this.agents.get(id);
+        if (!existing)
+            return null;
+        const updated = { ...existing, ...patch, id };
+        this.agents.set(id, AgentConfigSchema.parse(updated));
+        return updated;
+    }
+    async getChildren(parentId) {
+        const childIds = this.childrenMap.get(parentId) ?? [];
+        return childIds.map((id) => this.agents.get(id)).filter(Boolean);
+    }
+    async getParent(childId) {
+        const parentId = this.parentMap.get(childId);
+        if (!parentId)
+            return null;
+        return this.agents.get(parentId) ?? null;
+    }
+    async getAncestors(childId) {
+        const ancestors = [];
+        let current = childId;
+        for (;;) {
+            const parent = await this.getParent(current);
+            if (!parent)
+                break;
+            ancestors.unshift(parent);
+            current = parent.id;
+        }
+        return ancestors;
+    }
+    // -------------------------------------------------------------------------
+    // File loading
+    // -------------------------------------------------------------------------
+    async load(source) {
+        switch (source.type) {
+            case "inline": {
+                const parsed = AgentConfigSchema.parse(source.config);
+                await this.register(parsed, source.parentId);
+                return parsed;
+            }
+            case "file": {
+                const absPath = resolve(source.path);
+                if (this.loadedPaths.has(absPath)) {
+                    throw new Error(`Agent file already loaded: ${absPath}`);
+                }
+                const content = await readFile(absPath, "utf-8");
+                const raw = JSON.parse(content);
+                const parsed = AgentConfigSchema.parse(raw);
+                await this.register(parsed, source.parentId);
+                this.loadedPaths.add(absPath);
+                this.pathToAgentId.set(absPath, parsed.id);
+                return parsed;
+            }
+        }
+    }
+    async loadMultiple(sources) {
+        const results = [];
+        for (const source of sources) {
+            results.push(await this.load(source));
+        }
+        return results;
+    }
+    async reload(path) {
+        const absPath = resolve(path);
+        const previousId = this.pathToAgentId.get(absPath);
+        this.loadedPaths.delete(absPath);
+        this.pathToAgentId.delete(absPath);
+        if (previousId) {
+            await this.unregister(previousId);
+        }
+        return await this.load({ type: "file", path });
+    }
+}
+//# sourceMappingURL=agent-registry.js.map

package/dist/agent/agent-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-registry.js","sourceRoot":"","sources":["../../src/agent/agent-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AA8BvD;;GAEG;AACH,MAAM,OAAO,qBAAqB;IACb,MAAM,GAAG,IAAI,GAAG,EAAuB,CAAC;IAC1C,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;IACtC,WAAW,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC1C,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,aAAa,GAAG,IAAI,GAAG,EAAmB,CAAC;IAE5D,KAAK,CAAC,QAAQ,CAAC,MAAmB,EAAE,QAAkB;QACpD,MAAM,MAAM,GAAG,iBAAiB,CAAC,KAAK,CAAC,MAAM,CAA2B,CAAC;QACzE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QACnC,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;YACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YACtD,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACzB,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,EAAW;QACnB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,IAAI;QACR,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,GAAW,EAAE,KAAc;QAChD,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;YAC5C,MAAM,IAAI,GAAG,CAAC,CAAC,YAAuC,CAAC;YACvD,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC;QAC7B,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,EAAW;QAC1B,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACvB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC1B,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC5B,KAAK,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACpD,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YACjC,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;gBACb,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;gBACxB,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;gBACzC,MAAM;YACR,CAAC;QACH,CAAC;QACD,KAAK,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACpD,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;gBACnB,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;gBACjC,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACrC,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,EAAW,EAAE,KAA2B;QACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACrC,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC;QAC3B,MAAM,OAAO,GAAG,EAAE,GAAG,QAAQ,EAAE,GAAG,KAAK,EAAE,EAAE,EAAiB,CAAC;QAC7D,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,iBAAiB,CAAC,KAAK,CAAC,OAAO,CAA2B,CAAC,CAAC;QAChF,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,QAAiB;QACjC,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACtD,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAkB,CAAC;IACpF,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,OAAgB;QAC9B,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC7C,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC;QAC3B,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,OAAgB;QACjC,MAAM,SAAS,GAAkB,EAAE,CAAC;QACpC,IAAI,OAAO,GAAG,OAAO,CAAC;QACtB,SAAS,CAAC;YACR,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;YAC7C,IAAI,CAAC,MAAM;gBAAE,MAAM;YACnB,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAC1B,OAAO,GAAG,MAAM,CAAC,EAAE,CAAC;QACtB,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,4EAA4E;IAC5E,eAAe;IACf,4EAA4E;IAE5E,KAAK,CAAC,IAAI,CAAC,MAAmB;QAC5B,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;YACpB,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACd,MAAM,MAAM,GAAG,iBAAiB,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAA2B,CAAC;gBAChF,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;gBAC7C,OAAO,MAAM,CAAC;YAChB,CAAC;YACD,KAAK,MAAM,CAAC,CAAC,CAAC;gBACZ,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;gBACrC,IAAI,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;oBAClC,MAAM,IAAI,KAAK,CAAC,8BAA8B,OAAO,EAAE,CAAC,CAAC;gBAC3D,CAAC;gBACD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBACjD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBAChC,MAAM,MAAM,GAAG,iBAAiB,CAAC,KAAK,CAAC,GAAG,CAA2B,CAAC;gBACtE,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;gBAC7C,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;gBAC9B,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;gBAC3C,OAAO,MAAM,CAAC;YAChB,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,OAAsB;QACvC,MAAM,OAAO,GAAkB,EAAE,CAAC;QAClC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,OAAO,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;QACxC,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAY;QACvB,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC9B,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACnD,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACjC,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACnC,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;QACpC,CAAC;QACD,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IACjD,CAAC;CACF"}

package/dist/agent/behaviour-profiles.d.ts

@@ -0,0 +1,11 @@
+import type { AgentRule, AgentBehaviourMode } from "@vinhnt-sdk/schema";
+export interface BehaviourProfile {
+    readonly label: string;
+    readonly icon: string;
+    readonly description: string;
+    readonly rules: readonly AgentRule[];
+}
+export declare function getBehaviourProfile(mode: AgentBehaviourMode): BehaviourProfile;
+export declare function applyBehaviourProfile(baseRules: readonly AgentRule[] | undefined, profile: BehaviourProfile): AgentRule[];
+export declare function getBuiltinModes(): string[];
+//# sourceMappingURL=behaviour-profiles.d.ts.map

package/dist/agent/behaviour-profiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"behaviour-profiles.d.ts","sourceRoot":"","sources":["../../src/agent/behaviour-profiles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;CACtC;AAyCD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,kBAAkB,GAAG,gBAAgB,CAE9E;AAED,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,SAAS,SAAS,EAAE,GAAG,SAAS,EAC3C,OAAO,EAAE,gBAAgB,GACxB,SAAS,EAAE,CAEb;AAED,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAE1C"}

package/dist/agent/behaviour-profiles.js

@@ -0,0 +1,46 @@
+const BUILD_PROFILE = {
+    label: "Build",
+    icon: "hammer",
+    description: "Full tool access — edit files, run commands, make changes",
+    rules: [
+        { effect: "allow", target: "tool.*", reason: "Build mode: all tools allowed" },
+    ],
+};
+const PLAN_PROFILE = {
+    label: "Plan",
+    icon: "clipboard",
+    description: "Read-only analysis — review code, suggest changes without modifying files",
+    rules: [
+        { effect: "allow", target: "tool.read_file" },
+        { effect: "allow", target: "tool.glob_files" },
+        { effect: "allow", target: "tool.grep_files" },
+        { effect: "allow", target: "tool.list_directory" },
+        { effect: "allow", target: "tool.web_fetch" },
+        { effect: "allow", target: "tool.web_search" },
+        { effect: "allow", target: "tool.question" },
+        { effect: "allow", target: "tool.skill" },
+        { effect: "allow", target: "tool.skill_search" },
+        { effect: "allow", target: "tool.git_status" },
+        { effect: "allow", target: "tool.git_diff" },
+        { effect: "allow", target: "tool.git_log" },
+        { effect: "allow", target: "tool.read_image" },
+        { effect: "allow", target: "tool.lsp_*" },
+        { effect: "allow", target: "tool.list_agents" },
+        { effect: "allow", target: "tool.create_skill" },
+        { effect: "deny", target: "tool.*", reason: "Plan mode: only read-only tools allowed" },
+    ],
+};
+const DEFAULT_PROFILES = {
+    build: BUILD_PROFILE,
+    plan: PLAN_PROFILE,
+};
+export function getBehaviourProfile(mode) {
+    return DEFAULT_PROFILES[mode] ?? BUILD_PROFILE;
+}
+export function applyBehaviourProfile(baseRules, profile) {
+    return [...(baseRules ?? []), ...profile.rules];
+}
+export function getBuiltinModes() {
+    return Object.keys(DEFAULT_PROFILES);
+}
+//# sourceMappingURL=behaviour-profiles.js.map

package/dist/agent/behaviour-profiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"behaviour-profiles.js","sourceRoot":"","sources":["../../src/agent/behaviour-profiles.ts"],"names":[],"mappings":"AASA,MAAM,aAAa,GAAqB;IACtC,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,2DAA2D;IACxE,KAAK,EAAE;QACL,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,+BAA+B,EAAE;KAC/E;CACF,CAAC;AAEF,MAAM,YAAY,GAAqB;IACrC,KAAK,EAAE,MAAM;IACb,IAAI,EAAE,WAAW;IACjB,WAAW,EAAE,2EAA2E;IACxF,KAAK,EAAE;QACL,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE;QAC7C,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE;QAC9C,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE;QAC9C,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,qBAAqB,EAAE;QAClD,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE;QAC7C,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE;QAC9C,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE;QAC5C,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE;QACzC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,mBAAmB,EAAE;QAChD,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE;QAC9C,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE;QAC5C,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE;QAC3C,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE;QAC9C,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE;QACzC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE;QAC/C,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,mBAAmB,EAAE;QAChD,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,yCAAyC,EAAE;KACxF;CACF,CAAC;AAEF,MAAM,gBAAgB,GAAqC;IACzD,KAAK,EAAE,aAAa;IACpB,IAAI,EAAE,YAAY;CACnB,CAAC;AAEF,MAAM,UAAU,mBAAmB,CAAC,IAAwB;IAC1D,OAAO,gBAAgB,CAAC,IAAI,CAAC,IAAI,aAAa,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,SAA2C,EAC3C,OAAyB;IAEzB,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;AACvC,CAAC"}

package/dist/agent/create-agent-tool.d.ts

@@ -0,0 +1,20 @@
+import type { AgentKernel } from "../kernel/kernel.js";
+export interface CreateAgentInput {
+    name: string;
+    description: string;
+    systemPrompt?: string;
+    temperature?: number;
+    model?: string;
+    hidden?: boolean;
+    tools?: string[];
+    allowedTools?: string[];
+    deniedTools?: string[];
+    allowedRisks?: string[];
+    maxSteps?: number;
+    maxTokens?: number;
+    streaming?: boolean;
+    thinking?: boolean;
+    parentAgentId?: string;
+}
+export declare function createCreateAgentTool(kernel: AgentKernel): import("../index.js").ToolDefinition<CreateAgentInput, string>;
+//# sourceMappingURL=create-agent-tool.d.ts.map

package/dist/agent/create-agent-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-agent-tool.d.ts","sourceRoot":"","sources":["../../src/agent/create-agent-tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAOvD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAoBD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,WAAW,kEAuFxD"}

package/dist/agent/create-agent-tool.js

@@ -0,0 +1,108 @@
+import { createAgent, createSubAgent } from "./agent-factory.js";
+import { z } from "zod";
+import { defineTool } from "../tool/define-tool.js";
+const CreateAgentInputSchema = z.object({
+    name: z.string(),
+    description: z.string(),
+    systemPrompt: z.string().optional(),
+    temperature: z.number().optional(),
+    model: z.string().optional(),
+    hidden: z.boolean().optional(),
+    tools: z.array(z.string()).optional(),
+    allowedTools: z.array(z.string()).optional(),
+    deniedTools: z.array(z.string()).optional(),
+    allowedRisks: z.array(z.string()).optional(),
+    maxSteps: z.number().optional(),
+    maxTokens: z.number().optional(),
+    streaming: z.boolean().optional(),
+    thinking: z.boolean().optional(),
+    parentAgentId: z.string().optional(),
+});
+export function createCreateAgentTool(kernel) {
+    return defineTool({
+        name: "create_agent",
+        description: "Create a new agent with specified capabilities and permissions. Use this to create specialized agents that can be delegated tasks.",
+        risk: "write",
+        input: CreateAgentInputSchema,
+        jsonSchema: {
+            type: "object",
+            properties: {
+                name: { type: "string", description: "Name for the new agent" },
+                description: { type: "string", description: "Description of the agent's purpose and capabilities" },
+                systemPrompt: { type: "string", description: "Custom system prompt for the agent" },
+                temperature: { type: "number", description: "Temperature for LLM calls (0-2)" },
+                model: { type: "string", description: "Preferred model identifier (e.g. gpt-4o, claude-3-5-sonnet)" },
+                hidden: { type: "boolean", description: "If true, exclude from public listings" },
+                tools: { type: "array", items: { type: "string" }, description: "Restrict to specific tool IDs (glob patterns supported)" },
+                allowedTools: { type: "array", items: { type: "string" }, description: "Tools the agent is allowed to use" },
+                deniedTools: { type: "array", items: { type: "string" }, description: "Tools the agent is denied from using" },
+                allowedRisks: { type: "array", items: { type: "string" }, description: "Risk levels the agent can operate at" },
+                maxSteps: { type: "number", description: "Maximum execution steps before forced stop" },
+                maxTokens: { type: "number", description: "Maximum tokens per run" },
+                streaming: { type: "boolean", description: "Enable streaming responses" },
+                thinking: { type: "boolean", description: "Enable thinking/reasoning step" },
+                parentAgentId: { type: "string", description: "Parent agent ID for permission inheritance (creates a sub-agent)" },
+            },
+            required: ["name", "description"],
+        },
+        async execute(input) {
+            const registry = kernel.getAgentRegistry();
+            if (!registry)
+                throw new Error("No agent registry available");
+            const hasPerms = input.allowedTools || input.deniedTools || input.maxSteps !== undefined || input.maxTokens !== undefined || input.allowedRisks;
+            const hasCaps = input.tools || input.streaming !== undefined || input.thinking !== undefined;
+            if (input.parentAgentId) {
+                const parent = await registry.get(input.parentAgentId);
+                if (!parent)
+                    throw new Error(`Parent agent not found: ${input.parentAgentId}`);
+                const subParams = {
+                    profile: { name: input.name, description: input.description },
+                    ...(input.systemPrompt !== undefined ? { systemPrompt: input.systemPrompt } : {}),
+                    ...(input.temperature !== undefined ? { temperature: input.temperature } : {}),
+                    ...(hasPerms ? {
+                        permissions: {
+                            ...(input.allowedTools ? { allowedTools: input.allowedTools } : {}),
+                            ...(input.deniedTools ? { deniedTools: input.deniedTools } : {}),
+                            ...(input.allowedRisks ? { allowedRisks: input.allowedRisks } : {}),
+                            ...(input.maxSteps !== undefined ? { maxSteps: input.maxSteps } : {}),
+                            ...(input.maxTokens !== undefined ? { maxTokens: input.maxTokens } : {}),
+                        },
+                    } : {}),
+                };
+                const agent = createSubAgent(subParams, parent);
+                await registry.register(agent, input.parentAgentId);
+                return `Sub-agent "${agent.profile.name}" created with ID: ${agent.id}`;
+            }
+            const params = {
+                profile: {
+                    name: input.name,
+                    description: input.description,
+                    ...(input.model ? { model: input.model } : {}),
+                    ...(input.hidden !== undefined ? { hidden: input.hidden } : {}),
+                },
+                ...(input.systemPrompt !== undefined ? { systemPrompt: input.systemPrompt } : {}),
+                ...(input.temperature !== undefined ? { temperature: input.temperature } : {}),
+                ...(hasCaps ? {
+                    capabilities: {
+                        ...(input.tools ? { tools: input.tools } : {}),
+                        ...(input.streaming !== undefined ? { streaming: input.streaming } : {}),
+                        ...(input.thinking !== undefined ? { thinking: input.thinking } : {}),
+                    },
+                } : {}),
+                ...(hasPerms ? {
+                    permissions: {
+                        ...(input.allowedTools ? { allowedTools: input.allowedTools } : {}),
+                        ...(input.deniedTools ? { deniedTools: input.deniedTools } : {}),
+                        ...(input.allowedRisks ? { allowedRisks: input.allowedRisks } : {}),
+                        ...(input.maxSteps !== undefined ? { maxSteps: input.maxSteps } : {}),
+                        ...(input.maxTokens !== undefined ? { maxTokens: input.maxTokens } : {}),
+                    },
+                } : {}),
+            };
+            const agent = createAgent(params);
+            await registry.register(agent);
+            return `Agent "${agent.profile.name}" created with ID: ${agent.id}`;
+        },
+    }).toDefinition();
+}
+//# sourceMappingURL=create-agent-tool.js.map

package/dist/agent/create-agent-tool.js.map

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

package/dist/agent/default-agents.d.ts

@@ -0,0 +1,5 @@
+import type { AgentConfig } from "@vinhnt-sdk/schema";
+export declare const DEFAULT_BUILD_AGENT: AgentConfig;
+export declare const DEFAULT_PLAN_AGENT: AgentConfig;
+export declare const DEFAULT_AGENTS: AgentConfig[];
+//# sourceMappingURL=default-agents.d.ts.map

package/dist/agent/default-agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-agents.d.ts","sourceRoot":"","sources":["../../src/agent/default-agents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAW,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAE/D,eAAO,MAAM,mBAAmB,EAAE,WAcjC,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,WAkBhC,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,WAAW,EAGvC,CAAC"}

package/dist/agent/default-agents.js

@@ -0,0 +1,38 @@
+export const DEFAULT_BUILD_AGENT = {
+    id: "build",
+    profile: {
+        name: "build",
+        description: "Full tool access — edit files, run commands, make changes",
+        hidden: false,
+    },
+    capabilities: {
+        streaming: true,
+        thinking: true,
+    },
+    permissions: { mode: "primary" },
+    behaviourMode: "build",
+    systemPrompt: "You have full access to all tools. Make changes to the codebase as needed.",
+};
+export const DEFAULT_PLAN_AGENT = {
+    id: "plan",
+    profile: {
+        name: "plan",
+        description: "Read-only analysis — review code, suggest changes without modifying files",
+        hidden: false,
+    },
+    capabilities: {
+        streaming: true,
+        thinking: true,
+    },
+    permissions: { mode: "primary" },
+    behaviourMode: "plan",
+    systemPrompt: "You are in PLAN mode.\n" +
+        "You CANNOT modify files or execute shell commands.\n" +
+        "Analyze the codebase, suggest improvements, and create detailed plans.\n" +
+        "When the user is satisfied, they will switch to BUILD mode to implement the changes.",
+};
+export const DEFAULT_AGENTS = [
+    DEFAULT_BUILD_AGENT,
+    DEFAULT_PLAN_AGENT,
+];
+//# sourceMappingURL=default-agents.js.map

package/dist/agent/default-agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-agents.js","sourceRoot":"","sources":["../../src/agent/default-agents.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,mBAAmB,GAAgB;IAC9C,EAAE,EAAE,OAAkB;IACtB,OAAO,EAAE;QACP,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,2DAA2D;QACxE,MAAM,EAAE,KAAK;KACd;IACD,YAAY,EAAE;QACZ,SAAS,EAAE,IAAI;QACf,QAAQ,EAAE,IAAI;KACf;IACD,WAAW,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;IAChC,aAAa,EAAE,OAAO;IACtB,YAAY,EAAE,4EAA4E;CAC3F,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAgB;IAC7C,EAAE,EAAE,MAAiB;IACrB,OAAO,EAAE;QACP,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,2EAA2E;QACxF,MAAM,EAAE,KAAK;KACd;IACD,YAAY,EAAE;QACZ,SAAS,EAAE,IAAI;QACf,QAAQ,EAAE,IAAI;KACf;IACD,WAAW,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;IAChC,aAAa,EAAE,MAAM;IACrB,YAAY,EACV,yBAAyB;QACzB,sDAAsD;QACtD,0EAA0E;QAC1E,sFAAsF;CACzF,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAkB;IAC3C,mBAAmB;IACnB,kBAAkB;CACnB,CAAC"}

package/dist/agent/delegate-batch-tool.d.ts

@@ -0,0 +1,10 @@
+import type { AgentKernel } from "../kernel/kernel.js";
+export interface DelegateBatchInput {
+    tasks: Array<{
+        agentId: string;
+        prompt: string;
+    }>;
+}
+/** Tool for delegating tasks to multiple sub-agents in parallel */
+export declare function createDelegateBatchTool(kernel: AgentKernel): import("../index.js").ToolDefinition<DelegateBatchInput, string>;
+//# sourceMappingURL=delegate-batch-tool.d.ts.map

package/dist/agent/delegate-batch-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegate-batch-tool.d.ts","sourceRoot":"","sources":["../../src/agent/delegate-batch-tool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAIvD,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACnD;AASD,mEAAmE;AACnE,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,WAAW,oEAyC1D"}

package/dist/agent/delegate-batch-tool.js

@@ -0,0 +1,48 @@
+import { z } from "zod";
+import { defineTool } from "../tool/define-tool.js";
+const DelegateBatchSchema = z.object({
+    tasks: z.array(z.object({
+        agentId: z.string(),
+        prompt: z.string(),
+    })),
+});
+/** Tool for delegating tasks to multiple sub-agents in parallel */
+export function createDelegateBatchTool(kernel) {
+    return defineTool({
+        name: "delegate_batch",
+        description: "Delegate multiple tasks to sub-agents in parallel. Each task runs concurrently with its own isolated state. Use this when tasks are independent and can be resolved simultaneously.",
+        risk: "write",
+        input: DelegateBatchSchema,
+        jsonSchema: {
+            type: "object",
+            properties: {
+                tasks: {
+                    type: "array",
+                    description: "Array of tasks to delegate",
+                    items: {
+                        type: "object",
+                        properties: {
+                            agentId: { type: "string", description: "The ID of the sub-agent" },
+                            prompt: { type: "string", description: "The task description for the sub-agent" },
+                        },
+                        required: ["agentId", "prompt"],
+                    },
+                },
+            },
+            required: ["tasks"],
+        },
+        async execute(input, ctx) {
+            const parent = ctx?.parentContext;
+            const childCtx = parent
+                ? { ...parent }
+                : {
+                    requestId: crypto.randomUUID(),
+                    traceId: crypto.randomUUID(),
+                    actorId: "sub-agent",
+                    tenantId: "default",
+                };
+            return kernel.runAgentsParallel(input.tasks.map((t) => ({ agentId: t.agentId, prompt: t.prompt })), childCtx, ctx?.sessionId || undefined);
+        },
+    }).toDefinition();
+}
+//# sourceMappingURL=delegate-batch-tool.js.map

package/dist/agent/delegate-batch-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegate-batch-tool.js","sourceRoot":"","sources":["../../src/agent/delegate-batch-tool.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAMpD,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;QACtB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;QACnB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;KACnB,CAAC,CAAC;CACJ,CAAC,CAAC;AAEH,mEAAmE;AACnE,MAAM,UAAU,uBAAuB,CAAC,MAAmB;IACzD,OAAO,UAAU,CAA6B;QAC5C,IAAI,EAAE,gBAAgB;QACtB,WAAW,EAAE,qLAAqL;QAClM,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,mBAAmB;QAC1B,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,KAAK,EAAE;oBACL,IAAI,EAAE,OAAO;oBACb,WAAW,EAAE,4BAA4B;oBACzC,KAAK,EAAE;wBACL,IAAI,EAAE,QAAQ;wBACd,UAAU,EAAE;4BACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yBAAyB,EAAE;4BACnE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wCAAwC,EAAE;yBAClF;wBACD,QAAQ,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC;qBAChC;iBACF;aACF;YACD,QAAQ,EAAE,CAAC,OAAO,CAAC;SACpB;QACD,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG;YACtB,MAAM,MAAM,GAAG,GAAG,EAAE,aAAa,CAAC;YAClC,MAAM,QAAQ,GAAmB,MAAM;gBACrC,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE;gBACf,CAAC,CAAC;oBACE,SAAS,EAAE,MAAM,CAAC,UAAU,EAAe;oBAC3C,OAAO,EAAE,MAAM,CAAC,UAAU,EAAa;oBACvC,OAAO,EAAE,WAAW;oBACpB,QAAQ,EAAE,SAAS;iBACpB,CAAC;YACN,OAAO,MAAM,CAAC,iBAAiB,CAC7B,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAkB,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,EAC7E,QAAQ,EACR,GAAG,EAAE,SAAS,IAAI,SAAS,CAC5B,CAAC;QACJ,CAAC;KACF,CAAC,CAAC,YAAY,EAAE,CAAC;AACpB,CAAC"}

package/dist/agent/delegate-tool.d.ts

@@ -0,0 +1,13 @@
+import type { AgentKernel } from "../kernel/kernel.js";
+export interface DelegateInput {
+    agentId: string;
+    prompt: string;
+    agent_id?: string;
+    task?: string;
+}
+/** Tool for delegating a task to a sub-agent */
+export declare function createDelegateTool(kernel: AgentKernel): import("../index.js").ToolDefinition<{
+    agentId: string;
+    prompt: string;
+}, string>;
+//# sourceMappingURL=delegate-tool.d.ts.map

package/dist/agent/delegate-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegate-tool.d.ts","sourceRoot":"","sources":["../../src/agent/delegate-tool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAIvD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAOD,gDAAgD;AAChD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW;aACvB,MAAM;YAAU,MAAM;WAuCpD"}

package/dist/agent/delegate-tool.js

@@ -0,0 +1,49 @@
+import { z } from "zod";
+import { defineTool } from "../tool/define-tool.js";
+const DelegateInputSchema = z.object({
+    agentId: z.string(),
+    prompt: z.string(),
+});
+/** Tool for delegating a task to a sub-agent */
+export function createDelegateTool(kernel) {
+    return defineTool({
+        name: "delegate",
+        description: "Delegate a task to a sub-agent by ID. The sub-agent will run with its own permissions and return a result. Use this for specialized subtasks.",
+        risk: "write",
+        input: DelegateInputSchema,
+        normalize(raw) {
+            const input = raw;
+            const agentId = String(input.agentId ?? input.agent_id ?? "").trim();
+            const prompt = String(input.prompt ?? input.task ?? "").trim();
+            if (!agentId)
+                throw new Error("Agent ID is required — provide 'agentId' or 'agent_id'");
+            if (!prompt)
+                throw new Error("Prompt is required — provide 'prompt' or 'task'");
+            return { agentId, prompt };
+        },
+        jsonSchema: {
+            type: "object",
+            properties: {
+                agentId: { type: "string", description: "The ID of the sub-agent to delegate to" },
+                agent_id: { type: "string", description: "Alias for 'agentId' (snake_case)" },
+                prompt: { type: "string", description: "The task description for the sub-agent" },
+                task: { type: "string", description: "Alias for 'prompt'" },
+            },
+            required: [],
+        },
+        async execute(input, ctx) {
+            const parent = ctx.parentContext;
+            const childCtx = parent
+                ? { ...parent }
+                : {
+                    requestId: crypto.randomUUID(),
+                    traceId: crypto.randomUUID(),
+                    actorId: "sub-agent",
+                    tenantId: "default",
+                };
+            const output = await kernel.runAgent(input.agentId, input.prompt, childCtx, ctx.sessionId || undefined);
+            return output || "(no output)";
+        },
+    }).toDefinition();
+}
+//# sourceMappingURL=delegate-tool.js.map

package/dist/agent/delegate-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegate-tool.js","sourceRoot":"","sources":["../../src/agent/delegate-tool.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AASpD,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;CACnB,CAAC,CAAC;AAEH,gDAAgD;AAChD,MAAM,UAAU,kBAAkB,CAAC,MAAmB;IACpD,OAAO,UAAU,CAA8C;QAC7D,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,+IAA+I;QAC5J,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,mBAAmB;QAC1B,SAAS,CAAC,GAAG;YACX,MAAM,KAAK,GAAG,GAA8B,CAAC;YAC7C,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YACrE,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YAC/D,IAAI,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;YACxF,IAAI,CAAC,MAAM;gBAAE,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;YAChF,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAC7B,CAAC;QACD,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wCAAwC,EAAE;gBAClF,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kCAAkC,EAAE;gBAC7E,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wCAAwC,EAAE;gBACjF,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;aAC5D;YACD,QAAQ,EAAE,EAAE;SACb;QACD,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG;YACtB,MAAM,MAAM,GAAG,GAAG,CAAC,aAAa,CAAC;YACjC,MAAM,QAAQ,GAAmB,MAAM;gBACrC,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE;gBACf,CAAC,CAAC;oBACE,SAAS,EAAE,MAAM,CAAC,UAAU,EAAe;oBAC3C,OAAO,EAAE,MAAM,CAAC,UAAU,EAAa;oBACvC,OAAO,EAAE,WAAW;oBACpB,QAAQ,EAAE,SAAS;iBACpB,CAAC;YACN,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAClC,KAAK,CAAC,OAAkB,EAAE,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,SAAS,IAAI,SAAS,CAC7E,CAAC;YACF,OAAO,MAAM,IAAI,aAAa,CAAC;QACjC,CAAC;KACF,CAAC,CAAC,YAAY,EAAE,CAAC;AACpB,CAAC"}

package/dist/agent/dynamic-registry.d.ts

@@ -0,0 +1,30 @@
+import type { AgentId, AgentConfig } from "@vnt/schema";
+import type { AgentRegistry } from "./agent-registry.js";
+export type AgentSource = {
+    type: "inline";
+    config: AgentConfig;
+    parentId?: AgentId;
+} | {
+    type: "file";
+    path: string;
+    parentId?: AgentId;
+};
+export declare class DynamicAgentRegistry implements AgentRegistry {
+    private inner;
+    private loadedPaths;
+    private pathToAgentId;
+    constructor();
+    register(config: AgentConfig, parentId?: AgentId): Promise<void>;
+    load(source: AgentSource): Promise<AgentConfig>;
+    loadMultiple(sources: AgentSource[]): Promise<AgentConfig[]>;
+    reload(path: string): Promise<AgentConfig>;
+    get(id: AgentId): Promise<AgentConfig | null>;
+    list(): Promise<readonly AgentConfig[]>;
+    findByCapability(key: string, value: unknown): Promise<readonly AgentConfig[]>;
+    unregister(id: AgentId): Promise<void>;
+    update(id: AgentId, patch: Partial<AgentConfig>): Promise<AgentConfig | null>;
+    getChildren(parentId: AgentId): Promise<readonly AgentConfig[]>;
+    getParent(childId: AgentId): Promise<AgentConfig | null>;
+    getAncestors(childId: AgentId): Promise<readonly AgentConfig[]>;
+}
+//# sourceMappingURL=dynamic-registry.d.ts.map

package/dist/agent/dynamic-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-registry.d.ts","sourceRoot":"","sources":["../../src/agent/dynamic-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAMzD,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,GAAG;IACF,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,qBAAa,oBAAqB,YAAW,aAAa;IACxD,OAAO,CAAC,KAAK,CAAwB;IACrC,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,aAAa,CAA8B;IAEnD,cAEC;IAEK,QAAQ,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAGrE;IAEK,IAAI,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAqBpD;IAEK,YAAY,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAMjE;IAEK,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAS/C;IAEK,GAAG,CAAC,EAAE,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAElD;IAEK,IAAI,IAAI,OAAO,CAAC,SAAS,WAAW,EAAE,CAAC,CAE5C;IAEK,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,SAAS,WAAW,EAAE,CAAC,CAEnF;IAEK,UAAU,CAAC,EAAE,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ3C;IAEK,MAAM,CAAC,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAGlF;IAEK,WAAW,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,SAAS,WAAW,EAAE,CAAC,CAEpE;IAEK,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAE7D;IAEK,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,SAAS,WAAW,EAAE,CAAC,CAEpE;CACF"}