@vinhnt-sdk/core 0.1.0

package/dist/kernel/tool-saga.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-saga.d.ts","sourceRoot":"","sources":["../../src/kernel/tool-saga.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,SAAS,CAAC;IACjB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B;AAID,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkC;IACxD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAyC;IACvE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;IAEhD,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAM9B,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,GAAG,IAAI;IAItE,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,EAAE;IAQhC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBzC,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAOlC,KAAK,IAAI,IAAI;CAKd"}

package/dist/kernel/tool-saga.js

@@ -0,0 +1,59 @@
+const COMPENSATION_TIMEOUT = 5_000;
+export class ToolSaga {
+    steps = new Map();
+    compensations = new Map();
+    rolledBack = new Set();
+    record(entry) {
+        const entries = this.steps.get(entry.step) ?? [];
+        entries.push(entry);
+        this.steps.set(entry.step, entries);
+    }
+    registerCompensation(toolId, action) {
+        this.compensations.set(toolId, action);
+    }
+    getEntries(step) {
+        if (step !== undefined)
+            return this.steps.get(step) ?? [];
+        const all = [];
+        const sorted = [...this.steps.keys()].sort((a, b) => b - a);
+        for (const s of sorted)
+            all.push(...(this.steps.get(s) ?? []));
+        return all;
+    }
+    async rollbackStep(step) {
+        const entries = this.steps.get(step);
+        if (!entries)
+            return;
+        for (let i = entries.length - 1; i >= 0; i--) {
+            const entry = entries[i];
+            if (this.rolledBack.has(entry.toolId))
+                continue;
+            const action = this.compensations.get(entry.toolId);
+            if (action) {
+                try {
+                    await Promise.race([
+                        action.compensate(),
+                        new Promise((_, reject) => setTimeout(() => reject(new Error("Compensation timed out")), COMPENSATION_TIMEOUT)),
+                    ]);
+                }
+                catch (err) {
+                    console.warn(`[saga] Compensation failed for ${entry.toolName}(${entry.toolId}):`, err);
+                }
+            }
+            this.rolledBack.add(entry.toolId);
+        }
+        this.steps.delete(step);
+    }
+    async rollbackAll() {
+        const sorted = [...this.steps.keys()].sort((a, b) => b - a);
+        for (const step of sorted) {
+            await this.rollbackStep(step);
+        }
+    }
+    clear() {
+        this.steps.clear();
+        this.compensations.clear();
+        this.rolledBack.clear();
+    }
+}
+//# sourceMappingURL=tool-saga.js.map

package/dist/kernel/tool-saga.js.map

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

package/dist/knowledge/approval.d.ts

@@ -0,0 +1,19 @@
+import type { ApprovalRequest } from "@vinhnt-sdk/schema";
+export interface ApprovalHandler {
+    requestApproval(req: Omit<ApprovalRequest, "id" | "requestedAt" | "status">): Promise<ApprovalRequest>;
+    approve(id: string, resolvedBy?: string): Promise<ApprovalRequest | undefined>;
+    reject(id: string, resolvedBy?: string): Promise<ApprovalRequest | undefined>;
+    listPending(): ApprovalRequest[];
+    getRequest(id: string): ApprovalRequest | undefined;
+}
+export declare class WriteApprovalQueue implements ApprovalHandler {
+    private requests;
+    requestApproval(req: Omit<ApprovalRequest, "id" | "requestedAt" | "status">): Promise<ApprovalRequest>;
+    approve(id: string, resolvedBy?: string): Promise<ApprovalRequest | undefined>;
+    reject(id: string, resolvedBy?: string): Promise<ApprovalRequest | undefined>;
+    listPending(): ApprovalRequest[];
+    getRequest(id: string): ApprovalRequest | undefined;
+    /** Mark expired requests — returns count expired */
+    expirePending(): number;
+}
+//# sourceMappingURL=approval.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"approval.d.ts","sourceRoot":"","sources":["../../src/knowledge/approval.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,MAAM,WAAW,eAAe;IAC9B,eAAe,CAAC,GAAG,EAAE,IAAI,CAAC,eAAe,EAAE,IAAI,GAAG,aAAa,GAAG,QAAQ,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IACvG,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CAAC;IAC/E,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CAAC;IAC9E,WAAW,IAAI,eAAe,EAAE,CAAC;IACjC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAAC;CACrD;AAED,qBAAa,kBAAmB,YAAW,eAAe;IACxD,OAAO,CAAC,QAAQ,CAAyB;IAEnC,eAAe,CACnB,GAAG,EAAE,IAAI,CAAC,eAAe,EAAE,IAAI,GAAG,aAAa,GAAG,QAAQ,CAAC,GAC1D,OAAO,CAAC,eAAe,CAAC;IAWrB,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC;IAa9E,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC;IAanF,WAAW,IAAI,eAAe,EAAE;IAIhC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAInD,oDAAoD;IACpD,aAAa,IAAI,MAAM;CAYxB"}

