@superblocksteam/gateway 2.0.0-SNAPSHOT.1d4c72c0ab174c21

package/dist/transports/mcp/format-tool-content.js

@@ -0,0 +1,89 @@
+import { isRecord, readResult } from "./instructions/result.js";
+/**
+ * Serializes a capability result into MCP content blocks.
+ *
+ * Block order is important: callers read `content[0]` as the JSON body and
+ * `content.at(-1)` as the closing instruction.
+ *
+ * Screenshot bytes stay in the JSON as well as the image block, because Cursor
+ * CLI agents never see image blocks. A plan gets its own markdown block where a
+ * model renders the ask: in the JSON it is one escaped string, and a model that
+ * re-lays it out demotes headings and merges bullets. That block holds the plan
+ * and title only - an earlier version bundled instructions and option labels,
+ * which models pasted into the chat as a menu.
+ */
+export function formatMcpToolContent(result, progress = [], profile) {
+    const { publishDetailsUrl, screenshotBase64, textResult } = extractRichContent(result);
+    const content = [];
+    // Every text block ends in a newline because hosts concatenate them: without
+    // it the trail read "}[progress] Creating application[progress] Connecting
+    // live-edit session", running the JSON body into the first marker and every
+    // marker into the next.
+    content.push({
+        text: `${JSON.stringify(textResult, null, 2)}\n`,
+        type: "text",
+    });
+    if (profile?.hasNativeAskForm) {
+        const plan = planMarkdown(result);
+        if (plan) {
+            content.push({ text: `\n${plan}\n\n`, type: "text" });
+        }
+    }
+    if (publishDetailsUrl) {
+        content.push({
+            description: "View publish details",
+            name: "publish-details",
+            title: "View publish details",
+            type: "resource_link",
+            uri: publishDetailsUrl,
+        });
+    }
+    content.push(...progress.map((event) => ({
+        text: `[${event.type}] ${event.message}\n`,
+        type: "text",
+    })));
+    if (screenshotBase64) {
+        content.push({
+            data: screenshotBase64,
+            mimeType: "image/jpeg",
+            type: "image",
+        });
+    }
+    return content;
+}
+function planMarkdown(result) {
+    const flat = readResult(result);
+    if (flat.status !== "needs_decision" || flat.decisionKind !== "plan") {
+        return undefined;
+    }
+    const decision = flat.value.decision;
+    if (!isRecord(decision)) {
+        return undefined;
+    }
+    const plan = typeof decision.plan === "string" ? decision.plan.trim() : "";
+    if (!plan) {
+        return undefined;
+    }
+    const title = typeof decision.title === "string" ? decision.title.trim() : "";
+    return title ? `**${title}**\n\n${plan}` : plan;
+}
+function extractRichContent(result) {
+    if (result.kind !== "ok" ||
+        !result.value ||
+        typeof result.value !== "object") {
+        return {
+            publishDetailsUrl: undefined,
+            screenshotBase64: undefined,
+            textResult: result,
+        };
+    }
+    const value = result.value;
+    const publishDetailsUrl = typeof value.publishDetailsUrl === "string"
+        ? value.publishDetailsUrl
+        : undefined;
+    const screenshotBase64 = typeof value.screenshotBase64 === "string"
+        ? value.screenshotBase64
+        : undefined;
+    return { publishDetailsUrl, screenshotBase64, textResult: result };
+}
+//# sourceMappingURL=format-tool-content.js.map

package/dist/transports/mcp/format-tool-content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-tool-content.js","sourceRoot":"","sources":["../../../src/transports/mcp/format-tool-content.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,23 @@
+/**
+ * What to tell the calling agent after a tool call.
+ *
+ * One file per tool under `tools/` holds that tool's rules; `readResult`
+ * flattens a capability result so those rules read as a plain list of
+ * conditions. Callers only need the three functions below.
+ */
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import type { CapabilityResult } from "../../../capabilities/types.js";
+import type { ClientProfile } from "../client-presentation.js";
+import type { ToolName } from "../tool-names.js";
+/** The agent's next step after `tool` returned `result`, if it needs one. */
+export declare function instructionFor(tool: ToolName, result: CapabilityResult<unknown>, profile: ClientProfile): string | undefined;
+/**
+ * Writes `agentInstructions` onto a capability result, leaving any the
+ * capability set itself in place (activity relay and similar).
+ */
+export declare function attachAgentInstructions(tool: ToolName, result: CapabilityResult<unknown>, profile: ClientProfile): CapabilityResult<unknown>;
+/**
+ * The same, for Admin tools: they return MCP `CallToolResult` JSON rather than
+ * a capability result, so the payload is parsed and rewritten.
+ */
+export declare function attachAdminAgentInstructions(tool: ToolName, result: CallToolResult, profile: ClientProfile): CallToolResult;

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

