@flanksource/clicky-ui 0.3.21 → 0.3.22

package/dist/rpc/types.d.ts

@@ -42,10 +42,42 @@ export interface OpenAPISchema {
     additionalProperties?: OpenAPISchema | boolean;
     nullable?: boolean;
 }
-export type ClickyParameterRole = "search" | "filter" | "limit" | "offset" | "cursor" | "time-from" | "time-to";
+export type ClickyParameterRole = "search" | "filter" | "limit" | "offset" | "cursor" | "sort" | "order" | "time-from" | "time-to";
 export interface ClickyParameterMeta {
     role?: ClickyParameterRole;
 }
+/**
+ * A parameter's pointer to its filter control, set server-side.
+ *
+ * `$ref` names the control's SHAPE — which control this is — and is present on
+ * every generated filter, because a control's identity never varies with the
+ * values currently selected. `url`/`filter`/`searchParam` are the separate
+ * question of where its OPTIONS come from, and are present only when the
+ * backend can enumerate them: a range has no list to offer.
+ */
+export interface ClickyParameterLookup {
+    /** JSON pointer into `components["x-clicky-filters"]`. */
+    $ref?: string;
+    url?: string;
+    filter?: string;
+    searchParam?: string;
+    multi?: boolean;
+}
+/**
+ * One entry of `components["x-clicky-filters"]`: a filter control's shape,
+ * published once per spec and invariant for the life of it.
+ *
+ * Distinct from OperationLookupFilter, which is the per-request answer to "what
+ * values can this filter take right now" and may legitimately narrow as other
+ * filters are selected. Reading shape from here rather than from a lookup
+ * response is what keeps a control from decaying into a text box while its
+ * options are in flight.
+ */
+export interface ClickyFilterShape {
+    label?: string;
+    type?: OperationLookupFilterType;
+    multi?: boolean;
+}
 export interface OpenAPIParameter {
     name: string;
     in: "query" | "path" | "header";
@@ -56,6 +88,7 @@ export interface OpenAPIParameter {
      *  which is help text and must NOT be used as a placeholder. */
     placeholder?: string;
     "x-clicky"?: ClickyParameterMeta;
+    "x-clicky-lookup"?: ClickyParameterLookup;
     /** Vendor-extension placeholder, set server-side by clicky's converter.
      *  Takes precedence over `placeholder` when both are present. */
     "x-clicky-placeholder"?: string;
@@ -75,7 +108,7 @@ export interface OpenAPIOperation {
             schema?: OpenAPISchema;
         }>;
     };
-    responses: Record<string, unknown>;
+    responses?: Record<string, unknown>;
     "x-clicky"?: ClickyOperationMeta;
 }
 export interface OpenAPISpec {
@@ -90,6 +123,9 @@ export interface OpenAPISpec {
         name: string;
         description?: string;
     }>;
+    components?: {
+        "x-clicky-filters"?: Record<string, ClickyFilterShape>;
+    };
     "x-clicky"?: ClickySpecMeta;
 }
 export interface ResolvedOperation {
@@ -158,7 +194,18 @@ export interface ClickyToolHints {
 }
 export type OperationLookupFilterType = "bool" | "number" | "date"
 /** Both edges of a range under one parameter, as ">=from,<=to". */
- | "date-range" | "from" | "to" | "multi-filter"
+ | "date-range"
+/** A "date-range" with the clock taken off it: whole days, same grammar. */
+ | "day-range"
+/**
+ * A numeric range over elapsed time. Same grammar as "number"; the operands
+ * are the column's own unit, which `unit` names.
+ */
+ | "duration" | "from" | "to" | "multi-filter"
+/** A Kubernetes workload selected inside a profile's target scope. */
+ | "workload"
+/** Kubernetes label values, grouped by key when options are key=value pairs. */
+ | "labels"
 /**
  * An exact-value selection with nothing to enumerate — a UUID column, say.
  * Same wire grammar as "multi-filter"; typed rather than picked, because a
@@ -183,6 +230,10 @@ export interface OperationLookupFilter {
     timeEnabled?: boolean;
     timeZone?: string;
     timeZones?: string[];
+    /** The unit a "duration" filter's operands are written in ("ms" or "s"), so
+     *  the control labels itself in the numbers the column is stored in. Absent
+     *  means milliseconds. */
+    unit?: string;
 }
 export interface OperationLookupResponse {
     filters: Record<string, OperationLookupFilter>;

package/dist/rpc/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/rpc/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/rpc/types.ts"],"names":[],"mappings":"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"}

package/dist/rpc/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sources":["../../src/rpc/types.ts"],"sourcesContent":["import type { ClickyNode } from \"../data/Clicky\";\nimport type { TimeRangePresetGroup } from \"../components/TimeRange\";\n\nexport interface ExecutionRequest {\n  args?: string[];\n  flags?: Record<string, string>;\n}\n\nexport interface ExecutionPagination {\n  total?: number;\n  limit?: number;\n  offset?: number;\n\n  // totalRelation says whether total is a count or a lower bound. A backend\n  // that stops counting past a threshold reports \"gte\", and rendering that as\n  // a count would state a number nobody promised.\n  totalRelation?: \"eq\" | \"gte\";\n\n  // hasMore is the server's answer, not an inference from the page length: a\n  // short page and the end of the data are different facts.\n  hasMore?: boolean;\n\n  // nextCursor resumes after this page. Opaque — it is passed back unchanged\n  // and never parsed, because a client that can read one can forge one.\n  nextCursor?: string;\n\n  // truncated reports that the server stopped short of the whole result, so a\n  // partial answer is never rendered as a complete one.\n  truncated?: boolean;\n}\n\nexport interface ExecutionResponse {\n  success: boolean;\n  message?: string;\n  output?: string;\n  stdout?: string;\n  stderr?: string;\n  exit_code: number;\n  error?: string;\n  cli?: string;\n  input?: ExecutionRequest;\n  contentType?: string;\n  requestUrl?: string;\n  responseHeaders?: Record<string, string>;\n  pagination?: ExecutionPagination;\n  blob?: Blob;\n  parsed?: unknown;\n}\n\nexport interface OpenAPISchema {\n  type?: string;\n  format?: string;\n  default?: unknown;\n  enum?: unknown[];\n  description?: string;\n  properties?: Record<string, OpenAPISchema>;\n  items?: OpenAPISchema;\n  oneOf?: OpenAPISchema[];\n  additionalProperties?: OpenAPISchema | boolean;\n  nullable?: boolean;\n}\n\n// ClickyParameterRole tells the UI which widget owns a parameter:\n//   \"search\"    — render as the FilterBar's dedicated search input\n//   \"filter\"    — render as a FilterBar chip on the DataTable\n//   \"limit\"     — feed into DataTable pagination's pageSize\n//   \"offset\"    — feed into DataTable pagination's page (or skip)\n//   \"cursor\"    — carry the opaque position the previous page returned\n//   \"time-from\" — left edge of a time-range picker\n//   \"time-to\"   — right edge of a time-range picker\n// Set server-side by clicky's converter (see paramRole in clicky/rpc/openapi.go).\nexport type ClickyParameterRole =\n  | \"search\"\n  | \"filter\"\n  | \"limit\"\n  | \"offset\"\n  | \"cursor\"\n  | \"time-from\"\n  | \"time-to\";\n\nexport interface ClickyParameterMeta {\n  role?: ClickyParameterRole;\n}\n\nexport interface OpenAPIParameter {\n  name: string;\n  in: \"query\" | \"path\" | \"header\";\n  description?: string;\n  required?: boolean;\n  schema?: OpenAPISchema;\n  /** Hint text shown inside the empty input. Distinct from `description`,\n   *  which is help text and must NOT be used as a placeholder. */\n  placeholder?: string;\n  \"x-clicky\"?: ClickyParameterMeta;\n  /** Vendor-extension placeholder, set server-side by clicky's converter.\n   *  Takes precedence over `placeholder` when both are present. */\n  \"x-clicky-placeholder\"?: string;\n}\n\n/** Resolves the input placeholder for a parameter, drawing ONLY from explicit\n *  placeholder fields — never from `description` (help text). Returns undefined\n *  when no placeholder is declared so callers can apply their own fallback. */\nexport function parameterPlaceholder(\n  param: OpenAPIParameter,\n): string | undefined {\n  return param[\"x-clicky-placeholder\"] ?? param.placeholder;\n}\n\nexport interface OpenAPIOperation {\n  tags?: string[];\n  summary?: string;\n  description?: string;\n  operationId?: string;\n  parameters?: OpenAPIParameter[];\n  requestBody?: {\n    content?: Record<string, { schema?: OpenAPISchema }>;\n  };\n  responses: Record<string, unknown>;\n  \"x-clicky\"?: ClickyOperationMeta;\n}\n\nexport interface OpenAPISpec {\n  openapi: string;\n  info: { title: string; description?: string; version: string };\n  paths: Record<string, Record<string, OpenAPIOperation>>;\n  tags?: Array<{ name: string; description?: string }>;\n  \"x-clicky\"?: ClickySpecMeta;\n}\n\nexport interface ResolvedOperation {\n  path: string;\n  method: string;\n  operation: OpenAPIOperation;\n}\n\nexport interface DomainDefinition {\n  key: string;\n  title: string;\n  description: string;\n  icon?: string;\n  emptyTitle?: string;\n  emptyDescription?: string;\n}\n\nexport interface ClickySpecMeta {\n  surfaces?: ClickySurface[];\n}\n\nexport interface ClickySurface {\n  key: string;\n  entity: string;\n  title: string;\n  parent?: string;\n  admin?: boolean;\n  description?: string;\n  /** Opaque icon name emitted by the backend (x-clicky-icon), resolved to a glyph in the UI. */\n  icon?: string;\n  /**\n   * Hierarchy position within `parent`, \"/\"-separated (x-clicky-path) — e.g.\n   * \"jms/incoming/disbursements\". The backend has already applied whatever\n   * delimiter its own naming convention uses, so the UI never guesses one.\n   * Absent — the default — means the parent group renders as a flat list.\n   */\n  path?: string;\n}\n\nexport interface ClickyOperationMeta {\n  command?: string;\n  surface?: string;\n  verb: \"list\" | \"get\" | \"create\" | \"update\" | \"delete\" | \"action\";\n  scope: \"collection\" | \"entity\";\n  actionName?: string;\n  idParam?: string;\n  supportsLookup?: boolean;\n  supportsFilterMode?: boolean;\n  group?: string;\n  toolHints?: ClickyToolHints;\n  export?: ClickyExportMeta;\n}\n\nexport interface ClickyExportMeta {\n  formats?: string[];\n  scopes?: Array<\"page\" | \"all\">;\n  allRowsMode?: \"streaming\" | \"buffered\";\n  formatMaxRows?: Record<string, number>;\n}\n\nexport interface ClickyToolHints {\n  title?: string;\n  readOnlyHint?: boolean;\n  destructiveHint?: boolean;\n  idempotentHint?: boolean;\n  openWorldHint?: boolean;\n  icon?: string;\n  group?: string;\n  parent?: string;\n  defaultPermission?: \"on\" | \"ask\" | \"off\" | \"auto\";\n  strict?: boolean;\n}\n\nexport type OperationLookupFilterType =\n  | \"bool\"\n  | \"number\"\n  | \"date\"\n  /** Both edges of a range under one parameter, as \">=from,<=to\". */\n  | \"date-range\"\n  | \"from\"\n  | \"to\"\n  | \"multi-filter\"\n  /**\n   * An exact-value selection with nothing to enumerate — a UUID column, say.\n   * Same wire grammar as \"multi-filter\"; typed rather than picked, because a\n   * dropdown over identifiers is a page of the rows.\n   */\n  | \"value\";\n\nexport interface OperationLookupFilter {\n  label?: string;\n  options?: Record<string, ClickyNode>;\n  selected?: Record<string, ClickyNode>;\n  multi?: boolean;\n  type?: OperationLookupFilterType;\n  /** True when `options` is only the head of a larger set (server-side capped). */\n  truncated?: boolean;\n  /** True distinct count behind a truncated option set; drives \"… and N more\". */\n  total?: number;\n  presets?: Array<\n    { label: string; from: string; to: string } | TimeRangePresetGroup\n  >;\n  timeEnabled?: boolean;\n  timeZone?: string;\n  timeZones?: string[];\n}\n\nexport interface OperationLookupResponse {\n  filters: Record<string, OperationLookupFilter>;\n}\n\nexport function isPositionalParam(p: OpenAPIParameter): boolean {\n  return (\n    p.name === \"args\" ||\n    p.description?.toLowerCase().includes(\"positional argument\") === true\n  );\n}\n"],"names":[],"mappings":"AAsGO,SAAS,qBACd,OACoB;AACpB,SAAO,MAAM,sBAAsB,KAAK,MAAM;AAChD;AAoIO,SAAS,kBAAkB,GAA8B;AAxIzD;AAyIL,SACE,EAAE,SAAS,YACX,OAAE,gBAAF,mBAAe,cAAc,SAAS,4BAA2B;AAErE;"}
+{"version":3,"file":"types.js","sources":["../../src/rpc/types.ts"],"sourcesContent":["import type { ClickyNode } from \"../data/Clicky\";\nimport type { TimeRangePresetGroup } from \"../components/TimeRange\";\n\nexport interface ExecutionRequest {\n  args?: string[];\n  flags?: Record<string, string>;\n}\n\nexport interface ExecutionPagination {\n  total?: number;\n  limit?: number;\n  offset?: number;\n\n  // totalRelation says whether total is a count or a lower bound. A backend\n  // that stops counting past a threshold reports \"gte\", and rendering that as\n  // a count would state a number nobody promised.\n  totalRelation?: \"eq\" | \"gte\";\n\n  // hasMore is the server's answer, not an inference from the page length: a\n  // short page and the end of the data are different facts.\n  hasMore?: boolean;\n\n  // nextCursor resumes after this page. Opaque — it is passed back unchanged\n  // and never parsed, because a client that can read one can forge one.\n  nextCursor?: string;\n\n  // truncated reports that the server stopped short of the whole result, so a\n  // partial answer is never rendered as a complete one.\n  truncated?: boolean;\n}\n\nexport interface ExecutionResponse {\n  success: boolean;\n  message?: string;\n  output?: string;\n  stdout?: string;\n  stderr?: string;\n  exit_code: number;\n  error?: string;\n  cli?: string;\n  input?: ExecutionRequest;\n  contentType?: string;\n  requestUrl?: string;\n  responseHeaders?: Record<string, string>;\n  pagination?: ExecutionPagination;\n  blob?: Blob;\n  parsed?: unknown;\n}\n\nexport interface OpenAPISchema {\n  type?: string;\n  format?: string;\n  default?: unknown;\n  enum?: unknown[];\n  description?: string;\n  properties?: Record<string, OpenAPISchema>;\n  items?: OpenAPISchema;\n  oneOf?: OpenAPISchema[];\n  additionalProperties?: OpenAPISchema | boolean;\n  nullable?: boolean;\n}\n\n// ClickyParameterRole tells the UI which widget owns a parameter:\n//   \"search\"    — render as the FilterBar's dedicated search input\n//   \"filter\"    — render as a FilterBar chip on the DataTable\n//   \"limit\"     — feed into DataTable pagination's pageSize\n//   \"offset\"    — feed into DataTable pagination's page (or skip)\n//   \"cursor\"    — carry the opaque position the previous page returned\n//   \"sort\"      — select a public server-side sort key from a table header\n//   \"order\"     — carry that sort's asc/desc direction\n//   \"time-from\" — left edge of a time-range picker\n//   \"time-to\"   — right edge of a time-range picker\n// Set server-side by clicky's converter (see paramRole in clicky/rpc/openapi.go).\nexport type ClickyParameterRole =\n  | \"search\"\n  | \"filter\"\n  | \"limit\"\n  | \"offset\"\n  | \"cursor\"\n  | \"sort\"\n  | \"order\"\n  | \"time-from\"\n  | \"time-to\";\n\nexport interface ClickyParameterMeta {\n  role?: ClickyParameterRole;\n}\n\n/**\n * A parameter's pointer to its filter control, set server-side.\n *\n * `$ref` names the control's SHAPE — which control this is — and is present on\n * every generated filter, because a control's identity never varies with the\n * values currently selected. `url`/`filter`/`searchParam` are the separate\n * question of where its OPTIONS come from, and are present only when the\n * backend can enumerate them: a range has no list to offer.\n */\nexport interface ClickyParameterLookup {\n  /** JSON pointer into `components[\"x-clicky-filters\"]`. */\n  $ref?: string;\n  url?: string;\n  filter?: string;\n  searchParam?: string;\n  multi?: boolean;\n}\n\n/**\n * One entry of `components[\"x-clicky-filters\"]`: a filter control's shape,\n * published once per spec and invariant for the life of it.\n *\n * Distinct from OperationLookupFilter, which is the per-request answer to \"what\n * values can this filter take right now\" and may legitimately narrow as other\n * filters are selected. Reading shape from here rather than from a lookup\n * response is what keeps a control from decaying into a text box while its\n * options are in flight.\n */\nexport interface ClickyFilterShape {\n  label?: string;\n  type?: OperationLookupFilterType;\n  multi?: boolean;\n}\n\nexport interface OpenAPIParameter {\n  name: string;\n  in: \"query\" | \"path\" | \"header\";\n  description?: string;\n  required?: boolean;\n  schema?: OpenAPISchema;\n  /** Hint text shown inside the empty input. Distinct from `description`,\n   *  which is help text and must NOT be used as a placeholder. */\n  placeholder?: string;\n  \"x-clicky\"?: ClickyParameterMeta;\n  \"x-clicky-lookup\"?: ClickyParameterLookup;\n  /** Vendor-extension placeholder, set server-side by clicky's converter.\n   *  Takes precedence over `placeholder` when both are present. */\n  \"x-clicky-placeholder\"?: string;\n}\n\n/** Resolves the input placeholder for a parameter, drawing ONLY from explicit\n *  placeholder fields — never from `description` (help text). Returns undefined\n *  when no placeholder is declared so callers can apply their own fallback. */\nexport function parameterPlaceholder(\n  param: OpenAPIParameter,\n): string | undefined {\n  return param[\"x-clicky-placeholder\"] ?? param.placeholder;\n}\n\nexport interface OpenAPIOperation {\n  tags?: string[];\n  summary?: string;\n  description?: string;\n  operationId?: string;\n  parameters?: OpenAPIParameter[];\n  requestBody?: {\n    content?: Record<string, { schema?: OpenAPISchema }>;\n  };\n  // Optional because nothing here reads it, and a server may serve this catalog\n  // with the response schemas reduced to a stub — they are over half the bytes\n  // of a spec whose only job here is to describe what can be called.\n  responses?: Record<string, unknown>;\n  \"x-clicky\"?: ClickyOperationMeta;\n}\n\nexport interface OpenAPISpec {\n  openapi: string;\n  info: { title: string; description?: string; version: string };\n  paths: Record<string, Record<string, OpenAPIOperation>>;\n  tags?: Array<{ name: string; description?: string }>;\n  components?: {\n    \"x-clicky-filters\"?: Record<string, ClickyFilterShape>;\n  };\n  \"x-clicky\"?: ClickySpecMeta;\n}\n\nexport interface ResolvedOperation {\n  path: string;\n  method: string;\n  operation: OpenAPIOperation;\n}\n\nexport interface DomainDefinition {\n  key: string;\n  title: string;\n  description: string;\n  icon?: string;\n  emptyTitle?: string;\n  emptyDescription?: string;\n}\n\nexport interface ClickySpecMeta {\n  surfaces?: ClickySurface[];\n}\n\nexport interface ClickySurface {\n  key: string;\n  entity: string;\n  title: string;\n  parent?: string;\n  admin?: boolean;\n  description?: string;\n  /** Opaque icon name emitted by the backend (x-clicky-icon), resolved to a glyph in the UI. */\n  icon?: string;\n  /**\n   * Hierarchy position within `parent`, \"/\"-separated (x-clicky-path) — e.g.\n   * \"jms/incoming/disbursements\". The backend has already applied whatever\n   * delimiter its own naming convention uses, so the UI never guesses one.\n   * Absent — the default — means the parent group renders as a flat list.\n   */\n  path?: string;\n}\n\nexport interface ClickyOperationMeta {\n  command?: string;\n  surface?: string;\n  verb: \"list\" | \"get\" | \"create\" | \"update\" | \"delete\" | \"action\";\n  scope: \"collection\" | \"entity\";\n  actionName?: string;\n  idParam?: string;\n  supportsLookup?: boolean;\n  supportsFilterMode?: boolean;\n  group?: string;\n  toolHints?: ClickyToolHints;\n  export?: ClickyExportMeta;\n}\n\nexport interface ClickyExportMeta {\n  formats?: string[];\n  scopes?: Array<\"page\" | \"all\">;\n  allRowsMode?: \"streaming\" | \"buffered\";\n  formatMaxRows?: Record<string, number>;\n}\n\nexport interface ClickyToolHints {\n  title?: string;\n  readOnlyHint?: boolean;\n  destructiveHint?: boolean;\n  idempotentHint?: boolean;\n  openWorldHint?: boolean;\n  icon?: string;\n  group?: string;\n  parent?: string;\n  defaultPermission?: \"on\" | \"ask\" | \"off\" | \"auto\";\n  strict?: boolean;\n}\n\nexport type OperationLookupFilterType =\n  | \"bool\"\n  | \"number\"\n  | \"date\"\n  /** Both edges of a range under one parameter, as \">=from,<=to\". */\n  | \"date-range\"\n  /** A \"date-range\" with the clock taken off it: whole days, same grammar. */\n  | \"day-range\"\n  /**\n   * A numeric range over elapsed time. Same grammar as \"number\"; the operands\n   * are the column's own unit, which `unit` names.\n   */\n  | \"duration\"\n  | \"from\"\n  | \"to\"\n  | \"multi-filter\"\n  /** A Kubernetes workload selected inside a profile's target scope. */\n  | \"workload\"\n  /** Kubernetes label values, grouped by key when options are key=value pairs. */\n  | \"labels\"\n  /**\n   * An exact-value selection with nothing to enumerate — a UUID column, say.\n   * Same wire grammar as \"multi-filter\"; typed rather than picked, because a\n   * dropdown over identifiers is a page of the rows.\n   */\n  | \"value\";\n\nexport interface OperationLookupFilter {\n  label?: string;\n  options?: Record<string, ClickyNode>;\n  selected?: Record<string, ClickyNode>;\n  multi?: boolean;\n  type?: OperationLookupFilterType;\n  /** True when `options` is only the head of a larger set (server-side capped). */\n  truncated?: boolean;\n  /** True distinct count behind a truncated option set; drives \"… and N more\". */\n  total?: number;\n  presets?: Array<\n    { label: string; from: string; to: string } | TimeRangePresetGroup\n  >;\n  timeEnabled?: boolean;\n  timeZone?: string;\n  timeZones?: string[];\n  /** The unit a \"duration\" filter's operands are written in (\"ms\" or \"s\"), so\n   *  the control labels itself in the numbers the column is stored in. Absent\n   *  means milliseconds. */\n  unit?: string;\n}\n\nexport interface OperationLookupResponse {\n  filters: Record<string, OperationLookupFilter>;\n}\n\nexport function isPositionalParam(p: OpenAPIParameter): boolean {\n  return (\n    p.name === \"args\" ||\n    p.description?.toLowerCase().includes(\"positional argument\") === true\n  );\n}\n"],"names":[],"mappings":"AA6IO,SAAS,qBACd,OACoB;AACpB,SAAO,MAAM,sBAAsB,KAAK,MAAM;AAChD;AAyJO,SAAS,kBAAkB,GAA8B;AA7JzD;AA8JL,SACE,EAAE,SAAS,YACX,OAAE,gBAAF,mBAAe,cAAc,SAAS,4BAA2B;AAErE;"}