package/dist/knowledge/approval.js

@@ -0,0 +1,60 @@
+import { randomUUID } from "node:crypto";
+export class WriteApprovalQueue {
+    requests = [];
+    async requestApproval(req) {
+        const request = {
+            ...req,
+            id: randomUUID(),
+            requestedAt: new Date().toISOString(),
+            status: "pending",
+        };
+        this.requests.push(request);
+        return request;
+    }
+    async approve(id, resolvedBy) {
+        const idx = this.requests.findIndex((r) => r.id === id && r.status === "pending");
+        if (idx === -1)
+            return undefined;
+        const req = {
+            ...this.requests[idx],
+            status: "approved",
+            resolvedAt: new Date().toISOString(),
+            ...(resolvedBy ? { resolvedBy } : {}),
+        };
+        this.requests[idx] = req;
+        return req;
+    }
+    async reject(id, resolvedBy) {
+        const idx = this.requests.findIndex((r) => r.id === id && r.status === "pending");
+        if (idx === -1)
+            return undefined;
+        const req = {
+            ...this.requests[idx],
+            status: "rejected",
+            resolvedAt: new Date().toISOString(),
+            ...(resolvedBy ? { resolvedBy } : {}),
+        };
+        this.requests[idx] = req;
+        return req;
+    }
+    listPending() {
+        return this.requests.filter((r) => r.status === "pending");
+    }
+    getRequest(id) {
+        return this.requests.find((r) => r.id === id);
+    }
+    /** Mark expired requests — returns count expired */
+    expirePending() {
+        const now = Date.now();
+        let count = 0;
+        for (let i = 0; i < this.requests.length; i++) {
+            const r = this.requests[i];
+            if (r.status === "pending" && r.expiresAt && new Date(r.expiresAt).getTime() <= now) {
+                this.requests[i] = { ...r, status: "expired", resolvedAt: new Date().toISOString() };
+                count++;
+            }
+        }
+        return count;
+    }
+}
+//# sourceMappingURL=approval.js.map

package/dist/knowledge/approval.js.map

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

package/dist/knowledge/compressor.d.ts

@@ -0,0 +1,46 @@
+import type { CompressionSummary } from "@vinhnt-sdk/schema";
+import type { ChatMessage } from "../model.js";
+import type { ConversationCompactor } from "../session/compaction.js";
+export interface CompressorOptions {
+    /** Always protect this many messages at start */
+    readonly headCount: number;
+    /** Always protect this many messages at end */
+    readonly tailCount: number;
+    /** Truncate tool output beyond this length (0 = no truncation) */
+    readonly maxToolOutputLength: number;
+    /** Token budget — if exceeded, force compression */
+    readonly tokenBudget: number;
+    /** Approximate tokens per character */
+    readonly charsPerToken: number;
+}
+export declare class ContextCompressor implements ConversationCompactor {
+    private opts;
+    constructor(opts?: Partial<CompressorOptions>);
+    /**
+     * Phase 1: Prune verbose old tool outputs.
+     */
+    pruneToolOutputs(messages: readonly ChatMessage[]): readonly ChatMessage[];
+    /**
+     * Determine if compression is needed based on token budget.
+     */
+    needsCompression(messages: readonly ChatMessage[]): boolean;
+    /**
+     * Compress middle messages (head/tail protection + naive summarization).
+     * Implements ConversationCompactor.
+     */
+    compact(messages: readonly ChatMessage[], _signal?: AbortSignal): Promise<{
+        messages: readonly ChatMessage[];
+        summary: CompressionSummary;
+    }>;
+    /**
+     * Phase 2-4: Synchronous compress.
+     * - Protects headCount messages at start
+     * - Protects tailCount messages at end
+     * - Summarizes middle portion
+     */
+    compress(messages: readonly ChatMessage[]): {
+        messages: readonly ChatMessage[];
+        summary: CompressionSummary;
+    };
+}
+//# sourceMappingURL=compressor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compressor.d.ts","sourceRoot":"","sources":["../../src/knowledge/compressor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAEtE,MAAM,WAAW,iBAAiB;IAChC,iDAAiD;IACjD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,+CAA+C;IAC/C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,kEAAkE;IAClE,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,oDAAoD;IACpD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,uCAAuC;IACvC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAoBD,qBAAa,iBAAkB,YAAW,qBAAqB;IAC7D,OAAO,CAAC,IAAI,CAAoB;gBAEpB,IAAI,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC;IAI7C;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,GAAG,SAAS,WAAW,EAAE;IAI1E;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,GAAG,OAAO;IAK3D;;;OAGG;IACG,OAAO,CACX,QAAQ,EAAE,SAAS,WAAW,EAAE,EAChC,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC;QAAE,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;QAAC,OAAO,EAAE,kBAAkB,CAAA;KAAE,CAAC;IAI7E;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,GAAG;QAC1C,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;QACjC,OAAO,EAAE,kBAAkB,CAAC;KAC7B;CAyCF"}

