@spacelr/mcp 0.1.0 → 0.2.0

package/dist/index.mjs

@@ -3537,8 +3537,143 @@ function registerCronJobTools(server, api) {
   );
 }
 
-// libs/mcp-server/src/tools/webhooks.ts
+// libs/mcp-server/src/tools/schedules.ts
 import { z as z10 } from "zod";
+var STATUS_VALUES = ["scheduled", "fired", "failed", "cancelled"];
+function registerScheduleTools(server, api) {
+  server.registerTool(
+    "schedules_list",
+    {
+      description: "List one-shot scheduled function invocations for a project",
+      inputSchema: {
+        projectId: z10.string(),
+        functionId: z10.string().optional(),
+        status: z10.enum(STATUS_VALUES).optional(),
+        limit: z10.number().int().min(1).max(200).optional(),
+        offset: z10.number().int().min(0).optional()
+      }
+    },
+    async ({ projectId, functionId, status, limit, offset }) => {
+      try {
+        const result = await api.get(
+          `/projects/${encodeURIComponent(projectId)}/schedules`,
+          { params: { functionId, status, limit, offset } }
+        );
+        return {
+          content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+        };
+      } catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+          content: [{ type: "text", text: `Failed to list schedules: ${message}` }],
+          isError: true
+        };
+      }
+    }
+  );
+  server.registerTool(
+    "schedules_get",
+    {
+      description: "Get a single scheduled invocation by ID",
+      inputSchema: {
+        projectId: z10.string(),
+        scheduleId: z10.string()
+      }
+    },
+    async ({ projectId, scheduleId }) => {
+      try {
+        const result = await api.get(
+          `/projects/${encodeURIComponent(projectId)}/schedules/${encodeURIComponent(scheduleId)}`
+        );
+        return {
+          content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+        };
+      } catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+          content: [{ type: "text", text: `Failed to get schedule: ${message}` }],
+          isError: true
+        };
+      }
+    }
+  );
+  server.registerTool(
+    "schedules_create",
+    {
+      description: "Schedule a one-shot function invocation. `executeAt` must be ISO-8601 within the configured max-delay window (default 90 days). Repeating with the same `idempotencyKey` returns the existing schedule.",
+      inputSchema: {
+        projectId: z10.string(),
+        functionId: z10.string().regex(/^[a-f0-9]{24}$/i),
+        executeAt: z10.string().describe("ISO-8601 timestamp"),
+        payload: z10.record(z10.string(), z10.unknown()).optional(),
+        idempotencyKey: z10.string().min(1).max(256).optional(),
+        maxAttempts: z10.number().int().min(0).max(10).optional()
+      }
+    },
+    async ({
+      projectId,
+      functionId,
+      executeAt,
+      payload,
+      idempotencyKey,
+      maxAttempts
+    }) => {
+      try {
+        const body = { functionId, executeAt };
+        if (payload !== void 0) body.payload = payload;
+        if (idempotencyKey !== void 0) body.idempotencyKey = idempotencyKey;
+        if (maxAttempts !== void 0) body.maxAttempts = maxAttempts;
+        const result = await api.post(
+          `/projects/${encodeURIComponent(projectId)}/schedules`,
+          { body }
+        );
+        return {
+          content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+        };
+      } catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+          content: [{ type: "text", text: `Failed to create schedule: ${message}` }],
+          isError: true
+        };
+      }
+    }
+  );
+  server.registerTool(
+    "schedules_cancel",
+    {
+      description: "Cancel a scheduled invocation. Idempotent \u2014 returns the existing record if already in a terminal state (fired/failed/cancelled).",
+      inputSchema: {
+        projectId: z10.string(),
+        scheduleId: z10.string()
+      }
+    },
+    async ({ projectId, scheduleId }) => {
+      try {
+        const result = await api.delete(
+          `/projects/${encodeURIComponent(projectId)}/schedules/${encodeURIComponent(scheduleId)}`
+        );
+        return {
+          content: [
+            {
+              type: "text",
+              text: result ? JSON.stringify(result, null, 2) : "Schedule cancelled"
+            }
+          ]
+        };
+      } catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+          content: [{ type: "text", text: `Failed to cancel schedule: ${message}` }],
+          isError: true
+        };
+      }
+    }
+  );
+}
+
+// libs/mcp-server/src/tools/webhooks.ts
+import { z as z11 } from "zod";
 var WEBHOOK_EVENT_TYPES = [
   "user.created",
   "user.updated",
@@ -3562,7 +3697,7 @@ function registerWebhookTools(server, api) {
     {
       description: "List all webhooks for a project",
       inputSchema: {
-        projectId: z10.string()
+        projectId: z11.string()
       }
     },
     async ({ projectId }) => {
@@ -3585,8 +3720,8 @@ function registerWebhookTools(server, api) {
     {
       description: "Get a single webhook by ID",
       inputSchema: {
-        projectId: z10.string(),
-        webhookId: z10.string()
+        projectId: z11.string(),
+        webhookId: z11.string()
       }
     },
     async ({ projectId, webhookId }) => {
@@ -3609,12 +3744,12 @@ function registerWebhookTools(server, api) {
     {
       description: "Create a new webhook for a project. WARNING: The response includes a secret that will be visible in the conversation context. Events include: user.created, user.updated, user.deleted, user.login, user.email_verified, user.password_reset_requested, user.password_reset, user.2fa_verified, database.insert, database.update, database.delete, storage.upload, storage.delete, project.created, project.updated.",
       inputSchema: {
-        projectId: z10.string(),
-        url: z10.string().url(),
-        events: z10.array(z10.enum(WEBHOOK_EVENT_TYPES)).min(1),
-        description: z10.string().optional(),
-        headers: z10.record(z10.string(), z10.string()).optional(),
-        active: z10.boolean().optional()
+        projectId: z11.string(),
+        url: z11.string().url(),
+        events: z11.array(z11.enum(WEBHOOK_EVENT_TYPES)).min(1),
+        description: z11.string().optional(),
+        headers: z11.record(z11.string(), z11.string()).optional(),
+        active: z11.boolean().optional()
       }
     },
     async ({ projectId, url, events, description, headers, active }) => {
@@ -3641,13 +3776,13 @@ function registerWebhookTools(server, api) {
     {
       description: "Update an existing webhook",
       inputSchema: {
-        projectId: z10.string(),
-        webhookId: z10.string(),
-        url: z10.string().url().optional(),
-        events: z10.array(z10.enum(WEBHOOK_EVENT_TYPES)).min(1).optional(),
-        description: z10.string().optional(),
-        headers: z10.record(z10.string(), z10.string()).optional(),
-        active: z10.boolean().optional()
+        projectId: z11.string(),
+        webhookId: z11.string(),
+        url: z11.string().url().optional(),
+        events: z11.array(z11.enum(WEBHOOK_EVENT_TYPES)).min(1).optional(),
+        description: z11.string().optional(),
+        headers: z11.record(z11.string(), z11.string()).optional(),
+        active: z11.boolean().optional()
       }
     },
     async ({ projectId, webhookId, url, events, description, headers, active }) => {
@@ -3682,8 +3817,8 @@ function registerWebhookTools(server, api) {
     {
       description: "Delete a webhook",
       inputSchema: {
-        projectId: z10.string(),
-        webhookId: z10.string()
+        projectId: z11.string(),
+        webhookId: z11.string()
       }
     },
     async ({ projectId, webhookId }) => {
@@ -3706,8 +3841,8 @@ function registerWebhookTools(server, api) {
     {
       description: "Send a test ping to a webhook",
       inputSchema: {
-        projectId: z10.string(),
-        webhookId: z10.string()
+        projectId: z11.string(),
+        webhookId: z11.string()
       }
     },
     async ({ projectId, webhookId }) => {
@@ -3730,10 +3865,10 @@ function registerWebhookTools(server, api) {
     {
       description: "List webhook delivery logs for a project",
       inputSchema: {
-        projectId: z10.string(),
-        webhookId: z10.string().optional(),
-        limit: z10.number().int().min(1).max(100).optional(),
-        offset: z10.number().int().min(0).optional()
+        projectId: z11.string(),
+        webhookId: z11.string().optional(),
+        limit: z11.number().int().min(1).max(100).optional(),
+        offset: z11.number().int().min(0).optional()
       }
     },
     async ({ projectId, webhookId, limit, offset }) => {
@@ -3756,8 +3891,8 @@ function registerWebhookTools(server, api) {
     {
       description: "Retry a failed webhook delivery",
       inputSchema: {
-        projectId: z10.string(),
-        deliveryId: z10.string()
+        projectId: z11.string(),
+        deliveryId: z11.string()
       }
     },
     async ({ projectId, deliveryId }) => {
@@ -3778,14 +3913,14 @@ function registerWebhookTools(server, api) {
 }
 
 // libs/mcp-server/src/tools/notifications.ts
-import { z as z11 } from "zod";
+import { z as z12 } from "zod";
 function registerNotificationTools(server, api) {
   server.registerTool(
     "notification_templates_list",
     {
       description: "List all notification templates for a project (includes system defaults)",
       inputSchema: {
-        projectId: z11.string()
+        projectId: z12.string()
       }
     },
     async ({ projectId }) => {
@@ -3808,7 +3943,7 @@ function registerNotificationTools(server, api) {
     {
       description: "Get a single notification template by ID",
       inputSchema: {
-        id: z11.string()
+        id: z12.string()
       }
     },
     async ({ id }) => {
@@ -3831,15 +3966,15 @@ function registerNotificationTools(server, api) {
     {
       description: "Create a new project-specific notification template. Variables use Handlebars syntax in titleTemplate and bodyTemplate.",
       inputSchema: {
-        projectId: z11.string(),
-        type: z11.string(),
-        name: z11.string(),
-        titleTemplate: z11.string(),
-        bodyTemplate: z11.string(),
-        icon: z11.string().optional(),
-        defaultUrl: z11.string().optional(),
-        variables: z11.array(z11.string()).optional(),
-        isActive: z11.boolean().optional()
+        projectId: z12.string(),
+        type: z12.string(),
+        name: z12.string(),
+        titleTemplate: z12.string(),
+        bodyTemplate: z12.string(),
+        icon: z12.string().optional(),
+        defaultUrl: z12.string().optional(),
+        variables: z12.array(z12.string()).optional(),
+        isActive: z12.boolean().optional()
       }
     },
     async ({ projectId, type, name, titleTemplate, bodyTemplate, icon, defaultUrl, variables, isActive }) => {
@@ -3867,14 +4002,14 @@ function registerNotificationTools(server, api) {
     {
       description: "Update an existing notification template",
       inputSchema: {
-        id: z11.string(),
-        name: z11.string().optional(),
-        titleTemplate: z11.string().optional(),
-        bodyTemplate: z11.string().optional(),
-        icon: z11.string().optional(),
-        defaultUrl: z11.string().optional(),
-        variables: z11.array(z11.string()).optional(),
-        isActive: z11.boolean().optional()
+        id: z12.string(),
+        name: z12.string().optional(),
+        titleTemplate: z12.string().optional(),
+        bodyTemplate: z12.string().optional(),
+        icon: z12.string().optional(),
+        defaultUrl: z12.string().optional(),
+        variables: z12.array(z12.string()).optional(),
+        isActive: z12.boolean().optional()
       }
     },
     async ({ id, name, titleTemplate, bodyTemplate, icon, defaultUrl, variables, isActive }) => {
@@ -3911,7 +4046,7 @@ function registerNotificationTools(server, api) {
     {
       description: "Delete a project notification template override (reverts to system default)",
       inputSchema: {
-        id: z11.string()
+        id: z12.string()
       }
     },
     async ({ id }) => {
@@ -3934,9 +4069,9 @@ function registerNotificationTools(server, api) {
     {
       description: "Preview a compiled notification template with Handlebars variables applied",
       inputSchema: {
-        titleTemplate: z11.string(),
-        bodyTemplate: z11.string(),
-        variables: z11.record(z11.string(), z11.string())
+        titleTemplate: z12.string(),
+        bodyTemplate: z12.string(),
+        variables: z12.record(z12.string(), z12.string())
       }
     },
     async ({ titleTemplate, bodyTemplate, variables }) => {
@@ -3959,7 +4094,7 @@ function registerNotificationTools(server, api) {
     {
       description: "Get push notification provider configuration for a project (VAPID, FCM, APNS). WARNING: Response may include sensitive credentials that will be visible in the conversation context.",
       inputSchema: {
-        projectId: z11.string()
+        projectId: z12.string()
       }
     },
     async ({ projectId }) => {
@@ -3982,24 +4117,24 @@ function registerNotificationTools(server, api) {
     {
       description: "Update push notification provider configuration. Supports VAPID, FCM, and APNS providers. WARNING: privateKey and serviceAccountJson values are sensitive credentials that will be visible in the conversation context.",
       inputSchema: {
-        projectId: z11.string(),
-        vapid: z11.object({
-          publicKey: z11.string().optional(),
-          privateKey: z11.string().optional(),
-          subject: z11.string().optional(),
-          enabled: z11.boolean().optional()
+        projectId: z12.string(),
+        vapid: z12.object({
+          publicKey: z12.string().optional(),
+          privateKey: z12.string().optional(),
+          subject: z12.string().optional(),
+          enabled: z12.boolean().optional()
         }).optional(),
-        fcm: z11.object({
-          serviceAccountJson: z11.string().optional(),
-          enabled: z11.boolean().optional()
+        fcm: z12.object({
+          serviceAccountJson: z12.string().optional(),
+          enabled: z12.boolean().optional()
         }).optional(),
-        apns: z11.object({
-          keyId: z11.string().optional(),
-          teamId: z11.string().optional(),
-          privateKey: z11.string().optional(),
-          bundleId: z11.string().optional(),
-          production: z11.boolean().optional(),
-          enabled: z11.boolean().optional()
+        apns: z12.object({
+          keyId: z12.string().optional(),
+          teamId: z12.string().optional(),
+          privateKey: z12.string().optional(),
+          bundleId: z12.string().optional(),
+          production: z12.boolean().optional(),
+          enabled: z12.boolean().optional()
         }).optional()
       }
     },
@@ -4033,8 +4168,8 @@ function registerNotificationTools(server, api) {
     {
       description: "Delete push notification provider configuration. Specify a provider to delete only that one, or omit to delete all.",
       inputSchema: {
-        projectId: z11.string(),
-        provider: z11.enum(["vapid", "fcm", "apns"]).optional()
+        projectId: z12.string(),
+        provider: z12.enum(["vapid", "fcm", "apns"]).optional()
       }
     },
     async ({ projectId, provider }) => {
@@ -4078,12 +4213,12 @@ function registerNotificationTools(server, api) {
     {
       description: "Send a push notification to selected users",
       inputSchema: {
-        projectId: z11.string(),
-        userIds: z11.array(z11.string()).min(1),
-        title: z11.string(),
-        body: z11.string(),
-        icon: z11.string().optional(),
-        url: z11.string().optional()
+        projectId: z12.string(),
+        userIds: z12.array(z12.string()).min(1),
+        title: z12.string(),
+        body: z12.string(),
+        icon: z12.string().optional(),
+        url: z12.string().optional()
       }
     },
     async ({ projectId, userIds, title, body: notifBody, icon, url }) => {
@@ -4109,11 +4244,11 @@ function registerNotificationTools(server, api) {
     {
       description: "Broadcast a push notification to all subscribed users in a project",
       inputSchema: {
-        projectId: z11.string(),
-        title: z11.string(),
-        body: z11.string(),
-        icon: z11.string().optional(),
-        url: z11.string().optional()
+        projectId: z12.string(),
+        title: z12.string(),
+        body: z12.string(),
+        icon: z12.string().optional(),
+        url: z12.string().optional()
       }
     },
     async ({ projectId, title, body: notifBody, icon, url }) => {
@@ -4137,20 +4272,20 @@ function registerNotificationTools(server, api) {
 }
 
 // libs/mcp-server/src/tools/auditLogs.ts
-import { z as z12 } from "zod";
+import { z as z13 } from "zod";
 function registerAuditLogTools(server, api) {
   server.registerTool(
     "audit_logs_list",
     {
       description: "List audit logs for a project. Filter by entity type, action, and date range.",
       inputSchema: {
-        projectId: z12.string(),
-        entityType: z12.enum(["user", "client", "project", "auth", "database", "storage"]).optional(),
-        action: z12.string().optional(),
-        startDate: z12.string().datetime().optional(),
-        endDate: z12.string().datetime().optional(),
-        limit: z12.number().int().min(1).max(100).optional(),
-        offset: z12.number().int().min(0).optional()
+        projectId: z13.string(),
+        entityType: z13.enum(["user", "client", "project", "auth", "database", "storage"]).optional(),
+        action: z13.string().optional(),
+        startDate: z13.string().datetime().optional(),
+        endDate: z13.string().datetime().optional(),
+        limit: z13.number().int().min(1).max(100).optional(),
+        offset: z13.number().int().min(0).optional()
       }
     },
     async ({ projectId, entityType, action, startDate, endDate, limit, offset }) => {
@@ -4175,8 +4310,8 @@ function registerAuditLogTools(server, api) {
     {
       description: "Get a single audit log entry by ID",
       inputSchema: {
-        projectId: z12.string(),
-        logId: z12.string()
+        projectId: z13.string(),
+        logId: z13.string()
       }
     },
     async ({ projectId, logId }) => {
@@ -4207,13 +4342,14 @@ function registerAllTools(server, api) {
   registerFunctionTools(server, api);
   registerEmailTemplateTools(server, api);
   registerCronJobTools(server, api);
+  registerScheduleTools(server, api);
   registerWebhookTools(server, api);
   registerNotificationTools(server, api);
   registerAuditLogTools(server, api);
 }
 
 // libs/mcp-server/src/prompts/database.ts
-import { z as z13 } from "zod";
+import { z as z14 } from "zod";
 function registerDatabasePrompts(server) {
   server.registerPrompt(
     "setup-collection",
@@ -4221,9 +4357,9 @@ function registerDatabasePrompts(server) {
       title: "Setup Database Collection",
       description: "Guide for creating a new database collection with proper security rules. Collections MUST have rules defined before data can be inserted.",
       argsSchema: {
-        projectId: z13.string().describe("Project ID"),
-        collectionName: z13.string().describe("Name of the collection to create"),
-        access: z13.enum(["public-read", "authenticated", "admin-only"]).optional().describe("Access level (default: admin-only)")
+        projectId: z14.string().describe("Project ID"),
+        collectionName: z14.string().describe("Name of the collection to create"),
+        access: z14.enum(["public-read", "authenticated", "admin-only"]).optional().describe("Access level (default: admin-only)")
       }
     },
     async ({ projectId, collectionName, access }) => {
@@ -4288,7 +4424,7 @@ function registerDatabasePrompts(server) {
       title: "Database Workflow Guide",
       description: "Explains how the Spacelr database system works: rules-first approach, collection lifecycle, and security model.",
       argsSchema: {
-        projectId: z13.string().describe("Project ID")
+        projectId: z14.string().describe("Project ID")
       }
     },
     async ({ projectId }) => {
@@ -4337,7 +4473,7 @@ function registerDatabasePrompts(server) {
 }
 
 // libs/mcp-server/src/prompts/functions.ts
-import { z as z14 } from "zod";
+import { z as z15 } from "zod";
 function registerFunctionPrompts(server) {
   server.registerPrompt(
     "deploy-function",
@@ -4345,9 +4481,9 @@ function registerFunctionPrompts(server) {
       title: "Deploy a Serverless Function",
       description: "Step-by-step guide for creating, deploying, and testing a serverless function. Covers the full lifecycle from creation to execution.",
       argsSchema: {
-        projectId: z14.string().describe("Project ID"),
-        name: z14.string().describe("Function name"),
-        useCase: z14.string().optional().describe('What the function should do (e.g. "fetch data from API and store in DB")')
+        projectId: z15.string().describe("Project ID"),
+        name: z15.string().describe("Function name"),
+        useCase: z15.string().optional().describe('What the function should do (e.g. "fetch data from API and store in DB")')
       }
     },
     async ({ projectId, name, useCase }) => {