memory-journal-mcp 8.0.1 → 9.1.0

package/dist/transports/http/handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../../src/transports/http/handlers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAKhD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAA;AAOpE;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,IAAI,CAKpE;AAMD;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,aAAa,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,KAAK,IAAI,CAgBrG;AAMD;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,IAAI,CAgBjE;AAMD;;;GAGG;AACH,wBAAgB,oBAAoB,CAChC,SAAS,EAAE,MAAM,GAClB,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,IAAI,KAAK,IAAI,CAkDzD"}

package/dist/transports/http/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * memory-journal-mcp — HTTP Transport barrel export
+ */
+export { HttpTransport } from './server/index.js';
+export type { HttpTransportConfig } from './types.js';
+export { getClientIp, checkRateLimit } from './security.js';
+export { handleHealthCheck, handleRootInfo } from './handlers.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/transports/http/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/transports/http/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACjD,YAAY,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AACrD,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAC3D,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA"}

package/dist/transports/http/security.d.ts

@@ -0,0 +1,43 @@
+/**
+ * memory-journal-mcp — HTTP Transport Security
+ *
+ * Security utilities: rate limiting, headers, CORS, client IP extraction.
+ */
+import type { Request, Response } from 'express';
+import type { HttpTransportConfig, RateLimitEntry } from './types.js';
+/**
+ * Extract the client IP address from the request.
+ * Note: req.ip correctly respects proxy boundaries because
+ * `this.app.set('trust proxy', 'loopback')` is configured globally in the HTTP server
+ * when `trustProxy` is enabled. This prevents client IP spoofing while supporting reverse proxies.
+ * Falls back to req.socket.remoteAddress if req.ip is not available.
+ */
+export declare function getClientIp(req: Request): string;
+/**
+ * Check rate limit for a request.
+ * Returns object with `allowed` flag and optional `retryAfterSeconds`.
+ */
+export declare function checkRateLimit(req: Request, config: HttpTransportConfig, rateLimitMap: Map<string, RateLimitEntry>): {
+    allowed: boolean;
+    retryAfterSeconds?: number;
+};
+/**
+ * Set security headers for all responses.
+ *
+ * Headers: X-Content-Type-Options, X-Frame-Options, Cache-Control,
+ * Content-Security-Policy, Permissions-Policy, Referrer-Policy, HSTS (opt-in).
+ */
+export declare function setSecurityHeaders(res: Response, config: HttpTransportConfig): void;
+/**
+ * Set CORS headers based on configuration.
+ *
+ * Uses the `origin in whitelist` pattern from CodeQL's documented safe example
+ * for js/cors-misconfiguration-for-credentials. CodeQL only recognizes specific
+ * sanitizer expressions (object property lookup via `in`, `Set.has()`, etc.) —
+ * `Array.some()` with a callback is NOT recognized as a sanitizer.
+ *
+ * Wildcard subdomain patterns (`*.example.com`) are not supported when
+ * `corsAllowCredentials` is true. For credentialed CORS, list explicit origins.
+ */
+export declare function setCorsHeaders(req: Request, res: Response, config: HttpTransportConfig): boolean;
+//# sourceMappingURL=security.d.ts.map

package/dist/transports/http/security.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"security.d.ts","sourceRoot":"","sources":["../../../src/transports/http/security.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAEhD,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAYrE;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAEhD;AAMD;;;GAGG;AACH,wBAAgB,cAAc,CAC1B,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,mBAAmB,EAC3B,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,GAC1C;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAAE,CAkElD;AAMD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAYnF;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAiDhG"}

package/dist/transports/http/server/http-transport.d.ts

