@superblocksteam/gateway 2.0.0-SNAPSHOT.2161f9a02a4eb5d8

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,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,72 @@
+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;
+    }
+    if (result.status === "live_edit_terminated") {
+        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 === "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" &&
+        !/^Superblocks is still generating \(\d+s\)$/.test(line));
+}
+//# 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,2 @@
+import type { ToolResult } from "../result.js";
+export declare function instructCheckPublishProgress(result: ToolResult): string | undefined;

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

@@ -0,0 +1,14 @@
+export function instructCheckPublishProgress(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,MAAM,UAAU,4BAA4B,CAC1C,MAAkB;IAElB,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,8 @@
+/** 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 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.";
+export declare function instructUserDecision(result: ToolResult, profile: ClientProfile): string | undefined;

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

@@ -0,0 +1,19 @@
+/** Instructions shared verbatim by more than one tool. */
+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 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.";
+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;AAK1D,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,kBAAkB,GAC7B,mPAAmP,CAAC;AAEtP,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,3 @@
+import type { ClientProfile } from "../../client-presentation.js";
+import { type ToolResult } from "../result.js";
+export declare function instructCreateIntegration(result: ToolResult, profile: ClientProfile): string | undefined;

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

@@ -0,0 +1,32 @@
+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 opening = typeof url === "string" && url
+        ? profile.hasNativeBrowser
+            ? `Open the exact returned URL ${url} in Cowork's embedded browser side panel.`
+            : "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 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)) {
+        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. Wait for the user to confirm configuration is complete, then ${wiring}`;
+}
+function isPublicIntegration(result) {
+    const integration = result.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,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,OAAO,GACX,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG;QAC5B,CAAC,CAAC,OAAO,CAAC,gBAAgB;YACxB,CAAC,CAAC,+BAA+B,GAAG,2CAA2C;YAC/E,CAAC,CAAC,qGAAqG;QACzG,CAAC,CAAC,gFAAgF,CAAC;IACvF,MAAM,MAAM,GAAG,oDAAoD,aAAa,uHAAuH,CAAC;IAExM,IAAI,mBAAmB,CAAC,MAAM,CAAC,EAAE,CAAC;QAChC,OAAO,GAAG,OAAO,iHAAiH,MAAM,EAAE,CAAC;IAC7I,CAAC;IACD,OAAO,GAAG,OAAO,4IAA4I,MAAM,EAAE,CAAC;AACxK,CAAC;AAED,SAAS,mBAAmB,CAAC,MAAkB;IAC7C,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC;IAC7C,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,14 @@
+import { BUILDING_FOLLOW_UP, REPLACE_WEDGED_APP } from "./copy.js";
+export function instructEditApp(result) {
+    if (result.pendingAction === "start_new_app") {
+        return REPLACE_WEDGED_APP;
+    }
+    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,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAEnE,MAAM,UAAU,eAAe,CAAC,MAAkB;IAChD,IAAI,MAAM,CAAC,aAAa,KAAK,eAAe,EAAE,CAAC;QAC7C,OAAO,kBAAkB,CAAC;IAC5B,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;

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

@@ -0,0 +1,47 @@
+import { CHECKPOINT_FAILED, 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 = `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) {
+    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. A problem a user would plainly recognize as wrong warrants one `edit_app` call with a concrete correction, then inspect the next screenshot.";
+    }
+    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 "Open the app's `editUrl` so the user can answer in the Superblocks editor. Do not call `ask_user`.";
+    }
+    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,iBAAiB,EACjB,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,GAAG,mCAAmC,UAAU,CAAC,GAAG,uEAAuE,CAAC;IACrJ,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,qUAAqU,CAAC;IAC/U,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,oGAAoG,CAAC;IAC9G,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"}

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,26 @@
+import { instructAskUser } from "./ask-user.js";
+import { instructCheckAppProgress } from "./check-app-progress.js";
+import { instructCheckPublishProgress } from "./check-publish-progress.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 { instructPreviewApp } from "./preview-app.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,
+    check_app_progress: instructCheckAppProgress,
+    check_publish_progress: instructCheckPublishProgress,
+    create_integration: instructCreateIntegration,
+    edit_app: instructEditApp,
+    get_app: instructGetApp,
+    get_integration_metadata: instructGetIntegrationMetadata,
+    preview_app: instructPreviewApp,
+    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,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,4BAA4B,EAAE,MAAM,6BAA6B,CAAC;AAC3E,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,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,kBAAkB,EAAE,wBAAwB;IAC5C,sBAAsB,EAAE,4BAA4B;IACpD,kBAAkB,EAAE,yBAAyB;IAC7C,QAAQ,EAAE,eAAe;IACzB,OAAO,EAAE,cAAc;IACvB,wBAAwB,EAAE,8BAA8B;IACxD,WAAW,EAAE,kBAAkB;IAC/B,WAAW,EAAE,kBAAkB;IAC/B,SAAS,EAAE,gBAAgB;IAC3B,eAAe,EAAE,sBAAsB;CACxC,CAAC"}

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

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

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

@@ -0,0 +1,14 @@
+export function instructPreviewApp(result, profile) {
+    const { previewUrl } = result.value;
+    if (profile.hasNativeBrowser &&
+        result.status === "ready" &&
+        typeof previewUrl === "string" &&
+        previewUrl) {
+        return `Before any other action, ensure ${previewUrl} is open in Cowork's embedded Page browser and verify the preview loaded.`;
+    }
+    if (result.status === "ready" && result.value.needsBrowserDriver === true) {
+        return "No local browser is available to screenshot this preview. Share `previewUrl` directly and skip the screenshot rather than reporting a failure.";
+    }
+    return undefined;
+}
+//# sourceMappingURL=preview-app.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"preview-app.js","sourceRoot":"","sources":["../../../../../src/transports/mcp/instructions/tools/preview-app.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,kBAAkB,CAChC,MAAkB,EAClB,OAAsB;IAEtB,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC;IACpC,IACE,OAAO,CAAC,gBAAgB;QACxB,MAAM,CAAC,MAAM,KAAK,OAAO;QACzB,OAAO,UAAU,KAAK,QAAQ;QAC9B,UAAU,EACV,CAAC;QACD,OAAO,mCAAmC,UAAU,2EAA2E,CAAC;IAClI,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,KAAK,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,kBAAkB,KAAK,IAAI,EAAE,CAAC;QAC1E,OAAO,gJAAgJ,CAAC;IAC1J,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

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

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

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

@@ -0,0 +1,11 @@
+export function instructPublishApp(result) {
+    // `publishing` rather than `deployed` reads as a half-failure to the caller.
+    if (result.status === "publishing") {
+        return "Superblocks has started the publish. Tell the user the publish is rolling out, 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,MAAM,UAAU,kBAAkB,CAAC,MAAkB;IACnD,6EAA6E;IAC7E,IAAI,MAAM,CAAC,MAAM,KAAK,YAAY,EAAE,CAAC;QACnC,OAAO,gLAAgL,CAAC;IAC1L,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,2 @@
+import type { ToolResult } from "../result.js";
+export declare function instructStartApp(result: ToolResult): string | undefined;

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

@@ -0,0 +1,18 @@
+import { BUILDING_FOLLOW_UP, REPLACE_WEDGED_APP } from "./copy.js";
+export function instructStartApp(result) {
+    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.";
+    }
+    // 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 BUILDING_FOLLOW_UP;
+    }
+    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":"AACA,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAEnE,MAAM,UAAU,gBAAgB,CAAC,MAAkB;IACjD,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,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,kBAAkB,CAAC;IAC5B,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;