@jungjaehoon/mama-core 2.4.1 → 4.1.0

package/dist/agent-situation/index.js

@@ -1,28 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.listVisibleEdgeCandidates = exports.listVisibleCaseCandidates = exports.listVisibleMemoryCandidates = exports.listVisibleRawCandidates = void 0;
-__exportStar(require("./types.js"), exports);
-__exportStar(require("./cache-key.js"), exports);
-__exportStar(require("./ranking-policy.js"), exports);
-var source_readers_js_1 = require("./source-readers.js");
-Object.defineProperty(exports, "listVisibleRawCandidates", { enumerable: true, get: function () { return source_readers_js_1.listVisibleRawCandidates; } });
-Object.defineProperty(exports, "listVisibleMemoryCandidates", { enumerable: true, get: function () { return source_readers_js_1.listVisibleMemoryCandidates; } });
-Object.defineProperty(exports, "listVisibleCaseCandidates", { enumerable: true, get: function () { return source_readers_js_1.listVisibleCaseCandidates; } });
-Object.defineProperty(exports, "listVisibleEdgeCandidates", { enumerable: true, get: function () { return source_readers_js_1.listVisibleEdgeCandidates; } });
-__exportStar(require("./builder.js"), exports);
-__exportStar(require("./packet-store.js"), exports);
-//# sourceMappingURL=index.js.map

package/dist/agent-situation/packet-store.d.ts

@@ -1,27 +0,0 @@
-import type { DatabaseAdapter } from '../db-manager.js';
-import type { AgentSituationLease, AgentSituationPacketRecord } from './types.js';
-type PacketStoreAdapter = Pick<DatabaseAdapter, 'prepare' | 'transaction'>;
-export interface AcquireAgentSituationLeaseInput {
-    cacheKey: string;
-    rankingPolicyVersion: string;
-    leaseOwner: string;
-    nowMs: number;
-    leaseSeconds: number;
-}
-export interface AgentSituationRefreshInput {
-    cacheKey: string;
-    rankingPolicyVersion: string;
-    nowMs: number;
-    leaseOwner: string;
-    leaseSeconds?: number;
-    pollIntervalMs?: number;
-    maxPollMs?: number;
-    refresh?: boolean;
-}
-export declare function getFreshAgentSituationPacket(adapter: PacketStoreAdapter, cacheKey: string, rankingPolicyVersion: string, nowMs: number): AgentSituationPacketRecord | null;
-export declare function insertAgentSituationPacket(adapter: PacketStoreAdapter, packet: AgentSituationPacketRecord): AgentSituationPacketRecord;
-export declare function acquireAgentSituationLease(adapter: PacketStoreAdapter, input: AcquireAgentSituationLeaseInput): AgentSituationLease | null;
-export declare function releaseAgentSituationLease(adapter: PacketStoreAdapter, cacheKey: string, leaseOwner: string): void;
-export declare function getOrRefreshAgentSituationPacket(adapter: PacketStoreAdapter, input: AgentSituationRefreshInput, builder: () => Promise<AgentSituationPacketRecord> | AgentSituationPacketRecord): Promise<AgentSituationPacketRecord>;
-export {};
-//# sourceMappingURL=packet-store.d.ts.map

package/dist/agent-situation/packet-store.js

