@webpresso/agent-kit 3.3.2 → 3.3.3

package/dist/esm/mcp/tools/release-progress.js

@@ -0,0 +1,110 @@
+/**
+ * `wp_release_progress` — read-only Release workflow phase reporter for agents.
+ *
+ * Shares {@link runReleaseProgress} with the CLI so MCP and `wp release-progress`
+ * never diverge. Does not mutate GitHub; only reads via `gh`.
+ */
+import { z } from "zod";
+import { runReleaseProgress, } from "#cli/commands/release-progress.js";
+import { createSummaryOutputSchema, createSummaryResult } from "./_shared/result.js";
+import { readonlyOpsBaseSchema } from "./_readonly-ops.js";
+const inputSchema = readonlyOpsBaseSchema
+    .extend({
+    runId: z.union([z.string().min(1), z.number().int().positive()]).optional(),
+    repo: z.string().min(1).optional(),
+})
+    .strict();
+const releaseProgressDetailsSchema = z
+    .object({
+    runId: z.string(),
+    repo: z.string(),
+    phase: z.enum(["detect", "native-matrix", "publish", "done", "failed"]),
+    detail: z.string(),
+    native: z.object({
+        done: z.number().int().nonnegative(),
+        total: z.number().int().nonnegative(),
+        failed: z.number().int().nonnegative(),
+        inProgress: z.number().int().nonnegative(),
+    }),
+    publishRunning: z.boolean(),
+    publishDone: z.boolean(),
+    publishFailed: z.boolean(),
+    line: z.string(),
+})
+    .strict();
+const outputSchema = createSummaryOutputSchema({
+    details: releaseProgressDetailsSchema,
+});
+/**
+ * Build the tool descriptor. Tests inject gh seams; production uses defaults.
+ */
+export function createReleaseProgressTool(deps = {}) {
+    return {
+        name: "wp_release_progress",
+        description: "Read-only GitHub Actions Release workflow phase reporter (detect | native-matrix | publish | done | failed) with session-memory native matrix counts. Use instead of silent npm view polls after Version Packages merge. Does not mutate GitHub. Prefer this over shelling `wp release-progress` when available.",
+        inputSchema,
+        outputSchema,
+        annotations: {
+            title: "Release progress",
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+        handler: async (raw) => {
+            const input = inputSchema.parse(raw ?? {});
+            const repo = input.repo ?? "webpresso/agent-kit";
+            try {
+                const result = runReleaseProgress({
+                    runId: input.runId,
+                    repo,
+                    json: false,
+                    fetchJobs: deps.fetchJobs,
+                    resolveLatestRunId: deps.resolveLatestRunId,
+                    // Suppress CLI text I/O; structuredContent is the MCP contract.
+                    stdout: { write: () => undefined },
+                    stderr: { write: () => undefined },
+                });
+                const { progress, runId, line } = result;
+                const failed = progress.phase === "failed";
+                return createSummaryResult({
+                    passed: !failed,
+                    summary: line,
+                    details: {
+                        runId,
+                        repo,
+                        phase: progress.phase,
+                        detail: progress.detail,
+                        native: progress.native,
+                        publishRunning: progress.publishRunning,
+                        publishDone: progress.publishDone,
+                        publishFailed: progress.publishFailed,
+                        line,
+                    },
+                    warnings: failed ? [progress.detail] : [],
+                }, { isError: failed });
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                return createSummaryResult({
+                    passed: false,
+                    summary: `release-progress failed: ${message}`,
+                    details: {
+                        runId: input.runId === undefined ? "" : String(input.runId),
+                        repo,
+                        phase: "failed",
+                        detail: message,
+                        native: { done: 0, total: 0, failed: 0, inProgress: 0 },
+                        publishRunning: false,
+                        publishDone: false,
+                        publishFailed: false,
+                        line: `release-progress phase=failed native=0/0 ${message}`,
+                    },
+                    warnings: [message],
+                }, { isError: true });
+            }
+        },
+    };
+}
+const tool = createReleaseProgressTool();
+export default tool;

package/dist/esm/mcp/tools/wp-ui-blocks-list.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDescriptor } from "#mcp/auto-discover";
+declare const tool: ToolDescriptor;
+export default tool;

package/dist/esm/mcp/tools/wp-ui-blocks-list.js

