@prmichaelsen/remember-mcp 2.2.1 → 2.3.1

package/dist/services/confirmation-token.service.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Confirmation Token Service
+ *
+ * Manages confirmation tokens for sensitive operations like publishing memories.
+ * Tokens are one-time use with 5-minute expiry.
+ */
+/**
+ * Confirmation request stored in Firestore
+ */
+export interface ConfirmationRequest {
+    user_id: string;
+    token: string;
+    action: string;
+    target_collection?: string;
+    payload: any;
+    created_at: string;
+    expires_at: string;
+    status: 'pending' | 'confirmed' | 'denied' | 'expired' | 'retracted';
+    confirmed_at?: string;
+}
+/**
+ * Service for managing confirmation tokens
+ */
+export declare class ConfirmationTokenService {
+    private readonly EXPIRY_MINUTES;
+    /**
+     * Create a new confirmation request
+     *
+     * @param userId - User ID who initiated the request
+     * @param action - Action type (e.g., 'publish_memory')
+     * @param payload - Data to store with the request
+     * @param targetCollection - Optional target collection (e.g., 'the_void')
+     * @returns Request ID and token
+     */
+    createRequest(userId: string, action: string, payload: any, targetCollection?: string): Promise<{
+        requestId: string;
+        token: string;
+    }>;
+    /**
+     * Validate and retrieve a confirmation request
+     *
+     * @param userId - User ID
+     * @param token - Confirmation token
+     * @returns Request with request_id if valid, null otherwise
+     */
+    validateToken(userId: string, token: string): Promise<(ConfirmationRequest & {
+        request_id: string;
+    }) | null>;
+    /**
+     * Confirm a request
+     *
+     * @param userId - User ID
+     * @param token - Confirmation token
+     * @returns Confirmed request if valid, null otherwise
+     */
+    confirmRequest(userId: string, token: string): Promise<(ConfirmationRequest & {
+        request_id: string;
+    }) | null>;
+    /**
+     * Deny a request
+     *
+     * @param userId - User ID
+     * @param token - Confirmation token
+     * @returns True if denied successfully, false otherwise
+     */
+    denyRequest(userId: string, token: string): Promise<boolean>;
+    /**
+     * Retract a request
+     *
+     * @param userId - User ID
+     * @param token - Confirmation token
+     * @returns True if retracted successfully, false otherwise
+     */
+    retractRequest(userId: string, token: string): Promise<boolean>;
+    /**
+     * Update request status
+     *
+     * @param userId - User ID
+     * @param requestId - Request document ID
+     * @param status - New status
+     */
+    private updateStatus;
+    /**
+     * Clean up expired requests (optional - Firestore TTL handles deletion)
+     *
+     * Note: Configure Firestore TTL policy on 'requests' collection group
+     * with 'expires_at' field for automatic deletion within 24 hours.
+     *
+     * This method is optional for immediate cleanup if needed.
+     *
+     * @returns Count of deleted requests
+     */
+    cleanupExpired(): Promise<number>;
+}
+/**
+ * Singleton instance of the confirmation token service
+ */
+export declare const confirmationTokenService: ConfirmationTokenService;
+//# sourceMappingURL=confirmation-token.service.d.ts.map

package/dist/services/confirmation-token.service.spec.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Unit tests for Confirmation Token Service
+ */
+export {};
+//# sourceMappingURL=confirmation-token.service.spec.d.ts.map

package/dist/tools/confirm.d.ts

@@ -0,0 +1,20 @@
+/**
+ * remember_confirm tool
+ *
+ * Generic confirmation tool that executes any pending action.
+ * This is the second phase of the confirmation workflow.
+ */
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * Tool definition for remember_confirm
+ */
+export declare const confirmTool: Tool;
+interface ConfirmArgs {
+    token: string;
+}
+/**
+ * Handle remember_confirm tool execution
+ */
+export declare function handleConfirm(args: ConfirmArgs, userId: string): Promise<string>;
+export {};
+//# sourceMappingURL=confirm.d.ts.map

package/dist/tools/deny.d.ts

@@ -0,0 +1,19 @@
+/**
+ * remember_deny tool
+ *
+ * Generic denial tool for any pending action.
+ */
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * Tool definition for remember_deny
+ */
+export declare const denyTool: Tool;
+interface DenyArgs {
+    token: string;
+}
+/**
+ * Handle remember_deny tool execution
+ */
+export declare function handleDeny(args: DenyArgs, userId: string): Promise<string>;
+export {};
+//# sourceMappingURL=deny.d.ts.map

package/dist/tools/publish.d.ts

@@ -0,0 +1,22 @@
+/**
+ * remember_publish tool
+ *
+ * Generates a confirmation token for publishing a memory to a shared space.
+ * This is the first phase of the two-phase publish workflow.
+ */
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * Tool definition for remember_publish
+ */
+export declare const publishTool: Tool;
+interface PublishArgs {
+    memory_id: string;
+    target: string;
+    additional_tags?: string[];
+}
+/**
+ * Handle remember_publish tool execution
+ */
+export declare function handlePublish(args: PublishArgs, userId: string): Promise<string>;
+export {};
+//# sourceMappingURL=publish.d.ts.map

