@omercnet/paseo-context-mode 1.1.0 → 1.2.0

package/README.md

@@ -32,7 +32,9 @@ These previews were captured from an isolated Paseo test daemon with Context Mod
 - Provides provider- and project-scoped knowledge search, local-path indexing, URL fetch/index, indexed-source visibility, and an Insight link.
 - Requires an explicit provider, project path, scope review, and second confirmation before purge. Purge remains delegated to Context Mode's own MCP contract.
 - Returns structured install and provider-specific upgrade argv for review; Paseo never executes those commands automatically.
-- Adds a per-agent composer shortcut to the Context Mode surface.
+- On Paseo 0.11, registers the `context-mode` screen with URL-persisted `section`, `agentId`, and `workspaceId` params. Composer pills open Knowledge using the selected host's agent provider and working directory. URL params never carry paths or queries.
+- Custom or named providers that do not exactly match a Knowledge RPC provider require explicit provider selection. Missing agents or mismatched workspaces also require explicit scope selection.
+- Adds a live Healthy/Failing sidebar footer row on Paseo 0.11, reusing the screen's health data. Paseo 0.9/0.10 retain the static sidebar, Savings surface, and unscoped composer shortcut.
 
 Context Mode currently couples sessions, stats, and indexed content under `CONTEXT_MODE_DIR`. Until upstream supports separate session and content roots, this plugin keeps storage provider-scoped instead of risking cross-provider session contamination.
 

package/client/context-mode-footer.tsx

@@ -0,0 +1,54 @@
+import { type PluginSidebarItemProps, useRpc, useSettings } from "@getpaseo/plugin/client";
+import { SidebarRow } from "@getpaseo/plugin/client/ui";
+import { useQuery } from "@tanstack/react-query";
+import { Text } from "react-native";
+import { contextModeSettings, getContextModeStatus } from "../shared";
+
+// The footer stays mounted all session; poll slowly because each status miss spawns the binary.
+const FOOTER_REFRESH_MS = 60_000;
+
+export function ContextModeFooter({
+  theme,
+  host,
+  currentScreen,
+  openScreen,
+}: PluginSidebarItemProps) {
+  const settings = useSettings(contextModeSettings);
+  const loadStatus = useRpc(getContextModeStatus);
+  const status = useQuery({
+    queryKey: ["context-mode", host.id, "status"],
+    queryFn: () => loadStatus({ fresh: false }),
+    refetchInterval: FOOTER_REFRESH_MS,
+    staleTime: FOOTER_REFRESH_MS,
+    enabled: settings.status === "ready",
+  });
+  const failing =
+    settings.status === "error" ||
+    settings.status === "invalid" ||
+    Boolean(status.error) ||
+    (status.data && status.data.state !== "ready");
+  const healthy = settings.status === "ready" && !failing && status.data?.state === "ready";
+  const label = failing ? "Failing" : healthy ? "Healthy" : "Checking";
+  return (
+    <SidebarRow
+      icon="Gauge"
+      label="Context Mode"
+      active={currentScreen?.screenId === "context-mode"}
+      onPress={() => openScreen({ screenId: "context-mode" })}
+      trailing={
+        <Text
+          style={{
+            color: failing
+              ? theme.colors.statusDanger
+              : healthy
+                ? theme.colors.statusSuccess
+                : theme.colors.foregroundMuted,
+            fontSize: 12,
+          }}
+        >
+          {label}
+        </Text>
+      }
+    />
+  );
+}

package/client/context-mode-pill.tsx

@@ -50,7 +50,14 @@ export function contributeContextModeComposerPills(client: PluginClientContext):
         behavior: {
           kind: "action",
           onPress() {
-            client.openSurface("context-mode");
+            if (typeof client.addScreen === "function" && typeof client.openScreen === "function") {
+              client.openScreen({
+                screenId: "context-mode",
+                params: { section: "knowledge", agentId: agent.id, workspaceId: agent.workspaceId },
+              });
+            } else {
+              client.openSurface("context-mode");
+            }
           },
         },
       },

package/client/context-mode-surface.tsx

@@ -1,7 +1,7 @@
 import { type PluginSurfaceProps, useRpc, useSettings } from "@getpaseo/plugin/client";
 import { Icon } from "@getpaseo/plugin/client/react-native";
 import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
