@webskill/sdk 0.26.0 → 0.27.0

package/README.md

@@ -30,7 +30,9 @@ governance.
   stripped in the worker entry (0.2.3); other host-shared surfaces are NOT
   defended — use `ProcessSandboxExecutor` for untrusted skills.
 - **`navigator.webskill`** — a browser facade (`discover` / `read` / `validate` /
-  `run` / `install` / `uninstall`) assembled explicitly in one call.
+  `run` / `install` / `uninstall`) assembled explicitly in one call. For a
+  native-preserving compatibility package with ESM and standalone IIFE builds,
+  see [`@webskill/polyfill`](../polyfill).
 - **MCP** — call page-provided tools and consume page-declared dynamic skills
   over standard MCP transports (MessageChannel).
 - **Governance** — LLM-generated skill candidates with mandatory review,

package/dist/agent.d.ts

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

package/dist/agent.js

@@ -3,8 +3,8 @@ import { b as parseSkillMarkdown, y as isValidSkillName } from "./skill-WSUDp6A1
 import { t as assertRemoteUrlAllowed } from "./urlSafety-CiSuCJvX.js";
 import { n as sanitizeUntrustedLine, t as UNTRUSTED_LINE_LIMIT } from "./untrustedText-BIaRvPZK.js";
 import { d as extractedDocumentFormat, f as formatAttachmentText, u as classifyAttachment } from "./kind-Dc8x0HWz.js";
-import { c as toBase64, d as SPREADSHEET_LIMITS, f as SPREADSHEET_MIME_TYPE, l as encodeSpreadsheet, m as DEFAULT_MAX_DATA_SOURCE_BYTES, u as SPREADSHEET_EXTENSION } from "./linkedDocument-CZZOl9cO.js";
-import { A as frameSteps, C as DOCUMENT_READ_BUDGET, D as SCROLL_DIRECTIONS, E as toActionFrameScopes, O as toFrameScopes, S as sniffDocumentFormat, T as PAGE_DOCUMENT_REF, _ as defersImage, a as columnWidthToPixels, b as isPdfTextTrustworthy, c as isRangeTopLeft, d as rangeContains, f as readImageSize, g as asReadMode, h as createDocumentToolSource, i as MAX_DIGIT_WIDTH, k as frameLabel, l as parseCellAddress, m as READ_DOCUMENT_TOOL, n as EMU_PER_POINT, o as fitWithin, p as PDF_LARGE_IMAGE_RATIO, r as EMU_PER_TWIP, s as formatCellAddress, t as EMU_PER_PIXEL, u as parseCellRange, v as takesImage, w as PAGE_ACTION_KINDS, x as measurePdfTextQuality, y as PDF_GARBLED_RATIO } from "./geometry-CRhuySKV.js";
+import { c as toBase64, d as SPREADSHEET_LIMITS, f as SPREADSHEET_MIME_TYPE, l as encodeSpreadsheet, m as DEFAULT_MAX_DATA_SOURCE_BYTES, u as SPREADSHEET_EXTENSION } from "./linkedDocument-0iiVPd5t.js";
+import { A as frameSteps, C as DOCUMENT_READ_BUDGET, D as SCROLL_DIRECTIONS, E as toActionFrameScopes, O as toFrameScopes, S as sniffDocumentFormat, T as PAGE_DOCUMENT_REF, _ as defersImage, a as columnWidthToPixels, b as isPdfTextTrustworthy, c as isRangeTopLeft, d as rangeContains, f as readImageSize, g as asReadMode, h as createDocumentToolSource, i as MAX_DIGIT_WIDTH, k as frameLabel, l as parseCellAddress, m as READ_DOCUMENT_TOOL, n as EMU_PER_POINT, o as fitWithin, p as PDF_LARGE_IMAGE_RATIO, r as EMU_PER_TWIP, s as formatCellAddress, t as EMU_PER_PIXEL, u as parseCellRange, v as takesImage, w as PAGE_ACTION_KINDS, x as measurePdfTextQuality, y as PDF_GARBLED_RATIO } from "./geometry-BXMPNuM6.js";
 
 //#region ../agent/src/todo/store.ts
 const STATUSES = [
@@ -257,7 +257,8 @@ function createTodoToolSource(options = {}) {
 				store.clear();
 				return Promise.resolve(ok(events, progressText([])));
 			}
-			return Promise.resolve(toolError$9("VALIDATION_FAILED", "The \"action\" argument must be one of create, update, clear"));
+			const detail = action === void 0 ? "The \"action\" argument is required." : `Unknown action ${JSON.stringify(action)}.`;
+			return Promise.resolve(toolError$9("VALIDATION_FAILED", `${detail} Use one of create, update, clear.`));
 		} catch (e) {
 			const code = e instanceof Error && "code" in e ? String(e.code) : "VALIDATION_FAILED";
 			return Promise.resolve(toolError$9(code, e instanceof Error ? e.message : String(e)));
@@ -1332,7 +1333,8 @@ var PagePerceptionPolicy = class {
 			nodes,
 			images,
 			imagesOmitted,
-			record
+			record,
+			...result.page === void 0 ? {} : { page: result.page }
 		};
 	}
 	/**
@@ -1431,16 +1433,22 @@ const SUBTREE_CODES = /* @__PURE__ */ new Set([
 	"PERCEPTION_SUBTREE_OUT_OF_SCOPE",
 	"PERCEPTION_SUBTREE_UNKNOWN_REF"
 ]);
