@nbt-dev/components 0.1.0 → 0.1.2

package/dist/core/index.d.ts

@@ -7,5 +7,7 @@ export { useLiveBulkRegistry } from "./use-cartridge-info";
 export type { BulkEntity, BulkRegistry, LiveRegistryState, } from "./use-cartridge-info";
 export { useGsheetsApi } from "./use-gsheets";
 export type { GsheetSyncConfig, GsheetSaveInput } from "./use-gsheets";
+export { useWorkflowsApi, isWfTerminal, WF_TERMINAL } from "./use-workflows";
+export type { WfStatus, WfListItem, WfExecution, WfEvent, WfDetail, WfStats, WfVersion, WfExecReply, } from "./use-workflows";
 export { getDevToolsToken, setDevToolsToken, clearDevToolsToken, authHeaders, fetchWhoAmI, devToolsSignIn, devToolsSignUp, devToolsSignOut, wsAuthProtocols, fetchDevtoolsSettings, saveDevtoolsSettings, } from "./auth";
 export type { WhoAmI } from "./auth";

package/dist/core/use-workflows.d.ts

@@ -0,0 +1,68 @@
+export declare const WF_TERMINAL: readonly ["COMPLETED", "FAILED", "CANCELLED", "CONTINUED"];
+export type WfStatus = "RUNNING" | "SUSPENDED" | "COMPLETED" | "FAILED" | "CANCELLED" | "CONTINUED";
+export type WfListItem = {
+    id: string;
+    status: WfStatus;
+    workflowName: string;
+    createdAt: number;
+    updatedAt: number;
+    lane: string;
+    deployVersion: number;
+};
+export type WfExecution = {
+    id: string;
+    status: WfStatus;
+    workflowName: string;
+    args?: string;
+    result?: string;
+    error?: string;
+    cursor: number;
+    lane?: string;
+    deployVersion: number;
+    createdAt: number;
+    updatedAt: number;
+};
+export type WfEvent = {
+    id: string;
+    seq: number;
+    kind: string;
+    capability?: string;
+    target?: string;
+    op?: string;
+    payload?: string;
+};
+export type WfDetail = {
+    execution: WfExecution;
+    events: WfEvent[];
+};
+export type WfStats = {
+    writes: number;
+    reads: number;
+    emails: number;
+    fetches: number;
+    emits: number;
+    retries: number;
+    async_inflight: number;
+    async_peak: number;
+};
+export type WfVersion = {
+    version: number;
+    refcount: number;
+    current: boolean;
+};
+export type WfExecReply = {
+    id: string;
+    outcome: string;
+    status: string;
+    result?: string;
+    error?: string;
+};
+export declare function isWfTerminal(status: string): boolean;
+export declare function useWorkflowsApi(): {
+    listExecutions: () => Promise<WfListItem[]>;
+    getExecution: (id: string) => Promise<WfDetail>;
+    getStats: () => Promise<WfStats>;
+    getVersions: () => Promise<WfVersion[]>;
+    cancel: (id: string) => Promise<WfExecReply>;
+    advance: (id: string) => Promise<WfExecReply>;
+};

package/dist/index.js

@@ -162,6 +162,83 @@ function useGsheetsApi() {
   );
   return useMemo(() => ({ list, save, syncNow, remove }), [list, save, syncNow, remove]);
 }
