@silo-code/sdk 0.23.0 → 0.24.0

package/dist/dnd-service.d.ts

@@ -1,5 +1,5 @@
 import type React from "react";
-import type { Disposable } from "./types";
+import type { Disposable } from "./types.js";
 /**
  * Well-known MIME types for Silo drag payloads. Use these constants (rather than
  * raw strings) so drags interoperate across extensions and built-ins.

package/dist/editor-service.d.ts

@@ -1,6 +1,6 @@
-import type { Disposable } from "./types";
-import type { Event } from "./event";
-import type { EditorMode } from "./domain-types";
+import type { Disposable } from "./types.js";
+import type { Event } from "./event.js";
+import type { EditorMode } from "./domain-types.js";
 /**
  * Options for the editor open methods.
  *

package/dist/event.d.ts

@@ -1,4 +1,4 @@
-import type { Disposable } from "./types";
+import type { Disposable } from "./types.js";
 /**
  * A subscribable event: call it with a listener and receive a
  * {@link Disposable} that cancels the subscription. Modeled on VS Code's

package/dist/extension-storage.d.ts

@@ -1,4 +1,4 @@
-import type { Disposable } from "./types";
+import type { Disposable } from "./types.js";
 /**
  * Namespaced, persisted key/value storage handed to extensions. Two scopes are
  * exposed on {@link ExtensionContext.storage} ({@link ExtensionStorageScopes}):

package/dist/file-service.d.ts

@@ -1,4 +1,4 @@
-import type { Disposable } from "./types";
+import type { Disposable } from "./types.js";
 /**
  * Metadata for a single directory entry, as returned by
  * {@link FileService.readDir}.

package/dist/index.d.ts

@@ -15,33 +15,34 @@
  *
  * @packageDocumentation
  */
