@remnic/core 1.0.0

package/dist/access-mcp.d.ts

@@ -0,0 +1,76 @@
+import { Readable, Writable } from 'node:stream';
+import { EngramAccessService } from './access-service.js';
+import './types.js';
+import './explicit-capture.js';
+import './orchestrator-zTa-Qo-1.js';
+import './buffer.js';
+import './storage.js';
+import './memory-projection-store-NxMkbocT.js';
+import 'better-sqlite3';
+import './port-C1GZFv8h.js';
+import './transcript.js';
+import './session-integrity.js';
+import './summarizer.js';
+import './model-registry.js';
+import './local-llm.js';
+import './relevance.js';
+import './negative.js';
+import './recall-state.js';
+import './session-observer-state.js';
+import './embedding-fallback.js';
+import './semantic-consolidation.js';
+import 'zod';
+import './policy-runtime.js';
+import './profiling.js';
+import './trust-zones.js';
+
+type JsonRpcId = string | number | null;
+type JsonRpcRequest = {
+    jsonrpc?: string;
+    id?: JsonRpcId;
+    method?: string;
+    params?: Record<string, unknown>;
+};
+declare class EngramMcpServer {
+    private readonly service;
+    private buffer;
+    private flushTask;
+    private readonly tools;
+    private readonly authenticatedPrincipal?;
+    /**
+     * MCP client info keyed by server-assigned session ID. On each `initialize`
+     * handshake the server generates a UUID, stores the client's clientInfo
+     * against it, and returns the ID as `Mcp-Session-Id` in the response
+     * metadata. Subsequent requests from the same client include this header,
+     * allowing per-session clientInfo lookup without cross-session leaks.
+     */
+    private clientInfoBySession;
+    /**
+     * Session IDs generated during initialize, keyed by caller-supplied correlation
+     * ID (unique per HTTP request) to avoid collisions when multiple clients send
+     * initialize with the same JSON-RPC id concurrently.
+     */
+    private initSessionIds;
+    constructor(service: EngramAccessService, options?: {
+        principal?: string;
+    });
+    /** Get clientInfo for a specific MCP session. Returns undefined for non-MCP requests. */
+    getClientInfo(sessionId?: string): {
+        name: string;
+        version?: string;
+    } | undefined;
+    /** Pop the session ID generated during an initialize handshake, keyed by correlation ID. */
+    popInitSessionId(correlationId: string): string | undefined;
+    handleRequest(request: JsonRpcRequest, options?: {
+        principalOverride?: string;
+        sessionId?: string;
+        correlationId?: string;
+    }): Promise<Record<string, unknown> | null>;
+    runStdio(input: Readable, output: Writable): Promise<void>;
+    private scheduleFlush;
+    private flushBuffer;
+    private writeMessage;
+    private callTool;
+}
+
+export { EngramMcpServer };

package/dist/access-mcp.js

@@ -0,0 +1,8 @@
+import {
+  EngramMcpServer
+} from "./chunk-CXWFUJR2.js";
+import "./chunk-MARWOCVP.js";
+export {
+  EngramMcpServer
+};
+//# sourceMappingURL=access-mcp.js.map

package/dist/access-mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/access-schema.d.ts