@@ -0,0 +1,81 @@
+/**
+ * What to tell the calling agent after a tool call.
+ *
+ * One file per tool under `tools/` holds that tool's rules; `readResult`
+ * flattens a capability result so those rules read as a plain list of
+ * conditions. Callers only need the three functions below.
+ */
+import { isRecord, readResult } from "./result.js";
+import { INSTRUCTIONS } from "./tools/index.js";
+/** The agent's next step after `tool` returned `result`, if it needs one. */
+export function instructionFor(tool, result, profile) {
+    return INSTRUCTIONS[tool]?.(readResult(result), profile);
+}
+/**
+ * Writes `agentInstructions` onto a capability result, leaving any the
+ * capability set itself in place (activity relay and similar).
+ */
+export function attachAgentInstructions(tool, result, profile) {
+    const agentInstructions = instructionFor(tool, result, profile);
+    if (!agentInstructions) {
+        return result;
+    }
+    if (result.kind === "error") {
+        return result.agentInstructions ? result : { ...result, agentInstructions };
+    }
+    if (result.kind !== "ok" || !isRecord(result.value)) {
+        return result;
+    }
+    if (typeof result.value.agentInstructions === "string" &&
+        result.value.agentInstructions) {
+        return result;
+    }
+    return { kind: "ok", value: { ...result.value, agentInstructions } };
+}
+/**
+ * The same, for Admin tools: they return MCP `CallToolResult` JSON rather than
+ * a capability result, so the payload is parsed and rewritten.
+ */
+export function attachAdminAgentInstructions(tool, result, profile) {
+    if (result.isError) {
+        return result;
+    }
+    const block = result.content[0];
+    if (!block || block.type !== "text") {
+        return result;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(block.text);
+    }
+    catch {
+        return result;
+    }
+    if (!isRecord(parsed)) {
+        return result;
+    }
+    if (typeof parsed.agentInstructions === "string" &&
+        parsed.agentInstructions) {
+        return result;
+    }
+    const agentInstructions = instructionFor(tool, { kind: "ok", value: parsed }, profile);
+    if (!agentInstructions) {
+        return result;
+    }
+    const nextValue = { ...parsed, agentInstructions };
+    const existingStructured = isRecord(result.structuredContent)
+        ? result.structuredContent
+        : undefined;
+    return {
+        ...result,
+        content: [
+            { type: "text", text: JSON.stringify(nextValue) },
+            ...result.content.slice(1),
+        ],
+        structuredContent: {
+            ...(existingStructured ?? nextValue),
+            agentInstructions,
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/transports/mcp/instructions/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,6EAA6E;AAC7E,MAAM,UAAU,cAAc,CAC5B,IAAc,EACd,MAAiC,EACjC,OAAsB;IAEtB,OAAO,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC;AAC3D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CACrC,IAAc,EACd,MAAiC,EACjC,OAAsB;IAEtB,MAAM,iBAAiB,GAAG,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAChE,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACvB,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC5B,OAAO,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC9E,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QACpD,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IACE,OAAO,MAAM,CAAC,KAAK,CAAC,iBAAiB,KAAK,QAAQ;QAClD,MAAM,CAAC,KAAK,CAAC,iBAAiB,EAC9B,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,GAAG,MAAM,CAAC,KAAK,EAAE,iBAAiB,EAAE,EAAE,CAAC;AACvE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,4BAA4B,CAC1C,IAAc,EACd,MAAsB,EACtB,OAAsB;IAEtB,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAChC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QACpC,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACtB,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IACE,OAAO,MAAM,CAAC,iBAAiB,KAAK,QAAQ;QAC5C,MAAM,CAAC,iBAAiB,EACxB,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,MAAM,iBAAiB,GAAG,cAAc,CACtC,IAAI,EACJ,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,EAC7B,OAAO,CACR,CAAC;IACF,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACvB,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,MAAM,SAAS,GAAG,EAAE,GAAG,MAAM,EAAE,iBAAiB,EAAE,CAAC;IACnD,MAAM,kBAAkB,GAAG,QAAQ,CAAC,MAAM,CAAC,iBAAiB,CAAC;QAC3D,CAAC,CAAC,MAAM,CAAC,iBAAiB;QAC1B,CAAC,CAAC,SAAS,CAAC;IACd,OAAO;QACL,GAAG,MAAM;QACT,OAAO,EAAE;YACP,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE;YACjD,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;SAC3B;QACD,iBAAiB,EAAE;YACjB,GAAG,CAAC,kBAAkB,IAAI,SAAS,CAAC;YACpC,iBAAiB;SAClB;KACF,CAAC;AACJ,CAAC"}

package/dist/transports/mcp/instructions/result.d.ts

@@ -0,0 +1,18 @@
+import type { CapabilityResult, DecisionPayload, PendingAppAction } from "../../../capabilities/types.js";
+/**
+ * A capability result flattened into the handful of fields the tool files
+ * branch on. Reading happens once here so no tool file digs through
+ * `CapabilityResult`'s ok/error split or a nested `decision` object.
+ */
+export type ToolResult = {
+    /** Error code, or undefined when the call succeeded. */
+    code?: string;
+    decisionKind?: DecisionPayload["kind"];
+    ok: boolean;
+    pendingAction?: PendingAppAction;
+    status?: string;
+    /** Remaining response fields, for the few tools with their own signals. */
+    value: Record<string, unknown>;
+};
+export declare function readResult(result: CapabilityResult<unknown>): ToolResult;
+export declare function isRecord(value: unknown): value is Record<string, unknown>;

package/dist/transports/mcp/instructions/result.js

@@ -0,0 +1,58 @@
+export function readResult(result) {
+    if (result.kind === "error") {
+        return {
+            code: result.code,
+            ok: false,
+            ...(result.pendingAction ? { pendingAction: result.pendingAction } : {}),
+            value: {},
+        };
+    }
+    // auth_required is the host's to resolve, not the agent's; it carries no fields to branch on.
+    if (result.kind !== "ok") {
+        return { ok: false, value: {} };
+    }
+    const value = isRecord(result.value) ? result.value : {};
+    const decisionKind = decisionKindOf(value);
+    const pendingAction = pendingActionOf(value);
+    const { status } = value;
+    return {
+        ...(decisionKind ? { decisionKind } : {}),
+        ok: true,
+        ...(pendingAction ? { pendingAction } : {}),
+        ...(typeof status === "string" ? { status } : {}),
+        value,
+    };
+}
+export function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function decisionKindOf(value) {
+    const decision = value.decision;
+    if (!isRecord(decision)) {
+        return undefined;
+    }
+    switch (decision.kind) {
+        case "missing_integrations":
+        case "multi_choice":
+        case "plan":
+            return decision.kind;
+        default:
+            return undefined;
+    }
+}
+function pendingActionOf(value) {
+    switch (value.pendingAction) {
+        case "answer_question":
+        case "approve_plan":
+        case "create_integration":
+        case "decide_in_editor":
+        case "open_editor":
+        case "retry_build":
+        case "start_new_app":
+        case "wait_for_build":
+            return value.pendingAction;
+        default:
+            return undefined;
+    }
+}
+//# sourceMappingURL=result.js.map

package/dist/transports/mcp/instructions/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../../../src/transports/mcp/instructions/result.ts"],"names":[],"mappings":"AAsBA,MAAM,UAAU,UAAU,CAAC,MAAiC;IAC1D,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC5B,OAAO;YACL,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,EAAE,EAAE,KAAK;YACT,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACxE,KAAK,EAAE,EAAE;SACV,CAAC;IACJ,CAAC;IACD,8FAA8F;IAC9F,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;QACzB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IAClC,CAAC;IACD,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IACzD,MAAM,YAAY,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IAC3C,MAAM,aAAa,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IAC7C,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;IACzB,OAAO;QACL,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzC,EAAE,EAAE,IAAI;QACR,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3C,GAAG,CAAC,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,KAAK;KACN,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,cAAc,CACrB,KAA8B;IAE9B,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;IAChC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACxB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,QAAQ,QAAQ,CAAC,IAAI,EAAE,CAAC;QACtB,KAAK,sBAAsB,CAAC;QAC5B,KAAK,cAAc,CAAC;QACpB,KAAK,MAAM;YACT,OAAO,QAAQ,CAAC,IAAI,CAAC;QACvB;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CACtB,KAA8B;IAE9B,QAAQ,KAAK,CAAC,aAAa,EAAE,CAAC;QAC5B,KAAK,iBAAiB,CAAC;QACvB,KAAK,cAAc,CAAC;QACpB,KAAK,oBAAoB,CAAC;QAC1B,KAAK,kBAAkB,CAAC;QACxB,KAAK,aAAa,CAAC;QACnB,KAAK,aAAa,CAAC;QACnB,KAAK,eAAe,CAAC;QACrB,KAAK,gBAAgB;YACnB,OAAO,KAAK,CAAC,aAAa,CAAC;QAC7B;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC"}

package/dist/transports/mcp/instructions/tools/ask-user.d.ts

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

package/dist/transports/mcp/instructions/tools/ask-user.js

@@ -0,0 +1,17 @@
+import { SHOW_PLAN_VERBATIM } from "./copy.js";
+export function instructAskUser(result) {
+    if (!result.ok) {
+        return undefined;
+    }
+    if (result.decisionKind === "plan") {
+        return `Show this plan to the user. ${SHOW_PLAN_VERBATIM}`;
+    }
+    if (result.decisionKind === "multi_choice") {
+        return "Present `decision.question` and every entry of `decision.options`, none dropped or merged, as an affordance (picker/suggested replies) if your host supports one. Never type a numbered menu as a stand-in for a picker that's already showing the same options.";
+    }
+    if (!result.decisionKind) {
+        return "Nothing is waiting on the user right now. Follow the build instead: call `check_app_progress` or `get_app` rather than asking again.";
+    }
+    return undefined;
+}
+//# sourceMappingURL=ask-user.js.map

package/dist/transports/mcp/instructions/tools/ask-user.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask-user.js","sourceRoot":"","sources":["../../../../../src/transports/mcp/instructions/tools/ask-user.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAE/C,MAAM,UAAU,eAAe,CAAC,MAAkB;IAChD,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,MAAM,CAAC,YAAY,KAAK,MAAM,EAAE,CAAC;QACnC,OAAO,+BAA+B,kBAAkB,EAAE,CAAC;IAC7D,CAAC;IACD,IAAI,MAAM,CAAC,YAAY,KAAK,cAAc,EAAE,CAAC;QAC3C,OAAO,kQAAkQ,CAAC;IAC5Q,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;QACzB,OAAO,sIAAsI,CAAC;IAChJ,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

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

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

package/dist/transports/mcp/instructions/tools/check-app-progress.js

@@ -0,0 +1,75 @@
+import { CHECKPOINT_FAILED, instructUserDecision, REPLACE_WEDGED_APP, } from "./copy.js";
+export function instructCheckAppProgress(result, profile) {
+    const navigation = profile.hasNativeBrowser
+        ? result.value.browserNavigation
+        : undefined;
+    if (!isBrowserNavigation(navigation)) {
+        return resultInstructions(result, profile);
+    }
+    const instructions = resultInstructions(result, profile);
+    const browserInstructions = `CRITICAL DO NOT IGNORE: viewStatus is ready, before any other action, ensure ${navigation.url} is open in Cowork's embedded Page browser and verify the app loaded.`;
+    return instructions
+        ? `${browserInstructions}\n\n${instructions}`
+        : browserInstructions;
+}
+function resultInstructions(result, profile) {
+    if (result.decisionKind === "missing_integrations") {
+        return "Create every entry in `decision.integrations`; do not call `ask_user` or relay manual setup steps. Call `create_integration` with each entry's name, pluginId, and configuration. When `configurationSchema` is present, use it directly and skip `get_integration_config_schema`; when it is absent, call `get_integration_config_schema` first. Follow each `create_integration` result's agentInstructions for configuration and app wiring.";
+    }
+    const decisionInstructions = instructUserDecision(result, profile);
+    if (decisionInstructions) {
+        return decisionInstructions;
+    }
+    if (result.pendingAction === "start_new_app") {
+        return REPLACE_WEDGED_APP;
+    }
+    if (result.status === "checkpoint_failed") {
+        return CHECKPOINT_FAILED;
+    }
+    // A death the gateway judged unrecoverable arrives without `retry_build`:
+    // either as `start_new_app` above, or as no pendingAction at all.
+    if (result.status === "live_edit_terminated" &&
+        result.pendingAction !== "retry_build") {
+        return "This is terminal. Report the reply to the user and stop - do not retry `edit_app` or create another application for this turn.";
+    }
+    if (result.pendingAction === "retry_build" &&
+        (result.status === "cancelled" ||
+            result.status === "live_edit_terminated" ||
+            result.status === "no_changes" ||
+            result.status === "timeout")) {
+        return "Call `edit_app` again on this `applicationId` - the last turn ended without writing anything, but the application itself is fine to retry.";
+    }
+    if (result.status === "building") {
+        const lines = superblocksActivity(result);
+        if (lines.length > 0) {
+            const them = lines.length === 1 ? "it" : "all of them";
+            return `The build is still running. Superblocks sent ${lines.length} new activity ${lines.length === 1 ? "line" : "lines"} in this result. CRITICAL DO NOT IGNORE: Between polls, write ${them} into your own reply, oldest first, verbatim. Then, call check_app_progress again.`;
+        }
+        return `Superblocks is still working. This is a long poll, as soon as any activity is available it will be relayed to you. Do not sleep, immediately call check_app_progress again.`;
+    }
+    if (result.status === "unknown") {
+        return "Tell the user that Superblocks progress tracking was interrupted and ask whether they want to continue. Only if the user says to continue, call `edit_app` on the same `applicationId` with their instruction.";
+    }
+    if (result.status === "ready") {
+        return "The app is ready. Call get_app to get the editor and preview URLs. Do not call check_app_progress again.";
+    }
+    return undefined;
+}
+function isBrowserNavigation(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "action" in value &&
+        value.action === "open_editor" &&
+        "url" in value &&
+        typeof value.url === "string" &&
+        value.url.length > 0);
+}
+/** Gateway heartbeats are not Superblocks chat and must not trigger a relay. */
+function superblocksActivity(result) {
+    const activity = result.value.activity;
+    if (!Array.isArray(activity)) {
+        return [];
+    }
+    return activity.filter((line) => typeof line === "string" && line !== "Superblocks is still generating");
+}
+//# sourceMappingURL=check-app-progress.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"check-app-progress.js","sourceRoot":"","sources":["../../../../../src/transports/mcp/instructions/tools/check-app-progress.ts"],"names":[],"mappings":"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"}

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

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

package/dist/transports/mcp/instructions/tools/check-publish-progress.js

@@ -0,0 +1,23 @@
+import { instructPublishDetails } from "./copy.js";
+export function instructCheckPublishProgress(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.code === "publish_not_started") {
+        return "The publish cursor was not available. Retry `check_publish_progress` with both the `applicationId` and `commitId` returned by `publish_app`. Call `publish_app` only if nothing was ever queued.";
+    }
+    if (result.status === "publishing") {
+        const elapsedSeconds = result.value.elapsedSeconds;
+        const elapsed = typeof elapsedSeconds === "number" && Number.isFinite(elapsedSeconds)
+            ? ` for ${Math.max(0, Math.floor(elapsedSeconds))} seconds`
+            : "";
+        return `The rollout is still running${elapsed}, so the app is not live yet - do not tell the user it is. Continue to call \`check_publish_progress\` until the app is live. Do not call \`publish_app\` again.`;
+    }
+    return undefined;
+}
+//# sourceMappingURL=check-publish-progress.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"check-publish-progress.js","sourceRoot":"","sources":["../../../../../src/transports/mcp/instructions/tools/check-publish-progress.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAEnD,MAAM,UAAU,4BAA4B,CAC1C,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,IAAI,KAAK,qBAAqB,EAAE,CAAC;QAC1C,OAAO,kMAAkM,CAAC;IAC5M,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,KAAK,YAAY,EAAE,CAAC;QACnC,MAAM,cAAc,GAAG,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC;QACnD,MAAM,OAAO,GACX,OAAO,cAAc,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC;YACnE,CAAC,CAAC,QAAQ,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,UAAU;YAC3D,CAAC,CAAC,EAAE,CAAC;QACT,OAAO,+BAA+B,OAAO,kKAAkK,CAAC;IAClN,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

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

@@ -0,0 +1,14 @@
+/** Instructions shared verbatim by more than one tool. */
+import type { ClientProfile } from "../../client-presentation.js";
+import type { ToolResult } from "../result.js";
+export declare const BUILDING_FOLLOW_UP = "Call `check_app_progress` with this `applicationId` to follow the turn. Relay each new activity line to the user as it arrives. CRITICAL: Load your embedded browser tools.";
+export declare const CHECKPOINT_FAILED = "The build finished but did not save. Do not tell the user the app was saved, and do not poll again - open the editor via this result's `editUrl` and report that the checkpoint failed.";
+export declare const REPLACE_WEDGED_APP = "This application is wedged and cannot be recovered. Call `start_app` once more with the same prompt and artifacts, and set `replacesApplicationId` to this result's `applicationId`. Do not upload the source again.";
+export declare const RETRY_UNAVAILABLE_LIVE_EDIT = "Call `edit_app` again on this `applicationId` with the same prompt. The live-edit session was unavailable; the application itself is still there.";
+export declare const SHOW_PLAN_VERBATIM = "Lead with `decision.title` when it is present, then show the entire `decision.plan` markdown, verbatim, laid out as markdown. Do not paraphrase, summarize, shorten, reorder, or re-level its headings - the user is approving exactly this text.";
+/**
+ * The publish details page shows the rollout live, so Cowork opens it for the
+ * whole publish rather than at the end. Other hosts only ever show the link.
+ */
+export declare function instructPublishDetails(result: ToolResult, profile: ClientProfile): string | undefined;
+export declare function instructUserDecision(result: ToolResult, profile: ClientProfile): string | undefined;

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

@@ -0,0 +1,35 @@
+/** Instructions shared verbatim by more than one tool. */
+import { withCoworkEditorHost } from "../../cowork-editor-url.js";
+export const BUILDING_FOLLOW_UP = "Call `check_app_progress` with this `applicationId` to follow the turn. Relay each new activity line to the user as it arrives. CRITICAL: Load your embedded browser tools.";
+export const CHECKPOINT_FAILED = "The build finished but did not save. Do not tell the user the app was saved, and do not poll again - open the editor via this result's `editUrl` and report that the checkpoint failed.";
+export const REPLACE_WEDGED_APP = "This application is wedged and cannot be recovered. Call `start_app` once more with the same prompt and artifacts, and set `replacesApplicationId` to this result's `applicationId`. Do not upload the source again.";
+export const RETRY_UNAVAILABLE_LIVE_EDIT = "Call `edit_app` again on this `applicationId` with the same prompt. The live-edit session was unavailable; the application itself is still there.";
+export const SHOW_PLAN_VERBATIM = "Lead with `decision.title` when it is present, then show the entire `decision.plan` markdown, verbatim, laid out as markdown. Do not paraphrase, summarize, shorten, reorder, or re-level its headings - the user is approving exactly this text.";
+/**
+ * The publish details page shows the rollout live, so Cowork opens it for the
+ * whole publish rather than at the end. Other hosts only ever show the link.
+ */
+export function instructPublishDetails(result, profile) {
+    const url = result.value.publishDetailsUrl;
+    if (!profile.hasNativeBrowser ||
+        (result.status !== "publishing" && result.status !== "deployed") ||
+        typeof url !== "string" ||
+        !url) {
+        return undefined;
+    }
+    return `Before any other action, ensure ${withCoworkEditorHost(url)} is open in Cowork's embedded Page browser and verify the publish details loaded.`;
+}
+export function instructUserDecision(result, profile) {
+    if (result.decisionKind === "plan") {
+        return profile.hasNativeAskForm
+            ? `Use your native ask form to put this plan decision to the user. Do not call ask_user. Output the plan markdown as text, not in the native form. ${SHOW_PLAN_VERBATIM} In your native form, present exactly two choices labeled \`Approve\` and \`Refine\`. In \`Refine\`'s description, refer to the form's built-in free-text field only as \`Something else\`. Do not answer the decision yourself and do not call check_app_progress again until they have answered. If the user chooses \`Approve\`, call edit_app with the applicationId from this result and planAction "approve" with no prompt. If the form returns text in its \`response\` field, call edit_app with that applicationId, planAction "refine", and the exact \`response\` as prompt. If the user chooses \`Refine\` without feedback, ask the user for further instructions`
+            : "Call ask_user now to put this plan decision to the user. Do not answer it yourself and do not call check_app_progress again until they have answered.";
+    }
+    if (result.decisionKind === "multi_choice") {
+        return profile.hasNativeAskForm
+            ? "Use your native ask form to put this multi-choice decision to the user. Do not call ask_user. Present the available options and ask the user to choose one. Do not answer the decision yourself and do not call check_app_progress again until they have answered. Send their answer through edit_app, using the chosen option as the prompt. Provide their answer EXACTLY as they provided it to edit_app."
+            : "Call ask_user now to put this multi-choice decision to the user. Do not answer it yourself and do not call check_app_progress again until they have answered.";
+    }
+    return undefined;
+}
+//# sourceMappingURL=copy.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"copy.js","sourceRoot":"","sources":["../../../../../src/transports/mcp/instructions/tools/copy.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAG1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAGlE,MAAM,CAAC,MAAM,kBAAkB,GAC7B,6KAA6K,CAAC;AAEhL,MAAM,CAAC,MAAM,iBAAiB,GAC5B,yLAAyL,CAAC;AAE5L,MAAM,CAAC,MAAM,kBAAkB,GAC7B,sNAAsN,CAAC;AAEzN,MAAM,CAAC,MAAM,2BAA2B,GACtC,mJAAmJ,CAAC;AAEtJ,MAAM,CAAC,MAAM,kBAAkB,GAC7B,mPAAmP,CAAC;AAEtP;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CACpC,MAAkB,EAClB,OAAsB;IAEtB,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAAC;IAC3C,IACE,CAAC,OAAO,CAAC,gBAAgB;QACzB,CAAC,MAAM,CAAC,MAAM,KAAK,YAAY,IAAI,MAAM,CAAC,MAAM,KAAK,UAAU,CAAC;QAChE,OAAO,GAAG,KAAK,QAAQ;QACvB,CAAC,GAAG,EACJ,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,mCAAmC,oBAAoB,CAAC,GAAG,CAAC,mFAAmF,CAAC;AACzJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,MAAkB,EAClB,OAAsB;IAEtB,IAAI,MAAM,CAAC,YAAY,KAAK,MAAM,EAAE,CAAC;QACnC,OAAO,OAAO,CAAC,gBAAgB;YAC7B,CAAC,CAAC,mJAAmJ,kBAAkB,ipBAAipB;YACxzB,CAAC,CAAC,uJAAuJ,CAAC;IAC9J,CAAC;IACD,IAAI,MAAM,CAAC,YAAY,KAAK,cAAc,EAAE,CAAC;QAC3C,OAAO,OAAO,CAAC,gBAAgB;YAC7B,CAAC,CAAC,6YAA6Y;YAC/Y,CAAC,CAAC,+JAA+J,CAAC;IACtK,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

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

@@ -0,0 +1,4 @@
+import type { ClientProfile } from "../../client-presentation.js";
+import { type ToolResult } from "../result.js";
+export declare function instructCreateIntegration(result: ToolResult, profile: ClientProfile): string | undefined;
+export declare function isPublicIntegration(value: Record<string, unknown>): boolean;

package/dist/transports/mcp/instructions/tools/create-integration.js

@@ -0,0 +1,41 @@
+import { isEditorIntegrationSetupUrl } from "../../editor-integration-setup-url.js";
+import { isRecord } from "../result.js";
+export function instructCreateIntegration(result, profile) {
+    const url = result.value.integration_url;
+    const integrationId = result.value.integration_id;
+    if (typeof integrationId !== "string" || !integrationId) {
+        return undefined;
+    }
+    const editorSetup = typeof url === "string" && url ? isEditorIntegrationSetupUrl(url) : false;
+    const opening = typeof url === "string" && url
+        ? profile.hasNativeBrowser
+            ? editorSetup
+                ? `Open the exact returned URL ${url} in Cowork's embedded browser side panel even if the app editor is already open. That URL opens the Integrations tab inside the editor so the user can enter credentials there. Do not navigate to the org Integrations page.`
+                : `Open the exact returned URL ${url} in Cowork's embedded browser side panel.`
+            : editorSetup
+                ? "Show `integration_url` to the user and ask them to open it. It opens the Integrations tab in the editor so they can enter credentials there. Do not send them to the org Integrations page. Do not open it yourself."
+                : "Show `integration_url` to the user and ask them to open it in Superblocks. Do not open it yourself."
+        : "Tell the user to open the integration in Superblocks, but do not invent a URL.";
+    const stayInEditor = editorSetup
+        ? " After they confirm, they are still in the editor."
+        : "";
+    const wiring = `Call \`edit_app\` with returned integration_id \`${integrationId}\` and tell Superblocks to wire it into every affected API, test those APIs, and remove temporary setup instructions.`;
+    if (isPublicIntegration(result.value)) {
+        return `${opening} This result confirms the integration uses public/no-auth access, so do not wait for credential confirmation. ${wiring}`;
+    }
+    return `${opening} Never ask the user to put passwords, API tokens, or other secrets in chat.${stayInEditor} Wait for the user to confirm configuration is complete, then ${wiring}`;
+}
+export function isPublicIntegration(value) {
+    const integration = value.integration;
+    if (!isRecord(integration) || !Array.isArray(integration.configurations)) {
+        return false;
+    }
+    return integration.configurations.some((entry) => {
+        if (!isRecord(entry) || !isRecord(entry.configuration)) {
+            return false;
+        }
+        const authType = entry.configuration.authType;
+        return typeof authType === "string" && authType.toLowerCase() === "none";
+    });
+}
+//# sourceMappingURL=create-integration.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-integration.js","sourceRoot":"","sources":["../../../../../src/transports/mcp/instructions/tools/create-integration.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,2BAA2B,EAAE,MAAM,uCAAuC,CAAC;AACpF,OAAO,EAAE,QAAQ,EAAmB,MAAM,cAAc,CAAC;AAEzD,MAAM,UAAU,yBAAyB,CACvC,MAAkB,EAClB,OAAsB;IAEtB,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC;IACzC,MAAM,aAAa,GAAG,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC;IAClD,IAAI,OAAO,aAAa,KAAK,QAAQ,IAAI,CAAC,aAAa,EAAE,CAAC;QACxD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,WAAW,GACf,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,CAAC,CAAC,2BAA2B,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAC5E,MAAM,OAAO,GACX,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG;QAC5B,CAAC,CAAC,OAAO,CAAC,gBAAgB;YACxB,CAAC,CAAC,WAAW;gBACX,CAAC,CAAC,+BAA+B,GAAG,+NAA+N;gBACnQ,CAAC,CAAC,+BAA+B,GAAG,2CAA2C;YACjF,CAAC,CAAC,WAAW;gBACX,CAAC,CAAC,sNAAsN;gBACxN,CAAC,CAAC,qGAAqG;QAC3G,CAAC,CAAC,gFAAgF,CAAC;IACvF,MAAM,YAAY,GAAG,WAAW;QAC9B,CAAC,CAAC,oDAAoD;QACtD,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,MAAM,GAAG,oDAAoD,aAAa,uHAAuH,CAAC;IAExM,IAAI,mBAAmB,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QACtC,OAAO,GAAG,OAAO,iHAAiH,MAAM,EAAE,CAAC;IAC7I,CAAC;IACD,OAAO,GAAG,OAAO,8EAA8E,YAAY,iEAAiE,MAAM,EAAE,CAAC;AACvL,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAA8B;IAChE,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;IACtC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,cAAc,CAAC,EAAE,CAAC;QACzE,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,WAAW,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;QAC/C,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,aAAa,CAAC,EAAE,CAAC;YACvD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,MAAM,QAAQ,GAAG,KAAK,CAAC,aAAa,CAAC,QAAQ,CAAC;QAC9C,OAAO,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC;IAC3E,CAAC,CAAC,CAAC;AACL,CAAC"}

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

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

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

@@ -0,0 +1,18 @@
+import { BUILDING_FOLLOW_UP, REPLACE_WEDGED_APP, RETRY_UNAVAILABLE_LIVE_EDIT, } from "./copy.js";
+export function instructEditApp(result) {
+    if (result.pendingAction === "start_new_app") {
+        return REPLACE_WEDGED_APP;
+    }
+    if (result.code === "live_edit_unavailable" &&
+        result.pendingAction === "retry_build") {
+        return RETRY_UNAVAILABLE_LIVE_EDIT;
+    }
+    if (result.code === "live_edit_unavailable") {
+        return "This application's live-edit session is wedged, but it already has committed work - do not start a new application. Report to the user that this application needs manual recovery and stop.";
+    }
+    if (result.status === "building") {
+        return BUILDING_FOLLOW_UP;
+    }
+    return undefined;
+}
+//# sourceMappingURL=edit-app.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"edit-app.js","sourceRoot":"","sources":["../../../../../src/transports/mcp/instructions/tools/edit-app.ts"],"names":[],"mappings":"AACA,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,2BAA2B,GAC5B,MAAM,WAAW,CAAC;AAEnB,MAAM,UAAU,eAAe,CAAC,MAAkB;IAChD,IAAI,MAAM,CAAC,aAAa,KAAK,eAAe,EAAE,CAAC;QAC7C,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IACD,IACE,MAAM,CAAC,IAAI,KAAK,uBAAuB;QACvC,MAAM,CAAC,aAAa,KAAK,aAAa,EACtC,CAAC;QACD,OAAO,2BAA2B,CAAC;IACrC,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,uBAAuB,EAAE,CAAC;QAC5C,OAAO,8LAA8L,CAAC;IACxM,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QACjC,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

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

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