@superblocksteam/vite-plugin-file-sync 2.0.165-next.0 → 2.0.166-next.1

package/dist/ai-service/agent/tools/apis/sdk-root-documentation.js

@@ -0,0 +1,284 @@
+import { createHash } from "node:crypto";
+import { fromMarkdown } from "mdast-util-from-markdown";
+import { safeJsonStringify } from "../../../../util/log-sanitizer.js";
+const EMPTY_SOURCE_ID = "missing";
+const INDEX_SECTION_ID = "@index";
+function nodeOffset(node, edge) {
+    return node.position?.[edge].offset;
+}
+function nodeText(node) {
+    if ("value" in node && typeof node.value === "string") {
+        return node.value;
+    }
+    if (node.type === "image" || node.type === "imageReference") {
+        return node.alt ?? "";
+    }
+    if ("children" in node) {
+        return node.children.map((child) => nodeText(child)).join("");
+    }
+    return "";
+}
+function sectionSlug(title) {
+    return (title
+        .normalize("NFKD")
+        .replace(/[\u0300-\u036f]/g, "")
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-|-$/g, "")
+        .slice(0, 80) || "section");
+}
+function parseRootDocumentation(markdown) {
+    const tree = fromMarkdown(markdown);
+    const sourceId = markdown
+        ? createHash("sha256").update(markdown).digest("hex").slice(0, 12)
+        : EMPTY_SOURCE_ID;
+    const headings = tree.children.flatMap((node, childIndex) => {
+        if (node.type !== "heading") {
+            return [];
+        }
+        const start = nodeOffset(node, "start");
+        if (start === undefined) {
+            return [];
+        }
+        return [{ node, childIndex, start }];
+    });
+    const slugCounts = new Map();
+    const sections = headings.map(({ node, childIndex, start }, headingIndex) => {
+        const title = nodeText(node).trim();
+        const slug = sectionSlug(title);
+        const occurrence = (slugCounts.get(slug) ?? 0) + 1;
+        slugCounts.set(slug, occurrence);
+        const nextBoundaryIndex = headings.findIndex((candidate, candidateIndex) => candidateIndex > headingIndex && candidate.node.depth <= node.depth);
+        const boundary = nextBoundaryIndex === -1 ? undefined : headings[nextBoundaryIndex];
+        return {
+            id: occurrence === 1 ? slug : `${slug}-${occurrence}`,
+            title,
+            depth: node.depth,
+            start,
+            end: boundary?.start ?? markdown.length,
+            childStart: childIndex,
+            childEnd: boundary?.childIndex ?? tree.children.length,
+        };
+    });
+    return { markdown, tree, sourceId, sections };
+}
+function rootResult(documentation, root) {
+    return { documentation, root };
+}
+function buildIndex(parsed, notice, orientation, budget = Number.POSITIVE_INFINITY, offset = 0) {
+    if (!parsed.markdown) {
+        return rootResult([
+            orientation,
+            "SDK root documentation is unavailable in the installed @superblocksteam/sdk-api package. Do not guess SDK contracts; retry after the package installation is repaired.",
+        ]
+            .filter(Boolean)
+            .join("\n\n"), { sourceId: parsed.sourceId });
+    }
+    const lines = parsed.sections.map((section) => `${"  ".repeat(Math.max(0, section.depth - 1))}- \`${section.id}\` — ${section.title.slice(0, 160)}`);
+    if (lines.length === 0) {
+        return rootResult("The installed SDK README contains no discoverable Markdown headings. Do not guess SDK contracts; repair or update the installed @superblocksteam/sdk-api package.", { sourceId: parsed.sourceId });
+    }
+    const header = [
+        "## SDK root documentation index",
+        "",
+        ...(notice ? [`> ${notice}`, ""] : []),
+        ...(orientation ? [orientation, ""] : []),
+        'Request an ID below with `getSdkApiDocs({ section: "<id>" })`. If `root.continuation` is present, pass it exactly to `getSdkApiDocs({ continuation: "<token>" })`.',
+        "",
+    ];
+    let end = offset;
+    let best = rootResult(header.join("\n"), {
+        sourceId: parsed.sourceId,
+        section: INDEX_SECTION_ID,
+        range: { start: offset, end, total: lines.length },
+        continuation: encodeContinuation({
+            sourceId: parsed.sourceId,
+            section: INDEX_SECTION_ID,
+            offset: Math.max(1, end),
+        }),
+    });
+    while (end < lines.length) {
+        const candidateEnd = end + 1;
+        const continuation = candidateEnd < lines.length
+            ? encodeContinuation({
+                sourceId: parsed.sourceId,
+                section: INDEX_SECTION_ID,
+                offset: candidateEnd,
+            })
+            : undefined;
+        const candidate = rootResult([...header, ...lines.slice(offset, candidateEnd)].join("\n"), {
+            sourceId: parsed.sourceId,
+            section: INDEX_SECTION_ID,
+            range: { start: offset, end: candidateEnd, total: lines.length },
+            ...(continuation ? { continuation } : {}),
+        });
+        if (!resultFitsBudget(candidate, budget)) {
+            break;
+        }
+        best = candidate;
+        end = candidateEnd;
+    }
+    return best;
+}
+function encodeContinuation(value) {
+    return Buffer.from(JSON.stringify(value)).toString("base64url");
+}
+function decodeContinuation(value) {
+    try {
+        const parsed = JSON.parse(Buffer.from(value, "base64url").toString("utf8"));
+        if (typeof parsed.sourceId !== "string" ||
+            typeof parsed.section !== "string" ||
+            typeof parsed.offset !== "number" ||
+            !Number.isSafeInteger(parsed.offset) ||
+            parsed.offset <= 0) {
+            return undefined;
+        }
+        return {
+            sourceId: parsed.sourceId,
+            section: parsed.section,
+            offset: parsed.offset,
+        };
+    }
+    catch {
+        return undefined;
+    }
+}
+function collectReferenceIdentifiers(node, identifiers) {
+    if (node.type === "linkReference" || node.type === "imageReference") {
+        identifiers.add(node.identifier.toLowerCase());
+    }
+    if ("children" in node) {
+        for (const child of node.children) {
+            collectReferenceIdentifiers(child, identifiers);
+        }
+    }
+}
+function externalDefinitions(parsed, section) {
+    const identifiers = new Set();
+    for (const node of parsed.tree.children.slice(section.childStart, section.childEnd)) {
+        collectReferenceIdentifiers(node, identifiers);
+    }
+    if (identifiers.size === 0) {
+        return "";
+    }
+    const definitions = parsed.tree.children.flatMap((node) => {
+        if (node.type !== "definition") {
+            return [];
+        }
+        const start = nodeOffset(node, "start");
+        const end = nodeOffset(node, "end");
+        if (start === undefined ||
+            end === undefined ||
+            (start >= section.start && end <= section.end) ||
+            !identifiers.has(node.identifier.toLowerCase())) {
+            return [];
+        }
+        return [parsed.markdown.slice(start, end)];
+    });
+    return definitions.length > 0
+        ? `\n\n<!-- Reference definitions used by this section -->\n${definitions.join("\n")}`
+        : "";
+}
+function resultFitsBudget(result, budget) {
+    return safeJsonStringify({ ...result, plugins: [] }).length <= budget;
+}
+function pageResult(parsed, section, offset, end, preamble, definitions) {
+    const total = section.end - section.start;
+    const continuation = end < total
+        ? encodeContinuation({
+            sourceId: parsed.sourceId,
+            section: section.id,
+            offset: end,
+        })
+        : undefined;
+    return rootResult(preamble +
+        parsed.markdown.slice(section.start + offset, section.start + end) +
+        definitions, {
+        sourceId: parsed.sourceId,
+        section: section.id,
+        range: { start: offset, end, total },
+        ...(continuation ? { continuation } : {}),
+    });
+}
+function blockBoundaries(parsed, section) {
+    const nodes = parsed.tree.children.slice(section.childStart, section.childEnd);
+    const boundaries = nodes.slice(1).flatMap((node) => {
+        const start = nodeOffset(node, "start");
+        return start === undefined ? [] : [start - section.start];
+    });
+    boundaries.push(section.end - section.start);
+    return boundaries;
+}
+function paginateSection(parsed, section, offset, budget, preamble) {
+    const total = section.end - section.start;
+    const definitions = externalDefinitions(parsed, section);
+    const boundaries = blockBoundaries(parsed, section).filter((boundary) => boundary > offset);
+    let best = offset;
+    for (const boundary of boundaries) {
+        if (resultFitsBudget(pageResult(parsed, section, offset, boundary, preamble, definitions), budget)) {
+            best = boundary;
+            continue;
+        }
+        break;
+    }
+    if (best === offset) {
+        let low = offset + 1;
+        let high = boundaries[0] ?? total;
+        while (low <= high) {
+            const candidate = Math.floor((low + high) / 2);
+            if (resultFitsBudget(pageResult(parsed, section, offset, candidate, preamble, definitions), budget)) {
+                best = candidate;
+                low = candidate + 1;
+            }
+            else {
+                high = candidate - 1;
+            }
+        }
+    }
+    if (best === offset) {
+        return rootResult("This SDK README section cannot fit within the tool response budget. Request a narrower nested section from getSdkApiDocs() instead.", { sourceId: parsed.sourceId, section: section.id });
+    }
+    return pageResult(parsed, section, offset, best, preamble, definitions);
+}
+export function buildRootDocumentation(markdown, selector, budget, notice, orientation) {
+    const parsed = parseRootDocumentation(markdown);
+    const invalidSelector = (message) => buildIndex(parsed, [notice, message].filter(Boolean).join(" "), orientation, budget);
+    if (!selector.section && !selector.continuation) {
+        return buildIndex(parsed, notice, orientation, budget);
+    }
+    if (selector.section && selector.continuation) {
+        return invalidSelector("Pass either section or continuation, not both.");
+    }
+    let sectionId = selector.section;
+    let offset = 0;
+    if (selector.continuation) {
+        const continuation = decodeContinuation(selector.continuation);
+        if (!continuation) {
+            return invalidSelector("The continuation token is invalid. Choose a section from the current index and start again.");
+        }
+        if (continuation.sourceId !== parsed.sourceId) {
+            return invalidSelector("The continuation token is stale because the installed SDK README changed. Choose a section from this refreshed index and start again.");
+        }
+        sectionId = continuation.section;
+        offset = continuation.offset;
+    }
+    if (sectionId === INDEX_SECTION_ID) {
+        return buildIndex(parsed, notice, orientation, budget, offset);
+    }
+    const section = parsed.sections.find((candidate) => candidate.id === sectionId);
+    if (!section) {
+        return invalidSelector(`Unknown SDK README section \`${sectionId ?? ""}\`. Choose an ID from this index.`);
+    }
+    const total = section.end - section.start;
+    if (offset >= total) {
+        return invalidSelector("The continuation token points beyond the current section. Choose a section from the index and start again.");
+    }
+    // Every page repeats the notice and orientation so a section fetched
+    // directly, or refetched after compaction, still carries them.
+    const preamble = [notice && `> ${notice}`, orientation]
+        .filter(Boolean)
+        .map((part) => `${part}\n\n`)
+        .join("");
+    return paginateSection(parsed, section, offset, budget, preamble);
+}
+//# sourceMappingURL=sdk-root-documentation.js.map

