@superblocksteam/gateway 2.0.161-next.0 → 2.0.162-next.0

package/dist/transports/mcp/instructions/tools/get-integration-metadata.d.ts

@@ -0,0 +1,2 @@
+import type { ToolResult } from "../result.js";
+export declare function instructGetIntegrationMetadata(result: ToolResult): string | undefined;

package/dist/transports/mcp/instructions/tools/get-integration-metadata.js

@@ -0,0 +1,13 @@
+export function instructGetIntegrationMetadata(result) {
+    if (result.code === "integration_not_supported") {
+        return "This integration's plugin type can't be introspected by this tool. Ask the user directly what data it exposes, or proceed without inspecting schema.";
+    }
+    const entries = result.value.entries;
+    if (result.value.totalCount === 0 &&
+        Array.isArray(entries) &&
+        entries.length === 0) {
+        return "No columns/tables matched that search term. Retry with a narrower or different `search`, or omit it to see everything, before concluding the integration has no usable data.";
+    }
+    return undefined;
+}
+//# sourceMappingURL=get-integration-metadata.js.map

package/dist/transports/mcp/instructions/tools/get-integration-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-integration-metadata.js","sourceRoot":"","sources":["../../../../../src/transports/mcp/instructions/tools/get-integration-metadata.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,8BAA8B,CAC5C,MAAkB;IAElB,IAAI,MAAM,CAAC,IAAI,KAAK,2BAA2B,EAAE,CAAC;QAChD,OAAO,sJAAsJ,CAAC;IAChK,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC;IACrC,IACE,MAAM,CAAC,KAAK,CAAC,UAAU,KAAK,CAAC;QAC7B,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QACtB,OAAO,CAAC,MAAM,KAAK,CAAC,EACpB,CAAC;QACD,OAAO,8KAA8K,CAAC;IACxL,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/transports/mcp/instructions/tools/index.d.ts

@@ -0,0 +1,7 @@
+import type { ClientProfile } from "../../client-presentation.js";
+import type { ToolName } from "../../tool-names.js";
+import type { ToolResult } from "../result.js";
+/** One tool's whole rule set: its result in, the agent's next step out. */
+export type Instruct = (result: ToolResult, profile: ClientProfile) => string | undefined;
+/** Tools absent from this table send no instructions. */
+export declare const INSTRUCTIONS: Partial<Record<ToolName, Instruct>>;

package/dist/transports/mcp/instructions/tools/index.js

@@ -0,0 +1,31 @@
+import { instructAskUser } from "./ask-user.js";
+import { instructBuildApp, instructGetPreviewStatus } from "./build-app.js";
+import { instructCheckAppProgress } from "./check-app-progress.js";
+import { instructCheckPublishProgress } from "./check-publish-progress.js";
+import { APP_SHARING_CHOICE } from "./copy.js";
+import { instructCreateIntegration } from "./create-integration.js";
+import { instructEditApp } from "./edit-app.js";
+import { instructGetApp } from "./get-app.js";
+import { instructGetIntegrationMetadata } from "./get-integration-metadata.js";
+import { instructPublishApp } from "./publish-app.js";
+import { instructStartApp } from "./start-app.js";
+import { instructUploadArtifact } from "./upload-artifact.js";
+/** Tools absent from this table send no instructions. */
+export const INSTRUCTIONS = {
+    ask_user: instructAskUser,
+    build_app: instructBuildApp,
+    check_app_progress: instructCheckAppProgress,
+    check_publish_progress: instructCheckPublishProgress,
+    create_integration: instructCreateIntegration,
+    edit_app: instructEditApp,
+    get_app: instructGetApp,
+    get_application_access: () => APP_SHARING_CHOICE,
+    get_application_deployment_history: () => APP_SHARING_CHOICE,
+    get_application_summary: () => APP_SHARING_CHOICE,
+    get_integration_metadata: instructGetIntegrationMetadata,
+    get_preview_status: instructGetPreviewStatus,
+    publish_app: instructPublishApp,
+    start_app: instructStartApp,
+    upload_artifact: instructUploadArtifact,
+};
+//# sourceMappingURL=index.js.map

