common-memory-core 0.2.0

package/dist/core/transaction/fsync.d.ts

@@ -0,0 +1,6 @@
+export declare function fsyncFile(path: string): void;
+export declare function fileFsyncOpenMode(platform?: NodeJS.Platform): "r" | "r+";
+export declare function persistDirectory(path: string, platform?: NodeJS.Platform): void;
+export declare const fsyncDirectory: typeof persistDirectory;
+export declare function publishFileAtomically(tempPath: string, targetPath: string, afterRename?: () => void): void;
+//# sourceMappingURL=fsync.d.ts.map

package/dist/core/transaction/fsync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fsync.d.ts","sourceRoot":"","sources":["../../../src/core/transaction/fsync.ts"],"names":[],"mappings":"AAIA,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAE5C;AAGD,wBAAgB,iBAAiB,CAAC,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAAG,GAAG,GAAG,IAAI,CAA8C;AAIzI,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAAG,IAAI,CAMjG;AACD,eAAO,MAAM,cAAc,yBAAmB,CAAC;AAE/C,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,IAAI,GAAG,IAAI,CAK1G"}

package/dist/core/transaction/fsync.js

@@ -0,0 +1,41 @@
+import { closeSync, fsyncSync, openSync, renameSync } from "node:fs";
+import { dirname } from "node:path";
+import { CoreError } from "../contracts/errors.js";
+export function fsyncFile(path) {
+    const fd = openSync(path, fileFsyncOpenMode());
+    try {
+        fsyncSync(fd);
+    }
+    finally {
+        closeSync(fd);
+    }
+}
+// FlushFileBuffers on Windows requires a handle opened with write access.
+export function fileFsyncOpenMode(platform = process.platform) { return platform === "win32" ? "r+" : "r"; }
+// Node cannot fsync directory handles on Windows (fsyncSync returns EPERM).
+// File fsync, atomic rename, and journal recovery still protect transaction integrity.
+export function persistDirectory(path, platform = process.platform) {
+    if (platform === "win32")
+        return;
+    let fd;
+    try {
+        fd = openSync(path, "r");
+        fsyncSync(fd);
+    }
+    catch (error) {
+        throw new CoreError("STORE_UNAVAILABLE", "Directory durability is unavailable on this platform", { rule_id: "filesystem.directory_fsync", platform }, { cause: error });
+    }
+    finally {
+        if (fd !== undefined)
+            closeSync(fd);
+    }
+}
+export const fsyncDirectory = persistDirectory;
+export function publishFileAtomically(tempPath, targetPath, afterRename) {
+    // rename is the only publish operation. Replacement failure is surfaced; no
+    // remove-then-rename fallback is allowed for an existing target.
+    renameSync(tempPath, targetPath);
+    afterRename?.();
+    persistDirectory(dirname(targetPath));
+}
+//# sourceMappingURL=fsync.js.map

