@nullplatform/mcp 0.1.4 → 0.1.6

package/dist/md.js

@@ -1,4 +1,4 @@
-import { translate } from "./i18n.js";
+import { currentLocale, translate } from "./i18n.js";
 /**
  * The output design language. Every tool answer is markdown a developer scans in a
  * terminal or chat pane: a bold header line, tight tables, one status glyph per row,
@@ -47,7 +47,8 @@ export function statusLabel(status) {
 export function ago(iso) {
     if (!iso)
         return "";
-    const elapsedMs = Date.now() - new Date(iso).getTime();
+    const date = new Date(iso);
+    const elapsedMs = Date.now() - date.getTime();
     if (!Number.isFinite(elapsedMs) || elapsedMs < 0)
         return "";
     const minutes = Math.floor(elapsedMs / 60_000);
@@ -56,9 +57,18 @@ export function ago(iso) {
     if (minutes < 60)
         return translate("md.minutesAgo", { count: minutes });
     const hours = Math.round(minutes / 60);
-    if (hours < 48)
+    if (hours < 24)
         return translate("md.hoursAgo", { count: hours });
-    return translate("md.daysAgo", { count: Math.round(hours / 24) });
+    const days = Math.round(hours / 24);
+    if (days < 7)
+        return translate("md.daysAgo", { count: days });
+    // GitHub-style: a week or older shows an absolute calendar date (current year omitted), localized.
+    const sameYear = date.getFullYear() === new Date().getFullYear();
+    return new Intl.DateTimeFormat(currentLocale(), {
+        month: "short",
+        day: "numeric",
+        ...(sameYear ? {} : { year: "numeric" }),
+    }).format(date);
 }
 export function table(headers, rows) {
     if (rows.length === 0)

package/dist/surfaces/developer.js

@@ -12,7 +12,7 @@ You run in the developer's own environment, so fuse the local repo with platform
 
 Every tool accepts \`language\`: ALWAYS set it to the language the user is conversing in (ISO code, e.g. "es", "en") — answers come back in the user's language.
 
-Most tools render an interactive panel in clients that support it — the user sees apps, status, logs, metrics and parameters as live UI. When that panel renders, the user can already see the result: do NOT restate or summarise it in text (no re-listing applications, reprinting tables, or repeating status/metrics). Reply with at most one short sentence — the single key takeaway or next step — or nothing at all. Add prose only for something the panel doesn't already show.
+Most tools render an interactive panel in clients that support it — apps, status, builds, releases, deployments, logs, metrics, parameters and approvals all appear as live UI. **When a tool's panel renders, that panel IS the answer: do not reproduce its data in your text reply.** The user already sees every row, status and value. NEVER print a markdown table of the same rows, re-list the items, or restate per-row status — duplicating the panel in text is the single most common mistake. Reply with AT MOST one short sentence — the one key takeaway or the next step — or nothing at all. A one-line insight the panel doesn't itself show is fine ("builds 3 and 5 were never released"); re-rendering the list as a table is not.
 
 When the user wants to create, scaffold, set up or import an application, call \`application_create\` right away — pass a name if they gave one, otherwise no arguments. Its panel is an interactive FORM that collects the namespace, template and repository itself. Do NOT gather those details in conversation first, and while that form is on screen do NOT ask the user clarifying questions or use any question-asking tool for fields the form already covers (namespace, template, new-vs-import repository, monorepo path) — the form is the input surface. Just call \`application_create\` and let it drive; react only to what it reports back.
 

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.6",
   "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 .",