-export type { Disposable, DockPanelApi, DockPanelProps, EditorProps, EditorCapabilities, Editor, NewFileTemplate, FileType, Command, MenuId, MenuItemContribution, Keybinding, SidePanelProps, SidePanel, DockPanelKind, StatusItem, SettingsPage, ExtensionContext, Extension, ExtensionManifest, ExtensionHandle, } from "./types";
-export type { Workspace, EditorMode, EditorRecord, SidePanelSlot, } from "./domain-types";
-export type { WorkspaceService, WorkspaceState, CreateWorkspaceInput, WorkspaceStatusRow, WorkspaceStatusProvider, WorkspaceSectionProps, WorkspaceSectionProvider, WorkspaceBadge, WorkspaceBadgeProvider, } from "./workspace-service";
-export type { EditorService, EditorSaveHandlers, OpenFileOptions, EditorViewInfo, OpenDiffSpec, DiffContent, DiffContentRequest, DiffContentProvider, ActiveEditorInfo, EditorsState, EditorSaveEvent, } from "./editor-service";
-export type { LayoutService, LayoutState, SidePanelColumnState, SideLocation, } from "./layout-service";
-export type { ProcessService, ProcessSession, ProcessSpawnOptions, ProcessExecOptions, ProcessExecResult, } from "./process-service";
-export type { ProcessesService, ProcessInfo, ProcessStats, } from "./processes-service";
-export type { TerminalService, CreateTerminalInput, TerminalKind, TerminalRecord, TerminalTabDecoration, TerminalTabDecorationProvider, OscEvent, } from "./terminal-service";
-export type { FileService, FileMeta, FileChangeKind, FileChangeEvent, } from "./file-service";
-export type { SearchService, SearchOptions, SearchMatch, SearchFileResult, SearchResponse, } from "./search-service";
-export type { Permission } from "./permissions";
-export { PathDeniedError } from "./permissions";
-export type { ThemeService, ThemeState, ThemePreset, ResolvedTheme, ThemeBase, ThemeVars, CustomTheme, ThemeExport, } from "./theme-service";
-export type { ExtensionStorage, ExtensionStorageScopes, } from "./extension-storage";
-export type { DndService, DndItem, DndMime, DragInit, DndMode, DropContext, DropTargetHandlers, } from "./dnd-service";
-export { DND_MIME } from "./dnd-service";
-export type { UiService, FileFilter, MenuItem, MenuItemTrailing, MenuSeparator, MenuHeader, MenuEntry, ShowMenuOptions, ConfirmOptions, PromptOptions, ModalOptions, NotifyAction, NotifyOptions, } from "./ui-service";
-export { NetworkError } from "./network-service";
-export type { NetworkService, NetworkRequestOptions, NetworkResponse, NetworkBytesResponse, } from "./network-service";
-export type { SystemService, SystemInfo } from "./system-service";
-export type { LogService, LogLevel } from "./output-service";
-export type { ContextKeys } from "./context-keys";
-export type { Event } from "./event";
-export { path } from "./path";
-export { Tooltip } from "./Tooltip";
-export { useServiceState } from "./use-service-state";
-export type { ReactiveService } from "./use-service-state";
-export { useFocusGroup, focusGroupNextIndex } from "./use-focus-group";
-export type { FocusGroup, FocusGroupOptions, FocusGroupContainerProps, FocusGroupItemProps, FocusGroupOrientation, FocusGroupNavQuery, } from "./use-focus-group";
+export type { Disposable, DockPanelApi, DockPanelProps, EditorProps, EditorCapabilities, Editor, NewFileTemplate, FileType, Command, MenuId, MenuItemContribution, Keybinding, SidePanelProps, SidePanel, DockPanelKind, StatusItem, SettingsPage, ExtensionContext, Extension, ExtensionManifest, ExtensionHandle, } from "./types.js";
+export type { Workspace, EditorMode, EditorRecord, SidePanelSlot, } from "./domain-types.js";
+export type { WorkspaceService, WorkspaceState, CreateWorkspaceInput, WorkspaceStatusRow, WorkspaceStatusProvider, WorkspaceSectionProps, WorkspaceSectionProvider, WorkspaceBadge, WorkspaceBadgeProvider, } from "./workspace-service.js";
+export type { EditorService, EditorSaveHandlers, OpenFileOptions, EditorViewInfo, OpenDiffSpec, DiffContent, DiffContentRequest, DiffContentProvider, ActiveEditorInfo, EditorsState, EditorSaveEvent, } from "./editor-service.js";
+export type { LayoutService, LayoutState, SidePanelColumnState, SideLocation, } from "./layout-service.js";
+export type { ProcessService, ProcessSession, ProcessSpawnOptions, ProcessExecOptions, ProcessExecResult, } from "./process-service.js";
+export type { ProcessesService, ProcessInfo, ProcessStats, } from "./processes-service.js";
+export type { TerminalService, CreateTerminalInput, TerminalKind, TerminalRecord, TerminalTabDecoration, TerminalTabDecorationProvider, OscEvent, } from "./terminal-service.js";
+export type { FileService, FileMeta, FileChangeKind, FileChangeEvent, } from "./file-service.js";
+export type { SearchService, SearchOptions, SearchMatch, SearchFileResult, SearchResponse, } from "./search-service.js";
+export type { Permission } from "./permissions.js";
+export { PathDeniedError } from "./permissions.js";
+export type { ThemeService, ThemeState, ThemePreset, ResolvedTheme, ThemeBase, ThemeVars, CustomTheme, ThemeExport, } from "./theme-service.js";
+export type { ExtensionStorage, ExtensionStorageScopes, } from "./extension-storage.js";
+export type { DndService, DndItem, DndMime, DragInit, DndMode, DropContext, DropTargetHandlers, } from "./dnd-service.js";
+export { DND_MIME } from "./dnd-service.js";
+export type { UiService, FileFilter, MenuItem, MenuItemTrailing, MenuSeparator, MenuHeader, MenuEntry, ShowMenuOptions, ConfirmOptions, PromptOptions, ModalOptions, NotifyAction, NotifyOptions, } from "./ui-service.js";
+export { NetworkError } from "./network-service.js";
+export type { NetworkService, NetworkRequestOptions, NetworkResponse, NetworkBytesResponse, } from "./network-service.js";
+export type { WebviewService, WebFrame, WebviewNavType, WebviewNavigateEvent, WebviewRect, PickedElement, } from "./webview-service.js";
+export type { SystemService, SystemInfo } from "./system-service.js";
+export type { LogService, LogLevel } from "./output-service.js";
+export type { ContextKeys } from "./context-keys.js";
+export type { Event } from "./event.js";
+export { path } from "./path.js";
+export { Tooltip } from "./Tooltip.js";
+export { useServiceState } from "./use-service-state.js";
+export type { ReactiveService } from "./use-service-state.js";
+export { useFocusGroup, focusGroupNextIndex } from "./use-focus-group.js";
+export type { FocusGroup, FocusGroupOptions, FocusGroupContainerProps, FocusGroupItemProps, FocusGroupOrientation, FocusGroupNavQuery, } from "./use-focus-group.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -15,23 +15,23 @@
  *
  * @packageDocumentation
  */
-export { PathDeniedError } from "./permissions";
-export { DND_MIME } from "./dnd-service";
+export { PathDeniedError } from "./permissions.js";
+export { DND_MIME } from "./dnd-service.js";
 // Server-side HTTP client — bypasses CORS, readable response headers.
-export { NetworkError } from "./network-service";
+export { NetworkError } from "./network-service.js";
 // Pure path utilities — cross-platform replacement for `node:path` (banned in
 // extensions). All outputs use forward-slash separators. Both "/" and "\" are
 // accepted as input. Exported as a namespaced `path` object.
-export { path } from "./path";
+export { path } from "./path.js";
 // Tooltip — the same styled hover popup the host uses in the status bar.
 // Extensions use this instead of native `title` attributes to match host chrome.
-export { Tooltip } from "./Tooltip";
+export { Tooltip } from "./Tooltip.js";
 // Runtime helpers. The one blessed way for an extension to read a `ctx`
 // service's reactive state in React — replaces hand-rolled useSyncExternalStore.
