@nullplatform/mcp 0.1.4 → 0.1.5

package/dist/tools/approvals.js

@@ -16,6 +16,7 @@ export const approvalsTool = defineTool({
     title: "Approvals",
     description: 'List the approvals gating an application\'s actions (e.g. a deployment waiting on a policy), and act on one. action:"approve" lets the gated action proceed; action:"cancel" cancels the request. Both use your own permissions — the platform denies what you\'re not allowed to do. Use this when a deploy is stuck in creating_approval.',
     annotations: { destructiveHint: false, openWorldHint: true },
+    widget: "approvals",
     errorKey: "approvals.errorLabel",
     inputSchema: {
         app: appArg,

package/dist/tools/create-release.js

@@ -1,7 +1,7 @@
 import { z } from "zod";
 import { translate } from "../i18n.js";
 import { ago, glyph, next, shortCommit } from "../md.js";
-import { createRelease, findActiveReleaseForBuild, listBuilds } from "../np/journey.js";
+import { createRelease, findActiveReleaseForBuild, listBuilds, listReleases } from "../np/journey.js";
 import { defineTool, fail, reply } from "../tool.js";
 import { TOOL } from "../tool-names.js";
 import { appArg, requireApp } from "./shared.js";
@@ -9,7 +9,9 @@ export const createReleaseTool = defineTool({
     name: TOOL.applicationReleaseCreate,
     title: "Create release",
     description: "Cut an active release from a build (default: the latest successful build; semver auto-bumps the patch). Usually you can just call deploy, which does this for you.",
-    annotations: { destructiveHint: false, idempotentHint: false, openWorldHint: true },
+    // Convergent under retries (reuses the active release-for-build), so idempotent.
+    annotations: { destructiveHint: false, idempotentHint: true, openWorldHint: true },
+    widget: "releases",
     errorKey: "createRelease.errorLabel",
     inputSchema: {
         app: appArg,
@@ -40,13 +42,17 @@ export const createReleaseTool = defineTool({
         // (matching the requested semver, if any), return it instead of minting a duplicate.
         const existing = await findActiveReleaseForBuild(context.np, app.id, buildId, args.semver);
         if (existing) {
-            return reply(`${glyph("active")} ${translate("createRelease.exists", { semver: existing.semver, build: buildId })}${next(translate("createRelease.deployHint", { id: existing.id }))}`, { release: existing, reused: true });
+            const releases = await listReleases(context.np, app.id, { limit: 25 }).catch(() => [existing]);
+            return reply(`${glyph("active")} ${translate("createRelease.exists", { semver: existing.semver, build: buildId })}${next(translate("createRelease.deployHint", { id: existing.id }))}`, { release: existing, reused: true, app: `#${app.id}`, app_name: app.name, releases });
         }
         const release = await createRelease(context.np, {
             application_id: app.id,
             build_id: buildId,
             semver: args.semver,
         });
-        return reply(`${glyph("active")} ${translate("createRelease.done", { semver: release.semver, from: buildNote })}${next(translate("createRelease.deployHint", { id: release.id }))}`, { release, reused: false });
+        // Mirror the releases widget's shape so the SAME panel renders the new release with its
+        // Deploy action (read-after-write); the markdown stays the plain confirmation.
+        const releases = await listReleases(context.np, app.id, { limit: 25 }).catch(() => [release]);
+        return reply(`${glyph("active")} ${translate("createRelease.done", { semver: release.semver, from: buildNote })}${next(translate("createRelease.deployHint", { id: release.id }))}`, { release, reused: false, app: `#${app.id}`, app_name: app.name, releases });
     },
 });

package/dist/tools/create-scope.js

@@ -5,11 +5,14 @@ import { createScope, listScopes, listScopeTypes } from "../np/journey.js";
 import { defineTool, fail, reply } from "../tool.js";
 import { TOOL } from "../tool-names.js";
 import { appArg, dimsLabel, requireApp } from "./shared.js";
+import { buildAppStatus } from "./status.js";
 export const createScopeTool = defineTool({
     name: TOOL.applicationScopeCreate,
     title: "Create scope",
     description: "Create a scope (a deploy target, e.g. dev/staging/main) for an application. This provisions real infrastructure asynchronously. If the org has several scope types and none is given, it lists them to pick from.",
-    annotations: { destructiveHint: false, openWorldHint: true },
+    // Convergent under retries (reuses the scope-by-name), so idempotent.
+    annotations: { destructiveHint: false, idempotentHint: true, openWorldHint: true },
+    widget: "np-panel",
     errorKey: "createScope.errorLabel",
     inputSchema: {
         app: appArg,
@@ -31,10 +34,13 @@ export const createScopeTool = defineTool({
         const siblings = await listScopes(context.np, app.id);
         const existing = siblings.find((scope) => scope.name.toLowerCase() === args.name.toLowerCase());
         if (existing) {
-            const orgSlug = await context.org.organizationSlug();
+            const [orgSlug, status] = await Promise.all([
+                context.org.organizationSlug(),
+                buildAppStatus(context, app),
+            ]);
             return reply(translate("createScope.exists", { name: existing.name, id: existing.id, status: existing.status }) +
                 next(translate("createScope.provisioningHint", { name: existing.name })) +
-                linkLine(translate("md.dashboard"), dashboardLink(orgSlug, existing.nrn)), { scope: existing, reused: true });
+                linkLine(translate("md.dashboard"), dashboardLink(orgSlug, existing.nrn)), { ...status.structured, scope: existing, reused: true });
         }
         let type = args.type;
         let provider = args.provider;
@@ -46,11 +52,14 @@ export const createScopeTool = defineTool({
                 provider = provider ?? onlyType.provider ?? undefined;
             }
             else if (scopeTypes.length > 1) {
+                // np-panel's create-scope form picks a type from scope_types; the overview rides along
+                // so a fresh app (no scopes yet) renders that form instead of an empty panel.
+                const { structured } = await buildAppStatus(context, app);
                 return reply(`${translate("createScope.whichType", { name: args.name })}\n\n${table([translate("header.type"), translate("header.name"), translate("header.provider")], scopeTypes.map((scopeType) => [
                     scopeType.type ?? "",
                     scopeType.name ?? "",
                     scopeType.provider ?? "",
-                ]))}${next(translate("createScope.typeHint", { name: args.name }))}`, { scope_types: scopeTypes });
+                ]))}${next(translate("createScope.typeHint", { name: args.name }))}`, { ...structured, scope_types: scopeTypes });
             }
         }
         if (!type)
@@ -69,7 +78,12 @@ export const createScopeTool = defineTool({
             provider,
             dimensions,
         });
-        const orgSlug = await context.org.organizationSlug();
+        // Hand off into np-panel: the overview now includes the provisioning scope, so the panel
+        // shows it alongside a Deploy button — the literal next move (read-after-write).
+        const [orgSlug, status] = await Promise.all([
+            context.org.organizationSlug(),
+            buildAppStatus(context, app),
+        ]);
         return reply(translate("createScope.provisioning", {
             name: scope.name,
             id: scope.id,
@@ -77,6 +91,6 @@ export const createScopeTool = defineTool({
             dimensions: dimensions ? `, ${dimsLabel(dimensions)}` : "",
         }) +
             next(translate("createScope.provisioningHint", { name: scope.name })) +
-            linkLine(translate("md.dashboard"), dashboardLink(orgSlug, scope.nrn)), { scope });
+            linkLine(translate("md.dashboard"), dashboardLink(orgSlug, scope.nrn)), { ...status.structured, scope, reused: false });
     },
 });

package/dist/tools/deployments.js

@@ -1,7 +1,7 @@
 import { z } from "zod";
 import { translate } from "../i18n.js";
 import { ago, glyph, next, table } from "../md.js";
-import { listDeployments, listReleases, listScopes } from "../np/journey.js";
+import { isDeploymentTerminal, listDeployments, listReleases, listScopes, } from "../np/journey.js";
 import { defineTool, reply } from "../tool.js";
 import { TOOL } from "../tool-names.js";
 import { appArg, offsetArg, pageOf, requireApp } from "./shared.js";
@@ -45,6 +45,20 @@ export const deploymentsTool = defineTool({
             ? translate("deploymentList.group", { count: row.deployments?.length ?? 0 })
             : (scopeName.get(row.scope_id ?? -1) ?? `scope #${row.scope_id ?? "?"}`);
         const releaseLabel = (releaseId) => releaseId ? (semverOf.get(releaseId) ?? `#${releaseId}`) : "";
+        // A group has no status of its own — derive a headline from its children (same precedence as
+        // the widget's collapsed row), so the text reply never prints "· undefined".
+        const statusOf = (row) => {
+            if (row.type !== "deployment_group")
+                return row.status;
+            const children = row.deployments ?? [];
+            if (children.some((child) => !isDeploymentTerminal(child.status)))
+                return "running";
+            if (children.some((child) => child.status === "failed" || child.status === "rolled_back"))
+                return "failed";
+            if (children.length && children.every((child) => child.status === "finalized"))
+                return "finalized";
+            return children[0]?.status ?? "pending";
+        };
         const markdown = [
             translate("deploymentList.title", { app: app.name, count: rows.length }),
             "",
@@ -56,7 +70,7 @@ export const deploymentsTool = defineTool({
             ], rows.map((row) => [
                 scopeLabel(row),
                 releaseLabel(row.release_id),
-                `${glyph(row.status)} ${row.status}`,
+                `${glyph(statusOf(row))} ${statusOf(row)}`,
                 ago(row.created_at),
             ])),
             next(translate("deploymentList.hint")),

package/dist/tools/logs.js

@@ -22,6 +22,10 @@ export const logsTool = defineTool({
             .optional()
             .describe("ISO-8601 start of the time window, e.g. 2026-06-13T10:00:00Z"),
         end_time: z.string().optional().describe("ISO-8601 end of the time window (defaults to now)"),
+        page_token: z
+            .string()
+            .optional()
+            .describe("Pagination cursor (the next_page_token from a prior call) to fetch the next page of older lines."),
     },
     async handler(args, context) {
         const resolved = await requireApp(context, args);
@@ -45,6 +49,7 @@ export const logsTool = defineTool({
         const page = await readLogs(context.np, {
             application_id: app.id,
             scope_id: scope.id,
+            next_page_token: args.page_token,
             start_time: args.start_time,
             end_time: args.end_time,
         });

package/dist/tools/overview.js

@@ -16,6 +16,7 @@ export const overviewTool = defineTool({
     title: "Organization overview",
     description: "A cross-application health digest for the whole org: what's mid-rollout right now, and which scopes' last deployment failed or rolled back. Answers 'is anything broken?' / 'what's deploying?' without naming an app. Scans up to the first ~30 applications.",
     annotations: { readOnlyHint: true, openWorldHint: true },
+    widget: "overview",
     errorKey: "overview.errorLabel",
     inputSchema: {
         query: z.string().optional().describe("Limit the scan to apps whose name contains this"),
@@ -36,6 +37,7 @@ export const overviewTool = defineTool({
                 if (!isDeploymentTerminal(latest.status)) {
                     active.push({
                         app: app.name,
+                        app_id: app.id,
                         scope: scope.name,
                         deployment_id: latest.id,
                         status: latest.status,
@@ -46,6 +48,7 @@ export const overviewTool = defineTool({
                 else if (latest.status === "failed" || latest.status === "rolled_back") {
                     trouble.push({
                         app: app.name,
+                        app_id: app.id,
                         scope: scope.name,
                         status: latest.status,
                         when: latest.created_at,

package/dist/tools/playbook.js

@@ -16,6 +16,7 @@ export const playbookGetTool = defineTool({
     title: "Operating playbooks",
     description: "Read a nullplatform operating playbook — the methodology to follow BEFORE the matching non-trivial work (e.g. deploying-safely before a deploy, incident-response when something is broken, configuring-safely before changing parameters or secrets). The server instructions carry the full catalog; call this with no name to list them too.",
     annotations: { readOnlyHint: true },
+    widget: "playbook",
     errorKey: "playbook.errorLabel",
     inputSchema: {
         name: z.string().optional().describe('Playbook name, e.g. "deploying-safely". Omit to list them.'),

package/dist/tools/services.js

@@ -15,6 +15,7 @@ export const servicesTool = defineTool({
     title: "Services & dependencies",
     description: "List the dependency services (databases, queues, caches…) attached to an application, plus the catalog of dependency types available to provision. Read-only: provisioning a new dependency is a guided flow, so this links you into the dashboard to create one.",
     annotations: { readOnlyHint: true, openWorldHint: true },
+    widget: "services",
     errorKey: "services.errorLabel",
     inputSchema: { app: appArg },
     async handler(args, context) {
@@ -29,7 +30,8 @@ export const servicesTool = defineTool({
             listServiceSpecifications(context.bff, app.nrn),
             context.org.organizationSlug(),
         ]);
-        const dashboard = linkLine(translate("md.dashboard"), dashboardLink(orgSlug, app.nrn));
+        const dashboardUrl = dashboardLink(orgSlug, app.nrn);
+        const dashboard = linkLine(translate("md.dashboard"), dashboardUrl);
         const sections = [];
         if (services.length === 0) {
             sections.push(translate("services.none", { app: app.name }));
@@ -53,6 +55,7 @@ export const servicesTool = defineTool({
             app_name: app.name,
             services,
             catalog,
+            dashboard: dashboardUrl,
         });
     },
 });

package/dist/tools/set-params.js

@@ -1,7 +1,7 @@
 import { z } from "zod";
 import { translate } from "../i18n.js";
 import { next } from "../md.js";
-import { setParameters } from "../np/journey.js";
+import { listParameters, setParameters } from "../np/journey.js";
 import { defineTool, errorMessage, fail, reply } from "../tool.js";
 import { TOOL } from "../tool-names.js";
 import { appArg, requireApp } from "./shared.js";
@@ -9,7 +9,8 @@ export const setParamsTool = defineTool({
     name: TOOL.applicationParameterCreate,
     title: "Set parameters",
     description: "Create or update application configuration parameters (environment variables or files; mark secrets). Values apply on the NEXT deploy.",
-    annotations: { destructiveHint: false, openWorldHint: true },
+    annotations: { destructiveHint: false, idempotentHint: true, openWorldHint: true },
+    widget: "params",
     errorKey: "setParams.errorLabel",
     inputSchema: {
         app: appArg,
@@ -44,10 +45,16 @@ export const setParamsTool = defineTool({
                         app: app.name,
                         names,
                     });
+            // Mirror the params widget's shape so the SAME panel renders the resulting set with its
+            // add/save affordance (read-after-write); the markdown stays the plain confirmation.
+            const parameters = await listParameters(context.np, app.nrn).catch(() => undefined);
             return reply(summary + next(translate("setParams.applyHint")), {
                 created: result.created,
                 updated: result.updated,
                 total,
+                app: `#${app.id}`,
+                app_name: app.name,
+                ...(parameters === undefined ? { available: false } : { available: true, params: parameters }),
             });
         }
         catch (caught) {

package/dist/tools/status.js

@@ -24,6 +24,20 @@ async function scopeViews(context, applicationId) {
         };
     });
 }
+/**
+ * Build an application's full status view (the np-panel overview payload). Exported so write
+ * tools that should hand off into the same live panel — e.g. create-scope, after provisioning a
+ * new deploy target — can return this exact shape and let np-panel render the app + Deploy.
+ */
+export async function buildAppStatus(context, app) {
+    const [views, builds, releases, orgSlug] = await Promise.all([
+        scopeViews(context, app.id),
+        listBuilds(context.np, app.id, { limit: 5 }),
+        listReleases(context.np, app.id, { limit: 5 }),
+        context.org.organizationSlug(),
+    ]);
+    return renderStatus({ app, views, builds, releases, dashboard: dashboardLink(orgSlug, app.nrn) });
+}
 export const statusTool = defineTool({
     name: TOOL.applicationGet,
     title: "Application status",
@@ -52,19 +66,7 @@ export const statusTool = defineTool({
         const resolved = await requireApp(context, args);
         if ("out" in resolved)
             return resolved.out;
-        const [views, builds, releases, orgSlug] = await Promise.all([
-            scopeViews(context, resolved.app.id),
-            listBuilds(context.np, resolved.app.id, { limit: 5 }),
-            listReleases(context.np, resolved.app.id, { limit: 5 }),
-            context.org.organizationSlug(),
-        ]);
-        const { md, structured } = renderStatus({
-            app: resolved.app,
-            views,
-            builds,
-            releases,
-            dashboard: dashboardLink(orgSlug, resolved.app.nrn),
-        });
+        const { md, structured } = await buildAppStatus(context, resolved.app);
         return reply(md, structured);
     },
 });

package/dist/ui.js

@@ -22,6 +22,10 @@ export const WIDGETS = {
     builds: "Builds",
     releases: "Releases",
     deployments: "Deployments",
+    approvals: "Approvals",
+    overview: "Organization overview",
+    services: "Services & dependencies",
+    playbook: "Operating playbooks",
 };
 /** Did this session's client negotiate the MCP Apps extension? (Knowable after initialize.) */
 export function uiNegotiated(server) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nullplatform/mcp",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "nullplatform from your code assistant — an MCP server that replaces the dashboard for the everyday developer journey",
   "license": "MIT",
   "author": "nullplatform",
@@ -37,6 +37,7 @@
     "test": "vitest run",
     "test:watch": "vitest",
     "build:widgets": "node scripts/build-widgets.mjs",
+    "preview:widgets": "node scripts/preview/build-preview.mjs",
     "pretest": "node scripts/build-widgets.mjs",
     "lint": "biome check .",
     "lint:fix": "biome check --write .",