package/dist/transports/mcp/instructions/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/transports/mcp/instructions/tools/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAC5E,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,4BAA4B,EAAE,MAAM,6BAA6B,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,8BAA8B,EAAE,MAAM,+BAA+B,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAQ9D,yDAAyD;AACzD,MAAM,CAAC,MAAM,YAAY,GAAwC;IAC/D,QAAQ,EAAE,eAAe;IACzB,SAAS,EAAE,gBAAgB;IAC3B,kBAAkB,EAAE,wBAAwB;IAC5C,sBAAsB,EAAE,4BAA4B;IACpD,kBAAkB,EAAE,yBAAyB;IAC7C,QAAQ,EAAE,eAAe;IACzB,OAAO,EAAE,cAAc;IACvB,sBAAsB,EAAE,GAAG,EAAE,CAAC,kBAAkB;IAChD,kCAAkC,EAAE,GAAG,EAAE,CAAC,kBAAkB;IAC5D,uBAAuB,EAAE,GAAG,EAAE,CAAC,kBAAkB;IACjD,wBAAwB,EAAE,8BAA8B;IACxD,kBAAkB,EAAE,wBAAwB;IAC5C,WAAW,EAAE,kBAAkB;IAC/B,SAAS,EAAE,gBAAgB;IAC3B,eAAe,EAAE,sBAAsB;CACxC,CAAC"}

package/dist/transports/mcp/instructions/tools/publish-app.d.ts

@@ -0,0 +1,3 @@
+import type { ClientProfile } from "../../client-presentation.js";
+import type { ToolResult } from "../result.js";
+export declare function instructPublishApp(result: ToolResult, profile: ClientProfile): string | undefined;

package/dist/transports/mcp/instructions/tools/publish-app.js

@@ -0,0 +1,23 @@
+import { instructPublishDetails } from "./copy.js";
+export function instructPublishApp(result, profile) {
+    const instructions = resultInstructions(result);
+    const navigation = instructPublishDetails(result, profile);
+    if (!navigation) {
+        return instructions;
+    }
+    return instructions ? `${navigation}\n\n${instructions}` : navigation;
+}
+function resultInstructions(result) {
+    if (result.status === "publishing") {
+        const url = result.value.publishDetailsUrl;
+        const link = typeof url === "string" && url
+            ? ` and include ${url} in that message`
+            : "";
+        return `Superblocks has started the publish. Tell the user the publish is rolling out${link}, then call \`check_publish_progress\` until status is \`deployed\`. Do not call \`publish_app\` again.`;
+    }
+    if (result.code === "publish_needs_acknowledgement") {
+        return "A policy gate requires explicit acknowledgement before this can roll out. Tell the user what the gate flagged and ask whether to proceed, rather than retrying automatically.";
+    }
+    return undefined;
+}
+//# sourceMappingURL=publish-app.js.map

package/dist/transports/mcp/instructions/tools/publish-app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish-app.js","sourceRoot":"","sources":["../../../../../src/transports/mcp/instructions/tools/publish-app.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAEnD,MAAM,UAAU,kBAAkB,CAChC,MAAkB,EAClB,OAAsB;IAEtB,MAAM,YAAY,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAChD,MAAM,UAAU,GAAG,sBAAsB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3D,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,OAAO,YAAY,CAAC,CAAC,CAAC,GAAG,UAAU,OAAO,YAAY,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC;AACxE,CAAC;AAED,SAAS,kBAAkB,CAAC,MAAkB;IAC5C,IAAI,MAAM,CAAC,MAAM,KAAK,YAAY,EAAE,CAAC;QACnC,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAAC;QAC3C,MAAM,IAAI,GACR,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG;YAC5B,CAAC,CAAC,gBAAgB,GAAG,kBAAkB;YACvC,CAAC,CAAC,EAAE,CAAC;QACT,OAAO,gFAAgF,IAAI,yGAAyG,CAAC;IACvM,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,+BAA+B,EAAE,CAAC;QACpD,OAAO,+KAA+K,CAAC;IACzL,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/transports/mcp/instructions/tools/start-app.d.ts

