@medeo-plugin/sdk 0.0.0-stage → 0.7.0

package/dist/registry.js

@@ -0,0 +1,172 @@
+// Generated by platform-core from the capability registry; do not edit.
+export const METHODS = {
+    "capabilities.list": { permission: null, provider: null, ui: false, confirm: false, adapter: "host" },
+    "capabilities.labels": { permission: null, provider: null, ui: false, confirm: false, adapter: "host" },
+    "providers.list": { permission: null, provider: null, ui: false, confirm: false, adapter: "host" },
+    "permissions.request": { permission: null, provider: null, ui: true, confirm: true, adapter: "host" },
+    "i18n.state": { permission: null, provider: null, ui: false, confirm: false, adapter: "host" },
+    "i18n.setLocale": { permission: null, provider: null, ui: false, confirm: false, adapter: "host" },
+    "i18n.t": { permission: null, provider: null, ui: false, confirm: false, adapter: "host" },
+    "i18n.catalog": { permission: null, provider: null, ui: false, confirm: false, adapter: "host" },
+    "operations.state": { permission: null, provider: null, ui: false, confirm: false, adapter: "host" },
+    "operations.list": { permission: null, provider: null, ui: false, confirm: false, adapter: "host" },
+    "operations.cancel": { permission: null, provider: null, ui: false, confirm: false, adapter: "host" },
+    "operations.release": { permission: null, provider: null, ui: false, confirm: false, adapter: "host" },
+    "config.get": { permission: null, provider: null, ui: false, confirm: false, adapter: "host" },
+    "config.set": { permission: null, provider: null, ui: false, confirm: false, adapter: "host" },
+    "storage.get": { permission: "storage", provider: "medeo.storage", ui: false, confirm: false, adapter: "host" },
+    "storage.set": { permission: "storage", provider: "medeo.storage", ui: false, confirm: false, adapter: "host" },
+    "storage.remove": { permission: "storage", provider: "medeo.storage", ui: false, confirm: false, adapter: "host" },
+    "creation.open": { permission: "creation_open", provider: "medeo.creation", ui: false, confirm: false, adapter: "host" },
+    "resources.choose_directories": { permission: "file_access", provider: "medeo.workspace", ui: true, confirm: false, adapter: "host" },
+    "resources.request_directory": { permission: "file_access", provider: "medeo.workspace", ui: true, confirm: true, adapter: "host" },
+    "resources.list": { permission: "file_access", provider: "medeo.workspace", ui: false, confirm: false, adapter: "host" },
+    "resources.revoke": { permission: "file_access", provider: "medeo.workspace", ui: true, confirm: false, adapter: "host" },
+    "files.roots": { permission: "file_access", provider: "medeo.workspace", ui: false, confirm: false, adapter: "host" },
+    "files.mkdir": { permission: "file_access", provider: "medeo.workspace", ui: false, confirm: false, adapter: "host" },
+    "files.history": { permission: "file_access", provider: "medeo.workspace", ui: false, confirm: false, adapter: "host" },
+    "files.history_page": { permission: "file_access", provider: "medeo.workspace", ui: false, confirm: false, adapter: "host" },
+    "files.backup_preview": { permission: "file_access", provider: "medeo.workspace", ui: false, confirm: false, adapter: "host" },
+    "files.archive_backup": { permission: "file_access", provider: "medeo.workspace", ui: true, confirm: true, adapter: "host" },
+    "files.forget_preview": { permission: "file_access", provider: "medeo.workspace", ui: false, confirm: false, adapter: "host" },
+    "files.forget_record": { permission: "file_access", provider: "medeo.workspace", ui: true, confirm: true, adapter: "host" },
+    "files.restore": { permission: "file_access", provider: "medeo.workspace", ui: false, confirm: false, adapter: "host" },
+    "files.list": { permission: "file_access", provider: "medeo.workspace", ui: false, confirm: false, adapter: "host" },
+    "files.stat": { permission: "file_access", provider: "medeo.workspace", ui: false, confirm: false, adapter: "host" },
+    "files.read_text": { permission: "file_access", provider: "medeo.workspace", ui: false, confirm: false, adapter: "host" },
+    "files.write_text": { permission: "file_access", provider: "medeo.workspace", ui: false, confirm: false, adapter: "host" },
+    "files.move": { permission: "file_access", provider: "medeo.workspace", ui: false, confirm: false, adapter: "host" },
+    "files.trash": { permission: "file_access", provider: "medeo.workspace", ui: true, confirm: true, adapter: "host" },
+    "files.trash_preview": { permission: "file_access", provider: "medeo.workspace", ui: false, confirm: false, adapter: "host" },
+    "files.discard_preview": { permission: "file_access", provider: "medeo.workspace", ui: false, confirm: false, adapter: "host" },
+    "files.watch": { permission: "file_access", provider: "medeo.workspace", ui: false, confirm: false, adapter: "host" },
+    "files.events": { permission: "file_access", provider: "medeo.workspace", ui: false, confirm: false, adapter: "host" },
+    "files.watches": { permission: "file_access", provider: "medeo.workspace", ui: false, confirm: false, adapter: "host" },
+    "files.unwatch": { permission: "file_access", provider: "medeo.workspace", ui: false, confirm: false, adapter: "host" },
+    "files.read_link": { permission: "file_access", provider: "medeo.workspace", ui: false, confirm: false, adapter: "host" },
+    "files.measure": { permission: "file_access", provider: "medeo.workspace", ui: false, confirm: false, adapter: "host" },
+    "files.list_tree": { permission: "file_access", provider: "medeo.workspace", ui: false, confirm: false, adapter: "host" },
+    "files.trash_direct": { permission: "file_full_access", provider: "medeo.workspace", ui: false, confirm: false, adapter: "host" },
+    "network.request": { permission: "network", provider: "medeo.network", ui: false, confirm: false, adapter: "host" },
+    "network.read": { permission: "network", provider: "medeo.network", ui: false, confirm: false, adapter: "host" },
+    "network.origins": { permission: "network", provider: "medeo.network", ui: false, confirm: false, adapter: "host" },
+    "network.request_origin": { permission: "network", provider: "medeo.network", ui: true, confirm: true, adapter: "host" },
+    "network.revoke_origin": { permission: "network", provider: "medeo.network", ui: true, confirm: false, adapter: "host" },
+    "agent.models": { permission: "agent_api", provider: "medeo.agent", ui: false, confirm: false, adapter: "host" },
+    "agent.start": { permission: "agent_api", provider: "medeo.agent", ui: false, confirm: false, adapter: "host" },
+    "clipboard.read": { permission: "clipboard_read", provider: "medeo.desktop", ui: false, confirm: false, adapter: "electron" },
+    "clipboard.write": { permission: "clipboard_write", provider: "medeo.desktop", ui: false, confirm: false, adapter: "electron" },
+    "capture.status": { permission: "screen_capture", provider: "medeo.capture", ui: false, confirm: false, adapter: "host" },
+    "capture.sources": { permission: "screen_capture", provider: "medeo.capture", ui: true, confirm: false, adapter: "host" },
+    "capture.start": { permission: "screen_capture", provider: "medeo.capture", ui: true, confirm: true, adapter: "host" },
+    "capture.state": { permission: "screen_capture", provider: "medeo.capture", ui: false, confirm: false, adapter: "host" },
+    "capture.stop": { permission: "screen_capture", provider: "medeo.capture", ui: false, confirm: false, adapter: "host" },
+    "capture.cancel": { permission: "screen_capture", provider: "medeo.capture", ui: false, confirm: false, adapter: "host" },
+    "capture.open": { permission: "screen_capture", provider: "medeo.capture", ui: true, confirm: false, adapter: "electron" },
+    "capture.recover": { permission: "screen_capture", provider: "medeo.capture", ui: true, confirm: false, adapter: "host" },
+    "camera.status": { permission: "camera", provider: "medeo.system-services", ui: false, confirm: false, adapter: "host" },
+    "camera.start": { permission: "camera", provider: "medeo.system-services", ui: true, confirm: false, adapter: "host" },
+    "camera.stop": { permission: "camera", provider: "medeo.system-services", ui: false, confirm: false, adapter: "host" },
+    "camera.state": { permission: "camera", provider: "medeo.system-services", ui: false, confirm: false, adapter: "host" },
+    "camera.read": { permission: "camera", provider: "medeo.system-services", ui: false, confirm: false, adapter: "host" },
+    "microphone.status": { permission: "microphone", provider: "medeo.system-services", ui: false, confirm: false, adapter: "host" },
+    "microphone.start": { permission: "microphone", provider: "medeo.system-services", ui: true, confirm: false, adapter: "host" },
+    "microphone.stop": { permission: "microphone", provider: "medeo.system-services", ui: false, confirm: false, adapter: "host" },
+    "microphone.state": { permission: "microphone", provider: "medeo.system-services", ui: false, confirm: false, adapter: "host" },
+    "microphone.read": { permission: "microphone", provider: "medeo.system-services", ui: false, confirm: false, adapter: "host" },
+    "system_audio.status": { permission: "system_audio", provider: "medeo.system-services", ui: false, confirm: false, adapter: "host" },
+    "system_audio.start": { permission: "system_audio", provider: "medeo.system-services", ui: true, confirm: false, adapter: "host" },
+    "system_audio.stop": { permission: "system_audio", provider: "medeo.system-services", ui: false, confirm: false, adapter: "host" },
+    "system_audio.state": { permission: "system_audio", provider: "medeo.system-services", ui: false, confirm: false, adapter: "host" },
+    "system_audio.read": { permission: "system_audio", provider: "medeo.system-services", ui: false, confirm: false, adapter: "host" },
+    "applications.list": { permission: "applications", provider: "medeo.applications", ui: false, confirm: false, adapter: "host" },
+    "applications.launch": { permission: "applications", provider: "medeo.applications", ui: false, confirm: false, adapter: "host" },
+    "applications.state": { permission: "applications", provider: "medeo.applications", ui: false, confirm: false, adapter: "host" },
+    "shortcuts.register": { permission: "global_shortcuts", provider: "medeo.desktop", ui: false, confirm: false, adapter: "electron" },
+    "shortcuts.unregister": { permission: "global_shortcuts", provider: "medeo.desktop", ui: false, confirm: false, adapter: "electron" },
+    "shortcuts.events": { permission: "global_shortcuts", provider: "medeo.desktop", ui: false, confirm: false, adapter: "electron" },
+    "shortcuts.list": { permission: "global_shortcuts", provider: "medeo.desktop", ui: false, confirm: false, adapter: "electron" },
+    "notifications.show": { permission: "notifications", provider: "medeo.desktop", ui: false, confirm: false, adapter: "electron" },
+    "notifications.close": { permission: "notifications", provider: "medeo.desktop", ui: false, confirm: false, adapter: "electron" },
+    "tray.set": { permission: "tray", provider: "medeo.desktop", ui: false, confirm: false, adapter: "electron" },
+    "tray.remove": { permission: "tray", provider: "medeo.desktop", ui: false, confirm: false, adapter: "electron" },
+    "tray.events": { permission: "tray", provider: "medeo.desktop", ui: false, confirm: false, adapter: "electron" },
+    "windows.open": { permission: "app_windows", provider: "medeo.desktop", ui: false, confirm: false, adapter: "electron" },
+    "windows.close": { permission: "app_windows", provider: "medeo.desktop", ui: false, confirm: false, adapter: "electron" },
+    "windows.focus": { permission: "app_windows", provider: "medeo.desktop", ui: false, confirm: false, adapter: "electron" },
+    "windows.hide": { permission: "app_windows", provider: "medeo.desktop", ui: false, confirm: false, adapter: "electron" },
+    "windows.list": { permission: "app_windows", provider: "medeo.desktop", ui: false, confirm: false, adapter: "electron" },
+    "accessibility.status": { permission: "accessibility", provider: "medeo.system-services", ui: false, confirm: false, adapter: "host" },
+    "accessibility.request": { permission: "accessibility", provider: "medeo.system-services", ui: true, confirm: false, adapter: "host" },
+    "accessibility.windows": { permission: "accessibility", provider: "medeo.system-services", ui: false, confirm: false, adapter: "host" },
+    "accessibility.focus": { permission: "accessibility", provider: "medeo.system-services", ui: true, confirm: false, adapter: "host" },
+    "accessibility.selected_text": { permission: "accessibility", provider: "medeo.system-services", ui: true, confirm: false, adapter: "host" },
+    "accessibility.insert_text": { permission: "accessibility", provider: "medeo.system-services", ui: true, confirm: false, adapter: "host" },
+    "input_method.status": { permission: "input_method", provider: "medeo.input-method", ui: false, confirm: false, adapter: "host" },
+    "input_method.configure": { permission: "input_method", provider: "medeo.input-method", ui: false, confirm: false, adapter: "host" },
+    "input_method.enable": { permission: "input_method", provider: "medeo.input-method", ui: true, confirm: false, adapter: "host" },
+    "input_method.disable": { permission: "input_method", provider: "medeo.input-method", ui: false, confirm: false, adapter: "host" },
+    "input_method.events": { permission: "input_method", provider: "medeo.input-method", ui: false, confirm: false, adapter: "host" },
+    "input_method.respond": { permission: "input_method", provider: "medeo.input-method", ui: false, confirm: false, adapter: "host" },
+    "input_method.system": { permission: "input_method", provider: "medeo.input-method", ui: false, confirm: false, adapter: "host" },
+    "input_method.setup": { permission: "input_method", provider: "medeo.input-method", ui: true, confirm: true, adapter: "host" },
+    "input_method.remove": { permission: "input_method", provider: "medeo.input-method", ui: true, confirm: true, adapter: "host" },
+    "input_method.settings": { permission: "input_method", provider: "medeo.input-method", ui: true, confirm: false, adapter: "host" },
+    "external.open": { permission: "external_open", provider: "medeo.desktop", ui: false, confirm: false, adapter: "electron" },
+    "browser.open": { permission: "browser_view", provider: "medeo.desktop", ui: true, confirm: false, adapter: "electron" },
+    "browser.close": { permission: "browser_view", provider: "medeo.desktop", ui: false, confirm: false, adapter: "electron" },
+    "browser.state": { permission: "browser_view", provider: "medeo.desktop", ui: false, confirm: false, adapter: "electron" },
+    "system.info": { permission: "system_info", provider: "medeo.desktop", ui: false, confirm: false, adapter: "electron" },
+    "system.running": { permission: "system_info", provider: "medeo.desktop", ui: false, confirm: false, adapter: "host" },
+    "secrets.get": { permission: "secrets", provider: "medeo.secrets", ui: false, confirm: false, adapter: "host" },
+    "secrets.set": { permission: "secrets", provider: "medeo.secrets", ui: false, confirm: false, adapter: "host" },
+    "secrets.remove": { permission: "secrets", provider: "medeo.secrets", ui: false, confirm: false, adapter: "host" },
+    "secrets.result": { permission: "secrets", provider: "medeo.secrets", ui: false, confirm: false, adapter: "host" },
+    "background.schedule": { permission: "background_tasks", provider: "medeo.background", ui: false, confirm: false, adapter: "host" },
+    "background.list": { permission: "background_tasks", provider: "medeo.background", ui: false, confirm: false, adapter: "host" },
+    "background.cancel": { permission: "background_tasks", provider: "medeo.background", ui: false, confirm: false, adapter: "host" },
+    "background.events": { permission: "background_tasks", provider: "medeo.background", ui: false, confirm: false, adapter: "host" },
+    "power.start": { permission: "power", provider: "medeo.desktop", ui: false, confirm: false, adapter: "electron" },
+    "power.stop": { permission: "power", provider: "medeo.desktop", ui: false, confirm: false, adapter: "electron" },
+    "power.state": { permission: "power", provider: "medeo.desktop", ui: false, confirm: false, adapter: "electron" },
+    "process.start": { permission: "process_spawn", provider: "medeo.process", ui: false, confirm: false, adapter: "host" },
+    "process.state": { permission: "process_spawn", provider: "medeo.process", ui: false, confirm: false, adapter: "host" },
+    "process.write": { permission: "process_spawn", provider: "medeo.process", ui: false, confirm: false, adapter: "host" },
+    "process.stop": { permission: "process_spawn", provider: "medeo.process", ui: false, confirm: false, adapter: "host" },
+    "system.trash": { permission: "node", provider: "medeo.node", ui: false, confirm: false, adapter: "electron" },
+    "approvals.request": { permission: "approvals", provider: "medeo.approvals", ui: true, confirm: true, adapter: "host" },
+    "approvals.rules": { permission: "approvals", provider: "medeo.approvals", ui: false, confirm: false, adapter: "host" },
+    "approvals.forget": { permission: "approvals", provider: "medeo.approvals", ui: false, confirm: false, adapter: "host" },
+    "server.start": { permission: "local_server", provider: "medeo.local-server", ui: false, confirm: false, adapter: "host" },
+    "server.state": { permission: "local_server", provider: "medeo.local-server", ui: false, confirm: false, adapter: "host" },
+    "server.stop": { permission: "local_server", provider: "medeo.local-server", ui: false, confirm: false, adapter: "host" },
+    "server.events": { permission: "local_server", provider: "medeo.local-server", ui: false, confirm: false, adapter: "host" },
+    "server.respond": { permission: "local_server", provider: "medeo.local-server", ui: false, confirm: false, adapter: "host" },
+    "printing.print": { permission: "printing", provider: "medeo.desktop", ui: true, confirm: false, adapter: "electron" },
+    "contacts.status": { permission: "contacts", provider: "medeo.system-services", ui: false, confirm: false, adapter: "host" },
+    "contacts.request": { permission: "contacts", provider: "medeo.system-services", ui: true, confirm: false, adapter: "host" },
+    "contacts.list": { permission: "contacts", provider: "medeo.system-services", ui: false, confirm: false, adapter: "host" },
+    "contacts.save": { permission: "contacts", provider: "medeo.system-services", ui: true, confirm: false, adapter: "host" },
+    "calendar.status": { permission: "calendar", provider: "medeo.system-services", ui: false, confirm: false, adapter: "host" },
+    "calendar.request": { permission: "calendar", provider: "medeo.system-services", ui: true, confirm: false, adapter: "host" },
+    "calendar.list": { permission: "calendar", provider: "medeo.system-services", ui: false, confirm: false, adapter: "host" },
+    "calendar.save": { permission: "calendar", provider: "medeo.system-services", ui: true, confirm: false, adapter: "host" },
+    "location.status": { permission: "location", provider: "medeo.system-services", ui: false, confirm: false, adapter: "host" },
+    "location.request": { permission: "location", provider: "medeo.system-services", ui: true, confirm: false, adapter: "host" },
+    "location.current": { permission: "location", provider: "medeo.system-services", ui: true, confirm: false, adapter: "host" },
+    "devices.choose": { permission: "device_access", provider: "medeo.system-services", ui: true, confirm: false, adapter: "host" },
+    "devices.open": { permission: "device_access", provider: "medeo.system-services", ui: true, confirm: false, adapter: "host" },
+    "devices.read": { permission: "device_access", provider: "medeo.system-services", ui: false, confirm: false, adapter: "host" },
+    "devices.write": { permission: "device_access", provider: "medeo.system-services", ui: false, confirm: false, adapter: "host" },
+    "devices.close": { permission: "device_access", provider: "medeo.system-services", ui: false, confirm: false, adapter: "host" },
+    "devices.list": { permission: "device_access", provider: "medeo.system-services", ui: false, confirm: false, adapter: "host" },
+};
+export const LIMITS = {
+    notifications: 16,
+    power: 8,
+    shortcuts: 16,
+    windows: 8,
+    browser_windows: 4,
+    media_streams: 4,
+    queued_events: 64,
+};

