@omercnet/paseo-omp 1.3.3-next.238.1 → 1.3.3-next.243.1

package/OVERVIEW.md

@@ -2,7 +2,7 @@ OMP adds an agent provider for the OMP coding agent, plus an OMP sidebar and wor
 
 ## Setup
 
-- Paseo 0.9.2 through 0.9.x, 0.10.x or 0.11.x.
+- Paseo ^0.11.0.
 - OMP 18.1.15 or newer on the daemon host, speaking RPC protocol v2. Older runtimes are rejected.
 - Provider options let you change the OMP command, set environment values, choose an output redaction mode and set a session directory and timeout. Named OMP profiles appear as separate `OMP · <profile>` providers.
 

package/README.md

@@ -24,7 +24,7 @@ before capture.
 
 ## Quick start
 
-Requirements: Paseo `^0.9.2 || ^0.10.0 || ^0.11.0`, OMP `18.1.15` or newer, and OMP RPC protocol v2. Paseo 0.9.2 is required for reliable plugin-provider request failure containment, reload cleanup, and daemon shutdown ordering; 0.10.1 is verified against the same public plugin contracts.
+Requirements: Paseo `^0.11.0`, OMP `18.1.15` or newer, and OMP RPC protocol v2. The config screen and Hub row use the 0.11 screen and sidebar APIs, so Paseo 0.9 and 0.10 hosts are no longer supported.
 
 ```bash
 paseo plugin install npm:@omercnet/paseo-omp@<version>
@@ -40,7 +40,7 @@ Open the **OMP** sidebar to review the provider-profile contract, choose which c
 - [Core-provider issue and parity audit](docs/core-provider-issue-audit.md)
 - [Release checklist](docs/release-checklist.md)
 
-The plugin uses public Paseo 0.9 and 0.10 provider and client contracts and registers distinct `omp-plugin` and `omp-plugin-<profile>` identities; it does not modify the bundled `omp` provider.
+The plugin uses public Paseo 0.11 provider and client contracts and registers distinct `omp-plugin` and `omp-plugin-<profile>` identities; it does not modify the bundled `omp` provider.
 
 ## Named OMP profiles
 
@@ -55,7 +55,7 @@ Profile selection is request-local: concurrent clients cannot change each other'
 ## Paseo provider SDK coverage
 
 The capability inventory is pinned to `@getpaseo/plugin` 0.11.1, with nightly compatibility checks
-against supported 0.9 and 0.10 hosts and the latest/beta channels. Provider capability scoring covers
+against the latest and beta channels. Provider capability scoring covers
 all 17 entries in the SDK's `PROVIDER_CAPABILITIES`; the separate provider/client SDK table below
 also tracks the 0.11 registration, screen, and sidebar APIs. This measures strict SDK surface
 coverage, not general product quality.
@@ -95,7 +95,7 @@ Provider functionality outside the capability flags is tracked separately:
 | --- | ---: | --- |
 | Registration metadata and sanitized SVG icon | **100%** | Stable `omp-plugin` identity, label, description, and bundled icon. |
 | Strict `providerOptionsSchema` | **100%** | Command, literal environment, names-only profile inherited environment, output-redaction mode, session directory, RPC timeout, and role-model options are validated and normalized. Host-wide inherited names are separately persisted and merged at launch. |
-| Availability diagnostics | **50%** | The plugin implements a `checkAvailability` hook with bounded checks that distinguish missing, unrunnable, incompatible, and available OMP runtimes, but Paseo 0.10.2 and 0.11.1 do not call it. Hosts treat the provider as available when a connection opens, and launch failures surface at session start. |
+| Availability diagnostics | **50%** | The plugin implements a `checkAvailability` hook with bounded checks that distinguish missing, unrunnable, incompatible, and available OMP runtimes, but Paseo 0.11.1 does not call it. The host uses the `status()` hook below instead, which reuses this probe for the default launch. |
 | Catalog cache identity | **100%** | Hash includes effective options, merged host/profile inherited-environment names, settings, scope, cwd, and default command, but never resolves or fingerprints inherited values. |
 | Models, modes, and thinking catalog | **100%** | Native catalog is mapped to opaque public model IDs with committed defaults and permission-gated modes. |
 | Connection `send` / `onEvent` / `close` lifecycle | **100%** | Request correlation, multi-session ownership, process recovery, teardown, and provider reload/removal are covered. |
@@ -105,8 +105,9 @@ Provider functionality outside the capability flags is tracked separately:
 | Commands and committed session state events | **100%** | Publishes `session.commands`, `session.opened`, `session.config`, `session.ready`, and request completion in protocol order. |
 | Built-in timeline snapshots | **100%** | Assistant, reasoning, tools, todos, notifications, errors, compaction, and friendly MCP labels use stable IDs and complete snapshots. OMP emits client-safe PNG/JPEG when possible; validated legacy WebP images render on capable clients with an explicit per-image fallback elsewhere. |
 | Usage reporting | **100%** | Periodic, post-compaction, fallback, terminal, timeout, and recovered-runtime samples publish `session.usage`. |
-| 0.11 provider `status()` | **0%** | Not registered. Its request carries only an optional daemon-resolved `launch`; the daemon supplies one only when a registration declares `command`, which would move launch ownership to the daemon. Without that, status cannot see per-agent `providerOptions.command`, so probing a guessed default could wrongly mark a valid custom-command provider unavailable. |
-| 0.11 screens and sidebar items | **100%** | The global config surface migrates to `addScreen({ id: "config" })`, preserving legacy links and encoding profile selection in screen params. The Hub status row uses `addSidebarHeaderItem` + `SidebarRow`, lists processes and tails logs in a reusable popover. Hosts without the 0.11 APIs retain the static config row/surface; the Hub row is 0.11-only. |
+| 0.11 provider `status()` | **75%** | Registered for the plugin-owned default launch (`OMP_COMMAND` or `omp`, plus the fixed `--profile` wrapper for profile providers), using the bounded `--version`/`--help` probe. Only a missing executable reports `available: false`; slow, failing, or unrecognized probes stay available with a diagnostic. An unexpected internal probe error is not caught here, so the host reports it as unavailable. Available results are shared for 30 seconds; an unavailable result is never remembered, so installing `omp` takes effect on the next host call. The request carries only an optional daemon `launch` and never `providerOptions`, so a per-agent `providerOptions.command` or `env` is invisible. **Breaking on 0.11 hosts:** the host gates create, resume, and draft commands/features on this status, so a missing default executable blocks them all, including agents configured with an otherwise valid custom command. Any request `launch` is ignored. |
+| 0.11 provider `command` and daemon launch | **0%** | Deliberately not declared. Declaring `command` makes the daemon resolve it against its own `PATH` and reject every `connect` when the default binary is missing. The resulting `launch.env` is the daemon's entire process environment plus overrides, indistinguishable from configured values, so adopting it would defeat names-only `inheritEnv` and the fixed profile store environment. The host never supplies `launch` without a declared `command`; `connect` and `getCatalogCacheKey` do not read it, each pinned by `tests/provider-catalog.test.ts`. Revisit if the host stops gating on the default binary or exposes configured `env` separately from the daemon environment. |
+| 0.11 screens and sidebar items | **100%** | The global config surface migrates to `addScreen({ id: "config" })`, preserving legacy links and encoding profile selection in screen params. The Hub status row uses `addSidebarHeaderItem` + `SidebarRow`, lists processes and tails logs in a reusable popover. The legacy static config row and surface were removed with the 0.11 floor. |
 | 0.11 usage source | **0%** | Not registered. `server/quota.ts` reads OMP's recorded `usage_history`, not live quota, so there is no live fetcher to register. Upstream Claude and Codex sources fetch live quota for the Anthropic and Codex OAuth credentials in the daemon's default or `OMP_PROFILE` store; other providers and named profiles remain covered only by this plugin's historical quota pill. |
 
 Tracking rules:
@@ -124,7 +125,7 @@ Existing agents whose provider is `omp` remain owned by the bundled provider. Ne
 
 OMP `18.1.15` is the oldest version tested end to end. The direct provider's hard compatibility gate is `rpc-ui` protocol v2: metadata-free legacy ready frames and v1-only runtimes are rejected before a provider session opens because they cannot support the advertised persistence and conversation-rewind capabilities. Typed tool approvals remain capability-gated and fall back as described above. For terminal completion, a matching `agent_end.requestId` is authoritative and mismatches are ignored before state changes. Released OMP 18.2.x builds that omit that field use an ordered fallback requiring a fresh correlated native user entry followed by current-turn assistant activity, an idle non-compacting runtime, and no conflicting permission, tool, steer, or child-session work. Ambiguous events while OMP is active are ignored; unresolved ambiguity after confirmed idle fails only the Paseo turn. This trades a bounded residual same-agent stale-event risk for compatibility with released OMP instead of terminating and lazily restarting the runtime after every later prompt. Paseo clients, including mobile clients inside reconnect grace, do not own or terminate the daemon-managed OMP session.
 
-Paseo 0.9.2 is the minimum supported stable release, and 0.10.1 is supported. The controlled Docker canary is pinned to official 0.11.1; nightly SDK checks cover the newest 0.9 and 0.10 patches plus the latest and beta channels. Older Paseo lines are covered by that typecheck/unit matrix, not the current Docker canary. The canary preserves nested provider-subagent ancestry and spawning-tool links, and validates npm-managed plugin sources, platform-owned external URL opening, and whole-item timeline transforms before Overview grouping.
+Paseo 0.11 is the minimum supported release. The controlled Docker canary is pinned to official 0.11.1; nightly SDK checks cover the latest and beta channels. The canary preserves nested provider-subagent ancestry and spawning-tool links, and validates npm-managed plugin sources, platform-owned external URL opening, and whole-item timeline transforms before Overview grouping.
 
 Install, update, disable, or remove `paseo-omp` independently of the bundled provider. Verify the provider snapshot contains `omp-plugin` after installation; a bundled `omp` entry may remain present and is not modified by this plugin.
 

package/client/hub-sidebar.tsx

@@ -1,9 +1,6 @@
-import type { PluginHostProps } from "@getpaseo/plugin/client";
-// Namespace import: on 0.9/0.10 hosts this module lacks SidebarRow, which is only rendered from
-// 0.11-only sidebar items. Typed locally so older SDK typechecks still compile.
-import * as pluginUi from "@getpaseo/plugin/client/ui";
+import type { PluginPopoverProps, PluginSidebarItemProps } from "@getpaseo/plugin/client";
+import { SidebarRow } from "@getpaseo/plugin/client/ui";
 import { useQuery } from "@tanstack/react-query";
-import type { ComponentType, ReactNode } from "react";
 import { Text, View } from "react-native";
 import { HubProcessList } from "./hub-popover";
 import { CONFIG_SCREEN_ID, type HubSnapshot, hubTrailing } from "./sidebar-compat";
@@ -12,40 +9,7 @@ import { CONFIG_SCREEN_ID, type HubSnapshot, hubTrailing } from "./sidebar-compa
 const HUB_POLL_MS = 15_000;
 const HUB_SIDEBAR_QUERY_KEY = ["paseo-omp", "hub-sidebar"] as const;
 
-interface OpenScreenInput {
-  screenId: string;
-  params?: Record<string, string>;
-}
-type HostProps = Pick<PluginHostProps, "theme" | "layout">;
-interface PopoverProps extends HostProps {
-  close(): void;
-  openScreen(input: OpenScreenInput): void;
-}
-interface SidebarItemProps extends HostProps {
-  currentScreen: { screenId: string; params: Record<string, string> } | null;
-  openScreen(input: OpenScreenInput): void;
-  openPopover(Content: ComponentType<PopoverProps>): void;
-}
-type SidebarRowComponent = ComponentType<{
-  id?: string;
-  icon?: string | ComponentType<{ size: number; color: string }>;
-  label?: string;
-  onPress(): void;
-  active?: boolean;
-  trailing?: ReactNode;
-}>;
-
-const uiModule: object = pluginUi;
-// Present on every 0.11 host, the only hosts that render these items. The guard and cast keep
-// older-SDK typechecks (which lack SidebarRow) compiling; presence check only, because host
-// components may be memo/forwardRef objects rather than plain functions.
-const SidebarRow: SidebarRowComponent | undefined =
-  "SidebarRow" in uiModule && uiModule.SidebarRow
-    ? (uiModule.SidebarRow as SidebarRowComponent)
-    : undefined;
-
-export function ConfigSidebarItem({ currentScreen, openScreen }: SidebarItemProps) {
-  if (!SidebarRow) return null;
+export function ConfigSidebarItem({ currentScreen, openScreen }: PluginSidebarItemProps) {
   return (
     <SidebarRow
       icon="Settings"
@@ -64,7 +28,7 @@ export function createHubSidebar(loadSnapshot: () => Promise<HubSnapshot>) {
       refetchInterval: HUB_POLL_MS,
     });
 
-  function HubSidebarPopover({ theme, layout }: PopoverProps) {
+  function HubSidebarPopover({ theme, layout }: PluginPopoverProps) {
     const snapshot = useHubSnapshot();
     const muted = { color: theme.colors.foregroundMuted, fontSize: 13 };
     if (snapshot.isLoading) return <Text style={muted}>Loading hub processes…</Text>;
@@ -102,9 +66,8 @@ export function createHubSidebar(loadSnapshot: () => Promise<HubSnapshot>) {
     );
   }
 
-  function HubSidebarItem({ theme, openPopover }: SidebarItemProps) {
+  function HubSidebarItem({ theme, openPopover }: PluginSidebarItemProps) {
     const snapshot = useHubSnapshot();
-    if (!SidebarRow) return null;
     const state = hubTrailing(snapshot.data, snapshot.error !== null);
     const trailing = state ? (
       <View

package/client/sidebar-compat.ts

@@ -2,42 +2,12 @@ import type { HubProcess } from "../shared/hub";
 import { isOmpProfileName, type OmpStore } from "../shared/omp-store";
 import { hubProcessTone } from "./hub-status";
 
-/** The sidebar id the 0.10 `addSidebarItem` used; the 0.11 screen keeps it so saved links work. */
+/** The config screen keeps the id of the retired 0.10 sidebar item so saved links work. */
 export const CONFIG_SCREEN_ID = "config";
 export const HUB_SIDEBAR_ITEM_ID = "hub";
 
 type ScreenParams = Readonly<Record<string, string>>;
 
-/**
- * The 0.11 screen/sidebar-item API, typed structurally so 0.9/0.10 SDK typechecks still compile.
- * On 0.10 hosts these members are absent at runtime.
- */
-export interface ScreenCapableClient {
-  addScreen(contribution: {
-    id: string;
-    title: string | ((params: ScreenParams) => string);
-    Component: (props: never) => unknown;
-  }): () => void;
-  addSidebarHeaderItem(contribution: {
-    id: string;
-    title: string;
-    Component: (props: never) => unknown;
-  }): () => void;
-  openScreen(input: { screenId: string; params?: Record<string, string> }): void;
-}
-
-/** True only on Paseo 0.11+ hosts, which provide screens, header items, and `openScreen`. */
-export function supportsScreens<Client extends object>(
-  client: Client,
-): client is Client & ScreenCapableClient {
-  const candidate = client as Partial<Record<keyof ScreenCapableClient, unknown>>;
-  return (
-    typeof candidate.addScreen === "function" &&
-    typeof candidate.addSidebarHeaderItem === "function" &&
-    typeof candidate.openScreen === "function"
-  );
-}
-
 /** A `profile` screen param selects that store; anything invalid falls back to the default. */
 export function configStoreFromParams(params: ScreenParams | undefined): OmpStore | undefined {
   const profile = params?.profile?.trim();

package/index.client.tsx

@@ -4,7 +4,6 @@ import type {
   PluginClientContext,
   PluginSurfaceProps,
 } from "@getpaseo/plugin/client";
-import type { ComponentType } from "react";
 import { OmpIcon } from "./client/hub-icon";
 import { HubPopover } from "./client/hub-popover";
 import { ConfigSidebarItem, createHubSidebar } from "./client/hub-sidebar";
@@ -38,7 +37,6 @@ import {
   configStoreFromParams,
   HUB_SIDEBAR_ITEM_ID,
   loadHubSnapshot,
-  supportsScreens,
 } from "./client/sidebar-compat";
 import {
   type ComposerPillSettings,
@@ -112,29 +110,16 @@ async function loadAgents(paseo: PaseoApi): Promise<AgentEntry[]> {
 }
 
 /**
- * Paseo 0.11+: a param-addressable `config` screen (same id as the old sidebar item, so saved
- * links resolve to it), a header row that opens it, and a Hub status row. 0.9/0.10: the original
- * surface and static sidebar row, unchanged.
+ * A param-addressable `config` screen (same id as the old sidebar item, so saved links resolve to
+ * it), a header row that opens it, and a Hub status row.
  */
 export function registerConfigAndHub(
-  client: Pick<PluginClientContext, "addSurface" | "addSidebarItem" | "rpc" | "paseo">,
-  ConfigSurface: ComponentType<PluginSurfaceProps>,
+  client: Pick<
+    PluginClientContext,
+    "addScreen" | "addSidebarHeaderItem" | "openScreen" | "rpc" | "paseo"
+  >,
   onComposerPillSettingsChange: (settings: ComposerPillSettings) => void,
 ): () => void {
-  if (!supportsScreens(client)) {
-    const removeSurface = client.addSurface(CONFIG_SCREEN_ID, ConfigSurface);
-    const removeItem = client.addSidebarItem({
-      id: CONFIG_SCREEN_ID,
-      title: "OMP",
-      icon: "Settings",
-      surface: CONFIG_SCREEN_ID,
-    });
-    return () => {
-      removeItem();
-      removeSurface();
-    };
-  }
-  const screens = client;
   function ConfigScreen(props: PluginSurfaceProps & { params: Record<string, string> }) {
     const current = configStoreFromParams(props.params);
     return (
@@ -145,7 +130,7 @@ export function registerConfigAndHub(
         onStoreChange={(store) => {
           // Re-selecting the current store must not push a duplicate screen onto history.
           if (ompStoreKey(store) === ompStoreKey(current)) return;
-          screens.openScreen({ screenId: CONFIG_SCREEN_ID, params: configParamsFromStore(store) });
+          client.openScreen({ screenId: CONFIG_SCREEN_ID, params: configParamsFromStore(store) });
         }}
       />
     );
@@ -157,13 +142,13 @@ export function registerConfigAndHub(
     ),
   );
   const removers = [
-    screens.addScreen({ id: CONFIG_SCREEN_ID, title: configScreenTitle, Component: ConfigScreen }),
-    screens.addSidebarHeaderItem({
+    client.addScreen({ id: CONFIG_SCREEN_ID, title: configScreenTitle, Component: ConfigScreen }),
+    client.addSidebarHeaderItem({
       id: CONFIG_SCREEN_ID,
       title: "OMP",
       Component: ConfigSidebarItem,
     }),
-    screens.addSidebarHeaderItem({
+    client.addSidebarHeaderItem({
       id: HUB_SIDEBAR_ITEM_ID,
       title: "OMP Hub",
       Component: HubSidebarItem,
@@ -193,10 +178,6 @@ export default function contribute(client: PluginClientContext) {
     scheduleReconcile();
   }
 
-  function ConfigSurface(props: PluginSurfaceProps) {
-    return <OmpConfigSurface {...props} onComposerPillSettingsChange={applyComposerPillSettings} />;
-  }
-
   const removeMemoryPanel = client.addWorkspacePanel({
     id: "memory",
     title: "OMP Memory",
@@ -233,19 +214,15 @@ export default function contribute(client: PluginClientContext) {
       openPanel("workspace", { location: "workspace" });
     },
   });
-  const usesScreens = supportsScreens(client);
-  const removeConfigEntry = registerConfigAndHub(client, ConfigSurface, applyComposerPillSettings);
+  const removeConfigEntry = registerConfigAndHub(client, applyComposerPillSettings);
   const removeOpenConfig = client.addCommandCenterItem({
     id: "open-config",
     title: "Open OMP",
     icon: "Settings",
     keywords: ["omp", "config", "settings", "models", "providers", "composer", "pills"],
     context: "global",
-    onSelect(capabilities) {
-      // Branch on the same gate as registration: the screen exists only on the 0.11 path.
-      if (usesScreens && "openScreen" in capabilities) {
-        capabilities.openScreen({ screenId: CONFIG_SCREEN_ID });
-      } else capabilities.openSurface(CONFIG_SCREEN_ID);
+    onSelect({ openScreen }) {
+      openScreen({ screenId: CONFIG_SCREEN_ID });
     },
   });
   const removeImageRenderer = client.addTimelineRenderer({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@omercnet/paseo-omp",
-  "version": "1.3.3-next.238.1",
+  "version": "1.3.3-next.243.1",
   "type": "module",
   "description": "Paseo integration for OMP, including its direct provider and workspace tooling.",
   "license": "MIT",

package/paseo-plugin.json

@@ -1,6 +1,6 @@
 {
   "id": "paseo-omp",
   "description": "Paseo integration for OMP, including its direct provider and workspace tooling.",
-  "requirements": { "paseo": "^0.9.2 || ^0.10.0 || ^0.11.0" },
+  "requirements": { "paseo": "^0.11.0" },
   "build": [["node", "scripts/prepare-dependencies.mjs"]]
 }

package/server/package-version.ts

@@ -1,2 +1,2 @@
 /** Release Please keeps this bundle-safe constant aligned with package.json. */
-export const PASEO_OMP_PACKAGE_VERSION = "1.3.3-next.238.1"; // x-release-please-version
+export const PASEO_OMP_PACKAGE_VERSION = "1.3.3-next.243.1"; // x-release-please-version

package/server/provider/profile-providers.ts

@@ -7,7 +7,7 @@ import { ompAgentDir, ompCacheDir, ompDataDir, ompSessionDir, ompStateDir } from
 import { OmpRpcRuntime, type OmpRuntime } from "./omp-rpc";
 import type { OmpStartOptions } from "./omp-rpc-environment";
 import { parseOmpProviderOptions } from "./provider-options";
-import { createOmpProvider, type OmpProviderOptions } from "./registration";
+import { createOmpProvider, createOmpStatus, type OmpProviderOptions } from "./registration";
 import { OmpPublicError } from "./security";
 
 const MAX_PROFILES = 128;
@@ -229,6 +229,18 @@ export function createProfileOmpProvider(profile: string, options: OmpProviderOp
       sessionDir,
     );
   };
+  const checkAvailability = async (
+    input: Parameters<NonNullable<typeof provider.checkAvailability>>[0],
+    context?: Parameters<NonNullable<typeof provider.checkAvailability>>[1],
+  ) => {
+    const command = validateCatalog(input);
+    if (!provider.checkAvailability)
+      throw new OmpPublicError("OMP availability probe is unavailable");
+    return provider.checkAvailability(
+      { ...input, providerOptions: { ...input.providerOptions, command } },
+      context,
+    );
+  };
   return {
     ...provider,
     async getCatalogCacheKey(
@@ -237,18 +249,8 @@ export function createProfileOmpProvider(profile: string, options: OmpProviderOp
       validateCatalog(input);
       return provider.getCatalogCacheKey?.(input);
     },
-    async checkAvailability(
-      input: Parameters<NonNullable<typeof provider.checkAvailability>>[0],
-      context?: Parameters<NonNullable<typeof provider.checkAvailability>>[1],
-    ) {
-      const command = validateCatalog(input);
-      if (!provider.checkAvailability)
-        throw new OmpPublicError("OMP availability probe is unavailable");
-      return provider.checkAvailability(
-        { ...input, providerOptions: { ...input.providerOptions, command } },
-        context,
-      );
-    },
+    checkAvailability,
+    status: createOmpStatus(() => checkAvailability({ scope: "global" })),
     id,
     label: `OMP · ${profile}`,
   };

package/server/provider/registration.ts

@@ -1,6 +1,6 @@
 import { createHash } from "node:crypto";
 import { homedir } from "node:os";
-import type { ProviderRegistration } from "@getpaseo/plugin/server/provider";
+import type { ProviderRegistration, ProviderStatus } from "@getpaseo/plugin/server/provider";
 import { z } from "zod";
 import type { OmpBrowserAuthorizationRegistry } from "../mcp-browser";
 import type { OmpOperationalFailureReporter } from "../operational-failure-diagnostics";
@@ -41,6 +41,57 @@ type ProviderRegistrationCompat = Omit<
   ): Promise<ProviderAvailabilityCompat>;
 };
 
+const STATUS_CACHE_TTL_MS = 30_000;
+
+/**
+ * The 0.11 host calls `status` before every create, resume, and draft request and passes only
+ * the daemon-resolved launch, never per-agent `providerOptions`. Only a missing executable is
+ * definitive for the plugin-owned default launch; slow, failing, or unrecognized probes stay
+ * available with a diagnostic so load or a differently launched agent is never refused.
+ */
+function toProviderStatus(availability: ProviderAvailabilityCompat): ProviderStatus {
+  if (availability.status === "available") return { available: true };
+  if (availability.status === "missing") {
+    return {
+      available: false,
+      diagnostic: availability.diagnostic ?? "OMP executable was not found",
+    };
+  }
+  return {
+    available: true,
+    diagnostic: availability.diagnostic ?? `OMP launch probe reported ${availability.status}`,
+  };
+}
+
+/**
+ * Share one bounded probe across the host's frequent status calls. Only an available result is
+ * kept for the interval; an unavailable or failed result is shared by in-flight callers and then
+ * dropped, so installing the executable is picked up by the very next host call.
+ */
+export function createOmpStatus(
+  probe: () => Promise<ProviderAvailabilityCompat>,
+): () => Promise<ProviderStatus> {
+  let cached: { expiresAt: number; result: Promise<ProviderStatus> } | undefined;
+  return () => {
+    const now = Date.now();
+    if (cached && cached.expiresAt > now) return cached.result;
+    const entry = {
+      expiresAt: now + STATUS_CACHE_TTL_MS,
+      result: probe().then(toProviderStatus),
+    };
+    cached = entry;
+    entry.result.then(
+      (status) => {
+        if (!status.available && cached === entry) cached = undefined;
+      },
+      () => {
+        if (cached === entry) cached = undefined;
+      },
+    );
+    return entry.result;
+  };
+}
+
 const CAPABILITIES = [
   "prompt.message",
   "prompt.command",
@@ -98,6 +149,26 @@ export function createOmpProvider(options: OmpProviderOptions = {}): ProviderReg
       reportProtocolViolation: options.reportProtocolViolation,
     });
   const nativeReservations = new OmpNativeSessionReservations();
+  const checkAvailability: NonNullable<ProviderRegistrationCompat["checkAvailability"]> = async (
+    catalogOptions,
+    context,
+  ) => {
+    if (options.availabilityProbe) {
+      return await options.availabilityProbe(catalogOptions, context?.timeoutMs);
+    }
+    const providerOptions = parseOmpProviderOptions(catalogOptions.providerOptions);
+    const environment = { ...(options.environment ?? process.env), ...providerOptions.env };
+    const configuredCommand: readonly [string, ...string[]] = providerOptions.command?.[0]
+      ? [providerOptions.command[0], ...providerOptions.command.slice(1)]
+      : [environment.OMP_COMMAND || "omp"];
+    return await probeOmpAvailability({
+      command: configuredCommand,
+      cwd:
+        catalogOptions.scope === "workspace" && catalogOptions.cwd ? catalogOptions.cwd : homedir(),
+      environment,
+      timeoutMs: context?.timeoutMs,
+    });
+  };
   return {
     id: "omp-plugin",
     label: "OMP Plugin",
@@ -130,25 +201,8 @@ export function createOmpProvider(options: OmpProviderOptions = {}): ProviderReg
       }
       return createHash("sha256").update(stableJson(identity)).digest("base64url");
     },
-    async checkAvailability(catalogOptions, context) {
-      if (options.availabilityProbe) {
-        return await options.availabilityProbe(catalogOptions, context?.timeoutMs);
-      }
-      const providerOptions = parseOmpProviderOptions(catalogOptions.providerOptions);
-      const environment = { ...(options.environment ?? process.env), ...providerOptions.env };
-      const configuredCommand: readonly [string, ...string[]] = providerOptions.command?.[0]
-        ? [providerOptions.command[0], ...providerOptions.command.slice(1)]
-        : [environment.OMP_COMMAND || "omp"];
-      return await probeOmpAvailability({
-        command: configuredCommand,
-        cwd:
-          catalogOptions.scope === "workspace" && catalogOptions.cwd
-            ? catalogOptions.cwd
-            : homedir(),
-        environment,
-        timeoutMs: context?.timeoutMs,
-      });
-    },
+    checkAvailability,
+    status: createOmpStatus(() => checkAvailability({ scope: "global" })),
     async connect(request) {
       if (boundedJsonBytes(request, 8 * 1024, 32, 256, 64) === Number.POSITIVE_INFINITY) {
         throw new Error("OMP provider received an oversized connection request");