@jungjaehoon/mama-os 0.53.1 → 0.58.0

package/dist/agent/content-dedup.d.ts

@@ -1,86 +0,0 @@
-/**
- * Content Deduplicator for MAMA OS Standalone
- *
- * Prevents duplicate content injection into system prompts by using
- * SHA-256 content hashing and realpath normalization. Handles symlinks,
- * duplicate file paths, and identical content from different sources.
- */
-/**
- * Represents a unique content entry after deduplication.
- */
-export interface ContentEntry {
-    /** Original file path as provided */
-    path: string;
-    /** Resolved real path (symlinks resolved) */
-    realPath: string;
-    /** The content string */
-    content: string;
-    /** Semantic distance from query (lower = closer match) */
-    distance: number;
-    /** SHA-256 hash prefix of the content */
-    hash: string;
-}
-/**
- * Deduplicates content entries by SHA-256 hash and realpath normalization.
- *
- * When two entries share the same content hash, the entry with the smaller
- * distance (closer semantic match) is preferred. This ensures that even if
- * the same file is referenced via different paths (e.g., symlinks), only
- * the most relevant instance is kept.
- *
- * @example
- * ```typescript
- * const dedup = new ContentDeduplicator();
- * dedup.add('/path/to/file.ts', 'const x = 1;', 0.3);
- * dedup.add('/symlink/to/file.ts', 'const x = 1;', 0.5); // duplicate, ignored (higher distance)
- * dedup.add('/other/file.ts', 'const y = 2;', 0.1);
- * const entries = dedup.getEntries(); // 2 entries, sorted by distance
- * ```
- */
-export declare class ContentDeduplicator {
-    private seenHashes;
-    /**
-     * Add content for deduplication.
-     *
-     * Returns true if the content is new (not a duplicate). On hash collision,
-     * the entry with the closest distance is preferred.
-     *
-     * @param path - File path of the content source
-     * @param content - Raw content string
-     * @param distance - Semantic distance from query (lower = better)
-     * @returns true if content was added (new), false if duplicate
-     */
-    add(path: string, content: string, distance: number): boolean;
-    /**
-     * Get all unique entries sorted by distance (closest first).
-     *
-     * @returns Array of deduplicated content entries ordered by ascending distance
-     */
-    getEntries(): ContentEntry[];
-    /**
-     * Reset the deduplicator for reuse.
-     * Clears all tracked hashes and entries.
-     */
-    reset(): void;
-    /**
-     * Hash raw content with SHA-256, returning first 16 hex characters for efficiency.
-     *
-     * 16 hex chars = 64 bits of entropy, sufficient for collision avoidance
-     * in typical prompt injection scenarios (< 10,000 entries).
-     *
-     * @param content - Raw content string to hash
-     * @returns First 16 hex characters of SHA-256 digest
-     */
-    private hashContent;
-    /**
-     * Resolve the real path of a file, following symlinks.
-     *
-     * Falls back to the original path if realpath resolution fails
-     * (e.g., file doesn't exist yet, permission denied).
-     *
-     * @param filePath - File path to resolve
-     * @returns Resolved real path or original path on error
-     */
-    private safeRealpath;
-}
-//# sourceMappingURL=content-dedup.d.ts.map

package/dist/agent/content-dedup.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"content-dedup.d.ts","sourceRoot":"","sources":["../../src/agent/content-dedup.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,QAAQ,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,UAAU,CAAmC;IAErD;;;;;;;;;;OAUG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO;IA8B7D;;;;OAIG;IACH,UAAU,IAAI,YAAY,EAAE;IAI5B;;;OAGG;IACH,KAAK,IAAI,IAAI;IAIb;;;;;;;;OAQG;IACH,OAAO,CAAC,WAAW;IAInB;;;;;;;;OAQG;IACH,OAAO,CAAC,YAAY;CAOrB"}

package/dist/agent/content-dedup.js