@@ -1,228 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getFreshAgentSituationPacket = getFreshAgentSituationPacket;
-exports.insertAgentSituationPacket = insertAgentSituationPacket;
-exports.acquireAgentSituationLease = acquireAgentSituationLease;
-exports.releaseAgentSituationLease = releaseAgentSituationLease;
-exports.getOrRefreshAgentSituationPacket = getOrRefreshAgentSituationPacket;
-const inProcessRefreshesByAdapter = new WeakMap();
-function parseJson(row, field) {
-    const value = row[field];
-    if (typeof value !== 'string') {
-        throw new Error(`Invalid agent situation packet JSON field ${field}: expected string`);
-    }
-    try {
-        return JSON.parse(value);
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        throw new Error(`Invalid agent situation packet JSON field ${field}: ${message}`);
-    }
-}
-function inProcessRefreshesForAdapter(adapter) {
-    const existing = inProcessRefreshesByAdapter.get(adapter);
-    if (existing) {
-        return existing;
-    }
-    const scoped = new Map();
-    inProcessRefreshesByAdapter.set(adapter, scoped);
-    return scoped;
-}
-function mapPacketRow(row) {
-    return {
-        packet_id: String(row.packet_id),
-        cache_key: String(row.cache_key),
-        scope_json: String(row.scope_json),
-        scope: parseJson(row, 'scope_json'),
-        scope_hash: String(row.scope_hash),
-        range_start_ms: Number(row.range_start_ms),
-        range_end_ms: Number(row.range_end_ms),
-        focus_json: String(row.focus_json),
-        focus: parseJson(row, 'focus_json'),
-        envelope_hash: String(row.envelope_hash),
-        envelope_effective_filters_json: String(row.envelope_effective_filters_json),
-        envelope_effective_filters: parseJson(row, 'envelope_effective_filters_json'),
-        envelope_effective_filters_hash: String(row.envelope_effective_filters_hash),
-        ranking_policy_version: String(row.ranking_policy_version),
-        generated_at: Number(row.generated_at),
-        expires_at: Number(row.expires_at),
-        ttl_seconds: Number(row.ttl_seconds),
-        freshness_json: String(row.freshness_json),
-        freshness: parseJson(row, 'freshness_json'),
-        source_coverage_json: String(row.source_coverage_json),
-        source_coverage: parseJson(row, 'source_coverage_json'),
-        briefing_json: String(row.briefing_json),
-        briefing: parseJson(row, 'briefing_json'),
-        ranked_items_json: String(row.ranked_items_json),
-        ranked_items: parseJson(row, 'ranked_items_json'),
-        top_memory_refs_json: String(row.top_memory_refs_json),
-        top_memory_refs: parseJson(row, 'top_memory_refs_json'),
-        pending_human_questions_json: String(row.pending_human_questions_json),
-        pending_human_questions: parseJson(row, 'pending_human_questions_json'),
-        entity_clusters_json: String(row.entity_clusters_json),
-        entity_clusters: parseJson(row, 'entity_clusters_json'),
-        recommended_next_tools_json: String(row.recommended_next_tools_json),
-        recommended_next_tools: parseJson(row, 'recommended_next_tools_json'),
-        generated_from_slice_ids_json: String(row.generated_from_slice_ids_json),
-        generated_from_slice_ids: parseJson(row, 'generated_from_slice_ids_json'),
-        caveats_json: String(row.caveats_json),
-        caveats: parseJson(row, 'caveats_json'),
-        agent_id: String(row.agent_id),
-        model_run_id: String(row.model_run_id),
-        input_snapshot_ref: String(row.input_snapshot_ref),
-        source_refs_json: String(row.source_refs_json),
-        source_refs: parseJson(row, 'source_refs_json'),
-        tenant_id: String(row.tenant_id),
-        project_id: String(row.project_id),
-        memory_scope_kind: String(row.memory_scope_kind),
-        memory_scope_id: String(row.memory_scope_id),
-        created_at: Number(row.created_at),
-    };
-}
-function isDuplicateLeaseError(error) {
-    if (!(error instanceof Error)) {
-        return false;
-    }
-    return /UNIQUE constraint failed: agent_situation_refresh_leases\.cache_key|PRIMARY KEY constraint failed|SQLITE_CONSTRAINT_(PRIMARYKEY|UNIQUE)/i.test(error.message);
-}
-function mapLeaseRow(row) {
-    return {
-        cache_key: String(row.cache_key),
-        ranking_policy_version: String(row.ranking_policy_version),
-        lease_owner: String(row.lease_owner),
-        lease_expires_at: Number(row.lease_expires_at),
-        created_at: Number(row.created_at),
-    };
-}
-function getFreshAgentSituationPacket(adapter, cacheKey, rankingPolicyVersion, nowMs) {
-    const row = adapter
-        .prepare(`
-        SELECT *
-        FROM agent_situation_packets
-        WHERE cache_key = ?
-          AND ranking_policy_version = ?
-          AND expires_at > ?
-        ORDER BY expires_at DESC, generated_at DESC
-        LIMIT 1
-      `)
-        .get(cacheKey, rankingPolicyVersion, nowMs);
-    return row ? mapPacketRow(row) : null;
-}
-function insertAgentSituationPacket(adapter, packet) {
-    adapter
-        .prepare(`
-        INSERT INTO agent_situation_packets (
-          packet_id, cache_key, scope_json, scope_hash, range_start_ms, range_end_ms,
-          focus_json, envelope_hash, envelope_effective_filters_json,
-          envelope_effective_filters_hash, ranking_policy_version, generated_at, expires_at,
-          ttl_seconds, freshness_json, source_coverage_json, briefing_json, ranked_items_json,
-          top_memory_refs_json, pending_human_questions_json, entity_clusters_json,
-          recommended_next_tools_json, generated_from_slice_ids_json, caveats_json,
-          agent_id, model_run_id, input_snapshot_ref, source_refs_json, tenant_id, project_id,
-          memory_scope_kind, memory_scope_id, created_at
-        )
-        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
-      `)
-        .run(packet.packet_id, packet.cache_key, packet.scope_json, packet.scope_hash, packet.range_start_ms, packet.range_end_ms, packet.focus_json, packet.envelope_hash, packet.envelope_effective_filters_json, packet.envelope_effective_filters_hash, packet.ranking_policy_version, packet.generated_at, packet.expires_at, packet.ttl_seconds, packet.freshness_json, packet.source_coverage_json, packet.briefing_json, packet.ranked_items_json, packet.top_memory_refs_json, packet.pending_human_questions_json, packet.entity_clusters_json, packet.recommended_next_tools_json, packet.generated_from_slice_ids_json, packet.caveats_json, packet.agent_id, packet.model_run_id, packet.input_snapshot_ref, packet.source_refs_json, packet.tenant_id, packet.project_id, packet.memory_scope_kind, packet.memory_scope_id, packet.created_at);
-    const inserted = adapter
-        .prepare('SELECT * FROM agent_situation_packets WHERE packet_id = ?')
-        .get(packet.packet_id);
-    if (!inserted) {
-        throw new Error(`Agent situation packet insert failed: ${packet.packet_id}`);
-    }
-    return mapPacketRow(inserted);
-}
-function acquireAgentSituationLease(adapter, input) {
-    adapter
-        .prepare('DELETE FROM agent_situation_refresh_leases WHERE lease_expires_at <= ?')
-        .run(input.nowMs);
-    try {
-        adapter
-            .prepare(`
-          INSERT INTO agent_situation_refresh_leases (
-            cache_key, ranking_policy_version, lease_owner, lease_expires_at, created_at
-          )
-          VALUES (?, ?, ?, ?, ?)
-        `)
-            .run(input.cacheKey, input.rankingPolicyVersion, input.leaseOwner, input.nowMs + input.leaseSeconds * 1000, input.nowMs);
-    }
-    catch (error) {
-        if (isDuplicateLeaseError(error)) {
-            return null;
-        }
-        throw error;
-    }
-    const row = adapter
-        .prepare('SELECT * FROM agent_situation_refresh_leases WHERE cache_key = ?')
-        .get(input.cacheKey);
-    return row ? mapLeaseRow(row) : null;
-}
-function releaseAgentSituationLease(adapter, cacheKey, leaseOwner) {
-    adapter
-        .prepare('DELETE FROM agent_situation_refresh_leases WHERE cache_key = ? AND lease_owner = ?')
-        .run(cacheKey, leaseOwner);
-}
-function delay(ms) {
-    return new Promise((resolve) => setTimeout(resolve, ms));
-}
-async function waitForFreshPacket(adapter, input) {
-    const pollIntervalMs = input.pollIntervalMs ?? 50;
-    const maxPollMs = input.maxPollMs ?? 30_000;
-    const started = Date.now();
-    while (Date.now() - started < maxPollMs) {
-        const fresh = getFreshAgentSituationPacket(adapter, input.cacheKey, input.rankingPolicyVersion, input.nowMs);
-        if (fresh) {
-            return fresh;
-        }
-        await delay(pollIntervalMs);
-    }
-    return null;
-}
-async function getOrRefreshAgentSituationPacket(adapter, input, builder) {
-    if (!input.refresh) {
-        const fresh = getFreshAgentSituationPacket(adapter, input.cacheKey, input.rankingPolicyVersion, input.nowMs);
-        if (fresh) {
-            return fresh;
-        }
-    }
-    const refreshes = inProcessRefreshesForAdapter(adapter);
-    const key = `${input.cacheKey}:${input.rankingPolicyVersion}`;
-    const existing = refreshes.get(key);
-    if (existing) {
-        return existing;
-    }
-    const task = (async () => {
-        const lease = acquireAgentSituationLease(adapter, {
-            cacheKey: input.cacheKey,
-            rankingPolicyVersion: input.rankingPolicyVersion,
-            leaseOwner: input.leaseOwner,
-            nowMs: input.nowMs,
-            leaseSeconds: input.leaseSeconds ?? 30,
-        });
-        if (!lease) {
-            const fresh = await waitForFreshPacket(adapter, input);
-            if (fresh) {
-                return fresh;
-            }
-            throw new Error(`Timed out waiting for agent situation refresh lease for cache key ${input.cacheKey} and ranking policy ${input.rankingPolicyVersion}`);
-        }
-        try {
-            const built = await builder();
-            return insertAgentSituationPacket(adapter, built);
-        }
-        finally {
-            releaseAgentSituationLease(adapter, input.cacheKey, input.leaseOwner);
-        }
-    })();
-    refreshes.set(key, task);
-    try {
-        return await task;
-    }
-    finally {
-        refreshes.delete(key);
-        if (refreshes.size === 0) {
-            inProcessRefreshesByAdapter.delete(adapter);
-        }
-    }
-}
-//# sourceMappingURL=packet-store.js.map

