ai-memory-layer 2.0.0

package/dist/contracts/types.d.ts

@@ -0,0 +1,381 @@
+import type { MemoryScope, NormalizedMemoryScope } from './identity.js';
+export type TurnRole = 'user' | 'assistant' | 'system';
+export type CompactionTrigger = 'soft' | 'hard' | 'session_gap' | 'manual';
+export type FactType = 'preference' | 'entity' | 'decision' | 'constraint' | 'reference';
+export type FactSource = 'user_stated' | 'promoted_from_working' | 'manual';
+export type FactConfidence = 'high' | 'medium' | 'low';
+export type VerificationStatus = 'unverified' | 'corroborated' | 'verified' | 'tool_verified';
+export type KnowledgeRelation = 'duplicate' | 'compatible' | 'update' | 'conflict';
+export type KnowledgeState = 'candidate' | 'provisional' | 'trusted' | 'disputed' | 'superseded' | 'retired';
+export type KnowledgeClass = 'identity' | 'preference' | 'constraint' | 'procedure' | 'strategy' | 'anti_pattern' | 'project_fact' | 'episodic_fact';
+export type EvidenceSourceType = 'user_turn' | 'assistant_turn' | 'system_turn' | 'tool_output' | 'execution_result' | 'human_feedback' | 'working_memory_summary' | 'manual' | 'imported';
+export type SupportPolarity = 'supports' | 'contradicts';
+export type GroundingStrength = 'weak' | 'moderate' | 'strong' | 'tool_verified';
+export type KnowledgeDecision = 'promote_candidate' | 'keep_provisional' | 'reject_candidate' | 'mark_disputed' | 'supersede_existing';
+export type KnowledgeAuditDecision = 'created' | 'duplicate' | 'compatible' | 'updated' | 'conflict' | 'skipped_low_confidence';
+export type CompactionState = 'idle' | 'soft_triggered' | 'hard_triggered' | 'compacting';
+export type WorkItemKind = 'objective' | 'unresolved_work' | 'constraint';
+export type WorkItemStatus = 'open' | 'in_progress' | 'blocked' | 'done';
+export declare const TURN_ROLES: readonly TurnRole[];
+export declare const COMPACTION_TRIGGERS: readonly CompactionTrigger[];
+export declare const FACT_TYPES: readonly FactType[];
+export declare const FACT_SOURCES: readonly FactSource[];
+export declare const FACT_CONFIDENCES: readonly FactConfidence[];
+export declare const KNOWLEDGE_STATES: readonly KnowledgeState[];
+export declare const KNOWLEDGE_CLASSES: readonly KnowledgeClass[];
+export declare const EVIDENCE_SOURCE_TYPES: readonly EvidenceSourceType[];
+export declare const SUPPORT_POLARITIES: readonly SupportPolarity[];
+export declare const GROUNDING_STRENGTHS: readonly GroundingStrength[];
+export declare const VERIFICATION_STATUSES: readonly VerificationStatus[];
+export declare const KNOWLEDGE_RELATIONS: readonly KnowledgeRelation[];
+export declare const KNOWLEDGE_AUDIT_DECISIONS: readonly KnowledgeAuditDecision[];
+export declare const COMPACTION_STATES: readonly CompactionState[];
+export declare const WORK_ITEM_KINDS: readonly WorkItemKind[];
+export declare const WORK_ITEM_STATUSES: readonly WorkItemStatus[];
+export interface Turn extends NormalizedMemoryScope {
+    id: number;
+    session_id: string;
+    actor: string;
+    role: TurnRole;
+    content: string;
+    priority: number;
+    token_estimate: number;
+    created_at: number;
+    archived_at: number | null;
+    compaction_log_id: number | null;
+    schema_version: number;
+}
+export interface NewTurn extends MemoryScope {
+    session_id: string;
+    actor: string;
+    role: TurnRole;
+    content: string;
+    priority?: number;
+    token_estimate?: number;
+    created_at?: number;
+}
+export interface WorkingMemory extends NormalizedMemoryScope {
+    id: number;
+    session_id: string;
+    summary: string;
+    key_entities: string[];
+    topic_tags: string[];
+    turn_id_start: number;
+    turn_id_end: number;
+    turn_count: number;
+    compaction_trigger: CompactionTrigger;
+    created_at: number;
+    expires_at: number | null;
+    promoted_to_knowledge_id: number | null;
+    schema_version: number;
+}
+export interface NewWorkingMemory extends MemoryScope {
+    session_id: string;
+    summary: string;
+    key_entities: string[];
+    topic_tags: string[];
+    turn_id_start: number;
+    turn_id_end: number;
+    turn_count: number;
+    compaction_trigger: CompactionTrigger;
+    expires_at?: number | null;
+}
+export interface KnowledgeMemory extends NormalizedMemoryScope {
+    id: number;
+    fact: string;
+    fact_type: FactType;
+    knowledge_state: KnowledgeState;
+    knowledge_class: KnowledgeClass;
+    fact_subject: string | null;
+    fact_attribute: string | null;
+    fact_value: string | null;
+    normalized_fact: string | null;
+    slot_key: string | null;
+    is_negated: boolean;
+    source: FactSource;
+    confidence: FactConfidence;
+    confidence_score: number;
+    grounding_strength: GroundingStrength;
+    evidence_count: number;
+    trust_score: number;
+    verification_status: VerificationStatus;
+    verification_notes: string | null;
+    last_verified_at: number | null;
+    next_reverification_at: number | null;
+    last_confirmed_at: number | null;
+    confirmation_count: number;
+    source_system_id: string | null;
+    source_scope_id: string | null;
+    source_collaboration_id: string | null;
+    source_working_memory_id: number | null;
+    source_turn_ids: number[];
+    successful_use_count: number;
+    failed_use_count: number;
+    disputed_at: number | null;
+    dispute_reason: string | null;
+    contradiction_score: number;
+    superseded_at: number | null;
+    superseded_by_id: number | null;
+    retired_at: number | null;
+    created_at: number;
+    last_accessed_at: number;
+    access_count: number;
+    schema_version: number;
+}
+export interface NewKnowledgeMemory extends MemoryScope {
+    fact: string;
+    fact_type: FactType;
+    knowledge_state?: KnowledgeState;
+    knowledge_class?: KnowledgeClass;
+    fact_subject?: string | null;
+    fact_attribute?: string | null;
+    fact_value?: string | null;
+    normalized_fact?: string | null;
+    slot_key?: string | null;
+    is_negated?: boolean;
+    source: FactSource;
+    confidence: FactConfidence;
+    confidence_score?: number;
+    grounding_strength?: GroundingStrength;
+    evidence_count?: number;
+    trust_score?: number;
+    verification_status?: VerificationStatus;
+    verification_notes?: string | null;
+    last_verified_at?: number | null;
+    next_reverification_at?: number | null;
+    last_confirmed_at?: number | null;
+    confirmation_count?: number;
+    source_system_id?: string | null;
+    source_scope_id?: string | null;
+    source_collaboration_id?: string | null;
+    source_working_memory_id?: number | null;
+    source_turn_ids?: number[];
+    successful_use_count?: number;
+    failed_use_count?: number;
+    disputed_at?: number | null;
+    dispute_reason?: string | null;
+    contradiction_score?: number;
+    superseded_at?: number | null;
+    retired_at?: number | null;
+}
+export interface KnowledgeMemoryAudit extends NormalizedMemoryScope {
+    id: number;
+    working_memory_id: number | null;
+    fact: string;
+    fact_type: FactType;
+    fact_subject: string | null;
+    fact_attribute: string | null;
+    fact_value: string | null;
+    normalized_fact: string | null;
+    slot_key: string | null;
+    is_negated: boolean;
+    confidence: FactConfidence;
+    confidence_score: number;
+    verification_status: VerificationStatus;
+    source_text: string | null;
+    decision: KnowledgeAuditDecision;
+    created_knowledge_id: number | null;
+    related_knowledge_id: number | null;
+    detail: string | null;
+    created_at: number;
+}
+export interface NewKnowledgeMemoryAudit extends MemoryScope {
+    working_memory_id?: number | null;
+    fact: string;
+    fact_type: FactType;
+    fact_subject?: string | null;
+    fact_attribute?: string | null;
+    fact_value?: string | null;
+    normalized_fact?: string | null;
+    slot_key?: string | null;
+    is_negated?: boolean;
+    confidence: FactConfidence;
+    confidence_score?: number;
+    verification_status?: VerificationStatus;
+    source_text?: string | null;
+    decision: KnowledgeAuditDecision;
+    created_knowledge_id?: number | null;
+    related_knowledge_id?: number | null;
+    detail?: string | null;
+    created_at?: number;
+}
+export interface KnowledgeCandidate extends NormalizedMemoryScope {
+    id: number;
+    working_memory_id: number;
+    fact: string;
+    fact_type: FactType;
+    knowledge_class: KnowledgeClass;
+    normalized_fact: string;
+    slot_key: string | null;
+    confidence: FactConfidence;
+    source_summary: boolean;
+    source_turns: boolean;
+    grounding_strength: GroundingStrength;
+    evidence_count: number;
+    trust_score: number;
+    state: 'candidate' | 'provisional';
+    created_at: number;
+    promoted_knowledge_id: number | null;
+}
+export interface NewKnowledgeCandidate extends MemoryScope {
+    working_memory_id: number;
+    fact: string;
+    fact_type: FactType;
+    knowledge_class: KnowledgeClass;
+    normalized_fact: string;
+    slot_key?: string | null;
+    confidence: FactConfidence;
+    source_summary?: boolean;
+    source_turns?: boolean;
+    grounding_strength?: GroundingStrength;
+    evidence_count?: number;
+    trust_score?: number;
+    state?: 'candidate' | 'provisional';
+    created_at?: number;
+    promoted_knowledge_id?: number | null;
+}
+export interface KnowledgeEvidence extends NormalizedMemoryScope {
+    id: number;
+    knowledge_memory_id: number | null;
+    knowledge_candidate_id: number | null;
+    working_memory_id: number | null;
+    turn_id: number | null;
+    source_type: EvidenceSourceType;
+    support_polarity: SupportPolarity;
+    speaker_role: TurnRole | null;
+    actor: string | null;
+    excerpt: string;
+    start_offset: number | null;
+    end_offset: number | null;
+    is_explicit: boolean;
+    explicitness_score: number;
+    outcome: 'success' | 'failure' | 'neutral' | null;
+    created_at: number;
+}
+export interface NewKnowledgeEvidence extends MemoryScope {
+    knowledge_memory_id?: number | null;
+    knowledge_candidate_id?: number | null;
+    working_memory_id?: number | null;
+    turn_id?: number | null;
+    source_type: EvidenceSourceType;
+    support_polarity: SupportPolarity;
+    speaker_role?: TurnRole | null;
+    actor?: string | null;
+    excerpt: string;
+    start_offset?: number | null;
+    end_offset?: number | null;
+    is_explicit?: boolean;
+    explicitness_score?: number;
+    outcome?: 'success' | 'failure' | 'neutral' | null;
+    created_at?: number;
+}
+export interface KnowledgeTrustAssessment {
+    trust_score: number;
+    state: KnowledgeState;
+    decision: KnowledgeDecision;
+    reasons: string[];
+}
+export interface KnowledgeConflict {
+    existing_knowledge_id: number;
+    candidate_id: number | null;
+    relation: 'duplicate' | 'update' | 'conflict' | 'compatible';
+    severity: 'low' | 'medium' | 'high';
+    resolution: 'ignore' | 'dispute' | 'supersede';
+}
+export interface ContextMonitor extends NormalizedMemoryScope {
+    id: number;
+    compaction_state: CompactionState;
+    last_compaction_at: number | null;
+    active_turn_count: number;
+    active_token_estimate: number;
+    compaction_score: number;
+    updated_at: number;
+}
+export interface ContextMonitorUpsert extends MemoryScope {
+    compaction_state: CompactionState;
+    last_compaction_at?: number | null;
+    active_turn_count: number;
+    active_token_estimate: number;
+    compaction_score: number;
+}
+export interface CompactionLog extends NormalizedMemoryScope {
+    id: number;
+    session_id: string;
+    trigger_type: CompactionTrigger;
+    turn_id_start: number;
+    turn_id_end: number;
+    turns_compacted: number;
+    tokens_compacted_estimate: number;
+    working_memory_id: number;
+    active_turn_count_before: number;
+    active_turn_count_after: number;
+    duration_ms: number;
+    model_call_made: boolean;
+    error?: string | null;
+    created_at: number;
+}
+export interface NewCompactionLog extends MemoryScope {
+    session_id: string;
+    trigger_type: CompactionTrigger;
+    turn_id_start: number;
+    turn_id_end: number;
+    turns_compacted: number;
+    tokens_compacted_estimate: number;
+    working_memory_id: number;
+    active_turn_count_before: number;
+    active_turn_count_after: number;
+    duration_ms: number;
+    model_call_made?: boolean;
+    error?: string | null;
+    created_at?: number;
+}
+export interface SearchOptions {
+    limit?: number;
+    activeOnly?: boolean;
+    includeProvisional?: boolean;
+    includeDisputed?: boolean;
+    minimumTrustScore?: number;
+    knowledgeStates?: KnowledgeState[];
+    knowledgeClasses?: KnowledgeClass[];
+    preferLocalTrusted?: boolean;
+    preferLineageMemory?: boolean;
+}
+export interface SearchResult<T> {
+    item: T;
+    rank: number;
+}
+export interface PaginationOptions {
+    limit?: number;
+    offset?: number;
+    cursor?: number;
+}
+export interface PaginatedResult<T> {
+    items: T[];
+    hasMore: boolean;
+    nextCursor: number | null;
+}
+export interface TimeRange {
+    start_at?: number;
+    end_at?: number;
+}
+export interface WorkItem extends NormalizedMemoryScope {
+    id: number;
+    session_id: string | null;
+    kind: WorkItemKind;
+    title: string;
+    detail: string | null;
+    status: WorkItemStatus;
+    source_working_memory_id: number | null;
+    created_at: number;
+    updated_at: number;
+}
+export interface NewWorkItem extends MemoryScope {
+    session_id?: string | null;
+    kind: WorkItemKind;
+    title: string;
+    detail?: string | null;
+    status?: WorkItemStatus;
+    source_working_memory_id?: number | null;
+    created_at?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/contracts/types.d.ts.map

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

package/dist/contracts/types.js

@@ -0,0 +1,94 @@
+export const TURN_ROLES = ['user', 'assistant', 'system'];
+export const COMPACTION_TRIGGERS = [
+    'soft',
+    'hard',
+    'session_gap',
+    'manual',
+];
+export const FACT_TYPES = [
+    'preference',
+    'entity',
+    'decision',
+    'constraint',
+    'reference',
+];
+export const FACT_SOURCES = [
+    'user_stated',
+    'promoted_from_working',
+    'manual',
+];
+export const FACT_CONFIDENCES = ['high', 'medium', 'low'];
+export const KNOWLEDGE_STATES = [
+    'candidate',
+    'provisional',
+    'trusted',
+    'disputed',
+    'superseded',
+    'retired',
+];
+export const KNOWLEDGE_CLASSES = [
+    'identity',
+    'preference',
+    'constraint',
+    'procedure',
+    'strategy',
+    'anti_pattern',
+    'project_fact',
+    'episodic_fact',
+];
+export const EVIDENCE_SOURCE_TYPES = [
+    'user_turn',
+    'assistant_turn',
+    'system_turn',
+    'tool_output',
+    'execution_result',
+    'human_feedback',
+    'working_memory_summary',
+    'manual',
+    'imported',
+];
+export const SUPPORT_POLARITIES = ['supports', 'contradicts'];
+export const GROUNDING_STRENGTHS = [
+    'weak',
+    'moderate',
+    'strong',
+    'tool_verified',
+];
+export const VERIFICATION_STATUSES = [
+    'unverified',
+    'corroborated',
+    'verified',
+    'tool_verified',
+];
+export const KNOWLEDGE_RELATIONS = [
+    'duplicate',
+    'compatible',
+    'update',
+    'conflict',
+];
+export const KNOWLEDGE_AUDIT_DECISIONS = [
+    'created',
+    'duplicate',
+    'compatible',
+    'updated',
+    'conflict',
+    'skipped_low_confidence',
+];
+export const COMPACTION_STATES = [
+    'idle',
+    'soft_triggered',
+    'hard_triggered',
+    'compacting',
+];
+export const WORK_ITEM_KINDS = [
+    'objective',
+    'unresolved_work',
+    'constraint',
+];
+export const WORK_ITEM_STATUSES = [
+    'open',
+    'in_progress',
+    'blocked',
+    'done',
+];
+//# sourceMappingURL=types.js.map

package/dist/contracts/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/contracts/types.ts"],"names":[],"mappings":"AA+DA,MAAM,CAAC,MAAM,UAAU,GAAwB,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;AAC/E,MAAM,CAAC,MAAM,mBAAmB,GAAiC;IAC/D,MAAM;IACN,MAAM;IACN,aAAa;IACb,QAAQ;CACT,CAAC;AACF,MAAM,CAAC,MAAM,UAAU,GAAwB;IAC7C,YAAY;IACZ,QAAQ;IACR,UAAU;IACV,YAAY;IACZ,WAAW;CACZ,CAAC;AACF,MAAM,CAAC,MAAM,YAAY,GAA0B;IACjD,aAAa;IACb,uBAAuB;IACvB,QAAQ;CACT,CAAC;AACF,MAAM,CAAC,MAAM,gBAAgB,GAA8B,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;AACrF,MAAM,CAAC,MAAM,gBAAgB,GAA8B;IACzD,WAAW;IACX,aAAa;IACb,SAAS;IACT,UAAU;IACV,YAAY;IACZ,SAAS;CACV,CAAC;AACF,MAAM,CAAC,MAAM,iBAAiB,GAA8B;IAC1D,UAAU;IACV,YAAY;IACZ,YAAY;IACZ,WAAW;IACX,UAAU;IACV,cAAc;IACd,cAAc;IACd,eAAe;CAChB,CAAC;AACF,MAAM,CAAC,MAAM,qBAAqB,GAAkC;IAClE,WAAW;IACX,gBAAgB;IAChB,aAAa;IACb,aAAa;IACb,kBAAkB;IAClB,gBAAgB;IAChB,wBAAwB;IACxB,QAAQ;IACR,UAAU;CACX,CAAC;AACF,MAAM,CAAC,MAAM,kBAAkB,GAA+B,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;AAC1F,MAAM,CAAC,MAAM,mBAAmB,GAAiC;IAC/D,MAAM;IACN,UAAU;IACV,QAAQ;IACR,eAAe;CAChB,CAAC;AACF,MAAM,CAAC,MAAM,qBAAqB,GAAkC;IAClE,YAAY;IACZ,cAAc;IACd,UAAU;IACV,eAAe;CAChB,CAAC;AACF,MAAM,CAAC,MAAM,mBAAmB,GAAiC;IAC/D,WAAW;IACX,YAAY;IACZ,QAAQ;IACR,UAAU;CACX,CAAC;AACF,MAAM,CAAC,MAAM,yBAAyB,GAAsC;IAC1E,SAAS;IACT,WAAW;IACX,YAAY;IACZ,SAAS;IACT,UAAU;IACV,wBAAwB;CACzB,CAAC;AACF,MAAM,CAAC,MAAM,iBAAiB,GAA+B;IAC3D,MAAM;IACN,gBAAgB;IAChB,gBAAgB;IAChB,YAAY;CACb,CAAC;AACF,MAAM,CAAC,MAAM,eAAe,GAA4B;IACtD,WAAW;IACX,iBAAiB;IACjB,YAAY;CACb,CAAC;AACF,MAAM,CAAC,MAAM,kBAAkB,GAA8B;IAC3D,MAAM;IACN,aAAa;IACb,SAAS;IACT,MAAM;CACP,CAAC"}

package/dist/core/circuit-breaker.d.ts

@@ -0,0 +1,11 @@
+export type CircuitState = 'closed' | 'open' | 'half_open';
+export interface CircuitBreakerOptions {
+    failureThreshold?: number;
+    resetTimeoutMs?: number;
+}
+export interface CircuitBreaker {
+    readonly state: CircuitState;
+    execute<T>(run: () => Promise<T>): Promise<T>;
+}
+export declare function createCircuitBreaker(options?: CircuitBreakerOptions): CircuitBreaker;
+//# sourceMappingURL=circuit-breaker.d.ts.map

package/dist/core/circuit-breaker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.d.ts","sourceRoot":"","sources":["../../src/core/circuit-breaker.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;AAE3D,MAAM,WAAW,qBAAqB;IACpC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAC/C;AAED,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,qBAA0B,GAAG,cAAc,CAuCxF"}

package/dist/core/circuit-breaker.js

@@ -0,0 +1,38 @@
+export function createCircuitBreaker(options = {}) {
+    const failureThreshold = options.failureThreshold ?? 3;
+    const resetTimeoutMs = options.resetTimeoutMs ?? 30_000;
+    let state = 'closed';
+    let failures = 0;
+    let openedAt = 0;
+    function canProbe() {
+        return state === 'open' && Date.now() - openedAt >= resetTimeoutMs;
+    }
+    return {
+        get state() {
+            return canProbe() ? 'half_open' : state;
+        },
+        async execute(run) {
+            if (state === 'open' && !canProbe()) {
+                throw new Error('Circuit breaker is open');
+            }
+            if (canProbe()) {
+                state = 'half_open';
+            }
+            try {
+                const result = await run();
+                failures = 0;
+                state = 'closed';
+                return result;
+            }
+            catch (error) {
+                failures += 1;
+                if (failures >= failureThreshold || state === 'half_open') {
+                    state = 'open';
+                    openedAt = Date.now();
+                }
+                throw error;
+            }
+        },
+    };
+}
+//# sourceMappingURL=circuit-breaker.js.map

package/dist/core/circuit-breaker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.js","sourceRoot":"","sources":["../../src/core/circuit-breaker.ts"],"names":[],"mappings":"AAYA,MAAM,UAAU,oBAAoB,CAAC,UAAiC,EAAE;IACtE,MAAM,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,IAAI,CAAC,CAAC;IACvD,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,MAAM,CAAC;IACxD,IAAI,KAAK,GAAiB,QAAQ,CAAC;IACnC,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,QAAQ,GAAG,CAAC,CAAC;IAEjB,SAAS,QAAQ;QACf,OAAO,KAAK,KAAK,MAAM,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,IAAI,cAAc,CAAC;IACrE,CAAC;IAED,OAAO;QACL,IAAI,KAAK;YACP,OAAO,QAAQ,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC;QAC1C,CAAC;QAED,KAAK,CAAC,OAAO,CAAI,GAAqB;YACpC,IAAI,KAAK,KAAK,MAAM,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC;gBACpC,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;YAC7C,CAAC;YACD,IAAI,QAAQ,EAAE,EAAE,CAAC;gBACf,KAAK,GAAG,WAAW,CAAC;YACtB,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,GAAG,EAAE,CAAC;gBAC3B,QAAQ,GAAG,CAAC,CAAC;gBACb,KAAK,GAAG,QAAQ,CAAC;gBACjB,OAAO,MAAM,CAAC;YAChB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,QAAQ,IAAI,CAAC,CAAC;gBACd,IAAI,QAAQ,IAAI,gBAAgB,IAAI,KAAK,KAAK,WAAW,EAAE,CAAC;oBAC1D,KAAK,GAAG,MAAM,CAAC;oBACf,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBACxB,CAAC;gBACD,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/core/context.d.ts

@@ -0,0 +1,56 @@
+import type { EmbeddingAdapter, EmbeddingVector } from '../contracts/embedding.js';
+import { type MemoryScope, type ScopeLevel } from '../contracts/identity.js';
+import type { EventHook, Logger } from '../contracts/observability.js';
+import type { ContextMode, ContextPolicy } from '../contracts/policy.js';
+import type { KnowledgeMemory, Turn, WorkItem, WorkingMemory } from '../contracts/types.js';
+import type { AsyncStorageAdapter } from '../contracts/async-storage.js';
+import { type TokenEstimator } from './tokens.js';
+export interface ContextAssemblyOptions {
+    sessionId?: string;
+    crossScopeLevel?: ScopeLevel;
+    mode?: ContextMode;
+    maxKnowledgeItems?: number;
+    maxRecentSummaries?: number;
+    relevanceQuery?: string;
+    tokenBudget?: number;
+    queryVector?: EmbeddingVector;
+    embeddingAdapter?: EmbeddingAdapter;
+    policy?: ContextPolicy;
+    logger?: Logger;
+    onEvent?: EventHook;
+    tokenEstimator?: TokenEstimator;
+    asOf?: number;
+}
+export interface KnowledgeSelectionReason {
+    knowledgeMemoryId: number;
+    bucket: 'trusted_core' | 'task_relevant' | 'provisional' | 'disputed';
+    lexicalScore: number;
+    semanticScore: number;
+    recencyScore: number;
+    importanceScore: number;
+    trustScore: number;
+    classImportanceScore: number;
+    diversityPenalty: number;
+    finalScore: number;
+    explanation: string;
+}
+export interface MemoryContext {
+    mode: ContextMode;
+    activeTurns: Turn[];
+    workingMemory: WorkingMemory | null;
+    trustedCoreMemory: KnowledgeMemory[];
+    taskRelevantKnowledge: KnowledgeMemory[];
+    provisionalKnowledge: KnowledgeMemory[];
+    disputedKnowledge: KnowledgeMemory[];
+    relevantKnowledge: KnowledgeMemory[];
+    durableKnowledge: KnowledgeMemory[];
+    recentSummaries: WorkingMemory[];
+    currentObjective: string | null;
+    activeObjectives: WorkItem[];
+    activeState: string[];
+    unresolvedWork: string[];
+    knowledgeSelectionReasons: KnowledgeSelectionReason[];
+    tokenEstimate: number;
+}
+export declare function buildMemoryContext(adapter: AsyncStorageAdapter, scope: MemoryScope, options?: ContextAssemblyOptions): Promise<MemoryContext>;
+//# sourceMappingURL=context.d.ts.map

package/dist/core/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/core/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACnF,OAAO,EAAkB,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC7F,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEzE,OAAO,KAAK,EACV,eAAe,EAEf,IAAI,EACJ,QAAQ,EACR,aAAa,EACd,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAIlE,MAAM,WAAW,sBAAsB;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,UAAU,CAAC;IAC7B,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,wBAAwB;IACvC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,cAAc,GAAG,eAAe,GAAG,aAAa,GAAG,UAAU,CAAC;IACtE,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,WAAW,CAAC;IAClB,WAAW,EAAE,IAAI,EAAE,CAAC;IACpB,aAAa,EAAE,aAAa,GAAG,IAAI,CAAC;IACpC,iBAAiB,EAAE,eAAe,EAAE,CAAC;IACrC,qBAAqB,EAAE,eAAe,EAAE,CAAC;IACzC,oBAAoB,EAAE,eAAe,EAAE,CAAC;IACxC,iBAAiB,EAAE,eAAe,EAAE,CAAC;IACrC,iBAAiB,EAAE,eAAe,EAAE,CAAC;IACrC,gBAAgB,EAAE,eAAe,EAAE,CAAC;IACpC,eAAe,EAAE,aAAa,EAAE,CAAC;IACjC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,gBAAgB,EAAE,QAAQ,EAAE,CAAC;IAC7B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,yBAAyB,EAAE,wBAAwB,EAAE,CAAC;IACtD,aAAa,EAAE,MAAM,CAAC;CACvB;AAkRD,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,WAAW,EAClB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,aAAa,CAAC,CAuQxB"}