+
+// src/core/use-workflows.ts
+import { useCallback as useCallback2, useMemo as useMemo2 } from "react";
+var WF_TERMINAL = ["COMPLETED", "FAILED", "CANCELLED", "CONTINUED"];
+async function jsonOrThrow2(r) {
+  const body = await r.json().catch(() => ({}));
+  if (!r.ok) throw new Error(body?.error ?? `HTTP ${r.status}`);
+  return body;
+}
+function isWfTerminal(status) {
+  return WF_TERMINAL.includes(status);
+}
+function useWorkflowsApi() {
+  const { apiBaseUrl } = useDevToolsConfig();
+  const listExecutions = useCallback2(
+    async () => jsonOrThrow2(
+      await fetch(`${apiBaseUrl}/_console/wf`, {
+        credentials: "include",
+        headers: authHeaders()
+      })
+    ),
+    [apiBaseUrl]
+  );
+  const getExecution = useCallback2(
+    async (id) => jsonOrThrow2(
+      await fetch(`${apiBaseUrl}/_console/wf/${encodeURIComponent(id)}`, {
+        credentials: "include",
+        headers: authHeaders()
+      })
+    ),
+    [apiBaseUrl]
+  );
+  const getStats = useCallback2(
+    async () => jsonOrThrow2(
+      await fetch(`${apiBaseUrl}/_console/wf/stats`, {
+        credentials: "include",
+        headers: authHeaders()
+      })
+    ),
+    [apiBaseUrl]
+  );
+  const getVersions = useCallback2(
+    async () => jsonOrThrow2(
+      await fetch(`${apiBaseUrl}/_console/wf/versions`, {
+        credentials: "include",
+        headers: authHeaders()
+      })
+    ),
+    [apiBaseUrl]
+  );
+  const cancel = useCallback2(
+    async (id) => jsonOrThrow2(
+      await fetch(`${apiBaseUrl}/_console/wf/cancel`, {
+        method: "POST",
+        credentials: "include",
+        headers: authHeaders({ "content-type": "application/json" }),
+        body: JSON.stringify({ id })
+      })
+    ),
+    [apiBaseUrl]
+  );
+  const advance = useCallback2(
+    async (id) => jsonOrThrow2(
+      await fetch(`${apiBaseUrl}/_console/wf/advance`, {
+        method: "POST",
+        credentials: "include",
+        headers: authHeaders({ "content-type": "application/json" }),
+        body: JSON.stringify({ id })
+      })
+    ),
+    [apiBaseUrl]
+  );
+  return useMemo2(
+    () => ({ listExecutions, getExecution, getStats, getVersions, cancel, advance }),
+    [listExecutions, getExecution, getStats, getVersions, cancel, advance]
+  );
+}
 export {
   BulkStreamProvider,
   data_table_default as DataTable,
@@ -172,6 +249,7 @@ export {
   NbtEditor,
   NbtLspClient,
   value_popover_default as ValuePopover,
+  WF_TERMINAL,
   authHeaders,
   buildEntityGraphModel,
   cartsFromContracts,
@@ -185,6 +263,7 @@ export {
   fetchWhoAmI,
   filterEntityGraphModel,
   getDevToolsToken,
+  isWfTerminal,
   lspExtensions,
   nbtLanguage,
   nbtLanguageSupport,
@@ -196,6 +275,7 @@ export {
   useDevToolsConfig,
   useGsheetsApi,
   useLiveBulkRegistry,
+  useWorkflowsApi,
   wsAuthProtocols,
   wsBaseFrom
 };

package/dist/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../src/core/use-cartridge-info.ts", "../src/core/use-gsheets.ts"],
-  "sourcesContent": ["import { useEffect, useState } from \"react\";\nimport { useDevToolsConfig } from \"./config\";\nimport { authHeaders } from \"./auth\";\n\n// Live cartridge/entity registry for the Data tab. Instead of the build-time\n// `BULK_REGISTRY` (every cart in the repo, generated by `nbt generate`), we\n// read the daemon's `/_console/contracts` \u2014 which only lists *running*\n// cartridges and carries each entity's `searchFields`. Bulk WS routes are\n// derived live (`/_ws/bulk/<cart>/<entity-lower>`) and fed straight into\n// useBulkStream. So the tab reflects what is actually installed right now.\n\nexport type BulkEntity = {\n  name: string;\n  route: string;\n  searchFields: readonly string[];\n};\nexport type BulkRegistry = Record<string, BulkEntity[]>;\n\ntype Contract = {\n  cartridge?: string;\n  core?: boolean;\n  installed?: boolean;\n  owns?: Record<string, { searchFields?: string[] }>;\n};\n\nfunction buildRegistry(\n  contracts: Contract[],\n): { reg: BulkRegistry; core: Set<string>; installed: Set<string> } {\n  const reg: BulkRegistry = {};\n  const core = new Set<string>();\n  const installed = new Set<string>();\n  for (const c of contracts) {\n    const cart = c.cartridge;\n    if (!cart || !c.owns) continue;\n    const entities: BulkEntity[] = [];\n    for (const [name, ent] of Object.entries(c.owns)) {\n      const sf = Array.isArray(ent?.searchFields) ? ent.searchFields : [];\n      entities.push({\n        name,\n        route: `/_ws/bulk/${cart}/${name.toLowerCase()}`,\n        searchFields: sf,\n      });\n    }\n    if (entities.length > 0) {\n      reg[cart] = entities;\n      if (c.core) core.add(cart);\n      if (c.installed) installed.add(cart);\n    }\n  }\n  return { reg, core, installed };\n}\n\nexport type LiveRegistryState = {\n  registry: BulkRegistry;\n  carts: string[];\n  // Cartridge slugs flagged `core` by the daemon. The Data tab keeps `auth`\n  // visible but tucks the rest of these behind a \"more cartridges\" menu so\n  // deployed (user) cartridges are what's shown by default.\n  coreCarts: Set<string>;\n  // Cartridge slugs the user (or boot) explicitly installed/activated. The Data\n  // tab shows these (plus `auth`) by default; bundled-but-not-installed carts\n  // stay behind the \"more cartridges\" menu until the user opens them.\n  installedCarts: Set<string>;\n  loading: boolean;\n  error: string | null;\n};\n\nexport function useLiveBulkRegistry(): LiveRegistryState {\n  const { apiBaseUrl } = useDevToolsConfig();\n  const [registry, setRegistry] = useState<BulkRegistry>({});\n  const [coreCarts, setCoreCarts] = useState<Set<string>>(new Set());\n  const [installedCarts, setInstalledCarts] = useState<Set<string>>(new Set());\n  const [loading, setLoading] = useState(true);\n  const [error, setError] = useState<string | null>(null);\n\n  useEffect(() => {\n    const ac = new AbortController();\n    let cancelled = false;\n    setLoading(true);\n    setError(null);\n    (async () => {\n      try {\n        const r = await fetch(`${apiBaseUrl}/_console/contracts`, {\n          signal: ac.signal,\n          credentials: \"include\",\n          headers: authHeaders(),\n        });\n        if (!r.ok) throw new Error(`HTTP ${r.status}`);\n        const data = (await r.json()) as Contract[];\n        if (!Array.isArray(data)) throw new Error(\"malformed contracts response\");\n        if (cancelled) return;\n        const { reg, core, installed } = buildRegistry(data);\n        setRegistry(reg);\n        setCoreCarts(core);\n        setInstalledCarts(installed);\n      } catch (e) {\n        if (cancelled || (e as { name?: string }).name === \"AbortError\") return;\n        setError(e instanceof Error ? e.message : String(e));\n      } finally {\n        if (!cancelled) setLoading(false);\n      }\n    })();\n    return () => {\n      cancelled = true;\n      ac.abort();\n    };\n  }, [apiBaseUrl]);\n\n  const carts = Object.keys(registry).sort();\n  return { registry, carts, coreCarts, installedCarts, loading, error };\n}\n", "// Fetchers + hook for the Google Sheets cartridge-sync admin endpoints\n// (/_console/integrations/gsheets/*). Admin-gated server-side \u2014 the requests\n// carry the devtools Bearer token (authHeaders) like the contracts probe.\n\nimport { useCallback, useMemo } from \"react\";\nimport { useDevToolsConfig } from \"./config\";\nimport { authHeaders } from \"./auth\";\n\nexport type GsheetSyncConfig = {\n  cartridge: string;\n  spreadsheetId: string;\n  saEmail: string;\n  hasServiceAccount: boolean;\n  intervalSeconds: number;\n  enabled: boolean;\n  lastSyncAt: number; // ms epoch, 0 = never\n  status: string; // \"ok\" | \"error\" | \"\"\n  lastError: string;\n};\n\nexport type GsheetSaveInput = {\n  cartridge: string;\n  spreadsheetUrl: string;\n  serviceAccountJson?: string; // omit to keep the stored key\n  intervalSeconds: number;\n  enabled: boolean;\n};\n\nasync function jsonOrThrow(r: Response) {\n  const body = await r.json().catch(() => ({}));\n  if (!r.ok) throw new Error((body as { error?: string })?.error ?? `HTTP ${r.status}`);\n  return body;\n}\n\nexport function useGsheetsApi() {\n  const { apiBaseUrl } = useDevToolsConfig();\n\n  const list = useCallback(\n    async (): Promise<GsheetSyncConfig[]> =>\n      jsonOrThrow(\n        await fetch(`${apiBaseUrl}/_console/integrations/gsheets`, {\n          credentials: \"include\",\n          headers: authHeaders(),\n        }),\n      ),\n    [apiBaseUrl],\n  );\n\n  const save = useCallback(\n    async (input: GsheetSaveInput): Promise<GsheetSyncConfig> =>\n      jsonOrThrow(\n        await fetch(`${apiBaseUrl}/_console/integrations/gsheets`, {\n          method: \"POST\",\n          credentials: \"include\",\n          headers: authHeaders({ \"content-type\": \"application/json\" }),\n          body: JSON.stringify(input),\n        }),\n      ),\n    [apiBaseUrl],\n  );\n\n  const syncNow = useCallback(\n    async (cartridge: string): Promise<{ ok: boolean; error: string }> =>\n      jsonOrThrow(\n        await fetch(`${apiBaseUrl}/_console/integrations/gsheets/sync`, {\n          method: \"POST\",\n          credentials: \"include\",\n          headers: authHeaders({ \"content-type\": \"application/json\" }),\n          body: JSON.stringify({ cartridge }),\n        }),\n      ),\n    [apiBaseUrl],\n  );\n\n  const remove = useCallback(\n    async (cartridge: string): Promise<{ ok: boolean }> =>\n      jsonOrThrow(\n        await fetch(`${apiBaseUrl}/_console/integrations/gsheets/${encodeURIComponent(cartridge)}`, {\n          method: \"DELETE\",\n          credentials: \"include\",\n          headers: authHeaders(),\n        }),\n      ),\n    [apiBaseUrl],\n  );\n\n  return useMemo(() => ({ list, save, syncNow, remove }), [list, save, syncNow, remove]);\n}\n"],
-  "mappings": "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",
-  "names": []
+  "sources": ["../src/core/use-cartridge-info.ts", "../src/core/use-gsheets.ts", "../src/core/use-workflows.ts"],
+  "sourcesContent": ["import { useEffect, useState } from \"react\";\nimport { useDevToolsConfig } from \"./config\";\nimport { authHeaders } from \"./auth\";\n\n// Live cartridge/entity registry for the Data tab. Instead of the build-time\n// `BULK_REGISTRY` (every cart in the repo, generated by `nbt generate`), we\n// read the daemon's `/_console/contracts` \u2014 which only lists *running*\n// cartridges and carries each entity's `searchFields`. Bulk WS routes are\n// derived live (`/_ws/bulk/<cart>/<entity-lower>`) and fed straight into\n// useBulkStream. So the tab reflects what is actually installed right now.\n\nexport type BulkEntity = {\n  name: string;\n  route: string;\n  searchFields: readonly string[];\n};\nexport type BulkRegistry = Record<string, BulkEntity[]>;\n\ntype Contract = {\n  cartridge?: string;\n  core?: boolean;\n  installed?: boolean;\n  owns?: Record<string, { searchFields?: string[] }>;\n};\n\nfunction buildRegistry(\n  contracts: Contract[],\n): { reg: BulkRegistry; core: Set<string>; installed: Set<string> } {\n  const reg: BulkRegistry = {};\n  const core = new Set<string>();\n  const installed = new Set<string>();\n  for (const c of contracts) {\n    const cart = c.cartridge;\n    if (!cart || !c.owns) continue;\n    const entities: BulkEntity[] = [];\n    for (const [name, ent] of Object.entries(c.owns)) {\n      const sf = Array.isArray(ent?.searchFields) ? ent.searchFields : [];\n      entities.push({\n        name,\n        route: `/_ws/bulk/${cart}/${name.toLowerCase()}`,\n        searchFields: sf,\n      });\n    }\n    if (entities.length > 0) {\n      reg[cart] = entities;\n      if (c.core) core.add(cart);\n      if (c.installed) installed.add(cart);\n    }\n  }\n  return { reg, core, installed };\n}\n\nexport type LiveRegistryState = {\n  registry: BulkRegistry;\n  carts: string[];\n  // Cartridge slugs flagged `core` by the daemon. The Data tab keeps `auth`\n  // visible but tucks the rest of these behind a \"more cartridges\" menu so\n  // deployed (user) cartridges are what's shown by default.\n  coreCarts: Set<string>;\n  // Cartridge slugs the user (or boot) explicitly installed/activated. The Data\n  // tab shows these (plus `auth`) by default; bundled-but-not-installed carts\n  // stay behind the \"more cartridges\" menu until the user opens them.\n  installedCarts: Set<string>;\n  loading: boolean;\n  error: string | null;\n};\n\nexport function useLiveBulkRegistry(): LiveRegistryState {\n  const { apiBaseUrl } = useDevToolsConfig();\n  const [registry, setRegistry] = useState<BulkRegistry>({});\n  const [coreCarts, setCoreCarts] = useState<Set<string>>(new Set());\n  const [installedCarts, setInstalledCarts] = useState<Set<string>>(new Set());\n  const [loading, setLoading] = useState(true);\n  const [error, setError] = useState<string | null>(null);\n\n  useEffect(() => {\n    const ac = new AbortController();\n    let cancelled = false;\n    setLoading(true);\n    setError(null);\n    (async () => {\n      try {\n        const r = await fetch(`${apiBaseUrl}/_console/contracts`, {\n          signal: ac.signal,\n          credentials: \"include\",\n          headers: authHeaders(),\n        });\n        if (!r.ok) throw new Error(`HTTP ${r.status}`);\n        const data = (await r.json()) as Contract[];\n        if (!Array.isArray(data)) throw new Error(\"malformed contracts response\");\n        if (cancelled) return;\n        const { reg, core, installed } = buildRegistry(data);\n        setRegistry(reg);\n        setCoreCarts(core);\n        setInstalledCarts(installed);\n      } catch (e) {\n        if (cancelled || (e as { name?: string }).name === \"AbortError\") return;\n        setError(e instanceof Error ? e.message : String(e));\n      } finally {\n        if (!cancelled) setLoading(false);\n      }\n    })();\n    return () => {\n      cancelled = true;\n      ac.abort();\n    };\n  }, [apiBaseUrl]);\n\n  const carts = Object.keys(registry).sort();\n  return { registry, carts, coreCarts, installedCarts, loading, error };\n}\n", "// Fetchers + hook for the Google Sheets cartridge-sync admin endpoints\n// (/_console/integrations/gsheets/*). Admin-gated server-side \u2014 the requests\n// carry the devtools Bearer token (authHeaders) like the contracts probe.\n\nimport { useCallback, useMemo } from \"react\";\nimport { useDevToolsConfig } from \"./config\";\nimport { authHeaders } from \"./auth\";\n\nexport type GsheetSyncConfig = {\n  cartridge: string;\n  spreadsheetId: string;\n  saEmail: string;\n  hasServiceAccount: boolean;\n  intervalSeconds: number;\n  enabled: boolean;\n  lastSyncAt: number; // ms epoch, 0 = never\n  status: string; // \"ok\" | \"error\" | \"\"\n  lastError: string;\n};\n\nexport type GsheetSaveInput = {\n  cartridge: string;\n  spreadsheetUrl: string;\n  serviceAccountJson?: string; // omit to keep the stored key\n  intervalSeconds: number;\n  enabled: boolean;\n};\n\nasync function jsonOrThrow(r: Response) {\n  const body = await r.json().catch(() => ({}));\n  if (!r.ok) throw new Error((body as { error?: string })?.error ?? `HTTP ${r.status}`);\n  return body;\n}\n\nexport function useGsheetsApi() {\n  const { apiBaseUrl } = useDevToolsConfig();\n\n  const list = useCallback(\n    async (): Promise<GsheetSyncConfig[]> =>\n      jsonOrThrow(\n        await fetch(`${apiBaseUrl}/_console/integrations/gsheets`, {\n          credentials: \"include\",\n          headers: authHeaders(),\n        }),\n      ),\n    [apiBaseUrl],\n  );\n\n  const save = useCallback(\n    async (input: GsheetSaveInput): Promise<GsheetSyncConfig> =>\n      jsonOrThrow(\n        await fetch(`${apiBaseUrl}/_console/integrations/gsheets`, {\n          method: \"POST\",\n          credentials: \"include\",\n          headers: authHeaders({ \"content-type\": \"application/json\" }),\n          body: JSON.stringify(input),\n        }),\n      ),\n    [apiBaseUrl],\n  );\n\n  const syncNow = useCallback(\n    async (cartridge: string): Promise<{ ok: boolean; error: string }> =>\n      jsonOrThrow(\n        await fetch(`${apiBaseUrl}/_console/integrations/gsheets/sync`, {\n          method: \"POST\",\n          credentials: \"include\",\n          headers: authHeaders({ \"content-type\": \"application/json\" }),\n          body: JSON.stringify({ cartridge }),\n        }),\n      ),\n    [apiBaseUrl],\n  );\n\n  const remove = useCallback(\n    async (cartridge: string): Promise<{ ok: boolean }> =>\n      jsonOrThrow(\n        await fetch(`${apiBaseUrl}/_console/integrations/gsheets/${encodeURIComponent(cartridge)}`, {\n          method: \"DELETE\",\n          credentials: \"include\",\n          headers: authHeaders(),\n        }),\n      ),\n    [apiBaseUrl],\n  );\n\n  return useMemo(() => ({ list, save, syncNow, remove }), [list, save, syncNow, remove]);\n}\n", "// Fetchers + hook for the workflow-engine introspection endpoints\n// (/_console/wf*). The read routes are ungated like /_console/metrics; the two\n// mutating ones (cancel/advance) are admin-gated server-side, so every request\n// carries the devtools Bearer token (authHeaders) like the contracts probe.\n\nimport { useCallback, useMemo } from \"react\";\nimport { useDevToolsConfig } from \"./config\";\nimport { authHeaders } from \"./auth\";\n\n// Terminal statuses a workflow can settle into \u2014 used to decide whether to keep\n// polling an open instance and whether Cancel is offered.\nexport const WF_TERMINAL = [\"COMPLETED\", \"FAILED\", \"CANCELLED\", \"CONTINUED\"] as const;\n\nexport type WfStatus =\n  | \"RUNNING\"\n  | \"SUSPENDED\"\n  | \"COMPLETED\"\n  | \"FAILED\"\n  | \"CANCELLED\"\n  | \"CONTINUED\";\n\n// Row from GET /_console/wf \u2014 the enriched list (createdAt/updatedAt are unix ms).\nexport type WfListItem = {\n  id: string;\n  status: WfStatus;\n  workflowName: string;\n  createdAt: number;\n  updatedAt: number;\n  lane: string;\n  deployVersion: number;\n};\n\n// The execution record from GET /_console/wf/:id (raw entity field names).\nexport type WfExecution = {\n  id: string;\n  status: WfStatus;\n  workflowName: string;\n  args?: string;\n  result?: string;\n  error?: string;\n  cursor: number;\n  lane?: string;\n  deployVersion: number;\n  createdAt: number;\n  updatedAt: number;\n};\n\n// One journal entry. kind \u2208 HOST_CALL_INTENT | HOST_CALL_RESULT | SUSPENDED |\n// RESUMED | RETRY | COMPLETED | FAILED | CANCELLED | CONTINUED.\nexport type WfEvent = {\n  id: string;\n  seq: number;\n  kind: string;\n  capability?: string;\n  target?: string;\n  op?: string;\n  payload?: string;\n};\n\nexport type WfDetail = { execution: WfExecution; events: WfEvent[] };\n\nexport type WfStats = {\n  writes: number;\n  reads: number;\n  emails: number;\n  fetches: number;\n  emits: number;\n  retries: number;\n  async_inflight: number;\n  async_peak: number;\n};\n\nexport type WfVersion = { version: number; refcount: number; current: boolean };\n\n// The exec-reply shape returned by run/signal/advance/cancel.\nexport type WfExecReply = {\n  id: string;\n  outcome: string;\n  status: string;\n  result?: string;\n  error?: string;\n};\n\nasync function jsonOrThrow(r: Response) {\n  const body = await r.json().catch(() => ({}));\n  if (!r.ok) throw new Error((body as { error?: string })?.error ?? `HTTP ${r.status}`);\n  return body;\n}\n\nexport function isWfTerminal(status: string): boolean {\n  return (WF_TERMINAL as readonly string[]).includes(status);\n}\n\nexport function useWorkflowsApi() {\n  const { apiBaseUrl } = useDevToolsConfig();\n\n  const listExecutions = useCallback(\n    async (): Promise<WfListItem[]> =>\n      jsonOrThrow(\n        await fetch(`${apiBaseUrl}/_console/wf`, {\n          credentials: \"include\",\n          headers: authHeaders(),\n        }),\n      ),\n    [apiBaseUrl],\n  );\n\n  const getExecution = useCallback(\n    async (id: string): Promise<WfDetail> =>\n      jsonOrThrow(\n        await fetch(`${apiBaseUrl}/_console/wf/${encodeURIComponent(id)}`, {\n          credentials: \"include\",\n          headers: authHeaders(),\n        }),\n      ),\n    [apiBaseUrl],\n  );\n\n  const getStats = useCallback(\n    async (): Promise<WfStats> =>\n      jsonOrThrow(\n        await fetch(`${apiBaseUrl}/_console/wf/stats`, {\n          credentials: \"include\",\n          headers: authHeaders(),\n        }),\n      ),\n    [apiBaseUrl],\n  );\n\n  const getVersions = useCallback(\n    async (): Promise<WfVersion[]> =>\n      jsonOrThrow(\n        await fetch(`${apiBaseUrl}/_console/wf/versions`, {\n          credentials: \"include\",\n          headers: authHeaders(),\n        }),\n      ),\n    [apiBaseUrl],\n  );\n\n  const cancel = useCallback(\n    async (id: string): Promise<WfExecReply> =>\n      jsonOrThrow(\n        await fetch(`${apiBaseUrl}/_console/wf/cancel`, {\n          method: \"POST\",\n          credentials: \"include\",\n          headers: authHeaders({ \"content-type\": \"application/json\" }),\n          body: JSON.stringify({ id }),\n        }),\n      ),\n    [apiBaseUrl],\n  );\n\n  const advance = useCallback(\n    async (id: string): Promise<WfExecReply> =>\n      jsonOrThrow(\n        await fetch(`${apiBaseUrl}/_console/wf/advance`, {\n          method: \"POST\",\n          credentials: \"include\",\n          headers: authHeaders({ \"content-type\": \"application/json\" }),\n          body: JSON.stringify({ id }),\n        }),\n      ),\n    [apiBaseUrl],\n  );\n\n  return useMemo(\n    () => ({ listExecutions, getExecution, getStats, getVersions, cancel, advance }),\n    [listExecutions, getExecution, getStats, getVersions, cancel, advance],\n  );\n}\n"],
+  "mappings": "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",
+  "names": ["useCallback", "useMemo", "jsonOrThrow", "useCallback", "useMemo"]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nbt-dev/components",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Reusable React building blocks for NBT-console apps: the CodeMirror NBT editor (+LSP), the entity graph, and the live data table.",
   "type": "module",
   "main": "dist/index.js",

package/src/core/index.ts

@@ -23,6 +23,17 @@ export type {
 } from "./use-cartridge-info";
 export { useGsheetsApi } from "./use-gsheets";
 export type { GsheetSyncConfig, GsheetSaveInput } from "./use-gsheets";
+export { useWorkflowsApi, isWfTerminal, WF_TERMINAL } from "./use-workflows";
+export type {
+  WfStatus,
+  WfListItem,
+  WfExecution,
+  WfEvent,
+  WfDetail,
+  WfStats,
+  WfVersion,
+  WfExecReply,
+} from "./use-workflows";
 export {
   getDevToolsToken,
   setDevToolsToken,

package/src/core/use-workflows.ts

@@ -0,0 +1,171 @@
+// Fetchers + hook for the workflow-engine introspection endpoints
+// (/_console/wf*). The read routes are ungated like /_console/metrics; the two
+// mutating ones (cancel/advance) are admin-gated server-side, so every request
+// carries the devtools Bearer token (authHeaders) like the contracts probe.
+
+import { useCallback, useMemo } from "react";
+import { useDevToolsConfig } from "./config";
+import { authHeaders } from "./auth";
+
+// Terminal statuses a workflow can settle into — used to decide whether to keep
+// polling an open instance and whether Cancel is offered.
+export const WF_TERMINAL = ["COMPLETED", "FAILED", "CANCELLED", "CONTINUED"] as const;
+
+export type WfStatus =
+  | "RUNNING"
+  | "SUSPENDED"
+  | "COMPLETED"
+  | "FAILED"
+  | "CANCELLED"
+  | "CONTINUED";
+
+// Row from GET /_console/wf — the enriched list (createdAt/updatedAt are unix ms).
+export type WfListItem = {
+  id: string;
+  status: WfStatus;
+  workflowName: string;
+  createdAt: number;
+  updatedAt: number;
+  lane: string;
+  deployVersion: number;
+};
+
+// The execution record from GET /_console/wf/:id (raw entity field names).
+export type WfExecution = {
+  id: string;
+  status: WfStatus;
+  workflowName: string;
+  args?: string;
+  result?: string;
+  error?: string;
+  cursor: number;
+  lane?: string;
+  deployVersion: number;
+  createdAt: number;
+  updatedAt: number;
+};
+
+// One journal entry. kind ∈ HOST_CALL_INTENT | HOST_CALL_RESULT | SUSPENDED |
+// RESUMED | RETRY | COMPLETED | FAILED | CANCELLED | CONTINUED.
+export type WfEvent = {
+  id: string;
+  seq: number;
+  kind: string;
+  capability?: string;
+  target?: string;
+  op?: string;
+  payload?: string;
+};
+
+export type WfDetail = { execution: WfExecution; events: WfEvent[] };
+
+export type WfStats = {
+  writes: number;
+  reads: number;
+  emails: number;
+  fetches: number;
+  emits: number;
+  retries: number;
+  async_inflight: number;
+  async_peak: number;
+};
+
+export type WfVersion = { version: number; refcount: number; current: boolean };
+
+// The exec-reply shape returned by run/signal/advance/cancel.
+export type WfExecReply = {
+  id: string;
+  outcome: string;
+  status: string;
+  result?: string;
+  error?: string;
+};
+
+async function jsonOrThrow(r: Response) {
+  const body = await r.json().catch(() => ({}));
+  if (!r.ok) throw new Error((body as { error?: string })?.error ?? `HTTP ${r.status}`);
+  return body;
+}
+
+export function isWfTerminal(status: string): boolean {
+  return (WF_TERMINAL as readonly string[]).includes(status);
+}
+
+export function useWorkflowsApi() {
+  const { apiBaseUrl } = useDevToolsConfig();
+
+  const listExecutions = useCallback(
+    async (): Promise<WfListItem[]> =>
+      jsonOrThrow(
+        await fetch(`${apiBaseUrl}/_console/wf`, {
+          credentials: "include",
+          headers: authHeaders(),
+        }),
+      ),
+    [apiBaseUrl],
+  );
+
+  const getExecution = useCallback(
+    async (id: string): Promise<WfDetail> =>
+      jsonOrThrow(
+        await fetch(`${apiBaseUrl}/_console/wf/${encodeURIComponent(id)}`, {
+          credentials: "include",
+          headers: authHeaders(),
+        }),
+      ),
+    [apiBaseUrl],
+  );
+
+  const getStats = useCallback(
+    async (): Promise<WfStats> =>
+      jsonOrThrow(
+        await fetch(`${apiBaseUrl}/_console/wf/stats`, {
+          credentials: "include",
+          headers: authHeaders(),
+        }),
+      ),
+    [apiBaseUrl],
+  );
+
+  const getVersions = useCallback(
+    async (): Promise<WfVersion[]> =>
+      jsonOrThrow(
+        await fetch(`${apiBaseUrl}/_console/wf/versions`, {
+          credentials: "include",
+          headers: authHeaders(),
+        }),
+      ),
+    [apiBaseUrl],
+  );
+
+  const cancel = useCallback(
+    async (id: string): Promise<WfExecReply> =>
+      jsonOrThrow(
+        await fetch(`${apiBaseUrl}/_console/wf/cancel`, {
+          method: "POST",
+          credentials: "include",
+          headers: authHeaders({ "content-type": "application/json" }),
+          body: JSON.stringify({ id }),
+        }),
+      ),
+    [apiBaseUrl],
+  );
+
+  const advance = useCallback(
+    async (id: string): Promise<WfExecReply> =>
+      jsonOrThrow(
+        await fetch(`${apiBaseUrl}/_console/wf/advance`, {
+          method: "POST",
+          credentials: "include",
+          headers: authHeaders({ "content-type": "application/json" }),
+          body: JSON.stringify({ id }),
+        }),
+      ),
+    [apiBaseUrl],
+  );
+
+  return useMemo(
+    () => ({ listExecutions, getExecution, getStats, getVersions, cancel, advance }),
+    [listExecutions, getExecution, getStats, getVersions, cancel, advance],
+  );
+}