-export { useServiceState } from "./use-service-state";
+export { useServiceState } from "./use-service-state.js";
 // Headless keyboard navigation for a focus group (list / menu / toolbar / …):
 // one tab stop, arrow/Home/End movement, the WebKit-safe keyboard ring. The
 // `focusGroupNextIndex` helper is the pure roving-index core for widgets that
 // can't use the focus-driven hook (e.g. menus driven by a document listener).
-export { useFocusGroup, focusGroupNextIndex } from "./use-focus-group";
+export { useFocusGroup, focusGroupNextIndex } from "./use-focus-group.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AA2GH,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AA6BhD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAoBzC,sEAAsE;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAuBjD,8EAA8E;AAC9E,8EAA8E;AAC9E,6DAA6D;AAC7D,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAE9B,yEAAyE;AACzE,iFAAiF;AACjF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,wEAAwE;AACxE,iFAAiF;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,8EAA8E;AAC9E,4EAA4E;AAC5E,8EAA8E;AAC9E,8EAA8E;AAC9E,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AA2GH,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AA6BhD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAoBzC,sEAAsE;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAkCjD,8EAA8E;AAC9E,8EAA8E;AAC9E,6DAA6D;AAC7D,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAE9B,yEAAyE;AACzE,iFAAiF;AACjF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,wEAAwE;AACxE,iFAAiF;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,8EAA8E;AAC9E,4EAA4E;AAC5E,8EAA8E;AAC9E,8EAA8E;AAC9E,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/layout-service.d.ts

@@ -1,4 +1,4 @@
-import type { Disposable } from "./types";
+import type { Disposable } from "./types.js";
 /**
  * Which side column a layout operation targets.
  *

package/dist/permissions.d.ts

@@ -11,11 +11,16 @@
  * - `network` — make outbound network requests. Declarative consent only until
  *   sandboxed execution lands (in-process code can reach the network directly);
  *   declare it so the capability is reviewable and shown at install.
+ * - `webview` — use {@link ExtensionContext.webview} to get real DOM access,
+ *   script execution, and native pixel capture inside an iframe you own,
+ *   including cross-origin content. Declare it because this reaches into
+ *   arbitrary embedded pages, not because it touches the filesystem/network
+ *   directly.
  *
  * @category Extension Contract
  * @public
  */
-export type Permission = "fs:read" | "fs:write" | "process" | "network";
+export type Permission = "fs:read" | "fs:write" | "process" | "network" | "webview";
 /**
  * Thrown by {@link FileService} and {@link ProcessService} when an extension
  * touches a path — or runs a process with a working directory — outside the open

package/dist/permissions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../src/permissions.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,CAAC;AAExE;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IACxC,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAS3C"}
+{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../src/permissions.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,MAAM,UAAU,GAClB,SAAS,GACT,UAAU,GACV,SAAS,GACT,SAAS,GACT,SAAS,CAAC;AAEd;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IACxC,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAS3C"}

package/dist/permissions.js.map

@@ -1 +1 @@
-{"version":3,"file":"permissions.js","sourceRoot":"","sources":["../src/permissions.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,6EAA6E;AAC7E,8EAA8E;AAC9E,qEAAqE;AAqBrE;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAIxC,YAAY,IAAY,EAAE,OAAgB;QACxC,KAAK,CAAC,OAAO,IAAI,kCAAkC,IAAI,EAAE,CAAC,CAAC;QAJ7D,8DAA8D;QACrD;;;;;WAAa;QAIpB,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,4EAA4E;QAC5E,4EAA4E;QAC5E,yCAAyC;QACzC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,eAAe,CAAC,SAAS,CAAC,CAAC;IACzD,CAAC;CACF"}
+{"version":3,"file":"permissions.js","sourceRoot":"","sources":["../src/permissions.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,6EAA6E;AAC7E,8EAA8E;AAC9E,qEAAqE;AA+BrE;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAIxC,YAAY,IAAY,EAAE,OAAgB;QACxC,KAAK,CAAC,OAAO,IAAI,kCAAkC,IAAI,EAAE,CAAC,CAAC;QAJ7D,8DAA8D;QACrD;;;;;WAAa;QAIpB,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,4EAA4E;QAC5E,4EAA4E;QAC5E,yCAAyC;QACzC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,eAAe,CAAC,SAAS,CAAC,CAAC;IACzD,CAAC;CACF"}

package/dist/process-service.d.ts

@@ -1,4 +1,4 @@
-import type { Disposable } from "./types";
+import type { Disposable } from "./types.js";
 /**
  * Options for spawning a process session. Today sessions are shell PTYs, so
  * `cwd` is required (the webview has no ambient working directory).

package/dist/processes-service.d.ts

@@ -1,4 +1,4 @@
-import type { Disposable } from "./types";
+import type { Disposable } from "./types.js";
 /**
  * Resource snapshot for the foreground leader of a PTY session. Only present
  * on a {@link ProcessInfo} when an extension has called

package/dist/terminal-service.d.ts

@@ -1,6 +1,6 @@
 import type React from "react";
-import type { Disposable } from "./types";
-import type { TerminalKind, TerminalRecord } from "./domain-types";
+import type { Disposable } from "./types.js";
+import type { TerminalKind, TerminalRecord } from "./domain-types.js";
 /**
  * A parsed OSC (Operating System Command) escape sequence emitted by a
  * terminal program. Delivered by {@link TerminalService.subscribeOsc}.
@@ -20,7 +20,7 @@ export interface OscEvent {
     /** The raw payload string after the code and its separating semicolon. */
     payload: string;
 }