@@ -0,0 +1,25 @@
+import type { McpServer } from '@modelcontextprotocol/server';
+import type { McpServerFactory } from '../../../server/mcp-server/index.js';
+import type { Scheduler } from '../../../server/scheduler.js';
+import type { HttpTransportConfig } from '../types.js';
+import type { ServerRuntime } from '../../../utils/maintenance-lock.js';
+/**
+ * HTTP Transport for Memory Journal MCP Server
+ *
+ * Supports two transport protocols simultaneously:
+ * 1. Streamable HTTP (MCP 2025-03-26) via `/mcp` — preferred for modern clients
+ * 2. Legacy SSE (MCP 2024-11-05) via `/sse` + `/messages` — backward compatibility
+ */
+export declare class HttpTransport {
+    private readonly app;
+    private readonly config;
+    readonly activeServers: Set<McpServer>;
+    private httpServer;
+    private readonly sseTransports;
+    private readonly rateLimitMap;
+    private rateLimitCleanupTimer;
+    constructor(config: HttpTransportConfig);
+    start(serverFactory: McpServerFactory, scheduler: Scheduler | null, runtime: ServerRuntime): Promise<void>;
+    stop(scheduler: Scheduler | null): Promise<void>;
+}
+//# sourceMappingURL=http-transport.d.ts.map

package/dist/transports/http/server/http-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-transport.d.ts","sourceRoot":"","sources":["../../../../src/transports/http/server/http-transport.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAA;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAA;AAI3E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAA;AAC7D,OAAO,KAAK,EAAE,mBAAmB,EAAkB,MAAM,aAAa,CAAA;AAwBtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAA;AAIvE;;;;;;GAMG;AACH,qBAAa,aAAa;IACtB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,SAAgB,aAAa,iBAAuB;IACpD,OAAO,CAAC,UAAU,CAA6C;IAE/D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAG3B;IAEH,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAoC;IACjE,OAAO,CAAC,qBAAqB,CAA8C;gBAE/D,MAAM,EAAE,mBAAmB;IAYjC,KAAK,CACP,aAAa,EAAE,gBAAgB,EAC/B,SAAS,EAAE,SAAS,GAAG,IAAI,EAC3B,OAAO,EAAE,aAAa,GACvB,OAAO,CAAC,IAAI,CAAC;IAoTV,IAAI,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;CA4BzD"}

package/dist/transports/http/server/index.d.ts

@@ -0,0 +1,4 @@
+export { HttpTransport } from './http-transport.js';
+export { registerMcpProtocolRoutes, type SseTransportMap } from './protocol-handlers.js';
+export { LegacySSEServerTransport } from './legacy-sse.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/transports/http/server/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/transports/http/server/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAE,yBAAyB,EAAE,KAAK,eAAe,EAAE,MAAM,wBAAwB,CAAA;AACxF,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/transports/http/server/legacy-sse.d.ts

@@ -0,0 +1,30 @@
+import type { Transport, JSONRPCMessage } from '@modelcontextprotocol/server';
+import type { Request, Response } from 'express';
+/**
+ * A custom Server Transport that implements the Legacy SSE (MCP 2024-11-05) protocol.
+ * This is required because the official @modelcontextprotocol/server v2 package
+ * removed stateful SSEServerTransport in favor of Streamable HTTP (MCP 2025-03-26).
+ * This transport allows older clients (like SSEClientTransport) to connect using
+ * `GET /sse` followed by `POST /messages`.
+ */
+export declare class LegacySSEServerTransport implements Transport {
+    private messagesEndpoint;
+    private res;
+    sessionId: string;
+    onclose?: () => void;
+    onerror?: (error: Error) => void;
+    onmessage?: (message: JSONRPCMessage) => void;
+    constructor(messagesEndpoint: string, sessionId?: string);
+    start(): Promise<void>;
+    close(): Promise<void>;
+    send(message: JSONRPCMessage): Promise<void>;
+    /**
+     * Handles the initial GET request to establish the SSE stream.
+     */
+    handleSseRequest(req: Request, res: Response): void;
+    /**
+     * Handles incoming POST requests containing JSON-RPC messages.
+     */
+    handlePostMessage(req: Request, res: Response): void;
+}
+//# sourceMappingURL=legacy-sse.d.ts.map

