@jungjaehoon/mama-core 2.4.1 → 4.1.0

package/dist/agent-situation/source-readers.js

@@ -1,300 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.listVisibleRawCandidates = listVisibleRawCandidates;
-exports.listVisibleMemoryCandidates = listVisibleMemoryCandidates;
-exports.listVisibleCaseCandidates = listVisibleCaseCandidates;
-exports.listVisibleEdgeCandidates = listVisibleEdgeCandidates;
-exports.listVisibleAgentSituationSources = listVisibleAgentSituationSources;
-const types_js_1 = require("../memory/types.js");
-function placeholders(values) {
-    return values.map(() => '?').join(', ');
-}
-function scopeKey(scope) {
-    return `${scope.kind}:${scope.id}`;
-}
-function refKey(ref) {
-    return `${ref.kind}:${ref.id}`;
-}
-function tableExists(adapter, table) {
-    const row = adapter
-        .prepare("SELECT name FROM sqlite_master WHERE type='table' AND name = ?")
-        .get(table);
-    return Boolean(row?.name);
-}
-function normalizeLimit(limit) {
-    return Math.max(0, Math.min(100, Math.floor(limit)));
-}
-function visibilityEndMs(input) {
-    const asOf = input.effective_filters.as_of;
-    if (!asOf) {
-        return input.range_end_ms;
-    }
-    const parsed = Date.parse(asOf);
-    if (!Number.isFinite(parsed)) {
-        throw new Error(`Invalid agent situation as_of: ${asOf}`);
-    }
-    return Math.min(input.range_end_ms, parsed);
-}
-function parseCaseScopeRefs(row) {
-    const caseId = String(row.case_id ?? '<unknown>');
-    if (typeof row.scope_refs !== 'string' || row.scope_refs.length === 0) {
-        throw new Error(`Invalid case_truth.scope_refs for case ${caseId}: expected a JSON array string.`);
-    }
-    let parsed;
-    try {
-        parsed = JSON.parse(row.scope_refs);
-    }
-    catch {
-        throw new Error(`Invalid case_truth.scope_refs for case ${caseId}: malformed JSON.`);
-    }
-    if (!Array.isArray(parsed)) {
-        throw new Error(`Invalid case_truth.scope_refs for case ${caseId}: expected a JSON array.`);
-    }
-    return parsed.map((scope, index) => {
-        if (!scope || typeof scope !== 'object') {
-            throw new Error(`Invalid case_truth.scope_refs for case ${caseId}: entry ${index} must be an object.`);
-        }
-        const record = scope;
-        if (typeof record.kind !== 'string' ||
-            typeof record.id !== 'string' ||
-            !types_js_1.MEMORY_SCOPE_KINDS.includes(record.kind)) {
-            throw new Error(`Invalid case_truth.scope_refs for case ${caseId}: entry ${index} must include a valid kind and id.`);
-        }
-        return { kind: record.kind, id: record.id };
-    });
-}
-function isScopeVisible(scope, effective) {
-    const visible = new Set(effective.scopes.map(scopeKey));
-    return visible.has(scopeKey(scope));
-}
-function caseTimestampMs(row) {
-    const caseId = String(row.case_id ?? 'unknown');
-    const timestampFields = [
-        ['last_activity_at', row.last_activity_at],
-        ['updated_at', row.updated_at],
-        ['created_at', row.created_at],
-    ];
-    for (const [field, value] of timestampFields) {
-        if (value === null || value === undefined || value === '') {
-            continue;
-        }
-        if (typeof value !== 'string') {
-            throw new Error(`Invalid case_truth timestamp for case ${caseId}: ${field} must be an ISO timestamp string.`);
-        }
-        if (typeof value === 'string') {
-            const parsed = Date.parse(value);
-            if (Number.isFinite(parsed)) {
-                return parsed;
-            }
-        }
-    }
-    throw new Error(`Invalid case_truth timestamp for case ${caseId}: expected last_activity_at, updated_at, or created_at to contain a valid ISO timestamp.`);
-}
-function isOpenQuestion(row) {
-    const text = `${String(row.topic ?? '')} ${String(row.decision ?? '')} ${String(row.summary ?? '')}`;
-    return row.kind === 'task' || text.includes('?') || /\b(question|decide|answer)\b/i.test(text);
-}
-function listVisibleRawCandidates(adapter, input) {
-    if (!tableExists(adapter, 'connector_event_index')) {
-        return [];
-    }
-    const connectors = input.effective_filters.connectors;
-    const scopes = input.effective_filters.scopes;
-    const projectIds = input.effective_filters.project_refs.map((project) => project.id);
-    if (connectors.length === 0 || scopes.length === 0 || projectIds.length === 0) {
-        return [];
-    }
-    const endMs = visibilityEndMs(input);
-    const scopeClauses = scopes
-        .map(() => '(memory_scope_kind = ? AND memory_scope_id = ?)')
-        .join(' OR ');
-    const params = [input.effective_filters.tenant_id, ...projectIds, ...connectors];
-    for (const scope of scopes) {
-        params.push(scope.kind, scope.id);
-    }
-    params.push(input.range_start_ms, endMs, normalizeLimit(input.limit));
-    const rows = adapter
-        .prepare(`
-        SELECT event_index_id, source_connector, channel, title, content, event_datetime,
-               memory_scope_kind, memory_scope_id
-        FROM connector_event_index
-        WHERE tenant_id = ?
-          AND project_id IN (${placeholders(projectIds)})
-          AND source_connector IN (${placeholders(connectors)})
-          AND (${scopeClauses})
-          AND event_datetime BETWEEN ? AND ?
-        ORDER BY event_datetime DESC, event_index_id ASC
-        LIMIT ?
-      `)
-        .all(...params);
-    return rows.map((row) => ({
-        ref: { kind: 'raw', id: String(row.event_index_id) },
-        kind: 'raw',
-        title: String(row.title ?? 'Untitled raw event'),
-        summary: String(row.content ?? '').slice(0, 240),
-        content: String(row.content ?? ''),
-        timestamp_ms: Number(row.event_datetime),
-        connector: String(row.source_connector),
-        channel_id: typeof row.channel === 'string' ? row.channel : null,
-        scope: typeof row.memory_scope_kind === 'string' && typeof row.memory_scope_id === 'string'
-            ? { kind: row.memory_scope_kind, id: row.memory_scope_id }
-            : null,
-    }));
-}
-function listVisibleMemoryCandidates(adapter, input) {
-    if (!tableExists(adapter, 'decisions')) {
-        return [];
-    }
-    const scopes = input.effective_filters.scopes;
-    if (scopes.length === 0) {
-        return [];
-    }
-    const endMs = visibilityEndMs(input);
-    const scopeClauses = scopes.map(() => '(ms.kind = ? AND ms.external_id = ?)').join(' OR ');
-    const params = [];
-    for (const scope of scopes) {
-        params.push(scope.kind, scope.id);
-    }
-    params.push(input.range_start_ms, endMs, normalizeLimit(input.limit));
-    const rows = adapter
-        .prepare(`
-        SELECT DISTINCT d.id, d.topic, d.decision, d.reasoning, d.kind, d.status, d.summary,
-               d.confidence, d.event_datetime, d.created_at, ms.kind AS scope_kind,
-               ms.external_id AS scope_id
-        FROM decisions d
-        JOIN memory_scope_bindings msb ON msb.memory_id = d.id
-        JOIN memory_scopes ms ON ms.id = msb.scope_id
-        WHERE (${scopeClauses})
-          AND COALESCE(d.event_datetime, d.created_at) BETWEEN ? AND ?
-        ORDER BY COALESCE(d.event_datetime, d.created_at) DESC, d.id ASC
-        LIMIT ?
-      `)
-        .all(...params);
-    return rows.map((row) => ({
-        ref: { kind: 'memory', id: String(row.id) },
-        kind: 'memory',
-        title: String(row.topic ?? row.decision ?? 'Memory'),
-        summary: String(row.summary ?? row.decision ?? row.reasoning ?? ''),
-        topic: String(row.topic ?? ''),
-        timestamp_ms: Number(row.event_datetime ?? row.created_at ?? 0),
-        confidence: typeof row.confidence === 'number' ? row.confidence : Number(row.confidence ?? 1),
-        status: typeof row.status === 'string' ? row.status : null,
-        is_open_question: isOpenQuestion(row),
-        has_debate_edge: false,
-        scope: typeof row.scope_kind === 'string' && typeof row.scope_id === 'string'
-            ? { kind: row.scope_kind, id: row.scope_id }
-            : null,
-    }));
-}
-function listVisibleCaseCandidates(adapter, input) {
-    if (!tableExists(adapter, 'case_truth')) {
-        return [];
-    }
-    const endMs = visibilityEndMs(input);
-    const rows = adapter
-        .prepare(`
-        SELECT case_id, title, status, confidence, scope_refs, last_activity_at, updated_at, created_at
-        FROM case_truth
-        ORDER BY COALESCE(last_activity_at, updated_at, created_at) DESC, case_id ASC
-      `)
-        .all();
-    return rows
-        .map((row) => {
-        const timestamp = caseTimestampMs(row);
-        if (timestamp < input.range_start_ms || timestamp > endMs) {
-            return null;
-        }
-        const visibleScope = parseCaseScopeRefs(row).find((scope) => isScopeVisible(scope, input.effective_filters));
-        if (!visibleScope) {
-            return null;
-        }
-        return {
-            ref: { kind: 'case', id: String(row.case_id) },
-            kind: 'case',
-            title: String(row.title ?? 'Case'),
-            summary: String(row.status ?? ''),
-            timestamp_ms: timestamp,
-            confidence: row.confidence === 'low' ? 0.4 : row.confidence === 'medium' ? 0.7 : 1,
-            status: typeof row.status === 'string' ? row.status : null,
-            scope: visibleScope,
-        };
-    })
-        .filter((row) => Boolean(row))
-        .slice(0, normalizeLimit(input.limit));
-}
-function listVisibleEdgeCandidates(adapter, input, visibleRefs) {
-    if (!tableExists(adapter, 'twin_edges')) {
-        return [];
-    }
-    const visible = new Set(visibleRefs.map(refKey));
-    if (visible.size === 0) {
-        return [];
-    }
-    const uniqueVisibleRefs = [...new Map(visibleRefs.map((ref) => [refKey(ref), ref])).values()];
-    const subjectClauses = uniqueVisibleRefs
-        .map(() => '(subject_kind = ? AND subject_id = ?)')
-        .join(' OR ');
-    const objectClauses = uniqueVisibleRefs
-        .map(() => '(object_kind = ? AND object_id = ?)')
-        .join(' OR ');
-    const params = [input.range_start_ms, visibilityEndMs(input)];
-    for (const ref of uniqueVisibleRefs) {
-        params.push(ref.kind, ref.id);
-    }
-    for (const ref of uniqueVisibleRefs) {
-        params.push(ref.kind, ref.id);
-    }
-    params.push(normalizeLimit(input.limit));
-    const rows = adapter
-        .prepare(`
-        SELECT edge_id, edge_type, subject_kind, subject_id, object_kind, object_id,
-               confidence, reason_text, created_at
-        FROM twin_edges
-        WHERE created_at BETWEEN ? AND ?
-          AND (${subjectClauses})
-          AND (${objectClauses})
-        ORDER BY created_at DESC, edge_id ASC
-        LIMIT ?
-      `)
-        .all(...params);
-    return rows
-        .map((row) => {
-        const subject = {
-            kind: String(row.subject_kind),
-            id: String(row.subject_id),
-        };
-        const object = {
-            kind: String(row.object_kind),
-            id: String(row.object_id),
-        };
-        if (!visible.has(refKey(subject)) || !visible.has(refKey(object))) {
-            return null;
-        }
-        return {
-            ref: { kind: 'edge', id: String(row.edge_id) },
-            kind: String(row.edge_type),
-            title: String(row.edge_type),
-            summary: String(row.reason_text ?? ''),
-            timestamp_ms: Number(row.created_at),
-            confidence: typeof row.confidence === 'number' ? row.confidence : Number(row.confidence ?? 1),
-            status: null,
-            subject_ref: subject,
-            object_ref: object,
-        };
-    })
-        .filter((row) => Boolean(row))
-        .slice(0, normalizeLimit(input.limit));
-}
-function listVisibleAgentSituationSources(adapter, input) {
-    const raw = listVisibleRawCandidates(adapter, input);
-    const memories = listVisibleMemoryCandidates(adapter, input);
-    const cases = listVisibleCaseCandidates(adapter, input);
-    const visibleRefs = [
-        ...raw.map((item) => item.ref),
-        ...memories.map((item) => item.ref),
-        ...cases.map((item) => item.ref),
-    ];
-    const edges = listVisibleEdgeCandidates(adapter, input, visibleRefs);
-    return { raw, memories, cases, edges };
-}
-//# sourceMappingURL=source-readers.js.map