-export type { TerminalKind, TerminalRecord } from "./domain-types";
+export type { TerminalKind, TerminalRecord } from "./domain-types.js";
 /**
  * A decoration that an extension can attach to a terminal tab — a small icon
  * with an optional tooltip and semantic color. Registered via

package/dist/theme-service.d.ts

@@ -1,6 +1,6 @@
-import type { Disposable } from "./types";
-import type { ThemeBase, ThemeVars, CustomTheme, ThemeExport } from "./domain-types";
-export type { ThemeBase, ThemeVars, CustomTheme, ThemeExport, } from "./domain-types";
+import type { Disposable } from "./types.js";
+import type { ThemeBase, ThemeVars, CustomTheme, ThemeExport } from "./domain-types.js";
+export type { ThemeBase, ThemeVars, CustomTheme, ThemeExport, } from "./domain-types.js";
 /**
  * A selectable theme contributed via {@link ThemeService.registerPreset}.
  * Built-in presets (Tokyo Night, Solarized Light, Gruvbox Dark, …) are

package/dist/types.d.ts

@@ -25,22 +25,23 @@
  * @packageDocumentation
  */
 import type React from "react";
-import type { ContextKeys } from "./context-keys";
-import type { WorkspaceService } from "./workspace-service";
-import type { EditorService } from "./editor-service";
-import type { LayoutService } from "./layout-service";
-import type { ProcessService } from "./process-service";
-import type { ProcessesService } from "./processes-service";
-import type { TerminalService } from "./terminal-service";
-import type { FileService } from "./file-service";
-import type { SearchService } from "./search-service";
-import type { ThemeService, ThemePreset } from "./theme-service";
-import type { DndService } from "./dnd-service";
-import type { UiService } from "./ui-service";
-import type { NetworkService } from "./network-service";
-import type { SystemService } from "./system-service";
-import type { LogService } from "./output-service";
-import type { ExtensionStorage, ExtensionStorageScopes } from "./extension-storage";
+import type { ContextKeys } from "./context-keys.js";
+import type { WorkspaceService } from "./workspace-service.js";
+import type { EditorService } from "./editor-service.js";
+import type { LayoutService } from "./layout-service.js";
+import type { ProcessService } from "./process-service.js";
+import type { ProcessesService } from "./processes-service.js";
+import type { TerminalService } from "./terminal-service.js";
+import type { FileService } from "./file-service.js";
+import type { SearchService } from "./search-service.js";
+import type { ThemeService, ThemePreset } from "./theme-service.js";
+import type { DndService } from "./dnd-service.js";
+import type { UiService } from "./ui-service.js";
+import type { NetworkService } from "./network-service.js";
+import type { WebviewService } from "./webview-service.js";
+import type { SystemService } from "./system-service.js";
+import type { LogService } from "./output-service.js";
+import type { ExtensionStorage, ExtensionStorageScopes } from "./extension-storage.js";
 /**
  * The teardown handle returned by every `register*` call on
  * {@link ExtensionContext}. Calling {@link Disposable.dispose | dispose}
@@ -616,6 +617,13 @@ export interface ExtensionContext {
      * loading a URL. See {@link NetworkService} for the full API.
      */
     readonly net: NetworkService;
