context-mem 0.1.0

package/dist/core/observe-queue.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ObserveQueue = void 0;
+const utils_js_1 = require("./utils.js");
+const MAX_QUEUE_SIZE = 500;
+const BATCH_SIZE = 50;
+const DEDUP_WINDOW_MS = 60_000;
+class ObserveQueue {
+    queue = [];
+    dedupMap = new Map(); // hash → timestamp
+    onFlush;
+    flushing = false;
+    constructor(onFlush) {
+        this.onFlush = onFlush;
+    }
+    async enqueue(item) {
+        const hash = (0, utils_js_1.fnv1a64)(item.content);
+        const now = Date.now();
+        // Dedup check
+        const lastSeen = this.dedupMap.get(hash);
+        if (lastSeen !== undefined && (now - lastSeen) < DEDUP_WINDOW_MS) {
+            return false; // Duplicate
+        }
+        // Clean old dedup entries
+        for (const [key, ts] of this.dedupMap) {
+            if (now - ts >= DEDUP_WINDOW_MS)
+                this.dedupMap.delete(key);
+        }
+        this.dedupMap.set(hash, now);
+        this.queue.push(item);
+        // Evict oldest if over capacity
+        if (this.queue.length > MAX_QUEUE_SIZE) {
+            this.queue.shift();
+        }
+        // Auto-flush at batch size
+        if (this.queue.length >= BATCH_SIZE) {
+            await this.flush();
+        }
+        return true;
+    }
+    async flush() {
+        if (this.flushing || this.queue.length === 0)
+            return;
+        this.flushing = true;
+        try {
+            const items = this.queue.splice(0);
+            await this.onFlush(items);
+        }
+        finally {
+            this.flushing = false;
+        }
+    }
+    get size() { return this.queue.length; }
+}
+exports.ObserveQueue = ObserveQueue;
+//# sourceMappingURL=observe-queue.js.map

package/dist/core/observe-queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observe-queue.js","sourceRoot":"","sources":["../../src/core/observe-queue.ts"],"names":[],"mappings":";;;AAAA,yCAAqC;AAUrC,MAAM,cAAc,GAAG,GAAG,CAAC;AAC3B,MAAM,UAAU,GAAG,EAAE,CAAC;AACtB,MAAM,eAAe,GAAG,MAAM,CAAC;AAE/B,MAAa,YAAY;IACf,KAAK,GAAgB,EAAE,CAAC;IACxB,QAAQ,GAAwB,IAAI,GAAG,EAAE,CAAC,CAAC,mBAAmB;IAC9D,OAAO,CAAwC;IAC/C,QAAQ,GAAG,KAAK,CAAC;IAEzB,YAAY,OAA8C;QACxD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAAe;QAC3B,MAAM,IAAI,GAAG,IAAA,kBAAO,EAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACnC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEvB,cAAc;QACd,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,QAAQ,KAAK,SAAS,IAAI,CAAC,GAAG,GAAG,QAAQ,CAAC,GAAG,eAAe,EAAE,CAAC;YACjE,OAAO,KAAK,CAAC,CAAC,YAAY;QAC5B,CAAC;QAED,0BAA0B;QAC1B,KAAK,MAAM,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACtC,IAAI,GAAG,GAAG,EAAE,IAAI,eAAe;gBAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC7B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEtB,gCAAgC;QAChC,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,cAAc,EAAE,CAAC;YACvC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACrB,CAAC;QAED,2BAA2B;QAC3B,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,UAAU,EAAE,CAAC;YACpC,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;QACrB,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QACrD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACnC,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;QACxB,CAAC;IACH,CAAC;IAED,IAAI,IAAI,KAAa,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;CACjD;AArDD,oCAqDC"}

package/dist/core/pipeline.d.ts

