@vinhnt-sdk/core 0.1.0

package/dist/knowledge/memory-bounded.js

@@ -0,0 +1,63 @@
+import { InMemoryMemoryStore } from "./memory.js";
+const DEFAULT_LIMITS = {
+    profileLimit: 1400,
+    workingLimit: 2200,
+};
+function truncate(value, limit) {
+    if (value.length <= limit)
+        return value;
+    return value.slice(0, limit - 3) + "...";
+}
+export class BoundedMemory {
+    profile = "";
+    working = "";
+    store;
+    limits;
+    constructor(store, limits) {
+        this.store = store ?? new InMemoryMemoryStore();
+        this.limits = { ...DEFAULT_LIMITS, ...limits };
+    }
+    async setProfile(value) {
+        this.profile = truncate(value, this.limits.profileLimit);
+        await this.store.set({
+            key: "_profile",
+            value: this.profile,
+            sessionId: "_global",
+            tier: "long-term",
+            tags: ["profile", "bounded"],
+        });
+        return { key: "_profile", value: this.profile, tier: "stable", charLimit: this.limits.profileLimit };
+    }
+    getProfile() {
+        return { key: "_profile", value: this.profile, tier: "stable", charLimit: this.limits.profileLimit };
+    }
+    async setWorkingFact(key, value) {
+        const current = this.working.length > 0 ? this.working + "\n" : "";
+        const line = `${key}: ${value}`;
+        this.working = truncate(current + line, this.limits.workingLimit);
+        await this.store.set({
+            key: `_working:${key}`,
+            value,
+            sessionId: "_global",
+            tier: "working",
+            tags: ["working", "bounded"],
+        });
+        return { key, value, tier: "volatile", charLimit: this.limits.workingLimit };
+    }
+    getWorking() {
+        return this.working;
+    }
+    clearWorking() {
+        this.working = "";
+    }
+    getAllBounded() {
+        return [
+            { key: "_profile", value: this.profile, tier: "stable", charLimit: this.limits.profileLimit },
+            { key: "_working", value: this.working, tier: "volatile", charLimit: this.limits.workingLimit },
+        ];
+    }
+    totalChars() {
+        return this.profile.length + this.working.length;
+    }
+}
+//# sourceMappingURL=memory-bounded.js.map

package/dist/knowledge/memory-bounded.js.map

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

package/dist/knowledge/memory.d.ts

@@ -0,0 +1,21 @@
+import type { MemoryItem, MemoryStore, MemoryTier } from "./types.js";
+export declare class InMemoryMemoryStore implements MemoryStore {
+    private items;
+    get(key: string, sessionId: string): Promise<MemoryItem | undefined>;
+    set(data: Omit<MemoryItem, "id" | "createdAt" | "updatedAt">): Promise<MemoryItem>;
+    delete(key: string, sessionId: string): Promise<void>;
+    search(query: string, sessionId: string): Promise<MemoryItem[]>;
+    listByTier(tier: MemoryTier, sessionId: string): Promise<MemoryItem[]>;
+}
+export declare class SessionMemory {
+    private store;
+    private sessionId;
+    constructor(sessionId: string, store?: MemoryStore);
+    remember(key: string, value: string, tags?: string[]): Promise<MemoryItem>;
+    recall(key: string): Promise<string | undefined>;
+    forget(key: string): Promise<void>;
+    search(query: string): Promise<MemoryItem[]>;
+    getWorkingMemory(): Promise<MemoryItem[]>;
+    setWorkingMemory(data: Record<string, string>): Promise<MemoryItem[]>;
+}
+//# sourceMappingURL=memory.d.ts.map

package/dist/knowledge/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/knowledge/memory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEtE,qBAAa,mBAAoB,YAAW,WAAW;IACrD,OAAO,CAAC,KAAK,CAAoB;IAE3B,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAMpE,GAAG,CACP,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,GAAG,WAAW,GAAG,WAAW,CAAC,GACvD,OAAO,CAAC,UAAU,CAAC;IAqBhB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMrD,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAW/D,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;CAQ7E;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,SAAS,CAAS;gBAEd,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,WAAW;IAK5C,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC;IAU1E,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAKhD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAI5C,gBAAgB,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAIzC,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;CAc5E"}

