@vinhnt-sdk/core 0.1.0

package/dist/agent/dynamic-registry.js

@@ -0,0 +1,87 @@
+import { AgentConfigSchema } from "@vnt/schema";
+import { InMemoryAgentRegistry } from "./agent-registry.js";
+import { readFile } from "node:fs/promises";
+import { resolve } from "node:path";
+export class DynamicAgentRegistry {
+    inner;
+    loadedPaths = new Set();
+    pathToAgentId = new Map();
+    constructor() {
+        this.inner = new InMemoryAgentRegistry();
+    }
+    async register(config, parentId) {
+        const parsed = AgentConfigSchema.parse(config);
+        await this.inner.register(parsed, parentId);
+    }
+    async load(source) {
+        switch (source.type) {
+            case "inline": {
+                const parsed = AgentConfigSchema.parse(source.config);
+                await this.inner.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.inner.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.inner.unregister(previousId);
+        }
+        return await this.load({ type: "file", path });
+    }
+    async get(id) {
+        return this.inner.get(id);
+    }
+    async list() {
+        return this.inner.list();
+    }
+    async findByCapability(key, value) {
+        return this.inner.findByCapability(key, value);
+    }
+    async unregister(id) {
+        for (const [absPath, agentId] of this.pathToAgentId) {
+            if (agentId === id) {
+                this.loadedPaths.delete(absPath);
+                this.pathToAgentId.delete(absPath);
+            }
+        }
+        return this.inner.unregister(id);
+    }
+    async update(id, patch) {
+        const updated = await this.inner.update(id, patch);
+        return updated ? AgentConfigSchema.parse(updated) : null;
+    }
+    async getChildren(parentId) {
+        return this.inner.getChildren(parentId);
+    }
+    async getParent(childId) {
+        return this.inner.getParent(childId);
+    }
+    async getAncestors(childId) {
+        return this.inner.getAncestors(childId);
+    }
+}
+//# sourceMappingURL=dynamic-registry.js.map

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

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

package/dist/agent/execution-engine.d.ts

@@ -0,0 +1,25 @@
+import type { AgentId, RequestContext, RunId } from "@vinhnt-sdk/schema";
+import type { AgentRegistry } from "../agent/agent-registry.js";
+import { AgentKernel } from "../kernel/kernel.js";
+export type ExecutionResult = {
+    runId: string;
+    agentId: string;
+    agentName: string;
+    output: string | undefined;
+    status: string;
+    error: string | undefined;
+    ctx: RequestContext;
+    durationMs: number;
+};
+export declare class ExecutionEngine {
+    private readonly registry;
+    private kernel;
+    constructor(registry: AgentRegistry, kernel: AgentKernel);
+    execute(agentId: AgentId, prompt: string, ctx?: RequestContext, parentRunId?: RunId): Promise<ExecutionResult>;
+    executeBatch(tasks: Array<{
+        agentId: AgentId;
+        prompt: string;
+    }>, ctx?: RequestContext, parentRunId?: RunId): Promise<ExecutionResult[]>;
+    executeWithValidation(agentId: AgentId, prompt: string, ctx?: RequestContext, parentRunId?: RunId): Promise<ExecutionResult>;
+}
+//# sourceMappingURL=execution-engine.d.ts.map

package/dist/agent/execution-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-engine.d.ts","sourceRoot":"","sources":["../../src/agent/execution-engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAa,cAAc,EAAE,KAAK,EAAW,MAAM,oBAAoB,CAAC;AAC7F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAKlD,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,GAAG,EAAE,cAAc,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,qBAAa,eAAe;IAIxB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAH3B,OAAO,CAAC,MAAM,CAAc;gBAGT,QAAQ,EAAE,aAAa,EACxC,MAAM,EAAE,WAAW;IAKf,OAAO,CACX,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,EACd,GAAG,CAAC,EAAE,cAAc,EACpB,WAAW,CAAC,EAAE,KAAK,GAClB,OAAO,CAAC,eAAe,CAAC;IAgCrB,YAAY,CAChB,KAAK,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,EAClD,GAAG,CAAC,EAAE,cAAc,EACpB,WAAW,CAAC,EAAE,KAAK,GAClB,OAAO,CAAC,eAAe,EAAE,CAAC;IAavB,qBAAqB,CACzB,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,EACd,GAAG,CAAC,EAAE,cAAc,EACpB,WAAW,CAAC,EAAE,KAAK,GAClB,OAAO,CAAC,eAAe,CAAC;CAmB5B"}

package/dist/agent/execution-engine.js

@@ -0,0 +1,80 @@
+import { getCompletedEventData } from "../kernel/sub-agent-runner.js";
+import { RequestContextSchema } from "@vinhnt-sdk/schema";
+export class ExecutionEngine {
+    registry;
+    kernel;
+    constructor(registry, kernel) {
+        this.registry = registry;
+        this.kernel = kernel;
+    }
+    async execute(agentId, prompt, ctx, parentRunId) {
+        const agent = await this.registry.get(agentId);
+        if (!agent)
+            throw new Error(`Agent not found: ${agentId}`);
+        const validCtx = ctx ?? createCtx(parentRunId);
+        if (parentRunId && !validCtx.parentRunId) {
+            validCtx.parentRunId = parentRunId;
+        }
+        RequestContextSchema.parse(validCtx);
+        const start = Date.now();
+        this.kernel.setCurrentAgent(agent);
+        const handle = this.kernel.run(prompt, validCtx);
+        await handle.completed;
+        const durationMs = Date.now() - start;
+        const store = this.kernel.getEventStore();
+        const completedData = await getCompletedEventData(store, handle.runId);
+        const data = completedData;
+        return {
+            runId: handle.runId,
+            agentId: agent.id,
+            agentName: agent.profile.name,
+            output: data?.output,
+            status: data?.status ?? "unknown",
+            error: data?.error,
+            ctx: validCtx,
+            durationMs,
+        };
+    }
+    async executeBatch(tasks, ctx, parentRunId) {
+        const baseCtx = ctx ?? createCtx(parentRunId);
+        return Promise.all(tasks.map((t) => {
+            const taskCtx = {
+                ...baseCtx,
+                requestId: crypto.randomUUID(),
+            };
+            return this.execute(t.agentId, t.prompt, taskCtx, parentRunId);
+        }));
+    }
+    async executeWithValidation(agentId, prompt, ctx, parentRunId) {
+        try {
+            return await this.execute(agentId, prompt, ctx, parentRunId);
+        }
+        catch (err) {
+            const zodErr = err;
+            return {
+                runId: "",
+                agentId,
+                agentName: "unknown",
+                output: undefined,
+                status: "failed",
+                error: zodErr?.issues
+                    ? zodErr.issues.map((i) => `${i.path.join(".")}: ${i.message}`).join("; ")
+                    : err.message,
+                ctx: ctx ?? createCtx(parentRunId),
+                durationMs: 0,
+            };
+        }
+    }
+}
+function createCtx(parentRunId) {
+    const ctx = {
+        requestId: crypto.randomUUID(),
+        traceId: crypto.randomUUID(),
+        actorId: "execution-engine",
+        tenantId: "default",
+    };
+    if (parentRunId)
+        ctx.parentRunId = parentRunId;
+    return ctx;
+}
+//# sourceMappingURL=execution-engine.js.map

package/dist/agent/execution-engine.js.map

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

package/dist/agent/list-agents-tool.d.ts

@@ -0,0 +1,4 @@
+import type { AgentKernel } from "../kernel/kernel.js";
+/** Tool for listing all registered agents (useful for discovering sub-agents) */
+export declare function createListAgentsTool(kernel: AgentKernel): import("../index.js").ToolDefinition<unknown, string>;
+//# sourceMappingURL=list-agents-tool.d.ts.map

package/dist/agent/list-agents-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-agents-tool.d.ts","sourceRoot":"","sources":["../../src/agent/list-agents-tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAIvD,iFAAiF;AACjF,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,WAAW,yDAoCvD"}

package/dist/agent/list-agents-tool.js

@@ -0,0 +1,43 @@
+import { z } from "zod";
+import { defineTool } from "../tool/define-tool.js";
+/** Tool for listing all registered agents (useful for discovering sub-agents) */
+export function createListAgentsTool(kernel) {
+    return defineTool({
+        name: "list_agents",
+        description: "List all registered agents including their IDs, mode, capabilities, and permissions.",
+        risk: "read",
+        input: z.unknown(),
+        jsonSchema: {
+            type: "object",
+            properties: {},
+        },
+        async execute() {
+            const registry = kernel.getAgentRegistry();
+            if (!registry)
+                return "No agent registry configured";
+            const agents = await registry.list();
+            if (agents.length === 0)
+                return "No agents registered";
+            const lines = await Promise.all(agents.map(async (a) => {
+                const mode = a.permissions?.mode ?? "primary";
+                const parent = await registry.getParent(a.id);
+                let info = `- ${a.id}: ${a.profile.name} [${mode}] — ${a.profile.description}`;
+                if (parent)
+                    info += ` (parent: ${parent.id})`;
+                if (a.permissions?.ruleset?.rules) {
+                    const rules = a.permissions.ruleset.rules.map((r) => `${r.effect}:${r.target}`);
+                    info += ` rules: ${rules.join(", ")}`;
+                }
+                if (a.permissions?.allowedTools) {
+                    info += ` allowed: ${a.permissions.allowedTools.join(", ")}`;
+                }
+                if (a.permissions?.deniedTools) {
+                    info += ` denied: ${a.permissions.deniedTools.join(", ")}`;
+                }
+                return info;
+            }));
+            return lines.join("\n");
+        },
+    }).toDefinition();
+}
+//# sourceMappingURL=list-agents-tool.js.map

package/dist/agent/list-agents-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-agents-tool.js","sourceRoot":"","sources":["../../src/agent/list-agents-tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD,iFAAiF;AACjF,MAAM,UAAU,oBAAoB,CAAC,MAAmB;IACtD,OAAO,UAAU,CAAkB;QACjC,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,sFAAsF;QACnG,IAAI,EAAE,MAAM;QACZ,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE;QAClB,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE;SACf;QACD,KAAK,CAAC,OAAO;YACX,MAAM,QAAQ,GAAG,MAAM,CAAC,gBAAgB,EAAE,CAAC;YAC3C,IAAI,CAAC,QAAQ;gBAAE,OAAO,8BAA8B,CAAC;YACrD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACrC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,sBAAsB,CAAC;YAEvD,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;gBACrD,MAAM,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,IAAI,IAAI,SAAS,CAAC;gBAC9C,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBAC9C,IAAI,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,KAAK,IAAI,OAAO,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;gBAC/E,IAAI,MAAM;oBAAE,IAAI,IAAI,aAAa,MAAM,CAAC,EAAE,GAAG,CAAC;gBAC9C,IAAI,CAAC,CAAC,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;oBAClC,MAAM,KAAK,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;oBAChF,IAAI,IAAI,WAAW,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACxC,CAAC;gBACD,IAAI,CAAC,CAAC,WAAW,EAAE,YAAY,EAAE,CAAC;oBAChC,IAAI,IAAI,aAAa,CAAC,CAAC,WAAW,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC/D,CAAC;gBACD,IAAI,CAAC,CAAC,WAAW,EAAE,WAAW,EAAE,CAAC;oBAC/B,IAAI,IAAI,YAAY,CAAC,CAAC,WAAW,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC7D,CAAC;gBACD,OAAO,IAAI,CAAC;YACd,CAAC,CAAC,CAAC,CAAC;YACJ,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;KACF,CAAC,CAAC,YAAY,EAAE,CAAC;AACpB,CAAC"}

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

@@ -0,0 +1,15 @@
+import type { AgentKernel } from "../kernel/kernel.js";
+export interface SpawnAgentInput {
+    name?: string;
+    description?: string;
+    mode?: string;
+    capabilities?: string[];
+    systemPrompt?: string;
+    temperature?: number;
+    allowedTools?: string[];
+    deniedTools?: string[];
+    maxSteps?: number;
+    maxTokens?: number;
+}
+export declare function createSpawnAgentTool(kernel: AgentKernel): import("../index.js").ToolDefinition<SpawnAgentInput, string>;
+//# sourceMappingURL=spawn-agent-tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spawn-agent-tool.d.ts","sourceRoot":"","sources":["../../src/agent/spawn-agent-tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAIvD,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAoCD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,WAAW,iEAyCvD"}

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

@@ -0,0 +1,77 @@
+import { z } from "zod";
+import { defineTool } from "../tool/define-tool.js";
+function normalizeSpawnInput(raw) {
+    const name = String(raw.name ?? raw.mode ?? raw.id ?? "").trim() || undefined;
+    const caps = Array.isArray(raw.capabilities) ? raw.capabilities.join(", ") : "";
+    const description = String(raw.description ?? caps ?? "").trim() || undefined;
+    if (!name)
+        throw new Error("Sub-agent name is required — provide 'name' (or 'mode')");
+    if (!description)
+        throw new Error("Sub-agent description is required — provide 'description' (or 'capabilities')");
+    return {
+        name,
+        description,
+        ...(raw.systemPrompt !== undefined ? { systemPrompt: String(raw.systemPrompt) } : {}),
+        ...(raw.temperature !== undefined ? { temperature: Number(raw.temperature) } : {}),
+        ...(raw.allowedTools !== undefined ? { allowedTools: raw.allowedTools } : {}),
+        ...(raw.deniedTools !== undefined ? { deniedTools: raw.deniedTools } : {}),
+        ...(raw.maxSteps !== undefined ? { maxSteps: Number(raw.maxSteps) } : {}),
+        ...(raw.maxTokens !== undefined ? { maxTokens: Number(raw.maxTokens) } : {}),
+    };
+}
+const SpawnInputSchema = z.object({
+    name: z.string().optional(),
+    description: z.string().optional(),
+    mode: z.string().optional(),
+    id: z.string().optional(),
+    capabilities: z.array(z.string()).optional(),
+    systemPrompt: z.string().optional(),
+    temperature: z.number().optional(),
+    allowedTools: z.array(z.string()).optional(),
+    deniedTools: z.array(z.string()).optional(),
+    maxSteps: z.number().optional(),
+    maxTokens: z.number().optional(),
+});
+export function createSpawnAgentTool(kernel) {
+    return defineTool({
+        name: "spawn_agent",
+        description: "Create a sub-agent with inherited permissions. Use this to delegate tasks to specialized agents.",
+        risk: "write",
+        input: SpawnInputSchema,
+        normalize: (raw) => normalizeSpawnInput(raw),
+        jsonSchema: {
+            type: "object",
+            properties: {
+                name: { type: "string", description: "Name for the sub-agent" },
+                description: { type: "string", description: "Description of the sub-agent's purpose" },
+                mode: { type: "string", description: "Alias for 'name' (LLM-friendly)" },
+                capabilities: { type: "array", items: { type: "string" }, description: "Alias for 'description' — auto-joined as description" },
+                systemPrompt: { type: "string", description: "System prompt for the sub-agent" },
+                temperature: { type: "number", description: "Temperature for the sub-agent (0-2)" },
+                allowedTools: { type: "array", items: { type: "string" }, description: "Restrict to specific tools" },
+                deniedTools: { type: "array", items: { type: "string" }, description: "Deny specific tools" },
+                maxSteps: { type: "number", description: "Max steps for the sub-agent" },
+                maxTokens: { type: "number", description: "Max tokens for the sub-agent" },
+            },
+            required: [],
+        },
+        async execute(input) {
+            const hasPerms = input.allowedTools || input.deniedTools || input.maxSteps !== undefined || input.maxTokens !== undefined;
+            const agent = await kernel.spawnAgent({
+                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.maxSteps !== undefined ? { maxSteps: input.maxSteps } : {}),
+                        ...(input.maxTokens !== undefined ? { maxTokens: input.maxTokens } : {}),
+                    },
+                } : {}),
+            });
+            return `Sub-agent "${agent.profile.name}" created with ID: ${agent.id}`;
+        },
+    }).toDefinition();
+}
+//# sourceMappingURL=spawn-agent-tool.js.map

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

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