package/dist/core/transaction/fsync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fsync.js","sourceRoot":"","sources":["../../../src/core/transaction/fsync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEnD,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,MAAM,EAAE,GAAG,QAAQ,CAAC,IAAI,EAAE,iBAAiB,EAAE,CAAC,CAAC;IAAC,IAAI,CAAC;QAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IAAC,CAAC;YAAS,CAAC;QAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IAAC,CAAC;AACnG,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,iBAAiB,CAAC,WAA4B,OAAO,CAAC,QAAQ,IAAgB,OAAO,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AAEzI,4EAA4E;AAC5E,uFAAuF;AACvF,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,WAA4B,OAAO,CAAC,QAAQ;IACzF,IAAI,QAAQ,KAAK,OAAO;QAAE,OAAO;IACjC,IAAI,EAAsB,CAAC;IAC3B,IAAI,CAAC;QAAC,EAAE,GAAG,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IAAC,CAAC;IAChD,OAAO,KAAK,EAAE,CAAC;QAAC,MAAM,IAAI,SAAS,CAAC,mBAAmB,EAAE,sDAAsD,EAAE,EAAE,OAAO,EAAE,4BAA4B,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IAAC,CAAC;YAClL,CAAC;QAAC,IAAI,EAAE,KAAK,SAAS;YAAE,SAAS,CAAC,EAAE,CAAC,CAAC;IAAC,CAAC;AAClD,CAAC;AACD,MAAM,CAAC,MAAM,cAAc,GAAG,gBAAgB,CAAC;AAE/C,MAAM,UAAU,qBAAqB,CAAC,QAAgB,EAAE,UAAkB,EAAE,WAAwB;IAClG,4EAA4E;IAC5E,iEAAiE;IACjE,UAAU,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAAC,WAAW,EAAE,EAAE,CAAC;IAClD,gBAAgB,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;AACxC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+export { Writer } from "./v2/writer.js";
+export { RuntimeStore } from "./v2/runtime.js";
+export { CanonicalStore } from "./v2/canonical.js";
+export { ProjectRegistry } from "./v2/registry.js";
+export { readAuthorizedMemory, renderMemoryView, contextTargets, type MemoryView, type MemoryDocumentView } from "./v2/reader.js";
+export { encodeAgentImport, decodeAgentImport, provenanceOf, isImportSource, IMPORT_BASES, AGENT_IMPORT_SOURCE, DOCUMENT_IMPORT_SOURCE, type AgentImportPayload, type ImportBasis, type ProvenanceKind } from "./v2/import.js";
+export { prepareDocumentImport, chunkMarkdown, readMarkdownFile, admitDocumentImport, documentImportOutcome, encodeDocumentChunk, decodeDocumentChunk, DOCUMENT_AUTHORS, MAX_DOCUMENT_BYTES, MAX_DOCUMENT_CHUNK_BYTES, type DocumentAuthor, type DocumentImportChunk, type PreparedDocumentImport, type DocumentImportOutcome } from "./v2/document-import.js";
+export { OpenAIResponsesMemoryModel, createOpenAIResponsesMemoryModel, normalizeOpenAICompatibleBaseUrl, type OpenAIResponsesMemoryModelOptions } from "./memory-manager/openai/openai-responses-adapter.js";
+export type { MemoryModelPort, ApprovedModelRequest, MemoryModelResult, ModelUsage, ModelDiagnosticContext } from "./memory-manager/contracts/model-port.js";
+export { configDirectory, configFilePath, envFilePath, defaultConfig, loadConfig, saveConfig, saveApiKeyToEnvFile, saveNetworkSecret, loadLocalEnv, resolveApiKey, validateConfig, type CommonMemoryConfig } from "./config/config.js";
+export { createConfiguredMemoryModel, createConfiguredWriter, describeConfiguredNetwork, type ConfiguredModelOverrides } from "./config/runtime.js";
+export { OpenAIChatMemoryModel, type OpenAIChatMemoryModelOptions } from "./memory-manager/openai/openai-chat-adapter.js";
+export type { FailureDiagnostic, DiagnosticStage, DiagnosticReason } from "./memory-manager/contracts/diagnostic.js";
+export type { ObservationOutcome, JobStatus } from "./v2/runtime.js";
+export { SessionIngress, sessionKey, SESSION_CACHE_DEFAULTS, type SessionIdentity, type SessionMessage, type SessionTurnState, type SessionCacheOptions } from './v2/session.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,cAAc,EAAE,KAAK,UAAU,EAAE,KAAK,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAClI,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,KAAK,kBAAkB,EAAE,KAAK,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC/N,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,KAAK,cAAc,EAAE,KAAK,mBAAmB,EAAE,KAAK,sBAAsB,EAAE,KAAK,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAC/V,OAAO,EAAE,0BAA0B,EAAE,gCAAgC,EAAE,gCAAgC,EAAE,KAAK,iCAAiC,EAAE,MAAM,qDAAqD,CAAC;AAC7M,YAAY,EAAE,eAAe,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,UAAU,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AAC7J,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,WAAW,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACvO,OAAO,EAAE,2BAA2B,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,KAAK,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAEpJ,OAAO,EAAE,qBAAqB,EAAE,KAAK,4BAA4B,EAAE,MAAM,gDAAgD,CAAC;AAC1H,YAAY,EAAE,iBAAiB,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAC;AACrH,YAAY,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAErE,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,sBAAsB,EAAE,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,KAAK,gBAAgB,EAAE,KAAK,mBAAmB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+export { Writer } from "./v2/writer.js";
+export { RuntimeStore } from "./v2/runtime.js";
+export { CanonicalStore } from "./v2/canonical.js";
+export { ProjectRegistry } from "./v2/registry.js";
+export { readAuthorizedMemory, renderMemoryView, contextTargets } from "./v2/reader.js";
+export { encodeAgentImport, decodeAgentImport, provenanceOf, isImportSource, IMPORT_BASES, AGENT_IMPORT_SOURCE, DOCUMENT_IMPORT_SOURCE } from "./v2/import.js";
+export { prepareDocumentImport, chunkMarkdown, readMarkdownFile, admitDocumentImport, documentImportOutcome, encodeDocumentChunk, decodeDocumentChunk, DOCUMENT_AUTHORS, MAX_DOCUMENT_BYTES, MAX_DOCUMENT_CHUNK_BYTES } from "./v2/document-import.js";
+export { OpenAIResponsesMemoryModel, createOpenAIResponsesMemoryModel, normalizeOpenAICompatibleBaseUrl } from "./memory-manager/openai/openai-responses-adapter.js";
+export { configDirectory, configFilePath, envFilePath, defaultConfig, loadConfig, saveConfig, saveApiKeyToEnvFile, saveNetworkSecret, loadLocalEnv, resolveApiKey, validateConfig } from "./config/config.js";
+export { createConfiguredMemoryModel, createConfiguredWriter, describeConfiguredNetwork } from "./config/runtime.js";
+export { OpenAIChatMemoryModel } from "./memory-manager/openai/openai-chat-adapter.js";
+export { SessionIngress, sessionKey, SESSION_CACHE_DEFAULTS } from './v2/session.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,cAAc,EAA4C,MAAM,gBAAgB,CAAC;AAClI,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,mBAAmB,EAAE,sBAAsB,EAAkE,MAAM,gBAAgB,CAAC;AAC/N,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,wBAAwB,EAA0G,MAAM,yBAAyB,CAAC;AAC/V,OAAO,EAAE,0BAA0B,EAAE,gCAAgC,EAAE,gCAAgC,EAA0C,MAAM,qDAAqD,CAAC;AAE7M,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,WAAW,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAA2B,MAAM,oBAAoB,CAAC;AACvO,OAAO,EAAE,2BAA2B,EAAE,sBAAsB,EAAE,yBAAyB,EAAiC,MAAM,qBAAqB,CAAC;AAEpJ,OAAO,EAAE,qBAAqB,EAAqC,MAAM,gDAAgD,CAAC;AAI1H,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,sBAAsB,EAA8F,MAAM,iBAAiB,CAAC"}

package/dist/mcp/ingress.d.ts