package/dist/rpc/useOperationPages.cjs

@@ -0,0 +1,111 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const react = require("react");
+const reactQuery = require("@tanstack/react-query");
+const cursorStale = require("./cursorStale.cjs");
+const formMetadata = require("./formMetadata.cjs");
+const LIST_KEY = "operation-list";
+const CLICKY_HEADERS = { Accept: "application/json+clicky" };
+function useOperationPages({
+  client,
+  endpoint,
+  parameters,
+  filters
+}) {
+  var _a;
+  const queryClient = reactQuery.useQueryClient();
+  const cursorParam = cursorStale.cursorParameterName(parameters);
+  const path = endpoint == null ? void 0 : endpoint.path;
+  const method = endpoint == null ? void 0 : endpoint.method;
+  const walkFilters = react.useMemo(() => {
+    if (!cursorParam) return filters;
+    const rest = { ...filters };
+    delete rest[cursorParam];
+    return rest;
+  }, [cursorParam, filters]);
+  const execute = react.useCallback(
+    (values) => client.executeCommand(
+      path,
+      method,
+      formMetadata.packParameterValues(values, parameters),
+      CLICKY_HEADERS
+    ),
+    [client, method, parameters, path]
+  );
+  const single = reactQuery.useQuery({
+    queryKey: [LIST_KEY, method, path, filters],
+    queryFn: () => execute(filters),
+    enabled: !!endpoint && !cursorParam,
+    placeholderData: reactQuery.keepPreviousData,
+    staleTime: 3e4,
+    retry: 0
+  });
+  const walkKey = react.useMemo(
+    () => [LIST_KEY, "walk", method, path, walkFilters],
+    [method, path, walkFilters]
+  );
+  const walk = reactQuery.useInfiniteQuery({
+    queryKey: walkKey,
+    queryFn: ({ pageParam }) => execute(pageParam ? { ...walkFilters, [cursorParam]: pageParam } : walkFilters),
+    initialPageParam: void 0,
+    // The server's two answers, both required: it has more, and here is where
+    // to resume. A page claiming more without minting a token cannot be walked,
+    // and guessing one is how a client forges a position it was never given.
+    getNextPageParam: (lastPage) => {
+      var _a2;
+      return ((_a2 = lastPage.pagination) == null ? void 0 : _a2.hasMore) ? lastPage.pagination.nextCursor : void 0;
+    },
+    enabled: !!endpoint && !!cursorParam,
+    placeholderData: reactQuery.keepPreviousData,
+    staleTime: 3e4,
+    retry: 0
+  });
+  const walkPages = (_a = walk.data) == null ? void 0 : _a.pages;
+  const staleWalk = cursorStale.isCursorStale(walk.error) && ((walkPages == null ? void 0 : walkPages.length) ?? 0) > 0;
+  react.useEffect(() => {
+    if (!staleWalk) return;
+    void queryClient.resetQueries({ queryKey: walkKey });
+  }, [queryClient, staleWalk, walkKey]);
+  const fetchNextPage = walk.fetchNextPage;
+  const infinite = react.useMemo(() => {
+    if (!cursorParam) return void 0;
+    return {
+      hasMore: walk.hasNextPage,
+      loading: walk.isFetchingNextPage,
+      onLoadMore: () => void fetchNextPage()
+    };
+  }, [cursorParam, fetchNextPage, walk.hasNextPage, walk.isFetchingNextPage]);
+  const resetWalk = react.useCallback(() => {
+    void queryClient.resetQueries({ queryKey: walkKey });
+  }, [queryClient, walkKey]);
+  const refetchSingle = single.refetch;
+  if (!cursorParam) {
+    return {
+      pages: single.data ? [single.data] : [],
+      response: single.data ?? null,
+      isFetching: single.isFetching,
+      isPending: single.isPending,
+      isError: single.isError,
+      error: single.error,
+      refetch: () => void refetchSingle()
+    };
+  }
+  const pages = walkPages ?? [];
+  return {
+    pages,
+    response: pages[pages.length - 1] ?? null,
+    // Fetching the next page grows the run; it does not replace it. Reporting
+    // it as a load of the whole surface is what drops a spinner over rows the
+    // reader is still reading.
+    isFetching: walk.isFetching && !walk.isFetchingNextPage,
+    isPending: walk.isPending,
+    isError: walk.isError && !staleWalk,
+    error: staleWalk ? void 0 : walk.error,
+    // A mutation just changed the rows this walk was cut from, so its cursors
+    // no longer name positions in it. Starting over is the only honest refetch.
+    refetch: resetWalk,
+    ...infinite ? { infinite } : {}
+  };
+}
+exports.useOperationPages = useOperationPages;
+//# sourceMappingURL=useOperationPages.cjs.map