@@ -0,0 +1,15 @@
+import type { Observation, StoragePlugin, ObservationType } from './types.js';
+import { PluginRegistry } from './plugin-registry.js';
+import { PrivacyEngine } from '../plugins/privacy/privacy-engine.js';
+import type { BudgetManager } from './budget.js';
+export declare class Pipeline {
+    private registry;
+    private storage;
+    private privacy;
+    private sessionId;
+    private budgetManager?;
+    constructor(registry: PluginRegistry, storage: StoragePlugin, privacy: PrivacyEngine, sessionId: string);
+    setBudgetManager(budget: BudgetManager): void;
+    observe(content: string, type: ObservationType, source: string, filePath?: string): Promise<Observation>;
+}
+//# sourceMappingURL=pipeline.d.ts.map

package/dist/core/pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/core/pipeline.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAoB,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAChG,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAGrE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,qBAAa,QAAQ;IAIjB,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,SAAS;IANnB,OAAO,CAAC,aAAa,CAAC,CAAgB;gBAG5B,QAAQ,EAAE,cAAc,EACxB,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,aAAa,EACtB,SAAS,EAAE,MAAM;IAG3B,gBAAgB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAIvC,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;CA4G/G"}

package/dist/core/pipeline.js

@@ -0,0 +1,114 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Pipeline = void 0;
+const node_crypto_1 = require("node:crypto");
+const truncation_js_1 = require("./truncation.js");
+const utils_js_1 = require("./utils.js");
+class Pipeline {
+    registry;
+    storage;
+    privacy;
+    sessionId;
+    budgetManager;
+    constructor(registry, storage, privacy, sessionId) {
+        this.registry = registry;
+        this.storage = storage;
+        this.privacy = privacy;
+        this.sessionId = sessionId;
+    }
+    setBudgetManager(budget) {
+        this.budgetManager = budget;
+    }
+    async observe(content, type, source, filePath) {
+        if (!content || !content.trim()) {
+            throw new Error('Cannot observe empty content');
+        }
+        // 0. Budget check
+        if (this.budgetManager) {
+            const status = this.budgetManager.getStatus(this.sessionId);
+            if (status.blocked) {
+                throw new Error('Budget limit reached — observation blocked');
+            }
+        }
+        // 1. Privacy (fail-closed)
+        const { cleaned, redactions, had_private_tags } = this.privacy.process(content);
+        const privacyLevel = had_private_tags ? 'private' : redactions > 0 ? 'redacted' : 'public';
+        // 2. SHA256 deduplication
+        const contentHash = (0, node_crypto_1.createHash)('sha256').update(cleaned).digest('hex');
+        const existing = this.storage.prepare('SELECT id, type, content, summary, metadata, indexed_at, content_hash FROM observations WHERE content_hash = ?').get(contentHash);
+        if (existing) {
+            let metadata;
+            try {
+                metadata = JSON.parse(existing.metadata);
+            }
+            catch {
+                metadata = { source, tokens_original: 0, tokens_summarized: 0, privacy_level: privacyLevel };
+            }
+            return {
+                id: existing.id,
+                type: existing.type,
+                content: existing.content,
+                summary: (existing.summary ?? undefined),
+                content_hash: existing.content_hash,
+                metadata,
+                indexed_at: existing.indexed_at,
+            };
+        }
+        // 3. Find summarizer
+        const summarizers = this.registry.getAll('summarizer');
+        let summary;
+        let tokensOriginal = (0, utils_js_1.estimateTokens)(cleaned);
+        let tokensSummarized = tokensOriginal;
+        for (const s of summarizers) {
+            if (s.detect(cleaned)) {
+                try {
+                    const result = await s.summarize(cleaned, {});
+                    summary = result.summary;
+                    tokensSummarized = result.tokens_summarized;
+                }
+                catch {
+                    // Summarizer failed — store raw
+                }
+                break;
+            }
+        }
+        // 4. Truncation cascade — if no summarizer matched and content is large
+        if (!summary && cleaned.length > truncation_js_1.MAX_PASSTHROUGH) {
+            const aggressive = this.budgetManager ? this.budgetManager.getStatus(this.sessionId).throttled : false;
+            const result = (0, truncation_js_1.truncate)(cleaned, aggressive);
+            summary = result.content;
+            tokensSummarized = (0, utils_js_1.estimateTokens)(summary);
+        }
+        // 5. Build observation
+        const obs = {
+            id: (0, utils_js_1.ulid)(),
+            type,
+            content: cleaned,
+            summary,
+            content_hash: contentHash,
+            metadata: {
+                source,
+                file_path: filePath,
+                tokens_original: tokensOriginal,
+                tokens_summarized: tokensSummarized,
+                privacy_level: privacyLevel,
+                session_id: this.sessionId,
+            },
+            indexed_at: Date.now(),
+        };
+        // 6. Store
+        this.storage.exec(`INSERT INTO observations (id, type, content, summary, metadata, indexed_at, privacy_level, session_id, content_hash)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`, [obs.id, obs.type, obs.content, obs.summary || null, JSON.stringify(obs.metadata), obs.indexed_at, privacyLevel, this.sessionId, contentHash]);
+        // 7. Track token economics
+        const bytesUsed = Buffer.byteLength(obs.content, 'utf8');
+        this.storage.exec(`INSERT INTO token_stats (session_id, event_type, tokens_in, tokens_out, timestamp)
+       VALUES (?, 'store', ?, ?, ?)`, [this.sessionId, tokensOriginal, tokensSummarized, Date.now()]);
+        // 8. Record budget usage
+        if (this.budgetManager) {
+            this.budgetManager.record(this.sessionId, bytesUsed);
+        }
+        return obs;
+    }
+}
+exports.Pipeline = Pipeline;
+//# sourceMappingURL=pipeline.js.map