@@ -0,0 +1,61 @@
+import type { CommonMemoryConfig } from '../config/config.js';
+import { RuntimeStore } from '../v2/runtime.js';
+import { type AgentImportPayload } from '../v2/import.js';
+import { type MemoryView } from '../v2/reader.js';
+export type McpCapability = 'relay' | 'init' | 'read';
+export declare const MCP_CAPABILITIES: readonly McpCapability[];
+export interface McpOptions {
+    clientId: string;
+    workspaces: string[];
+    global: boolean;
+    accept: boolean;
+    capabilities: McpCapability[];
+}
+export interface SubmissionIdentity {
+    submissionId: string;
+    conversationId?: string | undefined;
+}
+export interface Submission extends SubmissionIdentity {
+    contextId: string;
+    text: string;
+}
+export interface InitSubmission extends AgentImportPayload {
+    importId: string;
+    contextId: string;
+}
+export type SubmissionOutcome = import("../v2/runtime.js").ObservationOutcome;
+/** Local host trust is established at launch, never by a tool argument. */
+export declare class McpIngress {
+    #private;
+    readonly store: RuntimeStore | null;
+    readonly config: CommonMemoryConfig;
+    /** Read-only launches never open the runtime database. */
+    constructor(store: RuntimeStore | null, config: CommonMemoryConfig, options: McpOptions);
+    get capabilities(): readonly McpCapability[];
+    has(capability: McpCapability): boolean;
+    contexts(): string[];
+    info(): {
+        capabilities: McpCapability[];
+        submissionEnabled: boolean;
+        initEnabled: boolean;
+        readEnabled: boolean;
+        contexts: string[];
+    };
+    status(input: SubmissionIdentity): SubmissionOutcome | null;
+    initStatus(importId: string): SubmissionOutcome | null;
+    submit(input: Submission, signal?: AbortSignal): {
+        accepted: true;
+        duplicate: boolean;
+        state: string;
+        contextId: string;
+    };
+    /** Agent-reported understanding: durably queued as one agent_import observation and flushed promptly. */
+    init(input: InitSubmission, signal?: AbortSignal): {
+        accepted: true;
+        duplicate: boolean;
+        state: string;
+        contextId: string;
+    };
+    read(contextId?: string): MemoryView;
+}
+//# sourceMappingURL=ingress.d.ts.map

package/dist/mcp/ingress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingress.d.ts","sourceRoot":"","sources":["../../src/mcp/ingress.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,OAAO,EAA0C,KAAK,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAClG,OAAO,EAAwB,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAExE,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AACtD,eAAO,MAAM,gBAAgB,EAAE,SAAS,aAAa,EAA8B,CAAC;AACpF,MAAM,WAAW,UAAU;IAAG,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,YAAY,EAAE,aAAa,EAAE,CAAA;CAAE;AACvI,MAAM,WAAW,kBAAkB;IAAG,YAAY,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE;AACjG,MAAM,WAAW,UAAW,SAAQ,kBAAkB;IAAG,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AAC1F,MAAM,WAAW,cAAe,SAAQ,kBAAkB;IAAG,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE;AAClG,MAAM,MAAM,iBAAiB,GAAG,OAAO,kBAAkB,EAAE,kBAAkB,CAAC;AAG9E,2EAA2E;AAC3E,qBAAa,UAAU;;IAKT,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAAE,QAAQ,CAAC,MAAM,EAAE,kBAAkB;IADpF,0DAA0D;gBACrC,KAAK,EAAE,YAAY,GAAG,IAAI,EAAW,MAAM,EAAE,kBAAkB,EAAE,OAAO,EAAE,UAAU;IAazG,IAAI,YAAY,IAAI,SAAS,aAAa,EAAE,CAAuC;IACnF,GAAG,CAAC,UAAU,EAAE,aAAa,GAAG,OAAO;IACvC,QAAQ,IAAI,MAAM,EAAE;IAQpB,IAAI,IAAI;QAAE,YAAY,EAAE,aAAa,EAAE,CAAC;QAAC,iBAAiB,EAAE,OAAO,CAAC;QAAC,WAAW,EAAE,OAAO,CAAC;QAAC,WAAW,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE;IAsBrI,MAAM,CAAC,KAAK,EAAE,kBAAkB,GAAG,iBAAiB,GAAG,IAAI;IAG3D,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI;IAGtD,MAAM,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG;QAAE,QAAQ,EAAE,IAAI,CAAC;QAAC,SAAS,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE;IAQzH,yGAAyG;IACzG,IAAI,CAAC,KAAK,EAAE,cAAc,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG;QAAE,QAAQ,EAAE,IAAI,CAAC;QAAC,SAAS,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE;IAS3H,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,UAAU;CAoBrC"}

package/dist/mcp/ingress.js