package/dist/rpc/useOperationPages.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useOperationPages.cjs","sources":["../../src/rpc/useOperationPages.ts"],"sourcesContent":["import { useCallback, useEffect, useMemo } from \"react\";\nimport {\n  keepPreviousData,\n  useInfiniteQuery,\n  useQuery,\n  useQueryClient,\n  type InfiniteData,\n  type QueryKey,\n} from \"@tanstack/react-query\";\n\nimport type { DataTableInfinite } from \"../data/DataTable\";\nimport { cursorParameterName, isCursorStale } from \"./cursorStale\";\nimport { packParameterValues, type ParameterValues } from \"./formMetadata\";\nimport type {\n  ExecutionResponse,\n  OpenAPIParameter,\n  ResolvedOperation,\n} from \"./types\";\nimport type { OperationsApiClient } from \"./useOperations\";\n\nconst LIST_KEY = \"operation-list\";\nconst CLICKY_HEADERS = { Accept: \"application/json+clicky\" };\n\nexport type OperationPagesOptions = {\n  client: OperationsApiClient;\n  /** The list operation, or undefined for a surface that has none. */\n  endpoint: ResolvedOperation | undefined;\n  /** Every parameter the operation declares — the source of the cursor role. */\n  parameters: OpenAPIParameter[];\n  /** Current filter/pagination state, as the catalog holds and URL-mirrors it. */\n  filters: ParameterValues;\n};\n\nexport type OperationPages = {\n  /** Every page fetched so far, oldest first. One entry outside a walk. */\n  pages: ExecutionResponse[];\n  /** The newest page — what every renderer means by \"the response\". */\n  response: ExecutionResponse | null;\n  /** True while the whole result is being replaced, not while it is growing. */\n  isFetching: boolean;\n  isPending: boolean;\n  isError: boolean;\n  error: unknown;\n  /** Re-runs the list. A walk restarts rather than replaying its cursors. */\n  refetch: () => void;\n  /** Load-more handle; absent unless the operation can walk by cursor. */\n  infinite?: DataTableInfinite;\n};\n\n/**\n * useOperationPages runs a surface's list operation, walking it forward when it\n * declares a cursor and fetching a single page when it does not.\n *\n * The mode is the operation's to decide, not the caller's: a cursor role is the\n * server saying \"you may resume this query\", and everything else — the majority\n * of surfaces — keeps the single-page query it has always had, replacing its\n * rows when the offset moves.\n *\n * In walk mode the cursor is deliberately absent from the query key. The key is\n * the identity of the query being walked, and the cursor is a position inside\n * it; keying on it made every page a different query, which is precisely why\n * advancing replaced the rows instead of extending them. Every other filter\n * stays in the key, so any filter, parameter or time-range change starts a new\n * walk on its own, with no reset logic layered on top.\n */\nexport function useOperationPages({\n  client,\n  endpoint,\n  parameters,\n  filters,\n}: OperationPagesOptions): OperationPages {\n  const queryClient = useQueryClient();\n  const cursorParam = cursorParameterName(parameters);\n  const path = endpoint?.path;\n  const method = endpoint?.method;\n\n  // The walk's own view of the filters: everything that identifies the query,\n  // with the position taken out. A cursor left over in the URL from a shared\n  // link names a position in a walk this session never made, so it is dropped\n  // rather than replayed.\n  const walkFilters = useMemo(() => {\n    if (!cursorParam) return filters;\n    const rest = { ...filters };\n    delete rest[cursorParam];\n    return rest;\n  }, [cursorParam, filters]);\n\n  const execute = useCallback(\n    (values: ParameterValues) =>\n      client.executeCommand(\n        path!,\n        method!,\n        packParameterValues(values, parameters),\n        CLICKY_HEADERS,\n      ),\n    [client, method, parameters, path],\n  );\n\n  // Both queries are declared on every render — hooks are not conditional — and\n  // exactly one is enabled. Their keys differ in shape as well as content, so a\n  // surface that switches modes can never read a page array as a page.\n  const single = useQuery<ExecutionResponse>({\n    queryKey: [LIST_KEY, method, path, filters],\n    queryFn: () => execute(filters),\n    enabled: !!endpoint && !cursorParam,\n    placeholderData: keepPreviousData,\n    staleTime: 30_000,\n    retry: 0,\n  });\n\n  // Prefixed with the same LIST_KEY as the single-page query: host apps\n  // invalidate [\"operation-list\"] after a mutation, and a walk that fell\n  // outside that prefix would keep serving rows the mutation changed.\n  const walkKey = useMemo(\n    () => [LIST_KEY, \"walk\", method, path, walkFilters],\n    [method, path, walkFilters],\n  );\n\n  const walk = useInfiniteQuery<\n    ExecutionResponse,\n    Error,\n    InfiniteData<ExecutionResponse, string | undefined>,\n    QueryKey,\n    string | undefined\n  >({\n    queryKey: walkKey,\n    queryFn: ({ pageParam }) =>\n      execute(pageParam ? { ...walkFilters, [cursorParam!]: pageParam } : walkFilters),\n    initialPageParam: undefined,\n    // The server's two answers, both required: it has more, and here is where\n    // to resume. A page claiming more without minting a token cannot be walked,\n    // and guessing one is how a client forges a position it was never given.\n    getNextPageParam: (lastPage) =>\n      lastPage.pagination?.hasMore ? lastPage.pagination.nextCursor : undefined,\n    enabled: !!endpoint && !!cursorParam,\n    placeholderData: keepPreviousData,\n    staleTime: 30_000,\n    retry: 0,\n  });\n\n  const walkPages = walk.data?.pages;\n\n  // A cursor the server refuses is recoverable by construction: the query is\n  // fine and only the position is gone, so the walk starts again instead of\n  // stranding the reader on an error panel they cannot page out of. Resetting\n  // is what does it — refetching would replay the very cursors that were\n  // refused, page by page.\n  //\n  // Guarded on a page having already been fetched, because only then can a\n  // cursor have been sent. A first page refused this way is a server that\n  // answers `cursor_stale` to a request carrying no cursor, and restarting on\n  // that spins: refuse, restart, refuse.\n  const staleWalk = isCursorStale(walk.error) && (walkPages?.length ?? 0) > 0;\n\n  useEffect(() => {\n    if (!staleWalk) return;\n    void queryClient.resetQueries({ queryKey: walkKey });\n  }, [queryClient, staleWalk, walkKey]);\n\n  const fetchNextPage = walk.fetchNextPage;\n  const infinite = useMemo<DataTableInfinite | undefined>(() => {\n    if (!cursorParam) return undefined;\n    return {\n      hasMore: walk.hasNextPage,\n      loading: walk.isFetchingNextPage,\n      onLoadMore: () => void fetchNextPage(),\n    };\n  }, [cursorParam, fetchNextPage, walk.hasNextPage, walk.isFetchingNextPage]);\n\n  const resetWalk = useCallback(() => {\n    void queryClient.resetQueries({ queryKey: walkKey });\n  }, [queryClient, walkKey]);\n  const refetchSingle = single.refetch;\n\n  if (!cursorParam) {\n    return {\n      pages: single.data ? [single.data] : [],\n      response: single.data ?? null,\n      isFetching: single.isFetching,\n      isPending: single.isPending,\n      isError: single.isError,\n      error: single.error,\n      refetch: () => void refetchSingle(),\n    };\n  }\n\n  const pages = walkPages ?? [];\n  return {\n    pages,\n    response: pages[pages.length - 1] ?? null,\n    // Fetching the next page grows the run; it does not replace it. Reporting\n    // it as a load of the whole surface is what drops a spinner over rows the\n    // reader is still reading.\n    isFetching: walk.isFetching && !walk.isFetchingNextPage,\n    isPending: walk.isPending,\n    isError: walk.isError && !staleWalk,\n    error: staleWalk ? undefined : walk.error,\n    // A mutation just changed the rows this walk was cut from, so its cursors\n    // no longer name positions in it. Starting over is the only honest refetch.\n    refetch: resetWalk,\n    ...(infinite ? { infinite } : {}),\n  };\n}\n"],"names":["useQueryClient","cursorParameterName","useMemo","useCallback","packParameterValues","useQuery","keepPreviousData","useInfiniteQuery","_a","isCursorStale","useEffect"],"mappings":"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"}