@@ -0,0 +1,3 @@
+import type { ClientProfile } from "../../client-presentation.js";
+import type { ToolResult } from "../result.js";
+export declare function instructStartApp(result: ToolResult, profile: ClientProfile): string | undefined;

package/dist/transports/mcp/instructions/tools/start-app.js

@@ -0,0 +1,22 @@
+import { REPLACE_WEDGED_APP, RETRY_UNAVAILABLE_LIVE_EDIT, buildingFollowUp, } from "./copy.js";
+export function instructStartApp(result, profile) {
+    if (result.pendingAction === "start_new_app") {
+        return REPLACE_WEDGED_APP;
+    }
+    if (result.code === "replacement_not_allowed") {
+        return "`replacesApplicationId` can only be used once, immediately after a `start_new_app` pendingAction. Call `check_app_progress` on the original application instead of retrying start_app.";
+    }
+    if (result.code === "live_edit_unavailable" &&
+        result.pendingAction === "retry_build") {
+        return RETRY_UNAVAILABLE_LIVE_EDIT;
+    }
+    // No `start_new_app` to recover with: this call was already the replacement.
+    if (result.code === "live_edit_unavailable") {
+        return "Superblocks could not start the replacement application's live-edit session. One fresh application has already been tried, so do not create another application or retry this build. Stop and report that Superblocks' live-edit service needs recovery.";
+    }
+    if (result.status === "building") {
+        return buildingFollowUp(profile);
+    }
+    return undefined;
+}
+//# sourceMappingURL=start-app.js.map

package/dist/transports/mcp/instructions/tools/start-app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-app.js","sourceRoot":"","sources":["../../../../../src/transports/mcp/instructions/tools/start-app.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,kBAAkB,EAClB,2BAA2B,EAC3B,gBAAgB,GACjB,MAAM,WAAW,CAAC;AAEnB,MAAM,UAAU,gBAAgB,CAC9B,MAAkB,EAClB,OAAsB;IAEtB,IAAI,MAAM,CAAC,aAAa,KAAK,eAAe,EAAE,CAAC;QAC7C,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,yBAAyB,EAAE,CAAC;QAC9C,OAAO,wLAAwL,CAAC;IAClM,CAAC;IACD,IACE,MAAM,CAAC,IAAI,KAAK,uBAAuB;QACvC,MAAM,CAAC,aAAa,KAAK,aAAa,EACtC,CAAC;QACD,OAAO,2BAA2B,CAAC;IACrC,CAAC;IACD,6EAA6E;IAC7E,IAAI,MAAM,CAAC,IAAI,KAAK,uBAAuB,EAAE,CAAC;QAC5C,OAAO,0PAA0P,CAAC;IACpQ,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QACjC,OAAO,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/transports/mcp/instructions/tools/upload-artifact.d.ts

@@ -0,0 +1,2 @@
+import type { ToolResult } from "../result.js";
+export declare function instructUploadArtifact(result: ToolResult): string | undefined;

package/dist/transports/mcp/instructions/tools/upload-artifact.js

@@ -0,0 +1,13 @@
+export function instructUploadArtifact(result) {
+    if (result.code === "import_zip_too_large") {
+        return "This file is over the 50 MB cap. Ask the user for a smaller file or, for imports, a smaller source export without dependencies, build output, secrets, or production data. Do not replace the source artifact with prose or silently omit source files and assets.";
+    }
+    if (result.code === "import_file_unsupported") {
+        return "Binary content was sent through `files`, which only accepts text. Re-send this file via `filePath` instead - the gateway reads the bytes itself.";
+    }
+    if (result.ok) {
+        return "Show the completed upload summary to the user before calling another tool. Pass this result's `artifact` unchanged into `start_app` or `edit_app`'s `artifacts` field. Do not re-upload on a retry - reuse this same artifact.";
+    }
+    return undefined;
+}
+//# sourceMappingURL=upload-artifact.js.map