package/dist/ai-service/agent/tools/apis/sdk-root-documentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-root-documentation.js","sourceRoot":"","sources":["../../../../../src/ai-service/agent/tools/apis/sdk-root-documentation.ts"],"names":[],"mappings":"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"}

package/dist/ai-service/agent/tools/apis/spreadsheet-csv.d.ts

@@ -0,0 +1,77 @@
+export type SpreadsheetSheetRole = "data table" | "derived report" | "empty";
+export type SpreadsheetFormulaExample = {
+    cachedResult: string;
+    cell: string;
+    formula: string;
+};
+export type SpreadsheetColumnDigest = {
+    columnIndex: number;
+    /** True when the workbook hides this column from its own readers. */
+    hidden?: boolean;
+    /** The column's formula with row numbers dropped, e.g. "B#*C#". */
+    computed?: string;
+    /** How many populated cells follow `computed`, e.g. "5000/5000". */
+    coverage?: string;
+    errorCellCount?: number;
+    example?: SpreadsheetFormulaExample;
+    /** The cell number format when the column has one, e.g. "yyyy-mm-dd". */
+    format?: string;
+    name: string;
+    type?: "boolean" | "date" | "number" | "text";
+};
+export type SpreadsheetFooterAggregate = {
+    aggregates: string[];
+    label: string;
+};
+export type SpreadsheetSheetDigest = {
+    /** A title above the header row, which belongs on a page rather than a table. */
+    banner?: string;
+    columns: SpreadsheetColumnDigest[];
+    dataRowCount: number;
+    footerAggregates?: SpreadsheetFooterAggregate[];
+    headerRowNumber: number;
+    /** True when the workbook hides this sheet from its own readers. */
+    hidden?: boolean;
+    /** Sentences written under the table, kept out of the rows. */
+    notes?: string[];
+    /** Other sheets this sheet's formulas read from. */
+    readsFrom?: string[];
+    role: SpreadsheetSheetRole;
+    sheetName: string;
+};
+export type SpreadsheetCsvSheet = {
+    /** Only a data table exports rows; a derived report is described, not imported. */
+    csv?: string;
+    digest: SpreadsheetSheetDigest;
+    /** The CSV file name, present only for a sheet that exports rows. */
+    fileName?: string;
+};
+/**
+ * A small workbook can expand into far more CSV than it occupies on disk, so
+ * bound the converted output the same way archive extraction is bounded.
+ */
+export declare const MAX_WORKBOOK_CSV_BYTES: number;
+export declare const MAX_WORKBOOK_CELLS = 1000000;
+/**
+ * An `.xlsx` is a zip, so the upload size limit bounds the compressed bytes
+ * rather than what the reader builds in memory. A million cells measured out
+ * at roughly 40 MiB of sheet XML, so this is the same ceiling as
+ * MAX_WORKBOOK_CELLS expressed in the only unit available before the reader
+ * has built a grid to count. It covers the whole archive because the reader
+ * expands every member it finds.
+ */
+export declare const MAX_WORKBOOK_INFLATED_BYTES: number;
+/**
+ * Parse an Excel workbook into what an app needs from it: a structure digest
+ * describing every sheet, and CSV rows for the sheets that hold data. Generated
+ * SDK APIs can only parse CSV, so this conversion happens before the file
+ * reaches testApi or the JavaScript sandbox.
+ */
+export declare function convertWorkbookToCsvSheets(input: {
+    bytes: Uint8Array;
+    fileName: string;
+    maxCells?: number;
+    maxCsvBytes?: number;
+    maxInflatedBytes?: number;
+}): Promise<SpreadsheetCsvSheet[]>;
+//# sourceMappingURL=spreadsheet-csv.d.ts.map