package/dist/rpc/useOperationPages.d.ts

@@ -0,0 +1,46 @@
+import { DataTableInfinite } from '../data/DataTable';
+import { ParameterValues } from './formMetadata';
+import { ExecutionResponse, OpenAPIParameter, ResolvedOperation } from './types';
+import { OperationsApiClient } from './useOperations';
+export type OperationPagesOptions = {
+    client: OperationsApiClient;
+    /** The list operation, or undefined for a surface that has none. */
+    endpoint: ResolvedOperation | undefined;
+    /** Every parameter the operation declares — the source of the cursor role. */
+    parameters: OpenAPIParameter[];
+    /** Current filter/pagination state, as the catalog holds and URL-mirrors it. */
+    filters: ParameterValues;
+};
+export type OperationPages = {
+    /** Every page fetched so far, oldest first. One entry outside a walk. */
+    pages: ExecutionResponse[];
+    /** The newest page — what every renderer means by "the response". */
+    response: ExecutionResponse | null;
+    /** True while the whole result is being replaced, not while it is growing. */
+    isFetching: boolean;
+    isPending: boolean;
+    isError: boolean;
+    error: unknown;
+    /** Re-runs the list. A walk restarts rather than replaying its cursors. */
+    refetch: () => void;
+    /** Load-more handle; absent unless the operation can walk by cursor. */
+    infinite?: DataTableInfinite;
+};
+/**
+ * useOperationPages runs a surface's list operation, walking it forward when it
+ * declares a cursor and fetching a single page when it does not.
+ *
+ * The mode is the operation's to decide, not the caller's: a cursor role is the
+ * server saying "you may resume this query", and everything else — the majority
+ * of surfaces — keeps the single-page query it has always had, replacing its
+ * rows when the offset moves.
+ *
+ * In walk mode the cursor is deliberately absent from the query key. The key is
+ * the identity of the query being walked, and the cursor is a position inside
+ * it; keying on it made every page a different query, which is precisely why
+ * advancing replaced the rows instead of extending them. Every other filter
+ * stays in the key, so any filter, parameter or time-range change starts a new
+ * walk on its own, with no reset logic layered on top.
+ */
+export declare function useOperationPages({ client, endpoint, parameters, filters, }: OperationPagesOptions): OperationPages;
+//# sourceMappingURL=useOperationPages.d.ts.map