package/dist/transports/mcp/instructions/tools/upload-artifact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-artifact.js","sourceRoot":"","sources":["../../../../../src/transports/mcp/instructions/tools/upload-artifact.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,sBAAsB,CAAC,MAAkB;IACvD,IAAI,MAAM,CAAC,IAAI,KAAK,sBAAsB,EAAE,CAAC;QAC3C,OAAO,oQAAoQ,CAAC;IAC9Q,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,yBAAyB,EAAE,CAAC;QAC9C,OAAO,kJAAkJ,CAAC;IAC5J,CAAC;IACD,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;QACd,OAAO,gOAAgO,CAAC;IAC1O,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/transports/mcp/mcp-app-brand-css.d.ts

@@ -0,0 +1 @@
+export declare const MCP_APP_BRAND_CSS = "\n    :root {\n      color-scheme: light dark;\n      --sb-app-background: var(\n        --color-background-primary,\n        light-dark(#ffffff, #1b1c1f)\n      );\n      --sb-app-background-subtle: var(\n        --color-background-secondary,\n        light-dark(#f9fafb, #24272b)\n      );\n      --sb-app-background-hover: var(\n        --color-background-tertiary,\n        light-dark(#f3f4f6, #2f3437)\n      );\n      --sb-app-background-inverse: var(\n        --color-background-inverse,\n        light-dark(#121517, #f9fafb)\n      );\n      --sb-app-text: var(\n        --color-text-primary,\n        light-dark(#121517, #f9fafb)\n      );\n      --sb-app-text-secondary: var(\n        --color-text-secondary,\n        light-dark(#5a6272, #c6cad2)\n      );\n      --sb-app-text-tertiary: var(\n        --color-text-tertiary,\n        light-dark(#6b7280, #a4aab7)\n      );\n      --sb-app-text-inverse: var(\n        --color-text-inverse,\n        light-dark(#ffffff, #121517)\n      );\n      --sb-app-border: var(\n        --color-border-primary,\n        light-dark(#e8eaed, #454d5f)\n      );\n      --sb-app-ring: var(\n        --color-ring-primary,\n        light-dark(#0077b6, #27bbff)\n      );\n      --sb-app-info-background: var(\n        --color-background-info,\n        light-dark(#e6f5ff, #083a50)\n      );\n      --sb-app-info-text: var(\n        --color-text-info,\n        light-dark(#00679e, #7dd3fc)\n      );\n      --sb-app-info-border: var(\n        --color-border-info,\n        light-dark(#c2e7ff, #075985)\n      );\n      --sb-app-success-background: var(\n        --color-background-success,\n        light-dark(#e8f8ef, #0a3926)\n      );\n      --sb-app-success-text: var(\n        --color-text-success,\n        light-dark(#087a43, #6ee7b7)\n      );\n      --sb-app-success-border: var(\n        --color-border-success,\n        light-dark(#b8e8cf, #087a43)\n      );\n      --sb-app-warning-background: var(\n        --color-background-warning,\n        light-dark(#fff7e6, #49350a)\n      );\n      --sb-app-warning-text: var(\n        --color-text-warning,\n        light-dark(#946200, #fcd34d)\n      );\n      --sb-app-warning-border: var(\n        --color-border-warning,\n        light-dark(#f5d996, #946200)\n      );\n      --sb-app-danger-background: var(\n        --color-background-danger,\n        light-dark(#fff1f1, #4a1d1d)\n      );\n      --sb-app-danger-text: var(\n        --color-text-danger,\n        light-dark(#c54141, #fca5a5)\n      );\n      --sb-app-danger-border: var(\n        --color-border-danger,\n        light-dark(#ffcaca, #c54141)\n      );\n    }\n    * {\n      box-sizing: border-box;\n    }\n    body {\n      min-width: 0;\n      margin: 0;\n      overflow-x: hidden;\n      background: transparent;\n      color: var(--sb-app-text);\n      font-family: var(--font-sans, system-ui, -apple-system, sans-serif);\n      font-size: var(--font-text-sm-size, 13px);\n      line-height: var(--font-text-sm-line-height, 1.45);\n    }\n    .card {\n      display: flex;\n      min-width: 0;\n      flex-direction: column;\n      gap: 12px;\n      padding: 16px;\n      border: var(--border-width-regular, 1px) solid var(--sb-app-border);\n      border-radius: var(--border-radius-lg, 12px);\n      background: var(--sb-app-background);\n      box-shadow: var(--shadow-sm, 0 1px 2px rgba(18, 21, 23, 0.08));\n    }\n    h1,\n    .meta,\n    .note {\n      min-width: 0;\n      overflow-wrap: anywhere;\n    }\n    .note:empty {\n      position: absolute;\n    }\n    button,\n    textarea {\n      font: inherit;\n    }\n    button {\n      appearance: none;\n      min-width: 0;\n      padding: 8px 12px;\n      border: var(--border-width-regular, 1px) solid var(--sb-app-border);\n      border-radius: var(--border-radius-md, 8px);\n      background: var(--sb-app-background-subtle);\n      color: var(--sb-app-text);\n      font-weight: var(--font-weight-medium, 500);\n      line-height: var(--font-text-sm-line-height, 1.45);\n      cursor: pointer;\n    }\n    button:hover:not(:disabled) {\n      background: var(--sb-app-background-hover);\n    }\n    .button-primary {\n      border-color: var(--sb-app-background-inverse);\n      background: var(--sb-app-background-inverse);\n      color: var(--sb-app-text-inverse);\n    }\n    .button-primary:hover:not(:disabled) {\n      border-color: var(--sb-app-background-inverse);\n      background: var(--sb-app-background-inverse);\n    }\n    button:focus-visible,\n    textarea:focus-visible,\n    a:focus-visible {\n      outline: 2px solid var(--sb-app-ring);\n      outline-offset: 2px;\n    }\n    button:disabled {\n      opacity: 0.48;\n      cursor: not-allowed;\n    }\n    .actions {\n      min-width: 0;\n    }\n    .actions > button {\n      overflow-wrap: anywhere;\n    }\n    @media (max-width: 360px) {\n      .actions {\n        flex-direction: column;\n        flex-wrap: nowrap;\n      }\n      .actions > button {\n        width: 100%;\n      }\n    }\n";