package/dist/crypto/password.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Hash a password using scrypt with a random salt.
+ * Returns `salt:hash` (both hex-encoded).
+ */
+export declare function hashPassword(password: string): Promise<string>;
+/**
+ * Verify a password against a stored `salt:hash` string.
+ * Uses constant-time comparison to prevent timing attacks.
+ */
+export declare function verifyPassword(password: string, stored: string): Promise<boolean>;
+//# sourceMappingURL=password.d.ts.map

package/dist/crypto/password.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"password.d.ts","sourceRoot":"","sources":["../../src/crypto/password.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CASpE;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAgBvF"}

package/dist/crypto/password.js

@@ -0,0 +1,44 @@
+import { randomBytes, scrypt, timingSafeEqual } from "node:crypto";
+const SALT_LEN = 32;
+const KEY_LEN = 64;
+const SCRYPT_OPTS = { N: 16384, r: 8, p: 1 };
+/**
+ * Hash a password using scrypt with a random salt.
+ * Returns `salt:hash` (both hex-encoded).
+ */
+export async function hashPassword(password) {
+    const salt = randomBytes(SALT_LEN).toString("hex");
+    const derived = await new Promise((resolve, reject) => {
+        scrypt(password, salt, KEY_LEN, SCRYPT_OPTS, (err, key) => {
+            if (err)
+                reject(err);
+            else
+                resolve(key);
+        });
+    });
+    return `${salt}:${derived.toString("hex")}`;
+}
+/**
+ * Verify a password against a stored `salt:hash` string.
+ * Uses constant-time comparison to prevent timing attacks.
+ */
+export async function verifyPassword(password, stored) {
+    const sep = stored.indexOf(":");
+    if (sep === -1)
+        return false;
+    const salt = stored.slice(0, sep);
+    const expectedHex = stored.slice(sep + 1);
+    const expected = Buffer.from(expectedHex, "hex");
+    const derived = await new Promise((resolve, reject) => {
+        scrypt(password, salt, KEY_LEN, SCRYPT_OPTS, (err, key) => {
+            if (err)
+                reject(err);
+            else
+                resolve(key);
+        });
+    });
+    if (derived.length !== expected.length)
+        return false;
+    return timingSafeEqual(derived, expected);
+}
+//# sourceMappingURL=password.js.map

