@webskill/sdk 0.23.0 → 0.24.0

package/dist/agent.d.ts

@@ -1,3 +1,3 @@
-import { D as DEFAULT_MAX_DATA_SOURCE_BYTES } from "./index-7No55dRb.js";
-import { $ as DownloadedFileEntry, $n as SkillCandidateSink, $r as createDownloadedFileToolSource, $t as PERCEPTION_PAGING_DEFAULTS, A as DataSourceRecord, An as PerceptionAuditSink, Ar as TemplateToolSourceOptions, At as FILL_TEMPLATE_TOOL, B as DocumentFileSource, Bn as READ_DOCUMENT_TOOL, Br as WorksetTabView, Bt as LIST_PAGE_TABS_TOOL, C as DataSourceCandidateRecord, Ci as rangeContains, Cn as ParentBudget, Cr as TemplateCellSkeleton, Ct as DwgView, D as DataSourcePolicy, Di as toActionFrameScopes, Dn as PdfTextQuality, Dr as TemplateParagraphSkeleton, Dt as EMU_PER_TWIP, E as DataSourceKind, Ei as takesImage, En as PdfPageImage, Er as TemplateImageResolver, Et as EMU_PER_POINT, F as DelegationRequest, Fn as PerceptionScope, Fr as TodoStatus, Ft as GeneratedSkillDraft, G as DocumentToolSourceOptions, Gn as RemoteImageToolSourceOptions, Gr as XlsxTemplateFillSpec, Gt as OpenedTabSignal, H as DocumentImageRole, Hn as RemoteImageFetch, Hr as XlsxDocumentReader, Ht as MAX_DIGIT_WIDTH, I as DelegationResult, In as PerceptionScopeInput, Ir as TodoStore, It as HttpDataSourceOptions, J as DocxTemplateEngine, Jn as SKILL_GENERATION_SYSTEM_PROMPT, Jr as clampDownloadWaitMs, Jt as PAGE_ACTION_TOOL, K as DocxDocumentContent, Kn as RenderedImage, Kr as XlsxTemplateSkeleton, Kt as PAGE_ACTION_KINDS, L as DelegationToolSourceOptions, Ln as PptxDocumentContent, Lr as TodoToolSourceOptions, Lt as INSPECT_TEMPLATE_TOOL, M as DelegationBudget, Mn as PerceptionPagingBudget, Mr as TodoItem, Mt as FrameNote, N as DelegationOrchestrator, Nn as PerceptionRecord, Nr as TodoList, Nt as FrameScope, O as DataSourcePolicyOptions, Oi as toFrameScopes, On as PerceivedImage, Or as TemplateSheetSkeleton, Ot as EXPORT_SPREADSHEET_TOOL, P as DelegationOrchestratorOptions, Pn as PerceptionResult, Pr as TodoListener, Pt as GENERATE_SKILL_TOOL, Q as DownloadedFileConsent, Qn as SkillBinaryPayload, Qr as createDocumentToolSource, Qt as PERCEIVE_PAGE_TOOL, R as DocumentBlock, Rn as PptxDocumentReader, Rr as VIEW_DWG_TOOL, Rt as ImageCaptureBudget, S as DataSourceCandidatePolicyOptions, Si as parseCellRange, Sn as PagePerceptionToolSourceOptions, Sr as TabWorksetToolSourceOptions, St as DwgUnits, T as DataSourceDef, Ti as sniffDocumentFormat, Tn as PdfDocumentReader, Tr as TemplateImageBytes, Tt as EMU_PER_PIXEL, U as DocumentReadBudget, Un as RemoteImageFetchFailure, Ur as XlsxSheetContent, Ut as NestedFrameRef, V as DocumentFormat, Vn as READ_DOWNLOADED_FILE_TOOL, Vr as XlsxDocumentContent, Vt as MANAGE_TODO_TOOL, W as DocumentReadMode, Wn as RemoteImageResult, Wr as XlsxTemplateEngine, Wt as OpenedPageInfo, X as DocxTemplateSkeleton, Xn as Size, Xr as columnWidthToPixels, Xt as PDF_GARBLED_RATIO, Y as DocxTemplateFillSpec, Yn as ScrollDirection, Yr as clampWorksetMax, Yt as PAGE_DOCUMENT_REF, Z as DownloadedFileAction, Zn as SkillAttachmentBytes, Zr as createDelegationToolSource, Zt as PDF_LARGE_IMAGE_RATIO, _ as DWG_MODEL_VIEW_ID, _i as frameSteps, _n as PageImageResult, _r as TODO_SYSTEM_PROMPT, _t as DwgOmission, a as ActionTabWindow, ai as createRemoteImageToolSource, an as PageActionPolicy, ar as SkillGeneratorOptions, at as DownloadedFileRecord, b as DataSourceCandidateAuditSink, bi as measurePdfTextQuality, bn as PagePerceptionPolicyOptions, br as TabWorksetPolicyOptions, bt as DwgProjection, c as CellAddress, ci as createTabWorksetToolSource, cn as PageActionRequest, cr as SpreadsheetToolSourceOptions, ct as DwgComponent, d as DELEGATE_TASK_TOOL, di as defersImage, dn as PageActionTarget, dr as SubtreeRejection, dt as DwgEntity, ei as createDwgToolSource, en as PERCEPTION_SYSTEM_PROMPT, er as SkillGenerationMessages, et as DownloadedFileListing, f as DELEGATION_SYSTEM_PROMPT, fi as dwgPickView, fn as PageActionToolSourceOptions, fr as TAB_WORKSET_DEFAULT_MAX, ft as DwgFill, g as DOWNLOAD_WAIT_MIN_MS, gi as frameLabel, gn as PageImageFailure, gr as TEMPLATE_INSPECT_BUDGET, gt as DwgLoadedDrawing, h as DOWNLOAD_WAIT_MAX_MS, hi as formatCellAddress, hn as PageImageCapture, hr as TAB_WORKSET_SYSTEM_PROMPT, ht as DwgLayer, i as ActionTabWatcher, ii as createPagePerceptionToolSource, in as PageActionOutcome, ir as SkillGenerator, it as DownloadedFileReader, j as DataSourceTransport, jn as PerceptionCaptureOptions, jr as TodoEvent, jt as FOCUS_PAGE_TAB_TOOL, k as DataSourceProvenance, ki as withDelegationOrigin, kn as PerceivedNode, kr as TemplateTableCellSkeleton, kt as FETCH_REMOTE_IMAGE_TOOL, l as CellRange, li as createTemplateToolSource, ln as PageActionScope, lr as SubAgentRunInput, lt as DwgDocumentContent, m as DOWNLOAD_WAIT_DEFAULT_MS, mi as fitWithin, mn as PageAuditSink, mr as TAB_WORKSET_MIN_MAX, mt as DwgGeometry, n as ActionDownloadWindow, ni as createPageActionToolSource, nn as PageActionExecutor, nr as SkillGenerationPolicy, nt as DownloadedFilePolicyOptions, o as CAPTURE_PAGE_IMAGE_TOOL, oi as createSkillGenerationToolSource, on as PageActionPolicyOptions, or as SkillTraceEvidence, ot as DownloadedFileToolSourceOptions, p as DOCUMENT_READ_BUDGET, pi as dwgViewsOf, pn as PageActionUi, pr as TAB_WORKSET_MAX_MAX, pt as DwgFont, q as DocxDocumentReader, qn as SCROLL_DIRECTIONS, qr as asReadMode, qt as PAGE_ACTION_SYSTEM_PROMPT, r as ActionFrameScope, ri as createPageImageToolSource, rn as PageActionKind, rr as SkillGenerationToolSourceOptions, rt as DownloadedFileReadResult, s as CLOSE_PAGE_TAB_TOOL, si as createSpreadsheetToolSource, sn as PageActionRecord, sr as SkillTraceEvidenceStep, st as DwgBounds, t as ActionDownloadWatcher, ti as createHttpDataSourceTransport, tn as PageActionConsent, tr as SkillGenerationOutcome, tt as DownloadedFilePolicy, u as ConsentUi, ui as createTodoToolSource, un as PageActionScopeInput, ur as SubAgentRunner, ut as DwgDocumentReader, v as DataSourceAuditSink, vi as isPdfTextTrustworthy, vn as PageImageToolSourceOptions, vr as TabAdmission, vt as DwgPoint, w as DataSourceCandidateStore, wi as readImageSize, wn as PdfDocumentHandle, wr as TemplateFileSource, wt as DwgViewport, x as DataSourceCandidatePolicy, xi as parseCellAddress, xn as PagePerceptionReader, xr as TabWorksetPort, xt as DwgToolSourceOptions, y as DataSourceCandidate, yi as isRangeTopLeft, yn as PagePerceptionPolicy, yr as TabWorksetPolicy, yt as DwgProjectedDrawing, z as DocumentFileBytes, zn as PptxSlideContent, zr as WorksetTab, zt as LIST_DOWNLOADED_FILES_TOOL } from "./index-V76_OFj2.js";
-export { type ActionDownloadWatcher, type ActionDownloadWindow, type ActionFrameScope, type ActionTabWatcher, type ActionTabWindow, CAPTURE_PAGE_IMAGE_TOOL, CLOSE_PAGE_TAB_TOOL, type CellAddress, type CellRange, type ConsentUi, DEFAULT_MAX_DATA_SOURCE_BYTES, DELEGATE_TASK_TOOL, DELEGATION_SYSTEM_PROMPT, DOCUMENT_READ_BUDGET, DOWNLOAD_WAIT_DEFAULT_MS, DOWNLOAD_WAIT_MAX_MS, DOWNLOAD_WAIT_MIN_MS, DWG_MODEL_VIEW_ID, type DataSourceAuditSink, type DataSourceCandidate, type DataSourceCandidateAuditSink, DataSourceCandidatePolicy, type DataSourceCandidatePolicyOptions, type DataSourceCandidateRecord, type DataSourceCandidateStore, type DataSourceDef, type DataSourceKind, DataSourcePolicy, type DataSourcePolicyOptions, type DataSourceProvenance, type DataSourceRecord, type DataSourceTransport, type DelegationBudget, DelegationOrchestrator, type DelegationOrchestratorOptions, type DelegationRequest, type DelegationResult, type DelegationToolSourceOptions, type DocumentBlock, type DocumentFileBytes, type DocumentFileSource, type DocumentFormat, type DocumentImageRole, type DocumentReadBudget, type DocumentReadMode, type DocumentToolSourceOptions, type DocxDocumentContent, type DocxDocumentReader, type DocxTemplateEngine, type DocxTemplateFillSpec, type DocxTemplateSkeleton, type DownloadedFileAction, type DownloadedFileConsent, type DownloadedFileEntry, type DownloadedFileListing, DownloadedFilePolicy, type DownloadedFilePolicyOptions, type DownloadedFileReadResult, type DownloadedFileReader, type DownloadedFileRecord, type DownloadedFileToolSourceOptions, type DwgBounds, type DwgComponent, type DwgDocumentContent, type DwgDocumentReader, type DwgEntity, type DwgFill, type DwgFont, type DwgGeometry, type DwgLayer, type DwgLoadedDrawing, type DwgOmission, type DwgPoint, type DwgProjectedDrawing, type DwgProjection, type DwgToolSourceOptions, type DwgUnits, type DwgView, type DwgViewport, EMU_PER_PIXEL, EMU_PER_POINT, EMU_PER_TWIP, EXPORT_SPREADSHEET_TOOL, FETCH_REMOTE_IMAGE_TOOL, FILL_TEMPLATE_TOOL, FOCUS_PAGE_TAB_TOOL, type FrameNote, type FrameScope, GENERATE_SKILL_TOOL, type GeneratedSkillDraft, type HttpDataSourceOptions, INSPECT_TEMPLATE_TOOL, type ImageCaptureBudget, LIST_DOWNLOADED_FILES_TOOL, LIST_PAGE_TABS_TOOL, MANAGE_TODO_TOOL, MAX_DIGIT_WIDTH, type NestedFrameRef, type OpenedPageInfo, type OpenedTabSignal, PAGE_ACTION_KINDS, PAGE_ACTION_SYSTEM_PROMPT, PAGE_ACTION_TOOL, PAGE_DOCUMENT_REF, PDF_GARBLED_RATIO, PDF_LARGE_IMAGE_RATIO, PERCEIVE_PAGE_TOOL, PERCEPTION_PAGING_DEFAULTS, PERCEPTION_SYSTEM_PROMPT, type PageActionConsent, type PageActionExecutor, type PageActionKind, type PageActionOutcome, PageActionPolicy, type PageActionPolicyOptions, type PageActionRecord, type PageActionRequest, type PageActionScope, type PageActionScopeInput, type PageActionTarget, type PageActionToolSourceOptions, type PageActionUi, type PageAuditSink, type PageImageCapture, type PageImageFailure, type PageImageResult, type PageImageToolSourceOptions, PagePerceptionPolicy, type PagePerceptionPolicyOptions, type PagePerceptionReader, type PagePerceptionToolSourceOptions, type ParentBudget, type PdfDocumentHandle, type PdfDocumentReader, type PdfPageImage, type PdfTextQuality, type PerceivedImage, type PerceivedNode, type PerceptionAuditSink, type PerceptionCaptureOptions, type PerceptionPagingBudget, type PerceptionRecord, type PerceptionResult, type PerceptionScope, type PerceptionScopeInput, type PptxDocumentContent, type PptxDocumentReader, type PptxSlideContent, READ_DOCUMENT_TOOL, READ_DOWNLOADED_FILE_TOOL, type RemoteImageFetch, type RemoteImageFetchFailure, type RemoteImageResult, type RemoteImageToolSourceOptions, type RenderedImage, SCROLL_DIRECTIONS, SKILL_GENERATION_SYSTEM_PROMPT, type ScrollDirection, type Size, type SkillAttachmentBytes, type SkillBinaryPayload, type SkillCandidateSink, type SkillGenerationMessages, type SkillGenerationOutcome, type SkillGenerationPolicy, type SkillGenerationToolSourceOptions, SkillGenerator, type SkillGeneratorOptions, type SkillTraceEvidence, type SkillTraceEvidenceStep, type SpreadsheetToolSourceOptions, type SubAgentRunInput, type SubAgentRunner, type SubtreeRejection, TAB_WORKSET_DEFAULT_MAX, TAB_WORKSET_MAX_MAX, TAB_WORKSET_MIN_MAX, TAB_WORKSET_SYSTEM_PROMPT, TEMPLATE_INSPECT_BUDGET, TODO_SYSTEM_PROMPT, type TabAdmission, TabWorksetPolicy, type TabWorksetPolicyOptions, type TabWorksetPort, type TabWorksetToolSourceOptions, type TemplateCellSkeleton, type TemplateFileSource, type TemplateImageBytes, type TemplateImageResolver, type TemplateParagraphSkeleton, type TemplateSheetSkeleton, type TemplateTableCellSkeleton, type TemplateToolSourceOptions, type TodoEvent, type TodoItem, type TodoList, type TodoListener, type TodoStatus, TodoStore, type TodoToolSourceOptions, VIEW_DWG_TOOL, type WorksetTab, type WorksetTabView, type XlsxDocumentContent, type XlsxDocumentReader, type XlsxSheetContent, type XlsxTemplateEngine, type XlsxTemplateFillSpec, type XlsxTemplateSkeleton, asReadMode, clampDownloadWaitMs, clampWorksetMax, columnWidthToPixels, createDelegationToolSource, createDocumentToolSource, createDownloadedFileToolSource, createDwgToolSource, createHttpDataSourceTransport, createPageActionToolSource, createPageImageToolSource, createPagePerceptionToolSource, createRemoteImageToolSource, createSkillGenerationToolSource, createSpreadsheetToolSource, createTabWorksetToolSource, createTemplateToolSource, createTodoToolSource, defersImage, dwgPickView, dwgViewsOf, fitWithin, formatCellAddress, frameLabel, frameSteps, isPdfTextTrustworthy, isRangeTopLeft, measurePdfTextQuality, parseCellAddress, parseCellRange, rangeContains, readImageSize, sniffDocumentFormat, takesImage, toActionFrameScopes, toFrameScopes, withDelegationOrigin };
+import { D as DEFAULT_MAX_DATA_SOURCE_BYTES } from "./index-Bq299VnF.js";
+import { $ as DownloadedFileEntry, $n as SkillCandidateSink, $r as clampWorksetMax, $t as PERCEPTION_PAGING_DEFAULTS, A as DataSourceRecord, Ai as takesImage, An as PerceptionAuditSink, Ar as TemplateSheetBlanks, At as FILL_TEMPLATE_TOOL, B as DocumentFileSource, Bn as READ_DOCUMENT_TOOL, Br as TodoToolSourceOptions, Bt as LIST_PAGE_TABS_TOOL, C as DataSourceCandidateRecord, Ci as isRangeTopLeft, Cn as ParentBudget, Cr as TemplateCellSkeleton, Ct as DwgView, D as DataSourcePolicy, Di as rangeContains, Dn as PdfTextQuality, Dr as TemplateImageBytes, Dt as EMU_PER_TWIP, E as DataSourceKind, Ei as parseCellRange, En as PdfPageImage, Er as TemplateFillWarning, Et as EMU_PER_POINT, F as DelegationRequest, Fn as PerceptionScope, Fr as TodoItem, Ft as GeneratedSkillDraft, G as DocumentToolSourceOptions, Gn as RemoteImageToolSourceOptions, Gr as XlsxDocumentReader, Gt as OpenedTabSignal, H as DocumentImageRole, Hn as RemoteImageFetch, Hr as WorksetTab, Ht as MAX_DIGIT_WIDTH, I as DelegationResult, In as PerceptionScopeInput, Ir as TodoList, It as HttpDataSourceOptions, J as DocxTemplateEngine, Jn as SKILL_GENERATION_SYSTEM_PROMPT, Jr as XlsxTemplateEngine, Jt as PAGE_ACTION_TOOL, K as DocxDocumentContent, Kn as RenderedImage, Kr as XlsxFillOutcome, Kt as PAGE_ACTION_KINDS, L as DelegationToolSourceOptions, Ln as PptxDocumentContent, Lr as TodoListener, Lt as INSPECT_TEMPLATE_TOOL, M as DelegationBudget, Mi as toFrameScopes, Mn as PerceptionPagingBudget, Mr as TemplateTableCellSkeleton, Mt as FrameNote, N as DelegationOrchestrator, Ni as withDelegationOrigin, Nn as PerceptionRecord, Nr as TemplateToolSourceOptions, Nt as FrameScope, O as DataSourcePolicyOptions, Oi as readImageSize, On as PerceivedImage, Or as TemplateImageResolver, Ot as EXPORT_SPREADSHEET_TOOL, P as DelegationOrchestratorOptions, Pn as PerceptionResult, Pr as TodoEvent, Pt as GENERATE_SKILL_TOOL, Q as DownloadedFileConsent, Qn as SkillBinaryPayload, Qr as clampDownloadWaitMs, Qt as PERCEIVE_PAGE_TOOL, R as DocumentBlock, Rn as PptxDocumentReader, Rr as TodoStatus, Rt as ImageCaptureBudget, S as DataSourceCandidatePolicyOptions, Si as isPdfTextTrustworthy, Sn as PagePerceptionToolSourceOptions, Sr as TabWorksetToolSourceOptions, St as DwgUnits, T as DataSourceDef, Ti as parseCellAddress, Tn as PdfDocumentReader, Tr as TemplateFillRejection, Tt as EMU_PER_PIXEL, U as DocumentReadBudget, Un as RemoteImageFetchFailure, Ur as WorksetTabView, Ut as NestedFrameRef, V as DocumentFormat, Vn as READ_DOWNLOADED_FILE_TOOL, Vr as VIEW_DWG_TOOL, Vt as MANAGE_TODO_TOOL, W as DocumentReadMode, Wn as RemoteImageResult, Wr as XlsxDocumentContent, Wt as OpenedPageInfo, X as DocxTemplateSkeleton, Xn as Size, Xr as XlsxTemplateSkeleton, Xt as PDF_GARBLED_RATIO, Y as DocxTemplateFillSpec, Yn as ScrollDirection, Yr as XlsxTemplateFillSpec, Yt as PAGE_DOCUMENT_REF, Z as DownloadedFileAction, Zn as SkillAttachmentBytes, Zr as asReadMode, Zt as PDF_LARGE_IMAGE_RATIO, _ as DWG_MODEL_VIEW_ID, _i as dwgViewsOf, _n as PageImageResult, _r as TODO_SYSTEM_PROMPT, _t as DwgOmission, a as ActionTabWindow, ai as createHttpDataSourceTransport, an as PageActionPolicy, ar as SkillGeneratorOptions, at as DownloadedFileRecord, b as DataSourceCandidateAuditSink, bi as frameLabel, bn as PagePerceptionPolicyOptions, br as TabWorksetPolicyOptions, bt as DwgProjection, c as CellAddress, ci as createPagePerceptionToolSource, cn as PageActionRequest, cr as SpreadsheetToolSourceOptions, ct as DwgComponent, d as DELEGATE_TASK_TOOL, di as createSpreadsheetToolSource, dn as PageActionTarget, dr as SubtreeRejection, dt as DwgEntity, ei as columnWidthToPixels, en as PERCEPTION_SYSTEM_PROMPT, er as SkillGenerationMessages, et as DownloadedFileListing, f as DELEGATION_SYSTEM_PROMPT, fi as createTabWorksetToolSource, fn as PageActionToolSourceOptions, fr as TAB_WORKSET_DEFAULT_MAX, ft as DwgFill, g as DOWNLOAD_WAIT_MIN_MS, gi as dwgPickView, gn as PageImageFailure, gr as TEMPLATE_INSPECT_BUDGET, gt as DwgLoadedDrawing, h as DOWNLOAD_WAIT_MAX_MS, hi as defersImage, hn as PageImageCapture, hr as TAB_WORKSET_SYSTEM_PROMPT, ht as DwgLayer, i as ActionTabWatcher, ii as createDwgToolSource, in as PageActionOutcome, ir as SkillGenerator, it as DownloadedFileReader, j as DataSourceTransport, ji as toActionFrameScopes, jn as PerceptionCaptureOptions, jr as TemplateSheetSkeleton, jt as FOCUS_PAGE_TAB_TOOL, k as DataSourceProvenance, ki as sniffDocumentFormat, kn as PerceivedNode, kr as TemplateParagraphSkeleton, kt as FETCH_REMOTE_IMAGE_TOOL, l as CellRange, li as createRemoteImageToolSource, ln as PageActionScope, lr as SubAgentRunInput, lt as DwgDocumentContent, m as DOWNLOAD_WAIT_DEFAULT_MS, mi as createTodoToolSource, mn as PageAuditSink, mr as TAB_WORKSET_MIN_MAX, mt as DwgGeometry, n as ActionDownloadWindow, ni as createDocumentToolSource, nn as PageActionExecutor, nr as SkillGenerationPolicy, nt as DownloadedFilePolicyOptions, o as CAPTURE_PAGE_IMAGE_TOOL, oi as createPageActionToolSource, on as PageActionPolicyOptions, or as SkillTraceEvidence, ot as DownloadedFileToolSourceOptions, p as DOCUMENT_READ_BUDGET, pi as createTemplateToolSource, pn as PageActionUi, pr as TAB_WORKSET_MAX_MAX, pt as DwgFont, q as DocxDocumentReader, qn as SCROLL_DIRECTIONS, qr as XlsxSheetContent, qt as PAGE_ACTION_SYSTEM_PROMPT, r as ActionFrameScope, ri as createDownloadedFileToolSource, rn as PageActionKind, rr as SkillGenerationToolSourceOptions, rt as DownloadedFileReadResult, s as CLOSE_PAGE_TAB_TOOL, si as createPageImageToolSource, sn as PageActionRecord, sr as SkillTraceEvidenceStep, st as DwgBounds, t as ActionDownloadWatcher, ti as createDelegationToolSource, tn as PageActionConsent, tr as SkillGenerationOutcome, tt as DownloadedFilePolicy, u as ConsentUi, ui as createSkillGenerationToolSource, un as PageActionScopeInput, ur as SubAgentRunner, ut as DwgDocumentReader, v as DataSourceAuditSink, vi as fitWithin, vn as PageImageToolSourceOptions, vr as TabAdmission, vt as DwgPoint, w as DataSourceCandidateStore, wi as measurePdfTextQuality, wn as PdfDocumentHandle, wr as TemplateFileSource, wt as DwgViewport, x as DataSourceCandidatePolicy, xi as frameSteps, xn as PagePerceptionReader, xr as TabWorksetPort, xt as DwgToolSourceOptions, y as DataSourceCandidate, yi as formatCellAddress, yn as PagePerceptionPolicy, yr as TabWorksetPolicy, yt as DwgProjectedDrawing, z as DocumentFileBytes, zn as PptxSlideContent, zr as TodoStore, zt as LIST_DOWNLOADED_FILES_TOOL } from "./index-B3rMAUWB.js";
+export { type ActionDownloadWatcher, type ActionDownloadWindow, type ActionFrameScope, type ActionTabWatcher, type ActionTabWindow, CAPTURE_PAGE_IMAGE_TOOL, CLOSE_PAGE_TAB_TOOL, type CellAddress, type CellRange, type ConsentUi, DEFAULT_MAX_DATA_SOURCE_BYTES, DELEGATE_TASK_TOOL, DELEGATION_SYSTEM_PROMPT, DOCUMENT_READ_BUDGET, DOWNLOAD_WAIT_DEFAULT_MS, DOWNLOAD_WAIT_MAX_MS, DOWNLOAD_WAIT_MIN_MS, DWG_MODEL_VIEW_ID, type DataSourceAuditSink, type DataSourceCandidate, type DataSourceCandidateAuditSink, DataSourceCandidatePolicy, type DataSourceCandidatePolicyOptions, type DataSourceCandidateRecord, type DataSourceCandidateStore, type DataSourceDef, type DataSourceKind, DataSourcePolicy, type DataSourcePolicyOptions, type DataSourceProvenance, type DataSourceRecord, type DataSourceTransport, type DelegationBudget, DelegationOrchestrator, type DelegationOrchestratorOptions, type DelegationRequest, type DelegationResult, type DelegationToolSourceOptions, type DocumentBlock, type DocumentFileBytes, type DocumentFileSource, type DocumentFormat, type DocumentImageRole, type DocumentReadBudget, type DocumentReadMode, type DocumentToolSourceOptions, type DocxDocumentContent, type DocxDocumentReader, type DocxTemplateEngine, type DocxTemplateFillSpec, type DocxTemplateSkeleton, type DownloadedFileAction, type DownloadedFileConsent, type DownloadedFileEntry, type DownloadedFileListing, DownloadedFilePolicy, type DownloadedFilePolicyOptions, type DownloadedFileReadResult, type DownloadedFileReader, type DownloadedFileRecord, type DownloadedFileToolSourceOptions, type DwgBounds, type DwgComponent, type DwgDocumentContent, type DwgDocumentReader, type DwgEntity, type DwgFill, type DwgFont, type DwgGeometry, type DwgLayer, type DwgLoadedDrawing, type DwgOmission, type DwgPoint, type DwgProjectedDrawing, type DwgProjection, type DwgToolSourceOptions, type DwgUnits, type DwgView, type DwgViewport, EMU_PER_PIXEL, EMU_PER_POINT, EMU_PER_TWIP, EXPORT_SPREADSHEET_TOOL, FETCH_REMOTE_IMAGE_TOOL, FILL_TEMPLATE_TOOL, FOCUS_PAGE_TAB_TOOL, type FrameNote, type FrameScope, GENERATE_SKILL_TOOL, type GeneratedSkillDraft, type HttpDataSourceOptions, INSPECT_TEMPLATE_TOOL, type ImageCaptureBudget, LIST_DOWNLOADED_FILES_TOOL, LIST_PAGE_TABS_TOOL, MANAGE_TODO_TOOL, MAX_DIGIT_WIDTH, type NestedFrameRef, type OpenedPageInfo, type OpenedTabSignal, PAGE_ACTION_KINDS, PAGE_ACTION_SYSTEM_PROMPT, PAGE_ACTION_TOOL, PAGE_DOCUMENT_REF, PDF_GARBLED_RATIO, PDF_LARGE_IMAGE_RATIO, PERCEIVE_PAGE_TOOL, PERCEPTION_PAGING_DEFAULTS, PERCEPTION_SYSTEM_PROMPT, type PageActionConsent, type PageActionExecutor, type PageActionKind, type PageActionOutcome, PageActionPolicy, type PageActionPolicyOptions, type PageActionRecord, type PageActionRequest, type PageActionScope, type PageActionScopeInput, type PageActionTarget, type PageActionToolSourceOptions, type PageActionUi, type PageAuditSink, type PageImageCapture, type PageImageFailure, type PageImageResult, type PageImageToolSourceOptions, PagePerceptionPolicy, type PagePerceptionPolicyOptions, type PagePerceptionReader, type PagePerceptionToolSourceOptions, type ParentBudget, type PdfDocumentHandle, type PdfDocumentReader, type PdfPageImage, type PdfTextQuality, type PerceivedImage, type PerceivedNode, type PerceptionAuditSink, type PerceptionCaptureOptions, type PerceptionPagingBudget, type PerceptionRecord, type PerceptionResult, type PerceptionScope, type PerceptionScopeInput, type PptxDocumentContent, type PptxDocumentReader, type PptxSlideContent, READ_DOCUMENT_TOOL, READ_DOWNLOADED_FILE_TOOL, type RemoteImageFetch, type RemoteImageFetchFailure, type RemoteImageResult, type RemoteImageToolSourceOptions, type RenderedImage, SCROLL_DIRECTIONS, SKILL_GENERATION_SYSTEM_PROMPT, type ScrollDirection, type Size, type SkillAttachmentBytes, type SkillBinaryPayload, type SkillCandidateSink, type SkillGenerationMessages, type SkillGenerationOutcome, type SkillGenerationPolicy, type SkillGenerationToolSourceOptions, SkillGenerator, type SkillGeneratorOptions, type SkillTraceEvidence, type SkillTraceEvidenceStep, type SpreadsheetToolSourceOptions, type SubAgentRunInput, type SubAgentRunner, type SubtreeRejection, TAB_WORKSET_DEFAULT_MAX, TAB_WORKSET_MAX_MAX, TAB_WORKSET_MIN_MAX, TAB_WORKSET_SYSTEM_PROMPT, TEMPLATE_INSPECT_BUDGET, TODO_SYSTEM_PROMPT, type TabAdmission, TabWorksetPolicy, type TabWorksetPolicyOptions, type TabWorksetPort, type TabWorksetToolSourceOptions, type TemplateCellSkeleton, type TemplateFileSource, type TemplateFillRejection, type TemplateFillWarning, type TemplateImageBytes, type TemplateImageResolver, type TemplateParagraphSkeleton, type TemplateSheetBlanks, type TemplateSheetSkeleton, type TemplateTableCellSkeleton, type TemplateToolSourceOptions, type TodoEvent, type TodoItem, type TodoList, type TodoListener, type TodoStatus, TodoStore, type TodoToolSourceOptions, VIEW_DWG_TOOL, type WorksetTab, type WorksetTabView, type XlsxDocumentContent, type XlsxDocumentReader, type XlsxFillOutcome, type XlsxSheetContent, type XlsxTemplateEngine, type XlsxTemplateFillSpec, type XlsxTemplateSkeleton, asReadMode, clampDownloadWaitMs, clampWorksetMax, columnWidthToPixels, createDelegationToolSource, createDocumentToolSource, createDownloadedFileToolSource, createDwgToolSource, createHttpDataSourceTransport, createPageActionToolSource, createPageImageToolSource, createPagePerceptionToolSource, createRemoteImageToolSource, createSkillGenerationToolSource, createSpreadsheetToolSource, createTabWorksetToolSource, createTemplateToolSource, createTodoToolSource, defersImage, dwgPickView, dwgViewsOf, fitWithin, formatCellAddress, frameLabel, frameSteps, isPdfTextTrustworthy, isRangeTopLeft, measurePdfTextQuality, parseCellAddress, parseCellRange, rangeContains, readImageSize, sniffDocumentFormat, takesImage, toActionFrameScopes, toFrameScopes, withDelegationOrigin };