package/dist/transports/mcp/mcp-app-brand-css.js

@@ -0,0 +1,180 @@
+export const MCP_APP_BRAND_CSS = `
+    :root {
+      color-scheme: light dark;
+      --sb-app-background: var(
+        --color-background-primary,
+        light-dark(#ffffff, #1b1c1f)
+      );
+      --sb-app-background-subtle: var(
+        --color-background-secondary,
+        light-dark(#f9fafb, #24272b)
+      );
+      --sb-app-background-hover: var(
+        --color-background-tertiary,
+        light-dark(#f3f4f6, #2f3437)
+      );
+      --sb-app-background-inverse: var(
+        --color-background-inverse,
+        light-dark(#121517, #f9fafb)
+      );
+      --sb-app-text: var(
+        --color-text-primary,
+        light-dark(#121517, #f9fafb)
+      );
+      --sb-app-text-secondary: var(
+        --color-text-secondary,
+        light-dark(#5a6272, #c6cad2)
+      );
+      --sb-app-text-tertiary: var(
+        --color-text-tertiary,
+        light-dark(#6b7280, #a4aab7)
+      );
+      --sb-app-text-inverse: var(
+        --color-text-inverse,
+        light-dark(#ffffff, #121517)
+      );
+      --sb-app-border: var(
+        --color-border-primary,
+        light-dark(#e8eaed, #454d5f)
+      );
+      --sb-app-ring: var(
+        --color-ring-primary,
+        light-dark(#0077b6, #27bbff)
+      );
+      --sb-app-info-background: var(
+        --color-background-info,
+        light-dark(#e6f5ff, #083a50)
+      );
+      --sb-app-info-text: var(
+        --color-text-info,
+        light-dark(#00679e, #7dd3fc)
+      );
+      --sb-app-info-border: var(
+        --color-border-info,
+        light-dark(#c2e7ff, #075985)
+      );
+      --sb-app-success-background: var(
+        --color-background-success,
+        light-dark(#e8f8ef, #0a3926)
+      );
+      --sb-app-success-text: var(
+        --color-text-success,
+        light-dark(#087a43, #6ee7b7)
+      );
+      --sb-app-success-border: var(
+        --color-border-success,
+        light-dark(#b8e8cf, #087a43)
+      );
+      --sb-app-warning-background: var(
+        --color-background-warning,
+        light-dark(#fff7e6, #49350a)
+      );
+      --sb-app-warning-text: var(
+        --color-text-warning,
+        light-dark(#946200, #fcd34d)
+      );
+      --sb-app-warning-border: var(
+        --color-border-warning,
+        light-dark(#f5d996, #946200)
+      );
+      --sb-app-danger-background: var(
+        --color-background-danger,
+        light-dark(#fff1f1, #4a1d1d)
+      );
+      --sb-app-danger-text: var(
+        --color-text-danger,
+        light-dark(#c54141, #fca5a5)
+      );
+      --sb-app-danger-border: var(
+        --color-border-danger,
+        light-dark(#ffcaca, #c54141)
+      );
+    }
+    * {
+      box-sizing: border-box;
+    }
+    body {
+      min-width: 0;
+      margin: 0;
+      overflow-x: hidden;
+      background: transparent;
+      color: var(--sb-app-text);
+      font-family: var(--font-sans, system-ui, -apple-system, sans-serif);
+      font-size: var(--font-text-sm-size, 13px);
+      line-height: var(--font-text-sm-line-height, 1.45);
+    }
+    .card {
+      display: flex;
+      min-width: 0;
+      flex-direction: column;
+      gap: 12px;
+      padding: 16px;
+      border: var(--border-width-regular, 1px) solid var(--sb-app-border);
+      border-radius: var(--border-radius-lg, 12px);
+      background: var(--sb-app-background);
+      box-shadow: var(--shadow-sm, 0 1px 2px rgba(18, 21, 23, 0.08));
+    }
+    h1,
+    .meta,
+    .note {
+      min-width: 0;
+      overflow-wrap: anywhere;
+    }
+    .note:empty {
+      position: absolute;
+    }
+    button,
+    textarea {
+      font: inherit;
+    }
+    button {
+      appearance: none;
+      min-width: 0;
+      padding: 8px 12px;
+      border: var(--border-width-regular, 1px) solid var(--sb-app-border);
+      border-radius: var(--border-radius-md, 8px);
+      background: var(--sb-app-background-subtle);
+      color: var(--sb-app-text);
+      font-weight: var(--font-weight-medium, 500);
+      line-height: var(--font-text-sm-line-height, 1.45);
+      cursor: pointer;
+    }
+    button:hover:not(:disabled) {
+      background: var(--sb-app-background-hover);
+    }
+    .button-primary {
+      border-color: var(--sb-app-background-inverse);
+      background: var(--sb-app-background-inverse);
+      color: var(--sb-app-text-inverse);
+    }
+    .button-primary:hover:not(:disabled) {
+      border-color: var(--sb-app-background-inverse);
+      background: var(--sb-app-background-inverse);
+    }
+    button:focus-visible,
+    textarea:focus-visible,
+    a:focus-visible {
+      outline: 2px solid var(--sb-app-ring);
+      outline-offset: 2px;
+    }
+    button:disabled {
+      opacity: 0.48;
+      cursor: not-allowed;
+    }
+    .actions {
+      min-width: 0;
+    }
+    .actions > button {
+      overflow-wrap: anywhere;
+    }
+    @media (max-width: 360px) {
+      .actions {
+        flex-direction: column;
+        flex-wrap: nowrap;
+      }
+      .actions > button {
+        width: 100%;
+      }
+    }
+`;
+//# sourceMappingURL=mcp-app-brand-css.js.map