package/dist/crypto/password.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"password.js","sourceRoot":"","sources":["../../src/crypto/password.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnE,MAAM,QAAQ,GAAG,EAAE,CAAC;AACpB,MAAM,OAAO,GAAG,EAAE,CAAC;AACnB,MAAM,WAAW,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAW,CAAC;AAEtD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,QAAgB;IACjD,MAAM,IAAI,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,MAAM,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC5D,MAAM,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;YACxD,IAAI,GAAG;gBAAE,MAAM,CAAC,GAAG,CAAC,CAAC;;gBAChB,OAAO,CAAC,GAAa,CAAC,CAAC;QAC9B,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IACH,OAAO,GAAG,IAAI,IAAI,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;AAC9C,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,QAAgB,EAAE,MAAc;IACnE,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAChC,IAAI,GAAG,KAAK,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IAC7B,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAClC,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;IAC1C,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IAEjD,MAAM,OAAO,GAAG,MAAM,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC5D,MAAM,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;YACxD,IAAI,GAAG;gBAAE,MAAM,CAAC,GAAG,CAAC,CAAC;;gBAChB,OAAO,CAAC,GAAa,CAAC,CAAC;QAC9B,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAI,OAAO,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IACrD,OAAO,eAAe,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;AAC5C,CAAC"}