@@ -0,0 +1,134 @@
+import { isAbsolute } from 'node:path';
+import { RuntimeStore } from '../v2/runtime.js';
+import { ProjectRegistry } from '../v2/registry.js';
+import { AGENT_IMPORT_SOURCE, encodeAgentImport } from '../v2/import.js';
+import { readAuthorizedMemory } from '../v2/reader.js';
+export const MCP_CAPABILITIES = ['relay', 'init', 'read'];
+const validId = (id) => /^[A-Za-z0-9_-]{1,128}$/.test(id);
+/** Local host trust is established at launch, never by a tool argument. */
+export class McpIngress {
+    store;
+    config;
+    #registry;
+    #projects;
+    #options;
+    /** Read-only launches never open the runtime database. */
+    constructor(store, config, options) {
+        this.store = store;
+        this.config = config;
+        if (!validId(options.clientId))
+            throw new Error('INVALID_CLIENT_ID');
+        if (!options.capabilities.length || options.capabilities.some(c => !MCP_CAPABILITIES.includes(c)))
+            throw new Error('INVALID_CAPABILITY');
+        if (!store && options.capabilities.some(c => c !== 'read'))
+            throw new Error('STORE_REQUIRED');
+        this.#options = { ...options, workspaces: [...options.workspaces], capabilities: [...new Set(options.capabilities)] };
+        this.#registry = new ProjectRegistry(config.dataRoot);
+        this.#projects = options.workspaces.map(workspace => {
+            if (!isAbsolute(workspace))
+                throw new Error('WORKSPACE_MUST_BE_ABSOLUTE');
+            const project = this.#registry.resolve(workspace);
+            if (!project)
+                throw new Error('UNREGISTERED_WORKSPACE');
+            return { workspace, contextId: `project:${project.id}` };
+        });
+    }
+    get capabilities() { return this.#options.capabilities; }
+    has(capability) { return this.#options.capabilities.includes(capability); }
+    contexts() {
+        const projects = this.#projects.filter(item => {
+            try {
+                return `project:${this.#registry.resolve(item.workspace)?.id}` === item.contextId;
+            }
+            catch {
+                return false;
+            }
+        }).map(item => item.contextId);
+        return [...new Set([...(this.#options.global ? ['global'] : []), ...projects])]
+            .filter(scope => this.config.disclosure.allowedScopes.includes(scope));
+    }
+    info() {
+        const contexts = this.contexts();
+        const userExplicit = this.config.disclosure.allowedProvenance.includes('user_explicit');
+        return {
+            capabilities: [...this.#options.capabilities],
+            submissionEnabled: this.has('relay') && this.#options.accept && userExplicit && contexts.length > 0,
+            // Init needs the launch capability and the configured permission to disclose agent-reported material remotely.
+            initEnabled: this.has('init') && this.config.disclosure.allowedProvenance.includes('agent_observation') && contexts.length > 0,
+            readEnabled: this.has('read') && contexts.length > 0,
+            contexts,
+        };
+    }
+    /** Read-only launches have no queue: item status is not part of their profile, not a backend failure. */
+    #store() { if (!this.store)
+        throw new Error('STATUS_UNAVAILABLE'); return this.store; }
+    #session(input) {
+        if (!validId(input.submissionId) || (input.conversationId !== undefined && !validId(input.conversationId)))
+            throw new Error('INVALID_SUBMISSION_ID');
+        return `mcp:${JSON.stringify([this.#options.clientId, input.conversationId === undefined ? ['submission', input.submissionId] : ['conversation', input.conversationId]])}`;
+    }
+    #initSession(importId) {
+        if (!validId(importId))
+            throw new Error('INVALID_SUBMISSION_ID');
+        return `mcp-init:${JSON.stringify([this.#options.clientId, importId])}`;
+    }
+    status(input) {
+        return this.#store().observationOutcome(this.#session(input), input.submissionId);
+    }
+    initStatus(importId) {
+        return this.#store().observationOutcome(this.#initSession(importId), importId);
+    }
+    submit(input, signal) {
+        const sessionId = this.#session(input);
+        if (!this.info().submissionEnabled)
+            throw new Error('SUBMISSION_DISABLED');
+        if (!this.contexts().includes(input.contextId))
+            throw new Error('CONTEXT_UNAVAILABLE');
+        if (!input.text.trim() || Buffer.byteLength(input.text) > this.config.disclosure.maxTotalBytes)
+            throw new Error('INVALID_TEXT_SIZE');
+        if (signal?.aborted)
+            throw new Error('CANCELLED');
+        return this.#enqueue(sessionId, input.submissionId, input.contextId, input.text, 'mcp_user_submission', false);
+    }
+    /** Agent-reported understanding: durably queued as one agent_import observation and flushed promptly. */
+    init(input, signal) {
+        const sessionId = this.#initSession(input.importId);
+        if (!this.info().initEnabled)
+            throw new Error('INIT_DISABLED');
+        if (!this.contexts().includes(input.contextId))
+            throw new Error('CONTEXT_UNAVAILABLE');
+        const text = encodeAgentImport({ sourceLabel: input.sourceLabel, basis: input.basis, understanding: input.understanding, gaps: input.gaps });
+        if (Buffer.byteLength(text) > this.config.disclosure.maxTotalBytes)
+            throw new Error('INVALID_TEXT_SIZE');
+        if (signal?.aborted)
+            throw new Error('CANCELLED');
+        return this.#enqueue(sessionId, input.importId, input.contextId, text, AGENT_IMPORT_SOURCE, true);
+    }
+    read(contextId) {
+        if (!this.info().readEnabled)
+            throw new Error('READ_DISABLED');
+        const contexts = this.contexts();
+        if (contextId !== undefined && !contexts.includes(contextId))
+            throw new Error('CONTEXT_UNAVAILABLE');
+        return readAuthorizedMemory({ dataRoot: this.config.dataRoot, contexts: contextId === undefined ? contexts : [contextId] });
+    }
+    #enqueue(sessionId, entryId, scope, text, source, flush) {
+        const store = this.#store();
+        return store.transaction(() => {
+            const duplicate = store.observationStatus(sessionId, entryId) !== null;
+            let observation;
+            try {
+                observation = store.enqueue({ sessionId, entryId, scope, text, source, observedAt: new Date().toISOString() });
+            }
+            catch (error) {
+                if (error instanceof Error && error.message === 'Conflicting observation identity')
+                    throw new Error('SUBMISSION_CONFLICT');
+                throw error;
+            }
+            if (flush)
+                store.requestFlush();
+            return { accepted: true, duplicate, state: observation.state, contextId: observation.scope };
+        });
+    }
+}
+//# sourceMappingURL=ingress.js.map

