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

package/dist/ai-service/agent/tools/apis/attachment-file-inputs.js

@@ -0,0 +1,208 @@
+import path from "node:path";
+import { resolveAttachmentFileName, } from "@superblocksteam/library-shared/types";
+import { assertAttachmentSize, getTextAttachmentType, isXlsxAttachmentFile, } from "@superblocksteam/shared";
+import { AttachmentsStore } from "../../../attachments/index.js";
+import { getCanonicalAttachmentUrl } from "../../../attachments/uploaded-content-part.js";
+import { getActiveContext } from "../../../llm/context-v2/utils/index.js";
+import { scrubSecrets, stripUnsafeChars } from "../../../types.js";
+import { resolveUploadedAttachmentLeases } from "../../tools2/tools/attachment-lease-resolver.js";
+import { convertWorkbookToCsvSheets } from "./spreadsheet-csv.js";
+const ATTACHMENT_FETCH_TIMEOUT_MS = 30_000;
+// Browsers often label .csv uploads as Excel files, which the shared
+// attachment checks reject as Office documents.
+const CSV_MIME_TYPE = "text/csv";
+function normalizeAttachmentInputs(attachmentInputs) {
+    return Object.fromEntries(Object.entries(attachmentInputs).map(([inputName, storageKeys]) => [
+        inputName,
+        storageKeys.map((storageKey) => storageKey.trim()),
+    ]));
+}
+function safeDisplayName(value) {
+    return stripUnsafeChars(scrubSecrets(value)).trim().slice(0, 200);
+}
+export function formatAttachmentInputDetails({ attachmentInputs, clark, services, }) {
+    const context = getActiveContext(clark, services);
+    const normalizedInputs = normalizeAttachmentInputs(attachmentInputs);
+    const storageKeys = Array.from(new Set(Object.values(normalizedInputs).flat()));
+    const attachments = context
+        ? new AttachmentsStore().getUploadedAttachmentsByStorageKeys(context, storageKeys)
+        : [];
+    const fileNamesByStorageKey = new Map(attachments.flatMap((attachment) => {
+        const storageKey = attachment.storageKey?.trim();
+        if (!storageKey)
+            return [];
+        const fileName = resolveAttachmentFileName({
+            fileName: attachment.fileName,
+            mediaType: attachment.mediaType,
+            type: "uploaded",
+        });
+        return [[storageKey, safeDisplayName(fileName)]];
+    }));
+    const details = Object.entries(normalizedInputs).map(([inputName, inputStorageKeys]) => {
+        const fileNames = inputStorageKeys.map((storageKey) => fileNamesByStorageKey.get(storageKey) ?? "unavailable attachment");
+        return `- ${safeDisplayName(inputName)}: ${fileNames.join(", ")}`;
+    });
+    return details.length > 0
+        ? `Attached files:\n${details.join("\n")}`
+        : undefined;
+}
+export async function buildAttachmentFileInputs({ attachmentInputs, clark, inputs, services, }) {
+    if (services.features.clarkAttachmentDownloadEnabled !== true) {
+        throw new Error("Attachment inputs are disabled");
+    }
+    const context = getActiveContext(clark, services);
+    if (!context) {
+        throw new Error("Context not available");
+    }
+    const normalizedInputs = normalizeAttachmentInputs(attachmentInputs);
+    const storageKeys = Array.from(new Set(Object.values(normalizedInputs).flat()));
+    if (storageKeys.some((storageKey) => storageKey.length === 0)) {
+        throw new Error("Attachment storageKey must not be empty");
+    }
+    const attachments = new AttachmentsStore()
+        .getUploadedAttachmentsByStorageKeys(context, storageKeys)
+        .filter((attachment) => attachment.type === "uploaded" &&
+        typeof attachment.storageKey === "string" &&
+        attachment.storageKey.length > 0);
+    const attachmentsByStorageKey = new Map(attachments.map((attachment) => [attachment.storageKey.trim(), attachment]));
+    const missingStorageKeys = storageKeys.filter((storageKey) => !attachmentsByStorageKey.has(storageKey));
+    if (missingStorageKeys.length > 0) {
+        throw new Error("Attachment not found in current session");
+    }
+    const unsupported = attachments.filter((attachment) => {
+        const fileName = resolveAttachmentFileName({
+            fileName: attachment.fileName,
+            mediaType: attachment.mediaType,
+            type: "uploaded",
+        });
+        return (getTextAttachmentType({ fileName }) !== "csv" &&
+            !isXlsxAttachmentFile({ fileName, mimeType: attachment.mediaType }));
+    });
+    if (unsupported.length > 0) {
+        throw new Error("Only CSV and Excel attachments can be passed as API inputs");
+    }
+    const leasesByUrl = await resolveUploadedAttachmentLeases({
+        attachments,
+        clark,
+        services,
+    });
+    const files = [];
+    const metadataByStorageKey = new Map();
+    for (const attachment of attachments) {
+        const lease = leasesByUrl.get(getCanonicalAttachmentUrl(attachment.url));
+        if (!lease) {
+            throw new Error("A fresh attachment download URL was not returned");
+        }
+        const fileName = resolveAttachmentFileName({
+            fileName: attachment.fileName,
+            mediaType: attachment.mediaType,
+            type: "uploaded",
+        });
+        const isWorkbook = isXlsxAttachmentFile({
+            fileName,
+            mimeType: attachment.mediaType,
+        });
+        const timeoutSignal = AbortSignal.timeout(ATTACHMENT_FETCH_TIMEOUT_MS);
+        const turnSignal = clark.context.abortController?.signal;
+        const response = await fetch(lease.signedUrl, {
+            signal: turnSignal
+                ? AbortSignal.any([turnSignal, timeoutSignal])
+                : timeoutSignal,
+        });
+        if (!response.ok || !response.body) {
+            throw new Error(`Failed to download attachment: HTTP ${response.status}`);
+        }
+        const reader = response.body.getReader();
+        const chunks = [];
+        let size = 0;
+        try {
+            for (;;) {
+                const { value, done } = await reader.read();
+                if (done)
+                    break;
+                size += value.byteLength;
+                assertAttachmentSize({
+                    fileName,
+                    mimeType: isWorkbook ? attachment.mediaType : CSV_MIME_TYPE,
+                    sizeBytes: size,
+                });
+                chunks.push(value);
+            }
+        }
+        catch (error) {
+            await reader.cancel(error);
+            throw error;
+        }
+        finally {
+            reader.releaseLock();
+        }
+        const contents = Buffer.concat(chunks, size);
+        const preparedSheets = isWorkbook
+            ? await convertWorkbookToCsvSheets({ bytes: contents, fileName })
+            : null;
+        if (preparedSheets) {
+            const sheetMetadata = [];
+            // A sheet that only derives values from other sheets has no rows to
+            // load, so only the data tables become API inputs.
+            const dataSheets = preparedSheets.filter((sheet) => sheet.csv !== undefined && sheet.fileName !== undefined);
+            if (dataSheets.length === 0) {
+                throw new Error("Workbook has no data to import");
+            }
+            for (const [index, sheet] of dataSheets.entries()) {
+                const csvBytes = Buffer.from(sheet.csv, "utf8");
+                const fileId = `clark-attachment-${attachment.id}-${index + 1}`;
+                files.push({
+                    buffer: csvBytes.toString("base64"),
+                    encoding: "base64",
+                    mimeType: CSV_MIME_TYPE,
+                    originalName: fileId,
+                    size: String(csvBytes.byteLength),
+                });
+                sheetMetadata.push({
+                    $superblocksId: fileId,
+                    encoding: "text",
+                    extension: "csv",
+                    name: sheet.fileName,
+                    size: csvBytes.byteLength,
+                    type: CSV_MIME_TYPE,
+                });
+            }
+            metadataByStorageKey.set(attachment.storageKey.trim(), sheetMetadata);
+        }
+        else {
+            const fileId = `clark-attachment-${attachment.id}`;
+            files.push({
+                buffer: contents.toString("base64"),
+                encoding: "base64",
+                mimeType: CSV_MIME_TYPE,
+                originalName: fileId,
+                size: String(contents.byteLength),
+            });
+            metadataByStorageKey.set(attachment.storageKey.trim(), [
+                {
+                    $superblocksId: fileId,
+                    encoding: "text",
+                    extension: path.extname(fileName).slice(1),
+                    name: fileName,
+                    size: contents.byteLength,
+                    type: CSV_MIME_TYPE,
+                },
+            ]);
+        }
+    }
+    const fileInputs = Object.fromEntries(Object.entries(normalizedInputs).map(([inputName, inputStorageKeys]) => {
+        const metadata = inputStorageKeys.flatMap((storageKey) => {
+            const filesForKey = metadataByStorageKey.get(storageKey);
+            if (!filesForKey) {
+                throw new Error("Attachment could not be prepared");
+            }
+            return filesForKey;
+        });
+        return [inputName, { files: metadata }];
+    }));
+    return {
+        files,
+        inputs: { ...inputs, ...fileInputs },
+    };
+}
+//# sourceMappingURL=attachment-file-inputs.js.map