@@ -1,114 +0,0 @@
-"use strict";
-/**
- * Content Deduplicator for MAMA OS Standalone
- *
- * Prevents duplicate content injection into system prompts by using
- * SHA-256 content hashing and realpath normalization. Handles symlinks,
- * duplicate file paths, and identical content from different sources.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ContentDeduplicator = void 0;
-const node_crypto_1 = require("node:crypto");
-const node_fs_1 = require("node:fs");
-/**
- * Deduplicates content entries by SHA-256 hash and realpath normalization.
- *
- * When two entries share the same content hash, the entry with the smaller
- * distance (closer semantic match) is preferred. This ensures that even if
- * the same file is referenced via different paths (e.g., symlinks), only
- * the most relevant instance is kept.
- *
- * @example
- * ```typescript
- * const dedup = new ContentDeduplicator();
- * dedup.add('/path/to/file.ts', 'const x = 1;', 0.3);
- * dedup.add('/symlink/to/file.ts', 'const x = 1;', 0.5); // duplicate, ignored (higher distance)
- * dedup.add('/other/file.ts', 'const y = 2;', 0.1);
- * const entries = dedup.getEntries(); // 2 entries, sorted by distance
- * ```
- */
-class ContentDeduplicator {
-    seenHashes = new Map();
-    /**
-     * Add content for deduplication.
-     *
-     * Returns true if the content is new (not a duplicate). On hash collision,
-     * the entry with the closest distance is preferred.
-     *
-     * @param path - File path of the content source
-     * @param content - Raw content string
-     * @param distance - Semantic distance from query (lower = better)
-     * @returns true if content was added (new), false if duplicate
-     */
-    add(path, content, distance) {
-        const hash = this.hashContent(content);
-        const realPath = this.safeRealpath(path);
-        const existing = this.seenHashes.get(hash);
-        if (existing) {
-            // Hash collision: prefer the entry with closest distance
-            if (distance < existing.distance) {
-                this.seenHashes.set(hash, { path, realPath, content, distance, hash });
-            }
-            return false;
-        }
-        // Also check if same realpath already exists with a different hash
-        // (content may have changed between reads — keep the new one if closer)
-        for (const [existingHash, entry] of this.seenHashes) {
-            if (entry.realPath === realPath) {
-                if (distance < entry.distance) {
-                    this.seenHashes.delete(existingHash);
-                    this.seenHashes.set(hash, { path, realPath, content, distance, hash });
-                }
-                return false;
-            }
-        }
-        this.seenHashes.set(hash, { path, realPath, content, distance, hash });
-        return true;
-    }
-    /**
-     * Get all unique entries sorted by distance (closest first).
-     *
-     * @returns Array of deduplicated content entries ordered by ascending distance
-     */
-    getEntries() {
-        return [...this.seenHashes.values()].sort((a, b) => a.distance - b.distance);
-    }
-    /**
-     * Reset the deduplicator for reuse.
-     * Clears all tracked hashes and entries.
-     */
-    reset() {
-        this.seenHashes.clear();
-    }
-    /**
-     * Hash raw content with SHA-256, returning first 16 hex characters for efficiency.
-     *
-     * 16 hex chars = 64 bits of entropy, sufficient for collision avoidance
-     * in typical prompt injection scenarios (< 10,000 entries).
-     *
-     * @param content - Raw content string to hash
-     * @returns First 16 hex characters of SHA-256 digest
-     */
-    hashContent(content) {
-        return (0, node_crypto_1.createHash)('sha256').update(content).digest('hex').slice(0, 16);
-    }
-    /**
-     * Resolve the real path of a file, following symlinks.
-     *
-     * Falls back to the original path if realpath resolution fails
-     * (e.g., file doesn't exist yet, permission denied).
-     *
-     * @param filePath - File path to resolve
-     * @returns Resolved real path or original path on error
-     */
-    safeRealpath(filePath) {
-        try {
-            return (0, node_fs_1.realpathSync)(filePath);
-        }
-        catch {
-            return filePath;
-        }
-    }
-}
-exports.ContentDeduplicator = ContentDeduplicator;
-//# sourceMappingURL=content-dedup.js.map