package/dist/knowledge/memory.js

@@ -0,0 +1,85 @@
+import { randomUUID } from "node:crypto";
+export class InMemoryMemoryStore {
+    items = [];
+    async get(key, sessionId) {
+        return this.items.find((item) => item.key === key && item.sessionId === sessionId);
+    }
+    async set(data) {
+        const existing = this.items.find((item) => item.key === data.key && item.sessionId === data.sessionId && item.tier === data.tier);
+        const now = new Date().toISOString();
+        if (existing) {
+            existing.value = data.value;
+            existing.tags = data.tags;
+            existing.updatedAt = now;
+            return existing;
+        }
+        const item = {
+            id: randomUUID(),
+            ...data,
+            createdAt: now,
+            updatedAt: now,
+        };
+        this.items.push(item);
+        return item;
+    }
+    async delete(key, sessionId) {
+        this.items = this.items.filter((item) => !(item.key === key && item.sessionId === sessionId));
+    }
+    async search(query, sessionId) {
+        const q = query.toLowerCase();
+        return this.items.filter((item) => (!sessionId || item.sessionId === sessionId) &&
+            (item.key.toLowerCase().includes(q) ||
+                item.value.toLowerCase().includes(q) ||
+                item.tags.some((t) => t.toLowerCase().includes(q))));
+    }
+    async listByTier(tier, sessionId) {
+        return this.items
+            .filter((item) => item.tier === tier && (!sessionId || item.sessionId === sessionId))
+            .sort((a, b) => new Date(b.updatedAt).getTime() - new Date(a.updatedAt).getTime());
+    }
+}
+export class SessionMemory {
+    store;
+    sessionId;
+    constructor(sessionId, store) {
+        this.sessionId = sessionId;
+        this.store = store ?? new InMemoryMemoryStore();
+    }
+    async remember(key, value, tags) {
+        return this.store.set({
+            key,
+            value,
+            sessionId: this.sessionId,
+            tier: "session",
+            tags: tags ?? [],
+        });
+    }
+    async recall(key) {
+        const item = await this.store.get(key, this.sessionId);
+        return item?.value;
+    }
+    async forget(key) {
+        return this.store.delete(key, this.sessionId);
+    }
+    async search(query) {
+        return this.store.search(query, this.sessionId);
+    }
+    async getWorkingMemory() {
+        return this.store.listByTier("working", this.sessionId);
+    }
+    async setWorkingMemory(data) {
+        const results = [];
+        for (const [key, value] of Object.entries(data)) {
+            const item = await this.store.set({
+                key,
+                value,
+                sessionId: this.sessionId,
+                tier: "working",
+                tags: ["working"],
+            });
+            results.push(item);
+        }
+        return results;
+    }
+}
+//# sourceMappingURL=memory.js.map

package/dist/knowledge/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../src/knowledge/memory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,MAAM,OAAO,mBAAmB;IACtB,KAAK,GAAiB,EAAE,CAAC;IAEjC,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,SAAiB;QACtC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CACpB,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,KAAK,GAAG,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,CAC3D,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,GAAG,CACP,IAAwD;QAExD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAC9B,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,KAAK,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,CAChG,CAAC;QACF,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACrC,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;YAC5B,QAAQ,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;YAC1B,QAAQ,CAAC,SAAS,GAAG,GAAG,CAAC;YACzB,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,MAAM,IAAI,GAAe;YACvB,EAAE,EAAE,UAAU,EAAE;YAChB,GAAG,IAAI;YACP,SAAS,EAAE,GAAG;YACd,SAAS,EAAE,GAAG;SACf,CAAC;QACF,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW,EAAE,SAAiB;QACzC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAC5B,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,KAAK,GAAG,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC,CAC9D,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,SAAiB;QAC3C,MAAM,CAAC,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CACtB,CAAC,IAAI,EAAE,EAAE,CACP,CAAC,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC;YAC5C,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;gBACjC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;gBACpC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CACxD,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,IAAgB,EAAE,SAAiB;QAClD,OAAO,IAAI,CAAC,KAAK;aACd,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC;aACpF,IAAI,CACH,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACP,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CACpE,CAAC;IACN,CAAC;CACF;AAED,MAAM,OAAO,aAAa;IAChB,KAAK,CAAc;IACnB,SAAS,CAAS;IAE1B,YAAY,SAAiB,EAAE,KAAmB;QAChD,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,KAAK,GAAG,KAAK,IAAI,IAAI,mBAAmB,EAAE,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,GAAW,EAAE,KAAa,EAAE,IAAe;QACxD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC;YACpB,GAAG;YACH,KAAK;YACL,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,IAAI,IAAI,EAAE;SACjB,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QACvD,OAAO,IAAI,EAAE,KAAK,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAa;QACxB,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,gBAAgB;QACpB,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAC1D,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,IAA4B;QACjD,MAAM,OAAO,GAAiB,EAAE,CAAC;QACjC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAChD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC;gBAChC,GAAG;gBACH,KAAK;gBACL,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,CAAC,SAAS,CAAC;aAClB,CAAC,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF"}

