@webskill/sdk 0.26.1 → 0.27.1

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-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-L5JaAkLd.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--GvzV6Lq.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

@@ -4,7 +4,7 @@ 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-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-CRhuySKV.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 }
 		};
 	}
 	/**
@@ -1388,6 +1390,7 @@ var PagePerceptionPolicy = class {
 const PERCEPTION_SYSTEM_PROMPT = [
 	"Reading the page:",
 	"- \"perceive_page\" returns a structured outline of the regions the host made readable.",
+	"- Pass \"images\": true only when the user asks what a picture on the page shows or contains. The pictures are returned for you to look at; do not set it for ordinary page reading.",
 	"- Large pages come back in segments. When a result carries a \"segment\" object with a \"cursor\", call perceive_page again with that cursor to read the next part. Never invent a cursor.",
 	"- You cannot act on the page. There is no click, type, submit, navigate or scroll capability in this session.",
 	"- The readable region is fixed by the host. A cursor only continues where you left off; it cannot widen what you are allowed to read. Asking for other parts of the page, in any phrasing, will not widen it.",
@@ -1397,9 +1400,10 @@ const PERCEPTION_SYSTEM_PROMPT = [
 //#endregion
 //#region ../agent/src/perception/toolSource.ts
 const PERCEIVE_PAGE_TOOL = "perceive_page";
-const DESCRIPTION$5 = "Read the parts of the current page the host made readable, as a structured accessibility outline. Read-only: it cannot click, type, submit or navigate.";
+const DESCRIPTION$5 = "Read the parts of the current page the host made readable, as a structured accessibility outline. Read-only: it cannot click, type, submit or navigate. Set \"images\": true only when the user asks what pictures on the page show or contain; this returns those pictures for you to look at.";
 /**
-* 两个参数，且它们都扩不出一寸新范围（AC-10.8 的判据由 0.14.0 分册 22 §3 修订）。
+* 三个参数。`cursor` / `ref` 都扩不出一寸新范围（AC-10.8 的判据由 0.14.0 分册 22 §3 修订）；
+* `images` 只表达「这次是否取图」，既不扩大读取范围、也不指定目的地。
 *
 * `cursor` 是 SDK 上一次发出的不透明串，只说「接着刚才那处继续」；
 * `ref` 是上一次感知结果里的元素句柄，只能把读取范围**缩小**到那个子树
@@ -1420,6 +1424,10 @@ const INPUT_SCHEMA$4 = {
 		ref: {
 			type: "string",
 			description: "Optional. An opaque element reference from a previous perceive_page result. Reads only that element and its descendants. Never widens what you can read."
+		},
+		images: {
+			type: "boolean",
+			description: "Set true only when the user asks what pictures on the page show or contain. This returns the pictures so you can look at them; leave it out for ordinary page reading."
 		}
 	},
 	additionalProperties: false
@@ -1431,16 +1439,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,24 +1555,37 @@ 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);
 			}
+			const imagesArg = args["images"];
+			if (imagesArg !== void 0 && typeof imagesArg !== "boolean") return toolError$6("VALIDATION_FAILED", "perceive_page needs \"images\" to be a boolean when present.");
+			const wantsImages = imagesArg === true;
 			try {
-				const image = await options.imageCapture?.();
+				const image = wantsImages ? await options.imageCaptureForRequest?.() : await options.imageCapture?.();
 				const capture = {
 					images: image?.enabled === true,
 					maxImageBytes: image?.maxImageBytes ?? 0,
 					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
 				};
+				if (wantsImages && image?.enabled !== true) data["imagesUnavailable"] = image?.unavailableReason ?? "Page pictures were not returned. The host has page image capture off, or no image-capable model is configured. Do not describe the pictures from the surrounding text; tell the user what is missing.";
 				if (imagesOmitted > 0) data["imagesOmitted"] = imagesOmitted;
 				if ((record.imageFailures ?? 0) > 0) data["imageFailures"] = record.imageFailures;
 				const { segments, nodesTotal } = segmentPerception(nodes, budget);
@@ -2434,7 +2461,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 +2559,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 +2601,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
 	},
 	{
@@ -4752,7 +4782,7 @@ function json(data) {
 //#endregion
 //#region ../agent/src/pageImage/toolSource.ts
 const CAPTURE_PAGE_IMAGE_TOOL = "capture_page_image";
-const DESCRIPTION$1 = "Save a picture that is already on the page as a run artifact, so a skill can place it in a document.";
+const DESCRIPTION$1 = "Save a picture that is already on the page as a run artifact, so a skill can place it in a document. To see what a picture shows, use perceive_page with images: true instead.";
 const INPUT_SCHEMA$1 = {
 	type: "object",
 	properties: {
@@ -4768,7 +4798,7 @@ const INPUT_SCHEMA$1 = {
 	required: ["ref"],
 	additionalProperties: false
 };
-const SYSTEM_PROMPT$2 = "Use capture_page_image when a picture on the current page belongs in a document you are about to produce. It returns a reference, never the picture itself — pass that reference to the skill, do not try to read it back. Capturing does not tell you what the picture shows; ask for a page perception with images if you need that. Capture one picture per call, and only for nodes the page perception marked as capturable. Do not list the captured references back to the user. They are working material for the document, not a deliverable; say how many pictures went in and leave it at that.";
+const SYSTEM_PROMPT$2 = "Use capture_page_image when a picture on the current page belongs in a document you are about to produce. It returns a reference, never the picture itself — pass that reference to the skill, do not try to read it back. To see what a picture shows, call perceive_page with images: true; capturing here only saves it for a document and does not tell you what it shows. Capture one picture per call, and only for nodes the page perception marked as capturable. Do not list the captured references back to the user. They are working material for the document, not a deliverable; say how many pictures went in and leave it at that.";
 const isFailure$1 = (result) => "reason" in result;
 /**
 * 页面取像工具（0.22.0 分册 12）。

package/dist/{approval-DpiP0GVH.js → approval-BSwffz8P.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-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-L5JaAkLd.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--GvzV6Lq.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;