-function toolError$6(code, message) {
+function toolError$6(code, message, data) {
 	return {
 		ok: false,
 		content: [],
 		error: {
 			code,
-			message
+			message,
+			...data !== void 0 ? { data } : {}
 		}
 	};
 }
+/** 失效游标不是总能有“当前有效游标”：只有同一 run 的 pending 快照才有。 */
+function cursorError(options) {
+	if (options.paged && options.pending !== void 0 && options.pending.runId === options.runId) return toolError$6("PERCEPTION_CURSOR_INVALID", CURSOR_REJECTED, { cursors: [...options.pending.cursors.keys()] });
+	return toolError$6("PERCEPTION_CURSOR_INVALID", CURSOR_REJECTED, { restart: true });
+}
 /**
 * 游标 id。**不以随机性作为安全依据**：猜中一个游标，模型也只能拿到同一份快照的
 * 另一段——那本来就是宿主授权它读的内容。授权自始至终由 `scope` 承担（设计 §5.2）。
@@ -1541,8 +1549,16 @@ function createPagePerceptionToolSource(options) {
 			if (ref !== void 0 && typeof ref !== "string") return toolError$6("PERCEPTION_REF_INVALID", "perceive_page needs \"ref\" to be a string when it is present.");
 			if (cursor !== void 0) {
 				const index = typeof cursor === "string" ? pending?.cursors.get(cursor) : void 0;
-				if (!paged || pending === void 0 || index === void 0 || pending.runId !== context?.runId) return toolError$6("PERCEPTION_CURSOR_INVALID", CURSOR_REJECTED);
-				if (ref !== void 0 && ref !== pending.subtreeRef) return toolError$6("PERCEPTION_CURSOR_INVALID", CURSOR_REJECTED);
+				if (!paged || pending === void 0 || index === void 0 || pending.runId !== context?.runId) return cursorError({
+					pending,
+					paged,
+					runId: context?.runId
+				});
+				if (ref !== void 0 && ref !== pending.subtreeRef) return cursorError({
+					pending,
+					paged: true,
+					runId: context?.runId
+				});
 				return resultOf(pending, index);
 			}
 			try {
@@ -1553,8 +1569,9 @@ function createPagePerceptionToolSource(options) {
 					maxImages: image?.maxImages ?? 0,
 					minImageArea: image?.minImageArea ?? 0
 				};
-				const { nodes, images, imagesOmitted, record } = await policy.perceive(capture, ref === void 0 ? void 0 : { ref });
+				const { nodes, images, imagesOmitted, record, page } = await policy.perceive(capture, ref === void 0 ? void 0 : { ref });
 				const data = {
+					...page === void 0 ? {} : { page },
 					scope: record.include,
 					excluded: record.exclude,
 					nodes
@@ -2434,7 +2451,10 @@ var TabWorksetPolicy = class {
 			page: pageOf(tab),
 			...from !== void 0 ? { from } : {}
 		});
-		return { focused: handle };
+		return {
+			focused: handle,
+			...tab.url !== void 0 ? { url: tab.url } : {}
+		};
 	}
 	async close(handle) {
 		const tabs = await this.#options.port.list();
@@ -2529,7 +2549,7 @@ function pageOf(tab) {
 */
 const TAB_WORKSET_SYSTEM_PROMPT = `You can work across several pages within one task.
 
-- \`list_page_tabs\` shows the pages available to you. The first one is the user's own page; you can read and act on it, but you can never close it.
+- \`list_page_tabs\` shows the pages available to you, each with its current address. The first one is the user's own page; you can read and act on it, but you can never close it. When a task asks you to share a link to a page you are on, take that address from this list — you cannot type an address yourself.
 - \`focus_page_tab\` decides which page \`perceive_page\` and \`act_on_page\` talk to next. Element references are per-page: a reference from one page will be rejected on another, so perceive after every switch.
 - New pages only join this set when an action you took opened them. You cannot open a page by URL, and pages the user opens on their own are not yours to touch.
 - Close a detail page with \`close_page_tab\` once you have read what you needed. Leaving them open uses up the page budget and will eventually block new ones.
@@ -2571,7 +2591,7 @@ const TAB_SCHEMA = {
 const SPECS = [
 	{
 		name: LIST_PAGE_TABS_TOOL,
-		description: "List the pages available to this task. The first entry is the user's own page and cannot be closed. Takes no arguments.",
+		description: "List the pages available to this task, with each page's current address. The first entry is the user's own page and cannot be closed. Takes no arguments.",
 		inputSchema: LIST_SCHEMA
 	},
 	{
@@ -4323,7 +4343,7 @@ const TEMPLATE_INSPECT_BUDGET = {
 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.";
+const TEMPLATE_ID = "The id (or file name) of a file the user attached to any message in this conversation, or the id from list_downloaded_files.";
 function inspectSchema(idHint) {
 	return {
 		type: "object",
@@ -4562,7 +4582,7 @@ function createTemplateToolSource(options) {
 	async function load(raw, tool, context) {
 		if (typeof raw !== "string" || raw === "") throw new WebSkillError("TOOL_UNSUPPORTED", `${tool} requires the "template" id of an attachment or download.`);
 		const file = await files.read(raw, context);
-		if (file === void 0) throw new WebSkillError("TOOL_UNSUPPORTED", `No readable file with id "${raw}". It is either not an attachment of the current message, or a download id that has since expired — list the downloads again to get a fresh one.`);
+		if (file === void 0) throw new WebSkillError("TOOL_UNSUPPORTED", `No readable file with id "${raw}". It is neither an attachment of this conversation nor a download id that is still valid — a download id may have expired; list the downloads again to get a fresh one.`);
 		const format = sniffDocumentFormat(file.bytes, file.name);
 		if (format !== "xlsx" && format !== "docx") throw new WebSkillError("TEMPLATE_UNSUPPORTED", `"${file.name}" is not an Excel (.xlsx) or Word (.docx) file, so it cannot be used as a template.`);
 		if ((format === "xlsx" ? xlsx : docx) === void 0) throw new WebSkillError("TEMPLATE_UNSUPPORTED", `This environment cannot fill ${format} templates.`);

package/dist/{approval-7CuZS3Z4.js → approval-BSwffz8P.js}

@@ -3,7 +3,7 @@ import { b as parseSkillMarkdown, i as buildCatalog, n as SkillDiscovery, r as S
 import { o as atomicWriteText, r as resolveInsideRoot, t as assertSafePathSegment } from "./pathSecurity-CirkQwWP.js";
 import { t as assertRemoteUrlAllowed } from "./urlSafety-CiSuCJvX.js";
 import { c as findUnpairedToolCalls, d as partsToText, f as promptText, l as interruptedToolResult, p as textParts, u as sealToolCallPairs } from "./llm-eIQNO9tr.js";
-import { a as UNSUPPORTED_DOCUMENT_MESSAGE, c as toBase64, f as SPREADSHEET_MIME_TYPE, g as DEFAULT_MAX_DOCUMENT_TEXT_BYTES, h as DEFAULT_MAX_DOCUMENT_BYTES, i as SUPPORTED_DOCUMENT_MIME, l as encodeSpreadsheet, n as READ_LINKED_DOCUMENT_TOOL, o as fromBase64, r as READ_LINKED_DOCUMENT_TOOL_NAME, s as isBytesOnlyDocument, v as TEXT_BUDGETED_CONTENT_TYPES } from "./linkedDocument-CZZOl9cO.js";
+import { a as UNSUPPORTED_DOCUMENT_MESSAGE, c as toBase64, f as SPREADSHEET_MIME_TYPE, g as DEFAULT_MAX_DOCUMENT_TEXT_BYTES, h as DEFAULT_MAX_DOCUMENT_BYTES, i as SUPPORTED_DOCUMENT_MIME, l as encodeSpreadsheet, n as READ_LINKED_DOCUMENT_TOOL, o as fromBase64, r as READ_LINKED_DOCUMENT_TOOL_NAME, s as isBytesOnlyDocument, v as TEXT_BUDGETED_CONTENT_TYPES } from "./linkedDocument-0iiVPd5t.js";
 import { t as mergeCatalogEntries } from "./external-_ZRQe-V9.js";
 import { i as isArtifactCardHidden, n as extractChartSpec, r as admitArtifactMetadata, t as buildRenderResult } from "./renderResult-D9Q-Vu2x.js";
 import { t as extractUiSpecEvents } from "./surface-DVGiCmwq.js";
@@ -1412,6 +1412,7 @@ var AgentLoop = class {
 			maxTurns: this.#config.maxTurns,
 			totalTimeoutMs: this.#config.totalTimeoutMs,
 			externalToolSchemas: /* @__PURE__ */ new Map(),
+			exposeReadSkillFile: true,
 			controller: new AbortController()
 		};
 		this.#controllers.set(runId, state.controller);
@@ -1424,6 +1425,7 @@ var AgentLoop = class {
 			strategy: route.strategy,
 			skillCount: route.catalog.entries.length
 		} });
+		state.exposeReadSkillFile = route.catalog.entries.length > 0 || (this.#deps.skillProviders?.length ?? 0) > 0;
 		await this.#lifecycle({
 			phase: "route",
 			data: {
@@ -1572,7 +1574,7 @@ var AgentLoop = class {
 				const externalToolSpecs = externalSpecs.filter((spec) => this.#disclosed(state, spec.name));
 				const skillToolSpecs = [...scriptToolSpecs, ...externalToolSpecs];
 				const toolSpecs = this.#config.toolCallingDisabled ? [] : [
-					toLlmToolSpec(READ_SKILL_FILE_TOOL),
+					...state.exposeReadSkillFile ? [toLlmToolSpec(READ_SKILL_FILE_TOOL)] : [],
 					...this.#deps.uiBridge ? [toLlmToolSpec(ASK_USER_TOOL)] : [],
 					...this.#deps.linkedDocuments ? [toLlmToolSpec(READ_LINKED_DOCUMENT_TOOL)] : [],
 					...skillToolSpecs
@@ -1871,6 +1873,7 @@ var AgentLoop = class {
 			maxTurns: snapshot.config.maxTurns,
 			totalTimeoutMs: snapshot.config.totalTimeoutMs,
 			externalToolSchemas: /* @__PURE__ */ new Map(),
+			exposeReadSkillFile: true,
 			controller: new AbortController()
 		};
 		this.#controllers.set(runId, state.controller);

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-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-DRkI7M3z.js";
-import { $r as XlsxTableReader, In as PerceptionScopeInput, K as DocxDocumentContent, Ln as PptxDocumentContent, Pn as PerceptionResult, Rn as PptxDocumentReader, Tn as PdfDocumentReader, Ut as NestedFrameRef, Xr as XlsxDocumentReader, Yr as XlsxDocumentContent, cn as PageActionRequest, dn as PageActionTarget, fr 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-Bb9kBiF0.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-D6eSrEi5.js";
+import { $r as XlsxTableReader, In as PerceptionScopeInput, K as DocxDocumentContent, Ln as PptxDocumentContent, Pn as PerceptionResult, Rn as PptxDocumentReader, Tn as PdfDocumentReader, Ut as NestedFrameRef, Xr as XlsxDocumentReader, Yr as XlsxDocumentContent, cn as PageActionRequest, dn as PageActionTarget, fr 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-QKiMepxO.js";
 //#region ../browser/dist/index.d.ts
 //#region src/fs/featureDetection.d.ts
 /** 检测当前环境是否可用 OPFS（navigator.storage.getDirectory） */
@@ -1636,9 +1636,9 @@ declare function readDocxBlocks(bytes: Uint8Array): Promise<DocxDocumentContent>
  * 图不是浮在表外的附件，它压着某几行几列——按锚点插回行流里，
  * 模型才知道「这张图说的是上面那几行」。
  */
-/** 值得单独烧一次多模态的图：至少跨 2 列、3 行（FR-22.11） @experimental */
+/** @experimental @deprecated 0.27.0 起不再按跨度过滤图片；保留导出仅为兼容既有调用。 */
 declare const XLSX_IMAGE_MIN_COLUMNS = 2;
-/** @experimental */
+/** @experimental @deprecated 0.27.0 起不再按跨度过滤图片；保留导出仅为兼容既有调用。 */
 declare const XLSX_IMAGE_MIN_ROWS = 3;
 /** @experimental */
 declare function createXlsxBlockReader(): XlsxDocumentReader;