package/dist/knowledge/prompt-builder.d.ts

@@ -0,0 +1,11 @@
+import type { PromptAssembly, MemoryEntry } from "@vinhnt-sdk/schema";
+export interface PromptBuilderOptions {
+    readonly identity: string;
+    readonly toolGuidance: string;
+    readonly skillsIndex: string;
+    readonly projectContext: string;
+    readonly memoryEntries: MemoryEntry[];
+    readonly sessionMetadata: string;
+}
+export declare function buildPrompt(options: PromptBuilderOptions): PromptAssembly;
+//# sourceMappingURL=prompt-builder.d.ts.map

package/dist/knowledge/prompt-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-builder.d.ts","sourceRoot":"","sources":["../../src/knowledge/prompt-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,WAAW,EAAE,CAAC;IACtC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,oBAAoB,GAAG,cAAc,CA0BzE"}

package/dist/knowledge/prompt-builder.js

@@ -0,0 +1,23 @@
+export function buildPrompt(options) {
+    const stable = [
+        options.identity,
+        options.toolGuidance,
+        options.skillsIndex,
+    ].filter(Boolean).join("\n\n");
+    const context = [
+        options.projectContext,
+    ].filter(Boolean).join("\n\n");
+    const volatileParts = [
+        ...options.memoryEntries.map((e) => `[${e.tier}] ${e.key}:\n${e.value}`),
+        options.sessionMetadata,
+    ].filter(Boolean);
+    const volatile = volatileParts.join("\n\n");
+    const memoryBlock = volatile ? `<memory>\n${volatile}\n</memory>` : "";
+    const assembled = [
+        stable,
+        context ? `<context>\n${context}\n</context>` : "",
+        memoryBlock,
+    ].filter(Boolean).join("\n\n");
+    return { stable, context, volatile, assembled, version: "1.0.0", metadata: {} };
+}
+//# sourceMappingURL=prompt-builder.js.map

package/dist/knowledge/prompt-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-builder.js","sourceRoot":"","sources":["../../src/knowledge/prompt-builder.ts"],"names":[],"mappings":"AAWA,MAAM,UAAU,WAAW,CAAC,OAA6B;IACvD,MAAM,MAAM,GAAG;QACb,OAAO,CAAC,QAAQ;QAChB,OAAO,CAAC,YAAY;QACpB,OAAO,CAAC,WAAW;KACpB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAE/B,MAAM,OAAO,GAAG;QACd,OAAO,CAAC,cAAc;KACvB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAE/B,MAAM,aAAa,GAAG;QACpB,GAAG,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,KAAK,EAAE,CAAC;QACxE,OAAO,CAAC,eAAe;KACxB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAElB,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAE5C,MAAM,WAAW,GAAG,QAAQ,CAAC,CAAC,CAAC,aAAa,QAAQ,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;IACvE,MAAM,SAAS,GAAG;QAChB,MAAM;QACN,OAAO,CAAC,CAAC,CAAC,cAAc,OAAO,cAAc,CAAC,CAAC,CAAC,EAAE;QAClD,WAAW;KACZ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAE/B,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;AAClF,CAAC"}

package/dist/knowledge/review.d.ts