package/dist/mcp/ingress.js.map

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

package/dist/mcp/server.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from '@modelcontextprotocol/server';
+import type { McpIngress } from './ingress.js';
+export declare function createMcpServer(ingress: McpIngress): McpServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/mcp/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAEzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAoB/C,wBAAgB,eAAe,CAAC,OAAO,EAAE,UAAU,GAAG,SAAS,CA8C9D"}

package/dist/mcp/server.js

@@ -0,0 +1,92 @@
+import { MEMORY_READ_GUIDANCE, MEMORY_READ_DESCRIPTION } from '../v2/read-guidance.js';
+import { McpServer } from '@modelcontextprotocol/server';
+import * as z from 'zod/v4';
+import { IMPORT_BASES, MAX_IMPORT_GAPS_BYTES, MAX_IMPORT_UNDERSTANDING_BYTES } from '../v2/import.js';
+import { renderMemoryView } from '../v2/reader.js';
+const id = z.string().regex(/^[A-Za-z0-9_-]{1,128}$/);
+const identity = { submissionId: id, conversationId: id.optional() };
+const safeErrors = new Set(['SUBMISSION_DISABLED', 'INIT_DISABLED', 'READ_DISABLED', 'STATUS_UNAVAILABLE', 'CONTEXT_UNAVAILABLE', 'INVALID_TEXT_SIZE', 'INVALID_SUBMISSION_ID', 'INVALID_IMPORT_LABEL', 'INVALID_IMPORT_BASIS', 'SUBMISSION_CONFLICT', 'CANCELLED']);
+function result(value, text = JSON.stringify(value)) {
+    return { content: [{ type: 'text', text }], structuredContent: { ...value } };
+}
+function failure(error) {
+    const code = error instanceof Error && safeErrors.has(error.message) ? error.message : 'MEMORY_UNAVAILABLE';
+    return { ...result({ code }), isError: true };
+}
+const INSTRUCTIONS = {
+    read: MEMORY_READ_GUIDANCE,
+    init: 'Common Memory Init: call memory_init only when the user explicitly requests memory import, migration or initialization. Submit only existing material actually visible to you; direct quotations are allowed and remain agent-reported data. Name the actual sources and coverage gaps. Preserve dates, conditions, project scope and uncertainty; exclude this migration session’s execution status and unsupported new claims. Never turn missing knowledge into negative facts about the user. Never include secrets. Approval to migrate does not verify each claim. Accepted means queued; use memory_status with the same importId and ask the user to review the destination with common-memory show. These are soft semantic defenses, not Core guarantees of truth or completeness. Nothing here reads memory.',
+    relay: 'Common Memory relay: submit complete user expressions verbatim for background memory maintenance; check processing state with memory_status.',
+};
+export function createMcpServer(ingress) {
+    const instructions = ingress.capabilities.map(c => INSTRUCTIONS[c]).join('\n\n');
+    const server = new McpServer({ name: 'common-memory', version: '0.2.0' }, { instructions });
+    if (ingress.has('relay'))
+        server.registerTool('memory_submit_user_turn', {
+            description: 'Submit one complete user expression verbatim, not an assistant summary. Requires local host opt-in. Accepted means durably queued, not remembered. Reuse the same submission/conversation IDs when retrying. Cancellation after acceptance does not retract evidence.',
+            inputSchema: z.object({ ...identity, contextId: z.string().max(160), text: z.string().min(1).max(ingress.config.disclosure.maxTotalBytes) }).strict(),
+            annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: true },
+        }, async (input, ctx) => {
+            try {
+                return result(ingress.submit(input, ctx.mcpReq.signal));
+            }
+            catch (error) {
+                return failure(error);
+            }
+        });
+    if (ingress.has('init'))
+        server.registerTool('memory_init', {
+            description: `Import existing material actually visible to you about the user (contextId "global") or current project (contextId "project:<id>"). Call only when the user explicitly asks to import or migrate memory. In "understanding" (≤${MAX_IMPORT_UNDERSTANDING_BYTES} bytes), quote or faithfully summarize selected existing material; even quotations remain agent-reported, never authenticated user statements. Preserve original dates, historical goals, conditions, project scope and tentative wording. Set "basis" from the material actually read; use "sourceLabel" as a source label, and describe specific sources, coverage and uncertainty in "understanding" or "gaps". Do not infer source or full ChatGPT memory coverage from the product or mode name. Keep inaccessible or unknown information in "gaps", not as negative user facts. Exclude this migration session's connection, import, readback and other execution status, unsupported new assertions, secrets, credentials and anything the user did not intend to share. Leave unsupported guesses for review outside the import. User approval to migrate does not establish truth. Accepted means durably queued; Core structural validation cannot guarantee provenance accuracy or prevent all unsupported or contradictory additions. Poll memory_status with the same importId; reuse the importId with the identical payload when retrying. Review the actual destination with common-memory show; an isolated trial does not guarantee the same result on another run.`,
+            inputSchema: z.object({
+                importId: id,
+                contextId: z.string().max(160),
+                sourceLabel: z.string().min(1).max(64),
+                basis: z.enum(IMPORT_BASES),
+                understanding: z.string().min(1).max(MAX_IMPORT_UNDERSTANDING_BYTES),
+                gaps: z.string().max(MAX_IMPORT_GAPS_BYTES).optional(),
+            }).strict(),
+            annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+        }, async (input, ctx) => {
+            try {
+                return result(ingress.init(input, ctx.mcpReq.signal));
+            }
+            catch (error) {
+                return failure(error);
+            }
+        });
+    if (ingress.has('read'))
+        server.registerTool('memory_read', {
+            description: MEMORY_READ_DESCRIPTION,
+            inputSchema: z.object({ contextId: z.string().max(160).optional() }).strict(),
+            annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+        }, async (input) => {
+            try {
+                const view = ingress.read(input.contextId);
+                return result(view, renderMemoryView(view));
+            }
+            catch (error) {
+                return failure(error);
+            }
+        });
+    server.registerTool('memory_status', {
+        description: 'Without arguments: this connection\'s capabilities and allowed context IDs. With submissionId or importId: that item\'s processing state, the documents it is retained in (retainedIn), and a diagnostic code. "processed" with an empty retainedIn means the Core kept nothing. No memory or conversation bodies are returned.',
+        inputSchema: z.object({ submissionId: id.optional(), conversationId: id.optional(), importId: id.optional() }).strict(),
+        annotations: { readOnlyHint: true, openWorldHint: false },
+    }, async (input) => {
+        try {
+            if (input.importId !== undefined) {
+                if (input.submissionId || input.conversationId)
+                    return failure(new Error('INVALID_SUBMISSION_ID'));
+                return result({ import: ingress.initStatus(input.importId) });
+            }
+            if (!input.submissionId && input.conversationId)
+                return failure(new Error('INVALID_SUBMISSION_ID'));
+            return result(input.submissionId ? { submission: ingress.status({ submissionId: input.submissionId, conversationId: input.conversationId }) } : ingress.info());
+        }
+        catch (error) {
+            return failure(error);
+        }
+    });
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACvF,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AACzD,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,8BAA8B,EAAE,MAAM,iBAAiB,CAAC;AACtG,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD,MAAM,EAAE,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;AACtD,MAAM,QAAQ,GAAG,EAAE,YAAY,EAAE,EAAE,EAAE,cAAc,EAAE,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC;AACrE,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,CAAC,qBAAqB,EAAE,eAAe,EAAE,eAAe,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,WAAW,CAAC,CAAC,CAAC;AACrQ,SAAS,MAAM,CAAC,KAAa,EAAE,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;IACzD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,EAAE,iBAAiB,EAAE,EAAE,GAAG,KAAK,EAAE,EAAE,CAAC;AACzF,CAAC;AACD,SAAS,OAAO,CAAC,KAAc;IAC7B,MAAM,IAAI,GAAG,KAAK,YAAY,KAAK,IAAI,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,oBAAoB,CAAC;IAC5G,OAAO,EAAE,GAAG,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAChD,CAAC;AACD,MAAM,YAAY,GAA8C;IAC9D,IAAI,EAAE,oBAAoB;IAC1B,IAAI,EAAE,yxBAAyxB;IAC/xB,KAAK,EAAE,8IAA8I;CACtJ,CAAC;AAEF,MAAM,UAAU,eAAe,CAAC,OAAmB;IACjD,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACjF,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,YAAY,EAAE,CAAC,CAAC;IAC5F,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;QAAE,MAAM,CAAC,YAAY,CAAC,yBAAyB,EAAE;YACvE,WAAW,EAAE,uQAAuQ;YACpR,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE;YACrJ,WAAW,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;SACvG,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACtB,IAAI,CAAC;gBAAC,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;YAAC,CAAC;YAChE,OAAO,KAAK,EAAE,CAAC;gBAAC,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC;YAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;IACH,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC;QAAE,MAAM,CAAC,YAAY,CAAC,aAAa,EAAE;YAC1D,WAAW,EAAE,iOAAiO,8BAA8B,utCAAutC;YACn+C,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;gBACpB,QAAQ,EAAE,EAAE;gBACZ,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC;gBAC9B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;gBACtC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC;gBAC3B,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,8BAA8B,CAAC;gBACpE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC,QAAQ,EAAE;aACvD,CAAC,CAAC,MAAM,EAAE;YACX,WAAW,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE;SACzG,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACtB,IAAI,CAAC;gBAAC,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;YAAC,CAAC;YAC9D,OAAO,KAAK,EAAE,CAAC;gBAAC,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC;YAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;IACH,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC;QAAE,MAAM,CAAC,YAAY,CAAC,aAAa,EAAE;YAC1D,WAAW,EAAE,uBAAuB;YACpC,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;YAC7E,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE;SACxG,EAAE,KAAK,EAAC,KAAK,EAAC,EAAE;YACf,IAAI,CAAC;gBAAC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;gBAAC,OAAO,MAAM,CAAC,IAAI,EAAE,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC;YAAC,CAAC;YAChG,OAAO,KAAK,EAAE,CAAC;gBAAC,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC;YAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;IACH,MAAM,CAAC,YAAY,CAAC,eAAe,EAAE;QACnC,WAAW,EAAE,iUAAiU;QAC9U,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,YAAY,EAAE,EAAE,CAAC,QAAQ,EAAE,EAAE,cAAc,EAAE,EAAE,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;QACvH,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE;KAC1D,EAAE,KAAK,EAAC,KAAK,EAAC,EAAE;QACf,IAAI,CAAC;YACH,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAAC,IAAI,KAAK,CAAC,YAAY,IAAI,KAAK,CAAC,cAAc;oBAAE,OAAO,OAAO,CAAC,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC,CAAC;gBAAC,OAAO,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YAAC,CAAC;YACxM,IAAI,CAAC,KAAK,CAAC,YAAY,IAAI,KAAK,CAAC,cAAc;gBAAE,OAAO,OAAO,CAAC,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC,CAAC;YACpG,OAAO,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,YAAY,EAAE,KAAK,CAAC,YAAY,EAAE,cAAc,EAAE,KAAK,CAAC,cAAc,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QAClK,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAAC,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC;QAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/mcp/stdio.d.ts

