@cubis/foundry 0.3.68 → 0.3.70

package/mcp/src/tools/registry.test.ts

@@ -42,9 +42,18 @@ function createTestContext(): ToolRuntimeContext {
         primarySkills: ["flutter-expert"],
         supportingSkills: [],
         artifacts: {
-          codex: { workflowFile: "mobile.md", compatibilityAlias: "$workflow-mobile" },
-          copilot: { workflowFile: "mobile.md", promptFile: "workflow-mobile.prompt.md" },
-          antigravity: { workflowFile: "mobile.md", commandFile: "mobile.toml" },
+          codex: {
+            workflowFile: "mobile.md",
+            compatibilityAlias: "$workflow-mobile",
+          },
+          copilot: {
+            workflowFile: "mobile.md",
+            promptFile: "workflow-mobile.prompt.md",
+          },
+          antigravity: {
+            workflowFile: "mobile.md",
+            commandFile: "mobile.toml",
+          },
           claude: { workflowFile: "mobile.md" },
         },
       },
@@ -77,10 +86,11 @@ describe("tool registry", () => {
     expect(names).toContain("stitch_get_mode");
     expect(names).toContain("stitch_set_profile");
     expect(names).toContain("stitch_get_status");
+    expect(names).toContain("playwright_get_status");
   });
 