package/dist/transports/mcp/mcp-app-brand-css.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-app-brand-css.js","sourceRoot":"","sources":["../../../src/transports/mcp/mcp-app-brand-css.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkLhC,CAAC"}

package/dist/transports/mcp/mount.d.ts

@@ -1,9 +1,22 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import type { AppDeps } from "../../deps.js";
+import { type EditorDocumentProbe } from "./editor-document-probe.js";
+/**
+ * Told to the model on connect, so it can match what a user actually says
+ * against these tools.
+ *
+ * People refer to this one system as the product and builder ("Superblocks")
+ * or by an older name for that same builder ("Clark"). Listing that accepted
+ * alias here is what lets "get Clark to build me a to-do app" reach
+ * `start_app`. Recognizing a name and using it are different things: the alias
+ * is input-only, because a client that reads "Clark" here repeats it back and
+ * reintroduces the retired name to the user.
+ */
+export declare const SERVER_INSTRUCTIONS = "Superblocks builds, edits, and publishes internal web applications. Prompts sent through these tools are handed to Superblocks, which writes the application code in a live-edit session.\n\nName the builder \"Superblocks\" in every word you write. Users sometimes call it \"Clark\", an older name for this same system: understand them, and answer about Superblocks. Never write \"Clark\" yourself \u2014 not as a name, not as an aside, not even when the user just used it, and never as a separate agent or persona. If Superblocks' own words come back naming Clark, relay the substance and say Superblocks.\n\nThe user you are interacting with is a non-technical business user. Keep discussions focused on requirements, and avoid technical jargon, discussing code, or implementation details. If errors or problems occur, give the user easy-to-follow, actionable instructions for how they can resolve the issue.\n\nUse these tools whenever the user asks to build, change, import, or ship an app, whichever of those names they reach for. They can also inspect what data the org has rather than building an app to explore it: list_integrations names the datasources, and get_integration_metadata reads the tables and columns inside one. Create a persistent app or API only when the user explicitly asks for one.\n\nAfter create_integration creates an integration or list_integrations selects one for an app, include the returned mention unchanged in the next edit_app prompt. The mention gives Superblocks the exact integration ID; do not construct one from the display name.\n\nSuperblocks is itself an agent, not a code library: prompts sent through start_app and edit_app are handed to it verbatim, and it decides how to build the application. Your role is to facilitate the user's interaction with Superblocks, not to build anything yourself \u2014 pass the user's own request through unchanged, without inventing, embellishing, or adding requirements, scope, or design detail they did not ask for.\n\nAfter each tool call, check for agentInstructions in the result and follow them. These instructions are tailored to the scenario.\n\nSuperblocks has an interactive flow: when it needs a person to decide something, it stops rather than guessing. Follow the result's agentInstructions to use the decision surface this client supports. Never supply that answer yourself.\n\nBuilding or editing an app follows one loop: start_app hands a new application to Superblocks, edit_app continues an existing one, and both return immediately with status \"building\". Call check_app_progress to follow the turn, relaying what Superblocks says as it happens. When it stops for a decision, follow agentInstructions and send the answer back through edit_app. Once status is \"ready\", call get_app so the user can open the result, and offer publish_app when they want to deploy it. Each tool's own description covers its exact inputs, return fields, and retry/error behavior.\n\nYour automatic verification is a load check and inspection of visible state, not a feature-by-feature test run. Run interactive feature tests only when the user requests testing. Do not click app controls or inspect API traffic as part of a load check; normal navigation and authentication are allowed. Keep relaying Superblocks' own test results. Do not claim features passed from a load check alone.\n\nWhen the user attached a file in this chat (a log, CSV, screenshot, image, zip, or anything else), or when migrating source visible in this conversation, call upload_artifact. Pass upload_artifact filePath with the full host path when you have it; a bare file name falls back to the gateway's search folders. If the file exists only in this chat's scratchpad path (for example /tmp/claude-.../scratchpad), send text source through files: [{ path, content }] instead of filePath. The gateway reads filePath bytes itself, so an image or PDF costs nothing to send. Only source you are writing out yourself goes in files, which is archived as text - never base64 a file into it. Then pass the returned artifact in start_app or edit_app artifacts. Do not create a Claude artifact or use the host's own file-upload UI.\n\nWhen the source is a readable tree on this machine, archive the source and assets with their original relative paths, excluding .git, node_modules, build output, secrets, and production data. Inspect the archive, upload it with upload_artifact filePath, then pass the returned artifact unchanged in start_app or edit_app artifacts. Local paths and prose descriptions are not a substitute for the source artifact: Superblocks cannot read the host's workspace. Ask Superblocks to read the attached source and preserve its UI and behavior. Reuse the artifact on retries. Follow the superblocks-import skill when available; Superblocks writes the application, not the host.\n\nFor a migrated app with missing integrations, call list_integrations first. Reuse only the same plugin and the same connection: the same REST base URL, or the same host, port, and database. A similar name is not a match. list_integrations and get_integration_metadata do not expose connection URLs or hosts, so do not use them to guess a match. When there is no exact match, follow the result's agentInstructions to create and wire every declared integration.\n\nThis connector is the single Superblocks MCP: Builder tools (upload_artifact, start_app, edit_app, check_app_progress, ask_user, get_app, build_app, publish_app, check_publish_progress) and Admin tools (integrations, apps, users, folders, deploy_application, and the rest of the customer Admin surface) share this endpoint \u2014 prefer create_integration / update_integration / list_integrations here over sending the user to a second MCP. create_integration takes name, plugin_id, and configuration, never the raw integrations API envelope. create_integration is Admin CRUD for org datasources; start_app creates an application and hands it a prompt. deploy_application is Admin deploy of an existing commit; publish_app is the Builder path that commits current work and waits for it to go live. Omit base_url on Admin tools unless targeting a different control plane. checkout_application is not exposed on this network surface (host filesystem writes); use the CLI/workspace checkout path instead.\n\nThis connection is already authenticated against one Superblocks Server \u2014 there is no setup, login, or auth-status call to make first. Call the tool that does the job and read its error if something is genuinely wrong; there is no tool that reports credentials or environments.\n\nNever tell the user to restart the MCP server; keep the MCP server running.\n\nA cancelled tool call does not undo work Superblocks already did. The application still exists; read applicationId on the error and follow agentInstructions (or pendingAction) instead of starting over.\n\nget_app's previewUrl opens the current development app with existing app permissions; it is not a published end-user URL. For a requested live-preview link, return that exact URL; do not open Share, change permissions, invite anyone, or publish. Call build_app only when the user explicitly requests an unpublished build or a shareable versioned preview, never automatically after an ordinary app creation, edit, or get_app. It creates a commit preview without publishing; retain its previewUrl and use get_preview_status for subsequent checks. If a sharing request is ambiguous (including \"Can I share this app?\"), ask before calling any tools whether they mean live preview, an unpublished commit preview, or publishing. Access permissions and deployment history cannot resolve this intent; an empty deployment history does not mean publishing is required to share a preview. Call publish_app or deploy_application only when the user explicitly asks to publish or deploy. Otherwise prefer MCP Apps Open editor / Open preview buttons over dumping editUrl / previewUrl / publishUrl into chat, especially preview JWTs. Claude Desktop can only openLink https URLs; when a URL is http, say so and rely on any screenshot instead.\n\nBrowser capture (MUST):\n1. Prefer host browser tools (Playwright MCP, chrome-devtools, agent-browser) over opening Superblocks URLs yourself. Honor the structured \"browser\" field on start_app / get_app / idp_step_up; do not paraphrase it into a different URL.\n2. When canvas.openWhileBuilding is \"claude_cowork_side_panel_only\", open canvas.editUrl while status is \"building\" only for a Claude Cowork task whose built-in browser is available, and use its embedded side panel. Every other host MUST NOT open it mid-build because that can steal the live-edit turn.\n3. NEVER paste tokens, JWTs, or API keys into browser evaluate or fill. Tokens are not in tool JSON; do not invent them.\n4. Playwright MCP MUST NOT use --isolated for Superblocks IdP. Cookies must survive the session.\n5. MUST NOT call browser_close until the Superblocks task is done (see driver.mustNotCloseUntil).\n6. agent-browser MUST always pass --profile and a stable --session for the same Superblocks origin.\n7. Claude-in-Chrome is not a mid-turn canvas. Do not use it to screenshot the live Vite app while a Gateway turn is held.";
 /**
  * The MCP server behind one stdio session.
  *
  * Tools run as the already-logged-in CLI user. There is no per-request OAuth
  * token to expire independently of the process.
  */
-export declare function createMcpServer(deps: AppDeps): McpServer;
+export declare function createMcpServer(deps: AppDeps, probeEditorDocument?: EditorDocumentProbe): McpServer;