package/dist/knowledge/compressor.js

@@ -0,0 +1,86 @@
+const DEFAULT_OPTS = {
+    headCount: 3,
+    tailCount: 20,
+    maxToolOutputLength: 500,
+    tokenBudget: 32000,
+    charsPerToken: 4,
+};
+function approximateTokens(text, charsPerToken = 4) {
+    return Math.ceil(text.length / charsPerToken);
+}
+function truncateToolOutput(msg, maxLen) {
+    if (msg.role !== "tool")
+        return msg;
+    if (msg.content.length <= maxLen)
+        return msg;
+    return { ...msg, content: msg.content.slice(0, maxLen) + "... [truncated]" };
+}
+export class ContextCompressor {
+    opts;
+    constructor(opts) {
+        this.opts = { ...DEFAULT_OPTS, ...opts };
+    }
+    /**
+     * Phase 1: Prune verbose old tool outputs.
+     */
+    pruneToolOutputs(messages) {
+        return messages.map((m) => truncateToolOutput(m, this.opts.maxToolOutputLength));
+    }
+    /**
+     * Determine if compression is needed based on token budget.
+     */
+    needsCompression(messages) {
+        const total = messages.reduce((sum, m) => sum + approximateTokens(m.content, this.opts.charsPerToken), 0);
+        return total > this.opts.tokenBudget;
+    }
+    /**
+     * Compress middle messages (head/tail protection + naive summarization).
+     * Implements ConversationCompactor.
+     */
+    async compact(messages, _signal) {
+        return this.compress(messages);
+    }
+    /**
+     * Phase 2-4: Synchronous compress.
+     * - Protects headCount messages at start
+     * - Protects tailCount messages at end
+     * - Summarizes middle portion
+     */
+    compress(messages) {
+        const originalCount = messages.length;
+        const pruned = this.pruneToolOutputs(messages);
+        if (pruned.length <= this.opts.headCount + this.opts.tailCount) {
+            return {
+                messages: pruned,
+                summary: {
+                    originalMessageCount: originalCount,
+                    compressedMessageCount: pruned.length,
+                    summary: undefined,
+                },
+            };
+        }
+        const head = pruned.slice(0, this.opts.headCount);
+        const tail = pruned.slice(-this.opts.tailCount);
+        const middle = pruned.slice(this.opts.headCount, -this.opts.tailCount);
+        const middleContent = middle
+            .map((m) => `[${m.role}] ${m.content.slice(0, 200)}`)
+            .join("\n");
+        const summary = middle.length > 0
+            ? `[Compressed ${middle.length} messages] ${middleContent.slice(0, 1000)}`
+            : undefined;
+        const result = [
+            ...head,
+            ...(summary ? [{ role: "system", content: `--- compressed context: ${summary.slice(0, 300)} ---` }] : []),
+            ...tail,
+        ];
+        return {
+            messages: result,
+            summary: {
+                originalMessageCount: originalCount,
+                compressedMessageCount: result.length,
+                summary,
+            },
+        };
+    }
+}
+//# sourceMappingURL=compressor.js.map

package/dist/knowledge/compressor.js.map

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

package/dist/knowledge/index.d.ts