package/dist/core/pipeline.js.map

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

package/dist/core/plugin-registry.d.ts

@@ -0,0 +1,13 @@
+import type { Plugin, PluginConfig, PluginType } from './types.js';
+export declare class PluginRegistry {
+    private plugins;
+    private registrationOrder;
+    register(plugin: Plugin, config?: PluginConfig): Promise<void>;
+    get<T extends Plugin = Plugin>(type: PluginType | string, name?: string): T | undefined;
+    getAll(type: PluginType | string): Plugin[];
+    unregister(name: string): Promise<void>;
+    shutdown(): Promise<void>;
+    has(name: string): boolean;
+    get size(): number;
+}
+//# sourceMappingURL=plugin-registry.d.ts.map

package/dist/core/plugin-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-registry.d.ts","sourceRoot":"","sources":["../../src/core/plugin-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEnE,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,iBAAiB,CAAgB;IAEnC,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,YAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAcxE,GAAG,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAYvF,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,MAAM,EAAE;IAIrC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQvC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAY/B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/core/plugin-registry.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PluginRegistry = void 0;
+class PluginRegistry {
+    plugins = new Map();
+    registrationOrder = [];
+    async register(plugin, config = {}) {
+        if (this.plugins.has(plugin.name)) {
+            throw new Error(`Plugin "${plugin.name}" is already registered`);
+        }
+        try {
+            await plugin.init(config);
+        }
+        catch (err) {
+            console.warn(`Plugin "${plugin.name}" init failed, skipping:`, err.message);
+            return;
+        }
+        this.plugins.set(plugin.name, plugin);
+        this.registrationOrder.push(plugin.name);
+    }
+    get(type, name) {
+        if (name) {
+            const plugin = this.plugins.get(name);
+            if (plugin && plugin.type === type)
+                return plugin;
+            return undefined;
+        }
+        for (const plugin of this.plugins.values()) {
+            if (plugin.type === type)
+                return plugin;
+        }
+        return undefined;
+    }
+    getAll(type) {
+        return Array.from(this.plugins.values()).filter(p => p.type === type);
+    }
+    async unregister(name) {
+        const plugin = this.plugins.get(name);
+        if (!plugin)
+            return;
+        await plugin.destroy();
+        this.plugins.delete(name);
+        this.registrationOrder = this.registrationOrder.filter(n => n !== name);
+    }
+    async shutdown() {
+        const reversed = [...this.registrationOrder].reverse();
+        for (const name of reversed) {
+            const plugin = this.plugins.get(name);
+            if (plugin) {
+                try {
+                    await plugin.destroy();
+                }
+                catch { /* ignore destroy errors on shutdown */ }
+            }
+        }
+        this.plugins.clear();
+        this.registrationOrder = [];
+    }
+    has(name) {
+        return this.plugins.has(name);
+    }
+    get size() {
+        return this.plugins.size;
+    }
+}
+exports.PluginRegistry = PluginRegistry;
+//# sourceMappingURL=plugin-registry.js.map

