@vinhnt-sdk/core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nguyen Thanh Vinh
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,57 @@
+# @vnt/agent-core
+
+Core agent engine for VNT Agent — kernel, tools, sessions, plugins, permissions, and knowledge.
+
+## Install
+
+```bash
+# npm
+npm install @vnt/agent-core
+
+# pnpm (monorepo)
+pnpm add @vnt/agent-core
+```
+
+## Quick Start
+
+```typescript
+import { AgentKernel, InMemoryToolRegistry, InMemorySessionState } from '@vnt/agent-core';
+
+const kernel = new AgentKernel({
+  modelProvider: myProvider,
+  toolRegistry: new InMemoryToolRegistry(),
+  sessionState: new InMemorySessionState(),
+});
+
+const handle = await kernel.startRun({ prompt: 'Refactor this function' });
+```
+
+## API Reference
+
+| Export | Type | Description |
+|--------|------|-------------|
+| `AgentKernel` | Class | Run loop orchestrator with circuit breaker |
+| `ModelCaller` | Class | Model invocation with streaming |
+| `PermissionGate` | Class | 4-phase permission evaluation |
+| `ToolRegistry`, `InMemoryToolRegistry` | Class | Tool registration and lookup |
+| `ToolRuntime` | Class | Tool execution with sandbox and hooks |
+| `ToolSaga` | Class | Transactional tool rollback support |
+| `SessionRunCoordinator` | Class | Session-aware run lifecycle management |
+| `DefaultPluginManager` | Class | Plugin activation and lifecycle |
+| `InMemoryEventBus` | Class | Typed pub/sub event bus |
+| `createReadFileTool`, `createShellTool`, ... | Function | 36 built-in tool factories |
+| `defineTool` | Function | Define custom tools with Zod schemas |
+| `LearningEngine`, `ContextCompressor` | Class | Knowledge and memory management |
+| `WorkspaceManager` | Class | Multi-workspace support |
+
+## Subpath Imports
+
+```typescript
+import { AgentKernel } from '@vnt/agent-core';              // main
+import { defineTool } from '@vnt/agent-core/tool/define';   // deep import
+import { EventBus } from '@vnt/agent-core/event-bus';      // deep import
+```
+
+## License
+
+MIT

package/dist/agent/agent-def.d.ts

@@ -0,0 +1,11 @@
+import type { AgentConfig, SkillSource } from "@vinhnt-sdk/schema";
+export interface AgentDefinition {
+    readonly config: AgentConfig;
+    readonly source: SkillSource;
+    readonly raw: string;
+}
+export interface AgentDefParser {
+    parse(raw: string, source: SkillSource): AgentDefinition;
+    parseFile(filePath: string, source: SkillSource): Promise<AgentDefinition>;
+}
+//# sourceMappingURL=agent-def.d.ts.map

package/dist/agent/agent-def.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-def.d.ts","sourceRoot":"","sources":["../../src/agent/agent-def.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEnE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,eAAe,CAAC;IACzD,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CAC5E"}

package/dist/agent/agent-def.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=agent-def.js.map

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

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

package/dist/agent/agent-factory.d.ts

@@ -0,0 +1,21 @@
+import type { AgentId, AgentConfig, AgentProfile, AgentCapabilities, AgentPermissions } from "@vinhnt-sdk/schema";
+export interface CreateAgentParams {
+    id?: AgentId;
+    profile: AgentProfile;
+    capabilities?: AgentCapabilities;
+    permissions?: AgentPermissions;
+    systemPrompt?: string;
+    temperature?: number;
+}
+export interface SubAgentParams {
+    id?: AgentId;
+    profile: Pick<AgentProfile, "name" | "description">;
+    capabilities?: AgentCapabilities;
+    permissions?: AgentPermissions;
+    systemPrompt?: string;
+    temperature?: number;
+}
+export declare function createAgent(params: CreateAgentParams): AgentConfig;
+export declare function validateAgentConfig(config: AgentConfig): string[];
+export declare function createSubAgent(params: SubAgentParams, parent: AgentConfig): AgentConfig;
+//# sourceMappingURL=agent-factory.d.ts.map

package/dist/agent/agent-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-factory.d.ts","sourceRoot":"","sources":["../../src/agent/agent-factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAgB,MAAM,oBAAoB,CAAC;AAIhI,MAAM,WAAW,iBAAiB;IAChC,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,OAAO,EAAE,YAAY,CAAC;IACtB,YAAY,CAAC,EAAE,iBAAiB,CAAC;IACjC,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,aAAa,CAAC,CAAC;IACpD,YAAY,CAAC,EAAE,iBAAiB,CAAC;IACjC,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAMD,wBAAgB,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,WAAW,CAgBlE;AAkDD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,EAAE,CAuBjE;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,WAAW,GAAG,WAAW,CAsBvF"}