package/dist/transports/http/server/legacy-sse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-sse.d.ts","sourceRoot":"","sources":["../../../../src/transports/http/server/legacy-sse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAE7E,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAGhD;;;;;;GAMG;AACH,qBAAa,wBAAyB,YAAW,SAAS;IAO1C,OAAO,CAAC,gBAAgB;IANpC,OAAO,CAAC,GAAG,CAAwB;IAC5B,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IACpB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;IAChC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAA;gBAEhC,gBAAgB,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;IAI1D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAWtB,IAAI,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAS5C;;OAEG;IACH,gBAAgB,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,IAAI;IA0BnD;;OAEG;IACH,iBAAiB,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,IAAI;CAcvD"}

package/dist/transports/http/server/protocol-handlers.d.ts

@@ -0,0 +1,9 @@
+import { NodeStreamableHTTPServerTransport } from '@modelcontextprotocol/node';
+import { type McpServer } from '@modelcontextprotocol/server';
+import type { Express } from 'express';
+import type { McpServerFactory } from '../../../server/mcp-server/index.js';
+import type { HttpTransportConfig } from '../types.js';
+import { LegacySSEServerTransport } from './legacy-sse.js';
+export type SseTransportMap = Map<string, NodeStreamableHTTPServerTransport | LegacySSEServerTransport>;
+export declare function registerMcpProtocolRoutes(app: Express, config: HttpTransportConfig, serverFactory: McpServerFactory, activeServers: Set<McpServer>, sseTransports: SseTransportMap): void;
+//# sourceMappingURL=protocol-handlers.d.ts.map

package/dist/transports/http/server/protocol-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol-handlers.d.ts","sourceRoot":"","sources":["../../../../src/transports/http/server/protocol-handlers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,iCAAiC,EAAE,MAAM,4BAA4B,CAAA;AAC7F,OAAO,EAAoB,KAAK,SAAS,EAAE,MAAM,8BAA8B,CAAA;AAE/E,OAAO,KAAK,EAAE,OAAO,EAAmC,MAAM,SAAS,CAAA;AAGvE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAA;AAE3E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAEtD,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAA;AAE1D,MAAM,MAAM,eAAe,GAAG,GAAG,CAC7B,MAAM,EACN,iCAAiC,GAAG,wBAAwB,CAC/D,CAAA;AAiBD,wBAAgB,yBAAyB,CACrC,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,mBAAmB,EAC3B,aAAa,EAAE,gBAAgB,EAC/B,aAAa,EAAE,GAAG,CAAC,SAAS,CAAC,EAC7B,aAAa,EAAE,eAAe,GAC/B,IAAI,CAkPN"}

package/dist/transports/http/types.d.ts