@@ -0,0 +1,26 @@
+import type { MemoryStore } from "./types.js";
+import type { WriteApprovalQueue } from "./approval.js";
+import type { BoundedMemory } from "./memory-bounded.js";
+export interface ReviewOptions {
+    readonly requireApproval: boolean;
+}
+interface FactExtraction {
+    key: string;
+    value: string;
+}
+export declare class BackgroundReview {
+    private sessionMem;
+    private boundedMem;
+    private approvalQueue;
+    constructor(sessionId: string, boundedMem: BoundedMemory, store?: MemoryStore, approvalQueue?: WriteApprovalQueue);
+    reviewTurn(messages: {
+        role: string;
+        content: string;
+    }[], options?: ReviewOptions): Promise<{
+        extracted: FactExtraction[];
+        approved: boolean;
+    }>;
+    private extractFacts;
+}
+export {};
+//# sourceMappingURL=review.d.ts.map

package/dist/knowledge/review.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review.d.ts","sourceRoot":"","sources":["../../src/knowledge/review.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;CACnC;AAED,UAAU,cAAc;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,UAAU,CAAgB;IAClC,OAAO,CAAC,UAAU,CAAgB;IAClC,OAAO,CAAC,aAAa,CAAiC;gBAGpD,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,aAAa,EACzB,KAAK,CAAC,EAAE,WAAW,EACnB,aAAa,CAAC,EAAE,kBAAkB;IAO9B,UAAU,CACd,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,EAC7C,OAAO,GAAE,aAA0C,GAClD,OAAO,CAAC;QAAE,SAAS,EAAE,cAAc,EAAE,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC;IA8B9D,OAAO,CAAC,YAAY;CAyBrB"}

package/dist/knowledge/review.js

@@ -0,0 +1,69 @@
+import { SessionMemory } from "./memory.js";
+export class BackgroundReview {
+    sessionMem;
+    boundedMem;
+    approvalQueue;
+    constructor(sessionId, boundedMem, store, approvalQueue) {
+        this.sessionMem = new SessionMemory(sessionId, store);
+        this.boundedMem = boundedMem;
+        this.approvalQueue = approvalQueue;
+    }
+    async reviewTurn(messages, options = { requireApproval: false }) {
+        const extracted = [];
+        for (const msg of messages) {
+            if (msg.role !== "assistant" && msg.role !== "user")
+                continue;
+            const facts = this.extractFacts(msg.content);
+            extracted.push(...facts);
+        }
+        if (extracted.length === 0)
+            return { extracted: [], approved: true };
+        for (const { key, value } of extracted) {
+            if (options.requireApproval && this.approvalQueue) {
+                await this.approvalQueue.requestApproval({
+                    type: "memory.write",
+                    description: `Extract fact: ${key} = ${value}`,
+                    payload: { key, value },
+                });
+            }
+            else {
+                await this.boundedMem.setWorkingFact(key, value);
+                await this.sessionMem.remember(key, value, ["auto-extracted"]);
+            }
+        }
+        const pendingCount = this.approvalQueue?.listPending().length ?? 0;
+        return {
+            extracted,
+            approved: !options.requireApproval || pendingCount === 0,
+        };
+    }
+    extractFacts(content) {
+        const facts = [];
+        const patterns = [
+            { re: /(?:remember|note|record|save|store)\s+(?:that\s+)?(.{10,200})/gi, keyPrefix: "fact" },
+            { re: /(?:I\s+(?:learn(?:ed)?|found|discovered|noticed)\s+that\s+)(.{10,200})/gi, keyPrefix: "discovery" },
+            { re: /(?:key\s+(?:fact|finding|decision):\s*)(.{10,200})/gi, keyPrefix: "" },
+        ];
+        for (const { re, keyPrefix } of patterns) {
+            let match;
+            while ((match = re.exec(content)) !== null) {
+                const captured = match[1];
+                if (!captured)
+                    continue;
+                const val = captured.trim();
+                const idx = val.indexOf(": ");
+                if (idx > 0 && idx < 60) {
+                    facts.push({ key: val.slice(0, idx).trim(), value: val.slice(idx + 2).trim() });
+                }
+                else if (keyPrefix) {
+                    facts.push({ key: keyPrefix, value: val });
+                }
+                else {
+                    facts.push({ key: `_fact_${facts.length + 1}`, value: val });
+                }
+            }
+        }
+        return facts;
+    }
+}
+//# sourceMappingURL=review.js.map