package/dist/event-bus/bridge.d.ts

@@ -0,0 +1,19 @@
+import type { EventDefinition, TypedEvent } from "@vinhnt-sdk/schema";
+import type { RunEventStore } from "../session/store.js";
+import type { EventBus } from "./types.js";
+export declare class EventBusBridge {
+    private bus;
+    private store;
+    constructor(store: RunEventStore, bus?: EventBus);
+    get eventBus(): EventBus;
+    publish<T>(def: EventDefinition<T>, data: T, meta?: {
+        traceId?: string;
+        aggregateId?: string;
+    }): void;
+    subscribe<T>(def: EventDefinition<T>, handler: (event: TypedEvent<T>) => void): () => void;
+    subscribeAll(handler: (event: TypedEvent<unknown>) => void): () => void;
+    durable<T>(def: EventDefinition<T> & {
+        durable: NonNullable<EventDefinition["durable"]>;
+    }, aggregateId: string, after?: number): AsyncIterable<TypedEvent<T>>;
+}
+//# sourceMappingURL=bridge.d.ts.map

package/dist/event-bus/bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../../src/event-bus/bridge.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAG3C,qBAAa,cAAc;IACzB,OAAO,CAAC,GAAG,CAAW;IACtB,OAAO,CAAC,KAAK,CAAgB;gBAEjB,KAAK,EAAE,aAAa,EAAE,GAAG,CAAC,EAAE,QAAQ;IAKhD,IAAI,QAAQ,IAAI,QAAQ,CAEvB;IAED,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,eAAe,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAoBrG,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,eAAe,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI;IAI1F,YAAY,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI;IAIhE,OAAO,CAAC,CAAC,EACd,GAAG,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG;QAAE,OAAO,EAAE,WAAW,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAAA;KAAE,EAC9E,WAAW,EAAE,MAAM,EACnB,KAAK,CAAC,EAAE,MAAM,GACb,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;CAWhC"}