@@ -0,0 +1,16 @@
+export { InMemoryMemoryStore, SessionMemory } from "./memory.js";
+export { BoundedMemory } from "./memory-bounded.js";
+export type { BoundedMemoryLimits } from "./memory-bounded.js";
+export { ContextCompressor } from "./compressor.js";
+export { LlmCompactor } from "./llm-compactor.js";
+export { WriteApprovalQueue } from "./approval.js";
+export { BackgroundReview } from "./review.js";
+export { LearningEngine } from "./learning-engine.js";
+export { createMemorySearchTool } from "./tool.js";
+export { buildPrompt } from "./prompt-builder.js";
+export type { MemoryItem, MemoryStore, MemoryTier, Skill } from "./types.js";
+export type { CompressorOptions } from "./compressor.js";
+export type { ReviewOptions } from "./review.js";
+export type { PromptBuilderOptions } from "./prompt-builder.js";
+export type { ApprovalHandler } from "./approval.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/knowledge/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAC7E,YAAY,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,YAAY,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAChE,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}

package/dist/knowledge/index.js

@@ -0,0 +1,10 @@
+export { InMemoryMemoryStore, SessionMemory } from "./memory.js";
+export { BoundedMemory } from "./memory-bounded.js";
+export { ContextCompressor } from "./compressor.js";
+export { LlmCompactor } from "./llm-compactor.js";
+export { WriteApprovalQueue } from "./approval.js";
+export { BackgroundReview } from "./review.js";
+export { LearningEngine } from "./learning-engine.js";
+export { createMemorySearchTool } from "./tool.js";
+export { buildPrompt } from "./prompt-builder.js";
+//# sourceMappingURL=index.js.map

package/dist/knowledge/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/knowledge/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/knowledge/learning-engine.d.ts

@@ -0,0 +1,47 @@
+interface LearningConfig {
+    enabled: boolean;
+    backgroundReview: boolean;
+    memoryWriteApproval: boolean;
+    skillWriteApproval: boolean;
+    memoryCharLimit: number;
+    userCharLimit: number;
+}
+import { BoundedMemory } from "./memory-bounded.js";
+import { WriteApprovalQueue } from "./approval.js";
+import { ContextCompressor } from "./compressor.js";
+import type { MemoryEntry } from "@vinhnt-sdk/schema";
+export interface LearningEngineOptions {
+    readonly config: LearningConfig;
+    readonly sessionId: string;
+}
+export declare class LearningEngine {
+    private config;
+    private store;
+    private boundedMem;
+    private approvalQueue;
+    private review;
+    private compressor;
+    private enabled;
+    constructor(options: LearningEngineOptions);
+    get isEnabled(): boolean;
+    setEnabled(val: boolean): void;
+    getBoundedMemory(): BoundedMemory;
+    getApprovalQueue(): WriteApprovalQueue;
+    getCompressor(): ContextCompressor;
+    buildMemoryBlock(): MemoryEntry[];
+    processTurn(messages: {
+        role: string;
+        content: string;
+    }[]): Promise<{
+        extracted: number;
+        staged: number;
+    }>;
+    getPendingApprovals(): import("@vinhnt-sdk/schema").ApprovalRequest[];
+    approveMemory(id: string): Promise<boolean>;
+    rejectMemory(id: string): Promise<boolean>;
+    setProfile(value: string): Promise<void>;
+    setWorkingFact(key: string, value: string): Promise<void>;
+    clearWorking(): void;
+}
+export {};
+//# sourceMappingURL=learning-engine.d.ts.map

package/dist/knowledge/learning-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"learning-engine.d.ts","sourceRoot":"","sources":["../../src/knowledge/learning-engine.ts"],"names":[],"mappings":"AAAA,UAAU,cAAc;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;CACvB;AACD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,UAAU,CAAgB;IAClC,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,UAAU,CAAoB;IACtC,OAAO,CAAC,OAAO,CAAU;gBAEb,OAAO,EAAE,qBAAqB;IAkB1C,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI;IAI9B,gBAAgB,IAAI,aAAa;IAIjC,gBAAgB,IAAI,kBAAkB;IAItC,aAAa,IAAI,iBAAiB;IAIlC,gBAAgB,IAAI,WAAW,EAAE;IAI3B,WAAW,CACf,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,GAC5C,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAajD,mBAAmB;IAIb,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAU3C,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAK1C,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxC,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/D,YAAY,IAAI,IAAI;CAGrB"}

package/dist/knowledge/learning-engine.js