@@ -0,0 +1,43 @@
+import { z } from "zod";
+import { resolveBlockRegistry } from "#compose/registry-resolve.js";
+const inputSchema = z
+    .object({
+    cwd: z.string().optional(),
+    profile: z.enum(["admin-crud", "ops-report"]).optional(),
+})
+    .strict();
+const tool = {
+    name: "wp_ui_blocks_list",
+    description: "List the agent UI block catalog for composition. Resolves project `.webpresso/generated/frontend/blocks/registry.json` when present, otherwise the offline catalog snapshot. Always returns source (project|snapshot), registryVersion, and warnings (e.g. snapshot used inside a webpresso tree without a generated registry).",
+    inputSchema,
+    annotations: {
+        title: "UI blocks list",
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
+    handler: async (raw) => {
+        const input = inputSchema.parse(raw ?? {});
+        const resolved = resolveBlockRegistry({ cwd: input.cwd });
+        // admin-crud: full registry (list/detail/form). ops-report: no admin blocks.
+        const blocks = input.profile === "ops-report" ? [] : resolved.registry.blocks;
+        const summary = `UI blocks: ${blocks.length} (source=${resolved.source}, version=${resolved.registryVersion})`;
+        const payload = {
+            passed: true,
+            summary,
+            source: resolved.source,
+            registryVersion: resolved.registryVersion,
+            path: resolved.path,
+            warnings: [...resolved.warnings],
+            profiles: ["admin-crud", "ops-report"],
+            blocks,
+            webpressoPresentWithoutRegistry: resolved.webpressoPresentWithoutRegistry,
+        };
+        return {
+            content: [{ type: "text", text: summary }],
+            structuredContent: payload,
+        };
+    },
+};
+export default tool;

package/dist/esm/mcp/tools/wp-ui-compose.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDescriptor } from "#mcp/auto-discover";
+declare const tool: ToolDescriptor;
+export default tool;

package/dist/esm/mcp/tools/wp-ui-compose.js

@@ -0,0 +1,62 @@
+import { z } from "zod";
+import { composeValidate } from "#compose/compose.js";
+const inputSchema = z
+    .object({
+    cwd: z.string().optional(),
+    profile: z.enum(["admin-crud", "ops-report"]),
+    kind: z.enum(["list", "detail", "form"]).optional(),
+    spec: z.unknown(),
+})
+    .strict()
+    .superRefine((value, ctx) => {
+    if (value.profile === "admin-crud" && value.kind === undefined) {
+        ctx.addIssue({
+            code: "custom",
+            message: "kind is required for admin-crud (list|detail|form)",
+            path: ["kind"],
+        });
+    }
+});
+const tool = {
+    name: "wp_ui_compose",
+    description: "Validate a profile-discriminated UI compose input. admin-crud: validate list/detail/form specs against the block registry (returns input spec unchanged when legal). ops-report: validate flat OpsReportSpec. Does not write files or open a browser.",
+    inputSchema,
+    annotations: {
+        title: "UI compose validate",
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
+    handler: async (raw) => {
+        const input = inputSchema.parse(raw ?? {});
+        const composeInput = input.profile === "admin-crud"
+            ? {
+                profile: "admin-crud",
+                kind: input.kind,
+                spec: input.spec && typeof input.spec === "object" && !Array.isArray(input.spec)
+                    ? input.spec
+                    : {},
+            }
+            : { profile: "ops-report", spec: input.spec };
+        const result = composeValidate(composeInput, { cwd: input.cwd });
+        const summary = result.ok
+            ? `compose ok (${result.profile})`
+            : `compose failed (${result.profile}): ${result.diagnostics.map((d) => d.message).join("; ")}`;
+        return {
+            content: [{ type: "text", text: summary }],
+            structuredContent: {
+                passed: result.ok,
+                summary,
+                profile: result.profile,
+                ok: result.ok,
+                spec: result.spec,
+                diagnostics: result.diagnostics,
+                registrySource: result.registrySource,
+                registryVersion: result.registryVersion,
+                warnings: result.warnings,
+            },
+        };
+    },
+};
+export default tool;

package/dist/esm/mcp/tools/wp-ui-preview.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDescriptor } from "#mcp/auto-discover";
+declare const tool: ToolDescriptor;
+export default tool;

package/dist/esm/mcp/tools/wp-ui-preview.js