package/dist/event-bus/bridge.js

@@ -0,0 +1,48 @@
+import { InMemoryEventBus } from "./in-memory-bus.js";
+export class EventBusBridge {
+    bus;
+    store;
+    constructor(store, bus) {
+        this.store = store;
+        this.bus = bus ?? new InMemoryEventBus();
+    }
+    get eventBus() {
+        return this.bus;
+    }
+    publish(def, data, meta) {
+        this.bus.publish(def, data, meta);
+        // Persist durable events to RunEventStore with correct sequence
+        if (def.durable && meta?.aggregateId) {
+            this.store.getNextSequence(meta.aggregateId).then((seq) => {
+                const event = {
+                    id: crypto.randomUUID(),
+                    runId: meta.aggregateId,
+                    sequence: seq,
+                    type: def.type,
+                    occurredAt: new Date().toISOString(),
+                    traceId: (meta.traceId ?? crypto.randomUUID()),
+                    data: data,
+                };
+                this.store.append(event).catch((err) => console.error("[EventBusBridge] Failed to persist event:", err));
+            }).catch((err) => console.error("[EventBusBridge] Failed to get next sequence:", err));
+        }
+    }
+    subscribe(def, handler) {
+        return this.bus.subscribe(def, handler);
+    }
+    subscribeAll(handler) {
+        return this.bus.subscribeAll(handler);
+    }
+    async *durable(def, aggregateId, after) {
+        // Replay from store first
+        if (after === undefined || after >= 0) {
+            const stored = await this.store.list(aggregateId, after);
+            for (const ev of stored) {
+                yield { id: ev.id, type: ev.type, occurredAt: ev.occurredAt, traceId: ev.traceId, sequence: ev.sequence, aggregateId: ev.runId, data: ev.data };
+            }
+        }
+        // Then live from bus
+        yield* this.bus.durable(def, aggregateId, after ?? -1);
+    }
+}
+//# sourceMappingURL=bridge.js.map

