mcp-stitch 0.1.0

package/dist/utils/safePath.js

@@ -0,0 +1,81 @@
+import { lstat, mkdir, realpath } from "node:fs/promises";
+import path from "node:path";
+function normalizeForCompare(input) {
+    return process.platform === "win32" ? input.toLowerCase() : input;
+}
+export function sanitizeFileName(name) {
+    const cleaned = name.replace(/[^a-zA-Z0-9._-]/g, "_").replace(/_+/g, "_");
+    return cleaned.length > 0 ? cleaned : "artifact";
+}
+function isPathInside(baseDir, targetPath) {
+    const baseCmp = normalizeForCompare(path.resolve(baseDir) + path.sep);
+    const targetCmp = normalizeForCompare(path.resolve(targetPath));
+    return targetCmp.startsWith(baseCmp) || targetCmp === normalizeForCompare(path.resolve(baseDir));
+}
+function validateRelativePath(relativeFilePath) {
+    if (!relativeFilePath || relativeFilePath.trim().length === 0) {
+        throw new Error("Invalid output path: relative path cannot be empty.");
+    }
+    if (path.isAbsolute(relativeFilePath)) {
+        throw new Error("Invalid output path: absolute paths are not allowed.");
+    }
+    const segments = relativeFilePath.split(/[\\/]+/);
+    for (const segment of segments) {
+        if (!segment || segment === "." || segment === "..") {
+            throw new Error("Invalid output path: path traversal segments are not allowed.");
+        }
+        if (segment.includes(":")) {
+            throw new Error("Invalid output path: suspicious path segment detected.");
+        }
+    }
+}
+async function pathExists(pathname) {
+    try {
+        await lstat(pathname);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function assertNoSymlinkSegments(baseDir, relativeFilePath) {
+    const base = path.resolve(baseDir);
+    const parts = relativeFilePath.split(/[\\/]+/);
+    const parentParts = parts.slice(0, -1);
+    let current = base;
+    for (const part of parentParts) {
+        current = path.join(current, part);
+        if (!(await pathExists(current))) {
+            continue;
+        }
+        const stats = await lstat(current);
+        if (stats.isSymbolicLink()) {
+            throw new Error("Invalid output path: symlink directories are not allowed in output path.");
+        }
+    }
+}
+export async function prepareSafeOutputPath(baseDir, relativeFilePath) {
+    validateRelativePath(relativeFilePath);
+    const base = path.resolve(baseDir);
+    await mkdir(base, { recursive: true });
+    const baseReal = await realpath(base);
+    const fullPath = path.resolve(baseReal, relativeFilePath);
+    if (!isPathInside(baseReal, fullPath)) {
+        throw new Error("Invalid output path: file must stay within the output directory.");
+    }
+    await assertNoSymlinkSegments(baseReal, relativeFilePath);
+    const parent = path.dirname(fullPath);
+    await mkdir(parent, { recursive: true });
+    const parentReal = await realpath(parent);
+    if (!isPathInside(baseReal, parentReal)) {
+        throw new Error("Invalid output path: resolved parent path escapes output directory.");
+    }
+    if (await pathExists(fullPath)) {
+        const fileStats = await lstat(fullPath);
+        if (fileStats.isSymbolicLink()) {
+            throw new Error("Invalid output path: target file cannot be a symlink.");
+        }
+    }
+    return fullPath;
+}
+//# sourceMappingURL=safePath.js.map

package/dist/utils/safePath.js.map

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

package/dist/utils/stitchIds.d.ts

@@ -0,0 +1,12 @@
+export declare function toBareProjectId(projectIdOrName: string): string;
+export declare function toProjectName(projectIdOrName: string): string;
+export declare function toBareAssetId(assetIdOrName: string): string;
+export declare function toAssetName(assetIdOrName: string): string;
+export declare function toBareScreenId(screenIdOrName: string): string;
+export type StitchScreenIdentifier = {
+    name: string;
+    projectId: string;
+    screenId: string;
+};
+export declare function toScreenIdentifier(screenIdOrName: string, projectIdOrName?: string): StitchScreenIdentifier | null;
+//# sourceMappingURL=stitchIds.d.ts.map

package/dist/utils/stitchIds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stitchIds.d.ts","sourceRoot":"","sources":["../../src/utils/stitchIds.ts"],"names":[],"mappings":"AAIA,wBAAgB,eAAe,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAI/D;AAED,wBAAgB,aAAa,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAI7D;AAED,wBAAgB,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAI3D;AAED,wBAAgB,WAAW,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAIzD;AAED,wBAAgB,cAAc,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAG7D;AAED,MAAM,MAAM,sBAAsB,GAAG;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,wBAAgB,kBAAkB,CAChC,cAAc,EAAE,MAAM,EACtB,eAAe,CAAC,EAAE,MAAM,GACvB,sBAAsB,GAAG,IAAI,CAoB/B"}

package/dist/utils/stitchIds.js

@@ -0,0 +1,48 @@
+const PROJECT_PREFIX = "projects/";
+const SCREEN_SEPARATOR = "/screens/";
+const ASSET_PREFIX = "assets/";
+export function toBareProjectId(projectIdOrName) {
+    return projectIdOrName.startsWith(PROJECT_PREFIX)
+        ? projectIdOrName.slice(PROJECT_PREFIX.length)
+        : projectIdOrName;
+}
+export function toProjectName(projectIdOrName) {
+    return projectIdOrName.startsWith(PROJECT_PREFIX)
+        ? projectIdOrName
+        : `${PROJECT_PREFIX}${projectIdOrName}`;
+}
+export function toBareAssetId(assetIdOrName) {
+    return assetIdOrName.startsWith(ASSET_PREFIX)
+        ? assetIdOrName.slice(ASSET_PREFIX.length)
+        : assetIdOrName;
+}
+export function toAssetName(assetIdOrName) {
+    return assetIdOrName.startsWith(ASSET_PREFIX)
+        ? assetIdOrName
+        : `${ASSET_PREFIX}${assetIdOrName}`;
+}
+export function toBareScreenId(screenIdOrName) {
+    const index = screenIdOrName.indexOf(SCREEN_SEPARATOR);
+    return index >= 0 ? screenIdOrName.slice(index + SCREEN_SEPARATOR.length) : screenIdOrName;
+}
+export function toScreenIdentifier(screenIdOrName, projectIdOrName) {
+    if (screenIdOrName.includes(SCREEN_SEPARATOR)) {
+        const [projectName, screenId] = screenIdOrName.split(SCREEN_SEPARATOR);
+        if (!projectName || !screenId)
+            return null;
+        return {
+            name: screenIdOrName,
+            projectId: toBareProjectId(projectName),
+            screenId,
+        };
+    }
+    if (!projectIdOrName)
+        return null;
+    const projectId = toBareProjectId(projectIdOrName);
+    return {
+        name: `${toProjectName(projectId)}/screens/${screenIdOrName}`,
+        projectId,
+        screenId: screenIdOrName,
+    };
+}
+//# sourceMappingURL=stitchIds.js.map

package/dist/utils/stitchIds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stitchIds.js","sourceRoot":"","sources":["../../src/utils/stitchIds.ts"],"names":[],"mappings":"AAAA,MAAM,cAAc,GAAG,WAAW,CAAC;AACnC,MAAM,gBAAgB,GAAG,WAAW,CAAC;AACrC,MAAM,YAAY,GAAG,SAAS,CAAC;AAE/B,MAAM,UAAU,eAAe,CAAC,eAAuB;IACrD,OAAO,eAAe,CAAC,UAAU,CAAC,cAAc,CAAC;QAC/C,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC;QAC9C,CAAC,CAAC,eAAe,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,eAAuB;IACnD,OAAO,eAAe,CAAC,UAAU,CAAC,cAAc,CAAC;QAC/C,CAAC,CAAC,eAAe;QACjB,CAAC,CAAC,GAAG,cAAc,GAAG,eAAe,EAAE,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,aAAqB;IACjD,OAAO,aAAa,CAAC,UAAU,CAAC,YAAY,CAAC;QAC3C,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC;QAC1C,CAAC,CAAC,aAAa,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,aAAqB;IAC/C,OAAO,aAAa,CAAC,UAAU,CAAC,YAAY,CAAC;QAC3C,CAAC,CAAC,aAAa;QACf,CAAC,CAAC,GAAG,YAAY,GAAG,aAAa,EAAE,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,cAAsB;IACnD,MAAM,KAAK,GAAG,cAAc,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACvD,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,KAAK,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC;AAC7F,CAAC;AAQD,MAAM,UAAU,kBAAkB,CAChC,cAAsB,EACtB,eAAwB;IAExB,IAAI,cAAc,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAC9C,MAAM,CAAC,WAAW,EAAE,QAAQ,CAAC,GAAG,cAAc,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;QACvE,IAAI,CAAC,WAAW,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC;QAE3C,OAAO;YACL,IAAI,EAAE,cAAc;YACpB,SAAS,EAAE,eAAe,CAAC,WAAW,CAAC;YACvC,QAAQ;SACT,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,eAAe;QAAE,OAAO,IAAI,CAAC;IAElC,MAAM,SAAS,GAAG,eAAe,CAAC,eAAe,CAAC,CAAC;IACnD,OAAO;QACL,IAAI,EAAE,GAAG,aAAa,CAAC,SAAS,CAAC,YAAY,cAAc,EAAE;QAC7D,SAAS;QACT,QAAQ,EAAE,cAAc;KACzB,CAAC;AACJ,CAAC"}

package/dist/utils/stitchResponse.d.ts

@@ -0,0 +1,11 @@
+type SummaryOptions = {
+    title: string;
+    data: unknown;
+    itemKeys?: string[];
+    idKeys?: string[];
+    maxPreviewChars?: number;
+};
+export declare function safeJsonPreview(value: unknown, maxChars?: number): string;
+export declare function formatStitchSummary(options: SummaryOptions): string;
+export {};
+//# sourceMappingURL=stitchResponse.d.ts.map

package/dist/utils/stitchResponse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stitchResponse.d.ts","sourceRoot":"","sources":["../../src/utils/stitchResponse.ts"],"names":[],"mappings":"AAAA,KAAK,cAAc,GAAG;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAKF,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,SAAO,GAAG,MAAM,CAQvE;AAuDD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAyBnE"}

package/dist/utils/stitchResponse.js

@@ -0,0 +1,71 @@
+const DEFAULT_ITEM_KEYS = ["projects", "screens", "items", "results"];
+const DEFAULT_ID_KEYS = ["name", "id", "project", "projectId", "screenId", "title"];
+export function safeJsonPreview(value, maxChars = 1200) {
+    const text = JSON.stringify(value, null, 2) ?? "null";
+    if (text.length <= maxChars) {
+        return text;
+    }
+    return `${text.slice(0, maxChars)}\n... [truncated ${text.length - maxChars} chars]`;
+}
+function findItems(data, itemKeys) {
+    if (Array.isArray(data)) {
+        return data;
+    }
+    if (!data || typeof data !== "object") {
+        return null;
+    }
+    const obj = data;
+    for (const key of itemKeys) {
+        const value = obj[key];
+        if (Array.isArray(value)) {
+            return value;
+        }
+    }
+    for (const value of Object.values(obj)) {
+        if (Array.isArray(value)) {
+            return value;
+        }
+    }
+    return null;
+}
+function pickSampleIds(items, idKeys) {
+    const ids = [];
+    for (const item of items) {
+        if (!item || typeof item !== "object") {
+            continue;
+        }
+        const obj = item;
+        for (const key of idKeys) {
+            const value = obj[key];
+            if (typeof value === "string" && value.trim().length > 0) {
+                ids.push(value.trim());
+                break;
+            }
+        }
+        if (ids.length >= 5) {
+            break;
+        }
+    }
+    return ids;
+}
+export function formatStitchSummary(options) {
+    const itemKeys = options.itemKeys ?? DEFAULT_ITEM_KEYS;
+    const idKeys = options.idKeys ?? DEFAULT_ID_KEYS;
+    const maxPreviewChars = options.maxPreviewChars ?? 1200;
+    const items = findItems(options.data, itemKeys);
+    const ids = items ? pickSampleIds(items, idKeys) : [];
+    const lines = [options.title, ""];
+    if (items) {
+        lines.push(`Item count: ${items.length}`);
+    }
+    if (ids.length > 0) {
+        lines.push(`Sample ids: ${ids.join(", ")}`);
+    }
+    if (options.data && typeof options.data === "object" && !Array.isArray(options.data)) {
+        const keys = Object.keys(options.data);
+        lines.push(`Top-level keys: ${keys.slice(0, 10).join(", ") || "(none)"}`);
+    }
+    lines.push("", "Preview:", safeJsonPreview(options.data, maxPreviewChars));
+    return lines.join("\n");
+}
+//# sourceMappingURL=stitchResponse.js.map

package/dist/utils/stitchResponse.js.map

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

package/dist/utils/stitchScreenResolver.d.ts

@@ -0,0 +1,26 @@
+import type { StitchClient } from "../services/stitchClient.js";
+import type { JsonObject } from "../models/stitch.js";
+type ResolveScreenSuccess = {
+    ok: true;
+    input: JsonObject;
+    resolver: {
+        requested: string;
+        projectId?: string;
+        strategy: "full-resource-name" | "list-screens-match";
+        matchedName: string;
+        matchedScreenId: string;
+        matchedTitle?: string;
+    };
+};
+type ResolveScreenFailure = {
+    ok: false;
+    error: string;
+};
+export type ResolveScreenResult = ResolveScreenSuccess | ResolveScreenFailure;
+export declare function resolveScreenInput(options: {
+    client: StitchClient;
+    screenIdOrName: string;
+    projectIdOrName?: string | undefined;
+}): Promise<ResolveScreenResult>;
+export {};
+//# sourceMappingURL=stitchScreenResolver.d.ts.map

package/dist/utils/stitchScreenResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stitchScreenResolver.d.ts","sourceRoot":"","sources":["../../src/utils/stitchScreenResolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAatD,KAAK,oBAAoB,GAAG;IAC1B,EAAE,EAAE,IAAI,CAAC;IACT,KAAK,EAAE,UAAU,CAAC;IAClB,QAAQ,EAAE;QACR,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,oBAAoB,GAAG,oBAAoB,CAAC;QACtD,WAAW,EAAE,MAAM,CAAC;QACpB,eAAe,EAAE,MAAM,CAAC;QACxB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;CACH,CAAC;AAEF,KAAK,oBAAoB,GAAG;IAC1B,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,oBAAoB,GAAG,oBAAoB,CAAC;AAoH9E,wBAAsB,kBAAkB,CAAC,OAAO,EAAE;IAChD,MAAM,EAAE,YAAY,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAyE/B"}

package/dist/utils/stitchScreenResolver.js

@@ -0,0 +1,159 @@
+import { toBareProjectId, toScreenIdentifier, } from "./stitchIds.js";
+function normalizeLookupText(value) {
+    return value.trim().replace(/\s+/g, " ").toLowerCase();
+}
+function getString(obj, key) {
+    const value = obj[key];
+    return typeof value === "string" && value.trim().length > 0 ? value.trim() : undefined;
+}
+function toScreenId(name) {
+    const marker = "/screens/";
+    const index = name.indexOf(marker);
+    return index >= 0 ? name.slice(index + marker.length) : name;
+}
+function toScreenSummary(value) {
+    if (!value || typeof value !== "object")
+        return null;
+    const obj = value;
+    const name = getString(obj, "name") ?? getString(obj, "sourceScreen");
+    if (!name)
+        return null;
+    const title = getString(obj, "title");
+    return {
+        name,
+        screenId: getString(obj, "screenId") ?? getString(obj, "id") ?? toScreenId(name),
+        ...(title ? { title } : {}),
+    };
+}
+function parseContentJson(data) {
+    const content = data.content;
+    if (!Array.isArray(content))
+        return null;
+    for (const item of content) {
+        if (!item || typeof item !== "object")
+            continue;
+        const text = item.text;
+        if (typeof text !== "string")
+            continue;
+        try {
+            return JSON.parse(text);
+        }
+        catch {
+            continue;
+        }
+    }
+    return null;
+}
+function extractScreens(data) {
+    if (!data || typeof data !== "object")
+        return [];
+    const obj = data;
+    const structuredContent = obj.structuredContent;
+    const source = structuredContent && typeof structuredContent === "object"
+        ? structuredContent
+        : parseContentJson(obj);
+    if (!source || typeof source !== "object")
+        return [];
+    const screens = source.screens;
+    if (!Array.isArray(screens))
+        return [];
+    return screens
+        .map((screen) => toScreenSummary(screen))
+        .filter((screen) => Boolean(screen));
+}
+function toIdentifier(screen) {
+    return toScreenIdentifier(screen.name);
+}
+function formatScreen(screen) {
+    const title = screen.title ? ` title="${screen.title}"` : "";
+    return `- ${screen.name} (screenId: ${screen.screenId}${title})`;
+}
+function ambiguityError(lookup, matches) {
+    return [
+        `Ambiguous screen lookup: "${lookup}" matched ${matches.length} screens.`,
+        "Use a full screen resource name or one of these screen ids:",
+        ...matches.map((match) => formatScreen(match)),
+    ].join("\n");
+}
+function notFoundError(lookup, projectId) {
+    return `No screen matched "${lookup}" in project ${projectId}. Use stitch_list_screens to inspect available screens, then retry with a full screen resource name or exact screen id.`;
+}
+function identifierFieldsForMatch(screen) {
+    return [screen.name, screen.screenId];
+}
+function lookupFieldsForMatch(screen) {
+    return [screen.name, screen.screenId, screen.title ?? ""].filter((value) => value.length > 0);
+}
+function findMatches(lookup, screens) {
+    const normalizedLookup = normalizeLookupText(lookup);
+    const exactIdentifierMatches = screens.filter((screen) => identifierFieldsForMatch(screen).some((field) => normalizeLookupText(field) === normalizedLookup));
+    if (exactIdentifierMatches.length > 0) {
+        return exactIdentifierMatches;
+    }
+    return screens.filter((screen) => lookupFieldsForMatch(screen).some((field) => normalizeLookupText(field).includes(normalizedLookup)));
+}
+export async function resolveScreenInput(options) {
+    const directIdentifier = toScreenIdentifier(options.screenIdOrName);
+    if (directIdentifier) {
+        return {
+            ok: true,
+            input: directIdentifier,
+            resolver: {
+                requested: options.screenIdOrName,
+                projectId: directIdentifier.projectId,
+                strategy: "full-resource-name",
+                matchedName: directIdentifier.name,
+                matchedScreenId: directIdentifier.screenId,
+            },
+        };
+    }
+    if (!options.projectIdOrName) {
+        return {
+            ok: false,
+            error: "Invalid screen lookup: provide a full screen resource name, or provide projectId with a screen id/title fragment.",
+        };
+    }
+    const projectId = toBareProjectId(options.projectIdOrName);
+    const listResult = await options.client.callTool({
+        toolName: "list_screens",
+        input: { projectId },
+    });
+    if (!listResult.ok) {
+        return {
+            ok: false,
+            error: `Failed to resolve screen lookup because list_screens failed.\n\n${listResult.error}`,
+        };
+    }
+    const screens = extractScreens(listResult.data);
+    const matches = findMatches(options.screenIdOrName, screens);
+    if (matches.length === 0) {
+        return { ok: false, error: notFoundError(options.screenIdOrName, projectId) };
+    }
+    if (matches.length > 1) {
+        return { ok: false, error: ambiguityError(options.screenIdOrName, matches) };
+    }
+    const match = matches[0];
+    if (!match) {
+        return { ok: false, error: notFoundError(options.screenIdOrName, projectId) };
+    }
+    const identifier = toIdentifier(match);
+    if (!identifier) {
+        return {
+            ok: false,
+            error: `Matched screen "${match.name}" but could not build a get_screen identifier.`,
+        };
+    }
+    return {
+        ok: true,
+        input: identifier,
+        resolver: {
+            requested: options.screenIdOrName,
+            projectId,
+            strategy: "list-screens-match",
+            matchedName: identifier.name,
+            matchedScreenId: identifier.screenId,
+            ...(match.title ? { matchedTitle: match.title } : {}),
+        },
+    };
+}
+//# sourceMappingURL=stitchScreenResolver.js.map

package/dist/utils/stitchScreenResolver.js.map

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

package/dist/utils/stitchToolHelpers.d.ts

@@ -0,0 +1,6 @@
+import type { JsonObject, StitchCallResponse } from "../models/stitch.js";
+export declare function toErrorText(prefix: string, message: string): string;
+export declare function requireConfirmation(action: string, confirm?: boolean): string | null;
+export declare function compactStitchResult(title: string, result: StitchCallResponse): string;
+export declare function jsonObjectFromRaw(rawInput: JsonObject | undefined): JsonObject | undefined;
+//# sourceMappingURL=stitchToolHelpers.d.ts.map

package/dist/utils/stitchToolHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stitchToolHelpers.d.ts","sourceRoot":"","sources":["../../src/utils/stitchToolHelpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAG1E,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAIpF;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAYrF;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAE1F"}

package/dist/utils/stitchToolHelpers.js

@@ -0,0 +1,25 @@
+import { formatStitchSummary } from "./stitchResponse.js";
+export function toErrorText(prefix, message) {
+    return `${prefix}\n\n${message}`;
+}
+export function requireConfirmation(action, confirm) {
+    return confirm === true
+        ? null
+        : `${action} is a mutating Stitch operation. Re-run with confirm: true to proceed.`;
+}
+export function compactStitchResult(title, result) {
+    if (!result.ok) {
+        return toErrorText(`${title} failed.`, result.error);
+    }
+    return formatStitchSummary({
+        title,
+        data: result.data,
+        itemKeys: ["projects", "screens", "assets", "designSystems", "items", "results", "outputComponents"],
+        idKeys: ["name", "id", "projectId", "screenId", "assetId", "title", "displayName"],
+        maxPreviewChars: 900,
+    });
+}
+export function jsonObjectFromRaw(rawInput) {
+    return rawInput;
+}
+//# sourceMappingURL=stitchToolHelpers.js.map

package/dist/utils/stitchToolHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stitchToolHelpers.js","sourceRoot":"","sources":["../../src/utils/stitchToolHelpers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE1D,MAAM,UAAU,WAAW,CAAC,MAAc,EAAE,OAAe;IACzD,OAAO,GAAG,MAAM,OAAO,OAAO,EAAE,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,MAAc,EAAE,OAAiB;IACnE,OAAO,OAAO,KAAK,IAAI;QACrB,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,GAAG,MAAM,wEAAwE,CAAC;AACxF,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAa,EAAE,MAA0B;IAC3E,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,OAAO,WAAW,CAAC,GAAG,KAAK,UAAU,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IACvD,CAAC;IAED,OAAO,mBAAmB,CAAC;QACzB,KAAK;QACL,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,QAAQ,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,eAAe,EAAE,OAAO,EAAE,SAAS,EAAE,kBAAkB,CAAC;QACpG,MAAM,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,CAAC;QAClF,eAAe,EAAE,GAAG;KACrB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,QAAgC;IAChE,OAAO,QAAQ,CAAC;AAClB,CAAC"}