+    /**
+     * Real DOM access, navigation control, and native pixel capture inside an
+     * `<iframe>` you own — including cross-origin content the browser's
+     * same-origin policy would otherwise fully sandbox. Requires the
+     * `"webview"` {@link Permission}. See {@link WebviewService}.
+     */
+    readonly webview: WebviewService;
     /**
      * Static host-platform metadata — the OS, CPU architecture, and running Silo
      * version. Values are baked into the binary at build time and never change

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/use-service-state.d.ts

@@ -1,4 +1,4 @@
-import type { Disposable } from "./types";
+import type { Disposable } from "./types.js";
 /**
  * The minimal reactive contract every stateful `ctx` service satisfies: a
  * `getState` returning a stable, frozen value and a `subscribe` that fires

package/dist/webview-service.d.ts

@@ -0,0 +1,164 @@
+import type { Disposable } from "./types.js";
+import type { Event } from "./event.js";
+/**
+ * The kind of in-frame navigation reported by {@link WebFrame.onNavigate}.
+ *
+ * - `"load"` — a full document load (the initial navigation, or any
+ *   non-SPA link click / `location.href` assignment).
+ * - `"push"` / `"replace"` — `history.pushState` / `history.replaceState`,
+ *   the SPA route-change primitives (React Router, Vue Router, etc.).
+ * - `"pop"` — a `popstate` event (back/forward within the SPA).
+ * - `"hash"` — a `hashchange` event.
+ *
+ * @category Core Types
+ * @public
+ */
+export type WebviewNavType = "push" | "replace" | "pop" | "load" | "hash";
+/**
+ * One navigation event from {@link WebFrame.onNavigate}.
+ *
+ * @category Core Types
+ * @public
+ */
+export interface WebviewNavigateEvent {
+    /** The kind of navigation — see {@link WebviewNavType}. */
+    type: WebviewNavType;
+    /** The frame's URL after the navigation. */
+    url: string;
+    /**
+     * `true` on the first event reported by a freshly created document — i.e.
+     * this event is the result of a full document load, whoever initiated it.
+     * `false` for every subsequent event from the same document (SPA route
+     * changes, the page's own `replaceState` calls, hash changes).
+     *
+     * This matters because frameworks commonly call `history.replaceState`
+     * while booting, so a single full-page navigation can report a `"replace"`
+     * event *before* its `"load"`. Without this flag a consumer tracking its
+     * own history stack can't tell that boot-time `"replace"` (a brand-new
+     * page — usually a new history entry) apart from a genuine in-page
+     * `replaceState` (rewrite the current entry).
+     */
+    newDocument: boolean;
+}
+/**
+ * A rectangle in frame-relative CSS pixels — the coordinate space
+ * `getBoundingClientRect()` returns inside the frame's own document. Used by
+ * {@link WebFrame.captureRect} (e.g. for a picked element or a marquee
+ * selection) and returned as part of {@link PickedElement}.
+ *
+ * @category Core Types
+ * @public
+ */
+export interface WebviewRect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/**
+ * The result of {@link WebFrame.pickElement} — what the user clicked while
+ * picking.
+ *
+ * @category Core Types
+ * @public
+ */
+export interface PickedElement {
+    /** A CSS selector breadcrumb from `<html>` down to the clicked element (tag + up to 2 classes per level). */
+    selector: string;
+    /** The element's trimmed text content, truncated to 200 characters. */
+    text: string;
+    /** The element's frame-relative bounding rect — pass to {@link WebFrame.captureRect} to screenshot just this element. */
+    rect: WebviewRect;
+}
+/**
+ * A live connection to an embedded frame's content, returned by
+ * {@link WebviewService.attach}. Dispose it (or let `ctx.subscriptions`
+ * dispose it) when your panel unmounts.
+ *
+ * @category Consumer Services
+ * @public
+ */
+export interface WebFrame extends Disposable {
+    /** The frame's current URL, updated on every {@link onNavigate} event. `null` before the first load. */
+    readonly url: string | null;
+    /** Subscribe to in-frame navigation — the only way to track SPA route changes and full loads alike. See {@link WebviewNavType}. */
+    onNavigate: Event<WebviewNavigateEvent>;
+    /**
+     * Fires when a navigation lands on what looks like a frame-blocked page —
+     * sites sending `X-Frame-Options` / `frame-ancestors` don't error, WebKit
+     * (and other engines) just commit an empty document at the target URL, so
+     * this is a heuristic (empty title + no body content after load), not a
+     * definitive diagnosis. Treat it as "this page probably won't work
+     * embedded — offer to open it in a browser instead."
+     */
+    onBlocked: Event<void>;
+    /** Navigate the frame back in its history, if possible. */
+    back(): void;
+    /** Navigate the frame forward in its history, if possible. */
+    forward(): void;
+    /** Reload the frame's current page. */
+    reload(): void;
+    /**
+     * Run JavaScript inside the frame and resolve with its result. A single
+     * expression's value is returned (e.g. `"document.title"`,
+     * `"location.href"`, `"document.querySelectorAll('a').length"`) — matching
+     * how a devtools console evaluates. Multi-statement code runs but only
+     * returns a value if it ends in an explicit `return`-compatible form.
+     * The result must be structured-clone-safe (no DOM nodes, functions, etc.).
+     */
+    exec<T = unknown>(code: string): Promise<T>;
+    /**
+     * Enter interactive element-pick mode: the user hovers to highlight and
+     * clicks to select, or presses Escape to cancel. Resolves with the picked
+     * element, or `null` if cancelled. No timeout — this is inherently
+     * user-paced.
+     */
+    pickElement(): Promise<PickedElement | null>;
+    /**
+     * Cancel an in-flight {@link pickElement} call — exits pick mode in the
+     * frame and resolves the pending `pickElement()` promise with `null`. A
+     * no-op if no pick is active (including if it already ended, e.g. via
+     * Escape or a click).
+     */
+    cancelPick(): void;
+    /** A native PNG snapshot of the frame's current visible viewport. */
+    capture(): Promise<Blob>;
+    /** A native PNG snapshot of a frame-relative sub-rect — e.g. a {@link PickedElement.rect} or a marquee selection. */
+    captureRect(rect: WebviewRect): Promise<Blob>;
+    /** A native PNG snapshot of the frame's entire scrollable document, stitched from scrolled captures. Scroll position is restored afterward. */
+    captureFullPage(): Promise<Blob>;
+}
+/**
+ * The webview-bridge domain, exposed as {@link ExtensionContext.webview}.
+ * Requires the `"webview"` {@link Permission}.
+ *
+ * @example
+ * ```tsx
+ * function MyPanel({ ctx }: { ctx: ExtensionContext }) {
+ *   const iframeRef = useRef<HTMLIFrameElement>(null);
+ *   const frameRef = useRef<WebFrame | null>(null);
+ *
+ *   useEffect(() => {
+ *     if (!iframeRef.current) return;
+ *     const frame = ctx.webview.attach(iframeRef.current);
+ *     frameRef.current = frame;
+ *     const sub = frame.onNavigate((e) => console.log(e.type, e.url));
+ *     return () => { sub.dispose(); frame.dispose(); };
+ *   }, []);
+ *
+ *   return <iframe ref={iframeRef} src="https://example.com" />;
+ * }
+ * ```
+ *
+ * @category Consumer Services
+ * @public
+ */
+export interface WebviewService {
+    /**
+     * Attach the bridge to an iframe your panel owns. The iframe can be
+     * cross-origin — that's the point. Returns a {@link WebFrame}; call
+     * `.dispose()` (or push it onto `ctx.subscriptions`) when done with it.
+     */
+    attach(frame: HTMLIFrameElement): WebFrame;
+}
+//# sourceMappingURL=webview-service.d.ts.map