package/dist/agent.js

@@ -2172,7 +2172,7 @@ var PageActionPolicy = class {
 			ok: outcome.ok,
 			...request.action === "fill" && request.value !== void 0 && !secret ? { value: request.value } : {},
 			...request.action === "scroll" && outcome.scrolled !== void 0 ? { scrolled: {
-				direction: request.value === "up" ? "up" : "down",
+				direction: scrollDirectionOf(request.value),
 				...outcome.scrolled
 			} } : {},
 			...outcome.reason !== void 0 ? { reason: outcome.reason } : {}
@@ -2216,6 +2216,8 @@ var PageActionPolicy = class {
 * 措辞刻意保守：提示词里的鼓励性表述会直接抬高模型尝试操作的频率，
 * 而每一次尝试都要打断用户去点确认。
 */
+/** 与 toolSource 的校验失败文案同源：模型看到的取值集合必须就是被校验的那个集合 */
+const DIRECTIONS = SCROLL_DIRECTIONS.map((d) => `"${d}"`).join(" / ");
 const PAGE_ACTION_SYSTEM_PROMPT = [
 	"You can act on the current page, but only within the regions the host made actionable.",
 	"Targets must come from the \"ref\" values in a fresh perceive_page result — you cannot construct them, and CSS selectors are rejected.",
@@ -2223,7 +2225,7 @@ const PAGE_ACTION_SYSTEM_PROMPT = [
 	"A reference expires as soon as the page is perceived again; perceive first, then act.",
 	"After an action, the result tells you where it led. \"openedTab\" means a new page opened — switch to it with focus_page_tab to read it. \"navigated\" means this page itself moved to a new address. \"elevatedModal\" means a dialog opened on this page. If none of the three appear, the page did not change.",
 	"Use the \"back\" action to return to the previous page in this page's history. It takes no \"ref\" and no \"value\", and it only affects the page you are currently on. After going back, always perceive_page again: every reference from before the action is dead.",
-	"Use the \"scroll\" action only when the page itself says there is more than you can see (for example a list that says it has 20 rows but shows 13). Pass the \"ref\" of any element inside the region you want to scroll and a \"value\" of \"down\" or \"up\"; the region is found for you, so do not look for a reference to the scrollbar or the container. The result carries \"scrolled\": when \"atEnd\" is true there is nothing further in that direction — stop scrolling and answer with what you have. Perceive the page again after each scroll: rows that left the screen no longer exist and their references are dead.",
+	"Use the \"scroll\" action only when the page itself says there is more than you can see (for example a list that says it has 20 rows but shows 13). Pass the \"ref\" of any element inside the region you want to scroll and a \"value\" of " + DIRECTIONS + "; the region is found for you, so do not look for a reference to the scrollbar or the container. Use \"left\" / \"right\" when a region is wider than it can show — a table whose columns run off the side, for example. The result carries \"scrolled\": when \"atEnd\" is true there is nothing further in that direction — stop scrolling and answer with what you have. Perceive the page again after each scroll: rows that left the screen no longer exist and their references are dead.",
 	"Use the \"hover\" action when a menu, tooltip or icon only appears while the pointer rests on something — a dropdown that ignores clicks, or a table header whose filter icon is invisible until hovered. Pass the \"ref\" of the thing to hover over and no \"value\". Then perceive_page again: whatever appeared is new and has no reference until you read it. If the result says \"noop\": true, nothing on the page reacted, and hovering again will not help — some pages reveal those panels through a pure CSS effect that only a real pointer can trigger. Say so and offer another route instead of retrying.",
 	"Use the \"drag\" action to drag one element onto another — reordering a list by its drag handle, for example. Pass the \"ref\" of what you are dragging and a \"value\" holding the ref of where it should land. Both must come from a perceive_page result, so perceive first and make sure the destination is actually on screen. You can only express a start and an end; there is no path, speed or pause in between."
 ].join("\n");
@@ -3276,8 +3278,13 @@ const TEMPLATE_INSPECT_BUDGET = {
 	cells: 400,
 	chars: 2e4
 };
-const INSPECT_DESCRIPTION = "Look inside an Excel (.xlsx) or Word (.docx) template the user attached, and report where things are: sheet names, cell addresses and their current text, merged regions; for Word, paragraph indexes and table/row/column coordinates. A cell reported with a \"formula\" is worked out by the template itself; fill the cells it reads instead. Call this before fill_template — you cannot guess a template's layout.";
-const FILL_DESCRIPTION = "Fill an Excel (.xlsx) or Word (.docx) template the user attached and hand the result back as a downloadable file. Everything the template already contains — styling, column widths, merged cells, formulas, headers and footers — is kept exactly as it was; only the places you name are written. The one exception is VBA macros: if the template is a macro-enabled workbook or document, the result is a plain .xlsx or .docx and its macros are dropped. Say so when you hand the file over.";
+/**
+* 待填区/只读区最多列几条。不导出、不并进 `TEMPLATE_INSPECT_BUDGET`——
+* 给那个 `as const` 常量加字段，会把一处纯内部的预算决定变成公开契约。
+*/
+const BLANK_RANGE_LIMIT = 100;
+const INSPECT_DESCRIPTION = "Look inside an Excel (.xlsx) or Word (.docx) template the user attached, and report where things are: sheet names, cell addresses and their current text, merged regions; for Word, paragraph indexes and table/row/column coordinates. For Excel it also reports what the template is waiting for: \"blankRanges\" are empty cells the template reserved — that is where the data goes, and leaving them empty is the most common way to get this wrong. \"coveredRanges\" are swallowed by a merged region: writing there shows nothing, write the top-left cell instead. \"headerRows\" are the template's own headings; do not overwrite them. A cell reported with a \"formula\" is worked out by the template itself — fill the cells that formula reads. Those cells are often absent from this listing because the template never styled them; they are still writable. Call this before fill_template — you cannot guess a template's layout.";
+const FILL_DESCRIPTION = "Fill an Excel (.xlsx) or Word (.docx) template the user attached and hand the result back as a downloadable file. Everything the template already contains — styling, column widths, merged cells, formulas, headers and footers — is kept exactly as it was; only the places you name are written. Cells that cannot be written come back one by one in \"rejected\" while every other cell is still written, so fix just those and call again. \"stillBlank\" lists cells the template is still waiting for — if it is not empty the template is not finished. The one exception is VBA macros: if the template is a macro-enabled workbook or document, the result is a plain .xlsx or .docx and its macros are dropped. Say so when you hand the file over.";
 const TEMPLATE_ID = "The attachment id, or the id from list_downloaded_files.";
 function inspectSchema(idHint) {
 	return {
@@ -3321,7 +3328,7 @@ function fillSchema(withImages, idHint) {
 			},
 			cells: {
 				type: "array",
-				description: "Excel only. Each entry writes one cell. Never write to a cell that inspect_template reported with a \"formula\" — an amount or a total is the template's own calculation, and overwriting it produces a sheet that no longer adds up when anything changes.",
+				description: "Excel only. Each entry writes one cell. Write every address listed in \"blankRanges\" that your data covers — those are the cells the template reserved. Never write to a cell that inspect_template reported with a \"formula\" — an amount or a total is the template's own calculation, and overwriting it produces a sheet that no longer adds up when anything changes.",
 				items: {
 					type: "object",
 					properties: {
@@ -3447,7 +3454,7 @@ function fillSchema(withImages, idHint) {
 	};
 }
 function systemPrompt(withImages) {
-	return "When the user gives you a form, a table or a report template and asks you to produce a filled-in copy, fill that template — do not build a new file from scratch and do not describe what to type where. Always call inspect_template first: the addresses and coordinates come from it, never from guesswork, and a wrong address is a wrong file. fill_template returns only a summary; the file is delivered to the user as a card, so do not read it back. The template is left untouched — everything it already contains is preserved, and you only name the places that change. When the template has too few detail rows for the data, insert rows instead of overwriting the rows below." + (withImages ? " A template that reserves space for a photo takes one: reference the picture as \"artifact:<name>\" or \"upload:<id or name>\" and give the cell it belongs in. Do not hand the picture over separately and ask the user to paste it." : "");
+	return "When the user gives you a form, a table or a report template and asks you to produce a filled-in copy, fill that template — do not build a new file from scratch and do not describe what to type where. Always call inspect_template first: the addresses and coordinates come from it, never from guesswork, and a wrong address is a wrong file. fill_template returns only a summary; the file is delivered to the user as a card, so do not read it back. The template is left untouched — everything it already contains is preserved, and you only name the places that change. When the template has too few detail rows for the data, insert rows instead of overwriting the rows below. Read what fill_template gives back: anything in \"rejected\" was not written and needs a different address, and anything in \"stillBlank\" is a cell the template is still waiting for. Fill those in and call again before telling the user the file is ready." + (withImages ? " A template that reserves space for a photo takes one: reference the picture as \"artifact:<name>\" or \"upload:<id or name>\" and give the cell it belongs in. Do not hand the picture over separately and ask the user to paste it." : "");
 }
 function toolError(e) {
 	return {
@@ -3541,6 +3548,9 @@ function createTemplateToolSource(options) {
 				const cells = sheet.cells.slice(0, Math.max(left, 0));
 				if (cells.length < sheet.cells.length) truncated = true;
 				left -= cells.length;
+				const blankRanges = (sheet.blanks ?? []).slice(0, BLANK_RANGE_LIMIT);
+				const coveredRanges = (sheet.covered ?? []).slice(0, BLANK_RANGE_LIMIT);
+				if (blankRanges.length < (sheet.blanks ?? []).length) truncated = true;
 				return {
 					name: sheet.name,
 					range: sheet.range,
@@ -3550,6 +3560,9 @@ function createTemplateToolSource(options) {
 						...cell.formula === void 0 ? {} : { formula: cell.formula }
 					})),
 					...sheet.merges.length > 0 ? { merges: [...sheet.merges] } : {},
+					...blankRanges.length > 0 ? { blankRanges } : {},
+					...coveredRanges.length > 0 ? { coveredRanges } : {},
+					...sheet.headerRows !== void 0 && sheet.headerRows.length > 0 ? { headerRows: [...sheet.headerRows] } : {},
 					...cells.length < sheet.cells.length ? { omittedCells: sheet.cells.length - cells.length } : {}
 				};
 			});
@@ -3606,14 +3619,24 @@ function createTemplateToolSource(options) {
 					};
 				}) } : {}
 			};
-			const bytes = await xlsx.fill(template.bytes, spec);
-			const artifact = await writeArtifact(fileName, bytes, XLSX_MIME, context);
+			const outcome = await xlsx.fill(template.bytes, spec);
+			const artifact = await writeArtifact(fileName, outcome.bytes, XLSX_MIME, context);
 			return json({
 				path: artifact.path,
 				size: artifact.size,
-				filledCount: spec.cells?.length ?? 0,
+				filledCount: outcome.filled,
 				insertedRows: (spec.rows ?? []).reduce((total, row) => total + row.count, 0),
-				...images.length > 0 ? { imageCount: images.length } : {}
+				...images.length > 0 ? { imageCount: images.length } : {},
+				...outcome.rejected.length > 0 ? { rejected: outcome.rejected.map(({ sheet, address, reason }) => ({
+					sheet,
+					address,
+					reason
+				})) } : {},
+				...outcome.warnings.length > 0 ? { warnings: [...outcome.warnings] } : {},
+				...outcome.stillBlank.length > 0 ? { stillBlank: outcome.stillBlank.map(({ sheet, ranges }) => ({
+					sheet,
+					ranges: [...ranges]
+				})) } : {}
 			});
 		}
 		const spec = {

package/dist/browser.d.ts

@@ -1,6 +1,6 @@
-import { G as FileStat, It as VerifyResult, K as FileSystemProvider, Lt as WebSkillError, N as ArchiveLimits, Ot as SkillsLockfile, Pt as UnsignedPolicy, S as UiBridge, St as SkillManifest, b as RenderResultRequest, c as InteractionResponse, jt as TrustedKeyStore, l as LlmClient, m as LlmStreamEvent, o as InteractionPolicy, p as LlmResponse, q as FileWriteStream, s as InteractionRequest, u as LlmCompleteInput, v as MemoryStore, vt as SkillInstallSource } from "./types-CpDRZ0rA-BiZBXGm4.js";
-import { $ as ImageOmission, B as ExternalToolSource, C as BridgeResponse, N as DocumentSurfaceHost, Pn as ToolResult, S as BridgeRequest, Sr as bridgeError, Yr as parseBridgeRequest, b as BridgeCapabilities, ct as LinkedDocumentReader, en as ScriptExecutionContext, jn as ToolDefinition, m as ApprovalScope, mr as WebSkillApi, sr as ViewerImageFact, tn as ScriptExecutor, ut as NetworkPolicy, z as ExternalSkillProvider } from "./index-7No55dRb.js";
-import { Hr as XlsxDocumentReader, In as PerceptionScopeInput, K as DocxDocumentContent, Ln as PptxDocumentContent, Pn as PerceptionResult, Rn as PptxDocumentReader, Tn as PdfDocumentReader, Ut as NestedFrameRef, Vr as XlsxDocumentContent, cn as PageActionRequest, dn as PageActionTarget, dr as SubtreeRejection, in as PageActionOutcome, jn as PerceptionCaptureOptions, kn as PerceivedNode, mn as PageAuditSink, nn as PageActionExecutor, q as DocxDocumentReader, u as ConsentUi, un as PageActionScopeInput, xn as PagePerceptionReader, yn as PagePerceptionPolicy } from "./index-V76_OFj2.js";
+import { G as FileStat, It as VerifyResult, K as FileSystemProvider, Lt as WebSkillError, N as ArchiveLimits, Ot as SkillsLockfile, Pt as UnsignedPolicy, S as UiBridge, St as SkillManifest, b as RenderResultRequest, c as InteractionResponse, jt as TrustedKeyStore, l as LlmClient, m as LlmStreamEvent, o as InteractionPolicy, p as LlmResponse, q as FileWriteStream, s as InteractionRequest, u as LlmCompleteInput, v as MemoryStore, vt as SkillInstallSource } from "./types-CpDRZ0rA-CFQ-vdKz.js";
+import { $ as ImageOmission, B as ExternalToolSource, C as BridgeResponse, N as DocumentSurfaceHost, Pn as ToolResult, S as BridgeRequest, Sr as bridgeError, Yr as parseBridgeRequest, b as BridgeCapabilities, ct as LinkedDocumentReader, en as ScriptExecutionContext, jn as ToolDefinition, m as ApprovalScope, mr as WebSkillApi, sr as ViewerImageFact, tn as ScriptExecutor, ut as NetworkPolicy, z as ExternalSkillProvider } from "./index-Bq299VnF.js";
+import { Gr as XlsxDocumentReader, In as PerceptionScopeInput, K as DocxDocumentContent, Ln as PptxDocumentContent, Pn as PerceptionResult, Rn as PptxDocumentReader, Tn as PdfDocumentReader, Ut as NestedFrameRef, Wr as XlsxDocumentContent, cn as PageActionRequest, dn as PageActionTarget, dr as SubtreeRejection, in as PageActionOutcome, jn as PerceptionCaptureOptions, kn as PerceivedNode, mn as PageAuditSink, nn as PageActionExecutor, q as DocxDocumentReader, u as ConsentUi, un as PageActionScopeInput, xn as PagePerceptionReader, yn as PagePerceptionPolicy } from "./index-B3rMAUWB.js";
 //#region ../browser/dist/index.d.ts
 //#region src/fs/featureDetection.d.ts
 /** 检测当前环境是否可用 OPFS（navigator.storage.getDirectory） */
@@ -1694,6 +1694,12 @@ interface XlsxTemplateSheet {
   }>;
   readonly merges: readonly string[];
   readonly columnWidths: readonly number[];
+  /** 空着、等着被填的格，压成矩形区间（0.24.0 FR-17.1 / FR-17.3） */
+  readonly blanks?: readonly string[];
+  /** 被合并区吞掉的格（不含左上角），写进去不会显示（FR-17.4） */
+  readonly covered?: readonly string[];
+  /** 表头行，1 基（FR-17.5） */
+  readonly headerRows?: readonly number[];
 }
 interface XlsxTemplateSkeleton {
   readonly sheets: readonly XlsxTemplateSheet[];
@@ -1725,6 +1731,31 @@ interface XlsxTemplateSpec {
   readonly cells?: readonly XlsxCellFill[];
   readonly images?: readonly XlsxImagePlacement[];
 }
+/** 一条被挡回的填写（0.24.0 FR-17.8 · 设计 18 §4.2） */
+interface XlsxFillRejection {
+  readonly sheet: string;
+  readonly address: string;
+  readonly code: 'TEMPLATE_CELL_IS_FORMULA' | 'TEMPLATE_CELL_IS_COVERED';
+  readonly reason: string;
+}
+/** 放行了，但值得说一句（写进了推导出来的表头行） */
+interface XlsxFillWarning {
+  readonly sheet: string;
+  readonly address: string;
+  readonly reason: string;
+}
+interface XlsxSheetBlanks {
+  readonly sheet: string;
+  readonly ranges: readonly string[];
+}
+/** 填充回执（FR-17.8 ~ FR-17.12）。`filled` 是真正写进文件的条数，不是请求条数。 */
+interface XlsxFillOutcome {
+  readonly bytes: Uint8Array;
+  readonly filled: number;
+  readonly rejected: readonly XlsxFillRejection[];
+  readonly warnings: readonly XlsxFillWarning[];
+  readonly stillBlank: readonly XlsxSheetBlanks[];
+}
 /** 读带坐标的骨架（FR-42.1）。模型据此决定往哪儿写。 */
 declare function readXlsxTemplate(bytes: Uint8Array): Promise<XlsxTemplateSkeleton>;
 /**
@@ -1732,9 +1763,13 @@ declare function readXlsxTemplate(bytes: Uint8Array): Promise<XlsxTemplateSkelet
  *
  * 顺序是**先插行、后填值**：填值用的地址是插行之后的坐标，反过来会逼模型心算偏移。
  *
- * @throws WebSkillError 模板不是 xlsx、地址不合法、目标不存在、插行越界
+ * 格值写入是**部分应用**（0.24.0 FR-17.8）：撞上护栏的逐条记进回执，其余照常落盘。
+ * 插行与图片仍然全或无——插了一半再中止，后面所有地址的行号都偏了，
+ * 「部分应用」在那里没有可理解的语义。
+ *
+ * @throws WebSkillError 模板不是 xlsx、地址不合法、目标不存在、插行越界、或请求的格一条都没写成
  */
-declare function fillXlsxTemplate(bytes: Uint8Array, spec: XlsxTemplateSpec): Promise<Uint8Array>;
+declare function fillXlsxTemplate(bytes: Uint8Array, spec: XlsxTemplateSpec): Promise<XlsxFillOutcome>;
 //#endregion
 //#region src/document/docxTemplate.d.ts
 interface DocxTemplateParagraph {
@@ -2713,4 +2748,4 @@ interface WebOfficeToolSourceOptions {
  */
 declare function createWebOfficeToolSource(options: WebOfficeToolSourceOptions): ExternalToolSource;
 //#endregion
-export { type BlockedEventLike, type BridgeCapabilities, type BridgeRequest, type BridgeResponse, type BrowserHostBundle, type BrowserHostOptions, type BrowserHostOverrides, BrowserSkillManager, BrowserWorkerScriptExecutor, type BuiltinSkillManifest, type CameraAvailability, type CameraOptions, type CameraSession, type CaptureFailure, type CaptureLevel, type CapturePhotoOptions, type CapturedImage, type ChromeBuiltinAvailability, ChromeBuiltinLlmClient, type CompressResult, type ConfiguredLlmClient, DEFAULT_CAMERA_MAX_DIMENSION, DEFAULT_FRAME_BUDGET, DEFAULT_MAX_VIEWER_PAYLOAD_BYTES, DEFAULT_MAX_VIEWER_PAYLOAD_PIXELS, DEFAULT_SOFT_VIEWER_PAYLOAD_BYTES, DEFAULT_SOFT_VIEWER_PAYLOAD_PIXELS, DOCUMENT_IMAGE_MIME_TYPES, DOCUMENT_SURFACE_AUDIT_EVENT, DOCX_IMAGE_WIDTH_RATIO, DOCX_UNEXTRACTED, type DictationAvailability, type DictationOptions, type DictationSession, type DocumentBlock, type DocumentImage, type DocumentLocationView, type DocumentSurfaceAudit, type DocumentSurfaceOptions, type DocxImagePlacement, type DocxTemplateCell, type DocxTemplateParagraph, type DocxTemplateSkeleton, type DocxTemplateSpec, type DocxTextFill, type DomPageActionExecutor, type DomPageActionOptions, type DomPerceptionReader, type DomPerceptionReaderOptions, type FetchLinkedDocumentOptions, type FetchRemoteImageOptions, type FrameBudget, type FrameDelivery, type FrameDispatcher, type FrameResolveContext, type FrameRouter, type FrameRouterOptions, HOST_PORT_MATRIX, type HandleKind, type HostChatbotAdapterShape, type HostConnectFacadeShape, type HostConsoleBackendShape, type HostKind, type HostSurface, type IframeSandboxOptions, IframeWorkerLike, type InspectHostWiringInput, LIST_WEBOFFICE_DOCUMENTS_TOOL, type LlmClientConfig, type LlmEntryConfig, MAX_REMOTE_IMAGE_BYTES, type MainToWorkerMessage, type OoxmlPackage, type OpenDocumentInput, OpfsProvider, PPTX_UNEXTRACTED, PPTX_UNEXTRACTED_NOTICE, type PageAgentHandler, type PageAgentHandlerOptions, type PageAgentReply, type PageAgentRequest, type PageAgentTargetEntry, type PageAgentTransport, type PageDocumentIdentity, type PageImageHost, type PayloadDimension, type PayloadSizeNotice, type PdfPage, type PortApplicability, type PortReport, type PortSpec, type PortStatus, type PresentationSlide, type PresentationSourceDocument, type PresentationSourceReader, type PresentationSourceSlide, READ_WEBOFFICE_DOCUMENT_TOOL, REMOTE_IMAGE_TIMEOUT_MS, type RemoteFetchFailure, type RemoteImageFailure, type RemoteImageHost, type RemotePageActionExecutorOptions, type RemotePageImageHostOptions, type RemotePerceptionReaderOptions, type RemoteTargetRegistry, type RemoteTargetRegistryOptions, type RoleHint, SANDBOX_PAGE_SCRIPT_SOURCE, SHARD_SOFT_LIMIT, type SandboxMode, type SandboxTokenDiff, type SeedSkillsFromHttpOptions, type SerializedError, type TargetResolution, TsTranspiler, type TypeScriptSupportOptions, VIEWER_IMG_SRC_BASE, VIEWER_IMG_SRC_REMOTE, VIEWER_SANDBOX_TOKENS, type ViewerBlockedHost, type ViewerBlockedNotice, type ViewerBlockedResult, type ViewerCspOptions, type ViewerDocument, type ViewerShellHost, type ViewerShellMount, type ViewerShellResult, type VisionCaptureOptions, WEBOFFICE_BUDGET, WEBOFFICE_UNEXTRACTED, WEB_OFFICE_OFFICE_TYPES, WEB_OFFICE_READ_METHODS, WEB_OFFICE_SUPPORTED_TYPES, WORKER_BOOTSTRAP_SOURCE, type WebOfficeAction, type WebOfficeApiSurface, type WebOfficeAuditRecord, type WebOfficeAuthorizationInput, type WebOfficeAuthorizationKey, type WebOfficeAuthorizationOutcome, type WebOfficeBudget, WebOfficeBudgetGuard, type WebOfficeChannel, type WebOfficeConsent, type WebOfficeContent, type WebOfficeDisplayHints, type WebOfficeExtractOptions, type WebOfficeFailure, type WebOfficeFingerprintResult, type WebOfficeHost, type WebOfficeInstanceRecord, type WebOfficeListing, WebOfficePolicy, type WebOfficePolicyOptions, type WebOfficeReadCursor, type WebOfficeReadOptions, type WebOfficeReadPort, type WebOfficeReadResult, type WebOfficeScrollPosition, type WebOfficeSupportedType, type WebOfficeToolSourceOptions, type WebOfficeVisionPort, type WindowLike, type WorkbookSheet, type WorkerEvent, type WorkerFactory, type WorkerLike, type WorkerRequest, WorkerRuntimeClient, type WorkerRuntimeClientDeps, type WorkerRuntimeHostOverrides, type WorkerScopeLike, WorkerUiBridge, XLSX_IMAGE_MIN_COLUMNS, XLSX_IMAGE_MIN_ROWS, XLSX_UNEXTRACTED, type XlsxCellFill, type XlsxImagePlacement, type XlsxRowInsert, type XlsxTemplateSheet, type XlsxTemplateSkeleton, type XlsxTemplateSpec, assertWebOfficeFingerprint, auditOoxmlPackage, blockedMessage, bridgeError, callWebOfficeMethod, captureByScrolling, captureDocumentImage, captureElementImage, capturePhoto, checkCameraAvailability, checkDictationAvailability, checkWebOfficeFingerprint, classifyFetchFailure, compressImageToBudget, contentKindOf, createBrowserChatbotHost, createDocumentSurfaceHost, createDocxBlockReader, createDomPageActionExecutor, createDomPerceptionReader, createEncryptedMemoryStore, createFetchLinkedDocumentReader, createFrameRouter, createIframeWorker, createLlmClient, createPageAgentHandler, createPptxBlockReader, createRemoteImageHost, createRemotePageActionExecutor, createRemotePageImageHost, createRemotePerceptionReader, createRemoteTargetRegistry, createWebOfficeHandle, createWebOfficeToolSource, createXlsxBlockReader, deleteMemoryEncryptionKey, describeScreenshotOverlap, diffSandboxTokens, documentKey, explainResolution, extractDocxText, extractPptxText, extractWebOfficeContent, extractXlsxText, extractZipWeb, fetchRemoteImage, fillDocxTemplate, fillXlsxTemplate, generateMemoryEncryptionKey, headingLevelOf, inspectHostWiring, installWebSkillNavigator, isCapturableElement, isCaptureFailure, isEncryptedMemoryValue, isOpfsAvailable, isRemoteImageFailure, isWebOfficeReadMethod, missingPorts, openCamera, openDocumentSurface, openMemoryEncryptionKey, parseBridgeRequest, parseMainMessage, parseWorkerEvent, probeChromeBuiltinAvailability, readDocxBlocks, readDocxTemplate, readOoxmlPackage, readPptxBlocks, readXlsxBlocks, readXlsxTemplate, resolveWebOfficeAuthorization, seedSkillsFromHttp, sha256HexWeb, startDictation, startViewerShell, startWorkerRuntimeHost, toDocumentImage, viewerCspHeader, watchBlockedResources, webOfficeFailure, writeOoxmlPackage };
+export { type BlockedEventLike, type BridgeCapabilities, type BridgeRequest, type BridgeResponse, type BrowserHostBundle, type BrowserHostOptions, type BrowserHostOverrides, BrowserSkillManager, BrowserWorkerScriptExecutor, type BuiltinSkillManifest, type CameraAvailability, type CameraOptions, type CameraSession, type CaptureFailure, type CaptureLevel, type CapturePhotoOptions, type CapturedImage, type ChromeBuiltinAvailability, ChromeBuiltinLlmClient, type CompressResult, type ConfiguredLlmClient, DEFAULT_CAMERA_MAX_DIMENSION, DEFAULT_FRAME_BUDGET, DEFAULT_MAX_VIEWER_PAYLOAD_BYTES, DEFAULT_MAX_VIEWER_PAYLOAD_PIXELS, DEFAULT_SOFT_VIEWER_PAYLOAD_BYTES, DEFAULT_SOFT_VIEWER_PAYLOAD_PIXELS, DOCUMENT_IMAGE_MIME_TYPES, DOCUMENT_SURFACE_AUDIT_EVENT, DOCX_IMAGE_WIDTH_RATIO, DOCX_UNEXTRACTED, type DictationAvailability, type DictationOptions, type DictationSession, type DocumentBlock, type DocumentImage, type DocumentLocationView, type DocumentSurfaceAudit, type DocumentSurfaceOptions, type DocxImagePlacement, type DocxTemplateCell, type DocxTemplateParagraph, type DocxTemplateSkeleton, type DocxTemplateSpec, type DocxTextFill, type DomPageActionExecutor, type DomPageActionOptions, type DomPerceptionReader, type DomPerceptionReaderOptions, type FetchLinkedDocumentOptions, type FetchRemoteImageOptions, type FrameBudget, type FrameDelivery, type FrameDispatcher, type FrameResolveContext, type FrameRouter, type FrameRouterOptions, HOST_PORT_MATRIX, type HandleKind, type HostChatbotAdapterShape, type HostConnectFacadeShape, type HostConsoleBackendShape, type HostKind, type HostSurface, type IframeSandboxOptions, IframeWorkerLike, type InspectHostWiringInput, LIST_WEBOFFICE_DOCUMENTS_TOOL, type LlmClientConfig, type LlmEntryConfig, MAX_REMOTE_IMAGE_BYTES, type MainToWorkerMessage, type OoxmlPackage, type OpenDocumentInput, OpfsProvider, PPTX_UNEXTRACTED, PPTX_UNEXTRACTED_NOTICE, type PageAgentHandler, type PageAgentHandlerOptions, type PageAgentReply, type PageAgentRequest, type PageAgentTargetEntry, type PageAgentTransport, type PageDocumentIdentity, type PageImageHost, type PayloadDimension, type PayloadSizeNotice, type PdfPage, type PortApplicability, type PortReport, type PortSpec, type PortStatus, type PresentationSlide, type PresentationSourceDocument, type PresentationSourceReader, type PresentationSourceSlide, READ_WEBOFFICE_DOCUMENT_TOOL, REMOTE_IMAGE_TIMEOUT_MS, type RemoteFetchFailure, type RemoteImageFailure, type RemoteImageHost, type RemotePageActionExecutorOptions, type RemotePageImageHostOptions, type RemotePerceptionReaderOptions, type RemoteTargetRegistry, type RemoteTargetRegistryOptions, type RoleHint, SANDBOX_PAGE_SCRIPT_SOURCE, SHARD_SOFT_LIMIT, type SandboxMode, type SandboxTokenDiff, type SeedSkillsFromHttpOptions, type SerializedError, type TargetResolution, TsTranspiler, type TypeScriptSupportOptions, VIEWER_IMG_SRC_BASE, VIEWER_IMG_SRC_REMOTE, VIEWER_SANDBOX_TOKENS, type ViewerBlockedHost, type ViewerBlockedNotice, type ViewerBlockedResult, type ViewerCspOptions, type ViewerDocument, type ViewerShellHost, type ViewerShellMount, type ViewerShellResult, type VisionCaptureOptions, WEBOFFICE_BUDGET, WEBOFFICE_UNEXTRACTED, WEB_OFFICE_OFFICE_TYPES, WEB_OFFICE_READ_METHODS, WEB_OFFICE_SUPPORTED_TYPES, WORKER_BOOTSTRAP_SOURCE, type WebOfficeAction, type WebOfficeApiSurface, type WebOfficeAuditRecord, type WebOfficeAuthorizationInput, type WebOfficeAuthorizationKey, type WebOfficeAuthorizationOutcome, type WebOfficeBudget, WebOfficeBudgetGuard, type WebOfficeChannel, type WebOfficeConsent, type WebOfficeContent, type WebOfficeDisplayHints, type WebOfficeExtractOptions, type WebOfficeFailure, type WebOfficeFingerprintResult, type WebOfficeHost, type WebOfficeInstanceRecord, type WebOfficeListing, WebOfficePolicy, type WebOfficePolicyOptions, type WebOfficeReadCursor, type WebOfficeReadOptions, type WebOfficeReadPort, type WebOfficeReadResult, type WebOfficeScrollPosition, type WebOfficeSupportedType, type WebOfficeToolSourceOptions, type WebOfficeVisionPort, type WindowLike, type WorkbookSheet, type WorkerEvent, type WorkerFactory, type WorkerLike, type WorkerRequest, WorkerRuntimeClient, type WorkerRuntimeClientDeps, type WorkerRuntimeHostOverrides, type WorkerScopeLike, WorkerUiBridge, XLSX_IMAGE_MIN_COLUMNS, XLSX_IMAGE_MIN_ROWS, XLSX_UNEXTRACTED, type XlsxCellFill, type XlsxFillOutcome, type XlsxFillRejection, type XlsxFillWarning, type XlsxImagePlacement, type XlsxRowInsert, type XlsxSheetBlanks, type XlsxTemplateSheet, type XlsxTemplateSkeleton, type XlsxTemplateSpec, assertWebOfficeFingerprint, auditOoxmlPackage, blockedMessage, bridgeError, callWebOfficeMethod, captureByScrolling, captureDocumentImage, captureElementImage, capturePhoto, checkCameraAvailability, checkDictationAvailability, checkWebOfficeFingerprint, classifyFetchFailure, compressImageToBudget, contentKindOf, createBrowserChatbotHost, createDocumentSurfaceHost, createDocxBlockReader, createDomPageActionExecutor, createDomPerceptionReader, createEncryptedMemoryStore, createFetchLinkedDocumentReader, createFrameRouter, createIframeWorker, createLlmClient, createPageAgentHandler, createPptxBlockReader, createRemoteImageHost, createRemotePageActionExecutor, createRemotePageImageHost, createRemotePerceptionReader, createRemoteTargetRegistry, createWebOfficeHandle, createWebOfficeToolSource, createXlsxBlockReader, deleteMemoryEncryptionKey, describeScreenshotOverlap, diffSandboxTokens, documentKey, explainResolution, extractDocxText, extractPptxText, extractWebOfficeContent, extractXlsxText, extractZipWeb, fetchRemoteImage, fillDocxTemplate, fillXlsxTemplate, generateMemoryEncryptionKey, headingLevelOf, inspectHostWiring, installWebSkillNavigator, isCapturableElement, isCaptureFailure, isEncryptedMemoryValue, isOpfsAvailable, isRemoteImageFailure, isWebOfficeReadMethod, missingPorts, openCamera, openDocumentSurface, openMemoryEncryptionKey, parseBridgeRequest, parseMainMessage, parseWorkerEvent, probeChromeBuiltinAvailability, readDocxBlocks, readDocxTemplate, readOoxmlPackage, readPptxBlocks, readXlsxBlocks, readXlsxTemplate, resolveWebOfficeAuthorization, seedSkillsFromHttp, sha256HexWeb, startDictation, startViewerShell, startWorkerRuntimeHost, toDocumentImage, viewerCspHeader, watchBlockedResources, webOfficeFailure, writeOoxmlPackage };

package/dist/browser.js

@@ -8,7 +8,7 @@ import { a as GoogleGenAiClient, o as AnthropicClient, s as OpenAiCompatibleClie
 import { c as toBase64$1, f as SPREADSHEET_MIME_TYPE } from "./linkedDocument-CZZOl9cO.js";
 import { n as normalizeToolContent, t as mergeCatalogEntries } from "./external-_ZRQe-V9.js";
 import { t as createWebSkillApi } from "./webSkillApi-D5VMUnrv.js";
-import { A as frameSteps, D as SCROLL_DIRECTIONS, E as toActionFrameScopes, O as toFrameScopes, _ as defersImage, a as columnWidthToPixels, b as isPdfTextTrustworthy, f as readImageSize, k as frameLabel, l as parseCellAddress, n as EMU_PER_POINT, o as fitWithin, p as PDF_LARGE_IMAGE_RATIO, r as EMU_PER_TWIP$1, s as formatCellAddress, t as EMU_PER_PIXEL, u as parseCellRange, v as takesImage } from "./geometry-CRhuySKV.js";
+import { A as frameSteps, D as SCROLL_DIRECTIONS, E as toActionFrameScopes, O as toFrameScopes, _ as defersImage, a as columnWidthToPixels, b as isPdfTextTrustworthy, c as isRangeTopLeft, d as rangeContains, f as readImageSize, k as frameLabel, l as parseCellAddress, n as EMU_PER_POINT, o as fitWithin, p as PDF_LARGE_IMAGE_RATIO, r as EMU_PER_TWIP$1, s as formatCellAddress, t as EMU_PER_PIXEL, u as parseCellRange, v as takesImage } from "./geometry-CRhuySKV.js";
 import { zipSync } from "fflate";
 
 //#region ../browser/src/fs/featureDetection.ts
@@ -7092,6 +7092,156 @@ function formulaTextOf(cell, hosts) {
 	if (host === void 0 || address === null) return "";
 	return offsetFormulaRows(host.body, parseCellAddress(address).row - host.row);
 }
+const hasFormula = (cell) => [...cell.children].some((child) => child.localName === "f");
+const rangeLabel = (start, end) => start.column === end.column && start.row === end.row ? formatCellAddress(start) : `${formatCellAddress(start)}:${formatCellAddress(end)}`;
+function mergeRangesOf(doc) {
+	const ranges = [];
+	for (const merge of byTag$1(doc, "mergeCell")) {
+		const ref = merge.getAttribute("ref");
+		if (ref !== null && ref !== "") ranges.push(parseCellRange(ref));
+	}
+	return ranges;
+}
+/**
+* 合并区里除左上角之外的部分（FR-17.4 · 设计 18 §2.3）。
+*
+* 报的是「写了没用的格」，不是「这里有块合并、请你自己排除左上角」——
+* 后者等于把区间算术外包给概率。挖掉左上角一格，剩下的总能切成
+* 最多两个矩形：右边一条 + 下面一块。
+*/
+function coveredRangesOf(merges) {
+	const out = [];
+	for (const { start, end } of merges) {
+		if (end.column > start.column) out.push(rangeLabel({
+			column: start.column + 1,
+			row: start.row
+		}, {
+			column: end.column,
+			row: start.row
+		}));
+		if (end.row > start.row) out.push(rangeLabel({
+			column: start.column,
+			row: start.row + 1
+		}, end));
+	}
+	return out;
+}
+/**
+* 待填格：XML 里存在这个 `<c>`、没值、没公式、且不是合并区从属格（设计 18 §2.1）。
+*
+* 「XML 里存在」是刻意的收窄：模板作者刷过格式的格才会被写进文件，
+* 那个 `<c>` 就是他留下的坑位记号。把从没出现过的格也算进来，
+* 两百列的噪声会淹掉真正的那一列。
+*/
+function blankAddressesOf(doc, shared, merges) {
+	const out = [];
+	for (const cell of byTag$1(doc, "c")) {
+		const address = cell.getAttribute("r");
+		if (address === null || cellText(cell, shared) !== "" || hasFormula(cell)) continue;
+		const parsed = parseCellAddress(address);
+		if (merges.some((range) => rangeContains(range, parsed) && !isRangeTopLeft(range, parsed))) continue;
+		out.push(parsed);
+	}
+	return out;
+}
+/**
+* 把散落的格压成矩形区间（FR-17.3 · 设计 18 §3）。
+*
+* 两趟：先同列纵向合并连续行，再把行范围**完全相同**的相邻列横向合并。
+* 行范围差一格就不合——宁可多报一条区间，也不能报出一个覆盖了非待填格的矩形，
+* 那会把模型引向一个写不进去的地址。
+*/
+function compressToRanges(addresses) {
+	const byColumn = /* @__PURE__ */ new Map();
+	for (const { column, row } of addresses) {
+		const rows = byColumn.get(column);
+		if (rows === void 0) byColumn.set(column, [row]);
+		else rows.push(row);
+	}
+	const strips = [];
+	for (const [column, rows] of [...byColumn].sort(([a], [b]) => a - b)) {
+		const [head, ...rest] = [...new Set(rows)].sort((a, b) => a - b);
+		if (head === void 0) continue;
+		let from = head;
+		let to = head;
+		for (const row of rest) {
+			if (row === to + 1) {
+				to = row;
+				continue;
+			}
+			strips.push({
+				column,
+				from,
+				to
+			});
+			from = row;
+			to = row;
+		}
+		strips.push({
+			column,
+			from,
+			to
+		});
+	}
+	const blocks = [];
+	for (const strip of strips) {
+		const left = blocks.find((block) => block.last === strip.column - 1 && block.from === strip.from && block.to === strip.to);
+		if (left === void 0) blocks.push({
+			first: strip.column,
+			last: strip.column,
+			from: strip.from,
+			to: strip.to
+		});
+		else left.last = strip.column;
+	}
+	return blocks.map((block) => rangeLabel({
+		column: block.first,
+		row: block.from
+	}, {
+		column: block.last,
+		row: block.to
+	}));
+}
+/** dimension 的列跨度，用来判一条合并区是不是「横跨整表宽」 */
+function sheetColumnSpan(doc) {
+	const ref = byTag$1(doc, "dimension")[0]?.getAttribute("ref");
+	if (ref === null || ref === void 0 || ref === "") return void 0;
+	const { start, end } = parseCellRange(ref);
+	return {
+		first: start.column,
+		last: end.column
+	};
+}
+/**
+* 表头行（FR-17.5 · 设计 18 §2.4）。
+*
+* 自上而下扫，遇到数据就停。区分表头与表尾的信号是「在不在数据之前」，
+* 不是「有没有合并」——表尾的照片粘贴区同样横跨整表宽，
+* 照「全宽合并即表头」去判，会把整张明细区一起卷进表头。
+*
+* 判据是启发式的（表头里写了年份会提前停），所以它只用于警示，不用于硬挡。
+*/
+function headerRowsOf(doc, merges) {
+	const span = sheetColumnSpan(doc);
+	const fullWidth = /* @__PURE__ */ new Set();
+	for (const range of merges) {
+		if (span === void 0 || range.start.column !== span.first || range.end.column !== span.last) continue;
+		for (let row = range.start.row; row <= range.end.row; row += 1) fullWidth.add(row);
+	}
+	const header = [];
+	for (const row of rowsOf(doc)) {
+		const number = rowNumberOf(row);
+		if (!Number.isInteger(number)) break;
+		const cells = byTag$1(row, "c");
+		if (cells.some(hasFormula)) break;
+		if (cells.some((cell) => {
+			const type = cell.getAttribute("t");
+			return (type === null || type === "n") && byTag$1(cell, "v").length > 0;
+		}) && !fullWidth.has(number - 1)) break;
+		header.push(number);
+	}
+	return header;
+}
 /** 读带坐标的骨架（FR-42.1）。模型据此决定往哪儿写。 */
 async function readXlsxTemplate(bytes) {
 	const pkg = await readOoxmlPackage(bytes);
@@ -7124,12 +7274,19 @@ async function readXlsxTemplate(bytes) {
 			if (!Number.isInteger(min) || !Number.isInteger(max) || !Number.isFinite(width)) continue;
 			for (let index = min; index <= max; index += 1) columnWidths[index - 1] = width;
 		}
+		const merges = mergeRangesOf(doc);
+		const blanks = compressToRanges(blankAddressesOf(doc, shared, merges));
+		const covered = coveredRangesOf(merges);
+		const headerRows = headerRowsOf(doc, merges);
 		sheets.push({
 			name: entry.name,
 			range: byTag$1(doc, "dimension")[0]?.getAttribute("ref") ?? "",
 			cells,
 			merges: byTag$1(doc, "mergeCell").map((merge) => merge.getAttribute("ref")).filter((ref) => ref !== null),
-			columnWidths
+			columnWidths,
+			...blanks.length > 0 ? { blanks } : {},
+			...covered.length > 0 ? { covered } : {},
+			...headerRows.length > 0 ? { headerRows } : {}
 		});
 	}
 	return { sheets };
@@ -7290,24 +7447,51 @@ function growFormulaRanges(formula, at, count) {
 	});
 }
 /**
-* 写值（FR-42.5）。数字写成数字，其余写成文本，不做类型推断（FR-42.26）。
+* 往一个格里写值（FR-42.5）。数字写成数字，其余写成文本，不做类型推断（FR-42.26）。
 *
 * 用 `inlineStr` 而不是往共享串表追加：改动的数据部件从两个降到一个（设计 43 §1.4）。
 * 单元格有三种形态（空壳 / 带值 / 不存在），三支都显式处理——静默跳过正是 FR-42.6 要禁的。
 *
-* @throws WebSkillError 目标格是公式格
+* 撞上护栏**不抛**，回报（0.24.0 FR-17.8）：模型一次写四十格、其中一格撞上公式，
+* 另外三十九格不该跟着消失。地址本身非法仍然抛——那不是「这格填不得」，
+* 是给出的字符串根本不是地址，放过去只会让同一个错误重复四十次。
+*
+* @throws WebSkillError 地址语法不合法
 */
-function fillCell(doc, address, value) {
+function fillCell(doc, address, value, guards) {
 	const parsed = parseCellAddress(address);
 	const normalized = formatCellAddress(parsed);
+	const covering = guards.merges.find((range) => rangeContains(range, parsed) && !isRangeTopLeft(range, parsed));
+	if (covering !== void 0) return {
+		ok: false,
+		address: normalized,
+		code: "TEMPLATE_CELL_IS_COVERED",
+		reason: `Cell ${normalized} is covered by the merged region ${rangeLabel(covering.start, covering.end)}, so anything written there is never displayed. Write ${formatCellAddress(covering.start)} instead.`
+	};
 	const row = rowsOf(doc).find((candidate) => rowNumberOf(candidate) === parsed.row + 1) ?? createRow(doc, parsed.row + 1);
 	let cell = byTag$1(row, "c").find((candidate) => candidate.getAttribute("r") === normalized);
 	if (cell === void 0) cell = createCell(doc, row, parsed.column, normalized);
 	const formula = [...cell.children].find((child) => child.localName === "f");
 	if (formula !== void 0) {
 		const body = formula.textContent ?? "";
-		throw new WebSkillError("TEMPLATE_CELL_IS_FORMULA", `Cell ${normalized} is computed by the template${body === "" ? "" : ` (=${body})`} and must not be overwritten. Fill the cells it reads instead; the template works this one out when the file is opened.`);
+		return {
+			ok: false,
+			address: normalized,
+			code: "TEMPLATE_CELL_IS_FORMULA",
+			reason: `Cell ${normalized} is computed by the template${body === "" ? "" : ` (=${body})`} and must not be overwritten. Fill the cells it reads instead; the template works this one out when the file is opened.`
+		};
 	}
+	writeCellValue(doc, cell, value);
+	return guards.headerRows.has(parsed.row + 1) ? {
+		ok: true,
+		address: normalized,
+		warning: `Cell ${normalized} sits on row ${parsed.row + 1}, which looks like one of the template's own heading rows. The value was written; make sure the heading was meant to change.`
+	} : {
+		ok: true,
+		address: normalized
+	};
+}
+function writeCellValue(doc, cell, value) {
 	while (cell.firstChild !== null) cell.removeChild(cell.firstChild);
 	if (value === "") {
 		cell.removeAttribute("t");
@@ -7461,10 +7645,15 @@ function addSheetRelationship(pkg, relsPath, type, target) {
 *
 * 顺序是**先插行、后填值**：填值用的地址是插行之后的坐标，反过来会逼模型心算偏移。
 *
-* @throws WebSkillError 模板不是 xlsx、地址不合法、目标不存在、插行越界
+* 格值写入是**部分应用**（0.24.0 FR-17.8）：撞上护栏的逐条记进回执，其余照常落盘。
+* 插行与图片仍然全或无——插了一半再中止，后面所有地址的行号都偏了，
+* 「部分应用」在那里没有可理解的语义。
+*
+* @throws WebSkillError 模板不是 xlsx、地址不合法、目标不存在、插行越界、或请求的格一条都没写成
 */
 async function fillXlsxTemplate(bytes, spec) {
 	const pkg = await readOoxmlPackage(bytes);
+	const shared = sharedStringsOf(pkg);
 	const sheets = listSheets(pkg);
 	const touched = /* @__PURE__ */ new Map();
 	const partOf = (name) => {
@@ -7476,14 +7665,49 @@ async function fillXlsxTemplate(bytes, spec) {
 			...cached
 		};
 	};
+	const reworked = /* @__PURE__ */ new Map();
 	for (const insert of spec.rows ?? []) {
-		const { doc } = partOf(insert.sheet);
+		const { entry, doc } = partOf(insert.sheet);
 		insertRows(pkg, doc, insert);
-	}
+		reworked.set(entry.path, entry);
+	}
+	const guards = /* @__PURE__ */ new Map();
+	const guardsOf = (path, doc) => {
+		const cached = guards.get(path);
+		if (cached !== void 0) return cached;
+		const merges = mergeRangesOf(doc);
+		const built = {
+			merges,
+			headerRows: new Set(headerRowsOf(doc, merges))
+		};
+		guards.set(path, built);
+		return built;
+	};
+	const rejected = [];
+	const warnings = [];
+	let filled = 0;
 	for (const fill of spec.cells ?? []) {
-		const { doc } = partOf(fill.sheet);
-		fillCell(doc, fill.address, fill.value);
+		const { entry, doc } = partOf(fill.sheet);
+		const outcome = fillCell(doc, fill.address, fill.value, guardsOf(entry.path, doc));
+		if (!outcome.ok) {
+			rejected.push({
+				sheet: entry.name,
+				address: outcome.address,
+				code: outcome.code,
+				reason: outcome.reason
+			});
+			continue;
+		}
+		filled += 1;
+		reworked.set(entry.path, entry);
+		if (outcome.warning !== void 0) warnings.push({
+			sheet: entry.name,
+			address: outcome.address,
+			reason: outcome.warning
+		});
 	}
+	const requested = spec.cells?.length ?? 0;
+	if (requested > 0 && filled === 0) throw new WebSkillError("TEMPLATE_FILL_REJECTED", `None of the ${requested} requested cell(s) could be written. ` + rejected.map((entry) => entry.reason).join(" "), { rejected });
 	const bySheet = /* @__PURE__ */ new Map();
 	for (const image of spec.images ?? []) {
 		const { entry } = partOf(image.sheet);
@@ -7494,11 +7718,27 @@ async function fillXlsxTemplate(bytes, spec) {
 		if (cached === void 0) continue;
 		attachImages(pkg, cached.doc, path, images, geometryOf(cached.doc));
 	}
+	const stillBlank = [];
+	for (const [path, entry] of reworked) {
+		const cached = touched.get(path);
+		if (cached === void 0) continue;
+		const ranges = compressToRanges(blankAddressesOf(cached.doc, shared, mergeRangesOf(cached.doc)));
+		if (ranges.length > 0) stillBlank.push({
+			sheet: entry.name,
+			ranges
+		});
+	}
 	if ([...touched.values()].some(({ doc }) => byTag$1(doc, "f").length > 0)) requestFullCalcOnLoad(pkg);
 	for (const [path, { declaration, doc }] of touched) pkg.set(path, serializeXmlPart(declaration, doc));
 	stripMacros(pkg);
 	assertOoxmlPackage(pkg);
-	return writeOoxmlPackage(pkg);
+	return {
+		bytes: writeOoxmlPackage(pkg),
+		filled,
+		rejected,
+		warnings,
+		stillBlank
+	};
 }
 /** `<calcPr>` 在 CT_Workbook 的序列里排在这几个之后；追加到末尾会落到 `extLst` 后面，那是不合法的 */
 const BEFORE_CALC_PR = [

package/dist/governance.d.ts

@@ -1,6 +1,6 @@
-import { K as FileSystemProvider, S as UiBridge, _t as SkillDocument, et as Page, f as LlmMessage, ht as SkillCatalogEntry, l as LlmClient, tt as PageQuery, xt as SkillManagerPort } from "./types-CpDRZ0rA-BiZBXGm4.js";
-import { Wt as RuntimeRun, dn as SkillIntegrityGuard, fn as SkillOutcomeReporter, gn as SkillStateGuard, hr as WebSkillRuntime, tt as IntegrityVerdict } from "./index-7No55dRb.js";
-import { S as candidateToCatalogEntry, _ as SKILL_VERSION_PAGE_SIZE, a as AuditLog, b as SkillVersionPage, c as CandidateBinaryRef, d as CandidateRisk, f as CandidateSkill, g as CompositeApprovalPolicy, h as CandidateStore, i as AuditEvent, l as CandidateFile, m as CandidateStatus, n as ApprovalDecision, o as AuditQueryFilter, p as CandidateSource, r as ApprovalPolicy, s as CANDIDATE_PAGE_SIZE, t as AlwaysHumanApprovalPolicy, u as CandidatePage, v as SkillState, x as SkillVersionStore, y as SkillVersion } from "./skillVersionStore-S4_HJ_Fl-Cvy9LqVu.js";
+import { K as FileSystemProvider, S as UiBridge, _t as SkillDocument, et as Page, f as LlmMessage, ht as SkillCatalogEntry, l as LlmClient, tt as PageQuery, xt as SkillManagerPort } from "./types-CpDRZ0rA-CFQ-vdKz.js";
+import { Wt as RuntimeRun, dn as SkillIntegrityGuard, fn as SkillOutcomeReporter, gn as SkillStateGuard, hr as WebSkillRuntime, tt as IntegrityVerdict } from "./index-Bq299VnF.js";
+import { S as candidateToCatalogEntry, _ as SKILL_VERSION_PAGE_SIZE, a as AuditLog, b as SkillVersionPage, c as CandidateBinaryRef, d as CandidateRisk, f as CandidateSkill, g as CompositeApprovalPolicy, h as CandidateStore, i as AuditEvent, l as CandidateFile, m as CandidateStatus, n as ApprovalDecision, o as AuditQueryFilter, p as CandidateSource, r as ApprovalPolicy, s as CANDIDATE_PAGE_SIZE, t as AlwaysHumanApprovalPolicy, u as CandidatePage, v as SkillState, x as SkillVersionStore, y as SkillVersion } from "./skillVersionStore-S4_HJ_Fl-Ds97pwm5.js";
 //#region ../governance/dist/index.d.ts
 //#region src/candidate/candidateNormalizer.d.ts
 /** 剥 markdown fence 与 <think> 块、截取首尾 {}；非对象 → CANDIDATE_INVALID */