package/dist/tools/query-space.d.ts

@@ -0,0 +1,28 @@
+/**
+ * remember_query_space tool
+ *
+ * RAG-optimized natural language queries for shared spaces.
+ * Similar to remember_query_memory but queries space collections.
+ */
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * Tool definition for remember_query_space
+ */
+export declare const querySpaceTool: Tool;
+interface QuerySpaceArgs {
+    question: string;
+    space: string;
+    content_type?: string;
+    tags?: string[];
+    min_weight?: number;
+    date_from?: string;
+    date_to?: string;
+    limit?: number;
+    format?: 'detailed' | 'compact';
+}
+/**
+ * Handle remember_query_space tool execution
+ */
+export declare function handleQuerySpace(args: QuerySpaceArgs, userId: string): Promise<string>;
+export {};
+//# sourceMappingURL=query-space.d.ts.map

package/dist/tools/search-space.d.ts

@@ -0,0 +1,29 @@
+/**
+ * remember_search_space tool
+ *
+ * Search shared spaces to discover memories from other users.
+ * Similar to remember_search_memory but searches space collections.
+ */
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * Tool definition for remember_search_space
+ */
+export declare const searchSpaceTool: Tool;
+interface SearchSpaceArgs {
+    query: string;
+    space: string;
+    content_type?: string;
+    tags?: string[];
+    min_weight?: number;
+    max_weight?: number;
+    date_from?: string;
+    date_to?: string;
+    limit?: number;
+    offset?: number;
+}
+/**
+ * Handle remember_search_space tool execution
+ */
+export declare function handleSearchSpace(args: SearchSpaceArgs, userId: string): Promise<string>;
+export {};
+//# sourceMappingURL=search-space.d.ts.map

package/dist/types/space-memory.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Space Memory type definitions for remember-mcp
+ *
+ * Space memories are memories published to shared collections
+ * where they can be discovered by other users.
+ */
+import type { Memory, SearchOptions, SearchResult } from './memory.js';
+/**
+ * Space memory - a memory published to a shared space
+ *
+ * Extends Memory with additional fields for attribution and discovery
+ */
+export interface SpaceMemory extends Omit<Memory, 'user_id' | 'doc_type'> {
+    /**
+     * Space identifier (snake_case)
+     * Examples: 'the_void', 'public_space'
+     */
+    space_id: string;
+    /**
+     * Original author's user_id (for permissions)
+     * This is private and not shown publicly
+     */
+    author_id: string;
+    /**
+     * Optional ghost profile ID for pseudonymous publishing
+     * If present, memory is attributed to ghost instead of user
+     */
+    ghost_id?: string;
+    /**
+     * When the memory was published to the space
+     */
+    published_at: string;
+    /**
+     * How many times this memory has been discovered/viewed
+     */
+    discovery_count: number;
+    /**
+     * Attribution type
+     * - 'user': Published as the user (shows author_id)
+     * - 'ghost': Published as a ghost (shows ghost_id)
+     */
+    attribution: 'user' | 'ghost';
+    /**
+     * Document type discriminator
+     * Always 'space_memory' for space memories
+     */
+    doc_type: 'space_memory';
+}
+/**
+ * Search options for space memories
+ * Same as SearchOptions but for space collections
+ */
+export interface SpaceSearchOptions extends Omit<SearchOptions, 'include_relationships'> {
+    /**
+     * Space to search
+     */
+    space: string;
+}
+/**
+ * Search result for space memories
+ */
+export interface SpaceSearchResult extends Omit<SearchResult, 'memories' | 'relationships'> {
+    /**
+     * Found space memories
+     */
+    space_memories: SpaceMemory[];
+}
+/**
+ * Supported space IDs
+ */
+export type SpaceId = 'the_void';
+/**
+ * Space display names mapped to IDs
+ */
+export declare const SPACE_DISPLAY_NAMES: Record<SpaceId, string>;
+/**
+ * Supported spaces constant
+ */
+export declare const SUPPORTED_SPACES: SpaceId[];
+//# sourceMappingURL=space-memory.d.ts.map