package/dist/knowledge/review.js.map

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

package/dist/knowledge/tool.d.ts

@@ -0,0 +1,4 @@
+import type { ToolDefinition } from "../tool/definitions.js";
+import type { SessionStore } from "../session/store.js";
+export declare function createMemorySearchTool(store: SessionStore): ToolDefinition;
+//# sourceMappingURL=tool.d.ts.map

package/dist/knowledge/tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/knowledge/tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,YAAY,GAAG,cAAc,CAwB1E"}

package/dist/knowledge/tool.js

@@ -0,0 +1,27 @@
+export function createMemorySearchTool(store) {
+    return {
+        id: "memory_search",
+        description: "Search past conversations by keyword. Returns messages from session history with relevance ranking.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                query: { type: "string", description: "The search query to find in past conversations" },
+                limit: { type: "number", description: "Maximum results (default: 10)", default: 10 },
+            },
+            required: ["query"],
+        },
+        risk: "read",
+        async execute(input) {
+            if (!store.searchMessages)
+                return [];
+            const messages = await store.searchMessages(input.query, input.limit ?? 10);
+            return messages.map((m) => ({
+                sessionId: m.sessionId.slice(0, 8),
+                role: m.role,
+                content: m.content.slice(0, 500),
+                createdAt: m.createdAt,
+            }));
+        },
+    };
+}
+//# sourceMappingURL=tool.js.map

package/dist/knowledge/tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../src/knowledge/tool.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,sBAAsB,CAAC,KAAmB;IACxD,OAAO;QACL,EAAE,EAAE,eAAe;QACnB,WAAW,EAAE,qGAAqG;QAClH,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gDAAgD,EAAE;gBACxF,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+BAA+B,EAAE,OAAO,EAAE,EAAE,EAAE;aACrF;YACD,QAAQ,EAAE,CAAC,OAAO,CAAC;SACpB;QACD,IAAI,EAAE,MAAM;QACZ,KAAK,CAAC,OAAO,CAAC,KAAwC;YACpD,IAAI,CAAC,KAAK,CAAC,cAAc;gBAAE,OAAO,EAAE,CAAC;YACrC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;YAC5E,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC1B,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;gBAClC,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;gBAChC,SAAS,EAAE,CAAC,CAAC,SAAS;aACvB,CAAC,CAAC,CAAC;QACN,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/knowledge/types.d.ts