package/dist/ai-service/agent/tools/apis/attachment-file-inputs.js.map

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

package/dist/ai-service/agent/tools/apis/get-sdk-api-docs.d.ts

@@ -1,4 +1,5 @@
 import type { ClarkStateHandlerParams } from "../../../state-machine/clark-fsm.js";
+import { type RootDocumentationMetadata } from "./sdk-root-documentation.js";
 /**
  * Stay under the agent outputLimiter (DEFAULT_MAX_OUTPUT_CHARS = 25_000)
  * with headroom for JSON wrapping. Importing middleware would create a cycle.
@@ -6,6 +7,7 @@ import type { ClarkStateHandlerParams } from "../../../state-machine/clark-fsm.j
 export declare const SCOPED_SDK_DOCS_CHAR_BUDGET = 24500;
 export type SdkApiDocsServices = {
     integrationStore: Pick<ClarkStateHandlerParams["integrationStore"], "getHeader" | "getPluginExecutionVersion">;
+    readSdkRootReadme?: () => Promise<string>;
 };
 export declare const SCOPED_SDK_PATTERNS_STUB: string;
 type SdkApiDocsResult = {
@@ -15,6 +17,7 @@ type SdkApiDocsResult = {
         version?: string;
         sdkVersion?: string;
     }[];
+    root?: RootDocumentationMetadata;
 };
 /**
  * Note appended when plugin-scoped docs are cut to stay under the
@@ -22,11 +25,13 @@ type SdkApiDocsResult = {
  * getSdkApiDocs with the same integrationIds returns the omitted tail —
  * there is no cursor/offset, so that call yields the same prefix.
  */
