milens 0.6.2 → 0.6.3

package/dist/gateway/cache.d.ts

@@ -0,0 +1,35 @@
+import type { ChatRequest, MessageAnalysis, CacheEntry, CacheConfig } from './types.js';
+import type { CodeSymbol } from '../types.js';
+import type BetterSqlite3 from 'better-sqlite3';
+export declare class SemanticCache {
+    private rawDb;
+    private config;
+    private stmts;
+    constructor(rawDb: BetterSqlite3.Database, config: CacheConfig);
+    private prepareStatements;
+    /** Look up a cached response by AST hash + request hash */
+    lookup(req: ChatRequest, analysis?: MessageAnalysis): CacheEntry | null;
+    /** Store a response in the cache */
+    store(req: ChatRequest, analysis: MessageAnalysis, response: string, meta: {
+        model: string;
+        provider: string;
+        tokensIn: number;
+        tokensOut: number;
+    }): void;
+    /** Compute AST hash — captures code structure, survives renames/reformats */
+    computeASTHash(symbols: CodeSymbol[]): string;
+    /** Compute request hash — normalized version of the prompt */
+    private computeRequestHash;
+    /** Evict expired entries + enforce max capacity */
+    private ensureCapacity;
+    /** Invalidate cache entries related to changed files */
+    invalidateForFiles(filePaths: string[]): number;
+    /** Get cache statistics */
+    getStats(): {
+        totalEntries: number;
+        totalHits: number;
+        totalTokensCached: number;
+        totalCostSaved: number;
+    };
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/gateway/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/gateway/cache.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACxF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,aAAa,MAAM,gBAAgB,CAAC;AAEhD,qBAAa,aAAa;IAItB,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,MAAM;IAJhB,OAAO,CAAC,KAAK,CAAiD;gBAGpD,KAAK,EAAE,aAAa,CAAC,QAAQ,EAC7B,MAAM,EAAE,WAAW;IAK7B,OAAO,CAAC,iBAAiB;IAoDzB,2DAA2D;IAC3D,MAAM,CAAC,GAAG,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE,eAAe,GAAG,UAAU,GAAG,IAAI;IA2BvE,oCAAoC;IACpC,KAAK,CACH,GAAG,EAAE,WAAW,EAChB,QAAQ,EAAE,eAAe,EACzB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAC7E,IAAI;IAmBP,6EAA6E;IAC7E,cAAc,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM;IAe7C,8DAA8D;IAC9D,OAAO,CAAC,kBAAkB;IAgB1B,mDAAmD;IACnD,OAAO,CAAC,cAAc;IAStB,wDAAwD;IACxD,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM;IAU/C,2BAA2B;IAC3B,QAAQ,IAAI;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,iBAAiB,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE;CAS3G"}

package/dist/gateway/cache.js

@@ -0,0 +1,175 @@
+// ── Semantic cache — AST-structure-aware caching for LLM responses ──
+import { createHash } from 'node:crypto';
+export class SemanticCache {
+    rawDb;
+    config;
+    stmts;
+    constructor(rawDb, config) {
+        this.rawDb = rawDb;
+        this.config = config;
+        this.stmts = this.prepareStatements();
+    }
+    prepareStatements() {
+        return {
+            lookup: this.rawDb.prepare(`SELECT * FROM gateway_cache
+         WHERE ast_hash = ? AND request_hash = ?
+         AND datetime(created_at, '+' || ttl_hours || ' hours') > datetime('now')
+         LIMIT 1`),
+            lookupByAst: this.rawDb.prepare(`SELECT * FROM gateway_cache
+         WHERE ast_hash = ?
+         AND datetime(created_at, '+' || ttl_hours || ' hours') > datetime('now')
+         ORDER BY hit_count DESC LIMIT 1`),
+            insert: this.rawDb.prepare(`INSERT OR REPLACE INTO gateway_cache
+         (id, ast_hash, request_hash, response, model, provider, tokens_in, tokens_out, cost_estimate, ttl_hours)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`),
+            recordHit: this.rawDb.prepare(`UPDATE gateway_cache SET hit_count = hit_count + 1, last_hit_at = datetime('now') WHERE id = ?`),
+            evictExpired: this.rawDb.prepare(`DELETE FROM gateway_cache WHERE datetime(created_at, '+' || ttl_hours || ' hours') <= datetime('now')`),
+            evictOldest: this.rawDb.prepare(`DELETE FROM gateway_cache WHERE id IN (
+           SELECT id FROM gateway_cache ORDER BY last_hit_at ASC NULLS FIRST, created_at ASC
+           LIMIT ?
+         )`),
+            count: this.rawDb.prepare('SELECT COUNT(*) as c FROM gateway_cache'),
+            invalidateByFile: this.rawDb.prepare(`DELETE FROM gateway_cache WHERE ast_hash IN (
+           SELECT DISTINCT gc.ast_hash FROM gateway_cache gc
+           WHERE gc.id IN (
+             SELECT gc2.id FROM gateway_cache gc2
+             JOIN json_each(gc2.response) -- Response contains symbol info referencing the file
+           )
+         )`),
+            stats: this.rawDb.prepare(`SELECT
+           COUNT(*) as total_entries,
+           SUM(hit_count) as total_hits,
+           SUM(tokens_in + tokens_out) as total_tokens_cached,
+           SUM(cost_estimate * hit_count) as total_cost_saved
+         FROM gateway_cache`),
+        };
+    }
+    /** Look up a cached response by AST hash + request hash */
+    lookup(req, analysis) {
+        if (!this.config.enabled)
+            return null;
+        const astHash = analysis?.symbols.length
+            ? this.computeASTHash(analysis.symbols)
+            : null;
+        const requestHash = this.computeRequestHash(req);
+        // Try exact match (ast + request)
+        if (astHash) {
+            const row = this.stmts.lookup.get(astHash, requestHash);
+            if (row) {
+                this.stmts.recordHit.run(row.id);
+                return rowToCacheEntry(row);
+            }
+            // Try AST-only match (structural cache hit — same code structure, different prompt wording)
+            const astRow = this.stmts.lookupByAst.get(astHash);
+            if (astRow) {
+                this.stmts.recordHit.run(astRow.id);
+                return rowToCacheEntry(astRow);
+            }
+        }
+        return null;
+    }
+    /** Store a response in the cache */
+    store(req, analysis, response, meta) {
+        if (!this.config.enabled || !analysis.symbols.length)
+            return;
+        // Evict if over capacity
+        this.ensureCapacity();
+        const astHash = this.computeASTHash(analysis.symbols);
+        const requestHash = this.computeRequestHash(req);
+        const id = createHash('sha256').update(astHash + requestHash).digest('hex').slice(0, 16);
+        const costEstimate = estimateCost(meta.tokensIn, meta.tokensOut, meta.model);
+        this.stmts.insert.run(id, astHash, requestHash, response, meta.model, meta.provider, meta.tokensIn, meta.tokensOut, costEstimate, this.config.ttlHours);
+    }
+    /** Compute AST hash — captures code structure, survives renames/reformats */
+    computeASTHash(symbols) {
+        // Hash based on structural properties, NOT code text or names
+        const structure = symbols
+            .sort((a, b) => a.filePath.localeCompare(b.filePath) || a.startLine - b.startLine)
+            .map(s => {
+            // Include: kind, export status, parent relationship, line span size
+            const span = s.endLine - s.startLine;
+            const parent = s.parentId ? '1' : '0';
+            return `${s.kind}:${s.exported ? 'E' : 'I'}:${parent}:${span}`;
+        })
+            .join('|');
+        return createHash('sha256').update(structure).digest('hex').slice(0, 16);
+    }
+    /** Compute request hash — normalized version of the prompt */
+    computeRequestHash(req) {
+        // Normalize: lowercase, collapse whitespace, remove timestamps
+        const normalized = req.messages
+            .filter(m => m.role === 'user')
+            .map(m => {
+            const text = typeof m.content === 'string' ? m.content
+                : Array.isArray(m.content)
+                    ? m.content.filter(p => p.type === 'text').map(p => p.text ?? '').join(' ')
+                    : '';
+            return text.toLowerCase().replace(/\s+/g, ' ').trim();
+        })
+            .join('\n');
+        return createHash('sha256').update(normalized).digest('hex').slice(0, 16);
+    }
+    /** Evict expired entries + enforce max capacity */
+    ensureCapacity() {
+        this.stmts.evictExpired.run();
+        const count = this.stmts.count.get()?.c ?? 0;
+        if (count >= this.config.maxEntries) {
+            const toDelete = Math.ceil(this.config.maxEntries * 0.1); // Remove 10%
+            this.stmts.evictOldest.run(toDelete);
+        }
+    }
+    /** Invalidate cache entries related to changed files */
+    invalidateForFiles(filePaths) {
+        // Simple approach: clear all cache when files change
+        // (More granular: match ast_hash to symbols in changed files)
+        if (filePaths.length > 0) {
+            const result = this.rawDb.prepare('DELETE FROM gateway_cache').run();
+            return result.changes;
+        }
+        return 0;
+    }
+    /** Get cache statistics */
+    getStats() {
+        const row = this.stmts.stats.get();
+        return {
+            totalEntries: row?.total_entries ?? 0,
+            totalHits: row?.total_hits ?? 0,
+            totalTokensCached: row?.total_tokens_cached ?? 0,
+            totalCostSaved: row?.total_cost_saved ?? 0,
+        };
+    }
+}
+function rowToCacheEntry(row) {
+    return {
+        id: row.id,
+        astHash: row.ast_hash,
+        requestHash: row.request_hash,
+        response: row.response,
+        model: row.model,
+        provider: row.provider,
+        tokensIn: row.tokens_in,
+        tokensOut: row.tokens_out,
+        costEstimate: row.cost_estimate,
+        createdAt: row.created_at,
+        hitCount: row.hit_count,
+        lastHitAt: row.last_hit_at,
+        ttlHours: row.ttl_hours,
+    };
+}
+// Rough cost estimation per 1M tokens (USD)
+const MODEL_COSTS = {
+    'gpt-4o': { input: 2.5, output: 10 },
+    'gpt-4o-mini': { input: 0.15, output: 0.6 },
+    'claude-3-5-sonnet': { input: 3, output: 15 },
+    'claude-3-5-haiku': { input: 0.8, output: 4 },
+    'gemini-1.5-pro': { input: 1.25, output: 5 },
+    'gemini-1.5-flash': { input: 0.075, output: 0.3 },
+};
+function estimateCost(tokensIn, tokensOut, model) {
+    // Try exact match then prefix match
+    const costs = MODEL_COSTS[model]
+        ?? Object.entries(MODEL_COSTS).find(([k]) => model.includes(k))?.[1]
+        ?? { input: 1, output: 3 }; // Default fallback
+    return (tokensIn * costs.input + tokensOut * costs.output) / 1_000_000;
+}
+//# sourceMappingURL=cache.js.map

package/dist/gateway/cache.js.map

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

package/dist/gateway/config.d.ts

@@ -0,0 +1,10 @@
+import type { GatewayConfig } from './types.js';
+/** Load gateway config from gateway.json, applying defaults for missing fields */
+export declare function loadConfig(projectDir: string): GatewayConfig;
+/** Create a default gateway.json if none exists */
+export declare function initConfig(projectDir: string): string;
+/** Validate config, returning errors */
+export declare function validateConfig(config: GatewayConfig): string[];
+/** Resolve env var references in api keys (${VAR_NAME} → process.env.VAR_NAME) */
+export declare function resolveEnvVars(config: GatewayConfig): GatewayConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/gateway/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/gateway/config.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAyF,MAAM,YAAY,CAAC;AA0CvI,kFAAkF;AAClF,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,CAgB5D;AAED,mDAAmD;AACnD,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAqCrD;AAED,wCAAwC;AACxC,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,EAAE,CA4B9D;AAED,kFAAkF;AAClF,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,GAAG,aAAa,CAQnE"}

package/dist/gateway/config.js

@@ -0,0 +1,167 @@
+// ── Config — gateway.json loader and validator ──
+import { readFileSync, existsSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+const DEFAULT_ROUTING = {
+    thresholds: { economy: 5, standard: 20 },
+    intentMultipliers: {
+        generate: 1.0,
+        refactor: 1.5,
+        review: 0.8,
+        test: 0.7,
+        debug: 1.2,
+        explain: 0.5,
+        docstring: 0.3,
+        unknown: 1.0,
+    },
+    defaultTier: 'standard',
+};
+const DEFAULT_CACHE = {
+    enabled: true,
+    maxEntries: 1000,
+    ttlHours: 24,
+};
+const DEFAULT_CONTEXT_INJECTION = {
+    enabled: true,
+    maxTokens: 500,
+    includeCallers: true,
+    includeDependencies: true,
+    includeBlastRadius: true,
+};
+const DEFAULT_CONFIG = {
+    port: 4141,
+    host: '127.0.0.1',
+    providers: [],
+    routing: DEFAULT_ROUTING,
+    cache: DEFAULT_CACHE,
+    contextInjection: DEFAULT_CONTEXT_INJECTION,
+    privacy: { rules: [], defaultAction: 'allow' },
+    rateLimit: { windowMs: 60000, maxRequests: 60 },
+};
+/** Load gateway config from gateway.json, applying defaults for missing fields */
+export function loadConfig(projectDir) {
+    const configPath = join(projectDir, 'gateway.json');
+    if (!existsSync(configPath)) {
+        return { ...DEFAULT_CONFIG };
+    }
+    const raw = readFileSync(configPath, 'utf-8');
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        throw new Error(`Invalid JSON in ${configPath}`);
+    }
+    return mergeConfig(parsed);
+}
+/** Create a default gateway.json if none exists */
+export function initConfig(projectDir) {
+    const configPath = join(projectDir, 'gateway.json');
+    if (existsSync(configPath)) {
+        return configPath;
+    }
+    const template = {
+        $schema: './node_modules/milens/gateway-schema.json',
+        port: 4141,
+        host: '127.0.0.1',
+        providers: [
+            {
+                id: 'openai-main',
+                name: 'OpenAI',
+                tier: 'premium',
+                format: 'openai',
+                endpoint: 'https://api.openai.com/v1',
+                apiKey: '${OPENAI_API_KEY}',
+                models: ['gpt-4o', 'gpt-4o-mini'],
+            },
+        ],
+        routing: DEFAULT_ROUTING,
+        cache: DEFAULT_CACHE,
+        contextInjection: DEFAULT_CONTEXT_INJECTION,
+        privacy: {
+            rules: [
+                { pathPattern: '**/.env*', action: 'block', reason: 'Environment files contain secrets' },
+                { pathPattern: '**/secrets/**', action: 'block', reason: 'Secret files' },
+            ],
+            defaultAction: 'allow',
+        },
+        rateLimit: { windowMs: 60000, maxRequests: 60 },
+    };
+    writeFileSync(configPath, JSON.stringify(template, null, 2) + '\n', 'utf-8');
+    return configPath;
+}
+/** Validate config, returning errors */
+export function validateConfig(config) {
+    const errors = [];
+    if (config.port < 1 || config.port > 65535) {
+        errors.push(`Invalid port: ${config.port}`);
+    }
+    if (!config.providers.length) {
+        errors.push('No providers configured — at least one provider is required');
+    }
+    for (const p of config.providers) {
+        if (!p.id)
+            errors.push('Provider missing "id"');
+        if (!p.format)
+            errors.push(`Provider "${p.id}": missing "format"`);
+        if (!p.endpoint)
+            errors.push(`Provider "${p.id}": missing "endpoint"`);
+        if (!p.apiKey)
+            errors.push(`Provider "${p.id}": missing "apiKey"`);
+        if (!p.models?.length)
+            errors.push(`Provider "${p.id}": missing "models"`);
+        // Check for env var references
+        if (p.apiKey.startsWith('${') && p.apiKey.endsWith('}')) {
+            const envVar = p.apiKey.slice(2, -1);
+            if (!process.env[envVar]) {
+                errors.push(`Provider "${p.id}": env var ${envVar} is not set`);
+            }
+        }
+    }
+    return errors;
+}
+/** Resolve env var references in api keys (${VAR_NAME} → process.env.VAR_NAME) */
+export function resolveEnvVars(config) {
+    return {
+        ...config,
+        providers: config.providers.map(p => ({
+            ...p,
+            apiKey: resolveEnvValue(p.apiKey),
+        })),
+    };
+}
+function resolveEnvValue(value) {
+    if (value.startsWith('${') && value.endsWith('}')) {
+        const envVar = value.slice(2, -1);
+        return process.env[envVar] ?? value;
+    }
+    return value;
+}
+function mergeConfig(raw) {
+    return {
+        port: typeof raw.port === 'number' ? raw.port : DEFAULT_CONFIG.port,
+        host: typeof raw.host === 'string' ? raw.host : DEFAULT_CONFIG.host,
+        providers: Array.isArray(raw.providers) ? raw.providers : [],
+        routing: {
+            ...DEFAULT_ROUTING,
+            ...(typeof raw.routing === 'object' && raw.routing ? raw.routing : {}),
+        },
+        cache: {
+            ...DEFAULT_CACHE,
+            ...(typeof raw.cache === 'object' && raw.cache ? raw.cache : {}),
+        },
+        contextInjection: {
+            ...DEFAULT_CONTEXT_INJECTION,
+            ...(typeof raw.contextInjection === 'object' && raw.contextInjection
+                ? raw.contextInjection : {}),
+        },
+        privacy: {
+            rules: Array.isArray(raw.privacy?.rules) ? raw.privacy.rules : [],
+            defaultAction: raw.privacy?.defaultAction ?? 'allow',
+        },
+        rateLimit: {
+            windowMs: raw.rateLimit?.windowMs ?? 60000,
+            maxRequests: raw.rateLimit?.maxRequests ?? 60,
+        },
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/gateway/config.js.map

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

package/dist/gateway/context-memory.d.ts

@@ -0,0 +1,68 @@
+/** A shared context entry */
+interface ContextEntry {
+    key: string;
+    value: string;
+    source: string;
+    addedAt: number;
+    hash: string;
+    tags: string[];
+}
+/** Change notification */
+interface ContextChange {
+    type: 'add' | 'update' | 'remove';
+    key: string;
+    value?: string;
+    source: string;
+    timestamp: number;
+}
+type ChangeListener = (change: ContextChange) => void;
+export declare class ContextMemory {
+    private agents;
+    private entries;
+    private listeners;
+    private changeLog;
+    private maxEntries;
+    private maxChangeLog;
+    constructor(opts?: {
+        maxEntries?: number;
+        maxChangeLog?: number;
+    });
+    /** Register a new agent session */
+    registerAgent(name: string, role: string): string;
+    /** Remove an agent session */
+    removeAgent(agentId: string): void;
+    /** Add or update a context entry (dedup by content hash) */
+    set(agentId: string, key: string, value: string, tags?: string[]): boolean;
+    /** Get a context entry */
+    get(key: string): string | undefined;
+    /** Remove a context entry */
+    remove(agentId: string, key: string): boolean;
+    /** Get all context entries matching tags */
+    getByTags(tags: string[]): ContextEntry[];
+    /** Get all context contributed by a specific agent */
+    getByAgent(agentId: string): ContextEntry[];
+    /** Subscribe to context changes */
+    subscribe(agentId: string, listener: ChangeListener): void;
+    /** Get changes since a timestamp */
+    getChangesSince(since: number): ContextChange[];
+    /** Build a summary string of shared context (for injection into prompts) */
+    buildContextSummary(maxTokens?: number): string;
+    /** List active agents */
+    listAgents(): {
+        id: string;
+        name: string;
+        role: string;
+        contextCount: number;
+        lastActive: number;
+    }[];
+    /** Get stats */
+    getStats(): {
+        agents: number;
+        entries: number;
+        changeLogSize: number;
+    };
+    private recordChange;
+    private evictOldest;
+}
+export {};
+//# sourceMappingURL=context-memory.d.ts.map

package/dist/gateway/context-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-memory.d.ts","sourceRoot":"","sources":["../../src/gateway/context-memory.ts"],"names":[],"mappings":"AAcA,6BAA6B;AAC7B,UAAU,YAAY;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,0BAA0B;AAC1B,UAAU,aAAa;IACrB,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,KAAK,cAAc,GAAG,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI,CAAC;AAEtD,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAmC;IACjD,OAAO,CAAC,OAAO,CAAmC;IAClD,OAAO,CAAC,SAAS,CAAqC;IACtD,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,YAAY,CAAS;gBAEjB,IAAI,GAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAO;IAKrE,mCAAmC;IACnC,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM;IAWjD,8BAA8B;IAC9B,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAKlC,4DAA4D;IAC5D,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,EAAO,GAAG,OAAO;IAgC9E,0BAA0B;IAC1B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIpC,6BAA6B;IAC7B,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO;IAY7C,4CAA4C;IAC5C,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,YAAY,EAAE;IAOzC,sDAAsD;IACtD,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,EAAE;IAQ3C,mCAAmC;IACnC,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,IAAI;IAI1D,oCAAoC;IACpC,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,EAAE;IAI/C,4EAA4E;IAC5E,mBAAmB,CAAC,SAAS,SAAO,GAAG,MAAM;IAoB7C,yBAAyB;IACzB,UAAU,IAAI;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,EAAE;IAUpG,gBAAgB;IAChB,QAAQ;;;;;IAQR,OAAO,CAAC,YAAY;IAcpB,OAAO,CAAC,WAAW;CASpB"}

package/dist/gateway/context-memory.js

@@ -0,0 +1,157 @@
+// ── Context Memory — shared context across multi-agent sessions ──
+import { createHash, randomUUID } from 'node:crypto';
+export class ContextMemory {
+    agents = new Map();
+    entries = new Map();
+    listeners = new Map();
+    changeLog = [];
+    maxEntries;
+    maxChangeLog;
+    constructor(opts = {}) {
+        this.maxEntries = opts.maxEntries ?? 500;
+        this.maxChangeLog = opts.maxChangeLog ?? 1000;
+    }
+    /** Register a new agent session */
+    registerAgent(name, role) {
+        const id = randomUUID().slice(0, 8);
+        this.agents.set(id, {
+            id, name, role,
+            joinedAt: Date.now(),
+            lastActive: Date.now(),
+            contextKeys: new Set(),
+        });
+        return id;
+    }
+    /** Remove an agent session */
+    removeAgent(agentId) {
+        this.agents.delete(agentId);
+        this.listeners.delete(agentId);
+    }
+    /** Add or update a context entry (dedup by content hash) */
+    set(agentId, key, value, tags = []) {
+        const agent = this.agents.get(agentId);
+        if (!agent)
+            return false;
+        const hash = createHash('sha256').update(value).digest('hex').slice(0, 12);
+        // Check for duplicate content under a different key
+        const existing = this.entries.get(key);
+        if (existing && existing.hash === hash) {
+            return false; // No change
+        }
+        // Enforce capacity
+        if (!existing && this.entries.size >= this.maxEntries) {
+            this.evictOldest();
+        }
+        const changeType = existing ? 'update' : 'add';
+        this.entries.set(key, {
+            key, value,
+            source: agentId,
+            addedAt: Date.now(),
+            hash,
+            tags,
+        });
+        agent.contextKeys.add(key);
+        agent.lastActive = Date.now();
+        this.recordChange({ type: changeType, key, value, source: agentId, timestamp: Date.now() });
+        return true;
+    }
+    /** Get a context entry */
+    get(key) {
+        return this.entries.get(key)?.value;
+    }
+    /** Remove a context entry */
+    remove(agentId, key) {
+        const entry = this.entries.get(key);
+        if (!entry)
+            return false;
+        this.entries.delete(key);
+        const agent = this.agents.get(agentId);
+        agent?.contextKeys.delete(key);
+        this.recordChange({ type: 'remove', key, source: agentId, timestamp: Date.now() });
+        return true;
+    }
+    /** Get all context entries matching tags */
+    getByTags(tags) {
+        const tagSet = new Set(tags);
+        return [...this.entries.values()].filter(e => e.tags.some(t => tagSet.has(t)));
+    }
+    /** Get all context contributed by a specific agent */
+    getByAgent(agentId) {
+        const agent = this.agents.get(agentId);
+        if (!agent)
+            return [];
+        return [...agent.contextKeys]
+            .map(k => this.entries.get(k))
+            .filter((e) => e !== undefined);
+    }
+    /** Subscribe to context changes */
+    subscribe(agentId, listener) {
+        this.listeners.set(agentId, listener);
+    }
+    /** Get changes since a timestamp */
+    getChangesSince(since) {
+        return this.changeLog.filter(c => c.timestamp > since);
+    }
+    /** Build a summary string of shared context (for injection into prompts) */
+    buildContextSummary(maxTokens = 2000) {
+        const entries = [...this.entries.values()]
+            .sort((a, b) => b.addedAt - a.addedAt);
+        const lines = [];
+        let approxTokens = 0;
+        for (const entry of entries) {
+            const line = `[${entry.tags.join(',')}] ${entry.key}: ${entry.value}`;
+            const lineTokens = Math.ceil(line.length / 4);
+            if (approxTokens + lineTokens > maxTokens)
+                break;
+            lines.push(line);
+            approxTokens += lineTokens;
+        }
+        return lines.length
+            ? `--- Shared Context (${this.agents.size} agents) ---\n${lines.join('\n')}`
+            : '';
+    }
+    /** List active agents */
+    listAgents() {
+        return [...this.agents.values()].map(a => ({
+            id: a.id,
+            name: a.name,
+            role: a.role,
+            contextCount: a.contextKeys.size,
+            lastActive: a.lastActive,
+        }));
+    }
+    /** Get stats */
+    getStats() {
+        return {
+            agents: this.agents.size,
+            entries: this.entries.size,
+            changeLogSize: this.changeLog.length,
+        };
+    }
+    recordChange(change) {
+        this.changeLog.push(change);
+        if (this.changeLog.length > this.maxChangeLog) {
+            this.changeLog = this.changeLog.slice(-Math.floor(this.maxChangeLog * 0.8));
+        }
+        // Notify other agents
+        for (const [agentId, listener] of this.listeners) {
+            if (agentId !== change.source) {
+                try {
+                    listener(change);
+                }
+                catch { /* ignore listener errors */ }
+            }
+        }
+    }
+    evictOldest() {
+        let oldest = null;
+        for (const entry of this.entries.values()) {
+            if (!oldest || entry.addedAt < oldest.addedAt)
+                oldest = entry;
+        }
+        if (oldest) {
+            this.entries.delete(oldest.key);
+        }
+    }
+}
+//# sourceMappingURL=context-memory.js.map

package/dist/gateway/context-memory.js.map

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