package/package.json

@@ -1,6 +1,40 @@
 {
   "name": "@medeo-plugin/sdk",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.7.0",
+  "description": "TypeScript SDK for Medeo desktop plugins: one import for the sandboxed worker, its windows and Node plugins.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/one2x-ai/medeo-desktop-plugin-sdk.git",
+    "directory": "packages/plugin-sdk"
+  },
+  "homepage": "https://github.com/one2x-ai/medeo-desktop-plugin-sdk#readme",
+  "keywords": [
+    "medeo",
+    "plugin",
+    "sdk"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "src",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "prepack": "npm run build"
+  },
+  "engines": {
+    "node": ">=22"
+  }
+}

package/src/generated.ts

@@ -0,0 +1,158 @@
+// Generated by platform-contract; do not edit.
+export type JsonValue = number | string | boolean | Array<JsonValue> | { [key in string]?: JsonValue } | null;
+export type Permission = "storage" | "creation_open" | { "file_access": Array<string> } | { "file_full_access": Array<string> } | { "network": Array<string> } | "agent_api" | "clipboard_read" | "clipboard_write" | "screen_capture" | "camera" | "microphone" | "system_audio" | "applications" | "global_shortcuts" | "notifications" | "tray" | "app_windows" | "accessibility" | "input_method" | { "external_open": Array<string> } | { "browser_view": Array<string> } | "system_info" | "secrets" | "background_tasks" | "power" | { "process_spawn": Array<string> } | "local_server" | "printing" | "contacts" | "calendar" | "location" | "device_access" | { "approvals": Array<string> } | "node";
+export type PluginCommand = { id: string, title: string, };
+export type PluginLocalization = { default_locale: string, catalogs: { [key in string]?: string }, };
+export type Runtime = "sandbox" | "node";
+export type GrantScope = "once" | "run" | "always";
+export type ApprovalRule = { action: string, 
+/**
+ * The rule key, or a prefix ending in `*`.
+ */
+pattern: string, allow: boolean, 
+/**
+ * `run` rules belong to the running instance; `always` rules are stored.
+ */
+scope: GrantScope, };
+export type ApprovalRecord = { action: string, rule_key: string, 
+/**
+ * `allow` or `deny`.
+ */
+decision: string, 
+/**
+ * `once`, `run`, `always`, or `rule` when a remembered rule decided.
+ */
+scope: string, time_ms: number, };
+export type TargetPlatform = "macos" | "windows";
+export type Engines = { medeo?: string, };
+export type InstallSourceKind = "file" | "folder" | "github" | "npm" | "dev";
+export type InstallSource = { kind: InstallSourceKind, 
+/**
+ * A file path, folder path, `owner/repo[#tag-prefix]` or npm package name.
+ */
+locator: string, 
+/**
+ * The release tag or npm version the package was taken from.
+ */
+version?: string, };
+export type ConfigType = "string" | "number" | "boolean";
+export type ConfigProperty = { type: ConfigType, default: JsonValue, title: string, description?: string, 
+/**
+ * Allowed values; the plugin center shows a choice.
+ */
+enum?: Array<JsonValue>, };
+export type Configuration = { properties: { [key in string]?: ConfigProperty }, };
+export type Keybinding = { command: string, key: string, };
+export type Menus = { 
+/**
+ * Command ids shown in the main window's Plugins menu.
+ */
+app?: Array<string>, };
+export type Contributes = { configuration?: Configuration, keybindings?: Array<Keybinding>, menus?: Menus, };
+export type Manifest = { localization?: PluginLocalization, id: string, name: string, 
+/**
+ * One sentence the plugin center shows under the name; translated as
+ * `plugin.description` in the plugin's catalogs.
+ */
+description?: string, 
+/**
+ * The plugin's icon, at the package root: `icon.svg` or `icon.png`.
+ */
+icon?: string, version: string, api_version: number, worker: string, ui: string | null, permissions: Array<Permission>, commands: Array<PluginCommand>, runtime?: Runtime, 
+/**
+ * When Medeo starts the plugin: `onStartup`, `onCommand:<id>`,
+ * `onSchedule`, `onShortcut`. Without any, it starts when used.
+ */
+activation_events?: Array<string>, contributes?: Contributes, 
+/**
+ * Operating systems the plugin runs on; empty means all.
+ */
+platforms?: Array<TargetPlatform>, 
+/**
+ * The Medeo versions the plugin needs; absent means any that loads format 2.
+ */
+engines?: Engines, };
+export type PackageFile = { size: number, sha256: string, };
+export type PackageIndex = { manifest: Manifest, files: { [key in string]?: PackageFile }, };
+export type Asset = { mime: string, path: string, size: number, sha256: string, };
+export type PackageSignature = { format: number, public_key: string, signature: string, index: string, };
+export type PackageInfo = { manifest: Manifest, digest: string, publisher: string, 
+/**
+ * Bytes of all signed files, i.e. the installed size. Records written
+ * before this field existed are backfilled at start.
+ */
+size: number, 
+/**
+ * What this build accepted but does not understand (`unknown_contribution:<key>`);
+ * shown at install and in the developer log, never a reason to refuse.
+ */
+warnings?: Array<string>, };
+export type CapabilityDescriptor = { permission: string, group: string, version: number, scoped: boolean, methods: Array<string>, available_methods: Array<string>, granted: boolean, declared: boolean, os_authorization: string, };
+export type DirectoryGrant = { id: string, name: string, available: boolean, 
+/**
+ * Full access: view and move to the Trash without a Host confirmation.
+ */
+full: boolean, };
+export type NetworkOrigin = { origin: string, declared: boolean, allowed: boolean, };
+export type InstalledPlugin = { localization: JsonValue, id: string, active: string | null, versions: Array<PackageInfo>, grants: Array<Permission>, directories: Array<DirectoryGrant>, network_origins: Array<NetworkOrigin>, 
+/**
+ * For resident (`onStartup`) plugins: whether the user lets it run in
+ * the background. Other plugins run only while in use and ignore it.
+ */
+enabled: boolean, resident: boolean, 
+/**
+ * User-owned macOS Dock launcher preference; plugins cannot modify it.
+ */
+dock: boolean, 
+/**
+ * User-owned: whether the plugin's menu-bar icon (`tray`) is shown; plugins cannot modify it.
+ */
+menu_bar: boolean, instance: string | null, 
+/**
+ * Permission ids granted to the running instance only (`run` scope).
+ */
+session_grants: Array<string>, 
+/**
+ * Permission ids the user refused with "don't ask again".
+ */
+denied: Array<string>, 
+/**
+ * Remembered `approvals.request` answers.
+ */
+approval_rules: Array<ApprovalRule>, 
+/**
+ * The active version's icon as a `data:` URL, when the package has one.
+ */
+icon?: string, 
+/**
+ * Where the plugin was installed from, when Main recorded it.
+ */
+source?: InstallSource, };
+export type Instance = { id: string, plugin_id: string, digest: string, manifest: Manifest, };
+export type Task = { id: string, plugin_id: string, instance: string, command: string, status: string, result: JsonValue | null, 
+/**
+ * Unix milliseconds; absent for rows written before times were recorded.
+ */
+created_ms: number | null, finished_ms: number | null, };
+export type Snapshot = { protocol: number, plugins: Array<InstalledPlugin>, tasks: Array<Task>, };
+export type HostEvent = { "type": "operation", instance: string, id: string, method: string, status: string, revision?: number, } | { "type": "signal", instance: string, channel: string, } | { "type": "wake", plugin_id: string, };
+export type Command = { "op": "ping" } | { "op": "shortcuts_list" } | { "op": "shortcut_validate", target: string, accelerator: string, } | { "op": "shortcut_save", target: string, accelerator: string, } | { "op": "shortcut_remove", target: string, } | { "op": "system_locale", locale: string, } | { "op": "plugin_locale", plugin_id: string, locale: string, } | { "op": "approve", instance: string, ticket: string, approved: boolean, 
+/**
+ * Without it an approval is stored (`always`) and a refusal asks again next time.
+ */
+scope?: GrantScope, } | { "op": "capture_stop", id: string, } | { "op": "capture_asset", instance: string, id: string, } | { "op": "media_asset", instance: string, id: string, } | { "op": "agent_settings" } | { "op": "agent_configure", endpoint: string, model: string, encrypted_key: string | null, key: string, persist: boolean, } | { "op": "agent_remove" } | { "op": "agent_test", action: string, id: string | null, } | { "op": "snapshot" } | { "op": "capability_catalog" } | { "op": "grant_permission", plugin_id: string, digest: string, permission: string, } | { "op": "forget_approval_rule", plugin_id: string, action: string, pattern: string, } | { "op": "approval_log", plugin_id: string, } | { "op": "revoke_permission", plugin_id: string, permission: string, } | { "op": "network_origin_revoke", plugin_id: string, origin: string, } | { "op": "configure_capabilities", methods: Array<string>, } | { "op": "capability_result", instance: string, ticket: string, result: JsonValue | null, error: string | null, } | { "op": "quiesce", plugin_id: string, } | { "op": "resource_grant", instance: string, directories: Array<string>, full: boolean, } | { "op": "resource_revoke", plugin_id: string, grant_id: string, } | { "op": "inspect", package_file: string, } | { "op": "install", package_file: string, digest: string, grants: Array<Permission>, 
+/**
+ * Recorded with the plugin (plugin center "Source"); absent for older callers.
+ */
+source?: InstallSource, } | { "op": "pack_dir", directory: string, key_file: string, output: string, 
+/**
+ * Stamp a content-derived `-dev.h<hash>` version like the toolchain's `dev` does.
+ */
+development: boolean, } | { "op": "prepare", plugin_id: string, digest: string, } | { "op": "commit", instance: string, } | { "op": "abort", instance: string, } | { "op": "stop", plugin_id: string, } | { "op": "busy", plugin_id: string, } | { "op": "deactivate", plugin_id: string, } | { "op": "dock_set", plugin_id: string, enabled: boolean, } | { "op": "menu_bar_set", plugin_id: string, enabled: boolean, } | { "op": "keep_running", plugin_id: string, enabled: boolean, } | { "op": "uninstall", plugin_id: string, } | { "op": "config_state", plugin_id: string, } | { "op": "config_set", plugin_id: string, key: string, value: JsonValue, } | { "op": "package_dir", instance: string, } | { "op": "remove_version", plugin_id: string, digest: string, } | { "op": "grants", plugin_id: string, grants: Array<Permission>, } | { "op": "asset", instance: string, path: string, } | { "op": "invoke", instance: string, method: string, args: JsonValue, 
+/**
+ * Main sets this when the caller is one of the plugin's windows rather
+ * than its background worker; `ui` methods require it.
+ */
+ui?: boolean, } | { "op": "task_start", instance: string, command: string, } | { "op": "task_finish", instance: string, task: string, result: JsonValue | null, failed: boolean, } | { "op": "labels", locale: string, };
+export type Request = { version: number, id: number, command: Command, };
+export type Response = { id: number, result: JsonValue | null, error: string | null, };