-export declare const SCOPED_DOCS_TRUNCATION_NOTE = "\n\n... [truncated plugin-scoped SDK docs for context budget; this tool has no continuation cursor \u2014 repeating getSdkApiDocs with the same pluginIds/integrationIds returns this same prefix, and getSdkApiDocs() with no IDs returns the shared root README, not the omitted plugin sections. To keep every plugin's docs intact, request fewer plugins per call]";
+export declare const SCOPED_DOCS_TRUNCATION_NOTE = "\n\n... [truncated plugin-scoped SDK docs for context budget; this tool has no plugin-doc continuation cursor \u2014 repeating getSdkApiDocs with the same pluginIds/integrationIds returns this same prefix, and getSdkApiDocs() with no IDs returns the shared root section index, not the omitted plugin sections. To keep every plugin's docs intact, request fewer plugins per call]";
 export declare function fitScopedDocsUnderBudget(result: SdkApiDocsResult, budget?: number, pluginStarts?: number[]): SdkApiDocsResult;
 export declare const getSdkApiDocsToolFactory: import("../../tools2/types.js").ToolFactory<SdkApiDocsServices, import("../../tools2/types.js").Tool<{
+    section?: string | undefined;
     integrationIds?: string[] | undefined;
     pluginIds?: string[] | undefined;
+    continuation?: string | undefined;
 }, SdkApiDocsResult>>;
 export {};
 //# sourceMappingURL=get-sdk-api-docs.d.ts.map

