@nullplatform/mcp 0.1.3 → 0.1.4

package/dist/i18n.js

@@ -51,6 +51,9 @@ const english = {
     "header.live": "Live",
     "header.traffic": "Traffic",
     "header.when": "When",
+    "header.version": "Version",
+    "header.build": "Build",
+    "header.release": "Release",
     // — markdown design language —
     "md.next": "Next",
     "md.none": "_none_",
@@ -168,6 +171,16 @@ const english = {
     "builds.assetsTitle": "Assets of build #{build}",
     "builds.noAssets": "Build #{build} has no assets (it may still be building).",
     "builds.errorLabel": "Couldn't list builds",
+    "releaseList.title": "**{app}** · {count} release(s)",
+    "releaseList.none": "**{app}** has no releases yet.",
+    "releaseList.noneHint": "cut one from a successful build with `application_release_create`, or just `application_deployment_create`.",
+    "releaseList.deployHint": 'deploy an active release with `application_deployment_create version:"x.y.z"`.',
+    "releaseList.errorLabel": "Couldn't list releases",
+    "deploymentList.title": "**{app}** · {count} deployment(s)",
+    "deploymentList.none": "**{app}** has no deployments yet.",
+    "deploymentList.group": "{count} scopes (group)",
+    "deploymentList.hint": "`application_get` for the live picture, or `application_deployment_update` to drive a rollout.",
+    "deploymentList.errorLabel": "Couldn't list deployments",
     // — organization_get tool —
     "overview.title": "Organization overview · {count} application(s) scanned",
     "overview.truncated": '_(showing the first {count} — narrow with `organization_get query:"..."`)_',
@@ -325,6 +338,9 @@ const spanish = {
     "header.live": "En vivo",
     "header.traffic": "Tráfico",
     "header.when": "Cuándo",
+    "header.version": "Versión",
+    "header.build": "Build",
+    "header.release": "Release",
     "md.next": "Siguiente",
     "md.none": "_ninguno_",
     "md.justNow": "recién",
@@ -432,6 +448,16 @@ const spanish = {
     "builds.assetsTitle": "Assets del build #{build}",
     "builds.noAssets": "El build #{build} no tiene assets (puede estar compilando todavía).",
     "builds.errorLabel": "No pude listar los builds",
+    "releaseList.title": "**{app}** · {count} release(s)",
+    "releaseList.none": "**{app}** todavía no tiene releases.",
+    "releaseList.noneHint": "cortá uno desde un build exitoso con `application_release_create`, o directamente `application_deployment_create`.",
+    "releaseList.deployHint": 'deployá un release activo con `application_deployment_create version:"x.y.z"`.',
+    "releaseList.errorLabel": "No pude listar los releases",
+    "deploymentList.title": "**{app}** · {count} deployment(s)",
+    "deploymentList.none": "**{app}** todavía no tiene deployments.",
+    "deploymentList.group": "{count} scopes (grupo)",
+    "deploymentList.hint": "`application_get` para la foto en vivo, o `application_deployment_update` para conducir un rollout.",
+    "deploymentList.errorLabel": "No pude listar los deployments",
     // — organization_get tool —
     "overview.title": "Panorama de la organización · {count} aplicación(es) escaneada(s)",
     "overview.truncated": '_(muestro las primeras {count} — acotá con `organization_get query:"..."`)_',

package/dist/np/journey.js

@@ -26,6 +26,8 @@ export async function listBuilds(np, applicationId, options = {}) {
     // canonical OpenAPI contract) — this is how a change is traced from a commit to its build.
     if (options.commit)
         query["commit.id"] = options.commit;
+    if (options.offset)
+        query.offset = options.offset;
     const page = await np.get("/build", query).catch(() => ({ results: [] }));
     return (page.results ?? []).map((build) => ({
         id: build.id,
@@ -52,6 +54,8 @@ export async function listReleases(np, applicationId, options = {}) {
     };
     if (options.status)
         query.status = options.status;
+    if (options.offset)
+        query.offset = options.offset;
     const page = await np
         .get("/release", query)
         .catch(() => ({ results: [] }));
@@ -195,6 +199,25 @@ export async function listScopeDeployments(np, scopeId, limit = 3) {
         .catch(() => ({ results: [] }));
     return (page.results ?? []).map(mapDeployment);
 }
+/** Every deployment of an application, newest first — the public `/deployment` endpoint accepts
+ *  `application_id`. Group rows (`type: "deployment_group"`) carry their per-scope children. */
+export async function listDeployments(np, applicationId, options = {}) {
+    const query = {
+        application_id: applicationId,
+        sort: "created_at:desc",
+        limit: options.limit ?? 50,
+    };
+    if (options.offset)
+        query.offset = options.offset;
+    const page = await np
+        .get("/deployment", query)
+        .catch(() => ({ results: [] }));
+    return (page.results ?? []).map((row) => ({
+        ...mapDeployment(row),
+        type: row.type,
+        deployments: row.deployments?.map(mapDeployment),
+    }));
+}
 /**
  * Traffic switch — the public API takes desiredSwitchedTraffic (camelCase INSIDE the
  * snake_case strategy_data envelope; verified live) and moves traffic toward it.
@@ -243,9 +266,12 @@ export async function setParameters(np, nrn, params) {
     return { created, updated };
 }
 /** Read parameters — NRN-scoped on the public API; returns undefined when unavailable. */
-export async function listParameters(np, nrn) {
+export async function listParameters(np, nrn, options = {}) {
     try {
-        const page = await np.get("/parameter", { nrn, limit: 100 });
+        const query = { nrn, limit: options.limit ?? 100 };
+        if (options.offset)
+            query.offset = options.offset;
+        const page = await np.get("/parameter", query);
         return (page.results ?? []).map((parameter) => ({
             id: parameter.id,
             name: parameter.name,

package/dist/tool-names.js

@@ -12,6 +12,8 @@ export const TOOL = {
     applicationLogList: "application_log_list",
     applicationMetricList: "application_metric_list",
     applicationBuildList: "application_build_list",
+    applicationReleaseList: "application_release_list",
+    applicationDeploymentList: "application_deployment_list",
     applicationParameterList: "application_parameter_list",
     applicationParameterCreate: "application_parameter_create",
     applicationDeploymentCreate: "application_deployment_create",

package/dist/tools/builds.js

@@ -4,7 +4,7 @@ import { ago, glyph, next, shortCommit, table } from "../md.js";
 import { listAssets, listBuilds, listReleases } from "../np/journey.js";
 import { defineTool, reply } from "../tool.js";
 import { TOOL } from "../tool-names.js";
-import { appArg, requireApp } from "./shared.js";
+import { appArg, offsetArg, pageOf, requireApp } from "./shared.js";
 /**
  * Closes the hole in the ship loop: between "push a commit" and "deploy" sits CI, and the
  * agent needs to see builds land. status only shows the latest; this lists recent builds,
@@ -15,6 +15,7 @@ export const buildsTool = defineTool({
     title: "Builds",
     description: "List an application's recent CI builds — status, branch, commit, age, and whether each is already released. Use it to answer 'did my push build yet?' and to pick a build_id to deploy. Pass build:<id> to see that build's assets, or commit:<sha> to find the build for a specific commit (tracing a change to its build and release).",
     annotations: { readOnlyHint: true, openWorldHint: true },
+    widget: "builds",
     errorKey: "builds.errorLabel",
     inputSchema: {
         app: appArg,
@@ -24,6 +25,7 @@ export const buildsTool = defineTool({
             .string()
             .optional()
             .describe("Full commit SHA — list only the build(s) for that commit (tracing a change to its build/release)"),
+        offset: offsetArg,
     },
     async handler(args, context) {
         const resolved = await requireApp(context, args);
@@ -47,7 +49,7 @@ export const buildsTool = defineTool({
             return reply(markdown, { build_id: args.build, assets });
         }
         const [builds, releases] = await Promise.all([
-            listBuilds(context.np, app.id, { limit: args.limit ?? 10, commit: args.commit }),
+            listBuilds(context.np, app.id, { limit: args.limit ?? 10, commit: args.commit, offset: args.offset }),
             listReleases(context.np, app.id, { limit: 50 }),
         ]);
         if (builds.length === 0) {
@@ -86,6 +88,7 @@ export const buildsTool = defineTool({
                 released: releasedBuildIds.has(build.id),
                 release_semver: releaseByBuild.get(build.id)?.semver ?? null,
             })),
+            page: pageOf(builds.length, args.limit ?? 10, args.offset ?? 0),
         });
     },
 });

package/dist/tools/deployments.js

@@ -0,0 +1,81 @@
+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 { defineTool, reply } from "../tool.js";
+import { TOOL } from "../tool-names.js";
+import { appArg, offsetArg, pageOf, requireApp } from "./shared.js";
+/**
+ * The deployments list — the end of build → release → deploy. Lists every deployment across an
+ * app's scopes (a deployment_group lands one release on several scopes and is shown as one row),
+ * resolving scope and release names so both the text reply and the bound widget read cleanly.
+ */
+export const deploymentsTool = defineTool({
+    name: TOOL.applicationDeploymentList,
+    title: "Deployments",
+    description: "List an application's deployments across all scopes — which release landed on which scope, the rollout status, and age; a deployment group (one release to several scopes) is shown as one row. Use to see deploy history or find an active rollout.",
+    annotations: { readOnlyHint: true, openWorldHint: true },
+    widget: "deployments",
+    errorKey: "deploymentList.errorLabel",
+    inputSchema: {
+        app: appArg,
+        limit: z.number().optional().describe("How many recent deployments (default 50)"),
+        offset: offsetArg,
+    },
+    async handler(args, context) {
+        const resolved = await requireApp(context, args);
+        if ("out" in resolved)
+            return resolved.out;
+        const app = resolved.app;
+        const [rows, scopes, releases] = await Promise.all([
+            listDeployments(context.np, app.id, { limit: args.limit ?? 50, offset: args.offset }),
+            listScopes(context.np, app.id),
+            listReleases(context.np, app.id, { limit: 200 }),
+        ]);
+        if (rows.length === 0) {
+            return reply(translate("deploymentList.none", { app: app.name }), {
+                app: `#${app.id}`,
+                app_name: app.name,
+                deployments: [],
+            });
+        }
+        const scopeName = new Map(scopes.map((scope) => [scope.id, scope.name]));
+        const semverOf = new Map(releases.map((release) => [release.id, release.semver]));
+        const scopeLabel = (row) => row.type === "deployment_group"
+            ? 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}`) : "";
+        const markdown = [
+            translate("deploymentList.title", { app: app.name, count: rows.length }),
+            "",
+            table([
+                translate("header.scope"),
+                translate("header.release"),
+                translate("header.status"),
+                translate("header.when"),
+            ], rows.map((row) => [
+                scopeLabel(row),
+                releaseLabel(row.release_id),
+                `${glyph(row.status)} ${row.status}`,
+                ago(row.created_at),
+            ])),
+            next(translate("deploymentList.hint")),
+        ].join("\n");
+        // Enrich the structured rows the widget renders: scope + release names resolved, children too.
+        const enrich = (row) => ({
+            ...row,
+            scope_name: scopeName.get(row.scope_id ?? -1) ?? null,
+            release_semver: row.release_id ? (semverOf.get(row.release_id) ?? null) : null,
+        });
+        const deployments = rows.map((row) => ({
+            ...enrich(row),
+            deployments: row.deployments?.map(enrich),
+        }));
+        return reply(markdown, {
+            app: `#${app.id}`,
+            app_name: app.name,
+            deployments,
+            page: pageOf(rows.length, args.limit ?? 50, args.offset ?? 0),
+        });
+    },
+});

package/dist/tools/index.js

@@ -4,12 +4,14 @@ import { createAppTool } from "./create-app.js";
 import { createReleaseTool } from "./create-release.js";
 import { createScopeTool } from "./create-scope.js";
 import { deployTool } from "./deploy.js";
+import { deploymentsTool } from "./deployments.js";
 import { findAppsTool } from "./find-apps.js";
 import { logsTool } from "./logs.js";
 import { metricsTool } from "./metrics.js";
 import { overviewTool } from "./overview.js";
 import { paramsTool } from "./params.js";
 import { playbookGetTool } from "./playbook.js";
+import { releasesTool } from "./releases.js";
 import { servicesTool } from "./services.js";
 import { setParamsTool } from "./set-params.js";
 import { statusTool } from "./status.js";
@@ -24,6 +26,8 @@ export const tools = [
     overviewTool,
     findAppsTool,
     buildsTool,
+    releasesTool,
+    deploymentsTool,
     logsTool,
     paramsTool,
     metricsTool,

package/dist/tools/params.js

@@ -3,7 +3,7 @@ import { dashboardLink, linkLine, next, table } from "../md.js";
 import { listParameters } from "../np/journey.js";
 import { defineTool, fail, reply } from "../tool.js";
 import { TOOL } from "../tool-names.js";
-import { appArg, requireApp } from "./shared.js";
+import { appArg, offsetArg, pageOf, requireApp } from "./shared.js";
 export const paramsTool = defineTool({
     name: TOOL.applicationParameterList,
     title: "Parameters",
@@ -11,7 +11,7 @@ export const paramsTool = defineTool({
     annotations: { readOnlyHint: true, openWorldHint: true },
     widget: "params",
     errorKey: "params.errorLabel",
-    inputSchema: { app: appArg },
+    inputSchema: { app: appArg, offset: offsetArg },
     async handler(args, context) {
         const resolved = await requireApp(context, args);
         if ("out" in resolved)
@@ -20,7 +20,7 @@ export const paramsTool = defineTool({
         if (!app.nrn)
             return fail(translate("resolve.noNrn", { app: app.name }));
         const [parameters, orgSlug] = await Promise.all([
-            listParameters(context.np, app.nrn),
+            listParameters(context.np, app.nrn, { offset: args.offset }),
             context.org.organizationSlug(),
         ]);
         const dashboard = dashboardLink(orgSlug, app.nrn);
@@ -53,6 +53,11 @@ export const paramsTool = defineTool({
             ])),
             next(translate("params.applyHint")),
         ].join("\n");
-        return reply(markdown, { available: true, params: parameters, ...appRef });
+        return reply(markdown, {
+            available: true,
+            params: parameters,
+            page: pageOf(parameters.length, 100, args.offset ?? 0),
+            ...appRef,
+        });
     },
 });

package/dist/tools/releases.js

@@ -0,0 +1,59 @@
+import { z } from "zod";
+import { translate } from "../i18n.js";
+import { ago, glyph, next, table } from "../md.js";
+import { listReleases } from "../np/journey.js";
+import { defineTool, reply } from "../tool.js";
+import { TOOL } from "../tool-names.js";
+import { appArg, offsetArg, pageOf, requireApp } from "./shared.js";
+/**
+ * The releases list — the middle of build → release → deploy. A release is an immutable semver
+ * pointer to a build; this lists them so the model (and the bound widget) can pick one to deploy.
+ */
+export const releasesTool = defineTool({
+    name: TOOL.applicationReleaseList,
+    title: "Releases",
+    description: "List an application's releases — semver, status (active/deprecated/unstable/failed), the build each pins, and age. Use to pick a release to deploy or promote, or to see what's shippable.",
+    annotations: { readOnlyHint: true, openWorldHint: true },
+    widget: "releases",
+    errorKey: "releaseList.errorLabel",
+    inputSchema: {
+        app: appArg,
+        limit: z.number().optional().describe("How many recent releases (default 25)"),
+        offset: offsetArg,
+    },
+    async handler(args, context) {
+        const resolved = await requireApp(context, args);
+        if ("out" in resolved)
+            return resolved.out;
+        const app = resolved.app;
+        const releases = await listReleases(context.np, app.id, {
+            limit: args.limit ?? 25,
+            offset: args.offset,
+        });
+        if (releases.length === 0) {
+            return reply(translate("releaseList.none", { app: app.name }) + next(translate("releaseList.noneHint")), { app: `#${app.id}`, app_name: app.name, releases: [] });
+        }
+        const markdown = [
+            translate("releaseList.title", { app: app.name, count: releases.length }),
+            "",
+            table([
+                translate("header.version"),
+                translate("header.status"),
+                translate("header.build"),
+                translate("header.when"),
+            ], releases.map((release) => [
+                release.semver,
+                `${glyph(release.status)} ${release.status}`,
+                release.build_id ? `#${release.build_id}` : "",
+                ago(release.created_at),
+            ])),
+            next(translate("releaseList.deployHint")),
+        ].join("\n");
+        return reply(markdown, {
+            app: `#${app.id}`,
+            app_name: app.name,
+            releases,
+            page: pageOf(releases.length, args.limit ?? 25, args.offset ?? 0),
+        });
+    },
+});

package/dist/tools/shared.js

@@ -11,6 +11,19 @@ export const appArg = z
     .string()
     .optional()
     .describe('Application name or "#id". Omit it to use the app linked to the current repo (git remote).');
+export const offsetArg = z
+    .number()
+    .optional()
+    .describe("Skip this many items to page through a long list (use page.next_offset from a prior call).");
+/**
+ * Pagination token for a list reply. No list endpoint returns a total, so the boundary is the
+ * standard offset heuristic: a full page means there is likely more. The widget/model pages by
+ * re-calling the tool with `offset: next_offset` until `has_more` is false.
+ */
+export function pageOf(count, limit, offset = 0) {
+    const hasMore = count >= limit;
+    return { has_more: hasMore, next_offset: hasMore ? offset + limit : null };
+}
 export function httpsRepoUrl(url) {
     const trimmed = url.trim().replace(/\.git$/, "");
     const sshForm = /^git@([^:]+):(.+)$/.exec(trimmed);

package/dist/ui.js

@@ -19,6 +19,9 @@ export const WIDGETS = {
     logs: "Logs",
     "find-apps": "Applications",
     metrics: "Metrics",
+    builds: "Builds",
+    releases: "Releases",
+    deployments: "Deployments",
 };
 /** 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.3",
+  "version": "0.1.4",
   "description": "nullplatform from your code assistant — an MCP server that replaces the dashboard for the everyday developer journey",
   "license": "MIT",
   "author": "nullplatform",