@superblocksteam/gateway 2.0.161 → 2.0.162-next.1

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":"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"}

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,20 @@
+import { DECIDE_IN_EDITOR, SHOW_PLAN_VERBATIM } from "./copy.js";
+export function instructAskUser(result) {
+    if (!result.ok) {
+        return undefined;
+    }
+    if (result.pendingAction === "decide_in_editor") {
+        return DECIDE_IN_EDITOR;
+    }
+    if (result.decisionKind === "plan") {
+        return `Show this plan in the chat stream. ${SHOW_PLAN_VERBATIM} Do not put the plan in a question widget or ask form.`;
+    }
+    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,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAEjE,MAAM,UAAU,eAAe,CAAC,MAAkB;IAChD,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,MAAM,CAAC,aAAa,KAAK,kBAAkB,EAAE,CAAC;QAChD,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IACD,IAAI,MAAM,CAAC,YAAY,KAAK,MAAM,EAAE,CAAC;QACnC,OAAO,sCAAsC,kBAAkB,wDAAwD,CAAC;IAC1H,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/build-app.d.ts

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

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

@@ -0,0 +1,54 @@
+const PRIVATE_PREVIEW = "This is an unpublished preview. Building it did not change app permissions; do not publish it or change permissions unless the user explicitly asks. The URL may carry a scoped preview credential, so give it only to the user or recipient who requested it and do not post it publicly.";
+export function instructBuildApp(result, profile) {
+    if (result.status === "building") {
+        const cursor = previewStatusCursor(result);
+        if (!cursor) {
+            return undefined;
+        }
+        const previewUrl = result.value.previewUrl;
+        const savedUrl = typeof previewUrl === "string" && previewUrl
+            ? ` Keep ${previewUrl} as the preview URL for this commit.`
+            : "";
+        return `The commit preview is still building.${savedUrl} Call \`get_preview_status\` with ${cursor} until it reports \`ready\` or \`failed\`. Do not call \`build_app\` again to poll because that would create another commit.`;
+    }
+    const previewUrl = result.value.previewUrl;
+    if (result.status !== "ready" ||
+        typeof previewUrl !== "string" ||
+        !previewUrl) {
+        return undefined;
+    }
+    const action = profile.hasNativeBrowser
+        ? `Before any other action, ensure ${previewUrl} is open in Cowork's embedded Page browser and verify only that the commit preview loaded.`
+        : `Give the user ${previewUrl}, the exact URL for this commit preview.`;
+    return `${action} ${PRIVATE_PREVIEW}`;
+}
+export function instructGetPreviewStatus(result, profile) {
+    if (result.status === "building") {
+        return instructBuildApp(result, profile);
+    }
+    if (result.status === "ready") {
+        const action = profile.hasNativeBrowser
+            ? "Before any other action, open the exact `previewUrl` from the original `build_app` result in Cowork's embedded Page browser and verify only that the commit preview loaded."
+            : "Give the user the exact `previewUrl` from the original `build_app` result.";
+        return `${action} ${PRIVATE_PREVIEW}`;
+    }
+    if (result.status === "failed") {
+        return "The commit preview build failed. Tell the user it is not ready. Do not open the preview URL, call `build_app` again, or publish it; wait for the user to decide what to do next.";
+    }
+    return undefined;
+}
+function previewStatusCursor(result) {
+    const { applicationId, branch, commitId, directoryHash } = result.value;
+    if (typeof applicationId !== "string" ||
+        typeof commitId !== "string" ||
+        typeof directoryHash !== "string") {
+        return undefined;
+    }
+    return JSON.stringify({
+        applicationId,
+        ...(typeof branch === "string" ? { branch } : {}),
+        commitId,
+        directoryHash,
+    });
+}
+//# sourceMappingURL=build-app.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"build-app.js","sourceRoot":"","sources":["../../../../../src/transports/mcp/instructions/tools/build-app.ts"],"names":[],"mappings":"AAGA,MAAM,eAAe,GACnB,4RAA4R,CAAC;AAE/R,MAAM,UAAU,gBAAgB,CAC9B,MAAkB,EAClB,OAAsB;IAEtB,IAAI,MAAM,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;QAC3C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC;QAC3C,MAAM,QAAQ,GACZ,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU;YAC1C,CAAC,CAAC,SAAS,UAAU,sCAAsC;YAC3D,CAAC,CAAC,EAAE,CAAC;QACT,OAAO,wCAAwC,QAAQ,qCAAqC,MAAM,8HAA8H,CAAC;IACnO,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC;IAC3C,IACE,MAAM,CAAC,MAAM,KAAK,OAAO;QACzB,OAAO,UAAU,KAAK,QAAQ;QAC9B,CAAC,UAAU,EACX,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,MAAM,GAAG,OAAO,CAAC,gBAAgB;QACrC,CAAC,CAAC,mCAAmC,UAAU,4FAA4F;QAC3I,CAAC,CAAC,iBAAiB,UAAU,0CAA0C,CAAC;IAC1E,OAAO,GAAG,MAAM,IAAI,eAAe,EAAE,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,MAAkB,EAClB,OAAsB;IAEtB,IAAI,MAAM,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QACjC,OAAO,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,OAAO,CAAC,gBAAgB;YACrC,CAAC,CAAC,6KAA6K;YAC/K,CAAC,CAAC,4EAA4E,CAAC;QACjF,OAAO,GAAG,MAAM,IAAI,eAAe,EAAE,CAAC;IACxC,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO,kLAAkL,CAAC;IAC5L,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,mBAAmB,CAAC,MAAkB;IAC7C,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC;IACxE,IACE,OAAO,aAAa,KAAK,QAAQ;QACjC,OAAO,QAAQ,KAAK,QAAQ;QAC5B,OAAO,aAAa,KAAK,QAAQ,EACjC,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,aAAa;QACb,GAAG,CAAC,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,QAAQ;QACR,aAAa;KACd,CAAC,CAAC;AACL,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,79 @@
+import { APP_LOAD_CHECK, CHECKPOINT_FAILED, DECIDE_IN_EDITOR, 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 = result.pendingAction === "decide_in_editor"
+        ? `CRITICAL DO NOT IGNORE: Before any other action, ensure ${navigation.url} is open in Cowork's embedded Page browser.`
+        : `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. ${APP_LOAD_CHECK}`;
+    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 === "decide_in_editor") {
+        return DECIDE_IN_EDITOR;
+    }
+    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) {
+            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 each new activity line into your own reply as a separate paragraph, 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":"AAEA,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,WAAW,CAAC;AAEnB,MAAM,UAAU,wBAAwB,CACtC,MAAkB,EAClB,OAAsB;IAEtB,MAAM,UAAU,GAAG,OAAO,CAAC,gBAAgB;QACzC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB;QAChC,CAAC,CAAC,SAAS,CAAC;IACd,IAAI,CAAC,mBAAmB,CAAC,UAAU,CAAC,EAAE,CAAC;QACrC,OAAO,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;IACD,MAAM,YAAY,GAAG,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzD,MAAM,mBAAmB,GACvB,MAAM,CAAC,aAAa,KAAK,kBAAkB;QACzC,CAAC,CAAC,2DAA2D,UAAU,CAAC,GAAG,6CAA6C;QACxH,CAAC,CAAC,gFAAgF,UAAU,CAAC,GAAG,yEAAyE,cAAc,EAAE,CAAC;IAC9L,OAAO,YAAY;QACjB,CAAC,CAAC,GAAG,mBAAmB,OAAO,YAAY,EAAE;QAC7C,CAAC,CAAC,mBAAmB,CAAC;AAC1B,CAAC;AAED,SAAS,kBAAkB,CACzB,MAAkB,EAClB,OAAsB;IAEtB,IAAI,MAAM,CAAC,YAAY,KAAK,sBAAsB,EAAE,CAAC;QACnD,OAAO,ibAAib,CAAC;IAC3b,CAAC;IACD,MAAM,oBAAoB,GAAG,oBAAoB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnE,IAAI,oBAAoB,EAAE,CAAC;QACzB,OAAO,oBAAoB,CAAC;IAC9B,CAAC;IACD,IAAI,MAAM,CAAC,aAAa,KAAK,kBAAkB,EAAE,CAAC;QAChD,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IACD,IAAI,MAAM,CAAC,aAAa,KAAK,eAAe,EAAE,CAAC;QAC7C,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,KAAK,mBAAmB,EAAE,CAAC;QAC1C,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IACD,0EAA0E;IAC1E,kEAAkE;IAClE,IACE,MAAM,CAAC,MAAM,KAAK,sBAAsB;QACxC,MAAM,CAAC,aAAa,KAAK,aAAa,EACtC,CAAC;QACD,OAAO,gIAAgI,CAAC;IAC1I,CAAC;IACD,IACE,MAAM,CAAC,aAAa,KAAK,aAAa;QACtC,CAAC,MAAM,CAAC,MAAM,KAAK,WAAW;YAC5B,MAAM,CAAC,MAAM,KAAK,sBAAsB;YACxC,MAAM,CAAC,MAAM,KAAK,YAAY;YAC9B,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC,EAC9B,CAAC;QACD,OAAO,4IAA4I,CAAC;IACtJ,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QACjC,MAAM,KAAK,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;QAC1C,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,OAAO,gDAAgD,KAAK,CAAC,MAAM,iBACjE,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAChC,gMAAgM,CAAC;QACnM,CAAC;QACD,OAAO,6KAA6K,CAAC;IACvL,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAChC,OAAO,gNAAgN,CAAC;IAC1N,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;QAC9B,OAAO,0GAA0G,CAAC;IACpH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,mBAAmB,CAC1B,KAAc;IAEd,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,QAAQ,IAAI,KAAK;QACjB,KAAK,CAAC,MAAM,KAAK,aAAa;QAC9B,KAAK,IAAI,KAAK;QACd,OAAO,KAAK,CAAC,GAAG,KAAK,QAAQ;QAC7B,KAAK,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CACrB,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,SAAS,mBAAmB,CAAC,MAAkB;IAC7C,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC;IACvC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,QAAQ,CAAC,MAAM,CACpB,CAAC,IAAI,EAAkB,EAAE,CACvB,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,iCAAiC,CACzE,CAAC;AACJ,CAAC"}

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,18 @@
+/** Instructions shared verbatim by more than one tool. */
+import type { ClientProfile } from "../../client-presentation.js";
+import type { ToolResult } from "../result.js";
+export declare const APP_LOAD_CHECK = "Your 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.";
+export declare const APP_SHARING_CHOICE = "For an ambiguous sharing request, ask the user to choose live preview, an unpublished commit preview, or publishing. Present all three options without choosing one for them. Do not assume publishing is required because the app has not been deployed: live and commit previews use existing app permissions without publishing. Only publish or change access when the user explicitly requests that action.";
+export declare const COWORK_BROWSER_TOOLSEARCH = "select:mcp__remote-devices__Claude_Browser__preview_start,mcp__remote-devices__Claude_Browser__navigate,mcp__remote-devices__Claude_Browser__tabs_context";
+export declare function buildingFollowUp(profile: ClientProfile): string;
+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 DECIDE_IN_EDITOR = "Open only the exact editor URL provided by this result so the user can answer in the Superblocks editor. When `browserNavigation` is present, follow its exact URL; otherwise use the exact URL in `editUrl`. Only the user may answer this decision. Do not click anything in the editor. Do not type anything in the editor. Do not switch between Plan and Build modes. Do not submit anything. Do not call `ask_user`. Stop and wait for the user.";
+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 in the chat stream. 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,49 @@
+/** Instructions shared verbatim by more than one tool. */
+import { withCoworkEditorHost } from "../../cowork-editor-url.js";
+export const APP_LOAD_CHECK = "Your 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.";
+export const APP_SHARING_CHOICE = "For an ambiguous sharing request, ask the user to choose live preview, an unpublished commit preview, or publishing. Present all three options without choosing one for them. Do not assume publishing is required because the app has not been deployed: live and commit previews use existing app permissions without publishing. Only publish or change access when the user explicitly requests that action.";
+export const COWORK_BROWSER_TOOLSEARCH = "select:mcp__remote-devices__Claude_Browser__preview_start,mcp__remote-devices__Claude_Browser__navigate,mcp__remote-devices__Claude_Browser__tabs_context";
+// Repeat the query on each build: initialize instructions are gone by then.
+export function buildingFollowUp(profile) {
+    const followUp = "Call `check_app_progress` with this `applicationId` to follow the turn. Relay each new activity line to the user as it arrives.";
+    if (!profile.hasNativeBrowser) {
+        return followUp;
+    }
+    return `${followUp} CRITICAL: load your browser pane tools now, before the first poll - call ToolSearch with query ${COWORK_BROWSER_TOOLSEARCH}. Without them you cannot open the app when a later result carries browserNavigation.`;
+}
+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 DECIDE_IN_EDITOR = "Open only the exact editor URL provided by this result so the user can answer in the Superblocks editor. When `browserNavigation` is present, follow its exact URL; otherwise use the exact URL in `editUrl`. Only the user may answer this decision. Do not click anything in the editor. Do not type anything in the editor. Do not switch between Plan and Build modes. Do not submit anything. Do not call `ask_user`. Stop and wait for the user.";
+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 in the chat stream. 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") {
+        // ENG-6810: ask widgets vary (some are one-line, some do not render
+        // markdown). The plan always belongs in the chat stream; the form is only
+        // Approve or Refine.
+        return profile.hasNativeAskForm
+            ? `Show this plan in the chat stream. Do not call ask_user. Output the plan markdown as text, not in the native form. ${SHOW_PLAN_VERBATIM} Do not put the plan in the form or any other question widget. Use your native ask form only to collect the choice: 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. Keep every native form field plain text, without Markdown markers. Use plain-text display labels but retain each original option string. 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. Map the selected plain-text label back to its original option string and send that original string through edit_app EXACTLY as Clark provided it."
+            : "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,cAAc,GACzB,mZAAmZ,CAAC;AAEtZ,MAAM,CAAC,MAAM,kBAAkB,GAC7B,kZAAkZ,CAAC;AAErZ,MAAM,CAAC,MAAM,yBAAyB,GACpC,2JAA2J,CAAC;AAE9J,4EAA4E;AAC5E,MAAM,UAAU,gBAAgB,CAAC,OAAsB;IACrD,MAAM,QAAQ,GACZ,iIAAiI,CAAC;IACpI,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC;QAC9B,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,OAAO,GAAG,QAAQ,mGAAmG,yBAAyB,uFAAuF,CAAC;AACxO,CAAC;AAED,MAAM,CAAC,MAAM,iBAAiB,GAC5B,yLAAyL,CAAC;AAE5L,MAAM,CAAC,MAAM,gBAAgB,GAC3B,wbAAwb,CAAC;AAE3b,MAAM,CAAC,MAAM,kBAAkB,GAC7B,sNAAsN,CAAC;AAEzN,MAAM,CAAC,MAAM,2BAA2B,GACtC,mJAAmJ,CAAC;AAEtJ,MAAM,CAAC,MAAM,kBAAkB,GAC7B,sQAAsQ,CAAC;AAEzQ;;;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,oEAAoE;QACpE,0EAA0E;QAC1E,qBAAqB;QACrB,OAAO,OAAO,CAAC,gBAAgB;YAC7B,CAAC,CAAC,sHAAsH,kBAAkB,+uBAA+uB;YACz3B,CAAC,CAAC,uJAAuJ,CAAC;IAC9J,CAAC;IACD,IAAI,MAAM,CAAC,YAAY,KAAK,cAAc,EAAE,CAAC;QAC3C,OAAO,OAAO,CAAC,gBAAgB;YAC7B,CAAC,CAAC,+hBAA+hB;YACjiB,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 browser pane 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 browser pane 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,2NAA2N;gBAC/P,CAAC,CAAC,+BAA+B,GAAG,uCAAuC;YAC7E,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,3 @@
+import type { ClientProfile } from "../../client-presentation.js";
+import type { ToolResult } from "../result.js";
+export declare function instructEditApp(result: ToolResult, profile: ClientProfile): string | undefined;

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

@@ -0,0 +1,18 @@
+import { REPLACE_WEDGED_APP, RETRY_UNAVAILABLE_LIVE_EDIT, buildingFollowUp, } from "./copy.js";
+export function instructEditApp(result, profile) {
+    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 buildingFollowUp(profile);
+    }
+    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":"AAEA,OAAO,EACL,kBAAkB,EAClB,2BAA2B,EAC3B,gBAAgB,GACjB,MAAM,WAAW,CAAC;AAEnB,MAAM,UAAU,eAAe,CAC7B,MAAkB,EAClB,OAAsB;IAEtB,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,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACnC,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;

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

@@ -0,0 +1,49 @@
+import { APP_LOAD_CHECK, CHECKPOINT_FAILED, DECIDE_IN_EDITOR, instructUserDecision, REPLACE_WEDGED_APP, } from "./copy.js";
+export function instructGetApp(result, profile) {
+    const instructions = resultInstructions(result, profile);
+    const navigation = result.value.browserNavigation;
+    if (!profile.hasNativeBrowser || !isBrowserNavigation(navigation)) {
+        return instructions;
+    }
+    const browserInstructions = result.pendingAction === "decide_in_editor"
+        ? `Before any other action, ensure ${navigation.url} is open in Cowork's embedded Page browser.`
+        : `Before any other action, ensure ${navigation.url} is open in Cowork's embedded Page browser and verify the app loaded. ${APP_LOAD_CHECK}`;
+    return instructions
+        ? `${browserInstructions}\n\n${instructions}`
+        : browserInstructions;
+}
+function resultInstructions(result, profile) {
+    const screenshot = result.value.screenshotBase64;
+    if (result.status === "ready" &&
+        typeof screenshot === "string" &&
+        screenshot) {
+        return "Inspect the screenshot before telling the user the app looks correct. A skeleton, spinner, empty table/chart, or 'Loading...' is not a defect - call `get_app` again in a few seconds. Do not test, debug, or correct a visible problem unless the user requests it; report what you see.";
+    }
+    if (result.pendingAction === "start_new_app") {
+        return REPLACE_WEDGED_APP;
+    }
+    if (result.pendingAction === "open_editor") {
+        return CHECKPOINT_FAILED;
+    }
+    if (result.pendingAction === "decide_in_editor") {
+        return DECIDE_IN_EDITOR;
+    }
+    const decisionInstructions = instructUserDecision(result, profile);
+    if (decisionInstructions) {
+        return decisionInstructions;
+    }
+    if (result.status === "needs_decision") {
+        return "Call `ask_user` now - do not answer this decision yourself from `get_app`'s output.";
+    }
+    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);
+}
+//# sourceMappingURL=get-app.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-app.js","sourceRoot":"","sources":["../../../../../src/transports/mcp/instructions/tools/get-app.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,WAAW,CAAC;AAEnB,MAAM,UAAU,cAAc,CAC5B,MAAkB,EAClB,OAAsB;IAEtB,MAAM,YAAY,GAAG,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzD,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAAC;IAClD,IAAI,CAAC,OAAO,CAAC,gBAAgB,IAAI,CAAC,mBAAmB,CAAC,UAAU,CAAC,EAAE,CAAC;QAClE,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,MAAM,mBAAmB,GACvB,MAAM,CAAC,aAAa,KAAK,kBAAkB;QACzC,CAAC,CAAC,mCAAmC,UAAU,CAAC,GAAG,6CAA6C;QAChG,CAAC,CAAC,mCAAmC,UAAU,CAAC,GAAG,yEAAyE,cAAc,EAAE,CAAC;IACjJ,OAAO,YAAY;QACjB,CAAC,CAAC,GAAG,mBAAmB,OAAO,YAAY,EAAE;QAC7C,CAAC,CAAC,mBAAmB,CAAC;AAC1B,CAAC;AAED,SAAS,kBAAkB,CACzB,MAAkB,EAClB,OAAsB;IAEtB,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC;IACjD,IACE,MAAM,CAAC,MAAM,KAAK,OAAO;QACzB,OAAO,UAAU,KAAK,QAAQ;QAC9B,UAAU,EACV,CAAC;QACD,OAAO,2RAA2R,CAAC;IACrS,CAAC;IACD,IAAI,MAAM,CAAC,aAAa,KAAK,eAAe,EAAE,CAAC;QAC7C,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IACD,IAAI,MAAM,CAAC,aAAa,KAAK,aAAa,EAAE,CAAC;QAC3C,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IACD,IAAI,MAAM,CAAC,aAAa,KAAK,kBAAkB,EAAE,CAAC;QAChD,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IACD,MAAM,oBAAoB,GAAG,oBAAoB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnE,IAAI,oBAAoB,EAAE,CAAC;QACzB,OAAO,oBAAoB,CAAC;IAC9B,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,KAAK,gBAAgB,EAAE,CAAC;QACvC,OAAO,qFAAqF,CAAC;IAC/F,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,mBAAmB,CAC1B,KAAc;IAEd,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,QAAQ,IAAI,KAAK;QACjB,KAAK,CAAC,MAAM,KAAK,aAAa;QAC9B,KAAK,IAAI,KAAK;QACd,OAAO,KAAK,CAAC,GAAG,KAAK,QAAQ;QAC7B,KAAK,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CACrB,CAAC;AACJ,CAAC"}