@@ -0,0 +1,83 @@
+import { BoundedMemory } from "./memory-bounded.js";
+import { BackgroundReview } from "./review.js";
+import { WriteApprovalQueue } from "./approval.js";
+import { ContextCompressor } from "./compressor.js";
+import { InMemoryMemoryStore } from "./memory.js";
+export class LearningEngine {
+    config;
+    store;
+    boundedMem;
+    approvalQueue;
+    review;
+    compressor;
+    enabled;
+    constructor(options) {
+        this.config = options.config;
+        this.enabled = options.config.enabled;
+        this.store = new InMemoryMemoryStore();
+        this.boundedMem = new BoundedMemory(this.store, {
+            profileLimit: options.config.userCharLimit,
+            workingLimit: options.config.memoryCharLimit,
+        });
+        this.approvalQueue = new WriteApprovalQueue();
+        this.review = new BackgroundReview(options.sessionId, this.boundedMem, this.store, this.approvalQueue);
+        this.compressor = new ContextCompressor();
+    }
+    get isEnabled() {
+        return this.enabled;
+    }
+    setEnabled(val) {
+        this.enabled = val;
+    }
+    getBoundedMemory() {
+        return this.boundedMem;
+    }
+    getApprovalQueue() {
+        return this.approvalQueue;
+    }
+    getCompressor() {
+        return this.compressor;
+    }
+    buildMemoryBlock() {
+        return this.boundedMem.getAllBounded();
+    }
+    async processTurn(messages) {
+        if (!this.enabled || !this.config.backgroundReview) {
+            return { extracted: 0, staged: 0 };
+        }
+        const result = await this.review.reviewTurn(messages, {
+            requireApproval: this.config.memoryWriteApproval,
+        });
+        return {
+            extracted: result.extracted.length,
+            staged: this.approvalQueue.listPending().length,
+        };
+    }
+    getPendingApprovals() {
+        return this.approvalQueue.listPending();
+    }
+    async approveMemory(id) {
+        const req = await this.approvalQueue.approve(id);
+        if (!req)
+            return false;
+        const payload = req.payload;
+        if (payload.key && payload.value !== undefined) {
+            await this.boundedMem.setWorkingFact(payload.key, payload.value);
+        }
+        return true;
+    }
+    async rejectMemory(id) {
+        const req = await this.approvalQueue.reject(id);
+        return req !== undefined;
+    }
+    async setProfile(value) {
+        await this.boundedMem.setProfile(value);
+    }
+    async setWorkingFact(key, value) {
+        await this.boundedMem.setWorkingFact(key, value);
+    }
+    clearWorking() {
+        this.boundedMem.clearWorking();
+    }
+}
+//# sourceMappingURL=learning-engine.js.map

package/dist/knowledge/learning-engine.js.map

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

package/dist/knowledge/llm-compactor.d.ts

@@ -0,0 +1,25 @@
+import type { CompressionSummary } from "@vinhnt-sdk/schema";
+import type { ChatMessage, ModelProvider } from "../model.js";
+import type { ConversationCompactor } from "../session/compaction.js";
+export interface LlmCompactorOptions {
+    /** Always protect this many messages at start */
+    readonly headCount: number;
+    /** Always protect this many messages at end */
+    readonly tailCount: number;
+    /** Token budget — if exceeded, force compression */
+    readonly tokenBudget: number;
+    /** Approximate tokens per character (for budget check) */
+    readonly charsPerToken: number;
+    /** System prompt for summarization */
+    readonly summaryPrompt: string;
+}
+export declare class LlmCompactor implements ConversationCompactor {
+    private readonly model;
+    private readonly opts;
+    constructor(model: ModelProvider, opts?: Partial<LlmCompactorOptions>);
+    compact(messages: readonly ChatMessage[], signal?: AbortSignal): Promise<{
+        messages: readonly ChatMessage[];
+        summary: CompressionSummary;
+    }>;
+}
+//# sourceMappingURL=llm-compactor.d.ts.map

package/dist/knowledge/llm-compactor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-compactor.d.ts","sourceRoot":"","sources":["../../src/knowledge/llm-compactor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAEtE,MAAM,WAAW,mBAAmB;IAClC,iDAAiD;IACjD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,+CAA+C;IAC/C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,oDAAoD;IACpD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,0DAA0D;IAC1D,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,sCAAsC;IACtC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAiBD,qBAAa,YAAa,YAAW,qBAAqB;IACxD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IACtC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAsB;gBAE/B,KAAK,EAAE,aAAa,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC;IAK/D,OAAO,CACX,QAAQ,EAAE,SAAS,WAAW,EAAE,EAChC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC;QAAE,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;QAAC,OAAO,EAAE,kBAAkB,CAAA;KAAE,CAAC;CAwE9E"}