@@ -0,0 +1,5 @@
+import { type McpOptions } from './ingress.js';
+export declare function parseMcpOptions(args: string[]): McpOptions;
+/** One process owns one Writer, even if SDK discovery invokes the factory twice. Read-only launches own none. */
+export declare function runMcp(args: string[]): Promise<void>;
+//# sourceMappingURL=stdio.d.ts.map

package/dist/mcp/stdio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio.d.ts","sourceRoot":"","sources":["../../src/mcp/stdio.ts"],"names":[],"mappings":"AAGA,OAAO,EAAoD,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAGjG,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAqB1D;AAED,iHAAiH;AACjH,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA+C1D"}

package/dist/mcp/stdio.js

@@ -0,0 +1,115 @@
+import { serveStdio, StdioServerTransport } from '@modelcontextprotocol/server/stdio';
+import { loadConfig } from '../config/config.js';
+import { createConfiguredWriter } from '../config/runtime.js';
+import { MCP_CAPABILITIES, McpIngress } from './ingress.js';
+import { createMcpServer } from './server.js';
+export function parseMcpOptions(args) {
+    const options = { clientId: '', workspaces: [], global: false, accept: false, capabilities: [] };
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === '--global')
+            options.global = true;
+        else if (arg === '--accept-client-reported-user-turns')
+            options.accept = true;
+        else if (arg === '--client-id' || arg === '--workspace' || arg === '--capability') {
+            const value = args[++i];
+            if (!value || value.startsWith('--'))
+                throw new Error('MCP option requires a value');
+            if (arg === '--workspace')
+                options.workspaces.push(value);
+            else if (arg === '--capability') {
+                if (!MCP_CAPABILITIES.includes(value))
+                    throw new Error('Unknown MCP capability');
+                if (!options.capabilities.includes(value))
+                    options.capabilities.push(value);
+            }
+            else {
+                if (options.clientId)
+                    throw new Error('Duplicate --client-id');
+                options.clientId = value;
+            }
+        }
+        else
+            throw new Error('Unknown MCP option');
+    }
+    if (!options.clientId)
+        throw new Error('MCP requires --client-id');
+    // Without --capability the process keeps its original relay behaviour.
+    if (!options.capabilities.length)
+        options.capabilities.push('relay');
+    return options;
+}
+/** One process owns one Writer, even if SDK discovery invokes the factory twice. Read-only launches own none. */
+export async function runMcp(args) {
+    const options = parseMcpOptions(args);
+    const config = loadConfig();
+    if (!config)
+        throw new Error('Run common-memory config first');
+    const readOnly = options.capabilities.every(c => c === 'read');
+    const writer = readOnly ? null : createConfiguredWriter(config);
+    let ingress;
+    try {
+        ingress = new McpIngress(writer?.store ?? null, config, options);
+    }
+    catch {
+        await writer?.close();
+        throw new Error('MCP context configuration is invalid');
+    }
+    const abort = new AbortController();
+    let running;
+    let closing;
+    let finish;
+    const finished = new Promise(resolve => { finish = resolve; });
+    const report = () => { process.stderr.write('[common-memory] MCP maintenance unavailable; inspect common-memory status.\n'); };
+    const check = () => {
+        if (closing || running || !writer)
+            return;
+        running = writer.run({ signal: abort.signal }).then(value => { if (value.outcome === 'failed')
+            report(); }, report)
+            .finally(() => { running = undefined; });
+    };
+    const transport = new StdioServerTransport(process.stdin, process.stdout, { maxBufferSize: 1024 * 1024 });
+    const handle = serveStdio(() => createMcpServer(ingress), { transport, onerror: report });
+    const timer = setInterval(check, 1000);
+    timer.unref();
+    const shutdown = () => {
+        if (closing)
+            return;
+        // Publish closing before the async cleanup can trigger transport.onclose again.
+        closing = Promise.resolve().then(async () => {
+            clearInterval(timer);
+            abort.abort();
+            try {
+                writer?.store.requestFlush();
+            }
+            catch {
+                report();
+            }
+            try {
+                await handle.close();
+                await running;
+            }
+            finally {
+                await writer?.close();
+                process.stdin.off('end', shutdown);
+                process.stdin.off('error', shutdown);
+                process.stdout.off('error', shutdown);
+                process.off('SIGINT', shutdown);
+                process.off('SIGTERM', shutdown);
+            }
+        }).catch(report).finally(finish);
+    };
+    const sdkClose = transport.onclose;
+    transport.onclose = () => { sdkClose?.(); shutdown(); };
+    process.stdin.once('end', shutdown);
+    process.stdin.once('error', shutdown);
+    process.stdout.once('error', shutdown);
+    process.once('SIGINT', shutdown);
+    process.once('SIGTERM', shutdown);
+    if (process.stdin.readableEnded || process.stdin.destroyed)
+        shutdown();
+    else
+        check();
+    await finished;
+}
+//# sourceMappingURL=stdio.js.map