@@ -0,0 +1,266 @@
+import { z } from 'zod';
+
+interface SchemaValidationError {
+    error: string;
+    code: "validation_error";
+    details: Array<{
+        field: string;
+        message: string;
+    }>;
+}
+declare function formatZodError(error: z.ZodError): SchemaValidationError;
+declare const recallRequestSchema: z.ZodObject<{
+    query: z.ZodString;
+    sessionKey: z.ZodOptional<z.ZodString>;
+    namespace: z.ZodOptional<z.ZodString>;
+    topK: z.ZodOptional<z.ZodNumber>;
+    mode: z.ZodOptional<z.ZodEnum<["auto", "no_recall", "minimal", "full", "graph_mode"]>>;
+    includeDebug: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    query: string;
+    namespace?: string | undefined;
+    topK?: number | undefined;
+    mode?: "no_recall" | "minimal" | "full" | "graph_mode" | "auto" | undefined;
+    sessionKey?: string | undefined;
+    includeDebug?: boolean | undefined;
+}, {
+    query: string;
+    namespace?: string | undefined;
+    topK?: number | 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, {
+    namespace?: string | undefined;
+    sessionKey?: string | undefined;
+}, {
+    namespace?: string | undefined;
+    sessionKey?: string | undefined;
+}>;
+declare const observeRequestSchema: z.ZodObject<{
+    sessionKey: z.ZodString;
+    messages: z.ZodArray<z.ZodObject<{
+        role: z.ZodEnum<["user", "assistant"]>;
+        content: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        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: {
+        content: string;
+        role: "user" | "assistant";
+    }[];
+    namespace?: string | undefined;
+    skipExtraction?: boolean | undefined;
+}, {
+    sessionKey: string;
+    messages: {
+        content: string;
+        role: "user" | "assistant";
+    }[];
+    namespace?: string | undefined;
+    skipExtraction?: boolean | undefined;
+}>;
+declare const memoryStoreRequestSchema: z.ZodObject<{
+    schemaVersion: z.ZodOptional<z.ZodNumber>;
+    idempotencyKey: z.ZodOptional<z.ZodString>;
+    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"]>>;
+    confidence: z.ZodOptional<z.ZodNumber>;
+    namespace: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    entityRef: z.ZodOptional<z.ZodString>;
+    ttl: z.ZodOptional<z.ZodString>;
+    sourceReason: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    content: string;
+    namespace?: string | undefined;
+    category?: "fact" | "preference" | "correction" | "entity" | "decision" | "relationship" | "principle" | "commitment" | "moment" | "skill" | "rule" | undefined;
+    confidence?: number | undefined;
+    ttl?: string | undefined;
+    tags?: string[] | undefined;
+    entityRef?: string | undefined;
+    schemaVersion?: number | undefined;
+    sessionKey?: string | undefined;
+    dryRun?: boolean | undefined;
+    sourceReason?: string | undefined;
+    idempotencyKey?: string | undefined;
+}, {
+    content: string;
+    namespace?: string | undefined;
+    category?: "fact" | "preference" | "correction" | "entity" | "decision" | "relationship" | "principle" | "commitment" | "moment" | "skill" | "rule" | undefined;
+    confidence?: number | undefined;
+    ttl?: string | undefined;
+    tags?: string[] | undefined;
+    entityRef?: 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>;
+    idempotencyKey: z.ZodOptional<z.ZodString>;
+    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"]>>;
+    confidence: z.ZodOptional<z.ZodNumber>;
+    namespace: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    entityRef: z.ZodOptional<z.ZodString>;
+    ttl: z.ZodOptional<z.ZodString>;
+    sourceReason: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    content: string;
+    namespace?: string | undefined;
+    category?: "fact" | "preference" | "correction" | "entity" | "decision" | "relationship" | "principle" | "commitment" | "moment" | "skill" | "rule" | undefined;
+    confidence?: number | undefined;
+    ttl?: string | undefined;
+    tags?: string[] | undefined;
+    entityRef?: string | undefined;
+    schemaVersion?: number | undefined;
+    sessionKey?: string | undefined;
+    dryRun?: boolean | undefined;
+    sourceReason?: string | undefined;
+    idempotencyKey?: string | undefined;
+}, {
+    content: string;
+    namespace?: string | undefined;
+    category?: "fact" | "preference" | "correction" | "entity" | "decision" | "relationship" | "principle" | "commitment" | "moment" | "skill" | "rule" | undefined;
+    confidence?: number | undefined;
+    ttl?: string | undefined;
+    tags?: string[] | undefined;
+    entityRef?: 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;
+    status: z.ZodEnum<["active", "pending_review", "quarantined", "rejected", "superseded", "archived"]>;
+    reasonCode: z.ZodString;
+    namespace: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    status: "active" | "pending_review" | "rejected" | "quarantined" | "superseded" | "archived";
+    reasonCode: string;
+    memoryId: string;
+    namespace?: string | undefined;
+}, {
+    status: "active" | "pending_review" | "rejected" | "quarantined" | "superseded" | "archived";
+    reasonCode: string;
+    memoryId: string;
+    namespace?: string | undefined;
+}>;
+declare const trustZonePromoteRequestSchema: z.ZodObject<{
+    recordId: z.ZodString;
+    targetZone: z.ZodEnum<["working", "trusted"]>;
+    promotionReason: z.ZodString;
+    recordedAt: z.ZodOptional<z.ZodString>;
+    summary: z.ZodOptional<z.ZodString>;
+    dryRun: z.ZodOptional<z.ZodBoolean>;
+    namespace: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    recordId: string;
+    targetZone: "working" | "trusted";
+    promotionReason: string;
+    namespace?: string | undefined;
+    summary?: string | undefined;
+    dryRun?: boolean | undefined;
+    recordedAt?: string | undefined;
+}, {
+    recordId: string;
+    targetZone: "working" | "trusted";
+    promotionReason: string;
+    namespace?: string | undefined;
+    summary?: string | undefined;
+    dryRun?: boolean | undefined;
+    recordedAt?: string | undefined;
+}>;
+declare const trustZoneDemoSeedRequestSchema: z.ZodObject<{
+    scenario: z.ZodOptional<z.ZodString>;
+    recordedAt: z.ZodOptional<z.ZodString>;
+    dryRun: z.ZodOptional<z.ZodBoolean>;
+    namespace: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    namespace?: string | undefined;
+    dryRun?: boolean | undefined;
+    recordedAt?: string | undefined;
+    scenario?: string | undefined;
+}, {
+    namespace?: string | undefined;
+    dryRun?: boolean | undefined;
+    recordedAt?: string | undefined;
+    scenario?: string | undefined;
+}>;
+declare const lcmSearchRequestSchema: z.ZodObject<{
+    query: z.ZodString;
+    sessionKey: z.ZodOptional<z.ZodString>;
+    namespace: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    query: string;
+    namespace?: string | undefined;
+    limit?: number | undefined;
+    sessionKey?: string | undefined;
+}, {
+    query: string;
+    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, {
+    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>;
+type ObserveRequest = z.infer<typeof observeRequestSchema>;
+type MemoryStoreRequest = z.infer<typeof memoryStoreRequestSchema>;
+type SuggestionSubmitRequest = z.infer<typeof suggestionSubmitRequestSchema>;
+type ReviewDispositionRequest = z.infer<typeof reviewDispositionRequestSchema>;
+type TrustZonePromoteRequest = z.infer<typeof trustZonePromoteRequestSchema>;
+type TrustZoneDemoSeedRequest = z.infer<typeof trustZoneDemoSeedRequestSchema>;
+type LcmSearchRequest = z.infer<typeof lcmSearchRequestSchema>;
+type DaySummaryRequest = z.infer<typeof daySummaryRequestSchema>;
+type SchemaName = "recall" | "recallExplain" | "observe" | "memoryStore" | "suggestionSubmit" | "reviewDisposition" | "trustZonePromote" | "trustZoneDemoSeed" | "lcmSearch" | "daySummary";
+type SchemaTypeFor<N extends SchemaName> = N extends "recall" ? RecallRequest : N extends "recallExplain" ? RecallExplainRequest : N extends "observe" ? ObserveRequest : N extends "memoryStore" ? MemoryStoreRequest : N extends "suggestionSubmit" ? SuggestionSubmitRequest : N extends "reviewDisposition" ? ReviewDispositionRequest : N extends "trustZonePromote" ? TrustZonePromoteRequest : N extends "trustZoneDemoSeed" ? TrustZoneDemoSeedRequest : N extends "lcmSearch" ? LcmSearchRequest : N extends "daySummary" ? DaySummaryRequest : never;
+/**
+ * Validate a request body against the named schema.
+ * Returns `{ success: true, data }` on pass or
+ * `{ success: false, error }` on failure with field-level detail.
+ */
+declare function validateRequest<T = unknown>(schemaName: SchemaName, body: unknown): {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    error: SchemaValidationError;
+};
+
+export { type DaySummaryRequest, type LcmSearchRequest, type MemoryStoreRequest, type ObserveRequest, type RecallExplainRequest, type RecallRequest, type ReviewDispositionRequest, type SchemaName, type SchemaTypeFor, type SchemaValidationError, type SuggestionSubmitRequest, type TrustZoneDemoSeedRequest, type TrustZonePromoteRequest, daySummaryRequestSchema, formatZodError, lcmSearchRequestSchema, memoryStoreRequestSchema, observeRequestSchema, recallExplainRequestSchema, recallRequestSchema, reviewDispositionRequestSchema, suggestionSubmitRequestSchema, trustZoneDemoSeedRequestSchema, trustZonePromoteRequestSchema, validateRequest };

package/dist/access-schema.js

@@ -0,0 +1,29 @@
+import {
+  daySummaryRequestSchema,
+  formatZodError,
+  lcmSearchRequestSchema,
+  memoryStoreRequestSchema,
+  observeRequestSchema,
+  recallExplainRequestSchema,
+  recallRequestSchema,
+  reviewDispositionRequestSchema,
+  suggestionSubmitRequestSchema,
+  trustZoneDemoSeedRequestSchema,
+  trustZonePromoteRequestSchema,
+  validateRequest
+} from "./chunk-PGK3VUHN.js";
+export {
+  daySummaryRequestSchema,
+  formatZodError,
+  lcmSearchRequestSchema,
+  memoryStoreRequestSchema,
+  observeRequestSchema,
+  recallExplainRequestSchema,
+  recallRequestSchema,
+  reviewDispositionRequestSchema,
+  suggestionSubmitRequestSchema,
+  trustZoneDemoSeedRequestSchema,
+  trustZonePromoteRequestSchema,
+  validateRequest
+};
+//# sourceMappingURL=access-schema.js.map

package/dist/access-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}