@remnic/core 1.0.1 → 1.0.3

package/dist/access-schema.d.ts

@@ -18,28 +18,28 @@ declare const recallRequestSchema: z.ZodObject<{
     includeDebug: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     query: string;
-    sessionKey?: string | undefined;
     namespace?: string | undefined;
     topK?: number | undefined;
-    mode?: "auto" | "no_recall" | "minimal" | "full" | "graph_mode" | undefined;
+    mode?: "no_recall" | "minimal" | "full" | "graph_mode" | "auto" | undefined;
+    sessionKey?: string | undefined;
     includeDebug?: boolean | undefined;
 }, {
     query: string;
-    sessionKey?: string | undefined;
     namespace?: string | undefined;
     topK?: number | undefined;
-    mode?: "auto" | "no_recall" | "minimal" | "full" | "graph_mode" | undefined;
+    mode?: "no_recall" | "minimal" | "full" | "graph_mode" | "auto" | undefined;
+    sessionKey?: string | undefined;
     includeDebug?: boolean | undefined;
 }>;
 declare const recallExplainRequestSchema: z.ZodObject<{
     sessionKey: z.ZodOptional<z.ZodString>;
     namespace: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    sessionKey?: string | undefined;
     namespace?: string | undefined;
-}, {
     sessionKey?: string | undefined;
+}, {
     namespace?: string | undefined;
+    sessionKey?: string | undefined;
 }>;
 declare const observeRequestSchema: z.ZodObject<{
     sessionKey: z.ZodString;
@@ -47,27 +47,27 @@ declare const observeRequestSchema: z.ZodObject<{
         role: z.ZodEnum<["user", "assistant"]>;
         content: z.ZodString;
     }, "strip", z.ZodTypeAny, {
-        role: "user" | "assistant";
         content: string;
-    }, {
         role: "user" | "assistant";
+    }, {
         content: string;
+        role: "user" | "assistant";
     }>, "many">;
     namespace: z.ZodOptional<z.ZodString>;
     skipExtraction: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     sessionKey: string;
     messages: {
-        role: "user" | "assistant";
         content: string;
+        role: "user" | "assistant";
     }[];
     namespace?: string | undefined;
     skipExtraction?: boolean | undefined;
 }, {
     sessionKey: string;
     messages: {
-        role: "user" | "assistant";
         content: string;
+        role: "user" | "assistant";
     }[];
     namespace?: string | undefined;
     skipExtraction?: boolean | undefined;
@@ -78,7 +78,7 @@ declare const memoryStoreRequestSchema: z.ZodObject<{
     dryRun: z.ZodOptional<z.ZodBoolean>;
     sessionKey: z.ZodOptional<z.ZodString>;
     content: z.ZodString;
-    category: z.ZodOptional<z.ZodEnum<["fact", "preference", "correction", "entity", "decision", "relationship", "principle", "commitment", "moment", "skill", "rule"]>>;
+    category: z.ZodOptional<z.ZodEnum<["fact", "preference", "correction", "entity", "decision", "relationship", "principle", "commitment", "moment", "skill", "rule", "procedure"]>>;
     confidence: z.ZodOptional<z.ZodNumber>;
     namespace: z.ZodOptional<z.ZodString>;
     tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -87,30 +87,30 @@ declare const memoryStoreRequestSchema: z.ZodObject<{
     sourceReason: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     content: string;
-    sessionKey?: string | undefined;
     namespace?: string | undefined;
-    schemaVersion?: number | undefined;
-    idempotencyKey?: string | undefined;
-    dryRun?: boolean | undefined;
-    category?: "fact" | "preference" | "correction" | "entity" | "decision" | "relationship" | "principle" | "commitment" | "moment" | "skill" | "rule" | undefined;
+    category?: "fact" | "preference" | "correction" | "entity" | "decision" | "relationship" | "principle" | "commitment" | "moment" | "skill" | "rule" | "procedure" | undefined;
     confidence?: number | undefined;
+    ttl?: string | undefined;
     tags?: string[] | undefined;
     entityRef?: string | undefined;
-    ttl?: string | undefined;
+    schemaVersion?: number | undefined;
+    sessionKey?: string | undefined;
+    dryRun?: boolean | undefined;
     sourceReason?: string | undefined;
+    idempotencyKey?: string | undefined;
 }, {
     content: string;
-    sessionKey?: string | undefined;
     namespace?: string | undefined;
-    schemaVersion?: number | undefined;
-    idempotencyKey?: string | undefined;
-    dryRun?: boolean | undefined;
-    category?: "fact" | "preference" | "correction" | "entity" | "decision" | "relationship" | "principle" | "commitment" | "moment" | "skill" | "rule" | undefined;
+    category?: "fact" | "preference" | "correction" | "entity" | "decision" | "relationship" | "principle" | "commitment" | "moment" | "skill" | "rule" | "procedure" | undefined;
     confidence?: number | undefined;
+    ttl?: string | undefined;
     tags?: string[] | undefined;
     entityRef?: string | undefined;
-    ttl?: string | undefined;
+    schemaVersion?: number | undefined;
+    sessionKey?: string | undefined;
+    dryRun?: boolean | undefined;
     sourceReason?: string | undefined;
+    idempotencyKey?: string | undefined;
 }>;
 declare const suggestionSubmitRequestSchema: z.ZodObject<{
     schemaVersion: z.ZodOptional<z.ZodNumber>;
@@ -118,7 +118,7 @@ declare const suggestionSubmitRequestSchema: z.ZodObject<{
     dryRun: z.ZodOptional<z.ZodBoolean>;
     sessionKey: z.ZodOptional<z.ZodString>;
     content: z.ZodString;
-    category: z.ZodOptional<z.ZodEnum<["fact", "preference", "correction", "entity", "decision", "relationship", "principle", "commitment", "moment", "skill", "rule"]>>;
+    category: z.ZodOptional<z.ZodEnum<["fact", "preference", "correction", "entity", "decision", "relationship", "principle", "commitment", "moment", "skill", "rule", "procedure"]>>;
     confidence: z.ZodOptional<z.ZodNumber>;
     namespace: z.ZodOptional<z.ZodString>;
     tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -127,30 +127,30 @@ declare const suggestionSubmitRequestSchema: z.ZodObject<{
     sourceReason: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     content: string;
-    sessionKey?: string | undefined;
     namespace?: string | undefined;
-    schemaVersion?: number | undefined;
-    idempotencyKey?: string | undefined;
-    dryRun?: boolean | undefined;
-    category?: "fact" | "preference" | "correction" | "entity" | "decision" | "relationship" | "principle" | "commitment" | "moment" | "skill" | "rule" | undefined;
+    category?: "fact" | "preference" | "correction" | "entity" | "decision" | "relationship" | "principle" | "commitment" | "moment" | "skill" | "rule" | "procedure" | undefined;
     confidence?: number | undefined;
+    ttl?: string | undefined;
     tags?: string[] | undefined;
     entityRef?: string | undefined;
-    ttl?: string | undefined;
+    schemaVersion?: number | undefined;
+    sessionKey?: string | undefined;
+    dryRun?: boolean | undefined;
     sourceReason?: string | undefined;
+    idempotencyKey?: string | undefined;
 }, {
     content: string;
-    sessionKey?: string | undefined;
     namespace?: string | undefined;
-    schemaVersion?: number | undefined;
-    idempotencyKey?: string | undefined;
-    dryRun?: boolean | undefined;
-    category?: "fact" | "preference" | "correction" | "entity" | "decision" | "relationship" | "principle" | "commitment" | "moment" | "skill" | "rule" | undefined;
+    category?: "fact" | "preference" | "correction" | "entity" | "decision" | "relationship" | "principle" | "commitment" | "moment" | "skill" | "rule" | "procedure" | undefined;
     confidence?: number | undefined;
+    ttl?: string | undefined;
     tags?: string[] | undefined;
     entityRef?: string | undefined;
-    ttl?: string | undefined;
+    schemaVersion?: number | undefined;
+    sessionKey?: string | undefined;
+    dryRun?: boolean | undefined;
     sourceReason?: string | undefined;
+    idempotencyKey?: string | undefined;
 }>;
 declare const reviewDispositionRequestSchema: z.ZodObject<{
     memoryId: z.ZodString;
@@ -158,14 +158,14 @@ declare const reviewDispositionRequestSchema: z.ZodObject<{
     reasonCode: z.ZodString;
     namespace: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    status: "active" | "pending_review" | "quarantined" | "rejected" | "superseded" | "archived";
-    memoryId: string;
+    status: "active" | "pending_review" | "rejected" | "quarantined" | "superseded" | "archived";
     reasonCode: string;
+    memoryId: string;
     namespace?: string | undefined;
 }, {
-    status: "active" | "pending_review" | "quarantined" | "rejected" | "superseded" | "archived";
-    memoryId: string;
+    status: "active" | "pending_review" | "rejected" | "quarantined" | "superseded" | "archived";
     reasonCode: string;
+    memoryId: string;
     namespace?: string | undefined;
 }>;
 declare const trustZonePromoteRequestSchema: z.ZodObject<{
@@ -181,17 +181,17 @@ declare const trustZonePromoteRequestSchema: z.ZodObject<{
     targetZone: "working" | "trusted";
     promotionReason: string;
     namespace?: string | undefined;
+    summary?: string | undefined;
     dryRun?: boolean | undefined;
     recordedAt?: string | undefined;
-    summary?: string | undefined;
 }, {
     recordId: string;
     targetZone: "working" | "trusted";
     promotionReason: string;
     namespace?: string | undefined;
+    summary?: string | undefined;
     dryRun?: boolean | undefined;
     recordedAt?: string | undefined;
-    summary?: string | undefined;
 }>;
 declare const trustZoneDemoSeedRequestSchema: z.ZodObject<{
     scenario: z.ZodOptional<z.ZodString>;
@@ -216,27 +216,27 @@ declare const lcmSearchRequestSchema: z.ZodObject<{
     limit: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
     query: string;
-    sessionKey?: string | undefined;
     namespace?: string | undefined;
     limit?: number | undefined;
+    sessionKey?: string | undefined;
 }, {
     query: string;
-    sessionKey?: string | undefined;
     namespace?: string | undefined;
     limit?: number | undefined;
+    sessionKey?: string | undefined;
 }>;
 declare const daySummaryRequestSchema: z.ZodObject<{
     memories: z.ZodOptional<z.ZodString>;
     sessionKey: z.ZodOptional<z.ZodString>;
     namespace: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    sessionKey?: string | undefined;
     namespace?: string | undefined;
     memories?: string | undefined;
-}, {
     sessionKey?: string | undefined;
+}, {
     namespace?: string | undefined;
     memories?: string | undefined;
+    sessionKey?: string | undefined;
 }>;
 type RecallRequest = z.infer<typeof recallRequestSchema>;
 type RecallExplainRequest = z.infer<typeof recallExplainRequestSchema>;

package/dist/access-schema.js

@@ -11,7 +11,7 @@ import {
   trustZoneDemoSeedRequestSchema,
   trustZonePromoteRequestSchema,
   validateRequest
-} from "./chunk-PGK3VUHN.js";
+} from "./chunk-MTLYEMJB.js";
 export {
   daySummaryRequestSchema,
   formatZodError,

package/dist/access-service.d.ts

@@ -1,12 +1,13 @@
 import { DaySummaryResult, RecallPlanMode, MemoryFile, MemoryLifecycleEvent, EntityFile, MemoryStatus } from './types.js';
 import { ExplicitCaptureInput } from './explicit-capture.js';
-import { r as readMemoryGovernanceRunArtifact } from './memory-projection-store-NxMkbocT.js';
+import { r as readMemoryGovernanceRunArtifact } from './memory-projection-store-DeSXPh1j.js';
 import { LastRecallSnapshot } from './recall-state.js';
-import { O as Orchestrator, I as IntentDebugSnapshot, G as GraphRecallSnapshot } from './orchestrator-CIvLFHx3.js';
+import { O as Orchestrator, I as IntentDebugSnapshot, G as GraphRecallSnapshot } from './orchestrator-B9kwlCep.js';
 import { TrustZoneStoreStatus, TrustZoneName, TrustZoneRecordKind, TrustZoneSourceClass, TrustZoneProvenanceScore, TrustZonePromotionResult, TrustZoneDemoSeedResult } from './trust-zones.js';
 import 'better-sqlite3';
 import './buffer.js';
 import './storage.js';
+import './page-versioning.js';
 import './port-C1GZFv8h.js';
 import './transcript.js';
 import './session-integrity.js';
@@ -17,7 +18,9 @@ import './relevance.js';
 import './negative.js';
 import './session-observer-state.js';
 import './embedding-fallback.js';
-import './semantic-consolidation.js';
+import './semantic-consolidation-DrvSYRdB.js';
+import './codex-materialize-CQlLTzke.js';
+import './logger.js';
 import 'zod';
 import './policy-runtime.js';
 import './profiling.js';
@@ -79,6 +82,28 @@ interface EngramAccessDaySummaryRequest {
     sessionKey?: string;
     namespace?: string;
 }
+/** Inputs accepted by the `remnic_briefing` MCP tool. */
+interface EngramAccessBriefingRequest {
+    since?: string;
+    focus?: string;
+    namespace?: string;
+    format?: "markdown" | "json";
+    maxFollowups?: number;
+    /** Caller principal for namespace access checks. Transport-bound — never from untrusted payloads. */
+    principal?: string;
+}
+/** Response for `remnic_briefing`. */
+interface EngramAccessBriefingResponse {
+    format: "markdown" | "json";
+    window: {
+        from: string;
+        to: string;
+    };
+    namespace: string;
+    markdown: string;
+    json: Record<string, unknown>;
+    followupsUnavailableReason?: string;
+}
 interface EngramAccessMemoryRecord {
     id: string;
     path: string;
@@ -349,6 +374,7 @@ declare class EngramAccessService {
     private readonly idempotency;
     private readonly idempotencyLocks;
     constructor(orchestrator: Orchestrator);
+    get briefingEnabled(): boolean;
     private resolveNamespace;
     private normalizeRecallMode;
     private resolveRecallNamespace;
@@ -362,6 +388,11 @@ declare class EngramAccessService {
     private withIdempotencyLock;
     health(namespace?: string): Promise<EngramAccessHealthResponse>;
     daySummary(request: EngramAccessDaySummaryRequest): Promise<DaySummaryResult | null>;
+    /**
+     * Build a daily context briefing. Gracefully degrades when the OpenAI key
+     * or Responses API is unavailable — never throws for LLM-related problems.
+     */
+    briefing(request: EngramAccessBriefingRequest): Promise<EngramAccessBriefingResponse>;
     recall(request: EngramAccessRecallRequest): Promise<EngramAccessRecallResponse>;
     recallExplain(request?: EngramAccessRecallExplainRequest): Promise<EngramAccessRecallExplainResponse>;
     memoryStore(request: EngramAccessMemoryStoreRequest): Promise<EngramAccessWriteResponse>;
@@ -400,6 +431,15 @@ declare class EngramAccessService {
         summaryPath: string;
         reportPath: string;
     }>;
+    procedureMiningRun(request: {
+        namespace?: string;
+        authenticatedPrincipal?: string;
+    }, principal?: string): Promise<{
+        namespace: string;
+        clustersProcessed: number;
+        proceduresWritten: number;
+        skippedReason?: string;
+    }>;
     trustZoneStatus(namespace?: string, principal?: string): Promise<EngramAccessTrustZoneStatusResponse>;
     trustZoneBrowse(request: EngramAccessTrustZoneBrowseRequest, principal?: string): Promise<EngramAccessTrustZoneBrowseResponse>;
     trustZonePromote(request: EngramAccessTrustZonePromoteRequest): Promise<EngramAccessTrustZonePromoteResponse>;
@@ -609,6 +649,27 @@ declare class EngramAccessService {
         saved: boolean;
     }>;
     lcmStatus(): Promise<EngramAccessLcmStatusResponse>;
+    /**
+     * Record citation usage from an observed oai-mem-citation block.
+     * For each citation entry, extract the memory ID from the path and
+     * increment its access tracking via the orchestrator. Returns the
+     * count of submitted IDs and the count of IDs that matched real memories.
+     */
+    recordCitationUsage(request: {
+        sessionId?: string;
+        namespace?: string;
+        authenticatedPrincipal?: string;
+        entries: Array<{
+            path: string;
+            lineStart: number;
+            lineEnd: number;
+            note: string;
+        }>;
+        rolloutIds: string[];
+    }): Promise<{
+        submitted: number;
+        matched: number;
+    }>;
 }
 
-export { ENGRAM_ACCESS_WRITE_SCHEMA_VERSION, type EngramAccessDaySummaryRequest, type EngramAccessEntityListResponse, type EngramAccessEntityResponse, type EngramAccessEntitySummary, type EngramAccessHealthResponse, EngramAccessInputError, type EngramAccessLcmSearchRequest, type EngramAccessLcmSearchResponse, type EngramAccessLcmStatusResponse, type EngramAccessMaintenanceResponse, type EngramAccessMemoryBrowseRequest, type EngramAccessMemoryBrowseResponse, type EngramAccessMemoryRecord, type EngramAccessMemoryResponse, type EngramAccessMemoryStoreRequest, type EngramAccessMemorySummary, type EngramAccessObserveRequest, type EngramAccessObserveResponse, type EngramAccessQualityResponse, type EngramAccessRecallExplainRequest, type EngramAccessRecallExplainResponse, type EngramAccessRecallRequest, type EngramAccessRecallResponse, type EngramAccessReviewDispositionRequest, type EngramAccessReviewDispositionResponse, type EngramAccessReviewQueueResponse, EngramAccessService, type EngramAccessSuggestionSubmitRequest, type EngramAccessTimelineResponse, type EngramAccessTrustZoneBrowseRequest, type EngramAccessTrustZoneBrowseResponse, type EngramAccessTrustZoneDemoSeedRequest, type EngramAccessTrustZoneDemoSeedResponse, type EngramAccessTrustZonePromoteRequest, type EngramAccessTrustZonePromoteResponse, type EngramAccessTrustZoneRecordSummary, type EngramAccessTrustZoneStatusResponse, type EngramAccessWriteEnvelope, type EngramAccessWriteResponse };
+export { ENGRAM_ACCESS_WRITE_SCHEMA_VERSION, type EngramAccessBriefingRequest, type EngramAccessBriefingResponse, type EngramAccessDaySummaryRequest, type EngramAccessEntityListResponse, type EngramAccessEntityResponse, type EngramAccessEntitySummary, type EngramAccessHealthResponse, EngramAccessInputError, type EngramAccessLcmSearchRequest, type EngramAccessLcmSearchResponse, type EngramAccessLcmStatusResponse, type EngramAccessMaintenanceResponse, type EngramAccessMemoryBrowseRequest, type EngramAccessMemoryBrowseResponse, type EngramAccessMemoryRecord, type EngramAccessMemoryResponse, type EngramAccessMemoryStoreRequest, type EngramAccessMemorySummary, type EngramAccessObserveRequest, type EngramAccessObserveResponse, type EngramAccessQualityResponse, type EngramAccessRecallExplainRequest, type EngramAccessRecallExplainResponse, type EngramAccessRecallRequest, type EngramAccessRecallResponse, type EngramAccessReviewDispositionRequest, type EngramAccessReviewDispositionResponse, type EngramAccessReviewQueueResponse, EngramAccessService, type EngramAccessSuggestionSubmitRequest, type EngramAccessTimelineResponse, type EngramAccessTrustZoneBrowseRequest, type EngramAccessTrustZoneBrowseResponse, type EngramAccessTrustZoneDemoSeedRequest, type EngramAccessTrustZoneDemoSeedResponse, type EngramAccessTrustZonePromoteRequest, type EngramAccessTrustZonePromoteResponse, type EngramAccessTrustZoneRecordSummary, type EngramAccessTrustZoneStatusResponse, type EngramAccessWriteEnvelope, type EngramAccessWriteResponse };

package/dist/access-service.js

@@ -2,28 +2,34 @@ import {
   ENGRAM_ACCESS_WRITE_SCHEMA_VERSION,
   EngramAccessInputError,
   EngramAccessService
-} from "./chunk-QY2BHY5O.js";
-import "./chunk-N5AKDXAI.js";
+} from "./chunk-V7XCAHIB.js";
 import "./chunk-EQINRHYR.js";
-import "./chunk-J3BT33K7.js";
+import "./chunk-POBPGDWI.js";
+import "./chunk-QDYXG4CS.js";
+import "./chunk-QNJMBKFK.js";
 import "./chunk-EEQLFRUM.js";
-import "./chunk-QWUUMMIK.js";
-import "./chunk-U4PV25RD.js";
-import "./chunk-ESSMF2FR.js";
+import "./chunk-QDW3E4RD.js";
+import "./chunk-4NRAJUDS.js";
+import "./chunk-DT5TVLJE.js";
+import "./chunk-TBBDFYXW.js";
+import "./chunk-DGXUHMOV.js";
+import "./chunk-LPSF4OQH.js";
+import "./chunk-XKECPATV.js";
+import "./chunk-ECKDIK5F.js";
+import "./chunk-POMSFKTB.js";
+import "./chunk-U2IQTSBY.js";
+import "./chunk-4KAN3GZ3.js";
+import "./chunk-6ZH4TU6I.js";
+import "./chunk-6PFRXT4K.js";
 import "./chunk-TP4FZJIZ.js";
 import "./chunk-SCU65EZI.js";
 import "./chunk-BOUYNNYD.js";
-import "./chunk-DM2T26WE.js";
 import "./chunk-QSVPYQPG.js";
-import "./chunk-YNCQ7E4M.js";
-import "./chunk-HLXVTBF3.js";
+import "./chunk-DM2T26WE.js";
 import "./chunk-M62O4P4T.js";
-import "./chunk-DT5TVLJE.js";
-import "./chunk-KWBU5S5U.js";
-import "./chunk-DGXUHMOV.js";
-import "./chunk-LPSF4OQH.js";
-import "./chunk-XKECPATV.js";
-import "./chunk-QCCCQT3O.js";
+import "./chunk-4DJQYKMN.js";
+import "./chunk-2ODBA7MQ.js";
+import "./chunk-N5AKDXAI.js";
 export {
   ENGRAM_ACCESS_WRITE_SCHEMA_VERSION,
   EngramAccessInputError,

package/dist/active-memory-bridge.d.ts

@@ -0,0 +1,66 @@
+import { PluginConfig, MemoryFile } from './types.js';
+
+interface ActiveMemoryMetadata {
+    type?: "fact" | "preference";
+    topic?: string;
+    updatedAt?: string;
+    sourceUri?: string;
+}
+interface ActiveMemorySearchResult {
+    id: string;
+    score: number;
+    text: string;
+    metadata?: ActiveMemoryMetadata;
+}
+interface ActiveMemorySearchOutput {
+    results: ActiveMemorySearchResult[];
+    truncated: boolean;
+}
+interface ActiveMemoryGetOutput {
+    id?: string;
+    text?: string;
+    metadata?: ActiveMemoryMetadata;
+    error?: "not_found";
+}
+interface ActiveMemoryRecallParams {
+    query: string;
+    limit?: number;
+    sessionKey: string;
+    filters?: Record<string, unknown>;
+    snippetMaxChars?: number;
+}
+type ActiveMemorySearchCandidate = {
+    id?: string;
+    score?: number;
+    snippet?: string;
+    text?: string;
+    path?: string;
+    metadata?: Record<string, unknown>;
+};
+declare function recallForActiveMemory(orchestrator: {
+    config?: PluginConfig;
+    resolvePrincipal?: (sessionKey?: string) => string;
+    resolveSelfNamespace?: (sessionKey?: string) => string;
+    searchAcrossNamespaces: (params: {
+        query: string;
+        maxResults?: number;
+        namespaces?: string[];
+        mode?: string;
+    }) => Promise<ActiveMemorySearchCandidate[]>;
+}, params: ActiveMemoryRecallParams): Promise<ActiveMemorySearchOutput>;
+declare function getMemoryForActiveMemory(orchestrator: {
+    config?: PluginConfig;
+    resolvePrincipal?: (sessionKey?: string) => string;
+    resolveSelfNamespace?: (sessionKey?: string) => string;
+    getStorageForNamespace?: (namespace: string) => Promise<{
+        getMemoryById?: (id: string) => Promise<MemoryFile | null>;
+    }>;
+    storage?: {
+        getMemoryById?: (id: string) => Promise<MemoryFile | null>;
+    };
+}, id: string, options?: {
+    namespace?: string;
+    sessionKey?: string;
+}): Promise<ActiveMemoryGetOutput>;
+
+export { type ActiveMemoryGetOutput, type ActiveMemoryMetadata, type ActiveMemoryRecallParams, type ActiveMemorySearchOutput, type ActiveMemorySearchResult, getMemoryForActiveMemory, recallForActiveMemory };

package/dist/active-memory-bridge.js

@@ -0,0 +1,11 @@
+import {
+  getMemoryForActiveMemory,
+  recallForActiveMemory
+} from "./chunk-G4SK7DSQ.js";
+import "./chunk-6MKAMLQL.js";
+import "./chunk-N5AKDXAI.js";
+export {
+  getMemoryForActiveMemory,
+  recallForActiveMemory
+};
+//# sourceMappingURL=active-memory-bridge.js.map

package/dist/active-recall.d.ts

@@ -0,0 +1,96 @@
+import { ActiveRecallChatType, ActiveRecallQueryMode, ActiveRecallPromptStyle, ActiveRecallThinking, ActiveRecallModelFallbackPolicy } from './types.js';
+
+interface ActiveRecallTurn {
+    role: "user" | "assistant";
+    content: string;
+}
+interface ActiveRecallInput {
+    sessionKey: string;
+    agentId: string;
+    chatType: ActiveRecallChatType;
+    recentTurns: ActiveRecallTurn[];
+    currentMessage: string;
+}
+interface ActiveRecallConfig {
+    enabled: boolean;
+    agents: string[] | null;
+    allowedChatTypes: ActiveRecallChatType[];
+    queryMode: ActiveRecallQueryMode;
+    promptStyle: ActiveRecallPromptStyle;
+    promptOverride: string | null;
+    promptAppend: string | null;
+    maxSummaryChars: number;
+    recentUserTurns: number;
+    recentAssistantTurns: number;
+    recentUserChars: number;
+    recentAssistantChars: number;
+    thinking: ActiveRecallThinking;
+    timeoutMs: number;
+    cacheTtlMs: number;
+    persistTranscripts: boolean;
+    transcriptDir: string;
+    entityGraphDepth: number;
+    includeCausalTrajectories: boolean;
+    includeDaySummary: boolean;
+    attachRecallExplain: boolean;
+    modelOverride: string | null;
+    modelFallbackPolicy: ActiveRecallModelFallbackPolicy;
+}
+interface ActiveRecallResult {
+    summary: string | null;
+    citations: Array<{
+        memoryId: string;
+        relevance: number;
+    }>;
+    latencyMs: number;
+    cacheHit: boolean;
+    modelUsed: string;
+    transcriptPath: string | null;
+}
+interface ActiveRecallDependencies {
+    recall(query: string, sessionKey: string): Promise<string | null>;
+    getLastRecallSnapshot?(sessionKey: string): {
+        memoryIds?: string[];
+    } | null;
+    walkEntityGraph?(params: {
+        sessionKey: string;
+        query: string;
+        depth: number;
+    }): Promise<string[]>;
+    loadCausalTrajectories?(params: {
+        sessionKey: string;
+        query: string;
+    }): Promise<string[]>;
+    loadDaySummary?(sessionKey: string): Promise<string | null>;
+    explainLastRecall?(sessionKey: string): Promise<string | null>;
+    generateSummary?(params: {
+        prompt: string;
+        sessionKey: string;
+        agentId: string;
+        model: string;
+        timeoutMs: number;
+        thinking: ActiveRecallThinking;
+        fallbackPolicy: ActiveRecallModelFallbackPolicy;
+    }): Promise<{
+        text: string | null;
+        modelUsed?: string;
+        cacheHit?: boolean;
+    }>;
+    now?: () => number;
+}
+declare function buildActiveRecallQueryBundle(input: ActiveRecallInput, config: ActiveRecallConfig): string;
+declare function normalizeActiveRecallSummary(value: string | null, maxChars: number): string | null;
+declare function buildActiveRecallPrompt(params: {
+    config: ActiveRecallConfig;
+    queryBundle: string;
+    recallContext: string | null;
+    graphContext: string[];
+    causalContext: string[];
+    daySummary: string | null;
+    recallExplain: string | null;
+}): string;
+declare function createActiveRecallEngine(deps: ActiveRecallDependencies, config: ActiveRecallConfig): {
+    run(input: ActiveRecallInput): Promise<ActiveRecallResult>;
+};
+
+export { type ActiveRecallConfig, type ActiveRecallDependencies, type ActiveRecallInput, type ActiveRecallResult, type ActiveRecallTurn, buildActiveRecallPrompt, buildActiveRecallQueryBundle, createActiveRecallEngine, normalizeActiveRecallSummary };