@spacelr/mcp 0.2.0 → 0.2.2

package/dist/index.mjs

@@ -1228,7 +1228,7 @@ function registerDatabaseTools(server, api) {
   server.registerTool(
     "database_collections_update_metadata",
     {
-      description: "Update a collection's realtime delivery mode, stream retention, write rate-limit override, or search filter requirements. `realtimeMode: 'stream'` switches the collection to Redis Streams for durable event replay (needed for chat, notifications, activity feeds). `realtimeMode: 'pubsub'` (default) is fire-and-forget, used for dashboards and list views. Exactly one of `streamRetention.maxLen` (approx. entry count) or `streamRetention.maxAgeMs` (retention age in ms) may be set. `writeThrottle` overrides the default per-collection write rate limit (10 writes / 10 s) \u2014 set `enabled: false` to disable entirely (e.g. audit logs), or override `limit` / `windowMs`. `searchConfig.requireFilter` declares top-level filter keys that callers MUST include in every `collection.search()` call to prevent unindexable full-scan regex queries \u2014 affects ALL callers immediately (no deprecation window). Response may include `warnings[]` if the project exceeds the 50-collection soft cap.",
+      description: "Update a collection's realtime delivery mode, stream retention, write rate-limit override, or search filter requirements. `realtimeMode: 'stream'` switches the collection to Redis Streams for durable event replay (needed for chat, notifications, activity feeds). `realtimeMode: 'pubsub'` (default) is fire-and-forget, used for dashboards and list views. Exactly one of `streamRetention.maxLen` (approx. entry count) or `streamRetention.maxAgeMs` (retention age in ms) may be set. `writeThrottle` overrides the default per-collection write rate limit (10 writes / 10 s) \u2014 set `enabled: false` to disable entirely (e.g. audit logs), or override `limit` / `windowMs`. `searchConfig.requireFilter` declares top-level filter keys that callers MUST include in every `collection.search()` call to prevent unindexable full-scan regex queries \u2014 affects ALL callers immediately (no deprecation window). `coldTier` enables/disables archival of aged documents to object storage: set `enabled: true` with `expireField`, `expireAfterMs`, `bucketWindow` (day|week|month) and `segmentSizeBytes`; set `enabled: false` to turn it off. Enabling also triggers index creation on the collection. Response may include `warnings[]` if the project exceeds the 50-collection soft cap.",
       inputSchema: {
         projectId: z4.string(),
         name: z4.string(),
@@ -1264,15 +1264,34 @@ function registerDatabaseTools(server, api) {
           // have no observable effect today and may take on different
           // semantics when enforcement ships. Add back once the feature
           // is live.
-        }).strict().optional()
+        }).strict().optional(),
+        coldTier: z4.object({
+          enabled: z4.boolean().describe("Turn cold-tier archival on or off for this collection"),
+          expireField: z4.string().optional().describe("Date/timestamp field that decides a document's age. Required when enabled."),
+          expireAfterMs: z4.number().int().min(1).optional().describe("Archive documents older than this many ms (by expireField). Required when enabled."),
+          partitionField: z4.string().nullable().optional().describe("Optional top-level field to partition segments by (e.g. tenant/room id). null = no partition."),
+          bucketWindow: z4.enum(["day", "week", "month"]).optional().describe("Time window each segment spans. Required when enabled."),
+          segmentSizeBytes: z4.number().int().min(1).optional().describe("Target uncompressed size of a segment before it is flushed. Required when enabled."),
+          maxDocsPerSegment: z4.number().int().min(1).optional().describe("Optional hard cap on documents per segment."),
+          archivePurgeGraceMs: z4.number().int().min(0).optional().describe(
+            "Delay in ms after archiving before the hot-tier copy is purged. 0 = purge at the next tick; omit for the backend default (1 day)."
+          ),
+          historyPolicy: z4.enum(["full_history", "from_join_time", "from_key_epoch"]).optional().describe("Optional read-history policy for partitioned access.")
+        }).refine(
+          (c) => c.enabled !== true || c.expireField !== void 0 && c.expireAfterMs !== void 0 && c.bucketWindow !== void 0 && c.segmentSizeBytes !== void 0,
+          {
+            message: "When enabled is true, expireField, expireAfterMs, bucketWindow and segmentSizeBytes are all required"
+          }
+        ).optional()
       }
     },
-    async ({ projectId, name, realtimeMode, streamRetention, writeThrottle, searchConfig }) => {
+    async ({ projectId, name, realtimeMode, streamRetention, writeThrottle, searchConfig, coldTier }) => {
       try {
         const body = {};
         if (realtimeMode !== void 0) body.realtimeMode = realtimeMode;
         if (streamRetention !== void 0) body.streamRetention = streamRetention;
         if (writeThrottle !== void 0) body.writeThrottle = writeThrottle;
+        if (coldTier !== void 0) body.coldTier = coldTier;
         if (searchConfig !== void 0) {
           const normalized = {};
           if (searchConfig.requireFilter !== void 0) {
@@ -1285,7 +1304,7 @@ function registerDatabaseTools(server, api) {
             content: [
               {
                 type: "text",
-                text: "At least one of realtimeMode, streamRetention, writeThrottle, or searchConfig must be provided"
+                text: "At least one of realtimeMode, streamRetention, writeThrottle, searchConfig, or coldTier must be provided"
               }
             ],
             isError: true