package/dist/rpc/useOperationPages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useOperationPages.d.ts","sourceRoot":"","sources":["../../src/rpc/useOperationPages.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,OAAO,EAAuB,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC3E,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAK3D,MAAM,MAAM,qBAAqB,GAAG;IAClC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,oEAAoE;IACpE,QAAQ,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACxC,8EAA8E;IAC9E,UAAU,EAAE,gBAAgB,EAAE,CAAC;IAC/B,gFAAgF;IAChF,OAAO,EAAE,eAAe,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,yEAAyE;IACzE,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,qEAAqE;IACrE,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACnC,8EAA8E;IAC9E,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,2EAA2E;IAC3E,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CAC9B,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,MAAM,EACN,QAAQ,EACR,UAAU,EACV,OAAO,GACR,EAAE,qBAAqB,GAAG,cAAc,CAoIxC"}

package/dist/rpc/useOperationPages.js

@@ -0,0 +1,111 @@
+import { useMemo, useCallback, useEffect } from "react";
+import { useQueryClient, useQuery, keepPreviousData, useInfiniteQuery } from "@tanstack/react-query";
+import { cursorParameterName, isCursorStale } from "./cursorStale.js";
+import { packParameterValues } from "./formMetadata.js";
+const LIST_KEY = "operation-list";
+const CLICKY_HEADERS = { Accept: "application/json+clicky" };
+function useOperationPages({
+  client,
+  endpoint,
+  parameters,
+  filters
+}) {
+  var _a;
+  const queryClient = useQueryClient();
+  const cursorParam = cursorParameterName(parameters);
+  const path = endpoint == null ? void 0 : endpoint.path;
+  const method = endpoint == null ? void 0 : endpoint.method;
+  const walkFilters = useMemo(() => {
+    if (!cursorParam) return filters;
+    const rest = { ...filters };
+    delete rest[cursorParam];
+    return rest;
+  }, [cursorParam, filters]);
+  const execute = useCallback(
+    (values) => client.executeCommand(
+      path,
+      method,
+      packParameterValues(values, parameters),
+      CLICKY_HEADERS
+    ),
+    [client, method, parameters, path]
+  );
+  const single = useQuery({
+    queryKey: [LIST_KEY, method, path, filters],
+    queryFn: () => execute(filters),
+    enabled: !!endpoint && !cursorParam,
+    placeholderData: keepPreviousData,
+    staleTime: 3e4,
+    retry: 0
+  });
+  const walkKey = useMemo(
+    () => [LIST_KEY, "walk", method, path, walkFilters],
+    [method, path, walkFilters]
+  );
+  const walk = useInfiniteQuery({
+    queryKey: walkKey,
+    queryFn: ({ pageParam }) => execute(pageParam ? { ...walkFilters, [cursorParam]: pageParam } : walkFilters),
+    initialPageParam: void 0,
+    // The server's two answers, both required: it has more, and here is where
+    // to resume. A page claiming more without minting a token cannot be walked,
+    // and guessing one is how a client forges a position it was never given.
+    getNextPageParam: (lastPage) => {
+      var _a2;
+      return ((_a2 = lastPage.pagination) == null ? void 0 : _a2.hasMore) ? lastPage.pagination.nextCursor : void 0;
+    },
+    enabled: !!endpoint && !!cursorParam,
+    placeholderData: keepPreviousData,
+    staleTime: 3e4,
+    retry: 0
+  });
+  const walkPages = (_a = walk.data) == null ? void 0 : _a.pages;
+  const staleWalk = isCursorStale(walk.error) && ((walkPages == null ? void 0 : walkPages.length) ?? 0) > 0;
+  useEffect(() => {
+    if (!staleWalk) return;
+    void queryClient.resetQueries({ queryKey: walkKey });
+  }, [queryClient, staleWalk, walkKey]);
+  const fetchNextPage = walk.fetchNextPage;
+  const infinite = useMemo(() => {
+    if (!cursorParam) return void 0;
+    return {
+      hasMore: walk.hasNextPage,
+      loading: walk.isFetchingNextPage,
+      onLoadMore: () => void fetchNextPage()
+    };
+  }, [cursorParam, fetchNextPage, walk.hasNextPage, walk.isFetchingNextPage]);
+  const resetWalk = useCallback(() => {
+    void queryClient.resetQueries({ queryKey: walkKey });
+  }, [queryClient, walkKey]);
+  const refetchSingle = single.refetch;
+  if (!cursorParam) {
+    return {
+      pages: single.data ? [single.data] : [],
+      response: single.data ?? null,
+      isFetching: single.isFetching,
+      isPending: single.isPending,
+      isError: single.isError,
+      error: single.error,
+      refetch: () => void refetchSingle()
+    };
+  }
+  const pages = walkPages ?? [];
+  return {
+    pages,
+    response: pages[pages.length - 1] ?? null,
+    // Fetching the next page grows the run; it does not replace it. Reporting
+    // it as a load of the whole surface is what drops a spinner over rows the
+    // reader is still reading.
+    isFetching: walk.isFetching && !walk.isFetchingNextPage,
+    isPending: walk.isPending,
+    isError: walk.isError && !staleWalk,
+    error: staleWalk ? void 0 : walk.error,
+    // A mutation just changed the rows this walk was cut from, so its cursors
+    // no longer name positions in it. Starting over is the only honest refetch.
+    refetch: resetWalk,
+    ...infinite ? { infinite } : {}
+  };
+}
+export {
+  useOperationPages
+};
+//# sourceMappingURL=useOperationPages.js.map

