@flanksource/clicky-ui 0.3.36 → 0.3.38

package/dist/rpc/sessionHeaderModel.js

@@ -0,0 +1,54 @@
+import { isSessionTerminal } from "./sessionTypes.js";
+const SECOND = 1e3;
+const MINUTE = 60 * SECOND;
+const HOUR = 60 * MINUTE;
+const DEFAULT_SESSION_DURATION_PRESETS_MS = [5 * MINUTE, 15 * MINUTE, HOUR];
+function sessionControls(session) {
+  const active = !isSessionTerminal(session.state);
+  const live = session.controllable && active;
+  const stopping = session.state === "stopping";
+  return {
+    stop: { visible: live, disabled: stopping },
+    extend: { visible: live, disabled: stopping },
+    restart: { visible: session.restartable && !active }
+  };
+}
+function formatSessionStoreLocation(store) {
+  const parts = [store.file && `in ${store.file}`, store.host && `on ${store.host}`].filter(Boolean);
+  return parts.length > 0 ? parts.join(" ") : `on the ${store.backend} store`;
+}
+function formatSessionDuration(ms) {
+  const total = Math.max(0, Math.round(ms / SECOND));
+  const hours = Math.floor(total / 3600);
+  const minutes = Math.floor(total % 3600 / 60);
+  const seconds = total % 60;
+  const parts = [];
+  if (hours > 0) parts.push(`${hours}h`);
+  if (minutes > 0) parts.push(`${minutes}m`);
+  if (seconds > 0 || parts.length === 0) parts.push(`${seconds}s`);
+  return parts.join(" ");
+}
+function formatSessionCountdown(stopAt, now) {
+  const deadline = Date.parse(stopAt);
+  if (Number.isNaN(deadline)) throw new Error(`session stopAt is not a timestamp: ${stopAt}`);
+  const remaining = deadline - now;
+  return remaining >= 0 ? `Stops in ${formatSessionDuration(remaining)}` : `Deadline passed ${formatSessionDuration(-remaining)} ago`;
+}
+const SESSION_STATE_TONES = {
+  starting: "info",
+  running: "info",
+  stopping: "warning",
+  completed: "success",
+  stopped: "neutral",
+  failed: "danger",
+  interrupted: "warning"
+};
+export {
+  DEFAULT_SESSION_DURATION_PRESETS_MS,
+  SESSION_STATE_TONES,
+  formatSessionCountdown,
+  formatSessionDuration,
+  formatSessionStoreLocation,
+  sessionControls
+};
+//# sourceMappingURL=sessionHeaderModel.js.map