package/dist/agent-situation/ranking-policy.d.ts

@@ -1,18 +0,0 @@
-import type { AgentSituationCandidate, SituationScore } from './types.js';
-export declare const AGENT_SITUATION_V0_POLICY_VERSION = "agent_situation.v0";
-export declare const AGENT_SITUATION_V0_WEIGHTS: {
-    readonly urgency: 0.35;
-    readonly confidence_gap: 0.2;
-    readonly debate_edge: 0.2;
-    readonly source_freshness: 0.2;
-    readonly cross_channel_signal: 0.15;
-    readonly pending_human_question: 0.1;
-    readonly open_question_urgency_boost: 0.2;
-};
-export interface AgentSituationRankingPolicy {
-    version: string;
-    weights: typeof AGENT_SITUATION_V0_WEIGHTS;
-}
-export declare function getAgentSituationRankingPolicy(version?: string): AgentSituationRankingPolicy;
-export declare function scoreAgentSituationCandidate(candidate: AgentSituationCandidate, policy: AgentSituationRankingPolicy): SituationScore;
-//# sourceMappingURL=ranking-policy.d.ts.map

package/dist/agent-situation/ranking-policy.js

@@ -1,75 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AGENT_SITUATION_V0_WEIGHTS = exports.AGENT_SITUATION_V0_POLICY_VERSION = void 0;
-exports.getAgentSituationRankingPolicy = getAgentSituationRankingPolicy;
-exports.scoreAgentSituationCandidate = scoreAgentSituationCandidate;
-exports.AGENT_SITUATION_V0_POLICY_VERSION = 'agent_situation.v0';
-exports.AGENT_SITUATION_V0_WEIGHTS = {
-    urgency: 0.35,
-    confidence_gap: 0.2,
-    debate_edge: 0.2,
-    source_freshness: 0.2,
-    cross_channel_signal: 0.15,
-    pending_human_question: 0.1,
-    open_question_urgency_boost: 0.2,
-};
-const V0_POLICY = {
-    version: exports.AGENT_SITUATION_V0_POLICY_VERSION,
-    weights: exports.AGENT_SITUATION_V0_WEIGHTS,
-};
-function textHasUrgency(candidate) {
-    const text = `${candidate.title} ${candidate.summary}`.toLowerCase();
-    return /\b(blocked|urgent|risk|deploy|release|needs?|review|failed|failing)\b/.test(text);
-}
-function freshnessScore(candidate) {
-    if (!Number.isFinite(candidate.timestamp_ms) || candidate.timestamp_ms <= 0) {
-        return 0;
-    }
-    const ageMs = Math.max(0, Date.now() - candidate.timestamp_ms);
-    const sevenDaysMs = 7 * 24 * 60 * 60 * 1000;
-    return Math.max(0, 1 - Math.min(ageMs, sevenDaysMs) / sevenDaysMs);
-}
-function getAgentSituationRankingPolicy(version = exports.AGENT_SITUATION_V0_POLICY_VERSION) {
-    if (version !== exports.AGENT_SITUATION_V0_POLICY_VERSION) {
-        throw new Error(`Unknown agent situation ranking policy: ${version}`);
-    }
-    return V0_POLICY;
-}
-function scoreAgentSituationCandidate(candidate, policy) {
-    const reasons = [];
-    const caveats = [];
-    let score = 0;
-    if (textHasUrgency(candidate)) {
-        score += policy.weights.urgency;
-        reasons.push('urgent_visible_signal');
-    }
-    const confidence = typeof candidate.confidence === 'number' ? candidate.confidence : 1;
-    if (confidence < 0.6) {
-        score += policy.weights.confidence_gap;
-        reasons.push('low_confidence_memory');
-        caveats.push('low_confidence_visible_memory');
-    }
-    if (candidate.has_debate_edge) {
-        score += policy.weights.debate_edge;
-        reasons.push('debated_visible_memory');
-    }
-    const freshness = freshnessScore(candidate);
-    if (freshness > 0) {
-        score += freshness * policy.weights.source_freshness;
-        reasons.push('recent_visible_source');
-    }
-    if (candidate.connector && candidate.channel_id) {
-        score += policy.weights.cross_channel_signal / 2;
-        reasons.push('visible_connector_context');
-    }
-    if (candidate.is_open_question) {
-        score += policy.weights.pending_human_question + policy.weights.open_question_urgency_boost;
-        reasons.push('pending_open_question');
-    }
-    return {
-        score: Number(score.toFixed(6)),
-        reasons: [...new Set(reasons)],
-        caveats: [...new Set(caveats)],
-    };
-}
-//# sourceMappingURL=ranking-policy.js.map