package/dist/weaviate/space-schema.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Weaviate space collection schema and utilities
+ *
+ * Manages shared space collections where users can publish memories
+ * for discovery by other users.
+ */
+import { type WeaviateClient, type Collection } from 'weaviate-client';
+/**
+ * Get collection name for a space
+ *
+ * @param spaceId - Space identifier (snake_case)
+ * @returns Collection name in format Memory_{space_id}
+ *
+ * @example
+ * getSpaceCollectionName('the_void') // Returns 'Memory_the_void'
+ */
+export declare function getSpaceCollectionName(spaceId: string): string;
+/**
+ * Sanitize display name to space ID
+ *
+ * Converts display names like "The Void" to snake_case IDs like "the_void"
+ *
+ * @param displayName - Display name with spaces and mixed case
+ * @returns snake_case space ID
+ *
+ * @example
+ * sanitizeSpaceId('The Void') // Returns 'the_void'
+ * sanitizeSpaceId('Public Space') // Returns 'public_space'
+ */
+export declare function sanitizeSpaceId(displayName: string): string;
+/**
+ * Get display name for a space ID
+ *
+ * @param spaceId - Space identifier
+ * @returns Display name or the space ID if not found
+ *
+ * @example
+ * getSpaceDisplayName('the_void') // Returns 'The Void'
+ */
+export declare function getSpaceDisplayName(spaceId: string): string;
+/**
+ * Validate space ID
+ *
+ * @param spaceId - Space identifier to validate
+ * @returns True if valid, false otherwise
+ */
+export declare function isValidSpaceId(spaceId: string): boolean;
+/**
+ * Ensure a space collection exists, creating it if needed
+ *
+ * @param client - Weaviate client
+ * @param spaceId - Space identifier
+ * @returns Collection reference
+ *
+ * @example
+ * const collection = await ensureSpaceCollection(client, 'the_void');
+ */
+export declare function ensureSpaceCollection(client: WeaviateClient, spaceId: string): Promise<Collection<any>>;
+//# sourceMappingURL=space-schema.d.ts.map

package/dist/weaviate/space-schema.spec.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Unit tests for Space Schema utilities
+ */
+export {};
+//# sourceMappingURL=space-schema.spec.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prmichaelsen/remember-mcp",
-  "version": "2.2.1",
+  "version": "2.3.1",
   "description": "Multi-tenant memory system MCP server with vector search and relationships",
   "main": "dist/server.js",
   "type": "module",

package/src/server-factory.ts

@@ -32,6 +32,13 @@ import { deleteRelationshipTool, handleDeleteRelationship } from './tools/delete
 import { setPreferenceTool, handleSetPreference } from './tools/set-preference.js';
 import { getPreferencesTool, handleGetPreferences } from './tools/get-preferences.js';
 
+// Import space tools
+import { publishTool, handlePublish } from './tools/publish.js';
+import { confirmTool, handleConfirm } from './tools/confirm.js';
+import { denyTool, handleDeny } from './tools/deny.js';
+import { searchSpaceTool, handleSearchSpace } from './tools/search-space.js';
+import { querySpaceTool, handleQuerySpace } from './tools/query-space.js';
+
 export interface ServerOptions {
   name?: string;
   version?: string;
@@ -173,6 +180,12 @@ function registerHandlers(server: Server, userId: string, accessToken: string):
         // Preference tools
         setPreferenceTool,
         getPreferencesTool,
+        // Space tools
+        publishTool,
+        confirmTool,
+        denyTool,
+        searchSpaceTool,
+        querySpaceTool,
       ],
     };
   });
@@ -233,6 +246,26 @@ function registerHandlers(server: Server, userId: string, accessToken: string):
           result = await handleGetPreferences(args as any, userId);
           break;
 
+        case 'remember_publish':
+          result = await handlePublish(args as any, userId);
+          break;
+
+        case 'remember_confirm':
+          result = await handleConfirm(args as any, userId);
+          break;
+
+        case 'remember_deny':
+          result = await handleDeny(args as any, userId);
+          break;
+
+        case 'remember_search_space':
+          result = await handleSearchSpace(args as any, userId);
+          break;
+
+        case 'remember_query_space':
+          result = await handleQuerySpace(args as any, userId);
+          break;
+
         default:
           throw new McpError(
             ErrorCode.MethodNotFound,

package/src/server.ts

@@ -31,6 +31,13 @@ import { deleteRelationshipTool, handleDeleteRelationship } from './tools/delete
 import { setPreferenceTool, handleSetPreference } from './tools/set-preference.js';
 import { getPreferencesTool, handleGetPreferences } from './tools/get-preferences.js';
 
+// Import space tools
+import { publishTool, handlePublish } from './tools/publish.js';
+import { confirmTool, handleConfirm } from './tools/confirm.js';
+import { denyTool, handleDeny } from './tools/deny.js';
+import { searchSpaceTool, handleSearchSpace } from './tools/search-space.js';
+import { querySpaceTool, handleQuerySpace } from './tools/query-space.js';
+
 /**
  * Initialize remember-mcp server
  */
@@ -98,6 +105,12 @@ function registerHandlers(server: Server): void {
         // Preference tools
         setPreferenceTool,
         getPreferencesTool,
+        // Space tools
+        publishTool,
+        confirmTool,
+        denyTool,
+        searchSpaceTool,
+        querySpaceTool,
       ],
     };
   });
@@ -162,6 +175,26 @@ function registerHandlers(server: Server): void {
           result = await handleGetPreferences(args as any, userId);
           break;
 
+        case 'remember_publish':
+          result = await handlePublish(args as any, userId);
+          break;
+
+        case 'remember_confirm':
+          result = await handleConfirm(args as any, userId);
+          break;
+
+        case 'remember_deny':
+          result = await handleDeny(args as any, userId);
+          break;
+
+        case 'remember_search_space':
+          result = await handleSearchSpace(args as any, userId);
+          break;
+
+        case 'remember_query_space':
+          result = await handleQuerySpace(args as any, userId);
+          break;
+
         default:
           throw new McpError(
             ErrorCode.MethodNotFound,