package/dist/ai-service/agent/tools/apis/spreadsheet-csv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spreadsheet-csv.d.ts","sourceRoot":"","sources":["../../../../../src/ai-service/agent/tools/apis/spreadsheet-csv.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,oBAAoB,GAAG,YAAY,GAAG,gBAAgB,GAAG,OAAO,CAAC;AAE7E,MAAM,MAAM,yBAAyB,GAAG;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,yBAAyB,CAAC;IACpC,yEAAyE;IACzE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;CAC/C,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,iFAAiF;IACjF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,uBAAuB,EAAE,CAAC;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,0BAA0B,EAAE,CAAC;IAChD,eAAe,EAAE,MAAM,CAAC;IACxB,oEAAoE;IACpE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,+DAA+D;IAC/D,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,IAAI,EAAE,oBAAoB,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,mFAAmF;IACnF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,sBAAsB,CAAC;IAC/B,qEAAqE;IACrE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,QAAoB,CAAC;AACxD,eAAO,MAAM,kBAAkB,UAAY,CAAC;AAC5C;;;;;;;GAOG;AACH,eAAO,MAAM,2BAA2B,QAAmB,CAAC;AAsU5D;;;;;GAKG;AACH,wBAAsB,0BAA0B,CAAC,KAAK,EAAE;IACtD,KAAK,EAAE,UAAU,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC,CA2DjC"}