@pi-unipi/background-tasks 2.12.0 → 2.13.0

package/README.md

@@ -74,6 +74,22 @@ subscription OAuth attribution, exact-match system-prompt sanitization, and
 cache-retention policy for Anthropic routes. Duplicate installed copies resolve
 ownership through an EventBus claim; later copies go inert.
 
+## Shared registry (for sibling extensions)
+
+Other packages can read the live task registry synchronously — no events, no polling:
+
+```ts
+import { getSharedTaskRegistry } from "@pi-unipi/background-tasks";
+
+const tasks = getSharedTaskRegistry()?.allTasks() ?? [];
+const running = tasks.filter((t) => t.status === "running").length;
+```
+
+The registry is published on `globalThis` under a `Symbol.for` key at extension
+init and `session_start`, and cleared on `session_shutdown` (counts are
+per-session). Returns `undefined` when the module is disabled — callers must
+treat that as "no data", e.g. the footer's glance process line does.
+
 ## Differences from the reference
 
 - Commands live in the `/unipi:*` namespace; env prefix is `UNIPI_BG_*`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/background-tasks",
-  "version": "2.12.0",
+  "version": "2.13.0",
   "description": "Background tasks for UniPi — durable shell jobs, delegated agents, attested Pi runs, and fixed-purpose Fusion workflows",
   "type": "module",
   "main": "src/index.ts",

package/src/index.ts

@@ -19,10 +19,14 @@ import {
 import { registerToolsAndCommands } from "./tools.js";
 import { registerFusionExtension } from "./fusion-extension.js";
 import { registerDelegateExtension } from "./delegate-extension.js";
+import { setSharedTaskRegistry, clearSharedTaskRegistry } from "./registry-shared.js";
 import { taskDisplayName, type BgTask, type StartAttestedPiTaskOptions, type StartTaskOptions } from "./types.js";
 
 const STATUS_INTERVAL_MS = 1000;
 
+// Direct synchronous access for sibling extensions (footer process one-liner).
+export { getSharedTaskRegistry } from "./registry-shared.js";
+
 export default function backgroundTasksExtension(pi: ExtensionAPI): void {
   const { config, warnings } = loadBackgroundTasksConfig(process.cwd());
 
@@ -53,6 +57,8 @@ export default function backgroundTasksExtension(pi: ExtensionAPI): void {
       eventService.publishTerminal(task);
     },
   });
+  setSharedTaskRegistry(registry);
+
   const eventService: BackgroundTaskExtensionService = installBackgroundTaskExtensionApi({
     events: pi.events,
     registry,
@@ -253,6 +259,7 @@ export default function backgroundTasksExtension(pi: ExtensionAPI): void {
 
   pi.on("session_start", async (_event, ctx) => {
     registry.setShuttingDown(false);
+    setSharedTaskRegistry(registry);
     currentCtx = ctx;
     await registry.ensureRuntimeDir(ctx);
     updateUi(ctx);
@@ -264,6 +271,7 @@ export default function backgroundTasksExtension(pi: ExtensionAPI): void {
 
   pi.on("session_shutdown", async (_event, ctx) => {
     registry.setShuttingDown(true);
+    clearSharedTaskRegistry();
     currentCtx = undefined;
     if (statusInterval) {
       clearInterval(statusInterval);

package/src/registry-shared.ts

@@ -0,0 +1,32 @@
+/**
+ * Shared BackgroundTaskRegistry accessor
+ *
+ * Exposes the live registry to sibling extensions (e.g. @pi-unipi/footer)
+ * without events or request/response channels — direct synchronous reads of
+ * `allTasks()`.
+ *
+ * Stored on globalThis under a `Symbol.for` key so the singleton is shared
+ * even if this package ends up instantiated more than once (duplicate
+ * node_modules copies would otherwise each hold their own module state).
+ */
+
+import type { BackgroundTaskRegistry } from "./registry.js";
+
+const SHARED_REGISTRY_KEY = Symbol.for("unipi.background-tasks.shared-registry");
+
+/** Publish the live registry (idempotent; later calls overwrite). */
+export function setSharedTaskRegistry(registry: BackgroundTaskRegistry): void {
+  (globalThis as unknown as Record<symbol, unknown>)[SHARED_REGISTRY_KEY] = registry;
+}
+
+/** Read the live registry, or undefined when background-tasks is not loaded. */
+export function getSharedTaskRegistry(): BackgroundTaskRegistry | undefined {
+  return (globalThis as unknown as Record<symbol, unknown>)[SHARED_REGISTRY_KEY] as
+    | BackgroundTaskRegistry
+    | undefined;
+}
+
+/** Drop the shared reference (used on session shutdown so readers see a clean slate). */
+export function clearSharedTaskRegistry(): void {
+  delete (globalThis as unknown as Record<symbol, unknown>)[SHARED_REGISTRY_KEY];
+}