@@ -0,0 +1,27 @@
+export type MemoryTier = "working" | "session" | "long-term";
+export interface MemoryItem {
+    id: string;
+    sessionId: string;
+    tier: MemoryTier;
+    key: string;
+    value: string;
+    tags: string[];
+    createdAt: string;
+    updatedAt: string;
+}
+export interface Skill {
+    id: string;
+    name: string;
+    description: string;
+    instruction: string;
+    triggers: string[];
+    createdAt: string;
+}
+export interface MemoryStore {
+    get(key: string, sessionId: string): Promise<MemoryItem | undefined>;
+    set(item: Omit<MemoryItem, "id" | "createdAt" | "updatedAt">): Promise<MemoryItem>;
+    delete(key: string, sessionId: string): Promise<void>;
+    search(query: string, sessionId: string): Promise<MemoryItem[]>;
+    listByTier(tier: MemoryTier, sessionId: string): Promise<MemoryItem[]>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/knowledge/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/knowledge/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,CAAC;AAE7D,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,UAAU,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAAC;IACrE,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,GAAG,WAAW,GAAG,WAAW,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACnF,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAChE,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;CACxE"}

package/dist/knowledge/types.js

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

package/dist/knowledge/types.js.map

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

package/dist/logger.d.ts

@@ -0,0 +1,11 @@
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export interface Logger {
+    debug(message: string, ...args: unknown[]): void;
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+}
+export declare function setLogger(newLogger: Logger): void;
+export declare function setLogLevel(level: LogLevel): void;
+export declare function getLogger(): Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACjD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CAClD;AAsCD,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAEjD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAEjD;AAED,wBAAgB,SAAS,IAAI,MAAM,CAElC"}

package/dist/logger.js

@@ -0,0 +1,44 @@
+// Simple logger for agent-core
+// In production, this can be replaced with a proper logger (e.g., @vinhnt-sdk/otel)
+const LOG_LEVELS = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+let currentLevel = 'warn';
+function createConsoleLogger() {
+    return {
+        debug: (message, ...args) => {
+            if (LOG_LEVELS[currentLevel] <= LOG_LEVELS.debug) {
+                console.debug(`[DEBUG] ${message}`, ...args);
+            }
+        },
+        info: (message, ...args) => {
+            if (LOG_LEVELS[currentLevel] <= LOG_LEVELS.info) {
+                console.info(`[INFO] ${message}`, ...args);
+            }
+        },
+        warn: (message, ...args) => {
+            if (LOG_LEVELS[currentLevel] <= LOG_LEVELS.warn) {
+                console.warn(`[WARN] ${message}`, ...args);
+            }
+        },
+        error: (message, ...args) => {
+            if (LOG_LEVELS[currentLevel] <= LOG_LEVELS.error) {
+                console.error(`[ERROR] ${message}`, ...args);
+            }
+        },
+    };
+}
+let logger = createConsoleLogger();
+export function setLogger(newLogger) {
+    logger = newLogger;
+}
+export function setLogLevel(level) {
+    currentLevel = level;
+}
+export function getLogger() {
+    return logger;
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,oFAAoF;AAWpF,MAAM,UAAU,GAA6B;IAC3C,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;CACT,CAAC;AAEF,IAAI,YAAY,GAAa,MAAM,CAAC;AAEpC,SAAS,mBAAmB;IAC1B,OAAO;QACL,KAAK,EAAE,CAAC,OAAO,EAAE,GAAG,IAAI,EAAE,EAAE;YAC1B,IAAI,UAAU,CAAC,YAAY,CAAC,IAAI,UAAU,CAAC,KAAK,EAAE,CAAC;gBACjD,OAAO,CAAC,KAAK,CAAC,WAAW,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;YAC/C,CAAC;QACH,CAAC;QACD,IAAI,EAAE,CAAC,OAAO,EAAE,GAAG,IAAI,EAAE,EAAE;YACzB,IAAI,UAAU,CAAC,YAAY,CAAC,IAAI,UAAU,CAAC,IAAI,EAAE,CAAC;gBAChD,OAAO,CAAC,IAAI,CAAC,UAAU,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;YAC7C,CAAC;QACH,CAAC;QACD,IAAI,EAAE,CAAC,OAAO,EAAE,GAAG,IAAI,EAAE,EAAE;YACzB,IAAI,UAAU,CAAC,YAAY,CAAC,IAAI,UAAU,CAAC,IAAI,EAAE,CAAC;gBAChD,OAAO,CAAC,IAAI,CAAC,UAAU,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;YAC7C,CAAC;QACH,CAAC;QACD,KAAK,EAAE,CAAC,OAAO,EAAE,GAAG,IAAI,EAAE,EAAE;YAC1B,IAAI,UAAU,CAAC,YAAY,CAAC,IAAI,UAAU,CAAC,KAAK,EAAE,CAAC;gBACjD,OAAO,CAAC,KAAK,CAAC,WAAW,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;YAC/C,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED,IAAI,MAAM,GAAW,mBAAmB,EAAE,CAAC;AAE3C,MAAM,UAAU,SAAS,CAAC,SAAiB;IACzC,MAAM,GAAG,SAAS,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAe;IACzC,YAAY,GAAG,KAAK,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/model.d.ts

@@ -0,0 +1,90 @@
+import type { ToolDefinition } from "./tool/definitions.js";
+export interface ToolCall {
+    readonly id: string;
+    readonly name: string;
+    readonly args: Record<string, unknown>;
+}
+export type MessageContentPart = {
+    type: "text";
+    text: string;
+} | {
+    type: "image";
+    image: string;
+    mimeType?: string;
+};
+export interface ChatMessage {
+    readonly role: string;
+    readonly content: string;
+    readonly contentParts?: readonly MessageContentPart[];
+    readonly toolCallId?: string;
+    readonly toolCalls?: readonly ToolCall[];
+}
+export interface ModelRequest {
+    readonly messages: readonly ChatMessage[];
+    readonly tools: readonly ToolDefinition[];
+    readonly maxTokens?: number;
+    readonly thinkingBudget?: number;
+    readonly thinkingPrompt?: string;
+}
+export interface ModelResponse {
+    readonly content: string;
+    readonly toolCalls?: readonly {
+        id: string;
+        name: string;
+        args: unknown;
+    }[];
+    readonly usage?: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+}
+export type ModelStreamEvent = {
+    type: "text";
+    content: string;
+} | {
+    type: "tool_call";
+    id: string;
+    name: string;
+    args: Record<string, unknown>;
+} | {
+    type: "usage";
+    inputTokens: number;
+    outputTokens: number;
+} | {
+    type: "done";
+} | {
+    type: "error";
+    error: string;
+};
+export interface ModelPricing {
+    readonly input: number;
+    readonly output: number;
+    readonly cacheRead?: number;
+    readonly cacheWrite?: number;
+}
+export interface ModelProvider {
+    readonly model?: string;
+    readonly contextLimit: number | undefined;
+    generate(request: ModelRequest, signal?: AbortSignal): Promise<ModelResponse>;
+    stream?(request: ModelRequest, signal?: AbortSignal): AsyncIterable<ModelStreamEvent>;
+    countTokens?(text: string): number;
+    readonly pricing?: ModelPricing;
+}
+export interface ModelRegistry {
+    register(id: string, provider: ModelProvider): void;
+    get(id: string): ModelProvider | undefined;
+    list(): readonly {
+        id: string;
+        provider: ModelProvider;
+    }[];
+}
+export declare class InMemoryModelRegistry implements ModelRegistry {
+    private readonly providers;
+    register(id: string, provider: ModelProvider): void;
+    get(id: string): ModelProvider | undefined;
+    list(): readonly {
+        id: string;
+        provider: ModelProvider;
+    }[];
+}
+//# sourceMappingURL=model.d.ts.map

package/dist/model.d.ts.map

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

package/dist/model.js

@@ -0,0 +1,13 @@
+export class InMemoryModelRegistry {
+    providers = new Map();
+    register(id, provider) {
+        this.providers.set(id, provider);
+    }
+    get(id) {
+        return this.providers.get(id);
+    }
+    list() {
+        return [...this.providers.entries()].map(([id, provider]) => ({ id, provider }));
+    }
+}
+//# sourceMappingURL=model.js.map

package/dist/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"AA+DA,MAAM,OAAO,qBAAqB;IACf,SAAS,GAAG,IAAI,GAAG,EAAyB,CAAC;IAE9D,QAAQ,CAAC,EAAU,EAAE,QAAuB;QAC1C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;IACnC,CAAC;IAED,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChC,CAAC;IAED,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;IACnF,CAAC;CACF"}

package/dist/permission/checker.d.ts

@@ -0,0 +1,29 @@
+import type { AgentConfig, AgentRuleset, AgentPermissions } from "@vinhnt-sdk/schema";
+export type PermissionResult = {
+    decision: "allow";
+} | {
+    decision: "deny";
+    reason: string;
+} | {
+    decision: "ask";
+    reason: string;
+};
+export declare function normalizePermissions(p: AgentPermissions | undefined): AgentRuleset;
+export declare function mergeRulesets(child: AgentRuleset, parent: AgentRuleset): AgentRuleset;
+export declare function resolveEffectivePermissions(agent: AgentConfig, ancestors?: AgentConfig[]): AgentRuleset;
+/**
+ * Evaluate a resource against a ruleset.
+ *
+ * Semantics (matching OpenCode's findLast):
+ * - Rules are evaluated in order; last matching rule wins.
+ * - "deny" blocks access.
+ * - "ask" triggers human-in-the-loop.
+ * - "allow" permits access.
+ * - If no rule matches, the default is "ask" (safe default).
+ *
+ * When `paramPattern` is set on a rule, the rule only matches if
+ * the JSON-stringified tool args also match the paramPattern glob.
+ */
+export declare function evaluatePermission(ruleset: AgentRuleset | undefined, resource: string, args?: Record<string, unknown>): PermissionResult;
+export declare function checkRiskAllowed(ruleset: AgentRuleset | undefined, risk: string): boolean;
+//# sourceMappingURL=checker.d.ts.map