@pairsystems/goodmem-mcp 0.1.8 → 0.1.10

package/dist/index.js

@@ -20988,7 +20988,7 @@ var StdioServerTransport = class {
 // dist/index.js
 var goodmemBaseUrl = process.env.GOODMEM_BASE_URL || "";
 var goodmemApiKey = process.env.GOODMEM_API_KEY || "";
-var BASED_ON_GOODMEM_COMMIT = "55768baed550c339bff8ef3893a8e9a024facc90";
+var BASED_ON_GOODMEM_COMMIT = "82cedec39260bff105828bed1c1e779d9f1e811f";
 function isConfigured() {
   return goodmemBaseUrl !== "" && goodmemApiKey !== "";
 }
@@ -21023,7 +21023,7 @@ async function callApi(method, path, body, query) {
   }
   return resp.text();
 }
-async function callApiNdjson(method, path, body, query) {
+async function callApiNdjson(method, path, body, query, timeoutSec) {
   if (!isConfigured()) {
     throw new Error("GoodMem is not configured. Call the goodmem_configure tool first with your base_url and api_key, or set GOODMEM_BASE_URL and GOODMEM_API_KEY environment variables.");
   }
@@ -21042,7 +21042,7 @@ async function callApiNdjson(method, path, body, query) {
   const resp = await fetch(url.toString(), {
     method,
     headers,
-    signal: AbortSignal.timeout(2e5),
+    signal: AbortSignal.timeout((timeoutSec ?? 200) * 1e3),
     ...body ? { body: JSON.stringify(body) } : {}
   });
   if (!resp.ok) {
@@ -21920,7 +21920,7 @@ function autoInferFromRegistry(registryType, args) {
 }
 var server = new McpServer({
   name: "goodmem",
-  version: "0.1.8"
+  version: "0.1.10"
 });
 server.tool("goodmem_configure", "Configure GoodMem server connection. Call this before using other GoodMem tools if GOODMEM_BASE_URL and GOODMEM_API_KEY environment variables are not set. Session credentials override environment variables.", {
   base_url: external_exports.string().describe("GoodMem server URL (e.g., https://your-server.example.com)"),
@@ -21944,7 +21944,12 @@ server.tool("goodmem_configure", "Configure GoodMem server connection. Call this
     const info = await resp.json();
     return { content: [{ type: "text", text: `Connected to GoodMem at ${goodmemBaseUrl}. Server version: ${info.version ?? "unknown"}.` }] };
   } catch (err) {
-    return { content: [{ type: "text", text: `Could not connect to ${args.base_url}: ${err}. Credentials were NOT saved. Check your base_url.` }] };
+    const msg = err instanceof Error ? err.message : String(err);
+    let hint = "Check your base_url.";
+    if (msg.includes("CERT") || msg.includes("certificate") || msg.includes("self-signed") || msg.includes("self signed") || msg.includes("UNABLE_TO_VERIFY")) {
+      hint = "TLS certificate error. If using self-signed certs, set NODE_TLS_REJECT_UNAUTHORIZED=0 (dev only) or NODE_EXTRA_CA_CERTS=/path/to/rootCA.pem in your MCP server env config.";
+    }
+    return { content: [{ type: "text", text: `Could not connect to ${args.base_url}: ${msg}. Credentials were NOT saved. ${hint}` }] };
   }
 });
 server.tool("goodmem_lookup_model", "Look up a model in the registry to see its provider, endpoint, dimensions, and other auto-inferred fields. Use this to check what models are available before creating an embedder, LLM, or reranker.", {
@@ -21970,7 +21975,7 @@ ${allModels.join("\n")}` }] };
 });
 server.tool("goodmem_client_info", "Return the MCP client package version and the goodmem server commit it was built against. No server connection required.", {}, async () => {
   return { content: [{ type: "text", text: JSON.stringify({
-    mcpVersion: "0.1.8",
+    mcpVersion: "0.1.10",
     basedOnGoodmemCommit: BASED_ON_GOODMEM_COMMIT
   }, null, 2) }] };
 });
@@ -22013,7 +22018,7 @@ function registerTools() {
     return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
   });
   server.tool("goodmem_apikeys_create", "Create a new API key", {
-    labels: external_exports.any().describe("Key-value pairs of metadata associated with the API key. Used for organization and filtering.").optional(),
+    labels: external_exports.record(external_exports.string(), external_exports.string()).describe("Key-value pairs of metadata associated with the API key. Used for organization and filtering.").optional(),
     expires_at: external_exports.number().int().describe("Expiration timestamp in milliseconds since epoch. If not provided, the key does not expire.").optional(),
     api_key_id: external_exports.string().describe("Optional client-provided UUID for idempotent creation. If not provided, server generates a new UUID. Returns ALREADY_EXISTS if ID is already in use.").optional()
   }, async (args) => {
@@ -22040,8 +22045,8 @@ function registerTools() {
   server.tool("goodmem_apikeys_update", "Update an API key", {
     id: external_exports.string().describe("The UUID of the API key to update"),
     status: external_exports.string().describe("New status for the API key. Allowed values: ACTIVE, INACTIVE.").optional(),
-    replace_labels: external_exports.any().describe("Replace all existing labels with this set. Mutually exclusive with mergeLabels.").optional(),
-    merge_labels: external_exports.any().describe("Merge these labels with existing ones. Mutually exclusive with replaceLabels.").optional()
+    replace_labels: external_exports.record(external_exports.string(), external_exports.string()).describe("Replace all existing labels with this set. Mutually exclusive with mergeLabels.").optional(),
+    merge_labels: external_exports.record(external_exports.string(), external_exports.string()).describe("Merge these labels with existing ones. Mutually exclusive with replaceLabels.").optional()
   }, async (args) => {
     const body = {};
     if (args.status !== void 0)
@@ -22081,7 +22086,7 @@ function registerTools() {
       }).passthrough().describe("Configuration when kind is CREDENTIAL_KIND_GCP_ADC").optional(),
       labels: external_exports.any().describe('Optional annotations to aid operators (e.g., "owner=vertex")').optional()
     }).passthrough().describe("Structured credential payload describing how to authenticate with the provider. Required for SaaS providers such as COHERE, JINA, and VOYAGE; optional for local or proxy providers.").optional(),
-    labels: external_exports.any().describe("User-defined labels for categorization").optional(),
+    labels: external_exports.record(external_exports.string(), external_exports.string()).describe("User-defined labels for categorization").optional(),
     version: external_exports.string().describe("Version information").optional(),
     monitoring_endpoint: external_exports.string().describe("Monitoring endpoint URL").optional(),
     owner_id: external_exports.string().describe("Optional owner ID. If not provided, derived from the authentication context. Requires CREATE_EMBEDDER_ANY permission if specified.").optional(),
@@ -22126,13 +22131,13 @@ function registerTools() {
     return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
   });
   server.tool("goodmem_embedders_delete", "Delete an embedder", {
-    id: external_exports.string().describe("The UUID of the embedder to delete")
+    id: external_exports.string().describe("The unique identifier of the embedder to delete")
   }, async (args) => {
     await callApi("DELETE", `/v1/embedders/${encodeURIComponent(String(args.id))}`, void 0);
     return { content: [{ type: "text", text: "Deleted successfully." }] };
   });
   server.tool("goodmem_embedders_get", "Get an embedder by ID", {
-    id: external_exports.string().describe("The UUID of the embedder to retrieve")
+    id: external_exports.string().describe("The unique identifier of the embedder to retrieve")
   }, async (args) => {
     const result = await callApi("GET", `/v1/embedders/${encodeURIComponent(String(args.id))}`, void 0);
     return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
@@ -22140,28 +22145,29 @@ function registerTools() {
   server.tool("goodmem_embedders_list", "List embedders", {
     owner_id: external_exports.string().describe("Filter embedders by owner ID. With LIST_EMBEDDER_ANY permission, omitting this shows all accessible embedders; providing it filters by that owner. With LIST_EMBEDDER_OWN permission, only your own embedders are shown regardless of this parameter.").optional(),
     provider_type: external_exports.enum(["OPENAI", "VLLM", "TEI", "LLAMA_CPP", "VOYAGE", "COHERE", "JINA"]).describe("Filter embedders by provider type. Allowed values match the ProviderType schema.").optional(),
-    labels: external_exports.record(external_exports.string(), external_exports.string()).describe("Filter by labels. Each key-value pair is sent as a label.<key>=<value> query parameter.").optional()
+    label: external_exports.record(external_exports.string(), external_exports.string()).describe("Filter by label. Each key-value pair is sent as label[key]=value query parameter.").optional()
   }, async (args) => {
     const query = {};
     if (args.owner_id !== void 0)
       query["ownerId"] = String(args.owner_id);
     if (args.provider_type !== void 0)
       query["providerType"] = String(args.provider_type);
-    if (args.labels) {
-      for (const [k, v] of Object.entries(args.labels))
-        query[`label.${k}`] = v;
+    if (args.label) {
+      for (const [k, v] of Object.entries(args.label))
+        query[`label[${k}]`] = v;
     }
     const result = await callApi("GET", `/v1/embedders`, void 0, query);
     return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
   });
   server.tool("goodmem_embedders_update", "Update an embedder", {
-    id: external_exports.string().describe("The UUID of the embedder to update"),
+    id: external_exports.string().describe("The unique identifier of the embedder to update"),
     display_name: external_exports.string().describe("User-facing name of the embedder").optional(),
     description: external_exports.string().describe("Description of the embedder").optional(),
     endpoint_url: external_exports.string().describe("API endpoint URL").optional(),
     api_path: external_exports.string().describe("API path for embeddings request").optional(),
     model_identifier: external_exports.string().describe("Model identifier").optional(),
     dimensionality: external_exports.number().int().describe("Output vector dimensions").optional(),
+    distribution_type: external_exports.enum(["DENSE", "SPARSE"]).describe("Type of embedding distribution (DENSE or SPARSE)").optional(),
     max_sequence_length: external_exports.number().int().describe("Maximum input sequence length").optional(),
     supported_modalities: external_exports.array(external_exports.enum(["TEXT", "IMAGE", "AUDIO", "VIDEO"])).describe("Supported content modalities").optional(),
     credentials: external_exports.object({
@@ -22181,8 +22187,8 @@ function registerTools() {
       }).passthrough().describe("Configuration when kind is CREDENTIAL_KIND_GCP_ADC").optional(),
       labels: external_exports.any().describe('Optional annotations to aid operators (e.g., "owner=vertex")').optional()
     }).passthrough().describe("Structured credential payload describing how to authenticate with the provider").optional(),
-    replace_labels: external_exports.any().describe("Replace all existing labels with these (mutually exclusive with mergeLabels)").optional(),
-    merge_labels: external_exports.any().describe("Merge these labels with existing ones (mutually exclusive with replaceLabels)").optional(),
+    replace_labels: external_exports.record(external_exports.string(), external_exports.string()).describe("Replace all existing labels with these (mutually exclusive with mergeLabels)").optional(),
+    merge_labels: external_exports.record(external_exports.string(), external_exports.string()).describe("Merge these labels with existing ones (mutually exclusive with replaceLabels)").optional(),
     version: external_exports.string().describe("Version information").optional(),
     monitoring_endpoint: external_exports.string().describe("Monitoring endpoint URL").optional()
   }, async (args) => {
@@ -22199,6 +22205,8 @@ function registerTools() {
       body["modelIdentifier"] = args.model_identifier;
     if (args.dimensionality !== void 0)
       body["dimensionality"] = args.dimensionality;
+    if (args.distribution_type !== void 0)
+      body["distributionType"] = args.distribution_type;
     if (args.max_sequence_length !== void 0)
       body["maxSequenceLength"] = args.max_sequence_length;
     if (args.supported_modalities !== void 0)
@@ -22241,7 +22249,7 @@ function registerTools() {
       }).passthrough().describe("Configuration when kind is CREDENTIAL_KIND_GCP_ADC").optional(),
       labels: external_exports.any().describe('Optional annotations to aid operators (e.g., "owner=vertex")').optional()
     }).passthrough().describe("Structured credential payload describing how to authenticate with the provider. Omit for deployments that do not require credentials.").optional(),
-    labels: external_exports.any().describe("User-defined labels for categorization").optional(),
+    labels: external_exports.record(external_exports.string(), external_exports.string()).describe("User-defined labels for categorization").optional(),
     version: external_exports.string().describe("Version information").optional(),
     monitoring_endpoint: external_exports.string().describe("Monitoring endpoint URL").optional(),
     capabilities: external_exports.object({
@@ -22307,13 +22315,13 @@ function registerTools() {
     return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
   });
   server.tool("goodmem_llms_delete", "Delete an LLM", {
-    id: external_exports.string().describe("The UUID of the LLM to delete")
+    id: external_exports.string().describe("The unique identifier of the LLM to delete")
   }, async (args) => {
     await callApi("DELETE", `/v1/llms/${encodeURIComponent(String(args.id))}`, void 0);
     return { content: [{ type: "text", text: "Deleted successfully." }] };
   });
   server.tool("goodmem_llms_get", "Get an LLM by ID", {
-    id: external_exports.string().describe("The UUID of the LLM to retrieve")
+    id: external_exports.string().describe("The unique identifier of the LLM to retrieve")
   }, async (args) => {
     const result = await callApi("GET", `/v1/llms/${encodeURIComponent(String(args.id))}`, void 0);
     return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
@@ -22321,22 +22329,22 @@ function registerTools() {
   server.tool("goodmem_llms_list", "List LLMs", {
     owner_id: external_exports.string().describe("Filter LLMs by owner ID. With LIST_LLM_ANY permission, omitting this shows all accessible LLMs; providing it filters by that owner. With LIST_LLM_OWN permission, only your own LLMs are shown regardless of this parameter.").optional(),
     provider_type: external_exports.enum(["OPENAI", "LITELLM_PROXY", "OPEN_ROUTER", "VLLM", "OLLAMA", "LLAMA_CPP", "CUSTOM_OPENAI_COMPATIBLE"]).describe("Filter LLMs by provider type. Allowed values match the LLMProviderType schema.").optional(),
-    labels: external_exports.record(external_exports.string(), external_exports.string()).describe("Filter by labels. Each key-value pair is sent as a label.<key>=<value> query parameter.").optional()
+    label: external_exports.record(external_exports.string(), external_exports.string()).describe("Filter by label. Each key-value pair is sent as label[key]=value query parameter.").optional()
   }, async (args) => {
     const query = {};
     if (args.owner_id !== void 0)
       query["ownerId"] = String(args.owner_id);
     if (args.provider_type !== void 0)
       query["providerType"] = String(args.provider_type);
-    if (args.labels) {
-      for (const [k, v] of Object.entries(args.labels))
-        query[`label.${k}`] = v;
+    if (args.label) {
+      for (const [k, v] of Object.entries(args.label))
+        query[`label[${k}]`] = v;
     }
     const result = await callApi("GET", `/v1/llms`, void 0, query);
     return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
   });
   server.tool("goodmem_llms_update", "Update an LLM", {
-    id: external_exports.string().describe("The UUID of the LLM to update"),
+    id: external_exports.string().describe("The unique identifier of the LLM to update"),
     display_name: external_exports.string().describe("Update display name").optional(),
     description: external_exports.string().describe("Update description").optional(),
     endpoint_url: external_exports.string().describe("Update endpoint base URL (OpenAI-compatible base, typically ends with /v1)").optional(),
@@ -22381,8 +22389,8 @@ function registerTools() {
     }).passthrough().describe("Update default sampling parameters").optional(),
     max_context_length: external_exports.number().int().describe("Update maximum context window size in tokens").optional(),
     client_config: external_exports.any().describe("Update provider-specific client configuration (replaces entire config; no merging)").optional(),
-    replace_labels: external_exports.any().describe("Replace all existing labels with this set. Empty map clears all labels. Cannot be used with mergeLabels.").optional(),
-    merge_labels: external_exports.any().describe("Merge with existing labels: upserts with overwrite. Labels not mentioned are preserved. Cannot be used with replaceLabels.").optional()
+    replace_labels: external_exports.record(external_exports.string(), external_exports.string()).describe("Replace all existing labels with this set. Empty map clears all labels. Cannot be used with mergeLabels.").optional(),
+    merge_labels: external_exports.record(external_exports.string(), external_exports.string()).describe("Merge with existing labels: upserts with overwrite. Labels not mentioned are preserved. Cannot be used with replaceLabels.").optional()
   }, async (args) => {
     const body = {};
     if (args.display_name !== void 0)
@@ -22419,7 +22427,34 @@ function registerTools() {
     return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
   });
   server.tool("goodmem_memories_batch_create", "Create multiple memories in a batch", {
-    requests: external_exports.array(external_exports.record(external_exports.string(), external_exports.unknown()).describe("JsonMemoryCreationRequest object")).describe("Array of memory creation requests.")
+    requests: external_exports.array(external_exports.object({
+      memoryId: external_exports.string().describe("Optional client-provided UUID for the memory. If omitted, the server generates one. Returns ALREADY_EXISTS if the ID is already in use.").optional(),
+      spaceId: external_exports.string().describe("ID of the space where this memory will be stored"),
+      originalContent: external_exports.string().describe("Original content as plain text (use either this or originalContentB64)").optional(),
+      originalContentB64: external_exports.string().describe("Original content as base64-encoded binary data (use either this or originalContent)").optional(),
+      originalContentRef: external_exports.string().describe("Reference to external content location").optional(),
+      contentType: external_exports.string().describe("MIME type of the content"),
+      metadata: external_exports.any().describe("Additional metadata for the memory").optional(),
+      chunkingConfig: external_exports.object({
+        none: external_exports.any().describe("No chunking strategy - preserve original content as single unit").optional(),
+        recursive: external_exports.object({
+          chunkSize: external_exports.number().int().describe("Maximum size of a chunk (should be \u2264 context window)"),
+          chunkOverlap: external_exports.number().int().describe("Sliding overlap between chunks"),
+          separators: external_exports.any().describe("Hierarchical separator list (order = preference)").optional(),
+          keepStrategy: external_exports.enum(["KEEP_NONE", "KEEP_START", "KEEP_END"]).describe("How to handle separators after splitting. KEEP_NONE is deprecated and behaves as KEEP_END."),
+          separatorIsRegex: external_exports.boolean().describe("Whether separators are regex patterns").optional(),
+          lengthMeasurement: external_exports.enum(["CHARACTER_COUNT", "TOKEN_COUNT", "CUSTOM"]).describe("How to measure chunk length")
+        }).passthrough().describe("Recursive hierarchical chunking strategy with configurable separators").optional(),
+        sentence: external_exports.object({
+          maxChunkSize: external_exports.number().int().describe("Maximum size of a chunk"),
+          minChunkSize: external_exports.number().int().describe("Minimum size before creating a new chunk"),
+          enableLanguageDetection: external_exports.boolean().describe("Whether to detect language for better segmentation").optional(),
+          lengthMeasurement: external_exports.enum(["CHARACTER_COUNT", "TOKEN_COUNT", "CUSTOM"]).describe("How to measure chunk length")
+        }).passthrough().describe("Sentence-based chunking strategy with language detection").optional()
+      }).passthrough().describe("Chunking strategy for this memory (if not provided, uses space default)").optional(),
+      extractPageImages: external_exports.boolean().describe("Optional hint to extract page images for eligible document types (for example, PDFs)").optional(),
+      fileField: external_exports.string().describe("Optional multipart file field name to bind binary content; required when multiple files are uploaded in a batch multipart request.").optional()
+    }).passthrough()).describe("Array of memory creation requests.")
   }, async (args) => {
     const body = {};
     if (args.requests !== void 0)
@@ -22464,7 +22499,7 @@ function registerTools() {
     original_content: external_exports.string().describe("Original content as plain text (use either this or originalContentB64)").optional(),
     original_content_b64: external_exports.string().describe("Original content as base64-encoded binary data (use either this or originalContent)").optional(),
     original_content_ref: external_exports.string().describe("Reference to external content location").optional(),
-    content_type: external_exports.string().describe("MIME type of the content"),
+    content_type: external_exports.string().describe("MIME type of the content (defaults to text/plain when original_content is provided)").optional(),
     metadata: external_exports.any().describe("Additional metadata for the memory").optional(),
     chunking_config: external_exports.object({
       none: external_exports.any().describe("No chunking strategy - preserve original content as single unit").optional(),
@@ -22504,6 +22539,9 @@ function registerTools() {
       body["chunkingConfig"] = args.chunking_config;
     if (args.extract_page_images !== void 0)
       body["extractPageImages"] = args.extract_page_images;
+    if (body["contentType"] === void 0 && body["originalContent"] !== void 0) {
+      body["contentType"] = "text/plain";
+    }
     const result = await callApi("POST", `/v1/memories`, body);
     return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
   });
@@ -22515,8 +22553,8 @@ function registerTools() {
   });
   server.tool("goodmem_memories_get", "Get a memory by ID", {
     id: external_exports.string().describe("The UUID of the memory to retrieve"),
-    include_content: external_exports.boolean().describe("Whether to include the original content in the response (defaults to false). The snake_case alias include_content is also accepted.").optional(),
-    include_processing_history: external_exports.boolean().describe("Whether to include background job processing history in the response (defaults to false). The snake_case alias include_processing_history is also accepted.").optional()
+    include_content: external_exports.boolean().describe("Whether to include the original content in the response (defaults to false).").optional(),
+    include_processing_history: external_exports.boolean().describe("Whether to include background job processing history in the response (defaults to false).").optional()
   }, async (args) => {
     const query = {};
     if (args.include_content !== void 0)
@@ -22528,14 +22566,14 @@ function registerTools() {
   });
   server.tool("goodmem_memories_list", "List memories in a space", {
     space_id: external_exports.string().describe("The UUID of the space containing the memories"),
-    include_content: external_exports.boolean().describe("Whether to include the original content in the response (defaults to false). The snake_case alias include_content is also accepted.").optional(),
-    include_processing_history: external_exports.boolean().describe("Whether to include background job processing history in the response (defaults to false). The snake_case alias include_processing_history is also accepted.").optional(),
-    status_filter: external_exports.string().describe("Filter memories by processing status (PENDING, PROCESSING, COMPLETED, FAILED). The snake_case alias status_filter is also accepted.").optional(),
+    include_content: external_exports.boolean().describe("Whether to include the original content in the response (defaults to false).").optional(),
+    include_processing_history: external_exports.boolean().describe("Whether to include background job processing history in the response (defaults to false).").optional(),
+    status_filter: external_exports.string().describe("Filter memories by processing status (PENDING, PROCESSING, COMPLETED, FAILED).").optional(),
     filter: external_exports.string().describe("Optional metadata filter expression for list results").optional(),
-    max_results: external_exports.number().int().describe("Maximum number of results per page (defaults to 50, clamped to [1, 500]). The snake_case alias max_results is also accepted.").optional(),
-    next_token: external_exports.string().describe("Opaque pagination token for the next page. URL-safe Base64 without padding; do not parse or construct it. The snake_case alias next_token is also accepted.").optional(),
-    sort_by: external_exports.string().describe("Field to sort by (e.g., 'created_at'). The snake_case alias sort_by is also accepted.").optional(),
-    sort_order: external_exports.enum(["ASCENDING", "DESCENDING", "SORT_ORDER_UNSPECIFIED"]).describe("Sort direction (ASCENDING or DESCENDING). The snake_case alias sort_order is also accepted.").optional()
+    max_results: external_exports.number().int().describe("Maximum number of results per page (defaults to 50, clamped to [1, 500]).").optional(),
+    next_token: external_exports.string().describe("Opaque pagination token for the next page. URL-safe Base64 without padding; do not parse or construct it.").optional(),
+    sort_by: external_exports.string().describe("Field to sort by (e.g., 'created_at').").optional(),
+    sort_order: external_exports.enum(["ASCENDING", "DESCENDING", "SORT_ORDER_UNSPECIFIED"]).describe("Sort direction (ASCENDING or DESCENDING).").optional()
   }, async (args) => {
     const query = {};
     if (args.include_content !== void 0)
@@ -22559,12 +22597,12 @@ function registerTools() {
   });
   server.tool("goodmem_memories_pages", "List memory page images", {
     id: external_exports.string().describe("Memory UUID"),
-    start_page_index: external_exports.number().int().describe("Optional lower bound for returned page indices, inclusive. The snake_case alias start_page_index is also accepted.").optional(),
-    end_page_index: external_exports.number().int().describe("Optional upper bound for returned page indices, inclusive. The snake_case alias end_page_index is also accepted.").optional(),
+    start_page_index: external_exports.number().int().describe("Optional lower bound for returned page indices, inclusive.").optional(),
+    end_page_index: external_exports.number().int().describe("Optional upper bound for returned page indices, inclusive.").optional(),
     dpi: external_exports.number().int().describe("Optional rendition filter for page-image DPI.").optional(),
-    content_type: external_exports.string().describe("Optional rendition filter for page-image MIME type, such as image/png. The snake_case alias content_type is also accepted.").optional(),
-    max_results: external_exports.number().int().describe("Maximum number of results per page. The snake_case alias max_results is also accepted.").optional(),
-    next_token: external_exports.string().describe("Opaque pagination token for the next page. The snake_case alias next_token is also accepted. Do not parse or construct it.").optional()
+    content_type: external_exports.string().describe("Optional rendition filter for page-image MIME type, such as image/png.").optional(),
+    max_results: external_exports.number().int().describe("Maximum number of results per page.").optional(),
+    next_token: external_exports.string().describe("Opaque pagination token for the next page. Do not parse or construct it.").optional()
   }, async (args) => {
     const query = {};
     if (args.start_page_index !== void 0)
@@ -22608,7 +22646,8 @@ function registerTools() {
     post_processor: external_exports.object({
       name: external_exports.string().describe("Fully qualified factory class name of the post-processor to apply."),
       config: external_exports.any().describe("Configuration parameters for the post-processor. Fields depend on the selected processor; see the linked documentation for the built-in ChatPostProcessor schema.").optional()
-    }).passthrough().describe("Optional post-processor configuration to transform retrieval results.").optional()
+    }).passthrough().describe("Optional post-processor configuration to transform retrieval results.").optional(),
+    timeout_sec: external_exports.number().int().describe("Maximum seconds to wait for the streaming response (default: 200).").optional()
   }, async (args) => {
     const body = {};
     if (args.message !== void 0)
@@ -22627,7 +22666,7 @@ function registerTools() {
       body["hnsw"] = args.hnsw;
     if (args.post_processor !== void 0)
       body["postProcessor"] = args.post_processor;
-    const result = await callApiNdjson("POST", `/v1/memories:retrieve`, body);
+    const result = await callApiNdjson("POST", `/v1/memories:retrieve`, body, void 0, args.timeout_sec);
     return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
   });
   server.tool("goodmem_ocr_document", "Run OCR on a document or image", {
@@ -22679,7 +22718,7 @@ function registerTools() {
       }).passthrough().describe("Configuration when kind is CREDENTIAL_KIND_GCP_ADC").optional(),
       labels: external_exports.any().describe('Optional annotations to aid operators (e.g., "owner=vertex")').optional()
     }).passthrough().describe("Structured credential payload describing how to authenticate with the provider. Required for SaaS providers; optional for local deployments.").optional(),
-    labels: external_exports.any().describe("User-defined labels for categorization").optional(),
+    labels: external_exports.record(external_exports.string(), external_exports.string()).describe("User-defined labels for categorization").optional(),
     version: external_exports.string().describe("Version information").optional(),
     monitoring_endpoint: external_exports.string().describe("Monitoring endpoint URL").optional(),
     owner_id: external_exports.string().describe("Optional owner ID. If not provided, derived from the authentication context. Requires CREATE_RERANKER_ANY permission if specified.").optional(),
@@ -22718,13 +22757,13 @@ function registerTools() {
     return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
   });
   server.tool("goodmem_rerankers_delete", "Delete a reranker", {
-    id: external_exports.string().describe("The UUID of the reranker to delete")
+    id: external_exports.string().describe("The unique identifier of the reranker to delete")
   }, async (args) => {
     await callApi("DELETE", `/v1/rerankers/${encodeURIComponent(String(args.id))}`, void 0);
     return { content: [{ type: "text", text: "Deleted successfully." }] };
   });
   server.tool("goodmem_rerankers_get", "Get a reranker by ID", {
-    id: external_exports.string().describe("The UUID of the reranker to retrieve")
+    id: external_exports.string().describe("The unique identifier of the reranker to retrieve")
   }, async (args) => {
     const result = await callApi("GET", `/v1/rerankers/${encodeURIComponent(String(args.id))}`, void 0);
     return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
@@ -22732,22 +22771,22 @@ function registerTools() {
   server.tool("goodmem_rerankers_list", "List rerankers", {
     owner_id: external_exports.string().describe("Filter rerankers by owner ID. With LIST_RERANKER_ANY permission, omitting this shows all accessible rerankers; providing it filters by that owner. With LIST_RERANKER_OWN permission, only your own rerankers are shown regardless of this parameter (PERMISSION_DENIED if set to another user).").optional(),
     provider_type: external_exports.enum(["OPENAI", "VLLM", "TEI", "LLAMA_CPP", "VOYAGE", "COHERE", "JINA"]).describe("Filter rerankers by provider type. Allowed values match the ProviderType schema.").optional(),
-    labels: external_exports.record(external_exports.string(), external_exports.string()).describe("Filter by labels. Each key-value pair is sent as a label.<key>=<value> query parameter.").optional()
+    label: external_exports.record(external_exports.string(), external_exports.string()).describe("Filter by label. Each key-value pair is sent as label[key]=value query parameter.").optional()
   }, async (args) => {
     const query = {};
     if (args.owner_id !== void 0)
       query["ownerId"] = String(args.owner_id);
     if (args.provider_type !== void 0)
       query["providerType"] = String(args.provider_type);
-    if (args.labels) {
-      for (const [k, v] of Object.entries(args.labels))
-        query[`label.${k}`] = v;
+    if (args.label) {
+      for (const [k, v] of Object.entries(args.label))
+        query[`label[${k}]`] = v;
     }
     const result = await callApi("GET", `/v1/rerankers`, void 0, query);
     return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
   });
   server.tool("goodmem_rerankers_update", "Update a reranker", {
-    id: external_exports.string().describe("The UUID of the reranker to update"),
+    id: external_exports.string().describe("The unique identifier of the reranker to update"),
     display_name: external_exports.string().describe("User-facing name of the reranker").optional(),
     description: external_exports.string().describe("Description of the reranker").optional(),
     endpoint_url: external_exports.string().describe("API endpoint URL").optional(),
@@ -22771,8 +22810,8 @@ function registerTools() {
       }).passthrough().describe("Configuration when kind is CREDENTIAL_KIND_GCP_ADC").optional(),
       labels: external_exports.any().describe('Optional annotations to aid operators (e.g., "owner=vertex")').optional()
     }).passthrough().describe("Structured credential payload describing how to authenticate with the provider. Omit to keep existing credentials.").optional(),
-    replace_labels: external_exports.any().describe("Replace all existing labels with these (mutually exclusive with mergeLabels)").optional(),
-    merge_labels: external_exports.any().describe("Merge these labels with existing ones (mutually exclusive with replaceLabels)").optional(),
+    replace_labels: external_exports.record(external_exports.string(), external_exports.string()).describe("Replace all existing labels with these (mutually exclusive with mergeLabels)").optional(),
+    merge_labels: external_exports.record(external_exports.string(), external_exports.string()).describe("Merge these labels with existing ones (mutually exclusive with replaceLabels)").optional(),
     version: external_exports.string().describe("Version information").optional(),
     monitoring_endpoint: external_exports.string().describe("Monitoring endpoint URL").optional()
   }, async (args) => {
@@ -22804,7 +22843,7 @@ function registerTools() {
   });
   server.tool("goodmem_spaces_create", "Create a new Space", {
     name: external_exports.string().describe("The desired name for the space. Must be unique within the user's scope."),
-    labels: external_exports.any().describe("A set of key-value pairs to categorize or tag the space. Used for filtering and organizational purposes.").optional(),
+    labels: external_exports.record(external_exports.string(), external_exports.string()).describe("A set of key-value pairs to categorize or tag the space. Used for filtering and organizational purposes.").optional(),
     space_embedders: external_exports.array(external_exports.object({
       embedderId: external_exports.string().describe("The UUID for the embedder to associate with the space."),
       defaultRetrievalWeight: external_exports.number().describe("Relative weight for this embedder used by default during retrieval. If omitted, defaults to 1.0; values need not sum to 1 and can be overridden per request.").optional()
@@ -22849,13 +22888,13 @@ function registerTools() {
     return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
   });
   server.tool("goodmem_spaces_delete", "Delete a space", {
-    id: external_exports.string().describe("The UUID of the space to delete")
+    id: external_exports.string().describe("The unique identifier of the space to delete")
   }, async (args) => {
     await callApi("DELETE", `/v1/spaces/${encodeURIComponent(String(args.id))}`, void 0);
     return { content: [{ type: "text", text: "Deleted successfully." }] };
   });
   server.tool("goodmem_spaces_get", "Get a space by ID", {
-    id: external_exports.string().describe("The UUID of the space to retrieve")
+    id: external_exports.string().describe("The unique identifier of the space to retrieve")
   }, async (args) => {
     const result = await callApi("GET", `/v1/spaces/${encodeURIComponent(String(args.id))}`, void 0);
     return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
@@ -22867,7 +22906,7 @@ function registerTools() {
     next_token: external_exports.string().describe("Pagination token for retrieving the next set of results").optional(),
     sort_by: external_exports.string().describe("Field to sort by: 'created_time', 'updated_time', or 'name' (default: 'created_time'). Unsupported values return INVALID_ARGUMENT.").optional(),
     sort_order: external_exports.enum(["ASCENDING", "DESCENDING", "SORT_ORDER_UNSPECIFIED"]).describe("Sort order (ASCENDING or DESCENDING, default: DESCENDING)").optional(),
-    labels: external_exports.record(external_exports.string(), external_exports.string()).describe("Filter by labels. Each key-value pair is sent as a label.<key>=<value> query parameter.").optional()
+    label: external_exports.record(external_exports.string(), external_exports.string()).describe("Filter by label. Each key-value pair is sent as label[key]=value query parameter.").optional()
   }, async (args) => {
     const query = {};
     if (args.owner_id !== void 0)
@@ -22882,19 +22921,19 @@ function registerTools() {
       query["sortBy"] = String(args.sort_by);
     if (args.sort_order !== void 0)
       query["sortOrder"] = String(args.sort_order);
-    if (args.labels) {
-      for (const [k, v] of Object.entries(args.labels))
-        query[`label.${k}`] = v;
+    if (args.label) {
+      for (const [k, v] of Object.entries(args.label))
+        query[`label[${k}]`] = v;
     }
     const result = await callApi("GET", `/v1/spaces`, void 0, query);
     return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
   });
   server.tool("goodmem_spaces_update", "Update a space", {
-    id: external_exports.string().describe("The UUID of the space to update"),
+    id: external_exports.string().describe("The unique identifier of the space to update"),
     name: external_exports.string().describe("The new name for the space.").optional(),
     public_read: external_exports.boolean().describe("Whether the space is publicly readable by all users.").optional(),
-    replace_labels: external_exports.any().describe("Labels to replace all existing labels. Mutually exclusive with mergeLabels.").optional(),
-    merge_labels: external_exports.any().describe("Labels to merge with existing labels. Mutually exclusive with replaceLabels.").optional()
+    replace_labels: external_exports.record(external_exports.string(), external_exports.string()).describe("Labels to replace all existing labels. Mutually exclusive with mergeLabels.").optional(),
+    merge_labels: external_exports.record(external_exports.string(), external_exports.string()).describe("Labels to merge with existing labels. Mutually exclusive with replaceLabels.").optional()
   }, async (args) => {
     const body = {};
     if (args.name !== void 0)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pairsystems/goodmem-mcp",
-  "version": "0.1.8",
+  "version": "0.1.10",
   "description": "GoodMem MCP server \u2014 exposes GoodMem API as MCP tools",
   "type": "module",
   "main": "dist/index.js",