package/dist/rpc/sessionHeaderModel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionHeaderModel.js","sources":["../../src/rpc/sessionHeaderModel.ts"],"sourcesContent":["import {\n  isSessionTerminal,\n  type SessionInfo,\n  type SessionState,\n  type SessionStoreLocation,\n} from \"./sessionTypes\";\n\nconst SECOND = 1_000;\nconst MINUTE = 60 * SECOND;\nconst HOUR = 60 * MINUTE;\n\nexport const DEFAULT_SESSION_DURATION_PRESETS_MS: readonly number[] = [5 * MINUTE, 15 * MINUTE, HOUR];\n\nexport type SessionControls = {\n  stop: { visible: boolean; disabled: boolean };\n  extend: { visible: boolean; disabled: boolean };\n  restart: { visible: boolean };\n};\n\n/**\n * sessionControls decides which control actions a header offers.\n *\n * Stop and Extend act on the live session, so they need `controllable` (this\n * process's registry holds it) and an active state; a session already\n * `stopping` keeps them on screen but disabled so the reader sees the stop in\n * flight. Restart replays the start record through the host's RestartFunc and\n * never touches the old session, so it follows the API's `restartable` alone\n * — an interrupted run whose owner is gone is exactly the one worth\n * restarting, and no registry holds it.\n */\nexport function sessionControls(session: SessionInfo): SessionControls {\n  const active = !isSessionTerminal(session.state);\n  const live = session.controllable && active;\n  const stopping = session.state === \"stopping\";\n  return {\n    stop: { visible: live, disabled: stopping },\n    extend: { visible: live, disabled: stopping },\n    restart: { visible: session.restartable && !active },\n  };\n}\n\n/**\n * Where a store is, from only the parts the server sent: \"in <file> on\n * <host>\", \"on <host>\", \"in <file>\", or \"on the <backend> store\" when the\n * backend has neither (a kv store).\n */\nexport function formatSessionStoreLocation(store: SessionStoreLocation): string {\n  const parts = [store.file && `in ${store.file}`, store.host && `on ${store.host}`].filter(Boolean);\n  return parts.length > 0 ? parts.join(\" \") : `on the ${store.backend} store`;\n}\n\nexport function formatSessionDuration(ms: number): string {\n  const total = Math.max(0, Math.round(ms / SECOND));\n  const hours = Math.floor(total / 3600);\n  const minutes = Math.floor((total % 3600) / 60);\n  const seconds = total % 60;\n  const parts: string[] = [];\n  if (hours > 0) parts.push(`${hours}h`);\n  if (minutes > 0) parts.push(`${minutes}m`);\n  if (seconds > 0 || parts.length === 0) parts.push(`${seconds}s`);\n  return parts.join(\" \");\n}\n\n/** \"Stops in 5m 12s\" before the deadline, \"Deadline passed 30s ago\" after it. */\nexport function formatSessionCountdown(stopAt: string, now: number): string {\n  const deadline = Date.parse(stopAt);\n  if (Number.isNaN(deadline)) throw new Error(`session stopAt is not a timestamp: ${stopAt}`);\n  const remaining = deadline - now;\n  return remaining >= 0\n    ? `Stops in ${formatSessionDuration(remaining)}`\n    : `Deadline passed ${formatSessionDuration(-remaining)} ago`;\n}\n\nexport type SessionStateTone = \"neutral\" | \"success\" | \"danger\" | \"warning\" | \"info\";\n\nexport const SESSION_STATE_TONES: Record<SessionState, SessionStateTone> = {\n  starting: \"info\",\n  running: \"info\",\n  stopping: \"warning\",\n  completed: \"success\",\n  stopped: \"neutral\",\n  failed: \"danger\",\n  interrupted: \"warning\",\n};\n"],"names":[],"mappings":";AAOA,MAAM,SAAS;AACf,MAAM,SAAS,KAAK;AACpB,MAAM,OAAO,KAAK;AAEX,MAAM,sCAAyD,CAAC,IAAI,QAAQ,KAAK,QAAQ,IAAI;AAmB7F,SAAS,gBAAgB,SAAuC;AACrE,QAAM,SAAS,CAAC,kBAAkB,QAAQ,KAAK;AAC/C,QAAM,OAAO,QAAQ,gBAAgB;AACrC,QAAM,WAAW,QAAQ,UAAU;AACnC,SAAO;AAAA,IACL,MAAM,EAAE,SAAS,MAAM,UAAU,SAAA;AAAA,IACjC,QAAQ,EAAE,SAAS,MAAM,UAAU,SAAA;AAAA,IACnC,SAAS,EAAE,SAAS,QAAQ,eAAe,CAAC,OAAA;AAAA,EAAO;AAEvD;AAOO,SAAS,2BAA2B,OAAqC;AAC9E,QAAM,QAAQ,CAAC,MAAM,QAAQ,MAAM,MAAM,IAAI,IAAI,MAAM,QAAQ,MAAM,MAAM,IAAI,EAAE,EAAE,OAAO,OAAO;AACjG,SAAO,MAAM,SAAS,IAAI,MAAM,KAAK,GAAG,IAAI,UAAU,MAAM,OAAO;AACrE;AAEO,SAAS,sBAAsB,IAAoB;AACxD,QAAM,QAAQ,KAAK,IAAI,GAAG,KAAK,MAAM,KAAK,MAAM,CAAC;AACjD,QAAM,QAAQ,KAAK,MAAM,QAAQ,IAAI;AACrC,QAAM,UAAU,KAAK,MAAO,QAAQ,OAAQ,EAAE;AAC9C,QAAM,UAAU,QAAQ;AACxB,QAAM,QAAkB,CAAA;AACxB,MAAI,QAAQ,EAAG,OAAM,KAAK,GAAG,KAAK,GAAG;AACrC,MAAI,UAAU,EAAG,OAAM,KAAK,GAAG,OAAO,GAAG;AACzC,MAAI,UAAU,KAAK,MAAM,WAAW,EAAG,OAAM,KAAK,GAAG,OAAO,GAAG;AAC/D,SAAO,MAAM,KAAK,GAAG;AACvB;AAGO,SAAS,uBAAuB,QAAgB,KAAqB;AAC1E,QAAM,WAAW,KAAK,MAAM,MAAM;AAClC,MAAI,OAAO,MAAM,QAAQ,SAAS,IAAI,MAAM,sCAAsC,MAAM,EAAE;AAC1F,QAAM,YAAY,WAAW;AAC7B,SAAO,aAAa,IAChB,YAAY,sBAAsB,SAAS,CAAC,KAC5C,mBAAmB,sBAAsB,CAAC,SAAS,CAAC;AAC1D;AAIO,MAAM,sBAA8D;AAAA,EACzE,UAAU;AAAA,EACV,SAAS;AAAA,EACT,UAAU;AAAA,EACV,WAAW;AAAA,EACX,SAAS;AAAA,EACT,QAAQ;AAAA,EACR,aAAa;AACf;"}

package/dist/rpc/sessionTypes.cjs