package/dist/rpc/useOperationPages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useOperationPages.js","sources":["../../src/rpc/useOperationPages.ts"],"sourcesContent":["import { useCallback, useEffect, useMemo } from \"react\";\nimport {\n  keepPreviousData,\n  useInfiniteQuery,\n  useQuery,\n  useQueryClient,\n  type InfiniteData,\n  type QueryKey,\n} from \"@tanstack/react-query\";\n\nimport type { DataTableInfinite } from \"../data/DataTable\";\nimport { cursorParameterName, isCursorStale } from \"./cursorStale\";\nimport { packParameterValues, type ParameterValues } from \"./formMetadata\";\nimport type {\n  ExecutionResponse,\n  OpenAPIParameter,\n  ResolvedOperation,\n} from \"./types\";\nimport type { OperationsApiClient } from \"./useOperations\";\n\nconst LIST_KEY = \"operation-list\";\nconst CLICKY_HEADERS = { Accept: \"application/json+clicky\" };\n\nexport type OperationPagesOptions = {\n  client: OperationsApiClient;\n  /** The list operation, or undefined for a surface that has none. */\n  endpoint: ResolvedOperation | undefined;\n  /** Every parameter the operation declares — the source of the cursor role. */\n  parameters: OpenAPIParameter[];\n  /** Current filter/pagination state, as the catalog holds and URL-mirrors it. */\n  filters: ParameterValues;\n};\n\nexport type OperationPages = {\n  /** Every page fetched so far, oldest first. One entry outside a walk. */\n  pages: ExecutionResponse[];\n  /** The newest page — what every renderer means by \"the response\". */\n  response: ExecutionResponse | null;\n  /** True while the whole result is being replaced, not while it is growing. */\n  isFetching: boolean;\n  isPending: boolean;\n  isError: boolean;\n  error: unknown;\n  /** Re-runs the list. A walk restarts rather than replaying its cursors. */\n  refetch: () => void;\n  /** Load-more handle; absent unless the operation can walk by cursor. */\n  infinite?: DataTableInfinite;\n};\n\n/**\n * useOperationPages runs a surface's list operation, walking it forward when it\n * declares a cursor and fetching a single page when it does not.\n *\n * The mode is the operation's to decide, not the caller's: a cursor role is the\n * server saying \"you may resume this query\", and everything else — the majority\n * of surfaces — keeps the single-page query it has always had, replacing its\n * rows when the offset moves.\n *\n * In walk mode the cursor is deliberately absent from the query key. The key is\n * the identity of the query being walked, and the cursor is a position inside\n * it; keying on it made every page a different query, which is precisely why\n * advancing replaced the rows instead of extending them. Every other filter\n * stays in the key, so any filter, parameter or time-range change starts a new\n * walk on its own, with no reset logic layered on top.\n */\nexport function useOperationPages({\n  client,\n  endpoint,\n  parameters,\n  filters,\n}: OperationPagesOptions): OperationPages {\n  const queryClient = useQueryClient();\n  const cursorParam = cursorParameterName(parameters);\n  const path = endpoint?.path;\n  const method = endpoint?.method;\n\n  // The walk's own view of the filters: everything that identifies the query,\n  // with the position taken out. A cursor left over in the URL from a shared\n  // link names a position in a walk this session never made, so it is dropped\n  // rather than replayed.\n  const walkFilters = useMemo(() => {\n    if (!cursorParam) return filters;\n    const rest = { ...filters };\n    delete rest[cursorParam];\n    return rest;\n  }, [cursorParam, filters]);\n\n  const execute = useCallback(\n    (values: ParameterValues) =>\n      client.executeCommand(\n        path!,\n        method!,\n        packParameterValues(values, parameters),\n        CLICKY_HEADERS,\n      ),\n    [client, method, parameters, path],\n  );\n\n  // Both queries are declared on every render — hooks are not conditional — and\n  // exactly one is enabled. Their keys differ in shape as well as content, so a\n  // surface that switches modes can never read a page array as a page.\n  const single = useQuery<ExecutionResponse>({\n    queryKey: [LIST_KEY, method, path, filters],\n    queryFn: () => execute(filters),\n    enabled: !!endpoint && !cursorParam,\n    placeholderData: keepPreviousData,\n    staleTime: 30_000,\n    retry: 0,\n  });\n\n  // Prefixed with the same LIST_KEY as the single-page query: host apps\n  // invalidate [\"operation-list\"] after a mutation, and a walk that fell\n  // outside that prefix would keep serving rows the mutation changed.\n  const walkKey = useMemo(\n    () => [LIST_KEY, \"walk\", method, path, walkFilters],\n    [method, path, walkFilters],\n  );\n\n  const walk = useInfiniteQuery<\n    ExecutionResponse,\n    Error,\n    InfiniteData<ExecutionResponse, string | undefined>,\n    QueryKey,\n    string | undefined\n  >({\n    queryKey: walkKey,\n    queryFn: ({ pageParam }) =>\n      execute(pageParam ? { ...walkFilters, [cursorParam!]: pageParam } : walkFilters),\n    initialPageParam: undefined,\n    // The server's two answers, both required: it has more, and here is where\n    // to resume. A page claiming more without minting a token cannot be walked,\n    // and guessing one is how a client forges a position it was never given.\n    getNextPageParam: (lastPage) =>\n      lastPage.pagination?.hasMore ? lastPage.pagination.nextCursor : undefined,\n    enabled: !!endpoint && !!cursorParam,\n    placeholderData: keepPreviousData,\n    staleTime: 30_000,\n    retry: 0,\n  });\n\n  const walkPages = walk.data?.pages;\n\n  // A cursor the server refuses is recoverable by construction: the query is\n  // fine and only the position is gone, so the walk starts again instead of\n  // stranding the reader on an error panel they cannot page out of. Resetting\n  // is what does it — refetching would replay the very cursors that were\n  // refused, page by page.\n  //\n  // Guarded on a page having already been fetched, because only then can a\n  // cursor have been sent. A first page refused this way is a server that\n  // answers `cursor_stale` to a request carrying no cursor, and restarting on\n  // that spins: refuse, restart, refuse.\n  const staleWalk = isCursorStale(walk.error) && (walkPages?.length ?? 0) > 0;\n\n  useEffect(() => {\n    if (!staleWalk) return;\n    void queryClient.resetQueries({ queryKey: walkKey });\n  }, [queryClient, staleWalk, walkKey]);\n\n  const fetchNextPage = walk.fetchNextPage;\n  const infinite = useMemo<DataTableInfinite | undefined>(() => {\n    if (!cursorParam) return undefined;\n    return {\n      hasMore: walk.hasNextPage,\n      loading: walk.isFetchingNextPage,\n      onLoadMore: () => void fetchNextPage(),\n    };\n  }, [cursorParam, fetchNextPage, walk.hasNextPage, walk.isFetchingNextPage]);\n\n  const resetWalk = useCallback(() => {\n    void queryClient.resetQueries({ queryKey: walkKey });\n  }, [queryClient, walkKey]);\n  const refetchSingle = single.refetch;\n\n  if (!cursorParam) {\n    return {\n      pages: single.data ? [single.data] : [],\n      response: single.data ?? null,\n      isFetching: single.isFetching,\n      isPending: single.isPending,\n      isError: single.isError,\n      error: single.error,\n      refetch: () => void refetchSingle(),\n    };\n  }\n\n  const pages = walkPages ?? [];\n  return {\n    pages,\n    response: pages[pages.length - 1] ?? null,\n    // Fetching the next page grows the run; it does not replace it. Reporting\n    // it as a load of the whole surface is what drops a spinner over rows the\n    // reader is still reading.\n    isFetching: walk.isFetching && !walk.isFetchingNextPage,\n    isPending: walk.isPending,\n    isError: walk.isError && !staleWalk,\n    error: staleWalk ? undefined : walk.error,\n    // A mutation just changed the rows this walk was cut from, so its cursors\n    // no longer name positions in it. Starting over is the only honest refetch.\n    refetch: resetWalk,\n    ...(infinite ? { infinite } : {}),\n  };\n}\n"],"names":["_a"],"mappings":"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"}