package/dist/webview-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webview-service.d.ts","sourceRoot":"","sources":["../src/webview-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAWrC;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,SAAS,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AAE1E;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,2DAA2D;IAC3D,IAAI,EAAE,cAAc,CAAC;IACrB,4CAA4C;IAC5C,GAAG,EAAE,MAAM,CAAC;IACZ;;;;;;;;;;;;OAYG;IACH,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,WAAW;IAC1B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,6GAA6G;IAC7G,QAAQ,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC;IACb,yHAAyH;IACzH,IAAI,EAAE,WAAW,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,QAAS,SAAQ,UAAU;IAC1C,wGAAwG;IACxG,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,mIAAmI;IACnI,UAAU,EAAE,KAAK,CAAC,oBAAoB,CAAC,CAAC;IACxC;;;;;;;OAOG;IACH,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IACvB,2DAA2D;IAC3D,IAAI,IAAI,IAAI,CAAC;IACb,8DAA8D;IAC9D,OAAO,IAAI,IAAI,CAAC;IAChB,uCAAuC;IACvC,MAAM,IAAI,IAAI,CAAC;IACf;;;;;;;OAOG;IACH,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC5C;;;;;OAKG;IACH,WAAW,IAAI,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IAC7C;;;;;OAKG;IACH,UAAU,IAAI,IAAI,CAAC;IACnB,qEAAqE;IACrE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,qHAAqH;IACrH,WAAW,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,+IAA+I;IAC/I,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAClC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,MAAM,CAAC,KAAK,EAAE,iBAAiB,GAAG,QAAQ,CAAC;CAC5C"}

package/dist/webview-service.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=webview-service.js.map

package/dist/webview-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webview-service.js","sourceRoot":"","sources":["../src/webview-service.ts"],"names":[],"mappings":""}

package/dist/workspace-service.d.ts

@@ -1,6 +1,6 @@
-import type { Disposable } from "./types";
-import type { Workspace } from "./domain-types";
-export type { Workspace, TerminalRecord } from "./domain-types";
+import type { Disposable } from "./types.js";
+import type { Workspace } from "./domain-types.js";
+export type { Workspace, TerminalRecord } from "./domain-types.js";
 /**
  * A single status row contributed by a {@link WorkspaceStatusProvider}.
  * Rows appear below the path line in the Workspaces side panel.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@silo-code/sdk",
-  "version": "0.23.0",
+  "version": "0.24.0",
   "description": "The public, types-first SDK for building Silo extensions — the only surface third-party extensions import.",
   "license": "MIT",
   "author": "Dave Weaver",
@@ -44,7 +44,7 @@
     "vitest": "^4.1.7"
   },
   "scripts": {
-    "build": "tsc -p tsconfig.build.json",
+    "build": "tsc -p tsconfig.build.json && node scripts/fix-esm-extensions.mjs",
     "test": "vitest run",
     "test:watch": "vitest"
   },

package/src/index.ts

@@ -179,6 +179,17 @@ export type {
   NetworkBytesResponse,
 } from "./network-service";
 
+// The webview-bridge domain: real DOM access, navigation control, and native
+// pixel capture inside an iframe you own, including cross-origin content.
+export type {
+  WebviewService,
+  WebFrame,
+  WebviewNavType,
+  WebviewNavigateEvent,
+  WebviewRect,
+  PickedElement,
+} from "./webview-service";
+
 // Static host-platform metadata: OS, CPU arch, and Silo version.
 export type { SystemService, SystemInfo } from "./system-service";
 

package/src/permissions.ts

@@ -16,11 +16,21 @@
  * - `network` — make outbound network requests. Declarative consent only until
  *   sandboxed execution lands (in-process code can reach the network directly);
  *   declare it so the capability is reviewable and shown at install.
+ * - `webview` — use {@link ExtensionContext.webview} to get real DOM access,
+ *   script execution, and native pixel capture inside an iframe you own,
+ *   including cross-origin content. Declare it because this reaches into
+ *   arbitrary embedded pages, not because it touches the filesystem/network
+ *   directly.
  *
  * @category Extension Contract
  * @public
  */