package/dist/mcp/stdio.js.map

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

package/dist/memory-manager/contracts/diagnostic.d.ts

@@ -0,0 +1,14 @@
+/** Persist only these local enums and bounded scalars, never provider text or secrets. */
+export declare const DIAGNOSTIC_STAGES: readonly ["network_config", "network", "request", "http", "response_body", "response_envelope", "model_output", "core_validation", "commit", "lease", "recovery"];
+export declare const DIAGNOSTIC_REASONS: readonly ["no_proxy_invalid", "proxy_config_invalid", "ca_config_invalid", "proxy_authentication", "proxy_http_error", "proxy_unavailable", "proxy_dns_error", "tls_verification_failed", "dns_error", "connection_refused", "invalid_schema", "request_rejected", "authentication", "rate_limited", "provider_unavailable", "model_not_found", "unsupported_parameter", "context_length_exceeded", "insufficient_quota", "network_error", "body_too_large", "body_read_failed", "invalid_envelope", "incomplete_output", "output_truncated", "tool_call", "invalid_json", "refusal", "timeout", "cancelled", "lease_renewal_failed", "stale_lease", "core_rejected", "commit_failed", "recovery_conflict"];
+export type DiagnosticStage = typeof DIAGNOSTIC_STAGES[number];
+export type DiagnosticReason = typeof DIAGNOSTIC_REASONS[number];
+export interface FailureDiagnostic {
+    stage: DiagnosticStage;
+    reason: DiagnosticReason;
+    httpStatus?: number;
+    proxyStatus?: number;
+    retryable: boolean;
+}
+export declare function sanitizeDiagnostic(value: unknown): FailureDiagnostic | null;
+//# sourceMappingURL=diagnostic.d.ts.map