package/dist/event-bus/bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.js","sourceRoot":"","sources":["../../src/event-bus/bridge.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,MAAM,OAAO,cAAc;IACjB,GAAG,CAAW;IACd,KAAK,CAAgB;IAE7B,YAAY,KAAoB,EAAE,GAAc;QAC9C,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,GAAG,GAAG,GAAG,IAAI,IAAI,gBAAgB,EAAE,CAAC;IAC3C,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,GAAG,CAAC;IAClB,CAAC;IAED,OAAO,CAAI,GAAuB,EAAE,IAAO,EAAE,IAAiD;QAC5F,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QAElC,gEAAgE;QAChE,IAAI,GAAG,CAAC,OAAO,IAAI,IAAI,EAAE,WAAW,EAAE,CAAC;YACrC,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE;gBACxD,MAAM,KAAK,GAAa;oBACtB,EAAE,EAAE,MAAM,CAAC,UAAU,EAAE;oBACvB,KAAK,EAAE,IAAI,CAAC,WAAoB;oBAChC,QAAQ,EAAE,GAAG;oBACb,IAAI,EAAE,GAAG,CAAC,IAAI;oBACd,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;oBACpC,OAAO,EAAE,CAAC,IAAI,CAAC,OAAO,IAAI,MAAM,CAAC,UAAU,EAAE,CAAY;oBACzD,IAAI,EAAE,IAA+B;iBACtC,CAAC;gBACF,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,2CAA2C,EAAE,GAAG,CAAC,CAAC,CAAC;YAC3G,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,+CAA+C,EAAE,GAAG,CAAC,CAAC,CAAC;QACzF,CAAC;IACH,CAAC;IAED,SAAS,CAAI,GAAuB,EAAE,OAAuC;QAC3E,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;IAED,YAAY,CAAC,OAA6C;QACxD,OAAO,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,CAAC,OAAO,CACZ,GAA8E,EAC9E,WAAmB,EACnB,KAAc;QAEd,0BAA0B;QAC1B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;YACtC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;YACzD,KAAK,MAAM,EAAE,IAAI,MAAM,EAAE,CAAC;gBACxB,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAmB,CAAC;YACnK,CAAC;QACH,CAAC;QACD,qBAAqB;QACrB,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,WAAW,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC;IACzD,CAAC;CACF"}