package/dist/agent/content-dedup.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"content-dedup.js","sourceRoot":"","sources":["../../src/agent/content-dedup.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,6CAAyC;AACzC,qCAAuC;AAkBvC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAa,mBAAmB;IACtB,UAAU,GAAG,IAAI,GAAG,EAAwB,CAAC;IAErD;;;;;;;;;;OAUG;IACH,GAAG,CAAC,IAAY,EAAE,OAAe,EAAE,QAAgB;QACjD,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QAEzC,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAE3C,IAAI,QAAQ,EAAE,CAAC;YACb,yDAAyD;YACzD,IAAI,QAAQ,GAAG,QAAQ,CAAC,QAAQ,EAAE,CAAC;gBACjC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;YACzE,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,mEAAmE;QACnE,wEAAwE;QACxE,KAAK,MAAM,CAAC,YAAY,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpD,IAAI,KAAK,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;gBAChC,IAAI,QAAQ,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;oBAC9B,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;oBACrC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;gBACzE,CAAC;gBACD,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QAED,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QACvE,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,UAAU;QACR,OAAO,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC/E,CAAC;IAED;;;OAGG;IACH,KAAK;QACH,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;IAC1B,CAAC;IAED;;;;;;;;OAQG;IACK,WAAW,CAAC,OAAe;QACjC,OAAO,IAAA,wBAAU,EAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACzE,CAAC;IAED;;;;;;;;OAQG;IACK,YAAY,CAAC,QAAgB;QACnC,IAAI,CAAC;YACH,OAAO,IAAA,sBAAY,EAAC,QAAQ,CAAC,CAAC;QAChC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,QAAQ,CAAC;QAClB,CAAC;IACH,CAAC;CACF;AA1FD,kDA0FC"}

package/dist/agent/context-compile-contract.d.ts

@@ -1,5 +0,0 @@
-/** Canonical authority contract projected on every context_compile tool surface. */
-export declare const CONTEXT_COMPILE_TOOL_DESCRIPTION = "Compile and persist an append-only scoped context packet from visible memory, raw, graph, and case evidence. AUTHORITY: OMIT scopes and connectors to use the current host-bound grants (recommended). Supply either field only to intentionally narrow the read; explicit values must remain authorized subsets and can never widen access. strictness is recall, balanced, or strict. Unavailable to Tier 3/read-only agents.";
-/** Temporal workers have one host-selected task and must not choose authority inputs. */
-export declare const TEMPORAL_CONTEXT_COMPILE_INSTRUCTION = "Do not supply scopes, connectors, or seed_refs to context_compile. The host-bound execution context applies the current generation project, connector, and memory grants and adds the active temporal task seed.";
-//# sourceMappingURL=context-compile-contract.d.ts.map

package/dist/agent/context-compile-contract.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"context-compile-contract.d.ts","sourceRoot":"","sources":["../../src/agent/context-compile-contract.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,eAAO,MAAM,gCAAgC,oaACsX,CAAC;AAEpa,yFAAyF;AACzF,eAAO,MAAM,oCAAoC,qNACmK,CAAC"}

package/dist/agent/context-compile-contract.js

@@ -1,8 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TEMPORAL_CONTEXT_COMPILE_INSTRUCTION = exports.CONTEXT_COMPILE_TOOL_DESCRIPTION = void 0;
-/** Canonical authority contract projected on every context_compile tool surface. */
-exports.CONTEXT_COMPILE_TOOL_DESCRIPTION = 'Compile and persist an append-only scoped context packet from visible memory, raw, graph, and case evidence. AUTHORITY: OMIT scopes and connectors to use the current host-bound grants (recommended). Supply either field only to intentionally narrow the read; explicit values must remain authorized subsets and can never widen access. strictness is recall, balanced, or strict. Unavailable to Tier 3/read-only agents.';
-/** Temporal workers have one host-selected task and must not choose authority inputs. */
-exports.TEMPORAL_CONTEXT_COMPILE_INSTRUCTION = 'Do not supply scopes, connectors, or seed_refs to context_compile. The host-bound execution context applies the current generation project, connector, and memory grants and adds the active temporal task seed.';
-//# sourceMappingURL=context-compile-contract.js.map

package/dist/agent/context-compile-contract.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"context-compile-contract.js","sourceRoot":"","sources":["../../src/agent/context-compile-contract.ts"],"names":[],"mappings":";;;AAAA,oFAAoF;AACvE,QAAA,gCAAgC,GAC3C,iaAAia,CAAC;AAEpa,yFAAyF;AAC5E,QAAA,oCAAoC,GAC/C,kNAAkN,CAAC"}

package/dist/agent/context-compile-service.d.ts

