@cnstra/pg-boss 0.1.0

package/README.md

@@ -0,0 +1,86 @@
+# @cnstra/pg-boss
+
+> **⚠️ Experimental**: API may change in future versions.
+
+[pg-boss](https://github.com/timgit/pg-boss) (Postgres-backed job queue) integration for
+[CNStra](https://cnstra.org). Run each stimulation as a durable job, get Postgres-native
+retry/backoff/scheduling/singleton, and stream **per-hop progress** into any store for a
+live admin/history view.
+
+It follows the same pattern as the [Message Brokers guide](https://cnstra.org/docs/integrations/message-brokers):
+**one job = one stimulation**, reconstructed across processes by **name** via a
+`CNSPersistOptionsRegistry` (neuron/collateral object references are not portable).
+
+## Install
+
+```bash
+npm install @cnstra/pg-boss @cnstra/core pg-boss
+```
+
+## Worker
+
+```ts
+import PgBoss from 'pg-boss';
+import { createCNS } from '@cnstra/core';
+import { createCNSWorker } from '@cnstra/pg-boss';
+
+const { cns, registry } = createCNS({ importUserNeuron, /* … */ });
+
+const boss = new PgBoss(process.env.DATABASE_URL!);
+await boss.start();
+await boss.createQueue('cns');
+
+await createCNSWorker({
+  boss,
+  cns,
+  registry,
+  queue: 'cns',
+  // Optional: durably record every step. If onHop returns a Promise, CNStra
+  // waits for it before running the next hop (per-hop checkpoint barrier).
+  progress: {
+    onStarted: (s) => db.insertStimulation(s),
+    onHop:     (h) => db.insertHop(h),   // unique(stimulation_id, index) → idempotent
+    onCompleted: (s) => db.finishStimulation(s),
+  },
+});
+```
+
+The worker reconstructs the entry signal from the job's `collateralName`, stimulates, and
+awaits completion. If the stimulation fails or aborts, `waitUntilComplete()` rejects and the
+error propagates so **pg-boss applies its retry/backoff policy**.
+
+## Producer
+
+```ts
+import { enqueueStimulation, stimulationJob } from '@cnstra/pg-boss';
+
+// Type-safe: throws if the collateral isn't registered
+const job = stimulationJob(registry, importUser, { userId: '42' });
+
+await enqueueStimulation(boss, 'cns', job, {
+  retryLimit: 5,
+  retryBackoff: true,
+  singletonKey: 'user:42', // one in-flight stimulation per entity
+});
+```
+
+## Retries & resume
+
+- **Cross-process (recommended):** a retried job re-runs the whole flow from the entry signal.
+  Make neurons **idempotent**, or deduplicate hops with `unique(stimulation_id, index)`.
+- **In-process partial resume:** `cns.activate(getFailedTasks())` works only within one process
+  (it holds live object references) — it is not portable through the queue.
+
+## What this package does / doesn't
+
+- ✅ Job execution, retry/backoff, scheduling, singleton, concurrency → **pg-boss**.
+- ✅ Per-step (hop) progress records → the `progress` sink (your tables / OIMDB / logs).
+- ❌ No built-in Postgres schema or admin UI — you own the store. pg-boss has **no per-step
+  progress** of its own, so step history is always your tables. See the docs for a schema and
+  an admin-panel design.
+
+See the full guide: https://cnstra.org/docs/integrations/pg-boss
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,126 @@
+import { ICNS, CNSPersistOptionsRegistry, CNSCollateral } from '@cnstra/core';
+
+/**
+ * Minimal, structural view of the pg-boss surface this package touches.
+ *
+ * We type against these instead of importing `pg-boss` directly so the package
+ * builds without pg-boss installed. It is compatible with pg-boss v9/v10+ where
+ * `work` handlers receive an array of jobs (batch). Pass your real `PgBoss`
+ * instance — it satisfies this shape structurally.
+ */
+interface IPgBossJob<TData = unknown> {
+    id: string;
+    name: string;
+    data: TData;
+}
+interface IPgBossLike {
+    send(name: string, data: object, options?: Record<string, unknown>): Promise<string | null>;
+    work<TData extends object>(name: string, handler: (jobs: IPgBossJob<TData>[]) => Promise<unknown>): Promise<string>;
+    work<TData extends object>(name: string, options: Record<string, unknown>, handler: (jobs: IPgBossJob<TData>[]) => Promise<unknown>): Promise<string>;
+}
+/**
+ * The payload placed on the queue. It carries the collateral **name** and a
+ * JSON-serializable payload — never live neuron/collateral object references,
+ * which are not portable across processes.
+ */
+interface TCNSStimulationJobData {
+    collateralName: string;
+    payload: unknown;
+    /** Optional per-run cap on neuron hops. */
+    maxNeuronHops?: number;
+}
+/** One per-hop progress record (mirrors the devtools `CNSDTOHop` shape). */
+interface TCNSHopRecord {
+    jobId: string;
+    index: number;
+    neuronName: string | null;
+    inputCollateral: string | null;
+    outputCollateral: string | null;
+    inputPayload: unknown;
+    outputPayload: unknown;
+    error: string | null;
+    at: number;
+}
+/** Lifecycle record for one stimulation (one job). */
+interface TCNSStimulationLifecycle {
+    jobId: string;
+    collateralName: string;
+    payload: unknown;
+    status: 'running' | 'completed' | 'failed';
+    startedAt: number;
+    completedAt?: number;
+    hopCount: number;
+    error?: string;
+}
+/**
+ * Where progress is written (Postgres, OIMDB, logs, …).
+ *
+ * If `onHop` returns a Promise, CNStra waits for it **before enqueuing the next
+ * hop** — i.e. each step is durably committed before the flow advances. This is
+ * the per-hop checkpoint barrier that makes an admin/progress view truthful
+ * across restarts.
+ */
+interface ICNSProgressSink {
+    onStarted?(rec: TCNSStimulationLifecycle): void | Promise<void>;
+    onHop?(rec: TCNSHopRecord): void | Promise<void>;
+    onCompleted?(rec: TCNSStimulationLifecycle): void | Promise<void>;
+}
+/** Structural view of the response passed to `onResponse` (not exported by core). */
+interface ICNSResponseLike {
+    inputSignal?: {
+        collateral?: unknown;
+        payload?: unknown;
+    };
+    outputSignal?: {
+        collateral?: unknown;
+        payload?: unknown;
+    };
+    error?: unknown;
+}
+
+interface TCNSWorkerOptions {
+    /** Your pg-boss instance (already started). */
+    boss: IPgBossLike;
+    /** The CNS the jobs run against. */
+    cns: ICNS<any, any>;
+    /** Name ↔ object registry used to reconstruct signals from job data. */
+    registry: CNSPersistOptionsRegistry;
+    /** Queue name to consume. */
+    queue: string;
+    /** Optional durable progress sink (started / hop / completed). */
+    progress?: ICNSProgressSink;
+    /** pg-boss `work` options (batchSize, pollingIntervalSeconds, …). */
+    workOptions?: Record<string, unknown>;
+}
+/**
+ * Register a pg-boss worker that turns each job into a CNStra stimulation.
+ *
+ * One job = one stimulation. The job carries `{ collateralName, payload }`; the
+ * worker reconstructs the entry signal by name, stimulates, optionally streams
+ * per-hop progress, and awaits completion. If the stimulation fails or aborts,
+ * `waitUntilComplete()` rejects and the error propagates so pg-boss applies its
+ * own retry/backoff policy.
+ */
+declare function createCNSWorker(options: TCNSWorkerOptions): Promise<string>;
+
+/** Commonly used pg-boss send options (a superset is passed through). */
+interface TCNSSendOptions {
+    retryLimit?: number;
+    retryBackoff?: boolean;
+    retryDelay?: number;
+    /** One in-flight job per key — e.g. one stimulation per entity id. */
+    singletonKey?: string;
+    startAfter?: number | string | Date;
+    expireInSeconds?: number;
+    priority?: number;
+    [key: string]: unknown;
+}
+/**
+ * Build a queue job from a **registered** collateral. Throws if the collateral
+ * is not in the registry, so a typo can't reach the queue.
+ */
+declare function stimulationJob(registry: CNSPersistOptionsRegistry, collateral: CNSCollateral<unknown>, payload: unknown, extra?: Pick<TCNSStimulationJobData, 'maxNeuronHops'>): TCNSStimulationJobData;
+/** Send a stimulation job to a pg-boss queue. Returns the job id. */
+declare function enqueueStimulation(boss: IPgBossLike, queue: string, job: TCNSStimulationJobData, options?: TCNSSendOptions): Promise<string | null>;
+
+export { type ICNSProgressSink, type ICNSResponseLike, type IPgBossJob, type IPgBossLike, type TCNSHopRecord, type TCNSSendOptions, type TCNSStimulationJobData, type TCNSStimulationLifecycle, type TCNSWorkerOptions, createCNSWorker, enqueueStimulation, stimulationJob };

package/dist/index.d.ts

@@ -0,0 +1,126 @@
+import { ICNS, CNSPersistOptionsRegistry, CNSCollateral } from '@cnstra/core';
+
+/**
+ * Minimal, structural view of the pg-boss surface this package touches.
+ *
+ * We type against these instead of importing `pg-boss` directly so the package
+ * builds without pg-boss installed. It is compatible with pg-boss v9/v10+ where
+ * `work` handlers receive an array of jobs (batch). Pass your real `PgBoss`
+ * instance — it satisfies this shape structurally.
+ */
+interface IPgBossJob<TData = unknown> {
+    id: string;
+    name: string;
+    data: TData;
+}
+interface IPgBossLike {
+    send(name: string, data: object, options?: Record<string, unknown>): Promise<string | null>;
+    work<TData extends object>(name: string, handler: (jobs: IPgBossJob<TData>[]) => Promise<unknown>): Promise<string>;
+    work<TData extends object>(name: string, options: Record<string, unknown>, handler: (jobs: IPgBossJob<TData>[]) => Promise<unknown>): Promise<string>;
+}
+/**
+ * The payload placed on the queue. It carries the collateral **name** and a
+ * JSON-serializable payload — never live neuron/collateral object references,
+ * which are not portable across processes.
+ */
+interface TCNSStimulationJobData {
+    collateralName: string;
+    payload: unknown;
+    /** Optional per-run cap on neuron hops. */
+    maxNeuronHops?: number;
+}
+/** One per-hop progress record (mirrors the devtools `CNSDTOHop` shape). */
+interface TCNSHopRecord {
+    jobId: string;
+    index: number;
+    neuronName: string | null;
+    inputCollateral: string | null;
+    outputCollateral: string | null;
+    inputPayload: unknown;
+    outputPayload: unknown;
+    error: string | null;
+    at: number;
+}
+/** Lifecycle record for one stimulation (one job). */
+interface TCNSStimulationLifecycle {
+    jobId: string;
+    collateralName: string;
+    payload: unknown;
+    status: 'running' | 'completed' | 'failed';
+    startedAt: number;
+    completedAt?: number;
+    hopCount: number;
+    error?: string;
+}
+/**
+ * Where progress is written (Postgres, OIMDB, logs, …).
+ *
+ * If `onHop` returns a Promise, CNStra waits for it **before enqueuing the next
+ * hop** — i.e. each step is durably committed before the flow advances. This is
+ * the per-hop checkpoint barrier that makes an admin/progress view truthful
+ * across restarts.
+ */
+interface ICNSProgressSink {
+    onStarted?(rec: TCNSStimulationLifecycle): void | Promise<void>;
+    onHop?(rec: TCNSHopRecord): void | Promise<void>;
+    onCompleted?(rec: TCNSStimulationLifecycle): void | Promise<void>;
+}
+/** Structural view of the response passed to `onResponse` (not exported by core). */
+interface ICNSResponseLike {
+    inputSignal?: {
+        collateral?: unknown;
+        payload?: unknown;
+    };
+    outputSignal?: {
+        collateral?: unknown;
+        payload?: unknown;
+    };
+    error?: unknown;
+}
+
+interface TCNSWorkerOptions {
+    /** Your pg-boss instance (already started). */
+    boss: IPgBossLike;
+    /** The CNS the jobs run against. */
+    cns: ICNS<any, any>;
+    /** Name ↔ object registry used to reconstruct signals from job data. */
+    registry: CNSPersistOptionsRegistry;
+    /** Queue name to consume. */
+    queue: string;
+    /** Optional durable progress sink (started / hop / completed). */
+    progress?: ICNSProgressSink;
+    /** pg-boss `work` options (batchSize, pollingIntervalSeconds, …). */
+    workOptions?: Record<string, unknown>;
+}
+/**
+ * Register a pg-boss worker that turns each job into a CNStra stimulation.
+ *
+ * One job = one stimulation. The job carries `{ collateralName, payload }`; the
+ * worker reconstructs the entry signal by name, stimulates, optionally streams
+ * per-hop progress, and awaits completion. If the stimulation fails or aborts,
+ * `waitUntilComplete()` rejects and the error propagates so pg-boss applies its
+ * own retry/backoff policy.
+ */
+declare function createCNSWorker(options: TCNSWorkerOptions): Promise<string>;
+
+/** Commonly used pg-boss send options (a superset is passed through). */
+interface TCNSSendOptions {
+    retryLimit?: number;
+    retryBackoff?: boolean;
+    retryDelay?: number;
+    /** One in-flight job per key — e.g. one stimulation per entity id. */
+    singletonKey?: string;
+    startAfter?: number | string | Date;
+    expireInSeconds?: number;
+    priority?: number;
+    [key: string]: unknown;
+}
+/**
+ * Build a queue job from a **registered** collateral. Throws if the collateral
+ * is not in the registry, so a typo can't reach the queue.
+ */
+declare function stimulationJob(registry: CNSPersistOptionsRegistry, collateral: CNSCollateral<unknown>, payload: unknown, extra?: Pick<TCNSStimulationJobData, 'maxNeuronHops'>): TCNSStimulationJobData;
+/** Send a stimulation job to a pg-boss queue. Returns the job id. */
+declare function enqueueStimulation(boss: IPgBossLike, queue: string, job: TCNSStimulationJobData, options?: TCNSSendOptions): Promise<string | null>;
+
+export { type ICNSProgressSink, type ICNSResponseLike, type IPgBossJob, type IPgBossLike, type TCNSHopRecord, type TCNSSendOptions, type TCNSStimulationJobData, type TCNSStimulationLifecycle, type TCNSWorkerOptions, createCNSWorker, enqueueStimulation, stimulationJob };

package/dist/index.js

@@ -0,0 +1,134 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  createCNSWorker: () => createCNSWorker,
+  enqueueStimulation: () => enqueueStimulation,
+  stimulationJob: () => stimulationJob
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/worker.ts
+function toHopRecord(jobId, index, resp, cns, registry) {
+  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k;
+  const outputCol = (_a = resp.outputSignal) == null ? void 0 : _a.collateral;
+  const inputCol = (_b = resp.inputSignal) == null ? void 0 : _b.collateral;
+  const ownerNeuron = outputCol ? cns.network.getParentNeuronByCollateral(outputCol) : null;
+  return {
+    jobId,
+    index,
+    neuronName: ownerNeuron ? (_c = registry.getNeuronName(ownerNeuron)) != null ? _c : null : null,
+    inputCollateral: inputCol ? (_d = registry.getCollateralName(inputCol)) != null ? _d : null : null,
+    outputCollateral: outputCol ? (_e = registry.getCollateralName(outputCol)) != null ? _e : null : null,
+    inputPayload: (_i = (_h = (_f = resp.inputSignal) == null ? void 0 : _f.payload) != null ? _h : (_g = resp.outputSignal) == null ? void 0 : _g.payload) != null ? _i : null,
+    outputPayload: outputCol ? (_k = (_j = resp.outputSignal) == null ? void 0 : _j.payload) != null ? _k : null : null,
+    error: resp.error != null ? String(resp.error) : null,
+    at: Date.now()
+  };
+}
+function createCNSWorker(options) {
+  const { boss, cns, registry, queue, progress, workOptions } = options;
+  const runJob = async (job) => {
+    var _a, _b, _c;
+    const { collateralName, payload, maxNeuronHops } = job.data;
+    const collateral = registry.getCollateral(collateralName);
+    if (!collateral) {
+      throw new Error(
+        `[@cnstra/pg-boss] Unknown collateral "${collateralName}". Register it in the CNSPersistOptionsRegistry.`
+      );
+    }
+    const startedAt = Date.now();
+    let hopCount = 0;
+    await ((_a = progress == null ? void 0 : progress.onStarted) == null ? void 0 : _a.call(progress, {
+      jobId: job.id,
+      collateralName,
+      payload,
+      status: "running",
+      startedAt,
+      hopCount: 0
+    }));
+    const stimulation = cns.stimulate(collateral.createSignal(payload), {
+      maxNeuronHops,
+      onResponse: async (resp) => {
+        var _a2;
+        const rec = toHopRecord(
+          job.id,
+          hopCount,
+          resp,
+          cns,
+          registry
+        );
+        hopCount += 1;
+        await ((_a2 = progress == null ? void 0 : progress.onHop) == null ? void 0 : _a2.call(progress, rec));
+      }
+    });
+    try {
+      await stimulation.waitUntilComplete();
+      await ((_b = progress == null ? void 0 : progress.onCompleted) == null ? void 0 : _b.call(progress, {
+        jobId: job.id,
+        collateralName,
+        payload,
+        status: "completed",
+        startedAt,
+        completedAt: Date.now(),
+        hopCount
+      }));
+    } catch (err) {
+      await ((_c = progress == null ? void 0 : progress.onCompleted) == null ? void 0 : _c.call(progress, {
+        jobId: job.id,
+        collateralName,
+        payload,
+        status: "failed",
+        startedAt,
+        completedAt: Date.now(),
+        hopCount,
+        error: err instanceof Error ? err.message : String(err)
+      }));
+      throw err;
+    }
+  };
+  const handler = async (jobs) => {
+    for (const job of jobs) {
+      await runJob(job);
+    }
+  };
+  return workOptions ? boss.work(queue, workOptions, handler) : boss.work(queue, handler);
+}
+
+// src/enqueue.ts
+function stimulationJob(registry, collateral, payload, extra) {
+  const collateralName = registry.getCollateralName(collateral);
+  if (!collateralName) {
+    throw new Error(
+      "[@cnstra/pg-boss] Collateral is not registered in the CNSPersistOptionsRegistry; cannot enqueue it by name."
+    );
+  }
+  return { collateralName, payload, ...extra };
+}
+function enqueueStimulation(boss, queue, job, options) {
+  return boss.send(queue, job, options);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createCNSWorker,
+  enqueueStimulation,
+  stimulationJob
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/worker.ts","../src/enqueue.ts"],"sourcesContent":["export { createCNSWorker } from './worker';\nexport type { TCNSWorkerOptions } from './worker';\n\nexport { enqueueStimulation, stimulationJob } from './enqueue';\nexport type { TCNSSendOptions } from './enqueue';\n\nexport type {\n    IPgBossLike,\n    IPgBossJob,\n    TCNSStimulationJobData,\n    TCNSHopRecord,\n    TCNSStimulationLifecycle,\n    ICNSProgressSink,\n    ICNSResponseLike,\n} from './types';\n","import type { CNSPersistOptionsRegistry, ICNS } from '@cnstra/core';\nimport type {\n    IPgBossLike,\n    IPgBossJob,\n    ICNSProgressSink,\n    ICNSResponseLike,\n    TCNSHopRecord,\n    TCNSStimulationJobData,\n} from './types';\n\nexport interface TCNSWorkerOptions {\n    /** Your pg-boss instance (already started). */\n    boss: IPgBossLike;\n    /** The CNS the jobs run against. */\n    cns: ICNS<any, any>;\n    /** Name ↔ object registry used to reconstruct signals from job data. */\n    registry: CNSPersistOptionsRegistry;\n    /** Queue name to consume. */\n    queue: string;\n    /** Optional durable progress sink (started / hop / completed). */\n    progress?: ICNSProgressSink;\n    /** pg-boss `work` options (batchSize, pollingIntervalSeconds, …). */\n    workOptions?: Record<string, unknown>;\n}\n\n/**\n * Resolve a single response into a durable hop record, turning live object\n * references into stable names via the registry (same derivation devtools uses).\n */\nfunction toHopRecord(\n    jobId: string,\n    index: number,\n    resp: ICNSResponseLike,\n    cns: ICNS<any, any>,\n    registry: CNSPersistOptionsRegistry\n): TCNSHopRecord {\n    const outputCol = resp.outputSignal?.collateral;\n    const inputCol = resp.inputSignal?.collateral;\n\n    const ownerNeuron = outputCol\n        ? cns.network.getParentNeuronByCollateral(outputCol as any)\n        : null;\n\n    return {\n        jobId,\n        index,\n        neuronName: ownerNeuron\n            ? registry.getNeuronName(ownerNeuron as any) ?? null\n            : null,\n        inputCollateral: inputCol\n            ? registry.getCollateralName(inputCol as any) ?? null\n            : null,\n        outputCollateral: outputCol\n            ? registry.getCollateralName(outputCol as any) ?? null\n            : null,\n        inputPayload:\n            resp.inputSignal?.payload ?? resp.outputSignal?.payload ?? null,\n        outputPayload: outputCol ? resp.outputSignal?.payload ?? null : null,\n        error: resp.error != null ? String(resp.error) : null,\n        at: Date.now(),\n    };\n}\n\n/**\n * Register a pg-boss worker that turns each job into a CNStra stimulation.\n *\n * One job = one stimulation. The job carries `{ collateralName, payload }`; the\n * worker reconstructs the entry signal by name, stimulates, optionally streams\n * per-hop progress, and awaits completion. If the stimulation fails or aborts,\n * `waitUntilComplete()` rejects and the error propagates so pg-boss applies its\n * own retry/backoff policy.\n */\nexport function createCNSWorker(options: TCNSWorkerOptions): Promise<string> {\n    const { boss, cns, registry, queue, progress, workOptions } = options;\n\n    const runJob = async (\n        job: IPgBossJob<TCNSStimulationJobData>\n    ): Promise<void> => {\n        const { collateralName, payload, maxNeuronHops } = job.data;\n        const collateral = registry.getCollateral(collateralName);\n        if (!collateral) {\n            throw new Error(\n                `[@cnstra/pg-boss] Unknown collateral \"${collateralName}\". ` +\n                    `Register it in the CNSPersistOptionsRegistry.`\n            );\n        }\n\n        const startedAt = Date.now();\n        let hopCount = 0;\n\n        await progress?.onStarted?.({\n            jobId: job.id,\n            collateralName,\n            payload,\n            status: 'running',\n            startedAt,\n            hopCount: 0,\n        });\n\n        const stimulation = cns.stimulate(collateral.createSignal(payload), {\n            maxNeuronHops,\n            onResponse: async (resp: ICNSResponseLike) => {\n                const rec = toHopRecord(\n                    job.id,\n                    hopCount,\n                    resp,\n                    cns,\n                    registry\n                );\n                hopCount += 1;\n                // Returning a Promise makes CNStra wait for the durable write\n                // before enqueuing the next hop (per-hop checkpoint barrier).\n                await progress?.onHop?.(rec);\n            },\n        });\n\n        try {\n            await stimulation.waitUntilComplete();\n            await progress?.onCompleted?.({\n                jobId: job.id,\n                collateralName,\n                payload,\n                status: 'completed',\n                startedAt,\n                completedAt: Date.now(),\n                hopCount,\n            });\n        } catch (err) {\n            await progress?.onCompleted?.({\n                jobId: job.id,\n                collateralName,\n                payload,\n                status: 'failed',\n                startedAt,\n                completedAt: Date.now(),\n                hopCount,\n                error: err instanceof Error ? err.message : String(err),\n            });\n            // Let pg-boss decide about retries/backoff.\n            throw err;\n        }\n    };\n\n    const handler = async (\n        jobs: IPgBossJob<TCNSStimulationJobData>[]\n    ): Promise<void> => {\n        for (const job of jobs) {\n            await runJob(job);\n        }\n    };\n\n    return workOptions\n        ? boss.work<TCNSStimulationJobData>(queue, workOptions, handler)\n        : boss.work<TCNSStimulationJobData>(queue, handler);\n}\n","import type { CNSCollateral, CNSPersistOptionsRegistry } from '@cnstra/core';\nimport type { IPgBossLike, TCNSStimulationJobData } from './types';\n\n/** Commonly used pg-boss send options (a superset is passed through). */\nexport interface TCNSSendOptions {\n    retryLimit?: number;\n    retryBackoff?: boolean;\n    retryDelay?: number;\n    /** One in-flight job per key — e.g. one stimulation per entity id. */\n    singletonKey?: string;\n    startAfter?: number | string | Date;\n    expireInSeconds?: number;\n    priority?: number;\n    [key: string]: unknown;\n}\n\n/**\n * Build a queue job from a **registered** collateral. Throws if the collateral\n * is not in the registry, so a typo can't reach the queue.\n */\nexport function stimulationJob(\n    registry: CNSPersistOptionsRegistry,\n    collateral: CNSCollateral<unknown>,\n    payload: unknown,\n    extra?: Pick<TCNSStimulationJobData, 'maxNeuronHops'>\n): TCNSStimulationJobData {\n    const collateralName = registry.getCollateralName(collateral);\n    if (!collateralName) {\n        throw new Error(\n            '[@cnstra/pg-boss] Collateral is not registered in the ' +\n                'CNSPersistOptionsRegistry; cannot enqueue it by name.'\n        );\n    }\n    return { collateralName, payload, ...extra };\n}\n\n/** Send a stimulation job to a pg-boss queue. Returns the job id. */\nexport function enqueueStimulation(\n    boss: IPgBossLike,\n    queue: string,\n    job: TCNSStimulationJobData,\n    options?: TCNSSendOptions\n): Promise<string | null> {\n    return boss.send(queue, job as unknown as object, options);\n}\n"],"mappings":"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","names":["_a"]}

package/dist/index.mjs

@@ -0,0 +1,106 @@
+// src/worker.ts
+function toHopRecord(jobId, index, resp, cns, registry) {
+  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k;
+  const outputCol = (_a = resp.outputSignal) == null ? void 0 : _a.collateral;
+  const inputCol = (_b = resp.inputSignal) == null ? void 0 : _b.collateral;
+  const ownerNeuron = outputCol ? cns.network.getParentNeuronByCollateral(outputCol) : null;
+  return {
+    jobId,
+    index,
+    neuronName: ownerNeuron ? (_c = registry.getNeuronName(ownerNeuron)) != null ? _c : null : null,
+    inputCollateral: inputCol ? (_d = registry.getCollateralName(inputCol)) != null ? _d : null : null,
+    outputCollateral: outputCol ? (_e = registry.getCollateralName(outputCol)) != null ? _e : null : null,
+    inputPayload: (_i = (_h = (_f = resp.inputSignal) == null ? void 0 : _f.payload) != null ? _h : (_g = resp.outputSignal) == null ? void 0 : _g.payload) != null ? _i : null,
+    outputPayload: outputCol ? (_k = (_j = resp.outputSignal) == null ? void 0 : _j.payload) != null ? _k : null : null,
+    error: resp.error != null ? String(resp.error) : null,
+    at: Date.now()
+  };
+}
+function createCNSWorker(options) {
+  const { boss, cns, registry, queue, progress, workOptions } = options;
+  const runJob = async (job) => {
+    var _a, _b, _c;
+    const { collateralName, payload, maxNeuronHops } = job.data;
+    const collateral = registry.getCollateral(collateralName);
+    if (!collateral) {
+      throw new Error(
+        `[@cnstra/pg-boss] Unknown collateral "${collateralName}". Register it in the CNSPersistOptionsRegistry.`
+      );
+    }
+    const startedAt = Date.now();
+    let hopCount = 0;
+    await ((_a = progress == null ? void 0 : progress.onStarted) == null ? void 0 : _a.call(progress, {
+      jobId: job.id,
+      collateralName,
+      payload,
+      status: "running",
+      startedAt,
+      hopCount: 0
+    }));
+    const stimulation = cns.stimulate(collateral.createSignal(payload), {
+      maxNeuronHops,
+      onResponse: async (resp) => {
+        var _a2;
+        const rec = toHopRecord(
+          job.id,
+          hopCount,
+          resp,
+          cns,
+          registry
+        );
+        hopCount += 1;
+        await ((_a2 = progress == null ? void 0 : progress.onHop) == null ? void 0 : _a2.call(progress, rec));
+      }
+    });
+    try {
+      await stimulation.waitUntilComplete();
+      await ((_b = progress == null ? void 0 : progress.onCompleted) == null ? void 0 : _b.call(progress, {
+        jobId: job.id,
+        collateralName,
+        payload,
+        status: "completed",
+        startedAt,
+        completedAt: Date.now(),
+        hopCount
+      }));
+    } catch (err) {
+      await ((_c = progress == null ? void 0 : progress.onCompleted) == null ? void 0 : _c.call(progress, {
+        jobId: job.id,
+        collateralName,
+        payload,
+        status: "failed",
+        startedAt,
+        completedAt: Date.now(),
+        hopCount,
+        error: err instanceof Error ? err.message : String(err)
+      }));
+      throw err;
+    }
+  };
+  const handler = async (jobs) => {
+    for (const job of jobs) {
+      await runJob(job);
+    }
+  };
+  return workOptions ? boss.work(queue, workOptions, handler) : boss.work(queue, handler);
+}
+
+// src/enqueue.ts
+function stimulationJob(registry, collateral, payload, extra) {
+  const collateralName = registry.getCollateralName(collateral);
+  if (!collateralName) {
+    throw new Error(
+      "[@cnstra/pg-boss] Collateral is not registered in the CNSPersistOptionsRegistry; cannot enqueue it by name."
+    );
+  }
+  return { collateralName, payload, ...extra };
+}
+function enqueueStimulation(boss, queue, job, options) {
+  return boss.send(queue, job, options);
+}
+export {
+  createCNSWorker,
+  enqueueStimulation,
+  stimulationJob
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/worker.ts","../src/enqueue.ts"],"sourcesContent":["import type { CNSPersistOptionsRegistry, ICNS } from '@cnstra/core';\nimport type {\n    IPgBossLike,\n    IPgBossJob,\n    ICNSProgressSink,\n    ICNSResponseLike,\n    TCNSHopRecord,\n    TCNSStimulationJobData,\n} from './types';\n\nexport interface TCNSWorkerOptions {\n    /** Your pg-boss instance (already started). */\n    boss: IPgBossLike;\n    /** The CNS the jobs run against. */\n    cns: ICNS<any, any>;\n    /** Name ↔ object registry used to reconstruct signals from job data. */\n    registry: CNSPersistOptionsRegistry;\n    /** Queue name to consume. */\n    queue: string;\n    /** Optional durable progress sink (started / hop / completed). */\n    progress?: ICNSProgressSink;\n    /** pg-boss `work` options (batchSize, pollingIntervalSeconds, …). */\n    workOptions?: Record<string, unknown>;\n}\n\n/**\n * Resolve a single response into a durable hop record, turning live object\n * references into stable names via the registry (same derivation devtools uses).\n */\nfunction toHopRecord(\n    jobId: string,\n    index: number,\n    resp: ICNSResponseLike,\n    cns: ICNS<any, any>,\n    registry: CNSPersistOptionsRegistry\n): TCNSHopRecord {\n    const outputCol = resp.outputSignal?.collateral;\n    const inputCol = resp.inputSignal?.collateral;\n\n    const ownerNeuron = outputCol\n        ? cns.network.getParentNeuronByCollateral(outputCol as any)\n        : null;\n\n    return {\n        jobId,\n        index,\n        neuronName: ownerNeuron\n            ? registry.getNeuronName(ownerNeuron as any) ?? null\n            : null,\n        inputCollateral: inputCol\n            ? registry.getCollateralName(inputCol as any) ?? null\n            : null,\n        outputCollateral: outputCol\n            ? registry.getCollateralName(outputCol as any) ?? null\n            : null,\n        inputPayload:\n            resp.inputSignal?.payload ?? resp.outputSignal?.payload ?? null,\n        outputPayload: outputCol ? resp.outputSignal?.payload ?? null : null,\n        error: resp.error != null ? String(resp.error) : null,\n        at: Date.now(),\n    };\n}\n\n/**\n * Register a pg-boss worker that turns each job into a CNStra stimulation.\n *\n * One job = one stimulation. The job carries `{ collateralName, payload }`; the\n * worker reconstructs the entry signal by name, stimulates, optionally streams\n * per-hop progress, and awaits completion. If the stimulation fails or aborts,\n * `waitUntilComplete()` rejects and the error propagates so pg-boss applies its\n * own retry/backoff policy.\n */\nexport function createCNSWorker(options: TCNSWorkerOptions): Promise<string> {\n    const { boss, cns, registry, queue, progress, workOptions } = options;\n\n    const runJob = async (\n        job: IPgBossJob<TCNSStimulationJobData>\n    ): Promise<void> => {\n        const { collateralName, payload, maxNeuronHops } = job.data;\n        const collateral = registry.getCollateral(collateralName);\n        if (!collateral) {\n            throw new Error(\n                `[@cnstra/pg-boss] Unknown collateral \"${collateralName}\". ` +\n                    `Register it in the CNSPersistOptionsRegistry.`\n            );\n        }\n\n        const startedAt = Date.now();\n        let hopCount = 0;\n\n        await progress?.onStarted?.({\n            jobId: job.id,\n            collateralName,\n            payload,\n            status: 'running',\n            startedAt,\n            hopCount: 0,\n        });\n\n        const stimulation = cns.stimulate(collateral.createSignal(payload), {\n            maxNeuronHops,\n            onResponse: async (resp: ICNSResponseLike) => {\n                const rec = toHopRecord(\n                    job.id,\n                    hopCount,\n                    resp,\n                    cns,\n                    registry\n                );\n                hopCount += 1;\n                // Returning a Promise makes CNStra wait for the durable write\n                // before enqueuing the next hop (per-hop checkpoint barrier).\n                await progress?.onHop?.(rec);\n            },\n        });\n\n        try {\n            await stimulation.waitUntilComplete();\n            await progress?.onCompleted?.({\n                jobId: job.id,\n                collateralName,\n                payload,\n                status: 'completed',\n                startedAt,\n                completedAt: Date.now(),\n                hopCount,\n            });\n        } catch (err) {\n            await progress?.onCompleted?.({\n                jobId: job.id,\n                collateralName,\n                payload,\n                status: 'failed',\n                startedAt,\n                completedAt: Date.now(),\n                hopCount,\n                error: err instanceof Error ? err.message : String(err),\n            });\n            // Let pg-boss decide about retries/backoff.\n            throw err;\n        }\n    };\n\n    const handler = async (\n        jobs: IPgBossJob<TCNSStimulationJobData>[]\n    ): Promise<void> => {\n        for (const job of jobs) {\n            await runJob(job);\n        }\n    };\n\n    return workOptions\n        ? boss.work<TCNSStimulationJobData>(queue, workOptions, handler)\n        : boss.work<TCNSStimulationJobData>(queue, handler);\n}\n","import type { CNSCollateral, CNSPersistOptionsRegistry } from '@cnstra/core';\nimport type { IPgBossLike, TCNSStimulationJobData } from './types';\n\n/** Commonly used pg-boss send options (a superset is passed through). */\nexport interface TCNSSendOptions {\n    retryLimit?: number;\n    retryBackoff?: boolean;\n    retryDelay?: number;\n    /** One in-flight job per key — e.g. one stimulation per entity id. */\n    singletonKey?: string;\n    startAfter?: number | string | Date;\n    expireInSeconds?: number;\n    priority?: number;\n    [key: string]: unknown;\n}\n\n/**\n * Build a queue job from a **registered** collateral. Throws if the collateral\n * is not in the registry, so a typo can't reach the queue.\n */\nexport function stimulationJob(\n    registry: CNSPersistOptionsRegistry,\n    collateral: CNSCollateral<unknown>,\n    payload: unknown,\n    extra?: Pick<TCNSStimulationJobData, 'maxNeuronHops'>\n): TCNSStimulationJobData {\n    const collateralName = registry.getCollateralName(collateral);\n    if (!collateralName) {\n        throw new Error(\n            '[@cnstra/pg-boss] Collateral is not registered in the ' +\n                'CNSPersistOptionsRegistry; cannot enqueue it by name.'\n        );\n    }\n    return { collateralName, payload, ...extra };\n}\n\n/** Send a stimulation job to a pg-boss queue. Returns the job id. */\nexport function enqueueStimulation(\n    boss: IPgBossLike,\n    queue: string,\n    job: TCNSStimulationJobData,\n    options?: TCNSSendOptions\n): Promise<string | null> {\n    return boss.send(queue, job as unknown as object, options);\n}\n"],"mappings":"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","names":["_a"]}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@cnstra/pg-boss",
+  "version": "0.1.0",
+  "description": "pg-boss (Postgres) integration for CNStra: run stimulations as jobs and stream per-hop progress",
+  "keywords": [
+    "cnstra",
+    "pg-boss",
+    "postgres",
+    "queue",
+    "workflow",
+    "orchestration"
+  ],
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "sideEffects": false,
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "test:types": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "peerDependencies": {
+    "@cnstra/core": "^2.4.0",
+    "pg-boss": ">=9"
+  },
+  "peerDependenciesMeta": {
+    "pg-boss": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@cnstra/core": "^2.4.0",
+    "tsup": "8.5.1",
+    "typescript": "5.7.2"
+  },
+  "author": "Andrei Baikov <abaikov23@gmail.com>",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  }
+}