package/dist/event-bus/global-bus.d.ts

@@ -0,0 +1,30 @@
+import type { TypedEvent, EventDefinition } from "@vinhnt-sdk/schema";
+import type { EventBus, EventHandler, Unsubscribe } from "./types.js";
+export interface RedisAdapter {
+    publish(channel: string, message: string): Promise<void>;
+    on(event: string, handler: (channel: string, message: string) => void): void;
+    subscribe(channel: string): void;
+}
+declare global {
+    var __vnt_global_event_bus__: GlobalEventBus | undefined;
+}
+export declare function getGlobalEventBus(): GlobalEventBus;
+export declare class GlobalEventBus implements EventBus {
+    private emitter;
+    private durableEvents;
+    private redisAdapter;
+    constructor();
+    setRedisAdapter(adapter: RedisAdapter): void;
+    publish<T>(def: EventDefinition<T>, data: T, meta?: {
+        traceId?: string;
+        aggregateId?: string;
+    }): void;
+    subscribe<T>(def: EventDefinition<T>, handler: EventHandler<T>): Unsubscribe;
+    subscribeAll(handler: EventHandler, namespace?: string): Unsubscribe;
+    project<T>(def: EventDefinition<T>, handler: (event: TypedEvent<T>) => void): Unsubscribe;
+    durable<T>(def: EventDefinition<T> & {
+        durable: NonNullable<EventDefinition["durable"]>;
+    }, aggregateId: string, after?: number): AsyncIterable<TypedEvent<T>>;
+    reset(): void;
+}
+//# sourceMappingURL=global-bus.d.ts.map

package/dist/event-bus/global-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-bus.d.ts","sourceRoot":"","sources":["../../src/event-bus/global-bus.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAItE,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IAC7E,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,OAAO,CAAC,MAAM,CAAC;IAEb,IAAI,wBAAwB,EAAE,cAAc,GAAG,SAAS,CAAC;CAC1D;AAED,wBAAgB,iBAAiB,IAAI,cAAc,CAKlD;AAED,qBAAa,cAAe,YAAW,QAAQ;IAC7C,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,aAAa,CAA4C;IACjE,OAAO,CAAC,YAAY,CAA6B;;IAMjD,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAe5C,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,eAAe,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IA2BrG,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,eAAe,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,WAAW;IAO5E,YAAY,CAAC,OAAO,EAAE,YAAY,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,WAAW;IAcpE,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,eAAe,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,WAAW;IAIlF,OAAO,CAAC,CAAC,EACd,GAAG,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG;QAAE,OAAO,EAAE,WAAW,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAAA;KAAE,EAC9E,WAAW,EAAE,MAAM,EACnB,KAAK,CAAC,EAAE,MAAM,GACb,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAS/B,KAAK,IAAI,IAAI;CAKd"}