@groundfloorcloud/mcp 0.1.5 → 0.1.6

package/README.md

@@ -69,7 +69,9 @@ The `command` must be your Node (from `which node`), not `npx` and not Cursor’
 |------|------|
 | `whoami` / `workspace_context` | Session + live workspace snapshot |
 | `workspaces_list` | List; switch with `gf workspaces use` |
-| `coderunner_list` / `_get_status` / `_get_logs` | Inspect workloads |
+| `coderunner_list` / `_get_status` / `_get_logs` / `_process_log` | Inspect workloads (Process Log does not need a job_id) |
+| `environments_list` | List workspace environments |
+| `coderunner_cancel_deployment` | Delete current (or given) deployment |
 | `apps_list` / `apps_get` | Inspect product Apps |
 | `secrets_list` / `files_list` / `domains_list` / `dataplane_status` | Inspect (no secrets values) |
 | `docs_list` / `docs_get` | Product docs (`coderunner`, `coderunner-runtime`, and `shell` are embedded how-tos) |

package/dist/index.js

@@ -191,6 +191,16 @@ async function cpGet(apiUrl, path2) {
   }
   return await res.json();
 }
+async function cpDelete(apiUrl, path2) {
+  const token = await getValidAccessToken();
+  const res = await fetch(`${apiUrl}${path2}`, {
+    method: "DELETE",
+    headers: { Authorization: `Bearer ${token}`, Accept: "application/json" }
+  });
+  if (!res.ok) {
+    throw new CpError(res.status, await parseError(res));
+  }
+}
 function queryString(params) {
   const u = new URLSearchParams();
   for (const [key, value] of Object.entries(params)) {
@@ -229,6 +239,22 @@ async function getDeployment(apiUrl, workspaceId, coderunnerId) {
   }
   return await res.json();
 }
+function deleteCoderunnerDeployment(apiUrl, workspaceId, coderunnerId, deploymentId) {
+  return cpDelete(
+    apiUrl,
+    `/v1/workspaces/${encodeURIComponent(
+      workspaceId
+    )}/coderunners/${encodeURIComponent(
+      coderunnerId
+    )}/deployments/${encodeURIComponent(deploymentId)}`
+  );
+}
+function listWorkspaceEnvironments(apiUrl, workspaceId) {
+  return cpGet(
+    apiUrl,
+    `/v1/workspaces/${encodeURIComponent(workspaceId)}/environments`
+  );
+}
 function getCoderunnerStatus(apiUrl, workspaceId, coderunnerId) {
   return cpGet(
     apiUrl,
@@ -247,6 +273,18 @@ function getCoderunnerLogs(apiUrl, workspaceId, coderunnerId, jobId) {
     )}/logs/${encodeURIComponent(jobId)}`
   );
 }
+function getProcessLogs(apiUrl, workspaceId, query = {}) {
+  const params = new URLSearchParams();
+  for (const [key, value] of Object.entries(query)) {
+    if (value == null || value === "") continue;
+    params.set(key, String(value));
+  }
+  const qs = params.toString();
+  return cpGet(
+    apiUrl,
+    `/v1/workspaces/${encodeURIComponent(workspaceId)}/logs${qs ? `?${qs}` : ""}`
+  );
+}
 function domainsBase(workspaceId, coderunnerId) {
   return `/v1/workspaces/${encodeURIComponent(
     workspaceId
@@ -429,7 +467,9 @@ Bind \`0.0.0.0\` and \`PORT\` (default 8080), for example
 ## Jobs and schedules
 
 Same package/start rules. The process may exit 0 when finished; it does not
-need a public URL. Schedules have **no** Deployment URL.
+need a public URL. Schedules have **no** Deployment URL. Set cron with
+\`gf deploy --workload-type schedule --schedule "<cron>"\` or
+\`groundfloor.json\` \`"schedule"\`.
 
 ## What \`gf deploy\` checks
 
@@ -506,8 +546,9 @@ Pick **one** type per coderunner. Changing type later means a new coderunner.
 
 ### Schedule
 
-- Same as job, plus a cron expression at create/deploy (\`schedule\` /
-  \`CronExpression\`).
+- Same as job, plus a cron expression at deploy:
+  \`gf deploy --workload-type schedule --schedule "<cron>"\`
+  (or \`groundfloor.json\` \`"schedule"\`).
 - No public invoke URL. Debug with Process Log, not curl.
 
 ### Service (Deployment)
@@ -545,7 +586,7 @@ CMD ["npm", "start"]
   \`gf secrets\` / deploy \`-e\`, never in the archive.
 - Zip **contents** at root, not a wrapping folder.
 - Optional \`groundfloor.json\`: \`name\`, \`runtime\`, \`workloadType\`,
-  \`cpu\`, \`memory\`, \`env\`.
+  \`cpu\`, \`memory\`, \`env\`, \`schedule\` (cron, schedule workloads only).
 
 ## Local development with live workspace data
 
@@ -747,7 +788,7 @@ function suggestCli(intent, args) {
     case "deploy":
       return {
         command: name ? `gf deploy -n ${name}${ws}` : `gf deploy${ws}`,
-        why: "Package the current (or --path) folder and deploy as a Coderunner. Workspace Authentication (groundfloor/external) must already be active. workloadType function|job|schedule|service (service = Deployment; requires a Dockerfile). Node bootstrap: scripts.start, listen PORT||8080, bind 0.0.0.0. Do not create an App for this.",
+        why: 'Package the current (or --path) folder and deploy as a Coderunner. Workspace Authentication (groundfloor/external) must already be active. workloadType function|job|schedule|service (service = Deployment; requires a Dockerfile). Schedules need --schedule "<cron>" or groundfloor.json schedule. Node bootstrap: scripts.start, listen PORT||8080, bind 0.0.0.0. Do not create an App for this.',
         docs: "https://docs.groundfloor.cloud/docs/customer-portal/coderunner"
       };
     case "run":
@@ -782,6 +823,18 @@ function suggestCli(intent, args) {
         why: "Ship a Shell federated App. Always init the kit first. npm run release (not zip dist/, not a lone remoteEntry.js). Do not gf deploy. Do not invent App.tsx.",
         docs: "https://docs.groundfloor.cloud/docs/integrations/shell"
       };
+    case "environments":
+      return {
+        command: `gf environments ls${ws}`,
+        why: "List workspace environments (id, name, status) for secrets and deploy targeting.",
+        docs: "https://docs.groundfloor.cloud/docs/customer-portal/developers"
+      };
+    case "cancel_deployment":
+      return {
+        command: name ? `gf coderunner cancel-deployment -c ${name}${ws}` : `gf coderunner cancel-deployment -c <id-or-slug>${ws}`,
+        why: "Delete the current deployment (or --deployment-id). Use this for a deploy stuck in deploying.",
+        docs: "https://docs.groundfloor.cloud/docs/customer-portal/coderunner"
+      };
     case "secrets":
       return {
         command: `gf secrets ls${ws}`,
@@ -797,7 +850,7 @@ function suggestCli(intent, args) {
     default:
       return {
         command: "gf --help",
-        why: `Unknown intent "${intent}". Use login | switch_workspace | deploy | run | status | init_app | publish_app | secrets | dataplane.`,
+        why: `Unknown intent "${intent}". Use login | switch_workspace | deploy | run | status | logs | environments | cancel_deployment | init_app | publish_app | secrets | dataplane.`,
         docs: "https://docs.groundfloor.cloud/docs/customer-portal/developers"
       };
   }
@@ -841,7 +894,7 @@ async function resolveCoderunnerId(apiUrl, workspaceId, idOrSlug) {
 }
 var server = new McpServer({
   name: "groundfloor",
-  version: "0.1.5"
+  version: "0.1.6"
 });
 server.tool(
   "whoami",
@@ -906,7 +959,7 @@ server.tool(
           types: {
             function: "HTTP handler on PORT/8080 bound to 0.0.0.0. Invoke with gf coderunner run or the Deployment URL. Node requires package.json scripts.start.",
             job: "Run-to-completion worker. Deploy, then gf coderunner run.",
-            schedule: "Cron job. No public Deployment URL. Set schedule/cron at create or deploy.",
+            schedule: 'Cron job. No public Deployment URL. Set cron with gf deploy --workload-type schedule --schedule "<cron>" (or groundfloor.json schedule).',
             service: "Long-running Deployment (same type as service). Dockerfile at ZIP root is required. Listen on 8080 / 0.0.0.0."
           },
           node: "No Dockerfile \u2192 platform injects node:18-alpine CMD npm start EXPOSE 8080. Require scripts.start; listen on PORT||8080; bind 0.0.0.0. gf deploy fails fast if scripts.start is missing.",
@@ -922,6 +975,8 @@ server.tool(
           switch_workspace: suggestCli("switch_workspace"),
           run: suggestCli("run"),
           logs: suggestCli("logs"),
+          environments: suggestCli("environments"),
+          cancel_deployment: suggestCli("cancel_deployment"),
           init_app: suggestCli("init_app"),
           publish_app: suggestCli("publish_app")
         },
@@ -997,9 +1052,102 @@ server.tool(
     }
   }
 );
+server.tool(
+  "coderunner_process_log",
+  "Process Log (deploy/build stdout/stderr) by coderunner id. Prefer this over coderunner_get_logs when there is no job_id.",
+  {
+    workspace_id: wsId,
+    coderunner_id: z.string().min(1).describe("Coderunner id or slug"),
+    limit: z.number().int().positive().optional(),
+    since_seconds: z.number().int().min(10).optional(),
+    search: z.string().optional(),
+    deployment_id: z.string().optional()
+  },
+  async (args) => {
+    try {
+      const c = await cfg(args.workspace_id);
+      const id = await resolveCoderunnerId(
+        c.apiUrl,
+        c.workspaceId,
+        args.coderunner_id
+      );
+      return text(
+        await getProcessLogs(c.apiUrl, c.workspaceId, {
+          runner_id: id,
+          deployment_id: args.deployment_id,
+          limit: args.limit ?? 50,
+          since_seconds: args.since_seconds ?? 3600,
+          search: args.search
+        })
+      );
+    } catch (e) {
+      return errText(e);
+    }
+  }
+);
+server.tool(
+  "environments_list",
+  "List environments in the workspace (id, name, status).",
+  { workspace_id: wsId },
+  async ({ workspace_id }) => {
+    try {
+      const c = await cfg(workspace_id);
+      const environments = await listWorkspaceEnvironments(
+        c.apiUrl,
+        c.workspaceId
+      );
+      return text({ environments, count: environments.length });
+    } catch (e) {
+      return errText(e);
+    }
+  }
+);
+server.tool(
+  "coderunner_cancel_deployment",
+  "Delete a coderunner deployment (current deployment if deployment_id is omitted). Same as `gf coderunner cancel-deployment`.",
+  {
+    workspace_id: wsId,
+    coderunner_id: z.string().min(1).describe("Coderunner id or slug"),
+    deployment_id: z.string().optional().describe("Deployment id; defaults to the current deployment")
+  },
+  async (args) => {
+    try {
+      const c = await cfg(args.workspace_id);
+      const id = await resolveCoderunnerId(
+        c.apiUrl,
+        c.workspaceId,
+        args.coderunner_id
+      );
+      let deploymentId = args.deployment_id?.trim();
+      if (!deploymentId) {
+        const current = await getDeployment(c.apiUrl, c.workspaceId, id);
+        deploymentId = current?.id?.trim();
+      }
+      if (!deploymentId) {
+        throw new Error(
+          `No current deployment for coderunner ${id}. Pass deployment_id.`
+        );
+      }
+      await deleteCoderunnerDeployment(
+        c.apiUrl,
+        c.workspaceId,
+        id,
+        deploymentId
+      );
+      return text({
+        coderunner_id: id,
+        deployment_id: deploymentId,
+        deleted: true,
+        next: suggestCli("logs", { coderunner: id })
+      });
+    } catch (e) {
+      return errText(e);
+    }
+  }
+);
 server.tool(
   "coderunner_get_logs",
-  "Job-run logs from a previous `gf coderunner run` (needs job_id). For deploy/build stdout use suggest_cli intent logs (`gf coderunner logs`).",
+  "Job-run logs from a previous `gf coderunner run` (needs job_id). For deploy/build stdout use coderunner_process_log or suggest_cli intent logs (`gf coderunner logs`).",
   {
     workspace_id: wsId,
     coderunner_id: z.string().min(1),
@@ -1160,13 +1308,15 @@ server.tool(
       "run",
       "status",
       "logs",
+      "environments",
+      "cancel_deployment",
       "init_app",
       "publish_app",
       "secrets",
       "dataplane"
     ]),
     workspace: z.string().optional(),
-    name: z.string().optional().describe("Coderunner name/id for deploy/run/status/logs"),
+    name: z.string().optional().describe("Coderunner name/id for deploy/run/status/logs/cancel_deployment"),
     slug: z.string().optional().describe("Portal app slug for init_app / publish_app"),
     cell: z.enum(["production", "stage", "dev"]).optional()
   },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@groundfloorcloud/mcp",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "Groundfloor MCP — inspect workspace state and docs; take actions with the gf CLI.",
   "type": "module",
   "bin": {