@@ -0,0 +1,95 @@
+/**
+ * memory-journal-mcp — HTTP Transport Types
+ *
+ * Shared interfaces and constants for the HTTP transport module.
+ */
+/** HTTP request timeout (ms) — prevents slowloris-style DoS */
+export declare const HTTP_REQUEST_TIMEOUT_MS = 120000;
+/** Keep-alive timeout (ms) — slightly above common LB idle timeout */
+export declare const HTTP_KEEP_ALIVE_TIMEOUT_MS = 65000;
+/** Headers timeout (ms) — must be > keepAliveTimeout per Node.js docs */
+export declare const HTTP_HEADERS_TIMEOUT_MS = 66000;
+export declare const DEFAULT_RATE_LIMIT_WINDOW_MS = 60000;
+export declare const DEFAULT_RATE_LIMIT_MAX_REQUESTS = 100;
+export declare const DEFAULT_MAX_BODY_BYTES = 1048576;
+export declare const DEFAULT_HSTS_MAX_AGE = 31536000;
+/** CORS preflight cache duration (seconds) — browsers cache OPTIONS responses for 24h */
+export declare const CORS_PREFLIGHT_MAX_AGE_SECONDS = 86400;
+/** JSON-RPC server error (protocol-level, not application errors) */
+export declare const JSONRPC_SERVER_ERROR = -32000;
+/** JSON-RPC internal error */
+export declare const JSONRPC_INTERNAL_ERROR = -32603;
+/** Session timeout for stateful HTTP mode (30 minutes) */
+export declare const SESSION_TIMEOUT_MS: number;
+/** Session timeout sweep interval (1 minute) */
+export declare const SESSION_SWEEP_INTERVAL_MS: number;
+export interface RateLimitEntry {
+    count: number;
+    resetTime: number;
+    lastSeen: number;
+}
+/**
+ * HTTP transport configuration
+ */
+export interface HttpTransportConfig {
+    /** Port to listen on */
+    port: number;
+    /** Host to bind to (default: localhost) */
+    host: string;
+    /** Enable stateless HTTP mode (default: false) */
+    stateless: boolean;
+    /** Bearer token for authentication (optional) */
+    authToken?: string;
+    /**
+     * Allowed CORS origins. Defaults to `[]` (no origins allowed — strict by default).
+     * To allow all origins, pass `["*"]`. For production, list explicit origins.
+     * Note: `corsAllowCredentials` cannot be combined with the `"*"` wildcard.
+     */
+    corsOrigins?: string[];
+    /** Allow credentials in CORS requests (default: false) */
+    corsAllowCredentials?: boolean;
+    /**
+     * Trust proxy headers for client IP extraction (default: false).
+     * When enabled, uses the leftmost IP from X-Forwarded-For for rate limiting.
+     * Only enable when running behind a trusted reverse proxy.
+     */
+    trustProxy?: boolean;
+    /**
+     * Enable HTTP Strict Transport Security header (default: false).
+     * Should only be enabled when running behind HTTPS.
+     */
+    enableHSTS?: boolean;
+    /** HSTS max-age in seconds (default: 31536000 = 1 year) */
+    hstsMaxAge?: number;
+    /** Enable rate limiting (default: true) */
+    enableRateLimit?: boolean;
+    /** Rate limit window in milliseconds (default: 60000 = 1 minute) */
+    rateLimitWindowMs?: number;
+    /** Maximum requests per window per IP (default: 100) */
+    rateLimitMaxRequests?: number;
+    /** Maximum request body size in bytes (default: 1MB) */
+    maxBodySize?: number;
+    /** Enable OAuth 2.1 authentication (default: false) */
+    oauthEnabled?: boolean;
+    /** OAuth issuer URL (authorization server) */
+    oauthIssuer?: string;
+    /** Expected OAuth audience (client ID) */
+    oauthAudience?: string;
+    /** JWKS URI for key discovery (auto-discovered if not set) */
+    oauthJwksUri?: string;
+    /** Clock tolerance in seconds for token validation (default: 60) */
+    oauthClockTolerance?: number;
+    /**
+     * The public resource origin for OAuth RFC 9728 metadata (e.g. "https://example.com").
+     * If omitted, falls back to the dynamic http://${host}:${port}.
+     */
+    publicOrigin?: string;
+    /**
+     * Explicit flag to allow plaintext (http://) loopback URLs for OAuth operations.
+     * Prevents accidental deployment of insecure issuers.
+     */
+    allowPlaintextLoopbackOAuth?: boolean;
+    /** Metrics export format. When set to 'prometheus', exposes GET /metrics endpoint. */
+    metricsExport?: 'prometheus';
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/transports/http/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/transports/http/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,+DAA+D;AAC/D,eAAO,MAAM,uBAAuB,SAAU,CAAA;AAE9C,sEAAsE;AACtE,eAAO,MAAM,0BAA0B,QAAS,CAAA;AAEhD,yEAAyE;AACzE,eAAO,MAAM,uBAAuB,QAAS,CAAA;AAM7C,eAAO,MAAM,4BAA4B,QAAS,CAAA;AAClD,eAAO,MAAM,+BAA+B,MAAM,CAAA;AAClD,eAAO,MAAM,sBAAsB,UAAY,CAAA;AAC/C,eAAO,MAAM,oBAAoB,WAAa,CAAA;AAE9C,yFAAyF;AACzF,eAAO,MAAM,8BAA8B,QAAS,CAAA;AAMpD,qEAAqE;AACrE,eAAO,MAAM,oBAAoB,SAAS,CAAA;AAE1C,8BAA8B;AAC9B,eAAO,MAAM,sBAAsB,SAAS,CAAA;AAE5C,0DAA0D;AAC1D,eAAO,MAAM,kBAAkB,QAAiB,CAAA;AAEhD,gDAAgD;AAChD,eAAO,MAAM,yBAAyB,QAAgB,CAAA;AAMtD,MAAM,WAAW,cAAc;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;CACnB;AAMD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAA;IAEZ,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAA;IAEZ,kDAAkD;IAClD,SAAS,EAAE,OAAO,CAAA;IAElB,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;IAEtB,0DAA0D;IAC1D,oBAAoB,CAAC,EAAE,OAAO,CAAA;IAE9B;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;IAEpB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;IAEpB,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB,2CAA2C;IAC3C,eAAe,CAAC,EAAE,OAAO,CAAA;IAEzB,oEAAoE;IACpE,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAE1B,wDAAwD;IACxD,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAE7B,wDAAwD;IACxD,WAAW,CAAC,EAAE,MAAM,CAAA;IAMpB,uDAAuD;IACvD,YAAY,CAAC,EAAE,OAAO,CAAA;IAEtB,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB,0CAA0C;IAC1C,aAAa,CAAC,EAAE,MAAM,CAAA;IAEtB,8DAA8D;IAC9D,YAAY,CAAC,EAAE,MAAM,CAAA;IAErB,oEAAoE;IACpE,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAE5B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IAErB;;;OAGG;IACH,2BAA2B,CAAC,EAAE,OAAO,CAAA;IAErC,sFAAsF;IACtF,aAAa,CAAC,EAAE,YAAY,CAAA;CAC/B"}

package/dist/types/auto-context.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Memory Journal MCP Server - AutoContext boundary validation
+ */
+import { z } from 'zod';
+/**
+ * Session Commit Context Schema
+ */
+export declare const SessionCommitContextSchema: z.ZodObject<{
+    commits: z.ZodArray<z.ZodString>;
+    branch: z.ZodOptional<z.ZodString>;
+    pr: z.ZodOptional<z.ZodNumber>;
+    repo: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type SessionCommitContext = z.infer<typeof SessionCommitContextSchema>;
+/**
+ * Versioned Envelope Schema for explicit typing
+ */
+export declare const VersionedEnvelopeSchema: z.ZodObject<{
+    version: z.ZodString;
+    data: z.ZodUnknown;
+}, z.core.$strip>;
+export type VersionedEnvelope = z.infer<typeof VersionedEnvelopeSchema>;
+/**
+ * Union schema for all valid AutoContext payloads
+ */
+export declare const AutoContextSchema: z.ZodUnion<readonly [z.ZodObject<{
+    version: z.ZodString;
+    data: z.ZodUnknown;
+}, z.core.$strip>, z.ZodObject<{
+    commits: z.ZodArray<z.ZodString>;
+    branch: z.ZodOptional<z.ZodString>;
+    pr: z.ZodOptional<z.ZodNumber>;
+    repo: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>]>;
+/**
+ * Helper to safely parse and validate autoContext JSON.
+ * Returns the parsed object, or null if invalid/omitted.
+ */
+export declare function parseAutoContext(autoContext: string | null | undefined): Record<string, unknown> | null;
+/**
+ * Safe extractor specifically for Session Commit entries.
+ */
+export declare function parseSessionCommitContext(autoContext: string | null | undefined): SessionCommitContext | null;
+//# sourceMappingURL=auto-context.d.ts.map

package/dist/types/auto-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-context.d.ts","sourceRoot":"","sources":["../../src/types/auto-context.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB;;GAEG;AACH,eAAO,MAAM,0BAA0B;;;;;iBAKrC,CAAA;AAEF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAA;AAE7E;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;iBAGlC,CAAA;AAEF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAEvE;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;mBAG5B,CAAA;AAEF;;;GAGG;AACH,wBAAgB,gBAAgB,CAC5B,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACvC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CA2BhC;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACrC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACvC,oBAAoB,GAAG,IAAI,CAM7B"}

package/dist/types/entities.d.ts

@@ -0,0 +1,180 @@
+/**
+ * Memory Journal MCP Server - Database Entity Types
+ */
+/**
+ * Entry types for journal entries
+ */
+export declare const ENTRY_TYPES: readonly ["personal_reflection", "project_decision", "technical_achievement", "bug_fix", "feature_implementation", "code_review", "meeting_notes", "learning", "research", "planning", "retrospective", "standup", "technical_note", "development_note", "enhancement", "milestone", "system_integration_test", "test_entry", "plan_draft", "adversarial_review", "plan_refinement", "plan_finalized", "copilot_validation", "maintenance", "other"];
+export type EntryType = typeof ENTRY_TYPES[number];
+/**
+ * Significance types for important entries
+ */
+export declare const SIGNIFICANCE_TYPES: readonly ["milestone", "breakthrough", "decision", "architecture", "lesson_learned", "blocker_resolved", "release", "security"];
+export type SignificanceType = typeof SIGNIFICANCE_TYPES[number] | null;
+/**
+ * Relationship types between entries
+ *
+ * Standard types:
+ * - evolves_from: Entry builds upon previous work
+ * - references: Entry mentions or links to another
+ * - implements: Entry implements a spec/design
+ * - clarifies: Entry explains or clarifies another
+ * - response_to: Entry responds to a question/issue
+ *
+ * Causal types (for decision tracing):
+ * - blocked_by: Entry was blocked by another (e.g., blocker → resolution)
+ * - resolved: Entry resolved/fixed an issue from another
+ * - caused: Entry caused or led to another outcome
+ */
+export declare const RELATIONSHIP_TYPES: readonly ["evolves_from", "references", "implements", "clarifies", "response_to", "blocked_by", "resolved", "caused"];
+export type RelationshipType = typeof RELATIONSHIP_TYPES[number];
+/**
+ * Journal entry entity
+ */
+export interface JournalEntry {
+    id: number;
+    entryType: EntryType;
+    content: string;
+    timestamp: string;
+    isPersonal: boolean;
+    significanceType: SignificanceType;
+    autoContext: string | null;
+    deletedAt: string | null;
+    isArchived: boolean;
+    tags: string[];
+    projectNumber?: number | null;
+    projectOwner?: string | null;
+    issueNumber?: number | null;
+    issueUrl?: string | null;
+    prNumber?: number | null;
+    prUrl?: string | null;
+    prStatus?: string | null;
+    workflowRunId?: number | null;
+    workflowName?: string | null;
+    workflowStatus?: string | null;
+    importanceScore?: number;
+    trustScore?: number;
+    impactScore?: number;
+    validationStatus?: 'passed' | 'failed' | 'none';
+    version: number;
+    workspaceId?: string;
+    sessionId?: string | null;
+}
+/**
+ * Anchor status representing the validity of an external reference
+ */
+export type AnchorStatus = 'pending' | 'valid' | 'stale' | 'invalidated' | 'unresolvable';
+/**
+ * Anchor entity representing a referenced file or dependency
+ */
+export interface Anchor {
+    id?: number;
+    entryId: number;
+    anchorPath: string;
+    anchorType: string;
+    status: AnchorStatus;
+    lastCheckedAt?: string;
+}
+/**
+ * Entry revision entity for history tracking
+ */
+export interface EntryRevision {
+    id: number;
+    entryId: number;
+    revisionNumber: number;
+    contentSnapshot: string;
+    changedAt: string;
+    changedBy: string | null;
+}
+/**
+ * Tag entity
+ */
+export interface Tag {
+    id: number;
+    name: string;
+    usageCount: number;
+}
+/**
+ * Relationship entity
+ */
+export interface Relationship {
+    id: number;
+    fromEntryId: number;
+    toEntryId: number;
+    relationshipType: RelationshipType;
+    description: string | null;
+    createdAt: string;
+}
+/**
+ * Embedding entity for vector search
+ */
+export interface Embedding {
+    entryId: number;
+    embedding: Float32Array;
+    modelName: string;
+}
+/**
+ * Importance scoring breakdown showing weighted component contributions
+ */
+export interface ImportanceBreakdown {
+    /** Significance type and impact contribution (weight: 0.30) */
+    significance: number;
+    /** Relationship count contribution (weight: 0.35) */
+    relationships: number;
+    /** Causal relationship contribution (weight: 0.20) */
+    causal: number;
+    /** Recency decay contribution (weight: 0.15) */
+    recency: number;
+    /** Trust and anchor validity contribution (weight modifier) */
+    trustModifier?: number;
+}
+/**
+ * Importance calculation result with total score and component breakdown
+ */
+export interface ImportanceResult {
+    /** Total importance score (0.0-1.0) */
+    score: number;
+    /** Weighted component contributions */
+    breakdown: ImportanceBreakdown;
+}
+/**
+ * Input for creating a new entry
+ */
+export interface CreateEntryInput {
+    content: string;
+    entryType?: EntryType | undefined;
+    tags?: string[] | undefined;
+    isPersonal?: boolean | undefined;
+    significanceType?: SignificanceType | undefined;
+    autoContext?: string | undefined;
+    isArchived?: boolean | undefined;
+    timestamp?: string | undefined;
+    projectNumber?: number | undefined;
+    projectOwner?: string | undefined;
+    issueNumber?: number | undefined;
+    issueUrl?: string | undefined;
+    prNumber?: number | undefined;
+    prUrl?: string | undefined;
+    prStatus?: 'draft' | 'open' | 'merged' | 'closed' | undefined;
+    workflowRunId?: number | undefined;
+    workflowName?: string | undefined;
+    workflowStatus?: 'queued' | 'in_progress' | 'completed' | undefined;
+    author?: string | undefined;
+    workspaceId?: string | undefined;
+    trustScore?: number | undefined;
+    impactScore?: number | undefined;
+    validationStatus?: 'passed' | 'failed' | 'none' | undefined;
+    anchors?: {
+        anchorPath: string;
+        anchorType: string;
+    }[] | undefined;
+    sessionId?: string | undefined;
+}
+/**
+ * Input for creating a team entry (extends standard entry with author)
+ */
+export interface CreateTeamEntryInput extends CreateEntryInput {
+    author?: string | undefined;
+    workspaceId?: string | undefined;
+}
+//# sourceMappingURL=entities.d.ts.map

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

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

package/dist/types/error-types.d.ts

@@ -0,0 +1,48 @@
+/**
+ * memory-journal-mcp — Error Type Definitions
+ *
+ * Standardized error types for the harmonized error handling system
+ * across all MCP servers (db-mcp, postgres-mcp, mysql-mcp, memory-journal-mcp).
+ */
+/**
+ * Categorization of error types for structured error responses.
+ * Enables agents to make programmatic decisions based on error category.
+ */
+export type ErrorCategory = 'validation' | 'connection' | 'query' | 'permission' | 'configuration' | 'resource' | 'authentication' | 'authorization' | 'internal' | 'conflict';
+/**
+ * Structured error response returned by tools.
+ * Provides agents with actionable context for error handling.
+ */
+export interface ErrorResponse {
+    /** Always false for error responses */
+    success: false;
+    /** Human-readable error message */
+    error: string;
+    /** Module-prefixed error code (e.g., 'AUTH_TOKEN_EXPIRED') */
+    code: string;
+    /** Error category for programmatic handling */
+    category: ErrorCategory;
+    /** Actionable suggestion for resolving the error */
+    suggestion?: string | undefined;
+    /** Whether the operation can be retried */
+    recoverable: boolean;
+    /** Details of individual errors in a multi-step operation */
+    aggregated_errors?: {
+        message: string;
+        [key: string]: unknown;
+    }[] | undefined;
+    /** Additional structured context */
+    details?: Record<string, unknown> | undefined;
+}
+/**
+ * Context information for error reporting and diagnostics.
+ */
+export interface ErrorContext {
+    /** The operation that failed */
+    operation?: string;
+    /** Entity identifier involved */
+    entityId?: string | number;
+    /** Additional context key-value pairs */
+    [key: string]: unknown;
+}
+//# sourceMappingURL=error-types.d.ts.map

package/dist/types/error-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-types.d.ts","sourceRoot":"","sources":["../../src/types/error-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;;GAGG;AACH,MAAM,MAAM,aAAa,GACnB,YAAY,GACZ,YAAY,GACZ,OAAO,GACP,YAAY,GACZ,eAAe,GACf,UAAU,GACV,gBAAgB,GAChB,eAAe,GACf,UAAU,GACV,UAAU,CAAA;AAMhB;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC1B,uCAAuC;IACvC,OAAO,EAAE,KAAK,CAAA;IAEd,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAA;IAEb,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAA;IAEZ,+CAA+C;IAC/C,QAAQ,EAAE,aAAa,CAAA;IAEvB,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAE/B,2CAA2C;IAC3C,WAAW,EAAE,OAAO,CAAA;IAEpB,6DAA6D;IAC7D,iBAAiB,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,EAAE,GAAG,SAAS,CAAA;IAE7E,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAA;CAChD;AAMD;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAE1B,yCAAyC;IACzC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACzB"}

package/dist/types/errors.d.ts

@@ -0,0 +1,108 @@
+/**
+ * memory-journal-mcp — Base Error Classes
+ *
+ * Enriched error hierarchy with category, suggestion, recoverable,
+ * and toResponse() for structured error handling.
+ */
+import type { ErrorCategory, ErrorResponse } from './error-types.js';
+interface ErrorOptions {
+    /** Actionable suggestion for resolving the error */
+    suggestion?: string | undefined;
+    /** Whether the operation can be retried */
+    recoverable?: boolean | undefined;
+    /** Additional structured context */
+    details?: Record<string, unknown> | undefined;
+    /** Original cause error */
+    cause?: unknown;
+}
+/**
+ * Base error class for all memory-journal-mcp errors.
+ * Provides structured error responses with category, suggestion,
+ * and recoverable fields for agent-friendly error handling.
+ *
+ * Auto-refinement: when constructed with a generic code (e.g., QUERY_FAILED)
+ * and the message matches a known pattern from ERROR_SUGGESTIONS, the code
+ * is refined to a more specific value (e.g., TABLE_NOT_FOUND).
+ */
+export declare class MemoryJournalMcpError extends Error {
+    /** Module-prefixed error code */
+    readonly code: string;
+    /** Error category for programmatic handling */
+    readonly category: ErrorCategory;
+    /** Actionable suggestion for resolving the error */
+    readonly suggestion?: string | undefined;
+    /** Whether the operation can be retried */
+    readonly recoverable: boolean;
+    /** Additional structured context */
+    readonly details?: Record<string, unknown> | undefined;
+    constructor(message: string, code: string, category: ErrorCategory, options?: ErrorOptions);
+    /**
+     * Convert to a structured ErrorResponse for tool responses.
+     */
+    toResponse(): ErrorResponse;
+}
+/**
+ * Database connection or initialization error
+ */
+export declare class ConnectionError extends MemoryJournalMcpError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+/**
+ * Query execution error
+ */
+export declare class QueryError extends MemoryJournalMcpError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+/**
+ * Input validation error (bad parameters, schema violations)
+ */
+export declare class ValidationError extends MemoryJournalMcpError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+/**
+ * Optimistic concurrency version conflict
+ */
+export declare class ConflictError extends MemoryJournalMcpError {
+    readonly currentState: Record<string, unknown>;
+    constructor(message: string, currentState: Record<string, unknown>);
+}
+/**
+ * Resource not found error
+ */
+export declare class ResourceNotFoundError extends MemoryJournalMcpError {
+    constructor(resourceType: string, identifier: string);
+}
+/**
+ * Server or service configuration error
+ */
+export declare class ConfigurationError extends MemoryJournalMcpError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+/**
+ * File or database permission error
+ */
+export declare class PermissionError extends MemoryJournalMcpError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+/**
+ * Authorization error (e.g. RBAC denial)
+ */
+export declare class AuthorizationError extends MemoryJournalMcpError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+/**
+ * Aggregation of multiple errors in a multi-step operation.
+ */
+export declare class AggregateMcpError extends MemoryJournalMcpError {
+    readonly errors: {
+        message: string;
+        [key: string]: unknown;
+    }[];
+    constructor(message: string, errors: {
+        message: string;
+        [key: string]: unknown;
+    }[], details?: Record<string, unknown>);
+    toResponse(): ErrorResponse;
+}
+export {};
+//# sourceMappingURL=errors.d.ts.map