@@ -1,60 +0,0 @@
-import { compileContext as defaultCompileContext, type ContextCompileInput, type ContextPacket, type ContextPacketRecord } from '@jungjaehoon/mama-core';
-import type { Envelope } from '../envelope/types.js';
-export interface ContextCompileStatement {
-    run: (...args: unknown[]) => unknown;
-    get: (...args: unknown[]) => unknown;
-    all: (...args: unknown[]) => unknown[];
-}
-export interface ContextCompileServiceAdapter {
-    prepare: (sql: string) => ContextCompileStatement;
-    transaction?: <T>(fn: () => T) => T;
-}
-export type ContextCompileCaller = 'http' | 'gateway' | string;
-export interface CompileAndPersistContextRequest {
-    caller: ContextCompileCaller;
-    envelope: Envelope;
-    /** Trusted per-gateway-call grant snapshot; keeps allowance and raw narrowing atomic. */
-    channelGrantSnapshot?: Readonly<Record<string, readonly string[]>>;
-    input: ContextCompileInput;
-    modelRunId?: string | null;
-    parentModelRunId?: string | null;
-    deadlineMs?: number;
-    signal?: AbortSignal;
-    /** Host-only authority guard, rechecked after async compilation and before persistence. */
-    beforePersist?: () => void;
-}
-export interface CompileAndPersistContextResult {
-    packet: ContextPacket;
-    record: ContextPacketRecord;
-    modelRunId: string;
-    parentModelRunId: string | null;
-}
-export interface ContextCompileService {
-    compileAndPersistContext(request: CompileAndPersistContextRequest): Promise<CompileAndPersistContextResult>;
-}
-export interface ContextCompileServiceOptions {
-    memoryAdapter: ContextCompileServiceAdapter;
-    compileContext?: typeof defaultCompileContext;
-    /**
-     * Which channels of each connector the owner has configured.
-     *
-     * Injected rather than read here so a test can state the grant instead of depending on
-     * whatever is in the running machine's config. Absent means no grant is carried and raw
-     * visibility falls back to the scope columns - which, measured on the live index, means
-     * the compile reads nothing at all.
-     */
-    channelGrant?: () => Record<string, readonly string[]>;
-    now?: () => number;
-    childModelRunId?: (request: CompileAndPersistContextRequest) => string;
-    packetId?: (request: CompileAndPersistContextRequest) => string;
-    logger?: {
-        error: (...args: unknown[]) => void;
-    };
-}
-export declare class ContextCompileServiceError extends Error {
-    readonly status: number;
-    readonly code: string;
-    constructor(status: number, code: string, message: string);
-}
-export declare function createContextCompileService(options: ContextCompileServiceOptions): ContextCompileService;
-//# sourceMappingURL=context-compile-service.d.ts.map

package/dist/agent/context-compile-service.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"context-compile-service.d.ts","sourceRoot":"","sources":["../../src/agent/context-compile-service.ts"],"names":[],"mappings":"AAEA,OAAO,EAKL,cAAc,IAAI,qBAAqB,EAQvC,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACzB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAMrD,MAAM,WAAW,uBAAuB;IACtC,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;IACrC,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;IACrC,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,EAAE,CAAC;CACxC;AAED,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,uBAAuB,CAAC;IAClD,WAAW,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;CACrC;AAED,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;AAE/D,MAAM,WAAW,+BAA+B;IAC9C,MAAM,EAAE,oBAAoB,CAAC;IAC7B,QAAQ,EAAE,QAAQ,CAAC;IACnB,yFAAyF;IACzF,oBAAoB,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,CAAC;IACnE,KAAK,EAAE,mBAAmB,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,2FAA2F;IAC3F,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,8BAA8B;IAC7C,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,qBAAqB;IACpC,wBAAwB,CACtB,OAAO,EAAE,+BAA+B,GACvC,OAAO,CAAC,8BAA8B,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,4BAA4B;IAC3C,aAAa,EAAE,4BAA4B,CAAC;IAC5C,cAAc,CAAC,EAAE,OAAO,qBAAqB,CAAC;IAC9C;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC;IACvD,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,+BAA+B,KAAK,MAAM,CAAC;IACvE,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,+BAA+B,KAAK,MAAM,CAAC;IAChE,MAAM,CAAC,EAAE;QACP,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;KACrC,CAAC;CACH;AAED,qBAAa,0BAA2B,SAAQ,KAAK;IACnD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAK1D;AAgdD,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,4BAA4B,GACpC,qBAAqB,CAyJvB"}