package/dist/core/plugin-registry.js.map

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

package/dist/core/session.d.ts

@@ -0,0 +1,14 @@
+import type { StoragePlugin, TokenEconomics } from './types.js';
+import type { EventTracker } from './events.js';
+export declare class SessionManager {
+    private storage;
+    private events?;
+    constructor(storage: StoragePlugin, events?: EventTracker | undefined);
+    saveSnapshot(sessionId: string, stats: TokenEconomics): void;
+    restoreSnapshot(sessionId: string): {
+        snapshot: Record<string, unknown>;
+        condensed: boolean;
+    } | null;
+    private buildSnapshot;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/core/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/core/session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAKhD,qBAAa,cAAc;IAEvB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,MAAM,CAAC;gBADP,OAAO,EAAE,aAAa,EACtB,MAAM,CAAC,EAAE,YAAY,YAAA;IAG/B,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,IAAI;IA4B5D,eAAe,CACb,SAAS,EAAE,MAAM,GAChB;QAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI;IAiCnE,OAAO,CAAC,aAAa;CAwCtB"}

package/dist/core/session.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionManager = void 0;
+const MAX_SNAPSHOT_BYTES = 2048;
+const STALE_THRESHOLD_MS = 24 * 60 * 60 * 1000; // 1 day
+class SessionManager {
+    storage;
+    events;
+    constructor(storage, events) {
+        this.storage = storage;
+        this.events = events;
+    }
+    saveSnapshot(sessionId, stats) {
+        const snapshot = this.buildSnapshot(sessionId, stats);
+        let snapshotStr = JSON.stringify(snapshot);
+        // If over budget, progressively trim content until it fits as valid JSON
+        if (snapshotStr.length > MAX_SNAPSHOT_BYTES) {
+            // Remove events first (lowest value), then errors, then decisions
+            delete snapshot.events;
+            snapshotStr = JSON.stringify(snapshot);
+        }
+        if (snapshotStr.length > MAX_SNAPSHOT_BYTES) {
+            delete snapshot.errors;
+            snapshotStr = JSON.stringify(snapshot);
+        }
+        if (snapshotStr.length > MAX_SNAPSHOT_BYTES) {
+            // Trim decisions to first 2
+            if (Array.isArray(snapshot.decisions)) {
+                snapshot.decisions = snapshot.decisions.slice(0, 2);
+            }
+            snapshotStr = JSON.stringify(snapshot);
+        }
+        this.storage.exec('INSERT OR REPLACE INTO snapshots (session_id, snapshot, created_at) VALUES (?, ?, ?)', [sessionId, snapshotStr, Date.now()]);
+    }
+    restoreSnapshot(sessionId) {
+        const row = this.storage
+            .prepare('SELECT session_id, snapshot, created_at FROM snapshots WHERE session_id = ?')
+            .get(sessionId);
+        if (!row)
+            return null;
+        const age = Date.now() - row.created_at;
+        let data;
+        try {
+            data = JSON.parse(row.snapshot);
+        }
+        catch {
+            return null; // corrupted snapshot
+        }
+        if (age > STALE_THRESHOLD_MS) {
+            return {
+                snapshot: {
+                    task: data.task,
+                    decisions: data.decisions,
+                    stats: data.stats,
+                    condensed: true,
+                    original_session: sessionId,
+                },
+                condensed: true,
+            };
+        }
+        return { snapshot: data, condensed: false };
+    }
+    buildSnapshot(sessionId, stats) {
+        const decisions = this.storage
+            .prepare("SELECT summary FROM observations WHERE session_id = ? AND type = 'decision' ORDER BY indexed_at DESC LIMIT 5")
+            .all(sessionId);
+        const errors = this.storage
+            .prepare("SELECT summary FROM observations WHERE session_id = ? AND type = 'error' ORDER BY indexed_at DESC LIMIT 3")
+            .all(sessionId);
+        let recentEvents = [];
+        if (this.events) {
+            recentEvents = this.events
+                .query(sessionId, { priority: 1, limit: 5 })
+                .map((e) => ({
+                type: e.event_type,
+                data: e.data,
+                time: e.timestamp,
+            }));
+        }
+        return {
+            session_id: sessionId,
+            stats: {
+                observations: stats.observations_stored,
+                tokens_saved: stats.tokens_saved,
+                savings_pct: stats.savings_percentage,
+            },
+            decisions: decisions.map((d) => d.summary),
+            errors: errors.map((e) => e.summary),
+            events: recentEvents,
+            snapshot_at: Date.now(),
+        };
+    }
+}
+exports.SessionManager = SessionManager;
+//# sourceMappingURL=session.js.map

package/dist/core/session.js.map

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

package/dist/core/truncation.d.ts

@@ -0,0 +1,11 @@
+import type { TruncationResult } from './types.js';
+export declare const MAX_PASSTHROUGH = 2048;
+/**
+ * Four-tier truncation cascade:
+ * T1: JSON schema extraction
+ * T2: Pattern matching (test output, diff, npm)
+ * T3: Head/Tail slicing
+ * T4: SHA256 hash (binary content)
+ */
+export declare function truncate(content: string, aggressive?: boolean): TruncationResult;
+//# sourceMappingURL=truncation.d.ts.map

package/dist/core/truncation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"truncation.d.ts","sourceRoot":"","sources":["../../src/core/truncation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGnD,eAAO,MAAM,eAAe,OAAO,CAAC;AAqFpC;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,UAAQ,GAAG,gBAAgB,CAuD9E"}

package/dist/core/truncation.js

@@ -0,0 +1,143 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_PASSTHROUGH = void 0;
+exports.truncate = truncate;
+const node_crypto_1 = require("node:crypto");
+// Tier thresholds
+exports.MAX_PASSTHROUGH = 2048;
+const HEAD = 500;
+const TAIL = 500;
+const AGGRESSIVE_HEAD = 200;
+const AGGRESSIVE_TAIL = 200;
+// Tier 1: JSON schema extraction
+function tryJsonSchema(content) {
+    try {
+        const parsed = JSON.parse(content);
+        return `[JSON schema] ${describeJson(parsed, 0)}`;
+    }
+    catch {
+        return null;
+    }
+}
+function describeJson(val, depth) {
+    if (depth > 3)
+        return '...';
+    if (val === null)
+        return 'null';
+    if (Array.isArray(val)) {
+        if (val.length === 0)
+            return 'array[0]';
+        return `array[${val.length}] of ${describeJson(val[0], depth + 1)}`;
+    }
+    if (typeof val === 'object') {
+        const keys = Object.keys(val);
+        if (keys.length === 0)
+            return 'object{}';
+        const fields = keys.slice(0, 10).map(k => `${k}: ${describeJson(val[k], depth + 1)}`).join(', ');
+        const extra = keys.length > 10 ? `, +${keys.length - 10} more` : '';
+        return `{${fields}${extra}}`;
+    }
+    return typeof val;
+}
+// Tier 2: Pattern matching for known verbose outputs
+const PATTERNS = [
+    {
+        // Test output
+        test: /Tests:\s.*total|PASS|FAIL|test suites?:/i,
+        extract: (c) => {
+            const lines = c.split('\n');
+            const summary = lines.filter(l => /Tests:|Test Suites:|passed|failed|PASS|FAIL|total/i.test(l)).slice(0, 10);
+            return `[Test output summary]\n${summary.join('\n')}`;
+        },
+    },
+    {
+        // Diff/patch
+        test: /^(diff --git|---|\+\+\+|@@)/m,
+        extract: (c) => {
+            const lines = c.split('\n');
+            const fileChanges = lines.filter(l => l.startsWith('diff --git') || l.startsWith('---') || l.startsWith('+++'));
+            const stats = lines.filter(l => /^\d+ files? changed/.test(l));
+            return `[Diff summary] ${fileChanges.length / 2} files\n${fileChanges.slice(0, 20).join('\n')}\n${stats.join('\n')}`;
+        },
+    },
+    {
+        // npm install output
+        test: /added \d+ packages?|npm warn|npm ERR!/,
+        extract: (c) => {
+            const lines = c.split('\n');
+            const relevant = lines.filter(l => /added|removed|npm warn|npm ERR!|up to date|packages? in/i.test(l)).slice(0, 10);
+            return `[npm output]\n${relevant.join('\n')}`;
+        },
+    },
+];
+// Tier 4: Binary content detection
+function isBinary(content) {
+    const sampleSize = Math.min(content.length, 512);
+    if (sampleSize === 0)
+        return false;
+    let nonPrintable = 0;
+    for (let i = 0; i < sampleSize; i++) {
+        const code = content.charCodeAt(i);
+        if (code < 32 && code !== 9 && code !== 10 && code !== 13) {
+            nonPrintable++;
+        }
+    }
+    return nonPrintable / sampleSize > 0.1;
+}
+/**
+ * Four-tier truncation cascade:
+ * T1: JSON schema extraction
+ * T2: Pattern matching (test output, diff, npm)
+ * T3: Head/Tail slicing
+ * T4: SHA256 hash (binary content)
+ */
+function truncate(content, aggressive = false) {
+    const originalLength = content.length;
+    // T4 first: binary content → hash immediately
+    if (isBinary(content)) {
+        const hash = (0, node_crypto_1.createHash)('sha256').update(content).digest('hex');
+        const result = `[Binary content] sha256:${hash} (${Buffer.byteLength(content, 'utf8')} bytes)`;
+        return { content: result, tier: 4, original_length: originalLength, truncated_length: result.length };
+    }
+    // T1: JSON schema extraction
+    const schema = tryJsonSchema(content);
+    if (schema) {
+        return { content: schema, tier: 1, original_length: originalLength, truncated_length: schema.length };
+    }
+    // T2: Pattern matching
+    for (const pattern of PATTERNS) {
+        if (pattern.test.test(content)) {
+            const extracted = pattern.extract(content);
+            return { content: extracted, tier: 2, original_length: originalLength, truncated_length: extracted.length };
+        }
+    }
+    // T3: Head/Tail slicing
+    const headSize = aggressive ? AGGRESSIVE_HEAD : HEAD;
+    const tailSize = aggressive ? AGGRESSIVE_TAIL : TAIL;
+    const lines = content.split('\n');
+    if (lines.length <= headSize + tailSize) {
+        // Char-level truncation — only truncate if content actually exceeds the char budget
+        const charBudget = aggressive ? 1600 : 4000;
+        if (originalLength <= charBudget) {
+            // Content fits in budget — return as-is
+            return { content, tier: 3, original_length: originalLength, truncated_length: originalLength };
+        }
+        const halfBudget = aggressive ? 800 : 2000;
+        const head = content.slice(0, halfBudget);
+        const tail = content.slice(-halfBudget);
+        const omitted = originalLength - head.length - tail.length;
+        const result = `${head}\n... (${omitted} chars omitted) ...\n${tail}`;
+        return { content: result, tier: 3, original_length: originalLength, truncated_length: result.length };
+    }
+    const headLines = lines.slice(0, headSize);
+    const tailLines = lines.slice(-tailSize);
+    const omitted = lines.length - headSize - tailSize;
+    const result = [
+        `[${lines.length} lines total]`,
+        ...headLines,
+        `... (${omitted} lines omitted) ...`,
+        ...tailLines,
+    ].join('\n');
+    return { content: result, tier: 3, original_length: originalLength, truncated_length: result.length };
+}
+//# sourceMappingURL=truncation.js.map

package/dist/core/truncation.js.map

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