@jungjaehoon/mama-core 2.4.1 → 4.0.0

package/dist/context-compile/ref.d.ts

@@ -1,7 +0,0 @@
-import type { TwinRef } from '../edges/types.js';
-import type { ContextRef } from './types.js';
-export declare function normalizeContextRef(input: unknown): ContextRef;
-export declare function normalizeContextRefs(refs: readonly unknown[] | undefined): ContextRef[];
-export declare function serializeContextRefForProvenance(ref: ContextRef): string;
-export declare function toTwinRef(ref: ContextRef): TwinRef;
-//# sourceMappingURL=ref.d.ts.map

package/dist/context-compile/ref.js

@@ -1,102 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.normalizeContextRef = normalizeContextRef;
-exports.normalizeContextRefs = normalizeContextRefs;
-exports.serializeContextRefForProvenance = serializeContextRefForProvenance;
-exports.toTwinRef = toTwinRef;
-const SUPPORTED_KINDS = new Set(['memory', 'raw', 'entity', 'case']);
-const UNSUPPORTED_KINDS = new Set(['decision', 'wiki_page', 'context_packet', 'report']);
-function asRecord(value) {
-    if (value === null || typeof value !== 'object' || Array.isArray(value)) {
-        throw new Error('Context ref must be an object with a kind field');
-    }
-    return value;
-}
-function requiredString(value, field) {
-    if (typeof value !== 'string') {
-        throw new Error(`Context ref ${field} must be a string`);
-    }
-    const trimmed = value.trim();
-    if (trimmed.length === 0) {
-        throw new Error(`Context ref ${field} must not be empty`);
-    }
-    return trimmed;
-}
-function optionalString(value, field) {
-    if (value === undefined) {
-        return undefined;
-    }
-    if (typeof value !== 'string') {
-        throw new Error(`Context ref ${field} must be a string`);
-    }
-    const trimmed = value.trim();
-    return trimmed.length > 0 ? trimmed : undefined;
-}
-function optionalNullableString(value, field) {
-    if (value === null) {
-        return null;
-    }
-    return optionalString(value, field);
-}
-function normalizeContextRef(input) {
-    const record = asRecord(input);
-    const kind = record.kind;
-    if (typeof kind !== 'string') {
-        throw new Error('Context ref kind must be a string');
-    }
-    if (UNSUPPORTED_KINDS.has(kind) || !SUPPORTED_KINDS.has(kind)) {
-        throw new Error(`Unsupported V0 context ref kind: ${kind}`);
-    }
-    switch (kind) {
-        case 'raw': {
-            const normalized = {
-                kind,
-                raw_id: requiredString(record.raw_id, 'raw_id'),
-                connector: requiredString(record.connector, 'connector'),
-            };
-            const sourceId = optionalString(record.source_id, 'source_id');
-            const channelId = optionalNullableString(record.channel_id, 'channel_id');
-            if (sourceId !== undefined) {
-                normalized.source_id = sourceId;
-            }
-            if (channelId !== undefined) {
-                normalized.channel_id = channelId;
-            }
-            return normalized;
-        }
-        case 'memory':
-        case 'entity':
-        case 'case':
-            return {
-                kind,
-                id: requiredString(record.id, 'id'),
-            };
-        default:
-            throw new Error(`Unsupported V0 context ref kind: ${kind}`);
-    }
-}
-function normalizeContextRefs(refs) {
-    if (!Array.isArray(refs)) {
-        return [];
-    }
-    return refs.map((ref) => normalizeContextRef(ref));
-}
-function serializeContextRefForProvenance(ref) {
-    if (ref.kind === 'raw') {
-        return `raw:${ref.connector}:${ref.raw_id}`;
-    }
-    return `${ref.kind}:${ref.id}`;
-}
-function toTwinRef(ref) {
-    if (ref.kind === 'raw') {
-        return {
-            kind: 'raw',
-            id: ref.raw_id,
-        };
-    }
-    return {
-        kind: ref.kind,
-        id: ref.id,
-    };
-}
-//# sourceMappingURL=ref.js.map

package/dist/context-compile/source-readers.d.ts

@@ -1,70 +0,0 @@
-import type { DatabaseAdapter } from '../db-manager.js';
-import type { ListVisibleTwinEdgesOptions, TwinEdgeRecord, TwinRef } from '../edges/types.js';
-import type { RecallBundle, RecallMemoryOptions } from '../memory/types.js';
-import type { SearchHitDiagnostics, SearchStrictness } from '../search/search-quality.js';
-import type { ContextBoundary, ContextProjectRef, ContextRange, ContextRef } from './types.js';
-import type { MemoryScopeRef } from '../memory/types.js';
-type ContextSourceAdapter = Pick<DatabaseAdapter, 'prepare'>;
-export type ContextCandidateSource = 'memory' | 'raw' | 'graph';
-export type ContextCandidateKind = ContextRef['kind'];
-export interface ContextCandidateSupport {
-    retrieval_source?: string;
-    lexical_support?: boolean;
-    entity_support?: boolean;
-    scope_support?: boolean;
-    graph_source?: 'primary' | 'expanded' | null;
-    graph_expanded?: boolean;
-    is_vector_only?: boolean;
-    vector_similarity?: number | null;
-    confirmation_signals: string[];
-    metadata_signals: string[];
-}
-export interface ContextCandidate {
-    ref: ContextRef;
-    title: string;
-    excerpt: string;
-    score: number;
-    timestamp_ms: number | null;
-    source: ContextCandidateSource;
-    visible: boolean;
-    hidden_reason?: string;
-    support: ContextCandidateSupport;
-    retrieval_diagnostics?: SearchHitDiagnostics;
-    edge_id?: string;
-    edge_type?: string;
-}
-export interface HiddenCandidateAggregate {
-    total: number;
-    by_kind: Partial<Record<ContextCandidateKind, number>>;
-    by_reason: Record<string, number>;
-}
-export interface ContextSourceReadResult {
-    candidates: ContextCandidate[];
-    hidden: HiddenCandidateAggregate;
-    source_refs: ContextRef[];
-}
-export interface ContextSourceReadInput {
-    task: string;
-    scopes?: MemoryScopeRef[];
-    connectors?: string[];
-    project_refs?: ContextProjectRef[];
-    tenant_id?: string | null;
-    boundary?: ContextBoundary;
-    range?: ContextRange;
-    as_of?: string | number | null;
-    limit?: number;
-    threshold?: number;
-    strictness?: SearchStrictness;
-}
-export interface ContextSourceReaderDeps {
-    adapter?: ContextSourceAdapter;
-    recallMemory?: (query: string, options?: RecallMemoryOptions) => Promise<RecallBundle>;
-    listVisibleTwinEdgesForRefs?: (adapter: ContextSourceAdapter, refs: readonly TwinRef[], options?: ListVisibleTwinEdgesOptions) => TwinEdgeRecord[];
-}
-export declare function sourceRefsFromCandidates(candidates: readonly ContextCandidate[]): ContextRef[];
-export declare function readMemoryCandidates(input: ContextSourceReadInput, deps?: ContextSourceReaderDeps): Promise<ContextSourceReadResult>;
-export declare function readRawCandidates(adapter: ContextSourceAdapter, input: ContextSourceReadInput): ContextSourceReadResult;
-export declare function setContextSourceClockForTests(clock: () => number): void;
-export declare function readGraphCandidates(adapter: ContextSourceAdapter, input: ContextSourceReadInput, visibleRefs: readonly ContextRef[], deps?: ContextSourceReaderDeps): ContextSourceReadResult;
-export {};
-//# sourceMappingURL=source-readers.d.ts.map