@ai-matrx/desktop-protocol 0.21.30 → 0.21.32

package/dist/index.cjs

@@ -546,7 +546,10 @@ __export(src_exports, {
   NotesWriteResult: () => NotesWriteResult,
   OPS: () => OPS,
   OpDescriptor: () => OpDescriptor,
+  OsGrantState: () => OsGrantState,
   OsPermissionName: () => OsPermissionName,
+  OsRequirementName: () => OsRequirementName,
+  PERMISSIONS_SINCE: () => PERMISSIONS_SINCE,
   PING_TEXT: () => PING_TEXT,
   PONG_TEXT: () => PONG_TEXT,
   PROTOCOL_MAJOR: () => PROTOCOL_MAJOR,
@@ -724,7 +727,13 @@ __export(src_exports, {
   ToolPlatform: () => ToolPlatform,
   ToolResultsFile: () => ToolResultsFile,
   ToolTransport: () => ToolTransport,
+  ToolsParseFile: () => ToolsParseFile,
   ToolsServiceProgress: () => ToolsServiceProgress,
+  ToolsWebBrowserFetchParams: () => ToolsWebBrowserFetchParams,
+  ToolsWebBrowserFetchResult: () => ToolsWebBrowserFetchResult,
+  ToolsWebScrapePage: () => ToolsWebScrapePage,
+  ToolsWebScrapeParams: () => ToolsWebScrapeParams,
+  ToolsWebScrapeResult: () => ToolsWebScrapeResult,
   ToolsWebSearchParams: () => ToolsWebSearchParams,
   TranscriptSegment: () => TranscriptSegment,
   TranscriptionModelId: () => TranscriptionModelId,
@@ -734,11 +743,39 @@ __export(src_exports, {
   VaultItemKind: () => VaultItemKind,
   VaultItemSummary: () => VaultItemSummary,
   WEB_MAX_TEXT_CHARS: () => WEB_MAX_TEXT_CHARS,
+  WebAttachTarget: () => WebAttachTarget,
   WebBrowserFetchParams: () => WebBrowserFetchParams,
   WebBrowserFetchResult: () => WebBrowserFetchResult,
   WebFetchParams: () => WebFetchParams,
   WebFetchResult: () => WebFetchResult,
   WebHeader: () => WebHeader,
+  WebLand: () => WebLand,
+  WebLogCaller: () => WebLogCaller,
+  WebLogClearParams: () => WebLogClearParams,
+  WebLogClearResult: () => WebLogClearResult,
+  WebLogEntry: () => WebLogEntry,
+  WebLogListParams: () => WebLogListParams,
+  WebLogListResult: () => WebLogListResult,
+  WebLogResult: () => WebLogResult,
+  WebLogVia: () => WebLogVia,
+  WebNotSavedReason: () => WebNotSavedReason,
+  WebOutboxDiscardParams: () => WebOutboxDiscardParams,
+  WebOutboxDiscardResult: () => WebOutboxDiscardResult,
+  WebOutboxItem: () => WebOutboxItem,
+  WebOutboxListParams: () => WebOutboxListParams,
+  WebOutboxListResult: () => WebOutboxListResult,
+  WebOutboxRetryParams: () => WebOutboxRetryParams,
+  WebOutboxRetryResult: () => WebOutboxRetryResult,
+  WebProgressEvent: () => WebProgressEvent,
+  WebResearchFetchParams: () => WebResearchFetchParams,
+  WebResearchFetchResult: () => WebResearchFetchResult,
+  WebResearchItem: () => WebResearchItem,
+  WebResearchItemState: () => WebResearchItemState,
+  WebResearchQueueParams: () => WebResearchQueueParams,
+  WebResearchQueueResult: () => WebResearchQueueResult,
+  WebRuntimeParams: () => WebRuntimeParams,
+  WebRuntimeState: () => WebRuntimeState,
+  WebRuntimeStateName: () => WebRuntimeStateName,
   WebScrapePage: () => WebScrapePage,
   WebScrapeParams: () => WebScrapeParams,
   WebScrapeResult: () => WebScrapeResult,
@@ -746,6 +783,8 @@ __export(src_exports, {
   WebSearchParams: () => WebSearchParams,
   WebSearchQueryResult: () => WebSearchQueryResult,
   WebSearchResult: () => WebSearchResult,
+  WebSourceNotice: () => WebSourceNotice,
+  WebSourceState: () => WebSourceState,
   Welcome: () => Welcome,
   WindowFocusParams: () => WindowFocusParams,
   WindowFocusResult: () => WindowFocusResult,
@@ -805,7 +844,7 @@ module.exports = __toCommonJS(src_exports);
 var import_zod = require("zod");
 var import_uuid = require("@ai-matrx/kit/uuid");
 var PROTOCOL_MAJOR = 1;
-var PROTOCOL_MINOR = 39;
+var PROTOCOL_MINOR = 42;
 var PROTOCOL_VERSION = `${PROTOCOL_MAJOR}.${PROTOCOL_MINOR}`;
 var ProtocolVersion = import_zod.z.string().regex(/^[1-9][0-9]{0,2}\.[0-9]{1,3}$/);
 var RequestId = import_zod.z.string().min(1).max(64).regex(/^[A-Za-z0-9_-]+$/);
@@ -1197,8 +1236,17 @@ var OsPermissionName = import_zod5.z.enum([
   "location",
   "local_network",
   "bluetooth",
-  "notifications"
+  "notifications",
+  // (1.41) Matrx Local's remaining kinds, checked on every OS (its permissions checker): a peer
+  // older than 1.41 is never sent these rows (versioning.ts PERMISSIONS_SINCE).
+  "reminders",
+  "speech_recognition",
+  "messages",
+  "mail",
+  "wifi"
 ]);
+var OsGrantState = import_zod5.z.enum(["granted", "denied", "not_determined", "not_applicable"]);
+var OsRequirementName = import_zod5.z.enum(["secret_storage", "tray", "display_server", "helper_programs", "smart_app_control", "path_length"]);
 var SysinfoGetParams = import_zod5.z.strictObject({});
 var SysinfoGetResult = import_zod5.z.strictObject({
   device_id: DeviceId,
@@ -1228,9 +1276,20 @@ var SysinfoGetResult = import_zod5.z.strictObject({
     import_zod5.z.strictObject({
       name: OsPermissionName,
       state: import_zod5.z.enum(["granted", "denied", "not_determined", "not_applicable"]),
-      settings_url: import_zod5.z.string().max(512).nullable()
+      settings_url: import_zod5.z.string().max(512).nullable(),
+      /** (1.41) One short fact when the state alone does not say it ("No camera", "Bluetooth is off"); absent when there is none. */
+      detail: import_zod5.z.string().max(256).optional()
     })
-  )
+  ),
+  /** (1.41) The requirements beyond the grants (OsRequirementName), each read when asked. */
+  requirements: import_zod5.z.array(
+    import_zod5.z.strictObject({
+      name: OsRequirementName,
+      state: OsGrantState,
+      settings_url: import_zod5.z.string().max(512).nullable(),
+      detail: import_zod5.z.string().max(256).nullable()
+    })
+  ).optional()
 });
 var SysinfoHardwareParams = import_zod5.z.strictObject({});
 var SysinfoHardwareResult = import_zod5.z.strictObject({
@@ -2669,10 +2728,12 @@ var GitCloneParams = import_zod19.z.strictObject({
 });
 
 // src/schema/web.ts
+var import_uuid4 = require("@ai-matrx/kit/uuid");
 var import_zod20 = require("zod");
 var WEB_MAX_TEXT_CHARS = 524288;
 var WebUrl = import_zod20.z.string().min(1).max(8192).regex(/^https?:\/\//);
 var WebText = import_zod20.z.string().max(WEB_MAX_TEXT_CHARS);
+var OrgId = import_zod20.z.string().regex(import_uuid4.UUID_SHAPE_PATTERN);
 var WebHeader = import_zod20.z.strictObject({ name: import_zod20.z.string().min(1).max(256), value: import_zod20.z.string().max(8192) });
 var WebFetchParams = import_zod20.z.strictObject({
   url: WebUrl,
@@ -2694,10 +2755,65 @@ var WebFetchResult = import_zod20.z.strictObject({
   bytes: nonNegInt,
   elapsed_ms: nonNegInt
 });
+var WebAttachTarget = import_zod20.z.strictObject({
+  entity_type: import_zod20.z.string().min(1).max(64),
+  entity_id: import_zod20.z.string().min(1).max(128),
+  label: import_zod20.z.string().max(200).optional()
+});
+var WebLand = import_zod20.z.strictObject({
+  /** The organization the page is saved in; absent: this computer's active organization. */
+  organization_id: OrgId.optional(),
+  /** Keep it: AI processing starts (chunks, search). Unkept pages are saved and wait. */
+  keep: import_zod20.z.boolean().default(false),
+  attach_to: import_zod20.z.array(WebAttachTarget).max(8).default([])
+});
+var WebNotSavedReason = import_zod20.z.enum([
+  /** Nobody is signed in on this computer. Saved on sign-in. */
+  "signed_out",
+  /** AI Matrx could not be reached. Retried on its own. */
+  "offline",
+  /** AI Matrx refused it (the message says why). Kept until the person retries or discards it. */
+  "rejected",
+  /** Waiting its turn behind other pages (retried on its own). */
+  "queued"
+]);
+var WebSourceNotice = import_zod20.z.strictObject({ code: import_zod20.z.string().max(120), message: import_zod20.z.string().max(2e3), remedy: import_zod20.z.string().max(120) });
+var WebSourceState = import_zod20.z.discriminatedUnion("state", [
+  import_zod20.z.strictObject({
+    state: import_zod20.z.literal("saved"),
+    processed_document_id: import_zod20.z.string().min(1).max(64),
+    source_id: import_zod20.z.string().min(1).max(128),
+    /** The page was already saved and nothing changed ("Already saved, no change"). */
+    reused_existing: import_zod20.z.boolean(),
+    /** The page changed: this is a new version of that Source. */
+    new_version_of: import_zod20.z.string().max(64).nullable(),
+    kept: import_zod20.z.boolean(),
+    intelligence: import_zod20.z.enum(["queued", "deferred", "never"]),
+    /** The original page as captured, kept by AI Matrx (null: the organization keeps none). */
+    original_file_id: import_zod20.z.string().max(128).nullable(),
+    /** The organization it was saved in. */
+    organization_id: OrgId,
+    notices: import_zod20.z.array(WebSourceNotice).max(20)
+  }),
+  import_zod20.z.strictObject({
+    state: import_zod20.z.literal("not_saved"),
+    outbox_id: import_zod20.z.string().min(1).max(64),
+    reason: WebNotSavedReason,
+    message: import_zod20.z.string().max(2e3)
+  })
+]);
 var WebScrapeParams = import_zod20.z.strictObject({
   urls: import_zod20.z.array(WebUrl).min(1).max(20),
   use_cache: import_zod20.z.boolean().default(true),
-  get_links: import_zod20.z.boolean().default(false)
+  get_links: import_zod20.z.boolean().default(false),
+  /**
+   * Since 1.38. `auto` (absent): this computer's scraper (HTTP, its browser only when a page needs
+   * it). `browser`: this computer's own browser renders every page. `server`: AI Matrx's servers
+   * read it (their connection, not this computer's; saved there as a web capture).
+   */
+  engine: import_zod20.z.enum(["auto", "browser", "server"]).optional(),
+  /** Since 1.38: where the pages are saved (see WebLand). */
+  land: WebLand.optional()
 });
 var WebScrapePage = import_zod20.z.strictObject({
   url: import_zod20.z.string(),
@@ -2712,7 +2828,9 @@ var WebScrapePage = import_zod20.z.strictObject({
   /** Why the page failed (blocked, timeout, not found…), in the scraper's words; null when ok. */
   error: import_zod20.z.string().nullable(),
   /** How the page was fetched (http, browser, cache). */
-  via: import_zod20.z.string().nullable()
+  via: import_zod20.z.string().nullable(),
+  /** Since 1.38: the page's Source (absent from a 1.37 core, and for a page that failed). */
+  source: WebSourceState.optional()
 });
 var WebScrapeResult = import_zod20.z.strictObject({ pages: import_zod20.z.array(WebScrapePage), elapsed_ms: nonNegInt });
 var WebSearchParams = import_zod20.z.strictObject({
@@ -2736,7 +2854,9 @@ var WebBrowserFetchParams = import_zod20.z.strictObject({
   wait_for: import_zod20.z.string().max(1024).optional(),
   wait_timeout_ms: import_zod20.z.int().min(100).max(12e4).default(3e4),
   /** true: readable text; false: the rendered HTML. */
-  extract_text: import_zod20.z.boolean().default(true)
+  extract_text: import_zod20.z.boolean().default(true),
+  /** Since 1.38: where the rendered page is saved (see WebLand). */
+  land: WebLand.optional()
 });
 var WebBrowserFetchResult = import_zod20.z.strictObject({
   url: import_zod20.z.string(),
@@ -2744,7 +2864,137 @@ var WebBrowserFetchResult = import_zod20.z.strictObject({
   title: import_zod20.z.string().nullable(),
   content: WebText,
   truncated: import_zod20.z.boolean(),
-  elapsed_ms: nonNegInt
+  elapsed_ms: nonNegInt,
+  /** Since 1.38: the rendered page's Source (absent from a 1.37 core). */
+  source: WebSourceState.optional()
+});
+var ToolsParseFile = import_zod20.z.strictObject({
+  /** Absolute path of the gzipped JSON the core reads, saves and then removes. */
+  path: import_zod20.z.string().min(1).max(4096),
+  bytes: nonNegInt
+});
+var ToolsWebScrapeParams = import_zod20.z.strictObject({
+  urls: import_zod20.z.array(WebUrl).min(1).max(20),
+  use_cache: import_zod20.z.boolean().default(true),
+  get_links: import_zod20.z.boolean().default(false),
+  /** `browser`: render every page in this computer's browser, then parse it. */
+  engine: import_zod20.z.enum(["auto", "browser"]).default("auto"),
+  /** Pages read at once (desktop.web/scrape_concurrency). */
+  concurrency: import_zod20.z.int().min(1).max(20).default(5),
+  /** The wait between pages from the same site (desktop.web/request_delay_ms). */
+  delay_ms: import_zod20.z.int().min(0).max(3e4).default(0),
+  /** Where the parse files go (the core's spool folder). */
+  spool_dir: import_zod20.z.string().min(1).max(4096)
+});
+var ToolsWebScrapePage = import_zod20.z.strictObject({
+  page: WebScrapePage,
+  /** The page's whole parse, for the door; null when the page failed or had no words. */
+  parse: ToolsParseFile.nullable(),
+  /** The page as fetched, for research (rendered HTML or the HTTP body); null when not kept. */
+  html: ToolsParseFile.nullable()
+});
+var ToolsWebScrapeResult = import_zod20.z.strictObject({ pages: import_zod20.z.array(ToolsWebScrapePage), elapsed_ms: nonNegInt });
+var ToolsWebBrowserFetchParams = import_zod20.z.strictObject({
+  url: WebUrl,
+  wait_for: import_zod20.z.string().max(1024).optional(),
+  wait_timeout_ms: import_zod20.z.int().min(100).max(12e4).default(3e4),
+  extract_text: import_zod20.z.boolean().default(true),
+  spool_dir: import_zod20.z.string().min(1).max(4096)
+});
+var ToolsWebBrowserFetchResult = import_zod20.z.strictObject({ result: WebBrowserFetchResult, parse: ToolsParseFile.nullable() });
+var WebRuntimeStateName = import_zod20.z.enum(["not_installed", "installing", "installed", "failed"]);
+var WebRuntimeParams = import_zod20.z.strictObject({});
+var WebRuntimeState = import_zod20.z.strictObject({
+  state: WebRuntimeStateName,
+  /** Why it failed, in the installer's words; null otherwise. */
+  error: import_zod20.z.string().max(2e3).nullable(),
+  /** Bytes the browser takes on this computer (its packages and Chromium); null when unknown. */
+  size_bytes: nonNegInt.nullable(),
+  /** Whether it can show a window while it works (false: only the headless shell is installed). */
+  can_show_window: import_zod20.z.boolean()
+});
+var WebOutboxItem = import_zod20.z.strictObject({
+  outbox_id: import_zod20.z.string().min(1).max(64),
+  url: import_zod20.z.string().max(8192),
+  title: import_zod20.z.string().max(500).nullable(),
+  organization_id: OrgId.nullable(),
+  reason: WebNotSavedReason,
+  message: import_zod20.z.string().max(2e3),
+  attempts: nonNegInt,
+  created_at_ms: nonNegInt,
+  last_attempt_at_ms: nonNegInt.nullable(),
+  bytes: nonNegInt
+});
+var WebOutboxListParams = import_zod20.z.strictObject({});
+var WebOutboxListResult = import_zod20.z.strictObject({
+  items: import_zod20.z.array(WebOutboxItem),
+  bytes: nonNegInt,
+  /** The most the outbox holds; past it the oldest pages are dropped (and the log says so). */
+  cap_bytes: nonNegInt
+});
+var WebOutboxRetryParams = import_zod20.z.strictObject({ outbox_id: import_zod20.z.string().min(1).max(64).optional() });
+var WebOutboxRetryResult = import_zod20.z.strictObject({ saved: nonNegInt, waiting: nonNegInt });
+var WebOutboxDiscardParams = import_zod20.z.strictObject({ outbox_id: import_zod20.z.string().min(1).max(64) });
+var WebOutboxDiscardResult = import_zod20.z.strictObject({ discarded: import_zod20.z.boolean() });
+var WebLogVia = import_zod20.z.enum(["this_computer", "browser", "server"]);
+var WebLogCaller = import_zod20.z.enum(["person", "agent", "research", "phone", "other"]);
+var WebLogResult = import_zod20.z.enum(["saved", "not_saved", "failed", "blocked", "read"]);
+var WebLogEntry = import_zod20.z.strictObject({
+  id: import_zod20.z.string().min(1).max(64),
+  at_ms: nonNegInt,
+  caller: WebLogCaller,
+  url: import_zod20.z.string().max(8192),
+  title: import_zod20.z.string().max(500).nullable(),
+  result: WebLogResult,
+  /** One sentence: why it failed or was blocked, or the save's notice. Never page text. */
+  detail: import_zod20.z.string().max(1e3).nullable(),
+  via: WebLogVia,
+  duration_ms: nonNegInt,
+  processed_document_id: import_zod20.z.string().max(64).nullable()
+});
+var WebLogListParams = import_zod20.z.strictObject({ since_ms: nonNegInt.optional(), limit: import_zod20.z.int().min(1).max(1e3).default(200) });
+var WebLogListResult = import_zod20.z.strictObject({ entries: import_zod20.z.array(WebLogEntry) });
+var WebLogClearParams = import_zod20.z.strictObject({});
+var WebLogClearResult = import_zod20.z.strictObject({ cleared: nonNegInt });
+var WebProgressEvent = import_zod20.z.strictObject({
+  request_id: RequestId,
+  phase: import_zod20.z.enum(["installing", "fetching", "saving"]),
+  done: nonNegInt,
+  total: nonNegInt
+});
+var WebResearchItemState = import_zod20.z.enum(["waiting", "fetching", "saved", "thin", "failed", "cannot_edit", "blocked"]);
+var WebResearchItem = import_zod20.z.strictObject({
+  topic_id: import_zod20.z.string().min(1).max(64),
+  topic_name: import_zod20.z.string().max(500),
+  source_id: import_zod20.z.string().min(1).max(64),
+  url: import_zod20.z.string().max(8192),
+  title: import_zod20.z.string().max(500).nullable(),
+  /** The capture level this computer would try (1 quick, 2 scroll); 3+ is the extension's. */
+  level: import_zod20.z.int().min(1).max(4),
+  last_failure: import_zod20.z.string().max(1e3).nullable(),
+  state: WebResearchItemState,
+  /** One sentence after a fetch: what happened. */
+  message: import_zod20.z.string().max(1e3).nullable()
+});
+var WebResearchQueueParams = import_zod20.z.strictObject({ topic_id: import_zod20.z.string().min(1).max(64).optional() });
+var WebResearchQueueResult = import_zod20.z.strictObject({
+  state: import_zod20.z.enum(["ready", "signed_out", "unavailable"]),
+  problem: import_zod20.z.string().max(1e3).nullable(),
+  /** L1/L2 items on topics this person can edit: what this computer can fetch. */
+  items: import_zod20.z.array(WebResearchItem),
+  /** Items on topics the person can view but not add to (shown, never fetched). */
+  view_only: nonNegInt
+});
+var WebResearchFetchParams = import_zod20.z.strictObject({
+  topic_id: import_zod20.z.string().min(1).max(64).optional(),
+  source_ids: import_zod20.z.array(import_zod20.z.string().min(1).max(64)).max(200).optional()
+});
+var WebResearchFetchResult = import_zod20.z.strictObject({
+  items: import_zod20.z.array(WebResearchItem),
+  saved: nonNegInt,
+  thin: nonNegInt,
+  failed: nonNegInt,
+  cannot_edit: nonNegInt
 });
 var ToolsServiceProgress = import_zod20.z.strictObject({ phase: import_zod20.z.enum(["fetching", "installing"]), done: nonNegInt, total: nonNegInt });
 
@@ -2782,7 +3032,27 @@ var SystemSettingsPane = import_zod21.z.enum([
   "storage",
   "system_report",
   /** (1.35) Privacy & Security › Microphone: where the person allows Matrx 2 the microphone. */
-  "microphone"
+  "microphone",
+  // (1.41) Each other privacy grant's own page (Settings › Permissions and privacy's buttons), named
+  // as sysinfo's OsPermissionName so a row opens its pane by its own name. A 1.40 core refuses these
+  // as INVALID_PARAMS, so a client asks only a 1.41 core for them.
+  "full_disk_access",
+  "accessibility",
+  "screen_recording",
+  "camera",
+  "automation",
+  "contacts",
+  "calendars",
+  "reminders",
+  "photos",
+  "location",
+  "local_network",
+  "bluetooth",
+  "wifi",
+  "notifications",
+  "speech_recognition",
+  "messages",
+  "mail"
 ]);
 var SystemOpenSettingsParams = import_zod21.z.strictObject({ pane: SystemSettingsPane });
 var SystemOpenSettingsResult = import_zod21.z.strictObject({ pane: SystemSettingsPane });
@@ -3488,10 +3758,10 @@ var ExecJobListResult = import_zod31.z.strictObject({ jobs: import_zod31.z.array
 
 // src/schema/coding.ts
 var import_zod32 = require("zod");
-var import_uuid4 = require("@ai-matrx/kit/uuid");
+var import_uuid5 = require("@ai-matrx/kit/uuid");
 var CodingServiceCredentials = import_zod32.z.strictObject({
   access_token: import_zod32.z.string().min(16).max(16384),
-  user_id: import_zod32.z.string().regex(import_uuid4.UUID_SHAPE_PATTERN),
+  user_id: import_zod32.z.string().regex(import_uuid5.UUID_SHAPE_PATTERN),
   /** The AI Matrx server this app talks to (production, or a local server on the nightly copy). */
   server_url: import_zod32.z.string().min(1).max(2048).regex(/^https?:\/\/[^\s/?#]+(\/[^\s?#]*)?$/)
 });
@@ -4262,7 +4532,12 @@ var MessagesListResult = import_zod36.z.strictObject({ messages: import_zod36.z.
 var MessagesSendParams = import_zod36.z.strictObject({
   /** A phone number or email the person can message. */
   to: import_zod36.z.string().min(3).max(320),
-  text: import_zod36.z.string().min(1).max(2e4)
+  text: import_zod36.z.string().min(1).max(2e4),
+  /**
+   * Send only over this service (Matrx Local's SendMessage `service`). Absent: iMessage first, and
+   * SMS when the recipient has no iMessage (since 1.42).
+   */
+  service: import_zod36.z.enum(["iMessage", "SMS"]).optional()
 });
 var MessagesSendResult = import_zod36.z.strictObject({ sent: import_zod36.z.boolean() });
 var ContactsSearchParams = import_zod36.z.strictObject({
@@ -4816,6 +5091,16 @@ var OPS = {
   "web.scrape": { params: WebScrapeParams, result: WebScrapeResult, kind: "unary", since: "1.22", errors: ["INVALID_PARAMS", "TIMEOUT", "RESOURCE_BUSY", "AUTH_REQUIRED", "INTERNAL"] },
   "web.search": { params: WebSearchParams, result: WebSearchResult, kind: "unary", since: "1.22", errors: ["INVALID_PARAMS", "TIMEOUT", "RESOURCE_BUSY", "AUTH_REQUIRED", "INTERNAL"] },
   "web.fetch_with_browser": { params: WebBrowserFetchParams, result: WebBrowserFetchResult, kind: "unary", since: "1.22", errors: ["INVALID_PARAMS", "TIMEOUT", "RESOURCE_BUSY", "AUTH_REQUIRED", "INTERNAL"] },
+  "web.runtime.state": { params: WebRuntimeParams, result: WebRuntimeState, kind: "unary", since: "1.40", errors: ["INTERNAL"] },
+  "web.runtime.install": { params: WebRuntimeParams, result: WebRuntimeState, kind: "unary", since: "1.40", errors: ["TIMEOUT", "RESOURCE_BUSY", "CANCELLED", "INTERNAL"] },
+  "web.runtime.remove": { params: WebRuntimeParams, result: WebRuntimeState, kind: "unary", since: "1.40", errors: ["RESOURCE_BUSY", "INTERNAL"] },
+  "web.outbox.list": { params: WebOutboxListParams, result: WebOutboxListResult, kind: "unary", since: "1.40", errors: ["INTERNAL"] },
+  "web.outbox.retry": { params: WebOutboxRetryParams, result: WebOutboxRetryResult, kind: "unary", since: "1.40", errors: ["NOT_FOUND", "AUTH_REQUIRED", "INTERNAL"] },
+  "web.outbox.discard": { params: WebOutboxDiscardParams, result: WebOutboxDiscardResult, kind: "unary", since: "1.40", errors: ["NOT_FOUND", "INTERNAL"] },
+  "web.log.list": { params: WebLogListParams, result: WebLogListResult, kind: "unary", since: "1.40", errors: ["INVALID_PARAMS"] },
+  "web.log.clear": { params: WebLogClearParams, result: WebLogClearResult, kind: "unary", since: "1.40", errors: ["INTERNAL"] },
+  "web.research.queue": { params: WebResearchQueueParams, result: WebResearchQueueResult, kind: "unary", since: "1.40", errors: ["INVALID_PARAMS", "INTERNAL"] },
+  "web.research.fetch": { params: WebResearchFetchParams, result: WebResearchFetchResult, kind: "unary", since: "1.40", errors: ["INVALID_PARAMS", "AUTH_REQUIRED", "RESOURCE_BUSY", "CANCELLED", "INTERNAL"] },
   // 1.23: the signed-in person's own agents and Vault, read as them (the desktop's Agents library and Vault).
   "account.agents.list": { params: AccountAgentsListParams, result: AccountAgentsListResult, kind: "unary", since: "1.23", errors: ["INTERNAL"] },
   "account.vault.list": { params: AccountVaultListParams, result: AccountVaultListResult, kind: "unary", since: "1.23", errors: ["INTERNAL"] },
@@ -4906,7 +5191,9 @@ var EVENTS = {
   "diag.errors.changed": DiagErrorsChangedEvent,
   "browser.invoke": BrowserInvokeEvent,
   "browser.sessions_changed": BrowserSessionsChangedEvent,
-  "browser.progress": BrowserProgressEvent
+  "browser.progress": BrowserProgressEvent,
+  "web.log.entry": WebLogEntry,
+  "web.progress": WebProgressEvent
 };
 var SERVICES = {
   ml: {
@@ -4932,9 +5219,12 @@ var SERVICES = {
     progress: ToolsServiceProgress,
     ops: {
       "tools.web_fetch": { params: WebFetchParams, result: WebFetchResult },
-      "tools.web_scrape": { params: WebScrapeParams, result: WebScrapeResult },
+      "tools.web_scrape": { params: ToolsWebScrapeParams, result: ToolsWebScrapeResult },
       "tools.web_search": { params: ToolsWebSearchParams, result: WebSearchResult },
-      "tools.web_browser_fetch": { params: WebBrowserFetchParams, result: WebBrowserFetchResult }
+      "tools.web_browser_fetch": { params: ToolsWebBrowserFetchParams, result: ToolsWebBrowserFetchResult },
+      "tools.web_runtime_state": { params: WebRuntimeParams, result: WebRuntimeState },
+      "tools.web_runtime_install": { params: WebRuntimeParams, result: WebRuntimeState },
+      "tools.web_runtime_remove": { params: WebRuntimeParams, result: WebRuntimeState }
     }
   }
 };
@@ -4967,7 +5257,9 @@ var NAMED_SCHEMAS = {
   RelayMsg,
   ClientToCoreMsg,
   CoreToClientMsg,
+  OsGrantState,
   OsPermissionName,
+  OsRequirementName,
   SysinfoGetParams,
   SysinfoGetResult,
   SysinfoHardwareParams,
@@ -5456,6 +5748,42 @@ var NAMED_SCHEMAS = {
   ToolsWebSearchParams,
   WebBrowserFetchParams,
   WebBrowserFetchResult,
+  WebAttachTarget,
+  WebLand,
+  WebNotSavedReason,
+  WebSourceNotice,
+  WebSourceState,
+  ToolsParseFile,
+  ToolsWebScrapeParams,
+  ToolsWebScrapePage,
+  ToolsWebScrapeResult,
+  ToolsWebBrowserFetchParams,
+  ToolsWebBrowserFetchResult,
+  WebRuntimeStateName,
+  WebRuntimeParams,
+  WebRuntimeState,
+  WebOutboxItem,
+  WebOutboxListParams,
+  WebOutboxListResult,
+  WebOutboxRetryParams,
+  WebOutboxRetryResult,
+  WebOutboxDiscardParams,
+  WebOutboxDiscardResult,
+  WebLogVia,
+  WebLogCaller,
+  WebLogResult,
+  WebLogEntry,
+  WebLogListParams,
+  WebLogListResult,
+  WebLogClearParams,
+  WebLogClearResult,
+  WebProgressEvent,
+  WebResearchItemState,
+  WebResearchItem,
+  WebResearchQueueParams,
+  WebResearchQueueResult,
+  WebResearchFetchParams,
+  WebResearchFetchResult,
   ToolsServiceProgress,
   AccountRowId,
   AccountReadState,
@@ -5665,7 +5993,14 @@ var FIELDS_SINCE = {
   AppsProjectsToWindowParams: { pin: "1.32", chat_ids: "1.36", take_off_from: "1.36" },
   AppsProjectsToWindowResult: { pin: "1.32" },
   AppsChatsTitlesCheckResult: { stale_windows: "1.33" },
-  AccountAgent: { tags: "1.39", model_id: "1.39", access_level: "1.39", organization_id: "1.39", origin: "1.39", is_archived: "1.39", orchestra: "1.39" }
+  AccountAgent: { tags: "1.39", model_id: "1.39", access_level: "1.39", organization_id: "1.39", origin: "1.39", is_archived: "1.39", orchestra: "1.39" },
+  WebScrapeParams: { engine: "1.40", land: "1.40" },
+  WebScrapePage: { source: "1.40" },
+  WebBrowserFetchParams: { land: "1.40" },
+  WebBrowserFetchResult: { source: "1.40" },
+  SysinfoGetResult: { requirements: "1.41" },
+  "SysinfoGetResult.permissions[]": { detail: "1.41" },
+  MessagesSendParams: { service: "1.42" }
 };
 var NULL_SINCE = {
   "RelayDeviceStatusEvent.since_ms": { since: "1.1", olderPeersGet: 0 }
@@ -5685,6 +6020,25 @@ var REASONS_SINCE = {
   awaiting_confirmation: "1.28",
   tool_disabled_on_device: "1.34"
 };
+var PERMISSIONS_SINCE = {
+  reminders: "1.41",
+  speech_recognition: "1.41",
+  messages: "1.41",
+  mail: "1.41",
+  wifi: "1.41"
+};
+function permissionsForPeer(value, version) {
+  if (value === null || typeof value !== "object" || Array.isArray(value)) return value;
+  const body = value;
+  if (!Array.isArray(body.permissions)) return value;
+  const since = PERMISSIONS_SINCE;
+  const kept = body.permissions.filter((p) => {
+    const name = p?.name;
+    const added = typeof name === "string" ? since[name] : void 0;
+    return !added || knows(version, added);
+  });
+  return kept.length === body.permissions.length ? value : { ...body, permissions: kept };
+}
 function statusForPeer(status, version) {
   const rule = NULL_SINCE["RelayDeviceStatusEvent.since_ms"];
   return status.since_ms === null && !knows(version, rule.since) ? { ...status, since_ms: rule.olderPeersGet } : status;
@@ -5729,7 +6083,9 @@ var RESULT_PATH = /* @__PURE__ */ new Map([
   ["apps.chats.list", "AppsChatsListResult"],
   ["apps.accounts.usage", "AppsAccountsUsageResult"],
   ["apps.accounts.resets", "AppsAccountsResetsResult"],
-  ["apps.windows.update_state", "AppsWindowsUpdateStateResult"]
+  ["apps.windows.update_state", "AppsWindowsUpdateStateResult"],
+  ["web.fetch_with_browser", "WebBrowserFetchResult"],
+  ["sysinfo.get", "SysinfoGetResult"]
 ]);
 var NESTED_RESULTS = /* @__PURE__ */ new Map([
   ["apps.chats.list", [["chats", "ChatRow"]]],
@@ -5742,7 +6098,9 @@ var NESTED_RESULTS = /* @__PURE__ */ new Map([
   ["apps.accounts.usage", [["accounts", "AccountUsage"]]],
   ["resources.snapshot", [["disks", "ResourcesDisk"]]],
   ["stack.state", [["servers", "StackServer"]]],
-  ["account.agents.list", [["agents", "AccountAgent"]]]
+  ["account.agents.list", [["agents", "AccountAgent"]]],
+  ["web.scrape", [["pages", "WebScrapePage"]]],
+  ["sysinfo.get", [["permissions", "SysinfoGetResult.permissions[]"]]]
 ]);
 function stripNested(value, nested, version) {
   if (value === null || typeof value !== "object" || Array.isArray(value)) return value;
@@ -5784,7 +6142,8 @@ function forPeer(op, part, value, version) {
     const windowKey = op ? WINDOW_RESULTS.get(op) : void 0;
     if (windowKey) return stripWindows(value, windowKey, version);
     const path = op ? RESULT_PATH.get(op) : void 0;
-    const top = path ? strip(value, FIELDS_SINCE[path], version) : value;
+    const known = op === "sysinfo.get" ? permissionsForPeer(value, version) : value;
+    const top = path ? strip(known, FIELDS_SINCE[path], version) : known;
     const nested = op ? NESTED_RESULTS.get(op) : void 0;
     return nested ? stripNested(top, nested, version) : top;
   }
@@ -5803,7 +6162,7 @@ function forPeer(op, part, value, version) {
 var VERSIONED_RESULT_OPS = [.../* @__PURE__ */ new Set([...RESULT_PATH.keys(), ...WINDOW_RESULTS.keys(), ...NESTED_RESULTS.keys()])];
 
 // src/contract.ts
-var CONTRACT_SHA256 = "542bc69319741eea52154d413b4fe974ee5a56f7aef351e78b866b0562e82753";
+var CONTRACT_SHA256 = "c96c1a43bc4b34d518fa088be9300d96baab63938ce0dbfb9425cdc706097668";
 
 // src/close-policy.ts
 var CLOSE_RULES = {
@@ -5874,7 +6233,9 @@ var TOOL_CATALOG = [
   { name: "desktop_contacts", group: "personal_automation", state: "built", path: "device_op", ops: ["contacts.search", "contacts.get"], platforms: ["darwin"], summary: "Contacts: search, one card" },
   { name: "desktop_calendar", group: "personal_automation", state: "built", path: "device_op", ops: ["calendar.list", "calendar.create", "reminders.list", "reminders.create"], platforms: ["darwin"], summary: "Calendar and Reminders: list and add" },
   { name: "desktop_photos", group: "personal_automation", state: "built", path: "device_op", ops: ["photos.search", "photos.get"], platforms: ["darwin"], summary: "The Photos library: find, export an original" },
-  { name: "desktop_location", group: "personal_automation", state: "built", path: "device_op", ops: ["location.get"], platforms: ["darwin", "win32"], summary: "Where the computer is (the OS's location service)" },
+  // Windows comes back once a Windows location fix is proven (plan attack retire-local 2026-10-12, B6):
+  // until then local_mac_apps (macOS-only) is judged on macOS and nothing claims Windows.
+  { name: "desktop_location", group: "personal_automation", state: "built", path: "device_op", ops: ["location.get"], platforms: ["darwin"], summary: "Where the computer is (the OS's location service)" },
   { name: "desktop_net", group: "personal_automation", state: "built", path: "device_op", ops: ["net.info", "net.wifi", "net.bluetooth", "net.devices", "net.mdns", "net.scan", "net.download"], platforms: ALL, summary: "Local network, Wi-Fi, Bluetooth, open ports and downloads" },
   { name: "desktop_schedule", group: "personal_automation", state: "built", path: "device_op", ops: ["schedule.create", "schedule.list", "schedule.cancel"], platforms: ALL, summary: "Run a tool's op on this computer on an interval; list and cancel" },
   // 1.38, code from anywhere: the person's Claude Code and Codex sessions on this computer. Turning