@@ -0,0 +1,52 @@
+import { z } from "zod";
+import { previewOpsReport } from "#compose/preview.js";
+const inputSchema = z
+    .object({
+    cwd: z.string().optional(),
+    profile: z.literal("ops-report"),
+    spec: z.unknown(),
+})
+    .strict();
+const tool = {
+    name: "wp_ui_preview",
+    description: "Validate an ops-report compose spec, write self-contained HTML under the worktree state surface (or .webpresso/compose fallback), and return { path } only. Does not open a browser. admin-crud is not supported for preview.",
+    inputSchema,
+    annotations: {
+        title: "UI ops-report preview",
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
+    handler: async (raw) => {
+        try {
+            const input = inputSchema.parse(raw ?? {});
+            const { path } = previewOpsReport({ cwd: input.cwd, spec: input.spec });
+            const summary = `ops-report preview written: ${path}`;
+            return {
+                content: [{ type: "text", text: summary }],
+                structuredContent: {
+                    passed: true,
+                    summary,
+                    path,
+                },
+            };
+        }
+        catch (error) {
+            const message = error instanceof z.ZodError
+                ? `Invalid wp_ui_preview input: ${error.issues.map((i) => i.message).join("; ")} (ops-report profile only; admin-crud is not supported)`
+                : error instanceof Error
+                    ? error.message
+                    : String(error);
+            return {
+                content: [{ type: "text", text: message }],
+                structuredContent: {
+                    passed: false,
+                    summary: message,
+                },
+                isError: true,
+            };
+        }
+    },
+};
+export default tool;

package/dist/esm/package.json

@@ -25,6 +25,8 @@
     "#worktrees/*": "./worktrees/*.js",
     "#fleet/*.js": "./fleet/*.js",
     "#fleet/*": "./fleet/*.js",
+    "#compose/*.js": "./compose/*.js",
+    "#compose/*": "./compose/*.js",
     "#cli/auto-update/*.js": "./cli/auto-update/*.js",
     "#cli/auto-update/*": "./cli/auto-update/*.js",
     "#cli/*.js": "./cli/*.js",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webpresso/agent-kit",
-  "version": "3.3.2",
+  "version": "3.3.3",
   "private": false,
   "description": "TypeScript-first agent harness for guarded develop/deploy workflows: wp CLI gates, MCP tools, hooks, memory, worktrees, secrets, audits, and evidence checks.",
   "keywords": [
@@ -78,6 +78,8 @@
     "#worktrees/*": "./src/worktrees/*.ts",
     "#fleet/*.js": "./src/fleet/*.ts",
     "#fleet/*": "./src/fleet/*.ts",
+    "#compose/*.js": "./src/compose/*.ts",
+    "#compose/*": "./src/compose/*.ts",
     "#cli/auto-update/*.js": "./src/cli/auto-update/*.ts",
     "#cli/auto-update/*": "./src/cli/auto-update/*.ts",
     "#cli/*.js": "./src/cli/*.ts",
@@ -505,19 +507,28 @@
   "packageManager": "pnpm@11.10.0",
   "webpresso": {
     "agentConfigVersion": "0.1.5",
+    "dependencyFreshnessExceptions": [
+      {
+        "package": "@xterm/xterm",
+        "reason": "Pinned to the 5.5 major the desktop-pty-loadtest spike actually measured. The spike's GUI performance gate for the terminal pane is still recorded as pending, so adopting the 6.0 renderer major would make that structural evidence non-transferable and leave apps/desktop with no supporting measurement at all. Upgrading is a separate change that must carry its own measurement.",
+        "owner": "ozby",
+        "expiry": "2026-10-31",
+        "linkedIssue": "https://github.com/webpresso/agent-kit/pull/889"
+      }
+    ],
     "setupWpActionRef": "c2c71a7a4be446fc6858e6b57bf55a11ccfa2d88"
   },
   "optionalDependencies": {
-    "@webpresso/agent-kit-runtime-darwin-arm64": "3.3.2",
-    "@webpresso/agent-kit-runtime-darwin-x64": "3.3.2",
-    "@webpresso/agent-kit-runtime-linux-x64": "3.3.2",
-    "@webpresso/agent-kit-runtime-linux-arm64": "3.3.2",
-    "@webpresso/agent-kit-runtime-windows-x64": "3.3.2",
-    "@webpresso/agent-kit-session-memory-darwin-x64": "3.3.2",
-    "@webpresso/agent-kit-session-memory-darwin-arm64": "3.3.2",
-    "@webpresso/agent-kit-session-memory-linux-x64": "3.3.2",
-    "@webpresso/agent-kit-session-memory-linux-arm64": "3.3.2",
-    "@webpresso/agent-kit-session-memory-win32-x64": "3.3.2",
-    "@webpresso/agent-kit-session-memory-win32-arm64": "3.3.2"
+    "@webpresso/agent-kit-runtime-darwin-arm64": "3.3.3",
+    "@webpresso/agent-kit-runtime-darwin-x64": "3.3.3",
+    "@webpresso/agent-kit-runtime-linux-x64": "3.3.3",
+    "@webpresso/agent-kit-runtime-linux-arm64": "3.3.3",
+    "@webpresso/agent-kit-runtime-windows-x64": "3.3.3",
+    "@webpresso/agent-kit-session-memory-darwin-x64": "3.3.3",
+    "@webpresso/agent-kit-session-memory-darwin-arm64": "3.3.3",
+    "@webpresso/agent-kit-session-memory-linux-x64": "3.3.3",
+    "@webpresso/agent-kit-session-memory-linux-arm64": "3.3.3",
+    "@webpresso/agent-kit-session-memory-win32-x64": "3.3.3",
+    "@webpresso/agent-kit-session-memory-win32-arm64": "3.3.3"
   }
 }