package/dist/rpc/useOperations.cjs

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const reactQuery = require("@tanstack/react-query");
+const react = require("react");
 function useOpenAPI(client) {
   return reactQuery.useQuery({
     queryKey: ["openapi-spec"],
@@ -10,14 +11,16 @@ function useOpenAPI(client) {
 }
 function useOperations(client) {
   const { data: spec, ...rest } = useOpenAPI(client);
-  const operations = [];
-  if (spec) {
+  const operations = react.useMemo(() => {
+    if (!spec) return [];
+    const resolved = [];
     for (const [path, methods] of Object.entries(spec.paths)) {
       for (const [method, operation] of Object.entries(methods)) {
-        operations.push({ path, method, operation });
+        resolved.push({ path, method, operation });
       }
     }
-  }
+    return resolved;
+  }, [spec]);
   return { operations, spec, ...rest };
 }
 function useOperationById(client, operationId) {

package/dist/rpc/useOperations.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"useOperations.cjs","sources":["../../src/rpc/useOperations.ts"],"sourcesContent":["import { useQuery } from \"@tanstack/react-query\";\nimport type { JsonSchemaObject } from \"../components/json-schema-form-types\";\nimport type {\n  ExecutionResponse,\n  OpenAPISpec,\n  OperationLookupFilter,\n  OperationLookupResponse,\n  ResolvedOperation,\n} from \"./types\";\n\nexport interface OperationsApiClient {\n  getOpenAPISpec(): Promise<OpenAPISpec>;\n  executeCommand(\n    path: string,\n    method: string,\n    params: Record<string, string>,\n    headers?: Record<string, string>,\n  ): Promise<ExecutionResponse>;\n  lookupFilters?(\n    path: string,\n    method: string,\n    params: Record<string, string>,\n    headers?: Record<string, string>,\n  ): Promise<OperationLookupResponse>;\n  lookupFilterOptions?(\n    path: string,\n    method: string,\n    filterKey: string,\n    query: string,\n    // Extra query params merged into the lookup request (e.g. a scope filter\n    // derived from a sibling form field). Lets a form-field lookup narrow the\n    // option set beyond the search term.\n    extraParams?: Record<string, string>,\n  ): Promise<OperationLookupFilter>;\n  // getSchema fetches a resource's JSON Schema via content negotiation; undefined\n  // when the resource exposes none. submitForm sends a nested JSON body (create\n  // POST / update PUT) preserving nested objects and arrays. Both are optional so\n  // alternative client implementations can omit schema-driven forms.\n  getSchema?(path: string): Promise<JsonSchemaObject | undefined>;\n  submitForm?(\n    path: string,\n    method: string,\n    body: Record<string, unknown>,\n    headers?: Record<string, string>,\n  ): Promise<ExecutionResponse>;\n}\n\nexport function useOpenAPI(client: OperationsApiClient) {\n  return useQuery<OpenAPISpec>({\n    queryKey: [\"openapi-spec\"],\n    queryFn: () => client.getOpenAPISpec(),\n    staleTime: 5 * 60 * 1000,\n  });\n}\n\nexport function useOperations(client: OperationsApiClient) {\n  const { data: spec, ...rest } = useOpenAPI(client);\n\n  const operations: ResolvedOperation[] = [];\n  if (spec) {\n    for (const [path, methods] of Object.entries(spec.paths)) {\n      for (const [method, operation] of Object.entries(methods)) {\n        operations.push({ path, method, operation });\n      }\n    }\n  }\n\n  return { operations, spec, ...rest };\n}\n\nexport function useOperationById(client: OperationsApiClient, operationId: string | undefined) {\n  const { operations, ...rest } = useOperations(client);\n  const operation = operationId\n    ? operations.find((op) => op.operation.operationId === operationId)\n    : undefined;\n  return { operation, ...rest };\n}\n"],"names":["useQuery"],"mappings":";;;AA+CO,SAAS,WAAW,QAA6B;AACtD,SAAOA,oBAAsB;AAAA,IAC3B,UAAU,CAAC,cAAc;AAAA,IACzB,SAAS,MAAM,OAAO,eAAA;AAAA,IACtB,WAAW,IAAI,KAAK;AAAA,EAAA,CACrB;AACH;AAEO,SAAS,cAAc,QAA6B;AACzD,QAAM,EAAE,MAAM,MAAM,GAAG,KAAA,IAAS,WAAW,MAAM;AAEjD,QAAM,aAAkC,CAAA;AACxC,MAAI,MAAM;AACR,eAAW,CAAC,MAAM,OAAO,KAAK,OAAO,QAAQ,KAAK,KAAK,GAAG;AACxD,iBAAW,CAAC,QAAQ,SAAS,KAAK,OAAO,QAAQ,OAAO,GAAG;AACzD,mBAAW,KAAK,EAAE,MAAM,QAAQ,WAAW;AAAA,MAC7C;AAAA,IACF;AAAA,EACF;AAEA,SAAO,EAAE,YAAY,MAAM,GAAG,KAAA;AAChC;AAEO,SAAS,iBAAiB,QAA6B,aAAiC;AAC7F,QAAM,EAAE,YAAY,GAAG,KAAA,IAAS,cAAc,MAAM;AACpD,QAAM,YAAY,cACd,WAAW,KAAK,CAAC,OAAO,GAAG,UAAU,gBAAgB,WAAW,IAChE;AACJ,SAAO,EAAE,WAAW,GAAG,KAAA;AACzB;;;;"}
+{"version":3,"file":"useOperations.cjs","sources":["../../src/rpc/useOperations.ts"],"sourcesContent":["import { useQuery } from \"@tanstack/react-query\";\nimport { useMemo } from \"react\";\nimport type { JsonSchemaObject } from \"../components/json-schema-form-types\";\nimport type {\n  ExecutionResponse,\n  OpenAPISpec,\n  OperationLookupFilter,\n  OperationLookupResponse,\n  ResolvedOperation,\n} from \"./types\";\n\nexport interface OperationsApiClient {\n  getOpenAPISpec(): Promise<OpenAPISpec>;\n  executeCommand(\n    path: string,\n    method: string,\n    params: Record<string, string>,\n    headers?: Record<string, string>,\n  ): Promise<ExecutionResponse>;\n  lookupFilters?(\n    path: string,\n    method: string,\n    params: Record<string, string>,\n    headers?: Record<string, string>,\n  ): Promise<OperationLookupResponse>;\n  lookupFilterOptions?(\n    path: string,\n    method: string,\n    filterKey: string,\n    query: string,\n    // Extra query params merged into the lookup request (e.g. a scope filter\n    // derived from a sibling form field). Lets a form-field lookup narrow the\n    // option set beyond the search term.\n    extraParams?: Record<string, string>,\n  ): Promise<OperationLookupFilter>;\n  // getSchema fetches a resource's JSON Schema via content negotiation; undefined\n  // when the resource exposes none. submitForm sends a nested JSON body (create\n  // POST / update PUT) preserving nested objects and arrays. Both are optional so\n  // alternative client implementations can omit schema-driven forms.\n  getSchema?(path: string): Promise<JsonSchemaObject | undefined>;\n  submitForm?(\n    path: string,\n    method: string,\n    body: Record<string, unknown>,\n    headers?: Record<string, string>,\n  ): Promise<ExecutionResponse>;\n}\n\nexport function useOpenAPI(client: OperationsApiClient) {\n  return useQuery<OpenAPISpec>({\n    queryKey: [\"openapi-spec\"],\n    queryFn: () => client.getOpenAPISpec(),\n    staleTime: 5 * 60 * 1000,\n  });\n}\n\nexport function useOperations(client: OperationsApiClient) {\n  const { data: spec, ...rest } = useOpenAPI(client);\n\n  // Flattening a hundred operations is cheap once and wasteful on every render\n  // of every page that reads the catalog — and callers memoize off this array,\n  // so a fresh identity re-runs their work too.\n  const operations = useMemo<ResolvedOperation[]>(() => {\n    if (!spec) return [];\n    const resolved: ResolvedOperation[] = [];\n    for (const [path, methods] of Object.entries(spec.paths)) {\n      for (const [method, operation] of Object.entries(methods)) {\n        resolved.push({ path, method, operation });\n      }\n    }\n    return resolved;\n  }, [spec]);\n\n  return { operations, spec, ...rest };\n}\n\nexport function useOperationById(client: OperationsApiClient, operationId: string | undefined) {\n  const { operations, ...rest } = useOperations(client);\n  const operation = operationId\n    ? operations.find((op) => op.operation.operationId === operationId)\n    : undefined;\n  return { operation, ...rest };\n}\n"],"names":["useQuery","useMemo"],"mappings":";;;;AAgDO,SAAS,WAAW,QAA6B;AACtD,SAAOA,oBAAsB;AAAA,IAC3B,UAAU,CAAC,cAAc;AAAA,IACzB,SAAS,MAAM,OAAO,eAAA;AAAA,IACtB,WAAW,IAAI,KAAK;AAAA,EAAA,CACrB;AACH;AAEO,SAAS,cAAc,QAA6B;AACzD,QAAM,EAAE,MAAM,MAAM,GAAG,KAAA,IAAS,WAAW,MAAM;AAKjD,QAAM,aAAaC,MAAAA,QAA6B,MAAM;AACpD,QAAI,CAAC,KAAM,QAAO,CAAA;AAClB,UAAM,WAAgC,CAAA;AACtC,eAAW,CAAC,MAAM,OAAO,KAAK,OAAO,QAAQ,KAAK,KAAK,GAAG;AACxD,iBAAW,CAAC,QAAQ,SAAS,KAAK,OAAO,QAAQ,OAAO,GAAG;AACzD,iBAAS,KAAK,EAAE,MAAM,QAAQ,WAAW;AAAA,MAC3C;AAAA,IACF;AACA,WAAO;AAAA,EACT,GAAG,CAAC,IAAI,CAAC;AAET,SAAO,EAAE,YAAY,MAAM,GAAG,KAAA;AAChC;AAEO,SAAS,iBAAiB,QAA6B,aAAiC;AAC7F,QAAM,EAAE,YAAY,GAAG,KAAA,IAAS,cAAc,MAAM;AACpD,QAAM,YAAY,cACd,WAAW,KAAK,CAAC,OAAO,GAAG,UAAU,gBAAgB,WAAW,IAChE;AACJ,SAAO,EAAE,WAAW,GAAG,KAAA;AACzB;;;;"}

package/dist/rpc/useOperations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useOperations.d.ts","sourceRoot":"","sources":["../../src/rpc/useOperations.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,OAAO,KAAK,EACV,iBAAiB,EACjB,WAAW,EACX,qBAAqB,EACrB,uBAAuB,EACvB,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAEjB,MAAM,WAAW,mBAAmB;IAClC,cAAc,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;IACvC,cAAc,CACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC9B,aAAa,CAAC,CACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC,uBAAuB,CAAC,CAAC;IACpC,mBAAmB,CAAC,CAClB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EAIb,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACnC,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAKlC,SAAS,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAAC;IAChE,UAAU,CAAC,CACT,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC/B;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,mBAAmB,sEAMrD;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAaxD;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,GAAG,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAM5F"}
+{"version":3,"file":"useOperations.d.ts","sourceRoot":"","sources":["../../src/rpc/useOperations.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,OAAO,KAAK,EACV,iBAAiB,EACjB,WAAW,EACX,qBAAqB,EACrB,uBAAuB,EACvB,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAEjB,MAAM,WAAW,mBAAmB;IAClC,cAAc,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;IACvC,cAAc,CACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC9B,aAAa,CAAC,CACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC,uBAAuB,CAAC,CAAC;IACpC,mBAAmB,CAAC,CAClB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EAIb,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACnC,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAKlC,SAAS,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAAC;IAChE,UAAU,CAAC,CACT,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC/B;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,mBAAmB,sEAMrD;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkBxD;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,GAAG,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAM5F"}

package/dist/rpc/useOperations.js

@@ -1,4 +1,5 @@
 import { useQuery } from "@tanstack/react-query";
+import { useMemo } from "react";
 function useOpenAPI(client) {
   return useQuery({
     queryKey: ["openapi-spec"],
@@ -8,14 +9,16 @@ function useOpenAPI(client) {
 }
 function useOperations(client) {
   const { data: spec, ...rest } = useOpenAPI(client);
-  const operations = [];
-  if (spec) {
+  const operations = useMemo(() => {
+    if (!spec) return [];
+    const resolved = [];
     for (const [path, methods] of Object.entries(spec.paths)) {
       for (const [method, operation] of Object.entries(methods)) {
-        operations.push({ path, method, operation });
+        resolved.push({ path, method, operation });
       }
     }
-  }
+    return resolved;
+  }, [spec]);
   return { operations, spec, ...rest };
 }
 function useOperationById(client, operationId) {

package/dist/rpc/useOperations.js.map

@@ -1 +1 @@
-{"version":3,"file":"useOperations.js","sources":["../../src/rpc/useOperations.ts"],"sourcesContent":["import { useQuery } from \"@tanstack/react-query\";\nimport type { JsonSchemaObject } from \"../components/json-schema-form-types\";\nimport type {\n  ExecutionResponse,\n  OpenAPISpec,\n  OperationLookupFilter,\n  OperationLookupResponse,\n  ResolvedOperation,\n} from \"./types\";\n\nexport interface OperationsApiClient {\n  getOpenAPISpec(): Promise<OpenAPISpec>;\n  executeCommand(\n    path: string,\n    method: string,\n    params: Record<string, string>,\n    headers?: Record<string, string>,\n  ): Promise<ExecutionResponse>;\n  lookupFilters?(\n    path: string,\n    method: string,\n    params: Record<string, string>,\n    headers?: Record<string, string>,\n  ): Promise<OperationLookupResponse>;\n  lookupFilterOptions?(\n    path: string,\n    method: string,\n    filterKey: string,\n    query: string,\n    // Extra query params merged into the lookup request (e.g. a scope filter\n    // derived from a sibling form field). Lets a form-field lookup narrow the\n    // option set beyond the search term.\n    extraParams?: Record<string, string>,\n  ): Promise<OperationLookupFilter>;\n  // getSchema fetches a resource's JSON Schema via content negotiation; undefined\n  // when the resource exposes none. submitForm sends a nested JSON body (create\n  // POST / update PUT) preserving nested objects and arrays. Both are optional so\n  // alternative client implementations can omit schema-driven forms.\n  getSchema?(path: string): Promise<JsonSchemaObject | undefined>;\n  submitForm?(\n    path: string,\n    method: string,\n    body: Record<string, unknown>,\n    headers?: Record<string, string>,\n  ): Promise<ExecutionResponse>;\n}\n\nexport function useOpenAPI(client: OperationsApiClient) {\n  return useQuery<OpenAPISpec>({\n    queryKey: [\"openapi-spec\"],\n    queryFn: () => client.getOpenAPISpec(),\n    staleTime: 5 * 60 * 1000,\n  });\n}\n\nexport function useOperations(client: OperationsApiClient) {\n  const { data: spec, ...rest } = useOpenAPI(client);\n\n  const operations: ResolvedOperation[] = [];\n  if (spec) {\n    for (const [path, methods] of Object.entries(spec.paths)) {\n      for (const [method, operation] of Object.entries(methods)) {\n        operations.push({ path, method, operation });\n      }\n    }\n  }\n\n  return { operations, spec, ...rest };\n}\n\nexport function useOperationById(client: OperationsApiClient, operationId: string | undefined) {\n  const { operations, ...rest } = useOperations(client);\n  const operation = operationId\n    ? operations.find((op) => op.operation.operationId === operationId)\n    : undefined;\n  return { operation, ...rest };\n}\n"],"names":[],"mappings":";AA+CO,SAAS,WAAW,QAA6B;AACtD,SAAO,SAAsB;AAAA,IAC3B,UAAU,CAAC,cAAc;AAAA,IACzB,SAAS,MAAM,OAAO,eAAA;AAAA,IACtB,WAAW,IAAI,KAAK;AAAA,EAAA,CACrB;AACH;AAEO,SAAS,cAAc,QAA6B;AACzD,QAAM,EAAE,MAAM,MAAM,GAAG,KAAA,IAAS,WAAW,MAAM;AAEjD,QAAM,aAAkC,CAAA;AACxC,MAAI,MAAM;AACR,eAAW,CAAC,MAAM,OAAO,KAAK,OAAO,QAAQ,KAAK,KAAK,GAAG;AACxD,iBAAW,CAAC,QAAQ,SAAS,KAAK,OAAO,QAAQ,OAAO,GAAG;AACzD,mBAAW,KAAK,EAAE,MAAM,QAAQ,WAAW;AAAA,MAC7C;AAAA,IACF;AAAA,EACF;AAEA,SAAO,EAAE,YAAY,MAAM,GAAG,KAAA;AAChC;AAEO,SAAS,iBAAiB,QAA6B,aAAiC;AAC7F,QAAM,EAAE,YAAY,GAAG,KAAA,IAAS,cAAc,MAAM;AACpD,QAAM,YAAY,cACd,WAAW,KAAK,CAAC,OAAO,GAAG,UAAU,gBAAgB,WAAW,IAChE;AACJ,SAAO,EAAE,WAAW,GAAG,KAAA;AACzB;"}
+{"version":3,"file":"useOperations.js","sources":["../../src/rpc/useOperations.ts"],"sourcesContent":["import { useQuery } from \"@tanstack/react-query\";\nimport { useMemo } from \"react\";\nimport type { JsonSchemaObject } from \"../components/json-schema-form-types\";\nimport type {\n  ExecutionResponse,\n  OpenAPISpec,\n  OperationLookupFilter,\n  OperationLookupResponse,\n  ResolvedOperation,\n} from \"./types\";\n\nexport interface OperationsApiClient {\n  getOpenAPISpec(): Promise<OpenAPISpec>;\n  executeCommand(\n    path: string,\n    method: string,\n    params: Record<string, string>,\n    headers?: Record<string, string>,\n  ): Promise<ExecutionResponse>;\n  lookupFilters?(\n    path: string,\n    method: string,\n    params: Record<string, string>,\n    headers?: Record<string, string>,\n  ): Promise<OperationLookupResponse>;\n  lookupFilterOptions?(\n    path: string,\n    method: string,\n    filterKey: string,\n    query: string,\n    // Extra query params merged into the lookup request (e.g. a scope filter\n    // derived from a sibling form field). Lets a form-field lookup narrow the\n    // option set beyond the search term.\n    extraParams?: Record<string, string>,\n  ): Promise<OperationLookupFilter>;\n  // getSchema fetches a resource's JSON Schema via content negotiation; undefined\n  // when the resource exposes none. submitForm sends a nested JSON body (create\n  // POST / update PUT) preserving nested objects and arrays. Both are optional so\n  // alternative client implementations can omit schema-driven forms.\n  getSchema?(path: string): Promise<JsonSchemaObject | undefined>;\n  submitForm?(\n    path: string,\n    method: string,\n    body: Record<string, unknown>,\n    headers?: Record<string, string>,\n  ): Promise<ExecutionResponse>;\n}\n\nexport function useOpenAPI(client: OperationsApiClient) {\n  return useQuery<OpenAPISpec>({\n    queryKey: [\"openapi-spec\"],\n    queryFn: () => client.getOpenAPISpec(),\n    staleTime: 5 * 60 * 1000,\n  });\n}\n\nexport function useOperations(client: OperationsApiClient) {\n  const { data: spec, ...rest } = useOpenAPI(client);\n\n  // Flattening a hundred operations is cheap once and wasteful on every render\n  // of every page that reads the catalog — and callers memoize off this array,\n  // so a fresh identity re-runs their work too.\n  const operations = useMemo<ResolvedOperation[]>(() => {\n    if (!spec) return [];\n    const resolved: ResolvedOperation[] = [];\n    for (const [path, methods] of Object.entries(spec.paths)) {\n      for (const [method, operation] of Object.entries(methods)) {\n        resolved.push({ path, method, operation });\n      }\n    }\n    return resolved;\n  }, [spec]);\n\n  return { operations, spec, ...rest };\n}\n\nexport function useOperationById(client: OperationsApiClient, operationId: string | undefined) {\n  const { operations, ...rest } = useOperations(client);\n  const operation = operationId\n    ? operations.find((op) => op.operation.operationId === operationId)\n    : undefined;\n  return { operation, ...rest };\n}\n"],"names":[],"mappings":";;AAgDO,SAAS,WAAW,QAA6B;AACtD,SAAO,SAAsB;AAAA,IAC3B,UAAU,CAAC,cAAc;AAAA,IACzB,SAAS,MAAM,OAAO,eAAA;AAAA,IACtB,WAAW,IAAI,KAAK;AAAA,EAAA,CACrB;AACH;AAEO,SAAS,cAAc,QAA6B;AACzD,QAAM,EAAE,MAAM,MAAM,GAAG,KAAA,IAAS,WAAW,MAAM;AAKjD,QAAM,aAAa,QAA6B,MAAM;AACpD,QAAI,CAAC,KAAM,QAAO,CAAA;AAClB,UAAM,WAAgC,CAAA;AACtC,eAAW,CAAC,MAAM,OAAO,KAAK,OAAO,QAAQ,KAAK,KAAK,GAAG;AACxD,iBAAW,CAAC,QAAQ,SAAS,KAAK,OAAO,QAAQ,OAAO,GAAG;AACzD,iBAAS,KAAK,EAAE,MAAM,QAAQ,WAAW;AAAA,MAC3C;AAAA,IACF;AACA,WAAO;AAAA,EACT,GAAG,CAAC,IAAI,CAAC;AAET,SAAO,EAAE,YAAY,MAAM,GAAG,KAAA;AAChC;AAEO,SAAS,iBAAiB,QAA6B,aAAiC;AAC7F,QAAM,EAAE,YAAY,GAAG,KAAA,IAAS,cAAc,MAAM;AACpD,QAAM,YAAY,cACd,WAAW,KAAK,CAAC,OAAO,GAAG,UAAU,gBAAgB,WAAW,IAChE;AACJ,SAAO,EAAE,WAAW,GAAG,KAAA;AACzB;"}

package/dist/rpc.cjs

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const OperationCatalog = require("./rpc/OperationCatalog.cjs");
 const EntityExplorerApp = require("./rpc/EntityExplorerApp.cjs");
+const ChatLayer = require("./rpc/ChatLayer.cjs");
 const acceptOptions = require("./rpc/accept-options.cjs");
 const SchemaActionForm = require("./rpc/SchemaActionForm.cjs");
 const operationLookupFetcher = require("./rpc/operationLookupFetcher.cjs");
@@ -27,6 +28,7 @@ const RouterProvider = require("./rpc/RouterProvider.cjs");
 const types = require("./rpc/types.cjs");
 exports.OperationCatalog = OperationCatalog.OperationCatalog;
 exports.EntityExplorerApp = EntityExplorerApp.EntityExplorerApp;
+exports.ChatLayer = ChatLayer.ChatLayer;
 exports.ACCEPT_OPTIONS = acceptOptions.ACCEPT_OPTIONS;
 exports.VIEW_OPTIONS = acceptOptions.VIEW_OPTIONS;
 exports.SchemaActionForm = SchemaActionForm.SchemaActionForm;