package/dist/ai-service/agent/tools/apis/get-sdk-api-docs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-sdk-api-docs.d.ts","sourceRoot":"","sources":["../../../../../src/ai-service/agent/tools/apis/get-sdk-api-docs.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAGnF;;;GAGG;AACH,eAAO,MAAM,2BAA2B,QAAS,CAAC;AAElD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,gBAAgB,EAAE,IAAI,CACpB,uBAAuB,CAAC,kBAAkB,CAAC,EAC3C,WAAW,GAAG,2BAA2B,CAC1C,CAAC;CACH,CAAC;AA6CF,eAAO,MAAM,wBAAwB,QAkBzB,CAAC;AA6Hb,KAAK,gBAAgB,GAAG;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACxE,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,4WAC8T,CAAC;AAEvW,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,gBAAgB,EACxB,MAAM,GAAE,MAAoC,EAC5C,YAAY,GAAE,MAAM,EAAO,GAC1B,gBAAgB,CA0BlB;AA2CD,eAAO,MAAM,wBAAwB;;;qBA+FpC,CAAC"}
+{"version":3,"file":"get-sdk-api-docs.d.ts","sourceRoot":"","sources":["../../../../../src/ai-service/agent/tools/apis/get-sdk-api-docs.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAEnF,OAAO,EAEL,KAAK,yBAAyB,EAE/B,MAAM,6BAA6B,CAAC;AAErC;;;GAGG;AACH,eAAO,MAAM,2BAA2B,QAAS,CAAC;AAElD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,gBAAgB,EAAE,IAAI,CACpB,uBAAuB,CAAC,kBAAkB,CAAC,EAC3C,WAAW,GAAG,2BAA2B,CAC1C,CAAC;IACF,iBAAiB,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;CAC3C,CAAC;AA6CF,eAAO,MAAM,wBAAwB,QAiBzB,CAAC;AA6Hb,KAAK,gBAAgB,GAAG;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACvE,IAAI,CAAC,EAAE,yBAAyB,CAAC;CAClC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,8XACgV,CAAC;AAEzX,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,gBAAgB,EACxB,MAAM,GAAE,MAAoC,EAC5C,YAAY,GAAE,MAAM,EAAO,GAC1B,gBAAgB,CA0BlB;AAyED,eAAO,MAAM,wBAAwB;;;;;qBAmIpC,CAAC"}

package/dist/ai-service/agent/tools/apis/get-sdk-api-docs.js

@@ -5,6 +5,7 @@ import { z } from "zod";
 import { resolveIntegrationDocumentation, } from "@superblocksteam/sdk-api/dist/integrations/documentation.js";
 import { safeJsonStringify } from "../../../../util/log-sanitizer.js";
 import { createToolFactory, ToolCategory } from "../../tools2/types.js";
+import { buildRootDocumentation, } from "./sdk-root-documentation.js";
 /**
  * Stay under the agent outputLimiter (DEFAULT_MAX_OUTPUT_CHARS = 25_000)
  * with headroom for JSON wrapping. Importing middleware would create a cycle.
@@ -14,7 +15,7 @@ const require = createRequire(import.meta.url);
 const SDK_API_PACKAGE_DIRECTORY = dirname(require.resolve("@superblocksteam/sdk-api/package.json"));
 const SDK_API_INTEGRATIONS_DIRECTORY = resolve(SDK_API_PACKAGE_DIRECTORY, "src/integrations");
 const SDK_API_ROOT_README_PATH = resolve(SDK_API_PACKAGE_DIRECTORY, "README.md");
-async function getSdkRootReadmeDocumentation() {
+async function readInstalledSdkRootReadme() {
     try {
         return await readFile(SDK_API_ROOT_README_PATH, "utf8");
     }
@@ -44,10 +45,9 @@ const SDK_INTEGRATIONS_KEY_GUIDANCE = [
     "In `run()`, access via `ctx.integrations.<key>` (e.g. `ctx.integrations.pokemon_tracker`). Use the integration ID only in the declaration (`postgres(UUID)`), never for access.",
 ].join("\n");
 export const SCOPED_SDK_PATTERNS_STUB = [
-    "## Shared SDK patterns (root README omitted)",
+    "## Essential shared SDK patterns",
     "",
-    "This lookup is plugin-scoped. The full SDK root README was omitted to avoid first-generation context compaction.",
-    "Call `getSdkApiDocs()` with no integrationIds/pluginIds if you need the complete shared SDK root guidance.",
+    "Detailed guidance is loaded from the installed SDK README on demand. Call `getSdkApiDocs()` with no IDs for the shared SDK root section index.",
     "",
     "### `api()`",
     "- Every `api()` config requires `name` (unique string), `input`, `output`, and `run`.",
@@ -146,7 +146,7 @@ function pluginsCoveredByPrefix(plugins, pluginStarts, prefixLength) {
  * getSdkApiDocs with the same integrationIds returns the omitted tail —
  * there is no cursor/offset, so that call yields the same prefix.
  */
-export const SCOPED_DOCS_TRUNCATION_NOTE = "\n\n... [truncated plugin-scoped SDK docs for context budget; this tool has no continuation cursor — repeating getSdkApiDocs with the same pluginIds/integrationIds returns this same prefix, and getSdkApiDocs() with no IDs returns the shared root README, not the omitted plugin sections. To keep every plugin's docs intact, request fewer plugins per call]";
+export const SCOPED_DOCS_TRUNCATION_NOTE = "\n\n... [truncated plugin-scoped SDK docs for context budget; this tool has no plugin-doc continuation cursor — repeating getSdkApiDocs with the same pluginIds/integrationIds returns this same prefix, and getSdkApiDocs() with no IDs returns the shared root section index, not the omitted plugin sections. To keep every plugin's docs intact, request fewer plugins per call]";
 export function fitScopedDocsUnderBudget(result, budget = SCOPED_SDK_DOCS_CHAR_BUDGET, pluginStarts = []) {
     if (safeJsonStringify(result).length <= budget) {
         return result;
@@ -198,12 +198,29 @@ function resolveRequestedPluginIds(integrationIds, pluginIds, services) {
     }
     return requestedPluginIds;
 }
-async function unscopedSdkRootDocumentation() {
+async function unscopedSdkRootDocumentation(selector, services, notice) {
+    const root = buildRootDocumentation(await (services.readSdkRootReadme?.() ?? readInstalledSdkRootReadme()), selector, SCOPED_SDK_DOCS_CHAR_BUDGET, notice, withIntegrationsKeyGuidance(SCOPED_SDK_PATTERNS_STUB));
     return {
-        documentation: withIntegrationsKeyGuidance(await getSdkRootReadmeDocumentation()),
+        ...root,
         plugins: [],
     };
 }
+function unresolvedDocumentationNotice(integrationIds, pluginIds) {
+    if (integrationIds.length === 0 && pluginIds.length === 0) {
+        return undefined;
+    }
+    const compact = (values) => values
+        .slice(0, 10)
+        .map((value) => value.slice(0, 80))
+        .join(", ");
+    const parts = [
+        ...(integrationIds.length > 0
+            ? [`integration IDs: ${compact(integrationIds)}`]
+            : []),
+        ...(pluginIds.length > 0 ? [`plugin IDs: ${compact(pluginIds)}`] : []),
+    ];
+    return `No version-aware plugin documentation resolved for ${parts.join("; ")}. Shared SDK root documentation is returned instead. Verify the IDs before implementing integration calls.`;
+}
 export const getSdkApiDocsToolFactory = createToolFactory("getSdkApiDocs", (services) => ({
     category: ToolCategory.API,
     readOnly: true,
@@ -211,7 +228,8 @@ export const getSdkApiDocsToolFactory = createToolFactory("getSdkApiDocs", (serv
 Retrieve SDK API implementation guidance for both generic and integration-specific API development.
 
 This tool provides:
-- Generic SDK API-building guidance when no integration IDs or plugin IDs are provided
+- A compact index of generic SDK guidance when no integration IDs or plugin IDs are provided
+- Root README sections selected by section ID, with advancing continuation tokens for oversized sections
 - Integration-specific method and usage guidance when integration IDs or plugin IDs are provided
 - Version-aware plugin documentation matched to the app's integration versions
 - A returned list of resolved plugin IDs so you can verify coverage
@@ -230,16 +248,23 @@ ALWAYS call this tool:
             .array(z.string())
             .describe("Plugin IDs to include plugin-specific SDK documentation for. Use this when you know plugin types directly.")
             .optional(),
+        section: z
+            .string()
+            .describe("SDK root README section ID from the unscoped index. Do not combine with continuation.")
+            .optional(),
+        continuation: z
+            .string()
+            .describe("Opaque continuation token from root.continuation. Pass it exactly and do not combine it with section.")
+            .optional(),
     }),
-    skipOutputLimit: (output) => output.plugins.length === 0,
-    execute: async ({ integrationIds = [], pluginIds = [], }) => {
+    execute: async ({ integrationIds = [], pluginIds = [], section, continuation, }) => {
         const requestedPluginIds = resolveRequestedPluginIds(integrationIds, pluginIds, services);
         if (requestedPluginIds.length === 0) {
-            return unscopedSdkRootDocumentation();
+            return unscopedSdkRootDocumentation({ section, continuation }, services, unresolvedDocumentationNotice(integrationIds, pluginIds));
         }
         const { documentation, plugins: resolvedPlugins } = await buildSdkPluginReadmeDocumentation(requestedPluginIds, services);
         if (resolvedPlugins.length === 0) {
-            return unscopedSdkRootDocumentation();
+            return unscopedSdkRootDocumentation({ section, continuation }, services, unresolvedDocumentationNotice(integrationIds, pluginIds));
         }
         const plugins = resolvedPlugins.map(({ pluginId, version, sdkVersion }) => ({
             pluginId,
@@ -253,23 +278,32 @@ ALWAYS call this tool:
         const integrationIds = input.integrationIds ?? [];
         const pluginIds = input.pluginIds ?? [];
         const plugins = output.plugins.map((plugin) => plugin.pluginId).join(",");
-        const argParts = [];
         const labelParts = [];
+        const refetchInput = {};
         if (integrationIds.length > 0) {
-            argParts.push(`integrationIds:[${integrationIds.join(",")}]`);
+            refetchInput.integrationIds = integrationIds;
             labelParts.push(`integrationIds=[${integrationIds.join(",")}]`);
         }
         if (pluginIds.length > 0) {
-            argParts.push(`pluginIds:[${pluginIds.join(",")}]`);
+            refetchInput.pluginIds = pluginIds;
             labelParts.push(`pluginIds=[${pluginIds.join(",")}]`);
         }
-        const refetchArg = `{${argParts.join(",")}}`;
+        if (input.section) {
+            refetchInput.section = input.section;
+            labelParts.push(`section=${input.section}`);
+        }
+        if (input.continuation) {
+            refetchInput.continuation = input.continuation;
+            labelParts.push("continuation=(exact token retained)");
+        }
+        const refetchArg = JSON.stringify(refetchInput);
+        const pluginScoped = integrationIds.length > 0 || pluginIds.length > 0;
         const inputLabel = labelParts.length > 0
-            ? `plugin-scoped ${labelParts.join(" ")}`
-            : "unscoped SDK root README lookup";
+            ? `${pluginScoped ? "plugin-scoped " : ""}${labelParts.join(" ")}`
+            : "unscoped SDK root documentation index";
         return {
             input: inputLabel,
-            output: `plugins=[${plugins || "(none)"}]; if these docs are needed after compaction, ALWAYS refetch getSdkApiDocs(${refetchArg}) — a count-only summary is not enough`,
+            output: `plugins=[${plugins || "(none)"}]; if these docs are needed after compaction, ALWAYS refetch getSdkApiDocs(${refetchArg}) — preserve section and continuation arguments exactly; a count-only summary is not enough`,
             protected: false,
         };
     },

package/dist/ai-service/agent/tools/apis/get-sdk-api-docs.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-sdk-api-docs.js","sourceRoot":"","sources":["../../../../../src/ai-service/agent/tools/apis/get-sdk-api-docs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE7C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EACL,+BAA+B,GAEhC,MAAM,6DAA6D,CAAC;AAErE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAEtE,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAExE;;;GAGG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,MAAM,CAAC;AASlD,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,yBAAyB,GAAG,OAAO,CACvC,OAAO,CAAC,OAAO,CAAC,uCAAuC,CAAC,CACzD,CAAC;AACF,MAAM,8BAA8B,GAAG,OAAO,CAC5C,yBAAyB,EACzB,kBAAkB,CACnB,CAAC;AACF,MAAM,wBAAwB,GAAG,OAAO,CACtC,yBAAyB,EACzB,WAAW,CACZ,CAAC;AAEF,KAAK,UAAU,6BAA6B;IAC1C,IAAI,CAAC;QACH,OAAO,MAAM,QAAQ,CAAC,wBAAwB,EAAE,MAAM,CAAC,CAAC;IAC1D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,6BAA6B,GAAG;IACpC,mEAAmE;IACnE,EAAE;IACF,0TAA0T;IAC1T,EAAE;IACF,0DAA0D;IAC1D,gDAAgD;IAChD,oGAAoG;IACpG,6FAA6F;IAC7F,oGAAoG;IACpG,6GAA6G;IAC7G,EAAE;IACF,gNAAgN;IAChN,EAAE;IACF,iLAAiL;CAClL,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,8CAA8C;IAC9C,EAAE;IACF,kHAAkH;IAClH,4GAA4G;IAC5G,EAAE;IACF,aAAa;IACb,uFAAuF;IACvF,oKAAoK;IACpK,EAAE;IACF,oBAAoB;IACpB,oJAAoJ;IACpJ,EAAE;IACF,yBAAyB;IACzB,0MAA0M;IAC1M,uGAAuG;IACvG,iJAAiJ;IACjJ,gPAAgP;CACjP,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,SAAS,2BAA2B,CAAC,aAAqB;IACxD,MAAM,QAAQ,GAAG,6BAA6B,CAAC,IAAI,EAAE,CAAC;IACtD,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC;IAClC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,OAAO,GAAG,QAAQ,OAAO,IAAI,EAAE,CAAC;AAClC,CAAC;AAED,SAAS,eAAe,CACtB,OAA2B;IAE3B,OAAO,OAAO,IAAI,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC;QAC/C,CAAC,CAAE,OAAmE;QACtE,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED,MAAM,iBAAiB,GAAG,kBAAkB,CAAC;AAE7C,KAAK,UAAU,4BAA4B,CACzC,QAAgB,EAChB,aAAsB,EACtB,UAAmB;IAEnB,IAAI,CAAC;QACH,OAAO,MAAM,+BAA+B,CAAC,QAAQ,EAAE;YACrD,aAAa,EAAE,eAAe,CAAC,aAAa,CAAC;YAC7C,UAAU,EAAE,eAAe,CAAC,UAAU,CAAC;YACvC,qBAAqB,EAAE,8BAA8B;SACtD,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IACE,KAAK,YAAY,KAAK;YACtB,MAAM,IAAI,KAAK;YACd,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAClD,CAAC;YACD,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AASD,KAAK,UAAU,iCAAiC,CAC9C,SAAmB,EACnB,QAA4B;IAK5B,MAAM,IAAI,GAAG,CAAC,wBAAwB,CAAC,CAAC;IAExC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,eAAe,GAAwB,EAAE,CAAC;IAEhD,MAAM,UAAU,GACd,QAAQ,CAAC,gBAAgB,CAAC,yBAAyB,CAAC,iBAAiB,CAAC,CAAC;IAEzE,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YACvB,SAAS;QACX,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAEnB,MAAM,aAAa,GACjB,QAAQ,CAAC,gBAAgB,CAAC,yBAAyB,CAAC,QAAQ,CAAC,CAAC;QAChE,MAAM,cAAc,GAAG,MAAM,4BAA4B,CACvD,QAAQ,EACR,aAAa,EACb,UAAU,CACX,CAAC;QACF,IAAI,cAAc,EAAE,CAAC;YACnB,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YAC1B,eAAe,CAAC,IAAI,CAAC;gBACnB,QAAQ;gBACR,OAAO,EAAE,aAAa;gBACtB,UAAU;gBACV,MAAM,EAAE,cAAc;aACvB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO;QACL,aAAa,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;QAChC,OAAO,EAAE,eAAe;KACzB,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAC1B,aAAqB,EACrB,OAAiB;IAEjB,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QAC5B,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;QAChC,MAAM,KAAK,GAAG,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QACxD,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;YACf,UAAU,GAAG,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC;QACrC,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,sBAAsB,CAC7B,OAAoC,EACpC,YAAsB,EACtB,YAAoB;IAEpB,IAAI,YAAY,CAAC,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC;QAC3C,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE;QACjC,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QAClC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,GAAG,YAAY,CAAC;IACzE,CAAC,CAAC,CAAC;AACL,CAAC;AAOD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,2BAA2B,GACtC,oWAAoW,CAAC;AAEvW,MAAM,UAAU,wBAAwB,CACtC,MAAwB,EACxB,SAAiB,2BAA2B,EAC5C,eAAyB,EAAE;IAE3B,IAAI,iBAAiB,CAAC,MAAM,CAAC,CAAC,MAAM,IAAI,MAAM,EAAE,CAAC;QAC/C,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,MAAM,GAAG,2BAA2B,CAAC;IAC3C,IAAI,EAAE,GAAG,CAAC,CAAC;IACX,IAAI,EAAE,GAAG,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC;IACrC,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC;QAChB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QACtC,MAAM,KAAK,GAAqB;YAC9B,aAAa,EAAE,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,MAAM;YAC1D,OAAO,EAAE,MAAM,CAAC,OAAO;SACxB,CAAC;QACF,IAAI,iBAAiB,CAAC,KAAK,CAAC,CAAC,MAAM,IAAI,MAAM,EAAE,CAAC;YAC9C,IAAI,GAAG,GAAG,CAAC;YACX,EAAE,GAAG,GAAG,GAAG,CAAC,CAAC;QACf,CAAC;aAAM,CAAC;YACN,EAAE,GAAG,GAAG,GAAG,CAAC,CAAC;QACf,CAAC;IACH,CAAC;IACD,OAAO;QACL,aAAa,EAAE,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,MAAM;QAC3D,OAAO,EAAE,sBAAsB,CAAC,MAAM,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,CAAC;KACpE,CAAC;AACJ,CAAC;AAED,SAAS,yBAAyB,CAChC,cAAwB,EACxB,SAAmB,EACnB,QAA4B;IAE5B,MAAM,kBAAkB,GAAa,EAAE,CAAC;IACxC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YACvB,SAAS;QACX,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACnB,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,MAAM,aAAa,IAAI,cAAc,EAAE,CAAC;QAC3C,MAAM,MAAM,GAAG,QAAQ,CAAC,gBAAgB,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;QAClE,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,SAAS;QACX,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QAClC,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YACvB,SAAS;QACX,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACnB,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;IAED,OAAO,kBAAkB,CAAC;AAC5B,CAAC;AAED,KAAK,UAAU,4BAA4B;IACzC,OAAO;QACL,aAAa,EAAE,2BAA2B,CACxC,MAAM,6BAA6B,EAAE,CACtC;QACD,OAAO,EAAE,EAAE;KACZ,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,wBAAwB,GAAG,iBAAiB,CACvD,eAAe,EACf,CAAC,QAA4B,EAAE,EAAE,CAAC,CAAC;IACjC,QAAQ,EAAE,YAAY,CAAC,GAAG;IAC1B,QAAQ,EAAE,IAAI;IACd,WAAW,EAAE;;;;;;;;;;;;;CAahB;IACG,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,cAAc,EAAE,CAAC;aACd,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;aACjB,QAAQ,CACP,sHAAsH,CACvH;aACA,QAAQ,EAAE;QACb,SAAS,EAAE,CAAC;aACT,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;aACjB,QAAQ,CACP,4GAA4G,CAC7G;aACA,QAAQ,EAAE;KACd,CAAC;IACF,eAAe,EAAE,CAAC,MAAwB,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;IAC1E,OAAO,EAAE,KAAK,EAAE,EACd,cAAc,GAAG,EAAE,EACnB,SAAS,GAAG,EAAE,GACf,EAA6B,EAAE;QAC9B,MAAM,kBAAkB,GAAG,yBAAyB,CAClD,cAAc,EACd,SAAS,EACT,QAAQ,CACT,CAAC;QACF,IAAI,kBAAkB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpC,OAAO,4BAA4B,EAAE,CAAC;QACxC,CAAC;QAED,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,eAAe,EAAE,GAC/C,MAAM,iCAAiC,CAAC,kBAAkB,EAAE,QAAQ,CAAC,CAAC;QACxE,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACjC,OAAO,4BAA4B,EAAE,CAAC;QACxC,CAAC;QACD,MAAM,OAAO,GAAG,eAAe,CAAC,GAAG,CACjC,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC;YACtC,QAAQ;YACR,OAAO;YACP,UAAU;SACX,CAAC,CACH,CAAC;QACF,MAAM,mBAAmB,GAAG,2BAA2B,CAAC,aAAa,CAAC,CAAC;QACvE,OAAO,wBAAwB,CAC7B,EAAE,aAAa,EAAE,mBAAmB,EAAE,OAAO,EAAE,EAC/C,2BAA2B,EAC3B,mBAAmB,CACjB,mBAAmB,EACnB,eAAe,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAC/C,CACF,CAAC;IACJ,CAAC;IACD,UAAU,EAAE,CAAC,KAAK,EAAE,MAAwB,EAAE,EAAE;QAC9C,MAAM,cAAc,GAAG,KAAK,CAAC,cAAc,IAAI,EAAE,CAAC;QAClD,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,IAAI,EAAE,CAAC;QACxC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1E,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,MAAM,UAAU,GAAa,EAAE,CAAC;QAChC,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,QAAQ,CAAC,IAAI,CAAC,mBAAmB,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC9D,UAAU,CAAC,IAAI,CAAC,mBAAmB,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClE,CAAC;QACD,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,QAAQ,CAAC,IAAI,CAAC,cAAc,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACpD,UAAU,CAAC,IAAI,CAAC,cAAc,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACxD,CAAC;QACD,MAAM,UAAU,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;QAC7C,MAAM,UAAU,GACd,UAAU,CAAC,MAAM,GAAG,CAAC;YACnB,CAAC,CAAC,iBAAiB,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;YACzC,CAAC,CAAC,iCAAiC,CAAC;QACxC,OAAO;YACL,KAAK,EAAE,UAAU;YACjB,MAAM,EAAE,YAAY,OAAO,IAAI,QAAQ,8EAA8E,UAAU,wCAAwC;YACvK,SAAS,EAAE,KAAK;SACjB,CAAC;IACJ,CAAC;CACF,CAAC,CACH,CAAC"}
+{"version":3,"file":"get-sdk-api-docs.js","sourceRoot":"","sources":["../../../../../src/ai-service/agent/tools/apis/get-sdk-api-docs.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,20 @@
+export type RootDocumentationMetadata = {
+    sourceId: string;
+    section?: string;
+    range?: {
+        start: number;
+        end: number;
+        total: number;
+    };
+    continuation?: string;
+};
+export type RootDocumentationResult = {
+    documentation: string;
+    root: RootDocumentationMetadata;
+};
+export type RootDocumentationSelector = {
+    section?: string;
+    continuation?: string;
+};
+export declare function buildRootDocumentation(markdown: string, selector: RootDocumentationSelector, budget: number, notice?: string, orientation?: string): RootDocumentationResult;
+//# sourceMappingURL=sdk-root-documentation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-root-documentation.d.ts","sourceRoot":"","sources":["../../../../../src/ai-service/agent/tools/apis/sdk-root-documentation.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,yBAAyB,GAAG;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACtD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,yBAAyB,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAmXF,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,yBAAyB,EACnC,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,MAAM,GACnB,uBAAuB,CA2DzB"}