package/dist/agent/agent-factory.js

@@ -0,0 +1,119 @@
+import { mergeRulesets, normalizePermissions } from "../permission/checker.js";
+import { DEFAULT_MAX_STEPS } from "../kernel/kernel-utils.js";
+function generateId() {
+    return `agent_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
+}
+export function createAgent(params) {
+    const { id, profile, capabilities, permissions, systemPrompt, temperature } = params;
+    if (!profile.name)
+        throw new Error("Agent name is required");
+    if (!profile.description)
+        throw new Error("Agent description is required");
+    return {
+        id: id ?? generateId(),
+        profile,
+        capabilities: {
+            streaming: true,
+            thinking: false,
+            ...capabilities,
+        },
+        permissions: { mode: "primary", ...permissions },
+        ...(systemPrompt !== undefined ? { systemPrompt } : {}),
+        ...(temperature !== undefined ? { temperature } : {}),
+    };
+}
+function buildRuleset(parent, child) {
+    return { ...mergeRulesets(normalizePermissions(child), normalizePermissions(parent.permissions)) };
+}
+function buildPermissions(parent, child) {
+    if (!parent.permissions && !child)
+        return undefined;
+    // Use ruleset-based inheritance when available
+    if (parent.permissions?.ruleset || child?.ruleset) {
+        const merged = buildRuleset(parent, child);
+        const perms = {
+            mode: child?.mode ?? "subagent",
+        };
+        if (merged)
+            perms.ruleset = merged;
+        return perms;
+    }
+    // Legacy field-based inheritance (backwards compat)
+    const allowedTools = child?.allowedTools ?? parent.permissions?.allowedTools;
+    const deniedTools = [
+        ...(parent.permissions?.deniedTools ?? []),
+        ...(child?.deniedTools ?? []),
+    ];
+    const allowedRisks = child?.allowedRisks ?? parent.permissions?.allowedRisks;
+    const perms = {
+        mode: child?.mode ?? "subagent",
+    };
+    if (allowedTools)
+        perms.allowedTools = allowedTools;
+    if (deniedTools.length > 0)
+        perms.deniedTools = deniedTools;
+    if (allowedRisks)
+        perms.allowedRisks = allowedRisks;
+    const parentMaxSteps = parent.permissions?.maxSteps ?? DEFAULT_MAX_STEPS;
+    const childMaxSteps = child?.maxSteps;
+    if (childMaxSteps !== undefined || parent.permissions?.maxSteps !== undefined) {
+        perms.maxSteps = Math.min(childMaxSteps ?? parentMaxSteps, parentMaxSteps);
+    }
+    const DEFAULT_MAX_TOKENS = 100000;
+    const parentMaxTokens = parent.permissions?.maxTokens ?? DEFAULT_MAX_TOKENS;
+    const childMaxTokens = child?.maxTokens;
+    if (childMaxTokens !== undefined || parent.permissions?.maxTokens !== undefined) {
+        perms.maxTokens = Math.min(childMaxTokens ?? parentMaxTokens, parentMaxTokens);
+    }
+    return Object.keys(perms).length > 0 ? perms : undefined;
+}
+export function validateAgentConfig(config) {
+    const errors = [];
+    if (!config.id)
+        errors.push("Agent id is required");
+    if (!config.profile?.name)
+        errors.push("Agent profile.name is required");
+    if (!config.profile?.description)
+        errors.push("Agent profile.description is required");
+    const mode = config.permissions?.mode;
+    if (mode && !["primary", "subagent", "all"].includes(mode)) {
+        errors.push(`Invalid mode: ${mode}. Expected primary, subagent, or all`);
+    }
+    const rules = config.permissions?.ruleset?.rules;
+    if (rules) {
+        for (let i = 0; i < rules.length; i++) {
+            const r = rules[i];
+            if (!r.effect || !["allow", "deny"].includes(r.effect)) {
+                errors.push(`Rule[${i}]: effect must be 'allow' or 'deny'`);
+            }
+            if (!r.target)
+                errors.push(`Rule[${i}]: target is required`);
+        }
+    }
+    return errors;
+}
+export function createSubAgent(params, parent) {
+    const { id, profile, capabilities, permissions, systemPrompt, temperature } = params;
+    if (!profile.name)
+        throw new Error("Sub-agent name is required");
+    if (!profile.description)
+        throw new Error("Sub-agent description is required");
+    return {
+        id: id ?? generateId(),
+        profile: {
+            name: profile.name,
+            description: profile.description,
+            ...(parent.profile.version ? { version: parent.profile.version } : {}),
+            ...(parent.profile.author ? { author: parent.profile.author } : {}),
+        },
+        capabilities: {
+            streaming: parent.capabilities.streaming ?? true,
+            thinking: parent.capabilities.thinking ?? false,
+            ...capabilities,
+        },
+        ...(buildPermissions(parent, permissions) ? { permissions: buildPermissions(parent, permissions) } : {}),
+        ...(systemPrompt !== undefined ? { systemPrompt } : {}),
+        ...(temperature !== undefined ? { temperature } : {}),
+    };
+}
+//# sourceMappingURL=agent-factory.js.map

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

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

package/dist/agent/agent-file-loader.d.ts

@@ -0,0 +1,46 @@
+import type { AgentDefinition, AgentDefParser } from "../agent/agent-def.js";
+import type { SkillSource } from "@vinhnt-sdk/schema";
+/**
+ * AgentFileLoader — Discovers and loads agents from .vnt/agents/ directories.
+ *
+ * Supports multiple discovery locations:
+ * 1. Workspace-local: .vnt/agents/<name>.md
+ * 2. Global: ~/.vnt/agents/<name>.md
+ * 3. Claude-compatible: .claude/agents/<name>.md
+ * 4. Agents-compatible: .agents/agents/<name>.md
+ */
+export declare class AgentFileLoader {
+    private readonly parser;
+    constructor(parser?: AgentDefParser);
+    /**
+     * Load agents from a single directory.
+     */
+    loadFromDirectory(dir: string, source: SkillSource): Promise<AgentDefinition[]>;
+    /**
+     * Discover agents from all conventional locations.
+     *
+     * Discovery order (workspace overrides global):
+     * 1. Global: ~/.vnt/agents/
+     * 2. Global Claude: ~/.claude/agents/
+     * 3. Global Agents: ~/.agents/agents/
+     * 4. Workspace: .vnt/agents/
+     * 5. Workspace Claude: .claude/agents/
+     * 6. Workspace Agents: .agents/agents/
+     */
+    discover(workspaceRoot: string): Promise<AgentDefinition[]>;
+}
+/**
+ * AgentFileProvider — Integrates discovered agents into the kernel.
+ */
+export declare class AgentFileProvider {
+    private agents;
+    /**
+     * Load agents from all conventional locations.
+     */
+    load(workspaceRoot: string): Promise<void>;
+    /**
+     * Get all discovered agents.
+     */
+    getAgents(): readonly AgentDefinition[];
+}
+//# sourceMappingURL=agent-file-loader.d.ts.map

package/dist/agent/agent-file-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-file-loader.d.ts","sourceRoot":"","sources":["../../src/agent/agent-file-loader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtD;;;;;;;;GAQG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;gBAE5B,MAAM,CAAC,EAAE,cAAc;IAInC;;OAEG;IACG,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IA0BrF;;;;;;;;;;OAUG;IACG,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;CAuClE;AAED;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAyB;IAEvC;;OAEG;IACG,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKhD;;OAEG;IACH,SAAS,IAAI,SAAS,eAAe,EAAE;CAGxC"}

package/dist/agent/agent-file-loader.js

@@ -0,0 +1,111 @@
+import { readdir, readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { AgentParser } from "../agent/agent-parser.js";
+/**
+ * AgentFileLoader — Discovers and loads agents from .vnt/agents/ directories.
+ *
+ * Supports multiple discovery locations:
+ * 1. Workspace-local: .vnt/agents/<name>.md
+ * 2. Global: ~/.vnt/agents/<name>.md
+ * 3. Claude-compatible: .claude/agents/<name>.md
+ * 4. Agents-compatible: .agents/agents/<name>.md
+ */
+export class AgentFileLoader {
+    parser;
+    constructor(parser) {
+        this.parser = parser ?? new AgentParser();
+    }
+    /**
+     * Load agents from a single directory.
+     */
+    async loadFromDirectory(dir, source) {
+        const agents = [];
+        try {
+            const entries = await readdir(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                if (!entry.isFile())
+                    continue;
+                if (!entry.name.endsWith(".md"))
+                    continue;
+                const filePath = join(dir, entry.name);
+                try {
+                    const raw = await readFile(filePath, "utf-8");
+                    const agent = this.parser.parse(raw, source);
+                    agents.push(agent);
+                }
+                catch (error) {
+                    console.error(`[AgentFileLoader] Failed to load agent from ${filePath}:`, error);
+                }
+            }
+        }
+        catch {
+            // Directory doesn't exist, ignore
+        }
+        return agents;
+    }
+    /**
+     * Discover agents from all conventional locations.
+     *
+     * Discovery order (workspace overrides global):
+     * 1. Global: ~/.vnt/agents/
+     * 2. Global Claude: ~/.claude/agents/
+     * 3. Global Agents: ~/.agents/agents/
+     * 4. Workspace: .vnt/agents/
+     * 5. Workspace Claude: .claude/agents/
+     * 6. Workspace Agents: .agents/agents/
+     */
+    async discover(workspaceRoot) {
+        const home = process.env.HOME || process.env.USERPROFILE || "";
+        const allAgents = [];
+        // Global locations
+        const globalLocations = [
+            { dir: join(home, ".vnt", "agents"), type: "global", priority: 0 },
+            { dir: join(home, ".claude", "agents"), type: "global", priority: 0 },
+            { dir: join(home, ".agents", "agents"), type: "global", priority: 0 },
+        ];
+        // Workspace locations
+        const workspaceLocations = [
+            { dir: join(workspaceRoot, ".vnt", "agents"), type: "project", priority: 10 },
+            { dir: join(workspaceRoot, ".claude", "agents"), type: "project", priority: 10 },
+            { dir: join(workspaceRoot, ".agents", "agents"), type: "project", priority: 10 },
+        ];
+        // Load from all locations
+        for (const loc of [...globalLocations, ...workspaceLocations]) {
+            const agents = await this.loadFromDirectory(loc.dir, {
+                type: loc.type,
+                dir: loc.dir,
+                priority: loc.priority,
+            });
+            allAgents.push(...agents);
+        }
+        // Deduplicate by ID (workspace > global)
+        const agentMap = new Map();
+        for (const agent of allAgents) {
+            const existing = agentMap.get(agent.config.id);
+            if (!existing || (agent.source?.priority ?? 0) > (existing.source?.priority ?? 0)) {
+                agentMap.set(agent.config.id, agent);
+            }
+        }
+        return [...agentMap.values()];
+    }
+}
+/**
+ * AgentFileProvider — Integrates discovered agents into the kernel.
+ */
+export class AgentFileProvider {
+    agents = [];
+    /**
+     * Load agents from all conventional locations.
+     */
+    async load(workspaceRoot) {
+        const loader = new AgentFileLoader();
+        this.agents = await loader.discover(workspaceRoot);
+    }
+    /**
+     * Get all discovered agents.
+     */
+    getAgents() {
+        return this.agents;
+    }
+}
+//# sourceMappingURL=agent-file-loader.js.map

package/dist/agent/agent-file-loader.js.map

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

package/dist/agent/agent-parser.d.ts

@@ -0,0 +1,9 @@
+import type { AgentConfig, SkillSource } from "@vinhnt-sdk/schema";
+import type { AgentDefinition, AgentDefParser } from "./agent-def.js";
+export declare class AgentParser implements AgentDefParser {
+    parse(raw: string, source: SkillSource): AgentDefinition;
+    parseFile(filePath: string, source: SkillSource): Promise<AgentDefinition>;
+    private mapPermissions;
+    toAgentConfig(def: AgentDefinition): AgentConfig;
+}
+//# sourceMappingURL=agent-parser.d.ts.map

package/dist/agent/agent-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-parser.d.ts","sourceRoot":"","sources":["../../src/agent/agent-parser.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAW,WAAW,EAAa,WAAW,EAAa,MAAM,oBAAoB,CAAC;AAClG,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAItE,qBAAa,WAAY,YAAW,cAAc;IAChD,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,eAAe;IAgDlD,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC;IAKhF,OAAO,CAAC,cAAc;IAetB,aAAa,CAAC,GAAG,EAAE,eAAe,GAAG,WAAW;CAGjD"}

package/dist/agent/agent-parser.js

@@ -0,0 +1,70 @@
+import { readFile } from "node:fs/promises";
+import { validateAgentConfig } from "./agent-factory.js";
+import { parseFrontmatter } from "../yaml-frontmatter.js";
+export class AgentParser {
+    parse(raw, source) {
+        const { frontmatter, body } = parseFrontmatter(raw);
+        const nameRaw = frontmatter.name;
+        const id = (typeof nameRaw === "string" ? nameRaw : crypto.randomUUID());
+        const mode = (frontmatter.mode ?? "all");
+        const model = typeof frontmatter.model === "string" ? frontmatter.model : undefined;
+        const hidden = typeof frontmatter.hidden === "boolean" ? frontmatter.hidden : undefined;
+        const tools = Array.isArray(frontmatter.tools) ? frontmatter.tools : undefined;
+        const maxSteps = typeof frontmatter.maxSteps === "number" ? frontmatter.maxSteps : undefined;
+        const temperature = typeof frontmatter.temperature === "number" ? frontmatter.temperature : undefined;
+        const perm = frontmatter.permission;
+        const rules = perm
+            ? this.mapPermissions(perm)
+            : undefined;
+        const config = {
+            id,
+            profile: {
+                name: typeof frontmatter.name === "string" ? frontmatter.name : "unnamed",
+                description: typeof frontmatter.description === "string" ? frontmatter.description : "",
+                ...(model !== undefined ? { model } : {}),
+                ...(hidden !== undefined ? { hidden } : {}),
+            },
+            capabilities: {
+                ...(tools !== undefined ? { tools } : {}),
+                streaming: true,
+                thinking: false,
+            },
+            permissions: {
+                mode,
+                ...(rules !== undefined || maxSteps !== undefined
+                    ? { ruleset: { rules: rules ?? [], ...(maxSteps !== undefined ? { maxSteps } : {}) } }
+                    : {}),
+            },
+            ...(body ? { systemPrompt: body } : {}),
+            ...(temperature !== undefined ? { temperature } : {}),
+        };
+        const errors = validateAgentConfig(config);
+        if (errors.length > 0) {
+            throw new Error(`Invalid agent config: ${errors.join("; ")}`);
+        }
+        return { config, source, raw };
+    }
+    async parseFile(filePath, source) {
+        const content = await readFile(filePath, "utf-8");
+        return this.parse(content, source);
+    }
+    mapPermissions(perm) {
+        const rules = [];
+        for (const [key, value] of Object.entries(perm)) {
+            if (typeof value === "string") {
+                rules.push({ effect: value, target: key });
+            }
+            else if (typeof value === "object" && value !== null) {
+                const nested = value;
+                for (const [pattern, effect] of Object.entries(nested)) {
+                    rules.push({ effect: effect, target: `${key}.${pattern}` });
+                }
+            }
+        }
+        return rules;
+    }
+    toAgentConfig(def) {
+        return def.config;
+    }
+}
+//# sourceMappingURL=agent-parser.js.map

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

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

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

@@ -0,0 +1,49 @@
+import type { AgentConfig, AgentId, SkillSourceType } from "@vinhnt-sdk/schema";
+export interface AgentRegistry {
+    register(config: AgentConfig, parentId?: AgentId): Promise<void>;
+    get(id: AgentId): Promise<AgentConfig | null>;
+    list(): Promise<readonly AgentConfig[]>;
+    findByCapability(key: string, value: unknown): Promise<readonly AgentConfig[]>;
+    update(id: AgentId, patch: Partial<AgentConfig>): Promise<AgentConfig | null>;
+    unregister(id: AgentId): Promise<void>;
+    getChildren(parentId: AgentId): Promise<readonly AgentConfig[]>;
+    getParent(childId: AgentId): Promise<AgentConfig | null>;
+    getAncestors(childId: AgentId): Promise<readonly AgentConfig[]>;
+}
+export interface SourceDir {
+    type: SkillSourceType;
+    dir: string;
+    priority: number;
+}
+export type AgentSource = {
+    type: "inline";
+    config: AgentConfig;
+    parentId?: AgentId;
+} | {
+    type: "file";
+    path: string;
+    parentId?: AgentId;
+};
+/**
+ * In-memory agent store with optional file loading (load/loadMultiple/reload).
+ */
+export declare class InMemoryAgentRegistry implements AgentRegistry {
+    protected readonly agents: Map<string, AgentConfig>;
+    private readonly parentMap;
+    private readonly childrenMap;
+    private readonly loadedPaths;
+    private readonly pathToAgentId;
+    register(config: AgentConfig, parentId?: AgentId): Promise<void>;
+    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[]>;
+    load(source: AgentSource): Promise<AgentConfig>;
+    loadMultiple(sources: AgentSource[]): Promise<AgentConfig[]>;
+    reload(path: string): Promise<AgentConfig>;
+}
+//# sourceMappingURL=agent-registry.d.ts.map

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

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