@omercnet/paseo-omp 1.1.0 → 1.2.0

package/README.md

@@ -24,7 +24,7 @@ before capture.
 
 ## Quick start
 
-Requirements: Paseo `^0.9.2 || ^0.10.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.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.
 
 ```bash
 paseo plugin install npm:@omercnet/paseo-omp@<version>
@@ -54,9 +54,13 @@ Profile selection is request-local: concurrent clients cannot change each other'
 
 ## Paseo provider SDK coverage
 
-This matrix inventories the complete capability set exported by the pinned `@getpaseo/plugin` 0.10.1 provider SDK, whose public provider surface is unchanged since 0.9.0; compatibility is checked nightly against the 0.9, 0.10, and latest SDK channels. It measures strict SDK surface coverage, not general product quality.
+The capability inventory is pinned to `@getpaseo/plugin` 0.11.0-beta.3 (PR #251), with nightly
+compatibility checks against supported 0.9 and 0.10 hosts. Provider capability scoring still 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.
 
-**Current capability completeness: 61.8%.** The provider advertises 11 of 17 capabilities (64.7%); ten are complete and `session.configure` is partial.
+**Provider capability completeness: 61.8%.** The provider advertises 11 of 17 capabilities (64.7%); ten are complete and `session.configure` is partial.
 
 Scoring is deliberately mechanical so releases remain comparable:
 
@@ -91,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 | **100%** | Bounded checks distinguish missing, unrunnable, incompatible, and available OMP runtimes. |
+| Availability diagnostics | **50%** | The plugin implements a `checkAvailability` hook with bounded checks that distinguish missing, unrunnable, incompatible, and available OMP runtimes, but no released daemon calls it (no upstream reference at v0.10.2 or v0.11.0-beta.3). Hosts treat the provider as available when a connection opens, and launch failures surface at session start. |
 | 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. |
@@ -101,6 +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 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:
 

package/client/hub-popover.tsx

@@ -1,4 +1,9 @@
-import { type PluginButtonContentProps, useAgent, useRpc } from "@getpaseo/plugin/client";
+import {
+  type PluginButtonContentProps,
+  type PluginHostProps,
+  useAgent,
+  useRpc,
+} from "@getpaseo/plugin/client";
 import { useQuery } from "@tanstack/react-query";
 import { useMemo, useState } from "react";
 import { Pressable, Text, View } from "react-native";
@@ -34,16 +39,31 @@ function toneColor(
 }
 
 export function HubPopover(props: PluginButtonContentProps) {
-  const { theme, layout } = props;
   const agentId = props.context === "agent" ? props.agentId : "";
   const cwd = useAgent(agentId, (agent) => agent.cwd) ?? "";
+  return <HubProcessList theme={props.theme} layout={props.layout} cwd={cwd} />;
+}
+
+/**
+ * Process cards with a per-process log tail, for one workspace directory. Pass `processes` when
+ * the caller already polls them; the list then skips its own process query.
+ */
+export function HubProcessList({
+  theme,
+  layout,
+  cwd,
+  processes: provided,
+}: Pick<PluginHostProps, "theme" | "layout"> & {
+  cwd: string;
+  processes?: readonly HubProcess[];
+}) {
   const loadProcesses = useRpc(listHubProcesses);
   const loadLog = useRpc(tailHubLog);
   const [selectedName, setSelectedName] = useState<string | null>(null);
   const processes = useQuery({
     queryKey: ["paseo-omp", "processes", cwd],
     queryFn: () => loadProcesses({ cwd }),
-    enabled: cwd.length > 0,
+    enabled: cwd.length > 0 && provided === undefined,
     refetchInterval: PROCESS_POLL_MS,
   });
   const log = useQuery({
@@ -80,9 +100,13 @@ export function HubPopover(props: PluginButtonContentProps) {
     [layout.compact, theme],
   );
 
-  if (processes.isLoading) return <Text style={styles.muted}>Loading hub processes…</Text>;
-  if (processes.error) return <Text style={styles.error}>Could not read omp hub state.</Text>;
-  const items = processes.data?.processes ?? [];
+  if (!provided && processes.isLoading) {
+    return <Text style={styles.muted}>Loading hub processes…</Text>;
+  }
+  if (!provided && processes.error) {
+    return <Text style={styles.error}>Could not read omp hub state.</Text>;
+  }
+  const items = provided ?? processes.data?.processes ?? [];
   if (items.length === 0) return <Text style={styles.muted}>No hub-supervised processes.</Text>;
 
   return (

package/client/hub-sidebar.tsx

@@ -0,0 +1,135 @@
+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 { 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";
+
+// The row is always mounted; a slower poll bounds per-client RPC fan-out across workspaces.
+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;
+  return (
+    <SidebarRow
+      icon="Settings"
+      label="OMP"
+      active={currentScreen?.screenId === CONFIG_SCREEN_ID}
+      onPress={() => openScreen({ screenId: CONFIG_SCREEN_ID })}
+    />
+  );
+}
+
+export function createHubSidebar(loadSnapshot: () => Promise<HubSnapshot>) {
+  const useHubSnapshot = () =>
+    useQuery({
+      queryKey: HUB_SIDEBAR_QUERY_KEY,
+      queryFn: loadSnapshot,
+      refetchInterval: HUB_POLL_MS,
+    });
+
+  function HubSidebarPopover({ theme, layout }: PopoverProps) {
+    const snapshot = useHubSnapshot();
+    const muted = { color: theme.colors.foregroundMuted, fontSize: 13 };
+    if (snapshot.isLoading) return <Text style={muted}>Loading hub processes…</Text>;
+    if (!snapshot.data) {
+      return (
+        <Text style={{ color: theme.colors.statusDanger, fontSize: 13 }}>
+          Could not read omp hub state.
+        </Text>
+      );
+    }
+    const active = snapshot.data.workspaces.filter(({ processes }) => processes.length > 0);
+    const notes = [
+      snapshot.data.unreadable > 0
+        ? `${snapshot.data.unreadable} workspace(s) could not be read.`
+        : undefined,
+      snapshot.data.truncated ? "Showing the first 50 workspaces." : undefined,
+    ].filter(Boolean);
+    return (
+      <View style={{ gap: layout.compact ? 12 : 14 }}>
+        {notes.map((note) => (
+          <Text key={note} style={{ ...muted, fontSize: 12 }}>
+            {note}
+          </Text>
+        ))}
+        {active.length === 0 ? <Text style={muted}>No hub-supervised processes.</Text> : null}
+        {active.map(({ cwd, processes }) => (
+          <View key={cwd} style={{ gap: 6 }}>
+            <Text numberOfLines={1} style={{ ...muted, fontSize: 12 }}>
+              {cwd}
+            </Text>
+            <HubProcessList theme={theme} layout={layout} cwd={cwd} processes={processes} />
+          </View>
+        ))}
+      </View>
+    );
+  }
+
+  function HubSidebarItem({ theme, openPopover }: SidebarItemProps) {
+    const snapshot = useHubSnapshot();
+    if (!SidebarRow) return null;
+    const state = hubTrailing(snapshot.data, snapshot.error !== null);
+    const trailing = state ? (
+      <View
+        accessibilityLabel={state.accessibilityLabel}
+        style={{ flexDirection: "row", alignItems: "center", gap: 6 }}
+      >
+        {state.running ? (
+          <Text style={{ color: theme.colors.foregroundMuted, fontSize: 12 }}>{state.running}</Text>
+        ) : null}
+        {state.failed || state.unreadable ? (
+          <Text style={{ color: theme.colors.statusDanger, fontSize: 12, fontWeight: "600" }}>
+            {[state.failed, state.unreadable ? "!" : undefined].filter(Boolean).join(" ")}
+          </Text>
+        ) : null}
+      </View>
+    ) : undefined;
+    return (
+      <SidebarRow
+        icon="Activity"
+        label="OMP Hub"
+        trailing={trailing}
+        onPress={() => openPopover(HubSidebarPopover)}
+      />
+    );
+  }
+
+  return { HubSidebarItem, HubSidebarPopover };
+}

package/client/memory-panel.tsx

@@ -23,7 +23,7 @@ export function OmpMemoryPanel({ theme, layout, workspaceId }: PluginWorkspacePa
   const styles = useMemo(
     () => ({
       root: {
-        flex: 1,
+        flexGrow: 1,
         gap: layout.compact ? 10 : 14,
         padding: layout.compact ? 16 : 24,
         backgroundColor: theme.colors.surface0,

package/client/omp-config-styles.ts

@@ -70,7 +70,7 @@ export function useConfigStyles(
   return useMemo(
     () => ({
       root: {
-        flex: 1,
+        flexGrow: 1,
         gap: compact ? 10 : 14,
         padding: compact ? 16 : 24,
         backgroundColor: theme.colors.surface0,

package/client/omp-config-surface.tsx

@@ -914,11 +914,14 @@ function OmpConfigContent({
   cwd,
   store,
   onStoreChange,
+  storeInHistory = false,
   onComposerPillSettingsChange,
 }: PluginSurfaceProps & {
   cwd?: string;
   store?: OmpStore;
   onStoreChange(store: OmpStore | undefined): void;
+  /** True when each store selection is a separate history entry (0.11 screen params). */
+  storeInHistory?: boolean;
   onComposerPillSettingsChange?: (settings: ComposerPillSettings) => void;
 }) {
   const loadConfig = useRpc(listOmpConfig);
@@ -1074,7 +1077,9 @@ function OmpConfigContent({
             disabled={pendingMutations > 0}
           />
           <Text style={styles.muted}>
-            Switching stores clears unapplied edits and pending confirmations.
+            {storeInHistory
+              ? "Each store opens as its own page; unapplied edits stay with the previous store, and Back returns to them."
+              : "Switching stores clears unapplied edits and pending confirmations."}
           </Text>
         </>
       ) : null}
@@ -1339,9 +1344,14 @@ function OmpStoreContent(
   props: PluginSurfaceProps & {
     cwd?: string;
     onComposerPillSettingsChange?: (settings: ComposerPillSettings) => void;
+    /** Controlled selection (0.11 screen params); omitted, the surface keeps local state. */
+    store?: OmpStore;
+    onStoreChange?: (store: OmpStore | undefined) => void;
   },
 ) {
-  const [store, setStore] = useState<OmpStore>();
+  const [localStore, setLocalStore] = useState<OmpStore>();
+  const controlled = props.onStoreChange !== undefined;
+  const store = controlled ? props.store : localStore;
   // Remount every editor when its target changes: drafts, confirmations, and mutation notices
   // belong to one store/workspace and must never be applied to the next selection.
   return (
@@ -1349,7 +1359,8 @@ function OmpStoreContent(
       key={`${ompStoreKey(store)}:${props.cwd ?? "global"}`}
       {...props}
       store={store}
-      onStoreChange={setStore}
+      onStoreChange={props.onStoreChange ?? setLocalStore}
+      storeInHistory={controlled}
     />
   );
 }
@@ -1357,6 +1368,8 @@ function OmpStoreContent(
 export function OmpConfigSurface(
   props: PluginSurfaceProps & {
     onComposerPillSettingsChange: (settings: ComposerPillSettings) => void;
+    store?: OmpStore;
+    onStoreChange?: (store: OmpStore | undefined) => void;
   },
 ) {
   return <OmpStoreContent {...props} />;

package/client/sidebar-compat.ts

@@ -0,0 +1,160 @@
+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. */
+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();
+  return profile && isOmpProfileName(profile) ? { profile } : undefined;
+}
+
+export function configParamsFromStore(store: OmpStore | undefined): Record<string, string> {
+  return store?.profile ? { profile: store.profile } : {};
+}
+
+export function configScreenTitle(params: ScreenParams): string {
+  const store = configStoreFromParams(params);
+  return store?.profile ? `OMP · ${store.profile}` : "OMP";
+}
+
+export interface HubWorkspaceProcesses {
+  cwd: string;
+  processes: readonly HubProcess[];
+}
+
+export interface HubSidebarSummary {
+  running: number;
+  failed: number;
+  total: number;
+}
+
+export function summarizeHubWorkspaces(
+  workspaces: readonly HubWorkspaceProcesses[],
+): HubSidebarSummary {
+  const summary: HubSidebarSummary = { running: 0, failed: 0, total: 0 };
+  for (const { processes } of workspaces) {
+    for (const process of processes) {
+      summary.total += 1;
+      const tone = hubProcessTone(process);
+      if (tone === "success") summary.running += 1;
+      else if (tone === "danger") summary.failed += 1;
+    }
+  }
+  return summary;
+}
+
+/** Distinct, non-empty workspace directories in first-seen order, bounded for polling cost. */
+export function workspaceDirectories(
+  workspaces: ReadonlyArray<{ workspaceDirectory?: string; projectRootPath: string }>,
+  limit = 50,
+): { directories: string[]; truncated: boolean } {
+  const directories = new Set<string>();
+  for (const workspace of workspaces) {
+    const directory = workspace.workspaceDirectory || workspace.projectRootPath;
+    if (!directory || directories.has(directory)) continue;
+    if (directories.size >= limit) return { directories: [...directories], truncated: true };
+    directories.add(directory);
+  }
+  return { directories: [...directories], truncated: false };
+}
+
+export interface HubSnapshot {
+  workspaces: HubWorkspaceProcesses[];
+  /** More workspaces exist than were polled; counts are a lower bound. */
+  truncated: boolean;
+  /** Workspaces whose hub state could not be read this poll. */
+  unreadable: number;
+}
+
+/**
+ * One poll of hub state. A failing workspace never hides the others; the poll fails only when
+ * the workspace list itself fails or every workspace is unreadable.
+ */
+export async function loadHubSnapshot(
+  listWorkspaces: () => Promise<{
+    entries: ReadonlyArray<{ workspaceDirectory?: string; projectRootPath: string }>;
+    pageInfo?: { hasMore?: boolean };
+  }>,
+  listProcesses: (cwd: string) => Promise<readonly HubProcess[]>,
+): Promise<HubSnapshot> {
+  const page = await listWorkspaces();
+  const { directories, truncated } = workspaceDirectories(page.entries);
+  const results = await Promise.allSettled(
+    directories.map(async (cwd) => ({ cwd, processes: await listProcesses(cwd) })),
+  );
+  const workspaces: HubWorkspaceProcesses[] = [];
+  for (const result of results) if (result.status === "fulfilled") workspaces.push(result.value);
+  if (directories.length > 0 && workspaces.length === 0) {
+    throw new Error("OMP hub state is unreadable");
+  }
+  return {
+    workspaces,
+    truncated: truncated || page.pageInfo?.hasMore === true,
+    unreadable: directories.length - workspaces.length,
+  };
+}
+
+export interface HubTrailing {
+  running?: string;
+  failed?: string;
+  /** Some or all hub state could not be read. */
+  unreadable: boolean;
+  accessibilityLabel: string;
+}
+
+/** What the Hub row's trailing slot shows; null when there is nothing to report. */
+export function hubTrailing(
+  snapshot: HubSnapshot | undefined,
+  loadFailed: boolean,
+): HubTrailing | null {
+  const summary = summarizeHubWorkspaces(snapshot?.workspaces ?? []);
+  const atLeast = snapshot?.truncated ? "+" : "";
+  const unreadable = loadFailed || (snapshot?.unreadable ?? 0) > 0;
+  if (summary.total === 0 && !unreadable) return null;
+  const running = summary.total > 0 ? `${summary.running}${atLeast} running` : undefined;
+  const failed = summary.failed > 0 ? `${summary.failed}${atLeast} failed` : undefined;
+  return {
+    ...(running ? { running } : {}),
+    ...(failed ? { failed } : {}),
+    unreadable,
+    accessibilityLabel: [running, failed, unreadable ? "some hub state unreadable" : undefined]
+      .filter(Boolean)
+      .join(", "),
+  };
+}

package/index.client.tsx

@@ -4,8 +4,10 @@ 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";
 import { summarizeHubProcesses } from "./client/hub-status";
 import { OmpMcpAuthorizationCard } from "./client/mcp-authorization";
 import { McpPopover } from "./client/mcp-popover";
@@ -29,6 +31,15 @@ import {
   quotaSummaryForProvider,
 } from "./client/quota-state";
 import { SessionsPopover } from "./client/sessions-popover";
+import {
+  CONFIG_SCREEN_ID,
+  configParamsFromStore,
+  configScreenTitle,
+  configStoreFromParams,
+  HUB_SIDEBAR_ITEM_ID,
+  loadHubSnapshot,
+  supportsScreens,
+} from "./client/sidebar-compat";
 import {
   type ComposerPillSettings,
   composerPillSettings,
@@ -100,6 +111,69 @@ async function loadAgents(paseo: PaseoApi): Promise<AgentEntry[]> {
   return entries;
 }
 
+/**
+ * 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.
+ */
+export function registerConfigAndHub(
+  client: Pick<PluginClientContext, "addSurface" | "addSidebarItem" | "rpc" | "paseo">,
+  ConfigSurface: ComponentType<PluginSurfaceProps>,
+  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 (
+      <OmpConfigSurface
+        {...props}
+        onComposerPillSettingsChange={onComposerPillSettingsChange}
+        store={current}
+        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) });
+        }}
+      />
+    );
+  }
+  const { HubSidebarItem } = createHubSidebar(() =>
+    loadHubSnapshot(
+      () => client.paseo.workspaces.list({ page: { limit: 200 } }),
+      async (cwd) => (await client.rpc(listHubProcesses, { cwd })).processes,
+    ),
+  );
+  const removers = [
+    screens.addScreen({ id: CONFIG_SCREEN_ID, title: configScreenTitle, Component: ConfigScreen }),
+    screens.addSidebarHeaderItem({
+      id: CONFIG_SCREEN_ID,
+      title: "OMP",
+      Component: ConfigSidebarItem,
+    }),
+    screens.addSidebarHeaderItem({
+      id: HUB_SIDEBAR_ITEM_ID,
+      title: "OMP Hub",
+      Component: HubSidebarItem,
+    }),
+  ];
+  return () => {
+    for (const remove of removers.reverse()) remove();
+  };
+}
+
 export default function contribute(client: PluginClientContext) {
   const pills = new Map<string, PillEntry>();
   let preferences: ComposerPillSettings | undefined;
@@ -159,21 +233,19 @@ export default function contribute(client: PluginClientContext) {
       openPanel("workspace", { location: "workspace" });
     },
   });
-  const removeConfigSurface = client.addSurface("config", ConfigSurface);
-  const removeConfigSidebarItem = client.addSidebarItem({
-    id: "config",
-    title: "OMP",
-    icon: "Settings",
-    surface: "config",
-  });
+  const usesScreens = supportsScreens(client);
+  const removeConfigEntry = registerConfigAndHub(client, ConfigSurface, applyComposerPillSettings);
   const removeOpenConfig = client.addCommandCenterItem({
     id: "open-config",
     title: "Open OMP",
     icon: "Settings",
     keywords: ["omp", "config", "settings", "models", "providers", "composer", "pills"],
     context: "global",
-    onSelect({ openSurface }) {
-      openSurface("config");
+    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);
     },
   });
   const removeImageRenderer = client.addTimelineRenderer({
@@ -497,8 +569,7 @@ export default function contribute(client: PluginClientContext) {
     removeMcpAuthorizationRenderer();
     removeImageTransformer();
     removeOpenConfig();
-    removeConfigSidebarItem();
-    removeConfigSurface();
+    removeConfigEntry();
     removeOpenWorkspace();
     removeWorkspacePanel();
     removeOpenMemory();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@omercnet/paseo-omp",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "type": "module",
   "description": "Paseo integration for OMP, including its direct provider and workspace tooling.",
   "license": "MIT",
@@ -51,16 +51,16 @@
     "typecheck": "tsc --noEmit -p tsconfig.client.json && tsc --noEmit -p tsconfig.server.json && tsc --noEmit -p tsconfig.tests.json"
   },
   "dependencies": {
-    "@getpaseo/protocol": "0.10.1",
+    "@getpaseo/protocol": "0.11.0-beta.3",
     "@modelcontextprotocol/sdk": "1.30.0",
     "yaml": "^2.9.0"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.5.10",
-    "@getpaseo/cli": "0.10.1",
-    "@getpaseo/client": "0.10.1",
-    "@getpaseo/plugin": "0.10.1",
-    "@getpaseo/server": "0.10.1",
+    "@getpaseo/cli": "0.11.0-beta.3",
+    "@getpaseo/client": "0.11.0-beta.3",
+    "@getpaseo/plugin": "0.11.0-beta.3",
+    "@getpaseo/server": "0.11.0-beta.3",
     "@oh-my-pi/pi-agent-core": "18.2.0",
     "@oh-my-pi/pi-coding-agent": "18.2.0",
     "@tanstack/react-query": "^5.102.3",

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" },
+  "requirements": { "paseo": "^0.9.2 || ^0.10.0 || ^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.1.0"; // x-release-please-version
+export const PASEO_OMP_PACKAGE_VERSION = "1.2.0"; // x-release-please-version