package/dist/memory-manager/contracts/diagnostic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostic.d.ts","sourceRoot":"","sources":["../../../src/memory-manager/contracts/diagnostic.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,eAAO,MAAM,iBAAiB,mKAAoK,CAAC;AACnM,eAAO,MAAM,kBAAkB,6qBAA8qB,CAAC;AAC9sB,MAAM,MAAM,eAAe,GAAG,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAC/D,MAAM,MAAM,gBAAgB,GAAG,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC;AACjE,MAAM,WAAW,iBAAiB;IAAG,KAAK,EAAE,eAAe,CAAC;IAAC,MAAM,EAAE,gBAAgB,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE;AACtJ,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,iBAAiB,GAAG,IAAI,CAQ3E"}

package/dist/memory-manager/contracts/diagnostic.js

@@ -0,0 +1,17 @@
+/** Persist only these local enums and bounded scalars, never provider text or secrets. */
+export const DIAGNOSTIC_STAGES = ['network_config', 'network', 'request', 'http', 'response_body', 'response_envelope', 'model_output', 'core_validation', 'commit', 'lease', 'recovery'];
+export const DIAGNOSTIC_REASONS = ['no_proxy_invalid', 'proxy_config_invalid', 'ca_config_invalid', 'proxy_authentication', 'proxy_http_error', 'proxy_unavailable', 'proxy_dns_error', 'tls_verification_failed', 'dns_error', 'connection_refused', 'invalid_schema', 'request_rejected', 'authentication', 'rate_limited', 'provider_unavailable', 'model_not_found', 'unsupported_parameter', 'context_length_exceeded', 'insufficient_quota', 'network_error', 'body_too_large', 'body_read_failed', 'invalid_envelope', 'incomplete_output', 'output_truncated', 'tool_call', 'invalid_json', 'refusal', 'timeout', 'cancelled', 'lease_renewal_failed', 'stale_lease', 'core_rejected', 'commit_failed', 'recovery_conflict'];
+export function sanitizeDiagnostic(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return null;
+    const d = value;
+    if (!DIAGNOSTIC_STAGES.includes(d.stage) || !DIAGNOSTIC_REASONS.includes(d.reason) || typeof d.retryable !== 'boolean')
+        return null;
+    const result = { stage: d.stage, reason: d.reason, retryable: d.retryable };
+    if (Number.isInteger(d.httpStatus) && Number(d.httpStatus) >= 100 && Number(d.httpStatus) <= 599)
+        result.httpStatus = Number(d.httpStatus);
+    if (Number.isInteger(d.proxyStatus) && Number(d.proxyStatus) >= 100 && Number(d.proxyStatus) <= 599)
+        result.proxyStatus = Number(d.proxyStatus);
+    return result;
+}
+//# sourceMappingURL=diagnostic.js.map

package/dist/memory-manager/contracts/diagnostic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostic.js","sourceRoot":"","sources":["../../../src/memory-manager/contracts/diagnostic.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,gBAAgB,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,mBAAmB,EAAE,cAAc,EAAE,iBAAiB,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,CAAU,CAAC;AACnM,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,kBAAkB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,WAAW,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,cAAc,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,oBAAoB,EAAE,eAAe,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,WAAW,EAAE,cAAc,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,sBAAsB,EAAE,aAAa,EAAE,eAAe,EAAE,eAAe,EAAE,mBAAmB,CAAU,CAAC;AAI9sB,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7E,MAAM,CAAC,GAAG,KAAgC,CAAC;IAC3C,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAwB,CAAC,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC,CAAC,MAA0B,CAAC,IAAI,OAAO,CAAC,CAAC,SAAS,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAC3K,MAAM,MAAM,GAAsB,EAAC,KAAK,EAAE,CAAC,CAAC,KAAwB,EAAE,MAAM,EAAE,CAAC,CAAC,MAA0B,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAC,CAAC;IACpI,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,GAAG,IAAI,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,GAAG;QAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IAC3I,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,GAAG,IAAI,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,GAAG;QAAE,MAAM,CAAC,WAAW,GAAG,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;IAChJ,OAAO,MAAM,CAAC;AAChB,CAAC"}