package/dist/agent-situation/source-readers.d.ts

@@ -1,52 +0,0 @@
-import type { DatabaseAdapter } from '../db-manager.js';
-import type { AgentSituationCandidate, AgentSituationEffectiveFilters, SituationRef } from './types.js';
-type SituationReaderAdapter = Pick<DatabaseAdapter, 'prepare'>;
-export interface AgentSituationSourceReadInput {
-    effective_filters: AgentSituationEffectiveFilters;
-    range_start_ms: number;
-    range_end_ms: number;
-    limit: number;
-}
-export interface VisibleRawCandidate extends AgentSituationCandidate {
-    ref: {
-        kind: 'raw';
-        id: string;
-    };
-    connector: string;
-    channel_id: string | null;
-    content: string;
-}
-export interface VisibleMemoryCandidate extends AgentSituationCandidate {
-    ref: {
-        kind: 'memory';
-        id: string;
-    };
-    topic: string;
-}
-export interface VisibleCaseCandidate extends AgentSituationCandidate {
-    ref: {
-        kind: 'case';
-        id: string;
-    };
-}
-export interface VisibleEdgeCandidate extends AgentSituationCandidate {
-    ref: {
-        kind: 'edge';
-        id: string;
-    };
-    subject_ref: SituationRef;
-    object_ref: SituationRef;
-}
-export interface VisibleAgentSituationSources {
-    raw: VisibleRawCandidate[];
-    memories: VisibleMemoryCandidate[];
-    cases: VisibleCaseCandidate[];
-    edges: VisibleEdgeCandidate[];
-}
-export declare function listVisibleRawCandidates(adapter: SituationReaderAdapter, input: AgentSituationSourceReadInput): VisibleRawCandidate[];
-export declare function listVisibleMemoryCandidates(adapter: SituationReaderAdapter, input: AgentSituationSourceReadInput): VisibleMemoryCandidate[];
-export declare function listVisibleCaseCandidates(adapter: SituationReaderAdapter, input: AgentSituationSourceReadInput): VisibleCaseCandidate[];
-export declare function listVisibleEdgeCandidates(adapter: SituationReaderAdapter, input: AgentSituationSourceReadInput, visibleRefs: SituationRef[]): VisibleEdgeCandidate[];
-export declare function listVisibleAgentSituationSources(adapter: SituationReaderAdapter, input: AgentSituationSourceReadInput): VisibleAgentSituationSources;
-export {};
-//# sourceMappingURL=source-readers.d.ts.map