package/dist/agent-situation/types.d.ts

@@ -1,195 +0,0 @@
-import type { MemoryScopeRef } from '../memory/types.js';
-import type { TwinRef } from '../edges/types.js';
-export type SituationFocus = 'decisions' | 'risks' | 'open_questions' | 'cases' | 'raw';
-export type SituationRefKind = TwinRef['kind'] | 'memory';
-export interface SituationRef {
-    kind: SituationRefKind;
-    id: string;
-}
-export interface SituationProjectRef {
-    kind: 'project';
-    id: string;
-}
-export interface AgentSituationEffectiveFilters {
-    scopes: MemoryScopeRef[];
-    connectors: string[];
-    project_refs: SituationProjectRef[];
-    tenant_id: string;
-    as_of?: string | null;
-}
-export interface AgentSituationCacheKeyInput extends AgentSituationEffectiveFilters {
-    range_start_ms: number;
-    range_end_ms: number;
-    focus: SituationFocus[];
-    limit: number;
-    ranking_policy_version: string;
-}
-export interface AgentSituationCacheKeyResult {
-    cacheKey: string;
-    canonicalInput: AgentSituationCacheKeyInput;
-    canonicalJson: string;
-    filtersHash: string;
-    scopeHash: string;
-}
-export type SituationCaveatCode = 'connector_stale' | 'some_sources_unavailable' | 'low_confidence_visible_memory' | 'graph_api_unavailable_until_m6' | 'case_visibility_incomplete' | 'no_visible_sources';
-export interface SituationSourceCoverage {
-    connector?: string;
-    channel_id?: string | null;
-    memory_scope?: MemoryScopeRef;
-    raw_count: number;
-    memory_count: number;
-    case_count: number;
-    edge_count: number;
-    last_seen: string | null;
-    stale: boolean;
-}
-export interface SituationBriefing {
-    decisions: string[];
-    facts: string[];
-    open_questions: string[];
-    risks: string[];
-}
-export interface SituationRankedItem {
-    ref: SituationRef;
-    kind: string;
-    score: number;
-    reasons: string[];
-    caveats: string[];
-}
-export interface SituationPendingHumanQuestion {
-    memory_id: string;
-    title: string;
-    summary: string;
-}
-export interface SituationEntityCluster {
-    label: string;
-    entity_refs: Array<{
-        kind: 'entity';
-        id: string;
-    }>;
-    source_refs: Array<{
-        kind: 'raw' | 'memory' | 'case';
-        id: string;
-    }>;
-    caveats: string[];
-}
-export interface SituationRecommendedTool {
-    tool: 'raw.search' | 'raw.searchAll' | 'raw.window' | 'memory.recall' | 'graph.neighborhood';
-    args: Record<string, unknown>;
-    reason: string;
-    expected_refs: SituationRef[];
-}
-export interface AgentSituationPacket {
-    packet_id: string;
-    scope: MemoryScopeRef[];
-    range_start: string;
-    range_end: string;
-    generated_at: string;
-    freshness: Record<string, unknown>;
-    source_coverage: SituationSourceCoverage[];
-    briefing: SituationBriefing;
-    ranked_items: SituationRankedItem[];
-    top_memory_refs: string[];
-    pending_human_questions: SituationPendingHumanQuestion[];
-    entity_clusters: SituationEntityCluster[];
-    recommended_next_tools: SituationRecommendedTool[];
-    ranking_policy_version: string;
-    ttl_seconds: number;
-    generated_from_slice_ids: string[];
-    caveats: string[];
-    cache: {
-        hit: boolean;
-        cache_key: string;
-        expires_at: string;
-    };
-}
-export interface AgentSituationInput {
-    scope: MemoryScopeRef[];
-    range_start_ms: number;
-    range_end_ms: number;
-    focus: SituationFocus[];
-    limit: number;
-    effective_filters: AgentSituationEffectiveFilters;
-    envelope_hash: string;
-    agent_id: string;
-    model_run_id: string;
-    ranking_policy_version?: string;
-    refresh?: boolean;
-    now_ms?: number;
-}
-export interface AgentSituationPacketRecord {
-    packet_id: string;
-    cache_key: string;
-    scope_json: string;
-    scope: MemoryScopeRef[];
-    scope_hash: string;
-    range_start_ms: number;
-    range_end_ms: number;
-    focus_json: string;
-    focus: SituationFocus[];
-    envelope_hash: string;
-    envelope_effective_filters_json: string;
-    envelope_effective_filters: AgentSituationEffectiveFilters;
-    envelope_effective_filters_hash: string;
-    ranking_policy_version: string;
-    generated_at: number;
-    expires_at: number;
-    ttl_seconds: number;
-    freshness_json: string;
-    freshness: Record<string, unknown>;
-    source_coverage_json: string;
-    source_coverage: SituationSourceCoverage[];
-    briefing_json: string;
-    briefing: SituationBriefing;
-    ranked_items_json: string;
-    ranked_items: SituationRankedItem[];
-    top_memory_refs_json: string;
-    top_memory_refs: string[];
-    pending_human_questions_json: string;
-    pending_human_questions: SituationPendingHumanQuestion[];
-    entity_clusters_json: string;
-    entity_clusters: SituationEntityCluster[];
-    recommended_next_tools_json: string;
-    recommended_next_tools: SituationRecommendedTool[];
-    generated_from_slice_ids_json: string;
-    generated_from_slice_ids: string[];
-    caveats_json: string;
-    caveats: string[];
-    agent_id: string;
-    model_run_id: string;
-    input_snapshot_ref: string;
-    source_refs_json: string;
-    source_refs: SituationRef[];
-    tenant_id: string;
-    project_id: string;
-    memory_scope_kind: MemoryScopeRef['kind'];
-    memory_scope_id: string;
-    created_at: number;
-}
-export interface AgentSituationLease {
-    cache_key: string;
-    ranking_policy_version: string;
-    lease_owner: string;
-    lease_expires_at: number;
-    created_at: number;
-}
-export interface AgentSituationCandidate {
-    ref: SituationRef;
-    kind: string;
-    title: string;
-    summary: string;
-    timestamp_ms: number;
-    confidence?: number | null;
-    status?: string | null;
-    is_open_question?: boolean;
-    has_debate_edge?: boolean;
-    connector?: string | null;
-    channel_id?: string | null;
-    scope?: MemoryScopeRef | null;
-}
-export interface SituationScore {
-    score: number;
-    reasons: string[];
-    caveats: string[];
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/cases/wiki-page-index.d.ts

@@ -1,37 +0,0 @@
-import type { DatabaseAdapter as DBManagerAdapter } from '../db-manager.js';
-export type AdapterLike = Pick<DBManagerAdapter, 'prepare' | 'transaction'>;
-export interface WikiPageIndexRecord {
-    id: number;
-    source_locator: string;
-    page_type: 'entity' | 'lesson' | 'synthesis' | 'process' | 'case';
-    title: string;
-    content: string;
-    case_id: string | null;
-    source_ids: string[];
-    entity_refs: string[];
-    confidence: 'high' | 'medium' | 'low' | null;
-    compiled_at: string;
-    created_at: string;
-    updated_at: string;
-}
-export interface WikiPageSearchHit {
-    record: WikiPageIndexRecord;
-    rank: number;
-    raw_score: number;
-}
-export interface UpsertWikiPageIndexInput {
-    source_locator: string;
-    page_type: WikiPageIndexRecord['page_type'];
-    title: string;
-    content: string;
-    case_id?: string | null;
-    source_ids: string[];
-    entity_refs: string[];
-    confidence: WikiPageIndexRecord['confidence'];
-    compiled_at: string;
-    embedding?: Float32Array | null;
-    embedding_model?: string;
-}
-export declare function ftsSearchWikiPages(adapter: AdapterLike, query: string, limit: number): WikiPageSearchHit[];
-export declare function vectorSearchWikiPages(adapter: AdapterLike, queryEmbedding: Float32Array, limit: number): WikiPageSearchHit[];
-//# sourceMappingURL=wiki-page-index.d.ts.map