@@ -0,0 +1,108 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const SESSION_STATES = [
+  "starting",
+  "running",
+  "stopping",
+  "completed",
+  "failed",
+  "stopped",
+  "interrupted"
+];
+const TERMINAL_STATES = /* @__PURE__ */ new Set([
+  "completed",
+  "failed",
+  "stopped",
+  "interrupted"
+]);
+function isSessionTerminal(state) {
+  return TERMINAL_STATES.has(state);
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isSessionState(value) {
+  return typeof value === "string" && SESSION_STATES.includes(value);
+}
+function parseSessionInfo(value, source) {
+  if (!isRecord(value)) {
+    throw new Error(`${source}: expected a session object, got ${JSON.stringify(value)}`);
+  }
+  const fail = (field, expected, got = value[field]) => {
+    throw new Error(`${source}: session field "${field}" must be ${expected}, got ${JSON.stringify(got)}`);
+  };
+  for (const field of ["id", "profile", "kind", "role", "startedAt", "updatedAt", "heartbeatAt"]) {
+    if (typeof value[field] !== "string" || value[field] === "") fail(field, "a non-empty string");
+  }
+  if (!isSessionState(value.state)) fail("state", `one of ${SESSION_STATES.join("|")}`);
+  if (typeof value.eventCount !== "number") fail("eventCount", "a number");
+  for (const field of ["controllable", "localWriter", "eventsAvailable", "unresponsive", "restartable"]) {
+    if (typeof value[field] !== "boolean") fail(field, "a boolean");
+  }
+  const owner = value.owner;
+  if (!isRecord(owner) || typeof owner.host !== "string" || typeof owner.pid !== "number") {
+    fail("owner", "{host: string, pid: number, boot: string}");
+  }
+  if (value.restartedAs !== void 0 && !Array.isArray(value.restartedAs)) {
+    fail("restartedAs", "an array of session ids");
+  }
+  if (value.events !== void 0) checkStreamRef(value.events, fail);
+  if (value.metadata !== void 0) checkMetadata(value.metadata, fail);
+  return value;
+}
+function checkMetadata(metadata, fail) {
+  if (!Array.isArray(metadata)) return fail("metadata", "an array of metadata entries", metadata);
+  metadata.forEach((entry, index) => {
+    const at = `metadata[${index}]`;
+    if (!isRecord(entry)) return fail(at, "{name, label, value: string, language?: string}", entry);
+    for (const field of ["name", "label", "value"]) {
+      if (typeof entry[field] !== "string" || entry[field] === "") {
+        fail(`${at}.${field}`, "a non-empty string", entry[field]);
+      }
+    }
+    if (entry.language !== void 0 && typeof entry.language !== "string") {
+      fail(`${at}.language`, "a string when present", entry.language);
+    }
+  });
+}
+function checkStreamRef(events, fail) {
+  if (!isRecord(events)) return fail("events", "a stream reference object", events);
+  for (const field of ["stream", "kind", "generation"]) {
+    if (typeof events[field] !== "string") fail(`events.${field}`, "a string", events[field]);
+  }
+  for (const field of ["low", "high", "from", "to", "total"]) {
+    if (typeof events[field] !== "number") fail(`events.${field}`, "a number", events[field]);
+  }
+  const store = events.store;
+  if (!isRecord(store)) return fail("events.store", "{backend: string, host?: string, file?: string}", store);
+  if (typeof store.backend !== "string") fail("events.store.backend", "a string", store.backend);
+  for (const field of ["host", "file"]) {
+    if (store[field] !== void 0 && typeof store[field] !== "string") {
+      fail(`events.store.${field}`, "a string when present", store[field]);
+    }
+  }
+}
+function sessionDurationParam(durationMs) {
+  if (!Number.isInteger(durationMs) || durationMs <= 0) {
+    throw new Error(`session duration must be a positive whole number of milliseconds, got ${durationMs}`);
+  }
+  return `${durationMs}ms`;
+}
+function sessionParamsDurationMs(session) {
+  var _a;
+  const value = (_a = session.params) == null ? void 0 : _a.durationMs;
+  if (value === void 0 || value === 0) return void 0;
+  if (typeof value !== "number" || !Number.isInteger(value) || value < 0) {
+    throw new Error(
+      `session ${session.id}: params.durationMs must be a non-negative whole number, got ${JSON.stringify(value)}`
+    );
+  }
+  return value;
+}
+exports.SESSION_STATES = SESSION_STATES;
+exports.isSessionState = isSessionState;
+exports.isSessionTerminal = isSessionTerminal;
+exports.parseSessionInfo = parseSessionInfo;
+exports.sessionDurationParam = sessionDurationParam;
+exports.sessionParamsDurationMs = sessionParamsDurationMs;
+//# sourceMappingURL=sessionTypes.cjs.map

package/dist/rpc/sessionTypes.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionTypes.cjs","sources":["../../src/rpc/sessionTypes.ts"],"sourcesContent":["// Wire types for the commons-db query sessions API (`cmd/query/sessions`):\n// `GET /api/v1/sessions/{id}` answers one SessionInfo, flat JSON — the\n// immutable SessionStart and the mutable SessionStatus side by side, plus the\n// fields the serving process derives. Field names are the Go json tags of\n// `query.SessionStart`, `query.SessionStatus`, `query.SessionInfo` and\n// `recordresults.StreamRef`, spelled exactly.\n\nexport const SESSION_STATES = [\n  \"starting\",\n  \"running\",\n  \"stopping\",\n  \"completed\",\n  \"failed\",\n  \"stopped\",\n  \"interrupted\",\n] as const;\n\nexport type SessionState = (typeof SESSION_STATES)[number];\n\n/** `capture` sessions create data and are persisted; `view` sessions follow existing data and never are. */\nexport type SessionRole = \"capture\" | \"view\";\n\nexport type SessionProfileKind = \"trace\" | \"top\" | \"capture\";\n\nexport type SessionOwner = {\n  host: string;\n  pid: number;\n  /** Process boot id: a different boot on the same host means the owner restarted. */\n  boot: string;\n};\n\n/** A store the server omits `host` and `file` for when the backend has neither (a kv store). */\nexport type SessionStoreLocation = {\n  backend: string;\n  host?: string;\n  file?: string;\n};\n\n/** Where a capture's canonical event rows live in the record store. */\nexport type SessionStreamRef = {\n  stream: string;\n  kind: string;\n  generation: string;\n  low: number;\n  high: number;\n  from: number;\n  to: number;\n  total: number;\n  expiresAt?: string;\n  store: SessionStoreLocation;\n};\n\n/**\n * One thing a capture reported about how it runs once armed — the statements\n * that opened an Extended Events session, say. `name` keys it within the\n * session; `language` names `value`'s language when it is code (`sql`).\n */\nexport type SessionMetadata = {\n  name: string;\n  label: string;\n  language?: string;\n  value: string;\n};\n\nexport type SessionInfo = {\n  // SessionStart — written once.\n  schemaVersion: number;\n  id: string;\n  profile: string;\n  kind: SessionProfileKind;\n  role: SessionRole;\n  /** Exactly what a restart replays; `durationMs` 0 or absent means the run had no bound. */\n  params?: Record<string, unknown>;\n  labels?: Record<string, string>;\n  principal?: string;\n  owner: SessionOwner;\n  restartOf?: string;\n  startedAt: string;\n\n  // SessionStatus — overwritten on every change.\n  state: SessionState;\n  error?: string;\n  warning?: string;\n  eventCount: number;\n  updatedAt: string;\n  heartbeatAt: string;\n  stopAt?: string;\n  stoppedAt?: string;\n  stopReason?: string;\n  handle?: string;\n  events?: SessionStreamRef;\n  summary?: unknown;\n  result?: unknown;\n  /** Written once the capture is armed, then kept. */\n  metadata?: SessionMetadata[];\n\n  // Derived by the serving process.\n  /** Live in this process's registry: Stop and Extend act on it. */\n  controllable: boolean;\n  /** The owner boot is this process, so its tail wakes in-process. */\n  localWriter: boolean;\n  /** The `events` stream's store is readable here. */\n  eventsAvailable: boolean;\n  /** Still active but its heartbeat is older than the registry's StaleAfter. */\n  unresponsive: boolean;\n  /** This process holds a RestartFunc for the session's profile and origin. */\n  restartable: boolean;\n  /** Ids of sessions whose `restartOf` names this one, computed on read from the index. */\n  restartedAs?: string[];\n};\n\nconst TERMINAL_STATES: ReadonlySet<SessionState> = new Set([\n  \"completed\",\n  \"failed\",\n  \"stopped\",\n  \"interrupted\",\n]);\n\nexport function isSessionTerminal(state: SessionState): boolean {\n  return TERMINAL_STATES.has(state);\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nexport function isSessionState(value: unknown): value is SessionState {\n  return typeof value === \"string\" && (SESSION_STATES as readonly string[]).includes(value);\n}\n\n/**\n * parseSessionInfo checks the fields a session view reads before it trusts a\n * response, and throws naming the first one that is missing or mistyped — a\n * header that rendered `undefined` as a state or an owner would hide a server\n * that stopped sending the contract.\n */\nexport function parseSessionInfo(value: unknown, source: string): SessionInfo {\n  if (!isRecord(value)) {\n    throw new Error(`${source}: expected a session object, got ${JSON.stringify(value)}`);\n  }\n  const fail: FieldFailure = (field, expected, got = value[field]) => {\n    throw new Error(`${source}: session field \"${field}\" must be ${expected}, got ${JSON.stringify(got)}`);\n  };\n  for (const field of [\"id\", \"profile\", \"kind\", \"role\", \"startedAt\", \"updatedAt\", \"heartbeatAt\"]) {\n    if (typeof value[field] !== \"string\" || value[field] === \"\") fail(field, \"a non-empty string\");\n  }\n  if (!isSessionState(value.state)) fail(\"state\", `one of ${SESSION_STATES.join(\"|\")}`);\n  if (typeof value.eventCount !== \"number\") fail(\"eventCount\", \"a number\");\n  for (const field of [\"controllable\", \"localWriter\", \"eventsAvailable\", \"unresponsive\", \"restartable\"]) {\n    if (typeof value[field] !== \"boolean\") fail(field, \"a boolean\");\n  }\n  const owner = value.owner;\n  if (!isRecord(owner) || typeof owner.host !== \"string\" || typeof owner.pid !== \"number\") {\n    fail(\"owner\", \"{host: string, pid: number, boot: string}\");\n  }\n  if (value.restartedAs !== undefined && !Array.isArray(value.restartedAs)) {\n    fail(\"restartedAs\", \"an array of session ids\");\n  }\n  if (value.events !== undefined) checkStreamRef(value.events, fail);\n  if (value.metadata !== undefined) checkMetadata(value.metadata, fail);\n  return value as SessionInfo;\n}\n\ntype FieldFailure = (field: string, expected: string, got?: unknown) => never;\n\nfunction checkMetadata(metadata: unknown, fail: FieldFailure): void {\n  if (!Array.isArray(metadata)) return fail(\"metadata\", \"an array of metadata entries\", metadata);\n  metadata.forEach((entry: unknown, index) => {\n    const at = `metadata[${index}]`;\n    if (!isRecord(entry)) return fail(at, \"{name, label, value: string, language?: string}\", entry);\n    for (const field of [\"name\", \"label\", \"value\"]) {\n      if (typeof entry[field] !== \"string\" || entry[field] === \"\") {\n        fail(`${at}.${field}`, \"a non-empty string\", entry[field]);\n      }\n    }\n    if (entry.language !== undefined && typeof entry.language !== \"string\") {\n      fail(`${at}.language`, \"a string when present\", entry.language);\n    }\n  });\n}\n\nfunction checkStreamRef(events: unknown, fail: FieldFailure): void {\n  if (!isRecord(events)) return fail(\"events\", \"a stream reference object\", events);\n  for (const field of [\"stream\", \"kind\", \"generation\"]) {\n    if (typeof events[field] !== \"string\") fail(`events.${field}`, \"a string\", events[field]);\n  }\n  for (const field of [\"low\", \"high\", \"from\", \"to\", \"total\"]) {\n    if (typeof events[field] !== \"number\") fail(`events.${field}`, \"a number\", events[field]);\n  }\n  const store = events.store;\n  if (!isRecord(store)) return fail(\"events.store\", \"{backend: string, host?: string, file?: string}\", store);\n  if (typeof store.backend !== \"string\") fail(\"events.store.backend\", \"a string\", store.backend);\n  for (const field of [\"host\", \"file\"]) {\n    if (store[field] !== undefined && typeof store[field] !== \"string\") {\n      fail(`events.store.${field}`, \"a string when present\", store[field]);\n    }\n  }\n}\n\n/**\n * sessionDurationParam renders a duration for the sessions API's `duration`\n * query param, which the server reads with Go's time.ParseDuration.\n */\nexport function sessionDurationParam(durationMs: number): string {\n  if (!Number.isInteger(durationMs) || durationMs <= 0) {\n    throw new Error(`session duration must be a positive whole number of milliseconds, got ${durationMs}`);\n  }\n  return `${durationMs}ms`;\n}\n\n/** The run's own bound, from `params.durationMs`; undefined when it had none (0 or absent). */\nexport function sessionParamsDurationMs(session: SessionInfo): number | undefined {\n  const value = session.params?.durationMs;\n  if (value === undefined || value === 0) return undefined;\n  if (typeof value !== \"number\" || !Number.isInteger(value) || value < 0) {\n    throw new Error(\n      `session ${session.id}: params.durationMs must be a non-negative whole number, got ${JSON.stringify(value)}`,\n    );\n  }\n  return value;\n}\n"],"names":[],"mappings":"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"}

package/dist/rpc/sessionTypes.d.ts

@@ -0,0 +1,99 @@
+export declare const SESSION_STATES: readonly ["starting", "running", "stopping", "completed", "failed", "stopped", "interrupted"];
+export type SessionState = (typeof SESSION_STATES)[number];
+/** `capture` sessions create data and are persisted; `view` sessions follow existing data and never are. */
+export type SessionRole = "capture" | "view";
+export type SessionProfileKind = "trace" | "top" | "capture";
+export type SessionOwner = {
+    host: string;
+    pid: number;
+    /** Process boot id: a different boot on the same host means the owner restarted. */
+    boot: string;
+};
+/** A store the server omits `host` and `file` for when the backend has neither (a kv store). */
+export type SessionStoreLocation = {
+    backend: string;
+    host?: string;
+    file?: string;
+};
+/** Where a capture's canonical event rows live in the record store. */
+export type SessionStreamRef = {
+    stream: string;
+    kind: string;
+    generation: string;
+    low: number;
+    high: number;
+    from: number;
+    to: number;
+    total: number;
+    expiresAt?: string;
+    store: SessionStoreLocation;
+};
+/**
+ * One thing a capture reported about how it runs once armed — the statements
+ * that opened an Extended Events session, say. `name` keys it within the
+ * session; `language` names `value`'s language when it is code (`sql`).
+ */
+export type SessionMetadata = {
+    name: string;
+    label: string;
+    language?: string;
+    value: string;
+};
+export type SessionInfo = {
+    schemaVersion: number;
+    id: string;
+    profile: string;
+    kind: SessionProfileKind;
+    role: SessionRole;
+    /** Exactly what a restart replays; `durationMs` 0 or absent means the run had no bound. */
+    params?: Record<string, unknown>;
+    labels?: Record<string, string>;
+    principal?: string;
+    owner: SessionOwner;
+    restartOf?: string;
+    startedAt: string;
+    state: SessionState;
+    error?: string;
+    warning?: string;
+    eventCount: number;
+    updatedAt: string;
+    heartbeatAt: string;
+    stopAt?: string;
+    stoppedAt?: string;
+    stopReason?: string;
+    handle?: string;
+    events?: SessionStreamRef;
+    summary?: unknown;
+    result?: unknown;
+    /** Written once the capture is armed, then kept. */
+    metadata?: SessionMetadata[];
+    /** Live in this process's registry: Stop and Extend act on it. */
+    controllable: boolean;
+    /** The owner boot is this process, so its tail wakes in-process. */
+    localWriter: boolean;
+    /** The `events` stream's store is readable here. */
+    eventsAvailable: boolean;
+    /** Still active but its heartbeat is older than the registry's StaleAfter. */
+    unresponsive: boolean;
+    /** This process holds a RestartFunc for the session's profile and origin. */
+    restartable: boolean;
+    /** Ids of sessions whose `restartOf` names this one, computed on read from the index. */
+    restartedAs?: string[];
+};
+export declare function isSessionTerminal(state: SessionState): boolean;
+export declare function isSessionState(value: unknown): value is SessionState;
+/**
+ * parseSessionInfo checks the fields a session view reads before it trusts a
+ * response, and throws naming the first one that is missing or mistyped — a
+ * header that rendered `undefined` as a state or an owner would hide a server
+ * that stopped sending the contract.
+ */
+export declare function parseSessionInfo(value: unknown, source: string): SessionInfo;
+/**
+ * sessionDurationParam renders a duration for the sessions API's `duration`
+ * query param, which the server reads with Go's time.ParseDuration.
+ */
+export declare function sessionDurationParam(durationMs: number): string;
+/** The run's own bound, from `params.durationMs`; undefined when it had none (0 or absent). */
+export declare function sessionParamsDurationMs(session: SessionInfo): number | undefined;
+//# sourceMappingURL=sessionTypes.d.ts.map

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

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

package/dist/rpc/sessionTypes.js

@@ -0,0 +1,108 @@
+const SESSION_STATES = [
+  "starting",
+  "running",
+  "stopping",
+  "completed",
+  "failed",
+  "stopped",
+  "interrupted"
+];
+const TERMINAL_STATES = /* @__PURE__ */ new Set([
+  "completed",
+  "failed",
+  "stopped",
+  "interrupted"
+]);
+function isSessionTerminal(state) {
+  return TERMINAL_STATES.has(state);
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isSessionState(value) {
+  return typeof value === "string" && SESSION_STATES.includes(value);
+}
+function parseSessionInfo(value, source) {
+  if (!isRecord(value)) {
+    throw new Error(`${source}: expected a session object, got ${JSON.stringify(value)}`);
+  }
+  const fail = (field, expected, got = value[field]) => {
+    throw new Error(`${source}: session field "${field}" must be ${expected}, got ${JSON.stringify(got)}`);
+  };
+  for (const field of ["id", "profile", "kind", "role", "startedAt", "updatedAt", "heartbeatAt"]) {
+    if (typeof value[field] !== "string" || value[field] === "") fail(field, "a non-empty string");
+  }
+  if (!isSessionState(value.state)) fail("state", `one of ${SESSION_STATES.join("|")}`);
+  if (typeof value.eventCount !== "number") fail("eventCount", "a number");
+  for (const field of ["controllable", "localWriter", "eventsAvailable", "unresponsive", "restartable"]) {
+    if (typeof value[field] !== "boolean") fail(field, "a boolean");
+  }
+  const owner = value.owner;
+  if (!isRecord(owner) || typeof owner.host !== "string" || typeof owner.pid !== "number") {
+    fail("owner", "{host: string, pid: number, boot: string}");
+  }
+  if (value.restartedAs !== void 0 && !Array.isArray(value.restartedAs)) {
+    fail("restartedAs", "an array of session ids");
+  }
+  if (value.events !== void 0) checkStreamRef(value.events, fail);
+  if (value.metadata !== void 0) checkMetadata(value.metadata, fail);
+  return value;
+}
+function checkMetadata(metadata, fail) {
+  if (!Array.isArray(metadata)) return fail("metadata", "an array of metadata entries", metadata);
+  metadata.forEach((entry, index) => {
+    const at = `metadata[${index}]`;
+    if (!isRecord(entry)) return fail(at, "{name, label, value: string, language?: string}", entry);
+    for (const field of ["name", "label", "value"]) {
+      if (typeof entry[field] !== "string" || entry[field] === "") {
+        fail(`${at}.${field}`, "a non-empty string", entry[field]);
+      }
+    }
+    if (entry.language !== void 0 && typeof entry.language !== "string") {
+      fail(`${at}.language`, "a string when present", entry.language);
+    }
+  });
+}
+function checkStreamRef(events, fail) {
+  if (!isRecord(events)) return fail("events", "a stream reference object", events);
+  for (const field of ["stream", "kind", "generation"]) {
+    if (typeof events[field] !== "string") fail(`events.${field}`, "a string", events[field]);
+  }
+  for (const field of ["low", "high", "from", "to", "total"]) {
+    if (typeof events[field] !== "number") fail(`events.${field}`, "a number", events[field]);
+  }
+  const store = events.store;
+  if (!isRecord(store)) return fail("events.store", "{backend: string, host?: string, file?: string}", store);
+  if (typeof store.backend !== "string") fail("events.store.backend", "a string", store.backend);
+  for (const field of ["host", "file"]) {
+    if (store[field] !== void 0 && typeof store[field] !== "string") {
+      fail(`events.store.${field}`, "a string when present", store[field]);
+    }
+  }
+}
+function sessionDurationParam(durationMs) {
+  if (!Number.isInteger(durationMs) || durationMs <= 0) {
+    throw new Error(`session duration must be a positive whole number of milliseconds, got ${durationMs}`);
+  }
+  return `${durationMs}ms`;
+}
+function sessionParamsDurationMs(session) {
+  var _a;
+  const value = (_a = session.params) == null ? void 0 : _a.durationMs;
+  if (value === void 0 || value === 0) return void 0;
+  if (typeof value !== "number" || !Number.isInteger(value) || value < 0) {
+    throw new Error(
+      `session ${session.id}: params.durationMs must be a non-negative whole number, got ${JSON.stringify(value)}`
+    );
+  }
+  return value;
+}
+export {
+  SESSION_STATES,
+  isSessionState,
+  isSessionTerminal,
+  parseSessionInfo,
+  sessionDurationParam,
+  sessionParamsDurationMs
+};
+//# sourceMappingURL=sessionTypes.js.map

package/dist/rpc/sessionTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionTypes.js","sources":["../../src/rpc/sessionTypes.ts"],"sourcesContent":["// Wire types for the commons-db query sessions API (`cmd/query/sessions`):\n// `GET /api/v1/sessions/{id}` answers one SessionInfo, flat JSON — the\n// immutable SessionStart and the mutable SessionStatus side by side, plus the\n// fields the serving process derives. Field names are the Go json tags of\n// `query.SessionStart`, `query.SessionStatus`, `query.SessionInfo` and\n// `recordresults.StreamRef`, spelled exactly.\n\nexport const SESSION_STATES = [\n  \"starting\",\n  \"running\",\n  \"stopping\",\n  \"completed\",\n  \"failed\",\n  \"stopped\",\n  \"interrupted\",\n] as const;\n\nexport type SessionState = (typeof SESSION_STATES)[number];\n\n/** `capture` sessions create data and are persisted; `view` sessions follow existing data and never are. */\nexport type SessionRole = \"capture\" | \"view\";\n\nexport type SessionProfileKind = \"trace\" | \"top\" | \"capture\";\n\nexport type SessionOwner = {\n  host: string;\n  pid: number;\n  /** Process boot id: a different boot on the same host means the owner restarted. */\n  boot: string;\n};\n\n/** A store the server omits `host` and `file` for when the backend has neither (a kv store). */\nexport type SessionStoreLocation = {\n  backend: string;\n  host?: string;\n  file?: string;\n};\n\n/** Where a capture's canonical event rows live in the record store. */\nexport type SessionStreamRef = {\n  stream: string;\n  kind: string;\n  generation: string;\n  low: number;\n  high: number;\n  from: number;\n  to: number;\n  total: number;\n  expiresAt?: string;\n  store: SessionStoreLocation;\n};\n\n/**\n * One thing a capture reported about how it runs once armed — the statements\n * that opened an Extended Events session, say. `name` keys it within the\n * session; `language` names `value`'s language when it is code (`sql`).\n */\nexport type SessionMetadata = {\n  name: string;\n  label: string;\n  language?: string;\n  value: string;\n};\n\nexport type SessionInfo = {\n  // SessionStart — written once.\n  schemaVersion: number;\n  id: string;\n  profile: string;\n  kind: SessionProfileKind;\n  role: SessionRole;\n  /** Exactly what a restart replays; `durationMs` 0 or absent means the run had no bound. */\n  params?: Record<string, unknown>;\n  labels?: Record<string, string>;\n  principal?: string;\n  owner: SessionOwner;\n  restartOf?: string;\n  startedAt: string;\n\n  // SessionStatus — overwritten on every change.\n  state: SessionState;\n  error?: string;\n  warning?: string;\n  eventCount: number;\n  updatedAt: string;\n  heartbeatAt: string;\n  stopAt?: string;\n  stoppedAt?: string;\n  stopReason?: string;\n  handle?: string;\n  events?: SessionStreamRef;\n  summary?: unknown;\n  result?: unknown;\n  /** Written once the capture is armed, then kept. */\n  metadata?: SessionMetadata[];\n\n  // Derived by the serving process.\n  /** Live in this process's registry: Stop and Extend act on it. */\n  controllable: boolean;\n  /** The owner boot is this process, so its tail wakes in-process. */\n  localWriter: boolean;\n  /** The `events` stream's store is readable here. */\n  eventsAvailable: boolean;\n  /** Still active but its heartbeat is older than the registry's StaleAfter. */\n  unresponsive: boolean;\n  /** This process holds a RestartFunc for the session's profile and origin. */\n  restartable: boolean;\n  /** Ids of sessions whose `restartOf` names this one, computed on read from the index. */\n  restartedAs?: string[];\n};\n\nconst TERMINAL_STATES: ReadonlySet<SessionState> = new Set([\n  \"completed\",\n  \"failed\",\n  \"stopped\",\n  \"interrupted\",\n]);\n\nexport function isSessionTerminal(state: SessionState): boolean {\n  return TERMINAL_STATES.has(state);\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nexport function isSessionState(value: unknown): value is SessionState {\n  return typeof value === \"string\" && (SESSION_STATES as readonly string[]).includes(value);\n}\n\n/**\n * parseSessionInfo checks the fields a session view reads before it trusts a\n * response, and throws naming the first one that is missing or mistyped — a\n * header that rendered `undefined` as a state or an owner would hide a server\n * that stopped sending the contract.\n */\nexport function parseSessionInfo(value: unknown, source: string): SessionInfo {\n  if (!isRecord(value)) {\n    throw new Error(`${source}: expected a session object, got ${JSON.stringify(value)}`);\n  }\n  const fail: FieldFailure = (field, expected, got = value[field]) => {\n    throw new Error(`${source}: session field \"${field}\" must be ${expected}, got ${JSON.stringify(got)}`);\n  };\n  for (const field of [\"id\", \"profile\", \"kind\", \"role\", \"startedAt\", \"updatedAt\", \"heartbeatAt\"]) {\n    if (typeof value[field] !== \"string\" || value[field] === \"\") fail(field, \"a non-empty string\");\n  }\n  if (!isSessionState(value.state)) fail(\"state\", `one of ${SESSION_STATES.join(\"|\")}`);\n  if (typeof value.eventCount !== \"number\") fail(\"eventCount\", \"a number\");\n  for (const field of [\"controllable\", \"localWriter\", \"eventsAvailable\", \"unresponsive\", \"restartable\"]) {\n    if (typeof value[field] !== \"boolean\") fail(field, \"a boolean\");\n  }\n  const owner = value.owner;\n  if (!isRecord(owner) || typeof owner.host !== \"string\" || typeof owner.pid !== \"number\") {\n    fail(\"owner\", \"{host: string, pid: number, boot: string}\");\n  }\n  if (value.restartedAs !== undefined && !Array.isArray(value.restartedAs)) {\n    fail(\"restartedAs\", \"an array of session ids\");\n  }\n  if (value.events !== undefined) checkStreamRef(value.events, fail);\n  if (value.metadata !== undefined) checkMetadata(value.metadata, fail);\n  return value as SessionInfo;\n}\n\ntype FieldFailure = (field: string, expected: string, got?: unknown) => never;\n\nfunction checkMetadata(metadata: unknown, fail: FieldFailure): void {\n  if (!Array.isArray(metadata)) return fail(\"metadata\", \"an array of metadata entries\", metadata);\n  metadata.forEach((entry: unknown, index) => {\n    const at = `metadata[${index}]`;\n    if (!isRecord(entry)) return fail(at, \"{name, label, value: string, language?: string}\", entry);\n    for (const field of [\"name\", \"label\", \"value\"]) {\n      if (typeof entry[field] !== \"string\" || entry[field] === \"\") {\n        fail(`${at}.${field}`, \"a non-empty string\", entry[field]);\n      }\n    }\n    if (entry.language !== undefined && typeof entry.language !== \"string\") {\n      fail(`${at}.language`, \"a string when present\", entry.language);\n    }\n  });\n}\n\nfunction checkStreamRef(events: unknown, fail: FieldFailure): void {\n  if (!isRecord(events)) return fail(\"events\", \"a stream reference object\", events);\n  for (const field of [\"stream\", \"kind\", \"generation\"]) {\n    if (typeof events[field] !== \"string\") fail(`events.${field}`, \"a string\", events[field]);\n  }\n  for (const field of [\"low\", \"high\", \"from\", \"to\", \"total\"]) {\n    if (typeof events[field] !== \"number\") fail(`events.${field}`, \"a number\", events[field]);\n  }\n  const store = events.store;\n  if (!isRecord(store)) return fail(\"events.store\", \"{backend: string, host?: string, file?: string}\", store);\n  if (typeof store.backend !== \"string\") fail(\"events.store.backend\", \"a string\", store.backend);\n  for (const field of [\"host\", \"file\"]) {\n    if (store[field] !== undefined && typeof store[field] !== \"string\") {\n      fail(`events.store.${field}`, \"a string when present\", store[field]);\n    }\n  }\n}\n\n/**\n * sessionDurationParam renders a duration for the sessions API's `duration`\n * query param, which the server reads with Go's time.ParseDuration.\n */\nexport function sessionDurationParam(durationMs: number): string {\n  if (!Number.isInteger(durationMs) || durationMs <= 0) {\n    throw new Error(`session duration must be a positive whole number of milliseconds, got ${durationMs}`);\n  }\n  return `${durationMs}ms`;\n}\n\n/** The run's own bound, from `params.durationMs`; undefined when it had none (0 or absent). */\nexport function sessionParamsDurationMs(session: SessionInfo): number | undefined {\n  const value = session.params?.durationMs;\n  if (value === undefined || value === 0) return undefined;\n  if (typeof value !== \"number\" || !Number.isInteger(value) || value < 0) {\n    throw new Error(\n      `session ${session.id}: params.durationMs must be a non-negative whole number, got ${JSON.stringify(value)}`,\n    );\n  }\n  return value;\n}\n"],"names":[],"mappings":"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"}

package/dist/rpc/types.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"types.cjs","sources":["../../src/rpc/types.ts"],"sourcesContent":["import type { ClickyNode } from \"../data/Clicky\";\nimport type { TimeRangePresetGroup } from \"../components/TimeRange\";\n\nexport type OperationRequestValues = Record<string, string | string[]>;\n\nexport interface ExecutionRequest {\n  args?: string[];\n  flags?: OperationRequestValues;\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  /** Captain's tool vocabulary. The legacy `on`/`off` spellings are still\n   *  accepted on decode and mean `allow`/`deny`. */\n  defaultPermission?: \"allow\" | \"ask\" | \"deny\" | \"auto\" | \"on\" | \"off\";\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":";;AA+IO,SAAS,qBACd,OACoB;AACpB,SAAO,MAAM,sBAAsB,KAAK,MAAM;AAChD;AA2JO,SAAS,kBAAkB,GAA8B;;AAC9D,SACE,EAAE,SAAS,YACX,OAAE,gBAAF,mBAAe,cAAc,SAAS,4BAA2B;AAErE;;;"}
+{"version":3,"file":"types.cjs","sources":["../../src/rpc/types.ts"],"sourcesContent":["import type { ClickyNode } from \"../data/Clicky\";\nimport type { TimeRangePresetGroup } from \"../components/TimeRange\";\nimport type { CronSuggestion } from \"../components/schedule-types\";\n\nexport type OperationRequestValues = Record<string, string | string[]>;\n\nexport interface ExecutionRequest {\n  args?: string[];\n  flags?: OperationRequestValues;\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  unit?: string;\n  defaultOperator?: \">\" | \">=\" | \"<\" | \"<=\";\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  schedule?: ClickyScheduleMeta;\n}\n\nexport interface ClickyScheduleMeta {\n  suggestions?: CronSuggestion[];\n  timeout?: number;\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  /** Captain's tool vocabulary. The legacy `on`/`off` spellings are still\n   *  accepted on decode and mean `allow`/`deny`. */\n  defaultPermission?: \"allow\" | \"ask\" | \"deny\" | \"auto\" | \"on\" | \"off\";\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  /**\n   * Per-value row counts, keyed the same as `options`. A value absent from\n   * this map is a value the source did not count — never rendered as zero —\n   * and the whole field is omitted when the source doesn't count at all.\n   */\n  counts?: Record<string, number>;\n  presets?: Array<\n    { label: string; from: string; to: string } | TimeRangePresetGroup\n  >;\n  timeEnabled?: boolean;\n  timeZone?: string;\n  timeZones?: string[];\n  /** Unit used by numeric values. For durations this is the storage unit\n   *  (\"ms\", \"s\", \"m\", or \"h\"); absent duration units mean milliseconds. */\n  unit?: string;\n  defaultOperator?: \">\" | \">=\" | \"<\" | \"<=\";\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":";;AAkJO,SAAS,qBACd,OACoB;AACpB,SAAO,MAAM,sBAAsB,KAAK,MAAM;AAChD;AAuKO,SAAS,kBAAkB,GAA8B;;AAC9D,SACE,EAAE,SAAS,YACX,OAAE,gBAAF,mBAAe,cAAc,SAAS,4BAA2B;AAErE;;;"}

package/dist/rpc/types.d.ts

@@ -1,5 +1,6 @@
 import { ClickyNode } from '../data/Clicky';
 import { TimeRangePresetGroup } from '../components/TimeRange';
+import { CronSuggestion } from '../components/schedule-types';
 export type OperationRequestValues = Record<string, string | string[]>;
 export interface ExecutionRequest {
     args?: string[];
@@ -77,6 +78,8 @@ export interface ClickyParameterLookup {
 export interface ClickyFilterShape {
     label?: string;
     type?: OperationLookupFilterType;
+    unit?: string;
+    defaultOperator?: ">" | ">=" | "<" | "<=";
     multi?: boolean;
 }
 export interface OpenAPIParameter {
@@ -174,6 +177,11 @@ export interface ClickyOperationMeta {
     group?: string;
     toolHints?: ClickyToolHints;
     export?: ClickyExportMeta;
+    schedule?: ClickyScheduleMeta;
+}
+export interface ClickyScheduleMeta {
+    suggestions?: CronSuggestion[];
+    timeout?: number;
 }
 export interface ClickyExportMeta {
     formats?: string[];
@@ -225,6 +233,12 @@ export interface OperationLookupFilter {
     truncated?: boolean;
     /** True distinct count behind a truncated option set; drives "… and N more". */
     total?: number;
+    /**
+     * Per-value row counts, keyed the same as `options`. A value absent from
+     * this map is a value the source did not count — never rendered as zero —
+     * and the whole field is omitted when the source doesn't count at all.
+     */
+    counts?: Record<string, number>;
     presets?: Array<{
         label: string;
         from: string;
@@ -233,10 +247,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 used by numeric values. For durations this is the storage unit
+     *  ("ms", "s", "m", or "h"); absent duration units mean milliseconds. */
     unit?: string;
+    defaultOperator?: ">" | ">=" | "<" | "<=";
 }
 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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"}