package/dist/knowledge/llm-compactor.js

@@ -0,0 +1,79 @@
+const DEFAULT_OPTS = {
+    headCount: 3,
+    tailCount: 20,
+    tokenBudget: 32000,
+    charsPerToken: 4,
+    summaryPrompt: "Summarize the following conversation history concisely. " +
+        "Preserve key decisions, tool results, user requirements, and any important context. " +
+        "Output only the summary, no preamble.",
+};
+function approximateTokens(text, charsPerToken) {
+    return Math.ceil(text.length / charsPerToken);
+}
+export class LlmCompactor {
+    model;
+    opts;
+    constructor(model, opts) {
+        this.model = model;
+        this.opts = { ...DEFAULT_OPTS, ...opts };
+    }
+    async compact(messages, signal) {
+        const originalCount = messages.length;
+        if (messages.length <= this.opts.headCount + this.opts.tailCount) {
+            return {
+                messages,
+                summary: {
+                    originalMessageCount: originalCount,
+                    compressedMessageCount: originalCount,
+                    summary: undefined,
+                },
+            };
+        }
+        const totalTokens = messages.reduce((sum, m) => sum + approximateTokens(m.content, this.opts.charsPerToken), 0);
+        if (totalTokens <= this.opts.tokenBudget) {
+            return {
+                messages,
+                summary: {
+                    originalMessageCount: originalCount,
+                    compressedMessageCount: originalCount,
+                    summary: undefined,
+                },
+            };
+        }
+        const head = messages.slice(0, this.opts.headCount);
+        const tail = messages.slice(-this.opts.tailCount);
+        const middle = messages.slice(this.opts.headCount, -this.opts.tailCount);
+        const middleText = middle
+            .map((m) => {
+            const roleLabel = m.role === "tool" ? `tool result (${m.toolCallId ?? "?"})` : m.role;
+            return `[${roleLabel}] ${m.content}`;
+        })
+            .join("\n\n");
+        const llmResponse = await this.model.generate({
+            messages: [
+                { role: "system", content: this.opts.summaryPrompt },
+                { role: "user", content: middleText },
+            ],
+            tools: [],
+            maxTokens: 1024,
+        }, signal);
+        const compactedContent = llmResponse.content.trim() || "(summary unavailable)";
+        const result = [
+            ...head,
+            {
+                role: "system",
+                content: `--- compressed context: ${compactedContent} ---`,
+            },
+            ...tail,
+        ];
+        return {
+            messages: result,
+            summary: {
+                originalMessageCount: originalCount,
+                compressedMessageCount: result.length,
+                summary: compactedContent,
+            },
+        };
+    }
+}
+//# sourceMappingURL=llm-compactor.js.map

package/dist/knowledge/llm-compactor.js.map

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

package/dist/knowledge/memory-bounded.d.ts

@@ -0,0 +1,21 @@
+import type { MemoryEntry } from "@vinhnt-sdk/schema";
+import type { MemoryStore } from "./types.js";
+export interface BoundedMemoryLimits {
+    profileLimit: number;
+    workingLimit: number;
+}
+export declare class BoundedMemory {
+    private profile;
+    private working;
+    private store;
+    private limits;
+    constructor(store?: MemoryStore, limits?: Partial<BoundedMemoryLimits>);
+    setProfile(value: string): Promise<MemoryEntry>;
+    getProfile(): MemoryEntry;
+    setWorkingFact(key: string, value: string): Promise<MemoryEntry>;
+    getWorking(): string;
+    clearWorking(): void;
+    getAllBounded(): MemoryEntry[];
+    totalChars(): number;
+}
+//# sourceMappingURL=memory-bounded.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory-bounded.d.ts","sourceRoot":"","sources":["../../src/knowledge/memory-bounded.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG9C,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB;AAYD,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAM;IACrB,OAAO,CAAC,OAAO,CAAM;IACrB,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,MAAM,CAAsB;gBAExB,KAAK,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC;IAKhE,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAYrD,UAAU,IAAI,WAAW;IAInB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IActE,UAAU,IAAI,MAAM;IAIpB,YAAY,IAAI,IAAI;IAIpB,aAAa,IAAI,WAAW,EAAE;IAO9B,UAAU,IAAI,MAAM;CAGrB"}