-export type Permission = "fs:read" | "fs:write" | "process" | "network";
+export type Permission =
+  | "fs:read"
+  | "fs:write"
+  | "process"
+  | "network"
+  | "webview";
 
 /**
  * Thrown by {@link FileService} and {@link ProcessService} when an extension

package/src/types.ts

@@ -38,6 +38,7 @@ import type { ThemeService, ThemePreset } from "./theme-service";
 import type { DndService } from "./dnd-service";
 import type { UiService } from "./ui-service";
 import type { NetworkService } from "./network-service";
+import type { WebviewService } from "./webview-service";
 import type { SystemService } from "./system-service";
 import type { LogService } from "./output-service";
 import type {
@@ -639,6 +640,13 @@ export interface ExtensionContext {
    * loading a URL. See {@link NetworkService} for the full API.
    */
   readonly net: NetworkService;
+  /**
+   * Real DOM access, navigation control, and native pixel capture inside an
+   * `<iframe>` you own — including cross-origin content the browser's
+   * same-origin policy would otherwise fully sandbox. Requires the
+   * `"webview"` {@link Permission}. See {@link WebviewService}.
+   */
+  readonly webview: WebviewService;
   /**
    * Static host-platform metadata — the OS, CPU architecture, and running Silo
    * version. Values are baked into the binary at build time and never change

package/src/webview-service.ts

@@ -0,0 +1,178 @@
+import type { Disposable } from "./types";
+import type { Event } from "./event";
+
+// `ctx.webview` — real DOM access, navigation control, and native pixel
+// capture inside an `<iframe>` your panel owns, including cross-origin
+// content that the browser's same-origin policy would otherwise fully
+// sandbox. The host achieves this by injecting a handshake-gated script into
+// every frame (a Tauri all-frames init script reaches subframes the browser
+// itself can't be reached from) and talking to it over `postMessage`; none of
+// that machinery is visible here — `attach` just gives you a working
+// `WebFrame`. Requires the `"webview"` {@link Permission}.
+
+/**
+ * The kind of in-frame navigation reported by {@link WebFrame.onNavigate}.
+ *
+ * - `"load"` — a full document load (the initial navigation, or any
+ *   non-SPA link click / `location.href` assignment).
+ * - `"push"` / `"replace"` — `history.pushState` / `history.replaceState`,
+ *   the SPA route-change primitives (React Router, Vue Router, etc.).
+ * - `"pop"` — a `popstate` event (back/forward within the SPA).
+ * - `"hash"` — a `hashchange` event.
+ *
+ * @category Core Types
+ * @public
+ */
+export type WebviewNavType = "push" | "replace" | "pop" | "load" | "hash";
+
+/**
+ * One navigation event from {@link WebFrame.onNavigate}.
+ *
+ * @category Core Types
+ * @public
+ */
+export interface WebviewNavigateEvent {
+  /** The kind of navigation — see {@link WebviewNavType}. */
+  type: WebviewNavType;
+  /** The frame's URL after the navigation. */
+  url: string;
+  /**
+   * `true` on the first event reported by a freshly created document — i.e.
+   * this event is the result of a full document load, whoever initiated it.
+   * `false` for every subsequent event from the same document (SPA route
+   * changes, the page's own `replaceState` calls, hash changes).
+   *
+   * This matters because frameworks commonly call `history.replaceState`
+   * while booting, so a single full-page navigation can report a `"replace"`
+   * event *before* its `"load"`. Without this flag a consumer tracking its
+   * own history stack can't tell that boot-time `"replace"` (a brand-new
+   * page — usually a new history entry) apart from a genuine in-page
+   * `replaceState` (rewrite the current entry).
+   */
+  newDocument: boolean;
+}
+
+/**
+ * A rectangle in frame-relative CSS pixels — the coordinate space
+ * `getBoundingClientRect()` returns inside the frame's own document. Used by
+ * {@link WebFrame.captureRect} (e.g. for a picked element or a marquee
+ * selection) and returned as part of {@link PickedElement}.
+ *
+ * @category Core Types
+ * @public
+ */
+export interface WebviewRect {
+  x: number;
+  y: number;
+  width: number;
+  height: number;
+}
+
+/**
+ * The result of {@link WebFrame.pickElement} — what the user clicked while
+ * picking.
+ *
+ * @category Core Types
+ * @public
+ */
+export interface PickedElement {
+  /** A CSS selector breadcrumb from `<html>` down to the clicked element (tag + up to 2 classes per level). */
+  selector: string;
+  /** The element's trimmed text content, truncated to 200 characters. */
+  text: string;
+  /** The element's frame-relative bounding rect — pass to {@link WebFrame.captureRect} to screenshot just this element. */
+  rect: WebviewRect;
+}
+
+/**
+ * A live connection to an embedded frame's content, returned by
+ * {@link WebviewService.attach}. Dispose it (or let `ctx.subscriptions`
+ * dispose it) when your panel unmounts.
+ *
+ * @category Consumer Services
+ * @public
+ */
+export interface WebFrame extends Disposable {
+  /** The frame's current URL, updated on every {@link onNavigate} event. `null` before the first load. */
+  readonly url: string | null;
+  /** Subscribe to in-frame navigation — the only way to track SPA route changes and full loads alike. See {@link WebviewNavType}. */
+  onNavigate: Event<WebviewNavigateEvent>;
+  /**
+   * Fires when a navigation lands on what looks like a frame-blocked page —
+   * sites sending `X-Frame-Options` / `frame-ancestors` don't error, WebKit
+   * (and other engines) just commit an empty document at the target URL, so
+   * this is a heuristic (empty title + no body content after load), not a
+   * definitive diagnosis. Treat it as "this page probably won't work
+   * embedded — offer to open it in a browser instead."
+   */
+  onBlocked: Event<void>;
+  /** Navigate the frame back in its history, if possible. */
+  back(): void;
+  /** Navigate the frame forward in its history, if possible. */
+  forward(): void;
+  /** Reload the frame's current page. */
+  reload(): void;
+  /**
+   * Run JavaScript inside the frame and resolve with its result. A single
+   * expression's value is returned (e.g. `"document.title"`,
+   * `"location.href"`, `"document.querySelectorAll('a').length"`) — matching
+   * how a devtools console evaluates. Multi-statement code runs but only
+   * returns a value if it ends in an explicit `return`-compatible form.
+   * The result must be structured-clone-safe (no DOM nodes, functions, etc.).
+   */
+  exec<T = unknown>(code: string): Promise<T>;
+  /**
+   * Enter interactive element-pick mode: the user hovers to highlight and
+   * clicks to select, or presses Escape to cancel. Resolves with the picked
+   * element, or `null` if cancelled. No timeout — this is inherently
+   * user-paced.
+   */
+  pickElement(): Promise<PickedElement | null>;
+  /**
+   * Cancel an in-flight {@link pickElement} call — exits pick mode in the
+   * frame and resolves the pending `pickElement()` promise with `null`. A
+   * no-op if no pick is active (including if it already ended, e.g. via
+   * Escape or a click).
+   */
+  cancelPick(): void;
+  /** A native PNG snapshot of the frame's current visible viewport. */
+  capture(): Promise<Blob>;
+  /** A native PNG snapshot of a frame-relative sub-rect — e.g. a {@link PickedElement.rect} or a marquee selection. */
+  captureRect(rect: WebviewRect): Promise<Blob>;
+  /** A native PNG snapshot of the frame's entire scrollable document, stitched from scrolled captures. Scroll position is restored afterward. */
+  captureFullPage(): Promise<Blob>;
+}
+
+/**
+ * The webview-bridge domain, exposed as {@link ExtensionContext.webview}.
+ * Requires the `"webview"` {@link Permission}.
+ *
+ * @example
+ * ```tsx
+ * function MyPanel({ ctx }: { ctx: ExtensionContext }) {
+ *   const iframeRef = useRef<HTMLIFrameElement>(null);
+ *   const frameRef = useRef<WebFrame | null>(null);
+ *
+ *   useEffect(() => {
+ *     if (!iframeRef.current) return;
+ *     const frame = ctx.webview.attach(iframeRef.current);
+ *     frameRef.current = frame;
+ *     const sub = frame.onNavigate((e) => console.log(e.type, e.url));
+ *     return () => { sub.dispose(); frame.dispose(); };
+ *   }, []);
+ *
+ *   return <iframe ref={iframeRef} src="https://example.com" />;
+ * }
+ * ```
+ *
+ * @category Consumer Services
+ * @public
+ */
+export interface WebviewService {
+  /**
+   * Attach the bridge to an iframe your panel owns. The iframe can be
+   * cross-origin — that's the point. Returns a {@link WebFrame}; call
+   * `.dispose()` (or push it onto `ctx.subscriptions`) when done with it.
+   */
+  attach(frame: HTMLIFrameElement): WebFrame;
+}