-import { useMemo, useState } from "react";
+import { useEffect, useMemo, useState } from "react";
 import { ActivityIndicator, Pressable, ScrollView, Text, View } from "react-native";
 import {
   type BinaryStatus,
@@ -14,9 +14,12 @@ import {
 import { ActionsSection } from "./actions-section";
 import { AnalyticsDashboard } from "./analytics-dashboard";
 import { KnowledgeSection } from "./knowledge-section";
+import { ScopedKnowledgeSection } from "./scoped-knowledge-section";
+import { parseScreenParams, type SurfaceTab } from "./screen-scope";
 
 interface ContextModeSurfaceProps extends PluginSurfaceProps {
   onOpenSettings(): void;
+  params?: Record<string, string>;
 }
 
 function statusLabel(status: BinaryStatus): string {
@@ -26,8 +29,6 @@ function statusLabel(status: BinaryStatus): string {
   return "Unavailable";
 }
 
-type SurfaceTab = "savings" | "knowledge" | "setup";
-
 const SURFACE_TABS: ReadonlyArray<{ id: SurfaceTab; label: string }> = [
   { id: "savings", label: "Savings" },
   { id: "knowledge", label: "Knowledge" },
@@ -39,13 +40,19 @@ export function ContextModeSurface({
   host,
   layout,
   onOpenSettings,
+  params,
 }: ContextModeSurfaceProps) {
   const settings = useSettings(contextModeSettings);
   const loadStatus = useRpc(getContextModeStatus);
   const loadStats = useRpc(getContextModeStats);
   const loadIntegrationAudit = useRpc(getContextModeIntegrationAudit);
   const queryClient = useQueryClient();
-  const [activeTab, setActiveTab] = useState<SurfaceTab>("savings");
+  const screenParams = parseScreenParams(params ?? {});
+  const [activeTab, setActiveTab] = useState<SurfaceTab>(screenParams.section);
+  useEffect(
+    () => setActiveTab(screenParams.section),
+    [screenParams.section, screenParams.agentId, screenParams.workspaceId],
+  );
   const readySettings = settings.status === "ready" ? settings : null;
   const refreshInterval = readySettings?.values.refreshIntervalMs ?? 15_000;
   const statusKey = ["context-mode", host.id, "status"] as const;
@@ -273,7 +280,17 @@ export function ContextModeSurface({
         />
       </View>
       <View style={[styles.tabPanel, activeTab === "knowledge" ? null : styles.tabPanelHidden]}>
-        <KnowledgeSection key={host.id} host={host} layout={layout} theme={theme} />
+        {activeTab !== "knowledge" ? null : screenParams.agentId || screenParams.workspaceId ? (
+          <ScopedKnowledgeSection
+            key={JSON.stringify([host.id, screenParams.agentId, screenParams.workspaceId])}
+            params={screenParams}
+            host={host}
+            layout={layout}
+            theme={theme}
+          />
+        ) : (
+          <KnowledgeSection key={host.id} host={host} layout={layout} theme={theme} />
+        )}
       </View>
       <View style={[styles.tabPanel, activeTab === "setup" ? null : styles.tabPanelHidden]}>
         <ActionsSection key={host.id} layout={layout} theme={theme} />

package/client/knowledge-section.tsx

@@ -20,6 +20,7 @@ import {
   purgeContextModeKnowledge,
   searchContextModeKnowledge,
 } from "../shared/knowledge";
+import type { KnowledgeScope } from "./screen-scope";
 
 const PROVIDERS = [
   { value: "claude", label: "Claude" },
@@ -35,7 +36,9 @@ const PROVIDERS = [
 const INSIGHT_URL = "https://context-mode.com/insight";
 type Provider = ContextModeProvider;
 type PurgeScope = "project" | "session";
-export type KnowledgeSectionProps = Pick<PluginSurfaceProps, "theme" | "layout" | "host">;
+export type KnowledgeSectionProps = Pick<PluginSurfaceProps, "theme" | "layout" | "host"> & {
+  initialScope?: KnowledgeScope;
+};
 
 interface KnowledgeStyles {
   section: ViewStyle;
@@ -235,7 +238,7 @@ function ResultPanel({
   );
 }
 
-export function KnowledgeSection({ theme, layout, host }: KnowledgeSectionProps) {
+export function KnowledgeSection({ theme, layout, host, initialScope }: KnowledgeSectionProps) {
   const styles = useMemo(() => createStyles(theme, layout.compact), [layout.compact, theme]);
   const searchKnowledge = useRpc(searchContextModeKnowledge);
   const indexPath = useRpc(indexContextModePath);
@@ -247,8 +250,10 @@ export function KnowledgeSection({ theme, layout, host }: KnowledgeSectionProps)
       queryKey: ["context-mode", host.id, "analytics-dashboard"],
     });
 
-  const [provider, setProvider] = useState<Provider | null>("claude");
-  const [projectPath, setProjectPath] = useState("");
+  const [provider, setProvider] = useState<Provider | null>(
+    initialScope ? initialScope.provider : "claude",
+  );
+  const [projectPath, setProjectPath] = useState(initialScope?.projectPath ?? "");
   const [query, setQuery] = useState("");
   const [searchSource, setSearchSource] = useState("");
   const [path, setPath] = useState("");
@@ -362,6 +367,7 @@ export function KnowledgeSection({ theme, layout, host }: KnowledgeSectionProps)
 
       <View style={styles.card}>
         <Text style={styles.fieldLabel}>Provider store</Text>
+        {initialScope?.note ? <Text style={styles.scopeNote}>{initialScope.note}</Text> : null}
         <View accessibilityRole="radiogroup" style={styles.choiceRow}>
           {PROVIDERS.map((option) => {
             const selected = provider === option.value;

package/client/scoped-knowledge-section.tsx

@@ -0,0 +1,48 @@
+import { type PluginSurfaceProps, usePaseo } from "@getpaseo/plugin/client";
+import { useQuery } from "@tanstack/react-query";
+import { Text, View } from "react-native";
+import { KnowledgeSection } from "./knowledge-section";
+import { resolveKnowledgeScope, type ScreenParams } from "./screen-scope";
+
+export function ScopedKnowledgeSection({
+  params,
+  ...props
+}: PluginSurfaceProps & { params: ScreenParams }) {
+  const paseo = usePaseo();
+  const scope = useQuery({
+    queryKey: [
+      "context-mode",
+      props.host.id,
+      "knowledge-scope",
+      params.agentId,
+      params.workspaceId,
+    ],
+    queryFn: () => resolveKnowledgeScope(paseo, params),
+    retry: false,
+  });
+  if (scope.isPending)
+    return (
+      <Text style={{ color: props.theme.colors.foregroundMuted }}>Resolving Knowledge scope…</Text>
+    );
+  if (scope.error)
+    return (
+      <View>
+        <Text accessibilityRole="alert" style={{ color: props.theme.colors.statusDanger }}>
+          {scope.error.message}
+        </Text>
+        <KnowledgeSection
+          key="scope-error"
+          {...props}
+          initialScope={{ provider: null, projectPath: "" }}
+        />
+      </View>
+    );
+  // Remount only when the resolved destination changes so stale form state never survives it.
+  return (
+    <KnowledgeSection
+      key={JSON.stringify([scope.data.provider, scope.data.projectPath])}
+      {...props}
+      initialScope={scope.data}
+    />
+  );
+}

package/client/screen-scope.ts

@@ -0,0 +1,61 @@
+import type { PaseoApi } from "@getpaseo/client";
+import { type ContextModeProvider, ContextModeProviderSchema } from "../shared/knowledge";
+
+export type SurfaceTab = "savings" | "knowledge" | "setup";
+export type KnowledgeScope = {
+  provider: ContextModeProvider | null;
+  projectPath: string;
+  note?: string;
+};
+
+export type ScreenParams = { section: SurfaceTab; agentId?: string; workspaceId?: string };
+export function parseScreenParams(params: Record<string, string>): ScreenParams {
+  const section: SurfaceTab =
+    params.section === "knowledge" || params.section === "setup" ? params.section : "savings";
+  return {
+    section,
+    agentId: params.agentId || undefined,
+    workspaceId: params.workspaceId || undefined,
+  };
+}
+
+export function knowledgeProvider(provider: string): ContextModeProvider | null {
+  const parsed = ContextModeProviderSchema.safeParse(provider);
+  return parsed.success ? parsed.data : null;
+}
+
+export async function resolveKnowledgeScope(
+  paseo: PaseoApi,
+  params: ScreenParams,
+): Promise<KnowledgeScope> {
+  if (params.agentId) {
+    const result = await paseo.agents.ref(params.agentId).refresh();
+    if (!result)
+      throw new Error("Agent not found on this host. Select a provider and project explicitly.");
+    if (params.workspaceId && result.agent.workspaceId !== params.workspaceId) {
+      throw new Error(
+        "Agent no longer belongs to this workspace. Select a provider and project explicitly.",
+      );
+    }
+    const provider = knowledgeProvider(result.agent.provider);
+    return {
+      provider,
+      projectPath: result.agent.cwd,
+      ...(!provider
+        ? {
+            note: `Provider ${result.agent.provider} cannot be mapped to a knowledge store. Select one explicitly.`,
+          }
+        : {}),
+    };
+  }
+  const workspace = params.workspaceId
+    ? await paseo.workspaces.ref(params.workspaceId).refresh()
+    : null;
+  if (!workspace)
+    throw new Error("Workspace not found on this host. Select a provider and project explicitly.");
+  return {
+    provider: null,
+    projectPath: workspace.workspaceDirectory,
+    note: "Select a provider store for this workspace.",
+  };
+}

package/index.client.tsx

@@ -1,4 +1,10 @@
-import type { PluginClientContext, PluginSurfaceProps } from "@getpaseo/plugin/client";
+import type {
+  PluginClientContext,
+  PluginScreenProps,
+  PluginSurfaceProps,
+} from "@getpaseo/plugin/client";
+import { SidebarRow } from "@getpaseo/plugin/client/ui";
+import { ContextModeFooter } from "./client/context-mode-footer";
 import { contributeContextModeComposerPills } from "./client/context-mode-pill";
 import { ContextModeSurface } from "./client/context-mode-surface";
 import { ContextModeSettingsScreen } from "./client/settings-screen";
@@ -9,6 +15,12 @@ export default function contribute(client: PluginClientContext) {
       <ContextModeSurface {...props} onOpenSettings={() => client.openSettings("context-mode")} />
     );
   }
+  function Screen(props: PluginScreenProps) {
+    return (
+      <ContextModeSurface {...props} onOpenSettings={() => client.openSettings("context-mode")} />
+    );
+  }
+  const screens = typeof client.addScreen === "function" && typeof client.openScreen === "function";
 
   const cleanups = [
     contributeContextModeComposerPills(client),
@@ -18,21 +30,44 @@ export default function contribute(client: PluginClientContext) {
       icon: "Settings",
       Component: ContextModeSettingsScreen,
     }),
-    client.addSurface("context-mode", Surface),
-    client.addSidebarItem({
-      id: "context-mode",
-      title: "Context Mode",
-      icon: "Gauge",
-      surface: "context-mode",
-    }),
+    ...(screens
+      ? [
+          client.addScreen({ id: "context-mode", title: "Context Mode", Component: Screen }),
+          ...(typeof client.addSidebarFooterItem === "function" && typeof SidebarRow === "function"
+            ? [
+                client.addSidebarFooterItem({
+                  id: "context-mode",
+                  title: "Context Mode",
+                  Component: ContextModeFooter,
+                }),
+              ]
+            : [
+                client.addSidebarItem({
+                  id: "context-mode",
+                  title: "Context Mode",
+                  icon: "Gauge",
+                  surface: "context-mode",
+                }),
+              ]),
+        ]
+      : [
+          client.addSurface("context-mode", Surface),
+          client.addSidebarItem({
+            id: "context-mode",
+            title: "Context Mode",
+            icon: "Gauge",
+            surface: "context-mode",
+          }),
+        ]),
     client.addCommandCenterItem({
       id: "open-context-mode",
       title: "Open Context Mode",
       icon: "Gauge",
       keywords: ["context", "savings", "tokens", "knowledge", "search", "doctor", "health"],
       context: "global",
-      onSelect({ openSurface }) {
-        openSurface("context-mode");
+      onSelect({ openSurface, openScreen }) {
+        if (screens && typeof openScreen === "function") openScreen({ screenId: "context-mode" });
+        else openSurface("context-mode");
       },
     }),
   ];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@omercnet/paseo-context-mode",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "type": "module",
   "description": "Provider-aware Context Mode health, savings, and MCP activation for Paseo.",
   "license": "MIT",
@@ -50,10 +50,10 @@
   },
   "devDependencies": {
     "@biomejs/biome": "^2.5.10",
-    "@getpaseo/cli": "0.10.1",
-    "@getpaseo/client": "0.10.1",
-    "@getpaseo/plugin": "0.10.1",
-    "@getpaseo/protocol": "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/protocol": "0.11.0-beta.3",
     "@tanstack/react-query": "^5.102.3",
     "@types/node": "^24.10.1",
     "@types/react": "^19.2.18",

package/paseo-plugin.json

@@ -1,5 +1,5 @@
 {
   "id": "context-mode",
   "description": "Provider-aware Context Mode health, savings, and MCP activation for Paseo.",
-  "requirements": { "paseo": "^0.9.0 || ^0.10.0" }
+  "requirements": { "paseo": "^0.9.0 || ^0.10.0 || ^0.11.0" }
 }