-  it("has exactly 14 built-in tools", () => {
-    expect(TOOL_REGISTRY).toHaveLength(14);
+  it("has exactly 15 built-in tools", () => {
+    expect(TOOL_REGISTRY).toHaveLength(15);
   });
 
   it("has no duplicate tool names", () => {
@@ -94,7 +104,9 @@ describe("tool registry", () => {
       expect(entry.name).toBeTruthy();
       expect(entry.description).toBeTruthy();
       expect(entry.schema).toBeTruthy();
-      expect(entry.category).toMatch(/^(skill|route|postman|stitch)$/);
+      expect(entry.category).toMatch(
+        /^(skill|route|postman|stitch|playwright)$/,
+      );
       expect(typeof entry.createHandler).toBe("function");
     }
   });
@@ -128,7 +140,11 @@ describe("tool registry", () => {
       (t) => t.name === "skill_list_categories",
     )!;
     const handler = entry.createHandler(ctx);
-    const result = (await handler({})) as {
+    const result = (await (
+      handler as unknown as (
+        args: Record<string, never>,
+      ) => Promise<{ content: Array<{ text: string }> }>
+    )({})) as {
       content: Array<{ text: string }>;
     };
     const data = JSON.parse(result.content[0].text);
@@ -137,15 +153,17 @@ describe("tool registry", () => {
 
   it("buildRegistrySummary produces correct structure", () => {
     const summary = buildRegistrySummary();
-    expect(summary.totalTools).toBe(14);
+    expect(summary.totalTools).toBe(15);
     expect(summary.categories).toHaveProperty("route");
     expect(summary.categories).toHaveProperty("skill");
     expect(summary.categories).toHaveProperty("postman");
     expect(summary.categories).toHaveProperty("stitch");
+    expect(summary.categories).toHaveProperty("playwright");
     expect(summary.categories.route.tools).toHaveLength(1);
     expect(summary.categories.skill.tools).toHaveLength(7);
     expect(summary.categories.postman.tools).toHaveLength(3);
     expect(summary.categories.stitch.tools).toHaveLength(3);
+    expect(summary.categories.playwright.tools).toHaveLength(1);
   });
 
   it("each schema has a valid .shape property", () => {

package/mcp/src/tools/registry.ts

@@ -12,13 +12,19 @@
  */
 
 import { z } from "zod";
+import type { ToolCallback } from "@modelcontextprotocol/sdk/server/mcp.js";
 import type { VaultManifest } from "../vault/types.js";
 import type { RouteManifest } from "../routes/types.js";
 import type { ConfigScope } from "../cbxConfig/types.js";
 
 // ─── Core types ─────────────────────────────────────────────
 
-export type ToolCategory = "skill" | "route" | "postman" | "stitch";
+export type ToolCategory =
+  | "skill"
+  | "route"
+  | "postman"
+  | "stitch"
+  | "playwright";
 
 export interface ToolRegistryEntry {
   /** Tool name exposed to MCP clients. */
@@ -35,7 +41,7 @@ export interface ToolRegistryEntry {
    */
   createHandler: (
     ctx: ToolRuntimeContext,
-  ) => (args: unknown) => Promise<unknown>;
+  ) => ToolCallback<z.ZodObject<z.ZodRawShape>>;
 }
 
 export interface ToolRuntimeContext {
@@ -146,6 +152,13 @@ import {
   handleStitchGetStatus,
 } from "./stitchGetStatus.js";
 
+import {
+  playwrightGetStatusName,
+  playwrightGetStatusDescription,
+  playwrightGetStatusSchema,
+  handlePlaywrightGetStatus,
+} from "./playwrightGetStatus.js";
+
 // ─── Scope helper ───────────────────────────────────────────
 
 function withDefaultScope(
@@ -335,6 +348,20 @@ export const TOOL_REGISTRY: readonly ToolRegistryEntry[] = [
         >,
       ),
   },
+
+  // ── Playwright tools ──────────────────────────────────────
+  {
+    name: playwrightGetStatusName,
+    description: playwrightGetStatusDescription,
+    schema: playwrightGetStatusSchema,
+    category: "playwright",
+    createHandler: (ctx) => async (args) =>
+      handlePlaywrightGetStatus(
+        withDefaultScope(args, ctx.defaultConfigScope) as z.infer<
+          typeof playwrightGetStatusSchema
+        >,
+      ),
+  },
 ];
 
 // ─── Helpers ────────────────────────────────────────────────

package/mcp/src/tools/routeResolve.ts

@@ -359,7 +359,7 @@ async function fileExists(target: string) {
 
 async function detectLanguageSkillHint() {
   const cwd = process.cwd();
-  const candidates = await fs.readdir(cwd).catch(() => []);
+  const candidates: string[] = await fs.readdir(cwd).catch(() => []);
   const has = (fileName: string) => candidates.includes(fileName);
 
   for (const entry of LANGUAGE_SIGNAL_FILES) {

package/mcp/src/upstream/passthrough.ts

@@ -6,14 +6,16 @@ import { mkdir, readFile, writeFile } from "node:fs/promises";
 import path from "node:path";
 import { Client } from "@modelcontextprotocol/sdk/client/index.js";
 import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
 import {
   parsePostmanState,
   parseStitchState,
+  parsePlaywrightState,
   readEffectiveConfig,
 } from "../cbxConfig/index.js";
 import type { CbxConfig, ConfigScope } from "../cbxConfig/types.js";
 
-type ServiceId = "postman" | "stitch";
+type ServiceId = "postman" | "stitch" | "playwright";
 
 export interface UpstreamToolInfo {
   name: string;
@@ -125,7 +127,10 @@ async function loadCachedCatalogTools({
   }
 }
 
-function getServiceAuth(config: CbxConfig, service: ServiceId): {
+function getServiceAuth(
+  config: CbxConfig,
+  service: ServiceId,
+): {
   mcpUrl: string | null;
   activeProfileName: string | null;
   envVar: string | null;
@@ -133,6 +138,17 @@ function getServiceAuth(config: CbxConfig, service: ServiceId): {
   configured: boolean;
   error?: string;
 } {
+  if (service === "playwright") {
+    const state = parsePlaywrightState(config);
+    return {
+      mcpUrl: state.mcpUrl,
+      activeProfileName: null,
+      envVar: null,
+      headers: {},
+      configured: Boolean(state.mcpUrl),
+    };
+  }
+
   if (service === "postman") {
     const state = parsePostmanState(config);
     const activeProfile = state.activeProfile;
@@ -209,6 +225,42 @@ async function withUpstreamClient<T>({
   }
 }
 
+function isCallToolResult(
+  result: Awaited<ReturnType<Client["callTool"]>>,
+): result is CallToolResult {
+  return Array.isArray(
+    (
+      result as {
+        content?: unknown;
+      }
+    ).content,
+  );
+}
+
+function normalizeUpstreamToolResult(
+  result: Awaited<ReturnType<Client["callTool"]>>,
+): CallToolResult {
+  if (isCallToolResult(result)) {
+    return result;
+  }
+
+  return {
+    content: [
+      {
+        type: "text",
+        text: JSON.stringify(
+          {
+            toolResult: result.toolResult,
+          },
+          null,
+          2,
+        ),
+      },
+    ],
+    _meta: result._meta,
+  };
+}
+
 async function persistCatalog(catalog: UpstreamCatalog): Promise<void> {
   if (!catalog.configPath) return;
   const catalogDir = resolveCatalogDir(catalog.configPath);
@@ -240,6 +292,7 @@ export async function discoverUpstreamCatalogs(
 ): Promise<{
   postman: UpstreamCatalog;
   stitch: UpstreamCatalog;
+  playwright: UpstreamCatalog;
 }> {
   const effective = readEffectiveConfig(scope);
   if (!effective) {
@@ -256,9 +309,14 @@ export async function discoverUpstreamCatalogs(
       discoveryError: "cbx_config.json not found",
     };
     const missingStitch: UpstreamCatalog = { ...missing, service: "stitch" };
+    const missingPlaywright: UpstreamCatalog = {
+      ...missing,
+      service: "playwright",
+    };
     return {
       postman: missing,
       stitch: missingStitch,
+      playwright: missingPlaywright,
     };
   }
 
@@ -331,6 +389,7 @@ export async function discoverUpstreamCatalogs(
   return {
     postman: await discoverOne("postman"),
     stitch: await discoverOne("stitch"),
+    playwright: await discoverOne("playwright"),
   };
 }
 
@@ -344,7 +403,7 @@ export async function callUpstreamTool({
   name: string;
   argumentsValue: Record<string, unknown>;
   scope?: ConfigScope | "auto";
-}) {
+}): Promise<CallToolResult> {
   const effective = readEffectiveConfig(scope);
   if (!effective) {
     throw new Error("cbx_config.json not found");
@@ -360,10 +419,12 @@ export async function callUpstreamTool({
   return withUpstreamClient({
     url: auth.mcpUrl,
     headers: auth.headers,
-    fn: async (client) =>
-      client.callTool({
-        name,
-        arguments: argumentsValue,
-      }),
+    fn: async (client): Promise<CallToolResult> =>
+      normalizeUpstreamToolResult(
+        await client.callTool({
+          name,
+          arguments: argumentsValue,
+        }),
+      ),
   });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cubis/foundry",
-  "version": "0.3.68",
+  "version": "0.3.70",
   "description": "Cubis Foundry CLI for workflow-first AI agent environments",
   "type": "module",
   "bin": {

package/src/cli/core.ts

@@ -217,6 +217,10 @@ const STITCH_SKILL_ID = "stitch";
 const STITCH_MCP_SERVER_ID = "StitchMCP";
 const STITCH_API_KEY_ENV_VAR = "STITCH_API_KEY_DEFAULT";
 const STITCH_MCP_URL = "https://stitch.googleapis.com/mcp";
+const PLAYWRIGHT_SKILL_ID = "playwright";
+const PLAYWRIGHT_MCP_SERVER_ID = "PlaywrightMCP";
+const PLAYWRIGHT_DEFAULT_PORT = 8931;
+const PLAYWRIGHT_MCP_URL = `http://localhost:${PLAYWRIGHT_DEFAULT_PORT}/mcp`;
 const POSTMAN_WORKSPACE_MANUAL_CHOICE = "__postman_workspace_manual__";
 const CBX_CONFIG_FILENAME = "cbx_config.json";
 const CBX_CREDENTIALS_ENV_FILENAME = "credentials.env";
@@ -4719,6 +4723,30 @@ function buildGeminiStitchServer({
   };
 }
 
+function buildVsCodePlaywrightServer({ mcpUrl = PLAYWRIGHT_MCP_URL } = {}) {
+  return {
+    type: "http",
+    url: mcpUrl,
+    headers: {},
+  };
+}
+
+function buildCopilotCliPlaywrightServer({ mcpUrl = PLAYWRIGHT_MCP_URL } = {}) {
+  return {
+    type: "http",
+    url: mcpUrl,
+    headers: {},
+    tools: ["*"],
+  };
+}
+
+function buildGeminiPlaywrightServer({ mcpUrl = PLAYWRIGHT_MCP_URL } = {}) {
+  return {
+    httpUrl: mcpUrl,
+    headers: {},
+  };
+}
+
 function getPostmanApiKeySource({ apiKey, envApiKey }) {
   if (apiKey) return "inline";
   if (envApiKey) return "env";
@@ -5210,6 +5238,7 @@ async function applyPostmanMcpForPlatform({
   stitchMcpUrl,
   includeStitchMcp = false,
   includeFoundryMcp = true,
+  includePlaywrightMcp = false,
   foundryRuntime = "local",
   dryRun = false,
   cwd = process.cwd(),
@@ -5278,6 +5307,9 @@ async function applyPostmanMcpForPlatform({
             mcpUrl: stitchMcpUrl,
           });
         }
+        if (includePlaywrightMcp) {
+          mcpServers[PLAYWRIGHT_MCP_SERVER_ID] = buildGeminiPlaywrightServer();
+        }
         next.mcpServers = mcpServers;
         return next;
       },
@@ -5324,6 +5356,10 @@ async function applyPostmanMcpForPlatform({
           } else {
             delete mcpServers[FOUNDRY_MCP_SERVER_ID];
           }
+          if (includePlaywrightMcp) {
+            mcpServers[PLAYWRIGHT_MCP_SERVER_ID] =
+              buildCopilotCliPlaywrightServer();
+          }
           next.mcpServers = mcpServers;
           return next;
         }
@@ -5350,6 +5386,9 @@ async function applyPostmanMcpForPlatform({
         } else {
           delete servers[FOUNDRY_MCP_SERVER_ID];
         }
+        if (includePlaywrightMcp) {
+          servers[PLAYWRIGHT_MCP_SERVER_ID] = buildVsCodePlaywrightServer();
+        }
         next.servers = servers;
         return next;
       },
@@ -5401,6 +5440,9 @@ async function applyPostmanMcpForPlatform({
           } else {
             delete servers[FOUNDRY_MCP_SERVER_ID];
           }
+          if (includePlaywrightMcp) {
+            servers[PLAYWRIGHT_MCP_SERVER_ID] = buildVsCodePlaywrightServer();
+          }
           next.servers = servers;
           return next;
         },
@@ -5529,6 +5571,57 @@ async function applyPostmanMcpForPlatform({
     };
   }
 
+  if (platform === "claude") {
+    const claudeConfigPath =
+      mcpScope === "global"
+        ? path.join(os.homedir(), ".claude", "mcp.json")
+        : path.join(workspaceRoot, ".mcp.json");
+    const result = await upsertJsonObjectFile({
+      targetPath: claudeConfigPath,
+      updater: (existing) => {
+        const next = { ...existing };
+        const mcpServers =
+          next.mcpServers &&
+          typeof next.mcpServers === "object" &&
+          !Array.isArray(next.mcpServers)
+            ? { ...next.mcpServers }
+            : {};
+        if (includeFoundryMcp) {
+          if (normalizedFoundryRuntime === "docker") {
+            mcpServers[FOUNDRY_MCP_SERVER_ID] = {
+              type: "url",
+              url: buildFoundryDockerUrl({ port: foundryDockerPort }),
+            };
+          } else {
+            mcpServers[FOUNDRY_MCP_SERVER_ID] = {
+              type: "stdio",
+              command: FOUNDRY_MCP_COMMAND,
+              args: buildFoundryServeArgs({ scope: foundryScope }),
+            };
+          }
+        } else {
+          delete mcpServers[FOUNDRY_MCP_SERVER_ID];
+        }
+        if (includePlaywrightMcp) {
+          mcpServers[PLAYWRIGHT_MCP_SERVER_ID] = {
+            type: "url",
+            url: PLAYWRIGHT_MCP_URL,
+          };
+        }
+        next.mcpServers = mcpServers;
+        return next;
+      },
+      dryRun,
+    });
+    return {
+      kind: "claude-mcp",
+      scope: mcpScope,
+      path: claudeConfigPath,
+      action: result.action,
+      warnings: [...warnings, ...result.warnings],
+    };
+  }
+
   return {
     kind: "unknown",
     scope: mcpScope,
@@ -5606,10 +5699,7 @@ async function resolvePostmanInstallSelection({
     : null;
   let workspaceSelectionSource = hasWorkspaceOption ? "option" : "none";
   const requestedMcpScope = options.mcpScope
-    ? coerceWorkspaceOnlyMcpScope(
-        options.mcpScope,
-        "--mcp-scope",
-      )
+    ? coerceWorkspaceOnlyMcpScope(options.mcpScope, "--mcp-scope")
     : null;
   let mcpScope = requestedMcpScope?.scope || "project";
   const warnings = [];
@@ -6057,6 +6147,7 @@ async function configurePostmanInstallArtifacts({
         stitchMcpUrl: effectiveStitchMcpUrl,
         includeStitchMcp: shouldInstallStitch,
         includeFoundryMcp: postmanSelection.foundryMcpEnabled,
+        includePlaywrightMcp: postmanSelection.playwrightEnabled ?? false,
         foundryRuntime: postmanSelection.effectiveMcpRuntime || "local",
         dryRun,
         cwd,
@@ -6167,6 +6258,7 @@ async function applyPostmanConfigArtifacts({
     POSTMAN_API_KEY_ENV_VAR;
   const postmanMcpUrl = postmanState.mcpUrl || POSTMAN_MCP_URL;
   const stitchEnabled = Boolean(stitchState);
+  const playwrightEnabled = Boolean(configValue?.playwright);
   const stitchApiKeyEnvVar =
     normalizePostmanApiKey(stitchState?.apiKeyEnvVar) || STITCH_API_KEY_ENV_VAR;
   const stitchMcpUrl = stitchState?.mcpUrl || STITCH_MCP_URL;
@@ -6239,6 +6331,7 @@ async function applyPostmanConfigArtifacts({
       stitchMcpUrl,
       includeStitchMcp: stitchEnabled,
       includeFoundryMcp: true,
+      includePlaywrightMcp: playwrightEnabled ?? false,
       foundryRuntime,
       dryRun,
       cwd,
@@ -8239,7 +8332,9 @@ async function performWorkflowInstall(
     cancelled: false,
     cwd,
     scope,
-    warnings: requestedInstallScope.warning ? [requestedInstallScope.warning] : [],
+    warnings: requestedInstallScope.warning
+      ? [requestedInstallScope.warning]
+      : [],
     ruleScope,
     dryRun,
     platform,

package/src/cli/init/execute.ts

@@ -23,12 +23,20 @@ export function buildInitExecutionPlan({
   const planItems: InitExecutionPlanItem[] = [];
   const wantsPostman = hasMcpSelection(selections.selectedMcps, "postman");
   const wantsStitch = hasMcpSelection(selections.selectedMcps, "stitch");
-  const wantsFoundry = hasMcpSelection(selections.selectedMcps, "cubis-foundry");
+  const wantsFoundry = hasMcpSelection(
+    selections.selectedMcps,
+    "cubis-foundry",
+  );
+  const wantsPlaywright = hasMcpSelection(
+    selections.selectedMcps,
+    "playwright",
+  );
 
   for (const platform of selections.platforms) {
     const stitchSupported = platform === "antigravity";
     const stitchEnabled = wantsStitch && stitchSupported;
-    const hasAnyMcp = wantsPostman || stitchEnabled || wantsFoundry;
+    const hasAnyMcp =
+      wantsPostman || stitchEnabled || wantsFoundry || wantsPlaywright;
     const warnings: string[] = [];
     if (wantsStitch && !stitchSupported) {
       warnings.push(
@@ -48,10 +56,11 @@ export function buildInitExecutionPlan({
       target,
       postman: wantsPostman,
       stitch: stitchEnabled,
+      playwright: wantsPlaywright,
       stitchDefaultForAntigravity: false,
       mcpScope: selections.mcpScope,
       foundryMcp: wantsFoundry,
-      mcpToolSync: wantsPostman || stitchEnabled,
+      mcpToolSync: wantsPostman || stitchEnabled || wantsPlaywright,
       mcpRuntime: hasAnyMcp ? selections.mcpRuntime : "local",
       mcpFallback: "local",
       mcpBuildLocal: hasAnyMcp ? selections.mcpBuildLocal : false,
@@ -83,9 +92,9 @@ export function formatInitSummary(selections: InitWizardSelections) {
     `- Skill profile: ${selections.skillProfile}`,
     `- Skills scope: ${selections.skillsScope}`,
     `- MCP scope: ${selections.mcpScope}`,
-    `- MCP runtime: ${selections.mcpRuntime}${selections.mcpRuntime === "docker" ? selections.mcpBuildLocal ? " (build local image)" : " (pull image)" : ""}`,
+    `- MCP runtime: ${selections.mcpRuntime}${selections.mcpRuntime === "docker" ? (selections.mcpBuildLocal ? " (build local image)" : " (pull image)") : ""}`,
     `- MCP selections: ${selections.selectedMcps.length > 0 ? selections.selectedMcps.join(", ") : "(none)"}`,
     `- Postman mode: ${postmanSelected ? selections.postmanMode : "(not selected)"}`,
-    `- Postman workspace: ${postmanSelected ? selections.postmanWorkspaceId === null ? "null" : selections.postmanWorkspaceId : "(not selected)"}`,
+    `- Postman workspace: ${postmanSelected ? (selections.postmanWorkspaceId === null ? "null" : selections.postmanWorkspaceId) : "(not selected)"}`,
   ].join("\n");
 }

package/src/cli/init/prompts.ts

@@ -90,6 +90,11 @@ export async function promptInitMcpSelection(defaultMcps: InitMcpId[]) {
         value: "stitch",
         checked: defaultMcps.includes("stitch"),
       },
+      {
+        name: "Playwright",
+        value: "playwright",
+        checked: defaultMcps.includes("playwright"),
+      },
     ],
   });
 }

package/src/cli/init/types.ts

@@ -1,6 +1,6 @@
 export type InitScope = "project" | "global";
 export type InitSkillProfile = "core" | "web-backend" | "full";
-export type InitMcpId = "cubis-foundry" | "postman" | "stitch";
+export type InitMcpId = "cubis-foundry" | "postman" | "stitch" | "playwright";
 export type InitPostmanMode = "full" | "minimal";
 export type InitPlatformId = "codex" | "antigravity" | "copilot" | "claude";
 export type InitMcpRuntime = "local" | "docker";