@omniviewdev/runtime 0.9.2 → 0.11.0

package/dist/context/drawer/types.d.ts

@@ -1,4 +1,6 @@
 import { ReactNode } from 'react';
+import { AccessRoute, ResourceReference } from '../../resource/v2/domain';
+import { HostRecord } from '../../resource/v2/host';
 /**
  * A factory function that produces a DrawerComponent for a given resource.
  * Plugins export these keyed by resource key so the host can build the full
@@ -119,28 +121,16 @@ export type DrawerContext<T = any> = {
      * Resource information (if this drawer is being displayed as part of a resource)
      */
     resource?: {
-        /**
-         * The id of the resource in question
-         */
-        id: string;
-        /**
-         * A human-readable display name for the resource, shown in the drawer header.
-         */
+        reference: ResourceReference;
+        targetId: string;
+        route: AccessRoute;
+        representation: string;
+        /** Opaque host-minted address key, when supplied by the host. */
+        key?: string;
         name?: string;
-        /**
-         * The resource key that defines the globally-recognizable key
-         */
-        key: string;
-        /**
-        * A connection id, if this drawer is displaying something in the context
-        * of a connection.
-        */
-        connectionID: string;
-        /**
-         * The plugin that owns this resource. When provided, host-level features
-         * like the Events tab can be injected automatically.
-         */
-        pluginID?: string;
+        pluginID: string;
+        /** Original observed record, not a re-fetched replacement. */
+        record?: HostRecord;
     };
 };
 export type BottomDrawerTab = {

package/dist/context/index.d.ts

@@ -3,3 +3,4 @@ export * from './settings';
 export * from './drawer';
 export * from './modal';
 export * from './operations/OperationsContext';
+export * from './windows';

package/dist/context/operations/OperationsContext.d.ts

@@ -1,10 +1,10 @@
 import { default as React } from 'react';
-export type Operation = {
+export type BackgroundOperation = {
     id: string;
     label: string;
     resourceKey: string;
     resourceName: string;
-    namespace: string;
+    namespace?: string;
     connectionID: string;
     status: 'running' | 'completed' | 'error' | 'cancelled';
     progress?: {
@@ -16,9 +16,9 @@ export type Operation = {
     completedAt?: number;
 };
 export type OperationsContextType = {
-    operations: Operation[];
-    addOperation: (op: Operation) => void;
-    updateOperation: (id: string, updates: Partial<Operation>) => void;
+    operations: BackgroundOperation[];
+    addOperation: (op: BackgroundOperation) => void;
+    updateOperation: (id: string, updates: Partial<BackgroundOperation>) => void;
     removeOperation: (id: string) => void;
 };
 export declare const OperationsContext: React.Context<OperationsContextType | undefined>;

package/dist/context/windows/WindowActionsContext.d.ts

@@ -0,0 +1,31 @@
+import { default as React } from 'react';
+export type OpenInNewTabOptions = {
+    /** Keep the current tab active; the new tab opens behind it. */
+    background?: boolean;
+};
+/**
+ * Opens host routes (e.g. `/_plugin/kubernetes/cluster/abc/resources`) outside
+ * the current page tab. The host application provides the implementation.
+ */
+export type WindowActions = {
+    /** Opens the path in a new page tab next to the current one. */
+    openInNewTab: (path: string, options?: OpenInNewTabOptions) => void;
+    /** Opens the path in a new workspace window. */
+    openInNewWindow: (path: string) => void;
+    /** Opens the path in a new tab in the side-by-side pane, splitting the view if needed. */
+    openInSplit: (path: string) => void;
+};
+export declare const WindowActionsContext: React.Context<WindowActions | null>;
+export declare const WindowActionsProvider: React.FC<{
+    actions: WindowActions;
+    children: React.ReactNode;
+}>;
+/**
+ * Window-level navigation for plugins: open a route in a new tab, a new window
+ * or the split pane.
+ *
+ * @example
+ * const { openInNewTab } = useWindowActions();
+ * openInNewTab(`/_plugin/${pluginId}/cluster/${id}/resources`);
+ */
+export declare function useWindowActions(): WindowActions;

package/dist/context/windows/activePageNavigator.d.ts

@@ -0,0 +1,13 @@
+type ActivePageNavigator = (path: string) => void;
+/**
+ * The host registers how to navigate the page the user is looking at (the
+ * active page tab of this window). Returns the unregister function.
+ */
+export declare function registerActivePageNavigator(navigator: ActivePageNavigator): () => void;
+/**
+ * Navigates the active page of this window to a host route such as
+ * `/settings?category=developer`. Code outside React (error actions, event
+ * handlers) uses this instead of touching `window.location`.
+ */
+export declare function navigateActivePage(path: string): void;
+export {};

package/dist/context/windows/index.d.ts

@@ -0,0 +1,2 @@
+export * from './WindowActionsContext';
+export * from './activePageNavigator';

package/dist/exec.d.ts

@@ -0,0 +1,5 @@
+import { CancellablePromise } from '@wailsio/runtime';
+import { Session, SessionOptions } from './bindings/github.com/omniviewdev/plugin-sdk/pkg/v1/exec/models';
+export { AttachSession, CloseSession, CreateTerminal, DetachSession, GetHandler, GetHandlers, GetPluginHandlers, GetSession, HasPlugin, ListPlugins, ListSessions, ResizeSession, WriteSession, } from './bindings/github.com/omniviewdev/omniview/backend/pkg/plugin/exec/servicewrapper';
+/** Wails receives exact JSON text; the public SDK-shaped API remains typed. */
+export declare function CreateSession(plugin: string, connectionID: string, options: SessionOptions): CancellablePromise<Session | null>;

package/dist/graph-JDqyJC_i.js

@@ -0,0 +1,10 @@
+var o = /* @__PURE__ */ ((e) => (e[e.WatchStateIdle = 0] = "WatchStateIdle", e[e.WatchStateSyncing = 1] = "WatchStateSyncing", e[e.WatchStateSynced = 2] = "WatchStateSynced", e[e.WatchStateError = 3] = "WatchStateError", e[e.WatchStateStopped = 4] = "WatchStateStopped", e[e.WatchStateFailed = 5] = "WatchStateFailed", e[e.WatchStateForbidden = 6] = "WatchStateForbidden", e[e.WatchStateSkipped = 7] = "WatchStateSkipped", e))(o || {}), p = /* @__PURE__ */ ((e) => (e[e.SyncOnConnect = 0] = "SyncOnConnect", e[e.SyncOnFirstQuery = 1] = "SyncOnFirstQuery", e[e.SyncNever = 2] = "SyncNever", e))(p || {});
+function s(e, d) {
+  const r = e.reference.address, n = d.reference.address;
+  return e.pluginId === d.pluginId && e.reference.incarnation === d.reference.incarnation && r.provider === n.provider && r.authority === n.authority && r.type === n.type && r.id === n.id && r.scope.length === n.scope.length && r.scope.every((t) => n.scope.some((i) => t.dimension === i.dimension && t.value === i.value));
+}
+export {
+  p as S,
+  o as W,
+  s
+};

package/dist/graph-wHun0Bkz.cjs

@@ -0,0 +1 @@
+"use strict";var o=(e=>(e[e.WatchStateIdle=0]="WatchStateIdle",e[e.WatchStateSyncing=1]="WatchStateSyncing",e[e.WatchStateSynced=2]="WatchStateSynced",e[e.WatchStateError=3]="WatchStateError",e[e.WatchStateStopped=4]="WatchStateStopped",e[e.WatchStateFailed=5]="WatchStateFailed",e[e.WatchStateForbidden=6]="WatchStateForbidden",e[e.WatchStateSkipped=7]="WatchStateSkipped",e))(o||{}),a=(e=>(e[e.SyncOnConnect=0]="SyncOnConnect",e[e.SyncOnFirstQuery=1]="SyncOnFirstQuery",e[e.SyncNever=2]="SyncNever",e))(a||{});function c(e,t){const r=e.reference.address,n=t.reference.address;return e.pluginId===t.pluginId&&e.reference.incarnation===t.reference.incarnation&&r.provider===n.provider&&r.authority===n.authority&&r.type===n.type&&r.id===n.id&&r.scope.length===n.scope.length&&r.scope.every(d=>n.scope.some(i=>d.dimension===i.dimension&&d.value===i.value))}exports.SyncPolicy=a;exports.WatchState=o;exports.sameGraphNode=c;

package/dist/hooks/connection/index.d.ts

@@ -1,7 +1,8 @@
 export * from './useConnection';
 export * from './useConnections';
-export * from './useConnectionNamespaces';
+export * from './useScopeValues';
 export * from './useConnectionStatus';
+export * from './useConnectionProfiles';
 export * from './useConnectionReadiness';
 export { requireConnectionReady, withConnectionReady } from '../../connection/connectionReadiness';
 export { ConnectionBoundary, ConnectionBoundaryFallback } from '../../connection/ConnectionBoundary';

package/dist/hooks/connection/useConnection.d.ts

@@ -1,37 +1,16 @@
 import { Connection } from '../../bindings/github.com/omniviewdev/plugin-sdk/pkg/types/models';
-type UseConnectionOptions = {
-    /**
-     * The name of the plugin we're interacting with
-     */
+import { ConnectionProfileResult } from '../../resource/v2/host';
+/** Connection lifecycle and explicit desired profiles remain separate from native discovery. */
+export declare const useConnection: ({ pluginID: explicitPluginID, connectionID, enabled, }: {
     pluginID?: string;
-    /**
-     * The ID of the connection
-     */
     connectionID: string;
-};
-/**
- * Get and retreive connections from a plugin's connection manager..
- */
-export declare const useConnection: ({ pluginID: explicitPluginID, connectionID }: UseConnectionOptions) => {
-    /**
-     * Get the connection
-     */
+    enabled?: boolean;
+}) => {
     connection: import('@tanstack/react-query').UseQueryResult<Connection, Error>;
-    /**
-     * Start the connection
-     */
     startConnection: import('@tanstack/react-query').UseMutateAsyncFunction<import('../../models').ConnectionStatus, unknown, void, unknown>;
-    /**
-     * Stop the connection
-     */
     stopConnection: import('@tanstack/react-query').UseMutateAsyncFunction<Connection, unknown, void, unknown>;
-    /**
-     * Update the connection.
-     */
-    updateConnection: import('@tanstack/react-query').UseMutateAsyncFunction<Connection, unknown, Connection, unknown>;
-    /**
-     * Delete the connection
-     */
-    deleteConnection: import('@tanstack/react-query').UseMutateAsyncFunction<void, unknown, void, unknown>;
+    saveConnectionProfile: import('@tanstack/react-query').UseMutateAsyncFunction<ConnectionProfileResult, unknown, Connection, unknown>;
+    importConnectionProfile: import('@tanstack/react-query').UseMutateAsyncFunction<ConnectionProfileResult, unknown, void, unknown>;
+    resetConnectionProfile: import('@tanstack/react-query').UseMutateAsyncFunction<ConnectionProfileResult, unknown, void, unknown>;
+    removeConnection: import('@tanstack/react-query').UseMutateAsyncFunction<void, unknown, void, unknown>;
 };
-export {};

package/dist/hooks/connection/useConnectionProfiles.d.ts

@@ -0,0 +1,7 @@
+import { ConnectionProfile } from '../../resource/v2/host';
+/** Desired profiles include disabled/review entries missing from effective discovery. */
+export declare function useConnectionProfiles({ pluginID: explicitPluginID }: {
+    pluginID?: string;
+}): {
+    profiles: import('@tanstack/react-query').UseQueryResult<readonly ConnectionProfile[], Error>;
+};

package/dist/hooks/connection/useConnectionStatus.d.ts

@@ -1,10 +1,13 @@
+import { NativeConnectionReadiness, HostConnectionState } from '../../resource/v2/host';
+import { AppError } from '../../errors/types';
 import { ActiveSync } from '../../utils/activeSyncAggregator';
 export interface ConnectionStatusEntry {
     pluginID: string;
     connectionID: string;
     name: string;
     avatar: string;
-    isStarted: boolean;
+    readiness: NativeConnectionReadiness;
+    readinessError?: HostConnectionState['readinessError'];
     sync?: ActiveSync;
     isSyncing: boolean;
     hasErrors: boolean;
@@ -14,6 +17,10 @@ export interface ConnectionStatusEntry {
     pluginError?: string;
 }
 export interface ConnectionStatusSummary {
+    isLoading: boolean;
+    error?: AppError;
+    /** Explicitly refresh native readiness; failures are never retried automatically. */
+    refresh: () => Promise<void>;
     entries: ConnectionStatusEntry[];
     grouped: Map<string, ConnectionStatusEntry[]>;
     connectedCount: number;

package/dist/hooks/connection/useConnections.d.ts

@@ -1,3 +1,4 @@
+import { AccessRoute, ReadTarget } from '../../resource/v2/domain';
 import { Connection } from '../../bindings/github.com/omniviewdev/plugin-sdk/pkg/types/models';
 type UseConnectionsOptions = {
     /**
@@ -12,7 +13,7 @@ export declare const connectionListQueryKey: (plugin: string) => string[];
  */
 export declare const useConnections: ({ plugin: explicitPlugin }: UseConnectionsOptions) => {
     connections: import('@tanstack/react-query').UseQueryResult<Connection[], Error>;
-    startWatch: import('@tanstack/react-query').UseMutateAsyncFunction<void, unknown, Connection, unknown>;
-    stopWatch: import('@tanstack/react-query').UseMutateAsyncFunction<void, unknown, Connection, unknown>;
+    startWatch: import('@tanstack/react-query').UseMutateAsyncFunction<void, unknown, readonly ReadTarget[], unknown>;
+    stopWatch: import('@tanstack/react-query').UseMutateAsyncFunction<void, unknown, AccessRoute, unknown>;
 };
 export {};

package/dist/hooks/connection/useScopeValues.d.ts

@@ -0,0 +1,9 @@
+import { AccessRoute } from '../../resource/v2/domain';
+export declare const useScopeValues: ({ pluginID: explicitPluginID, route, dimension, enabled, }: {
+    pluginID?: string;
+    route: AccessRoute;
+    dimension: string;
+    enabled?: boolean;
+}) => {
+    values: import('@tanstack/react-query').UseQueryResult<string[], Error>;
+};

package/dist/hooks/logs/useLogSession.d.ts

@@ -1,3 +1,4 @@
+import { Value, ResourceReference, AccessRoute } from '../../resource/v2/domain';
 type UseLogSessionOptions = {
     pluginID?: string;
 };
@@ -5,7 +6,9 @@ type CreateLogSessionArgs = {
     connectionID: string;
     resourceKey: string;
     resourceID: string;
-    resourceData: Record<string, any>;
+    resourceData: Value;
+    reference?: ResourceReference;
+    route?: AccessRoute;
     icon?: string | React.ReactNode;
     label?: string;
     target?: string;

package/dist/hooks/metric/useMetricStream.d.ts

@@ -1,4 +1,5 @@
 import { MetricResult } from '../../bindings/github.com/omniviewdev/plugin-sdk/pkg/v1/metric/models';
+import { Value, ResourceReference, AccessRoute } from '../../resource/v2/domain';
 export type UseMetricStreamOptions = {
     /** The plugin providing metrics */
     pluginID?: string;
@@ -10,8 +11,11 @@ export type UseMetricStreamOptions = {
     resourceID: string;
     /** The resource namespace */
     resourceNamespace?: string;
-    /** The full resource data object */
-    resourceData?: Record<string, unknown>;
+    /** Canonical resource body, never the presentation projection. */
+    resourceData?: Value;
+    reference?: ResourceReference;
+    route?: AccessRoute;
+    params?: Record<string, string>;
     /** Specific metric IDs to stream */
     metricIDs?: string[];
     /** Polling interval in milliseconds (default 10000) */

package/dist/hooks/metric/useResourceMetrics.d.ts

@@ -1,5 +1,6 @@
 import { QueryResponse } from '../../bindings/github.com/omniviewdev/plugin-sdk/pkg/v1/metric/models';
 import { MetricProviderSummary } from '../../bindings/github.com/omniviewdev/omniview/backend/pkg/plugin/metric/models';
+import { Value, ResourceReference, AccessRoute } from '../../resource/v2/domain';
 export type UseResourceMetricsOptions = {
     /** The plugin that owns the resource (e.g., "kubernetes") */
     pluginID?: string;
@@ -11,8 +12,11 @@ export type UseResourceMetricsOptions = {
     resourceID: string;
     /** The resource namespace (optional) */
     resourceNamespace?: string;
-    /** The full resource data object */
-    resourceData?: Record<string, unknown>;
+    /** Canonical resource body, absent for nonresource metrics. */
+    resourceData?: Value;
+    reference?: ResourceReference;
+    route?: AccessRoute;
+    params?: Record<string, string>;
     /** Specific metric IDs to fetch (empty = all) */
     metricIDs?: string[];
     /** The shape of metric data to request */

package/dist/hooks/networker/types.d.ts

@@ -1,4 +1,5 @@
 import { PortForwardSession } from '../../bindings/github.com/omniviewdev/plugin-sdk/pkg/v1/networker/models';
+import { Value, ResourceReference, AccessRoute } from '../../resource/v2/domain';
 export type PortForwardResourceOpts = {
     /**
     * The resource key identifier.
@@ -11,9 +12,11 @@ export type PortForwardResourceOpts = {
     */
     resourceId: string;
     /**
-    * The resource data object
+    * The canonical resource body, never the presentation projection.
     */
-    resource: any;
+    resource: Value;
+    reference?: ResourceReference;
+    route?: AccessRoute;
     /**
     * The port to forward on the resource
     * @example 8080

package/dist/hooks/networker/useResourcePortForwarder.d.ts

@@ -9,7 +9,7 @@ export declare function useResourcePortForwarder({ pluginID: explicitPluginID, c
 }): {
     sessions: import('@tanstack/react-query').UseQueryResult<never[] | (import('../../models').PortForwardSession | null)[], Error>;
     forward: import('@tanstack/react-query').UseMutateAsyncFunction<import('../../models').PortForwardSession, unknown, {
-        opts: Partial<PortForwardResourceOpts>;
+        opts: PortForwardResourceOpts;
     }, unknown>;
     close: import('@tanstack/react-query').UseMutateAsyncFunction<import('../../models').PortForwardSession | null, unknown, {
         opts: {

package/dist/hooks/resource/useConnectionQueryGuard.d.ts

@@ -1,3 +1,3 @@
 import { QueryKey } from '@tanstack/react-query';
 /** Cancel connection-scoped reads immediately and reject late results after invalidation. */
-export declare function useConnectionQueryGuard(pluginID: string, connectionID: string): <T>(queryKey: QueryKey, signal: AbortSignal, operation: () => Promise<T>) => Promise<T>;
+export declare function useConnectionQueryGuard(pluginID: string, connectionID: string): <T>(queryKey: QueryKey, signal: AbortSignal, operation: () => Promise<T>, routeConnectionID?: string) => Promise<T>;

package/dist/hooks/resource/useDependencyTree.d.ts

@@ -1,20 +1,12 @@
+import { AccessRoute, ResourceReference } from '../../resource/v2/domain';
 type UseDependencyTreeOptions = {
     /**
      * The ID of the plugin responsible for this resource
      * @example "kubernetes"
      */
     pluginID?: string;
-    /** The connection ID the resource belongs to */
-    connectionID: string;
-    /**
-     * The resource key of the root resource
-     * @example "apps::v1::Deployment"
-     */
-    resourceKey: string;
-    /** The ID of the root resource */
-    resourceID: string;
-    /** Namespace of the root resource, if the backend has namespaces */
-    namespace?: string;
+    reference: ResourceReference;
+    route: AccessRoute;
     /** How many edges deep to follow. The host caps this at 5. */
     maxDepth?: number;
     /** Whether to enable the query */
@@ -31,7 +23,7 @@ type UseDependencyTreeOptions = {
  * ReplicaSet → Pods → Node, ConfigMaps, PVCs). A resource reachable by more
  * than one path appears once.
  */
-export declare const useDependencyTree: ({ pluginID: explicitPluginID, connectionID, resourceKey, resourceID, namespace, maxDepth, enabled, refetchInterval, }: UseDependencyTreeOptions) => {
+export declare const useDependencyTree: ({ pluginID: explicitPluginID, reference, route, maxDepth, enabled, refetchInterval, }: UseDependencyTreeOptions) => {
     tree: import('../../models').DependencyTree | null;
     isLoading: boolean;
     isFetching: boolean;

package/dist/hooks/resource/useEditorSchemas.d.ts

@@ -1,8 +1,9 @@
+import { AccessRoute } from '../../resource/v2/domain';
 type UseEditorSchemasOptions = {
     /** The plugin ID to fetch schemas for */
     pluginID?: string;
-    /** The connection ID to fetch schemas for */
-    connectionID: string;
+    /** Route used to acquire schemas; never resource identity. */
+    route: AccessRoute;
     /** Whether to enable the query */
     enabled?: boolean;
 };
@@ -10,13 +11,17 @@ type UseEditorSchemasOptions = {
  * useEditorSchemas fetches editor schemas for a plugin + connection pair
  * from the backend via Wails bindings.
  *
- * The caller is responsible for registering the returned schemas with
- * the SchemaRegistry (which lives in the host app's monaco provider).
+ * Shared documents are fetched once per exact reference and published together
+ * with the schema bindings. Callers must pass both to the host SchemaRegistry.
  */
-export declare const useEditorSchemas: ({ pluginID: explicitPluginID, connectionID, enabled, }: UseEditorSchemasOptions) => {
-    schemas: import('../../models').EditorSchema[];
+export declare const useEditorSchemas: ({ pluginID: explicitPluginID, route, enabled, }: UseEditorSchemasOptions) => {
+    schemas: import('../..').EditorSchema[];
+    documents: import('../..').SchemaDocument[];
     isLoading: boolean;
     error: Error | null;
-    refetch: (options?: import('@tanstack/react-query').RefetchOptions) => Promise<import('@tanstack/react-query').QueryObserverResult<import('../../models').EditorSchema[], Error>>;
+    refetch: (options?: import('@tanstack/react-query').RefetchOptions) => Promise<import('@tanstack/react-query').QueryObserverResult<{
+        schemas: import('../..').EditorSchema[];
+        documents: import('../..').SchemaDocument[];
+    }, Error>>;
 };
 export default useEditorSchemas;

package/dist/hooks/resource/useEventBatcher.d.ts

@@ -1,27 +1,10 @@
 import { QueryClient, QueryKey } from '@tanstack/react-query';
+import { HostWatchAddPayload, HostWatchDeletePayload, HostWatchUpdatePayload, ResourceView } from '../../resource/v2/host';
 import { WatchState } from '../../types/watch';
-export type AddPayload = {
-    data: any;
-    key: string;
-    connection: string;
-    id: string;
-    namespace: string;
-};
-export type UpdatePayload = {
-    data: any;
-    key: string;
-    connection: string;
-    id: string;
-    namespace: string;
-};
-export type DeletePayload = {
-    data: any;
-    key: string;
-    connection: string;
-    id: string;
-    namespace: string;
-};
-export type ResourceEvent = {
+export type AddPayload = HostWatchAddPayload;
+export type UpdatePayload = HostWatchUpdatePayload;
+export type DeletePayload = HostWatchDeletePayload;
+export type ResourceUpdateEvent = {
     type: 'ADD';
     payload: AddPayload;
 } | {
@@ -31,30 +14,11 @@ export type ResourceEvent = {
     type: 'DELETE';
     payload: DeletePayload;
 };
-/**
- * Apply a batch of resource events to a list query cache entry.
- * Extracted for testability — this is the core batching logic.
- *
- * Returns a new plain object (immutable-style) without relying on Immer,
- * avoiding issues with Wails binding class instances that Immer cannot draft.
- */
-export declare function applyBatch(oldData: any, events: ResourceEvent[], idAccessor: string): any;
-/**
- * Adaptive two-mode event batcher for resource watch events.
- *
- * **Mode 1 — Initial Sync (SYNCING state):** Uses `setTimeout` with a larger
- * window (default 500ms) to batch the initial ADD flood into 1-2 flushes.
- * Satisfies REQ-BATCH-2.
- *
- * **Mode 2 — Live Updates (all other states):** Races `requestAnimationFrame`
- * against the same bounded window, retaining next-frame batching while allowing
- * already-delivered data to progress when painting is withheld but timers run.
- * This does not promise progress while the entire event loop is frozen.
- *
- * Mode transitions happen automatically when `watchState` changes.
- * Pending timers flush normally; subsequent events use the new scheduling.
- */
-export declare function useEventBatcher(queryClient: QueryClient, queryKey: QueryKey, getResourceKey: (id: string, ns: string) => QueryKey, idAccessor: string | undefined, watchState: WatchState, options?: {
+/** Advisory events may patch observed host keys, never expand native page membership. */
+export declare function applyBatch(oldData: ResourceView | undefined, events: readonly ResourceUpdateEvent[], membershipChanged?: boolean): ResourceView | undefined;
+/** At most one pending event per observed page key; unseen row bodies are never retained. */
+export declare function useEventBatcher(queryClient: QueryClient, queryKey: QueryKey, watchState: WatchState, options?: {
     syncWindowMs?: number;
     enabled?: boolean;
-}): (event: ResourceEvent) => void;
+    isCurrent?: () => boolean;
+}): (event: ResourceUpdateEvent) => void;

package/dist/hooks/resource/useRelatedResources.d.ts

@@ -1,4 +1,5 @@
-import { GraphEdge, GraphNode } from '../../bindings/github.com/omniviewdev/omniview/backend/pkg/plugin/resource/graph/models';
+import { GraphEdge, GraphNode } from '../../resource/v2/graph';
+import { AccessRoute, ResourceReference } from '../../resource/v2/domain';
 /** Which side of the relationship the viewed resource is on. */
 export type RelationshipDirection = 'outgoing' | 'incoming';
 /** A resource linked to the viewed resource by one relationship edge. */
@@ -26,17 +27,8 @@ type UseRelatedResourcesOptions = {
      * @example "kubernetes"
      */
     pluginID?: string;
-    /** The connection ID the resource belongs to */
-    connectionID: string;
-    /**
-     * The resource key of the viewed resource
-     * @example "core::v1::Pod"
-     */
-    resourceKey: string;
-    /** The ID of the viewed resource */
-    resourceID: string;
-    /** Namespace of the viewed resource, if the backend has namespaces */
-    namespace?: string;
+    reference: ResourceReference;
+    route: AccessRoute;
     /** Which edges to return. Defaults to both directions. */
     direction?: RelationshipDirection | 'both';
     /** Only return edges of this relationship type */
@@ -59,7 +51,7 @@ export declare function relationshipLabel(type: string, direction: RelationshipD
  * toRelatedResources converts graph edges around `self` into one entry per
  * edge, keyed by the resource at the other end.
  */
-export declare function toRelatedResources(self: GraphNode, edges: GraphEdge[]): RelatedResource[];
+export declare function toRelatedResources(self: Omit<GraphNode, 'key'>, edges: GraphEdge[]): RelatedResource[];
 /**
  * useRelatedResources returns the resources linked to one resource in the
  * relationship graph the host builds from the plugin's relationship
@@ -68,7 +60,7 @@ export declare function toRelatedResources(self: GraphNode, edges: GraphEdge[]):
  * Only resources the host is watching are indexed. Targets referenced by
  * name (a Secret a Pod mounts) are returned even if they do not exist.
  */
-export declare const useRelatedResources: ({ pluginID: explicitPluginID, connectionID, resourceKey, resourceID, namespace, direction, relationshipType, enabled, refetchInterval, }: UseRelatedResourcesOptions) => {
+export declare const useRelatedResources: ({ pluginID: explicitPluginID, reference, route, direction, relationshipType, enabled, refetchInterval, }: UseRelatedResourcesOptions) => {
     /** One entry per edge, from the viewed resource's side. */
     related: RelatedResource[];
     /** The raw graph edges. */