@plumbus/core 0.4.2 → 0.5.0

package/dist/runtime/queue-factory.js.map

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

package/dist/runtime/register-consumers.d.ts

@@ -0,0 +1,29 @@
+import type { PostgresJsDatabase } from 'drizzle-orm/postgres-js';
+import type { ConsumerRegistry } from '../events/consumer-registry.js';
+import type { EventRegistry } from '../events/registry.js';
+import type { CapabilityRegistry } from '../execution/capability-registry.js';
+import type { createFlowEngine } from '../flows/engine.js';
+import type { EntityRegistry } from '../data/registry.js';
+import type { PlumbusConfig } from '../types/config.js';
+import type { AIService, LoggerService } from '../types/context.js';
+import type { PlumbusMetrics } from '../observability/metrics.js';
+export interface RegisterCapabilityConsumersOptions {
+    capabilities: CapabilityRegistry;
+    consumers: ConsumerRegistry;
+    events: EventRegistry;
+    entities: EntityRegistry;
+    db: PostgresJsDatabase;
+    config: PlumbusConfig;
+    flowEngine?: ReturnType<typeof createFlowEngine>;
+    aiService?: AIService;
+    logger?: LoggerService;
+    metrics?: PlumbusMetrics;
+    /** Called when MCP task rows need status sync (optional @plumbus/mcp integration). */
+    onMcpJobComplete?: (jobId: string, result: 'completed' | 'failed', payload?: unknown, error?: unknown, tenantId?: string | null) => Promise<void>;
+}
+/**
+ * Register eventHandler (with trigger.event) and job capabilities as queue consumers.
+ * Skips handlers whose consumer id is already registered manually.
+ */
+export declare function registerCapabilityConsumers(opts: RegisterCapabilityConsumersOptions): void;
+//# sourceMappingURL=register-consumers.d.ts.map

package/dist/runtime/register-consumers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-consumers.d.ts","sourceRoot":"","sources":["../../src/runtime/register-consumers.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAEvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAO3D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAG9E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAG3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAGlE,MAAM,WAAW,kCAAkC;IACjD,YAAY,EAAE,kBAAkB,CAAC;IACjC,SAAS,EAAE,gBAAgB,CAAC;IAC5B,MAAM,EAAE,aAAa,CAAC;IACtB,QAAQ,EAAE,cAAc,CAAC;IACzB,EAAE,EAAE,kBAAkB,CAAC;IACvB,MAAM,EAAE,aAAa,CAAC;IACtB,UAAU,CAAC,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;IACjD,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,sFAAsF;IACtF,gBAAgB,CAAC,EAAE,CACjB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,WAAW,GAAG,QAAQ,EAC9B,OAAO,CAAC,EAAE,OAAO,EACjB,KAAK,CAAC,EAAE,OAAO,EACf,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,KACrB,OAAO,CAAC,IAAI,CAAC,CAAC;CACpB;AA6GD;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,kCAAkC,GAAG,IAAI,CA2J1F"}

package/dist/runtime/register-consumers.js

@@ -0,0 +1,233 @@
+// ── Capability Consumer Registration ──
+// Auto-wires eventHandler and job capabilities into the ConsumerRegistry.
+import { eq } from 'drizzle-orm';
+import { createAuditService } from '../audit/service.js';
+import { createEventEmitter } from '../events/emitter.js';
+import { outboxTable } from '../events/outbox.js';
+import { TrustedReplayActor } from '../types/event.js';
+import { CapabilityKind } from '../types/enums.js';
+import { buildCapabilityRuntimeDeps } from '../execution/capability-invocation.js';
+import { executeCapability } from '../execution/capability-executor.js';
+import { evaluateAccess } from '../execution/authorization.js';
+import { createExecutionContext } from '../execution/context-factory.js';
+import { createFlowService } from '../flows/flow-service.js';
+import { createJobService, JobClaimResult } from '../jobs/service.js';
+import { jobEventType } from '../jobs/types.js';
+function eventWorkerAuth(cap, envelope, tenantId) {
+    const serviceAccount = cap.access?.serviceAccounts?.[0] ?? 'event-worker';
+    return {
+        userId: serviceAccount,
+        roles: ['system'],
+        scopes: [],
+        provider: 'event-worker',
+        tenantId: tenantId ?? envelope.tenantId,
+    };
+}
+const TRUSTED_REPLAY_ACTORS = new Set([
+    TrustedReplayActor.OpsRetry,
+    TrustedReplayActor.OutboxReplay,
+]);
+function isTrustedReplay(envelope) {
+    return TRUSTED_REPLAY_ACTORS.has(envelope.actor);
+}
+function tenantFromTrustedReplay(envelope) {
+    if (envelope.tenantId != null) {
+        return envelope.tenantId;
+    }
+    const metaTenant = envelope.metadata?.tenantId;
+    if (typeof metaTenant === 'string') {
+        return metaTenant;
+    }
+    return undefined;
+}
+async function resolveEventHandlerTenantId(db, envelope, logger) {
+    const rows = await db
+        .select({ tenantId: outboxTable.tenantId, eventType: outboxTable.eventType })
+        .from(outboxTable)
+        .where(eq(outboxTable.id, envelope.id))
+        .limit(1);
+    const row = rows[0];
+    if (!row) {
+        if (isTrustedReplay(envelope)) {
+            const tenantId = tenantFromTrustedReplay(envelope);
+            logger?.info?.('Trusted replay delivery without outbox row', {
+                eventId: envelope.id,
+                eventType: envelope.eventType,
+                actor: envelope.actor,
+                tenantId,
+            });
+            return tenantId;
+        }
+        throw new Error(`Event handler rejected: no outbox row for event "${envelope.id}" — possible forged queue message. ` +
+            'Redis is a trust boundary; replay via plumbus events replay/dead-letter retry only.');
+    }
+    if (row.eventType !== envelope.eventType) {
+        throw new Error(`Event envelope type mismatch for "${envelope.id}": queue=${envelope.eventType} outbox=${row.eventType}`);
+    }
+    if (row.tenantId != null && envelope.tenantId != null && row.tenantId !== envelope.tenantId) {
+        throw new Error(`Event envelope tenant mismatch for "${envelope.id}": queue=${envelope.tenantId} outbox=${row.tenantId}`);
+    }
+    return row.tenantId ?? envelope.tenantId;
+}
+function buildConsumerContext(opts, auth, eventMeta) {
+    const audit = createAuditService({ db: opts.db, auth });
+    const data = opts.entities.createDataService({ db: opts.db, auth, audit });
+    const eventService = createEventEmitter({
+        db: opts.db,
+        auth,
+        registry: opts.events,
+        audit,
+        correlationId: eventMeta?.correlationId,
+        causationId: eventMeta?.causationId,
+    });
+    const flows = opts.flowEngine ? createFlowService(opts.flowEngine, auth) : undefined;
+    const capRuntime = buildCapabilityRuntimeDeps(opts.capabilities);
+    return createExecutionContext({
+        auth,
+        data,
+        events: eventService,
+        flows,
+        ai: opts.aiService,
+        audit,
+        logger: opts.logger,
+        config: opts.config,
+        correlationId: eventMeta?.correlationId,
+        ...capRuntime,
+    });
+}
+/**
+ * Register eventHandler (with trigger.event) and job capabilities as queue consumers.
+ * Skips handlers whose consumer id is already registered manually.
+ */
+export function registerCapabilityConsumers(opts) {
+    const jobs = createJobService(opts.db);
+    for (const cap of opts.capabilities.getAll()) {
+        if (cap.kind === CapabilityKind.EventHandler && cap.trigger?.event) {
+            if (opts.consumers.getById(cap.name)) {
+                opts.logger?.debug?.(`Skipping auto-registration for "${cap.name}" — manual consumer exists`);
+                continue;
+            }
+            opts.consumers.register({
+                id: cap.name,
+                eventTypes: [cap.trigger.event],
+                versionConstraint: cap.trigger.versionConstraint,
+                handler: async (envelope) => {
+                    const tenantId = await resolveEventHandlerTenantId(opts.db, envelope, opts.logger);
+                    const auth = eventWorkerAuth(cap, envelope, tenantId);
+                    const authz = evaluateAccess(cap.access, auth);
+                    if (!authz.allowed) {
+                        throw new Error(authz.reason ?? 'Event handler access denied');
+                    }
+                    const parsed = cap.input.safeParse(envelope.payload);
+                    if (!parsed.success) {
+                        throw new Error(`Event payload validation failed for handler "${cap.name}"`);
+                    }
+                    const ctx = buildConsumerContext(opts, auth, {
+                        correlationId: envelope.correlationId,
+                        causationId: envelope.id,
+                    });
+                    const started = Date.now();
+                    const result = await executeCapability(cap, ctx, parsed.data);
+                    opts.metrics?.capabilityDuration.observe(Date.now() - started, {
+                        capability: cap.name,
+                        kind: 'eventHandler',
+                    });
+                    if (!result.success) {
+                        opts.metrics?.eventFailed.inc({ consumer: cap.name });
+                        throw new Error(result.error.message);
+                    }
+                    opts.metrics?.eventDelivered.inc({ consumer: cap.name });
+                },
+            });
+        }
+        if (cap.kind === CapabilityKind.Job) {
+            const eventType = jobEventType(cap.domain, cap.name);
+            const consumerId = `job:${cap.domain}:${cap.name}`;
+            if (opts.consumers.getById(consumerId)) {
+                continue;
+            }
+            opts.consumers.register({
+                id: consumerId,
+                eventTypes: [eventType],
+                handler: async (envelope) => {
+                    const payload = envelope.payload;
+                    const started = Date.now();
+                    const record = await jobs.getById(payload.jobExecutionId);
+                    if (!record) {
+                        throw new Error(`Job execution "${payload.jobExecutionId}" not found`);
+                    }
+                    if (record.capabilityDomain !== cap.domain ||
+                        record.capabilityName !== cap.name ||
+                        payload.capability.domain !== cap.domain ||
+                        payload.capability.name !== cap.name) {
+                        await jobs.markFailed(payload.jobExecutionId, {
+                            code: 'capability_mismatch',
+                            message: 'Job capability mismatch at dequeue',
+                        });
+                        throw new Error('Job capability mismatch at dequeue');
+                    }
+                    const auth = record.authSnapshotJson;
+                    if (!auth) {
+                        await jobs.markFailed(payload.jobExecutionId, {
+                            code: 'missing_auth_snapshot',
+                            message: 'Job auth snapshot missing at dequeue',
+                        });
+                        throw new Error('Job auth snapshot missing at dequeue');
+                    }
+                    const authz = evaluateAccess(cap.access, auth);
+                    if (!authz.allowed) {
+                        await jobs.markFailed(payload.jobExecutionId, {
+                            code: 'forbidden',
+                            message: authz.reason ?? 'Job access denied at dequeue',
+                        });
+                        throw new Error(authz.reason ?? 'Job access denied');
+                    }
+                    const staleAfterMs = (opts.config.queue?.visibilityTimeoutSec ?? 30) * 1000;
+                    const claimResult = await jobs.tryClaimForExecution(payload.jobExecutionId, staleAfterMs);
+                    if (claimResult === JobClaimResult.Terminal) {
+                        opts.logger?.debug?.('Job already terminal — acknowledging duplicate delivery', {
+                            jobExecutionId: payload.jobExecutionId,
+                        });
+                        return;
+                    }
+                    if (claimResult === JobClaimResult.Retry) {
+                        throw new Error(`Job "${payload.jobExecutionId}" claim failed — will retry`);
+                    }
+                    const ctx = buildConsumerContext(opts, auth, {
+                        correlationId: envelope.correlationId,
+                        causationId: envelope.id,
+                    });
+                    const jobInput = record.inputJson ?? payload.input;
+                    const parsed = cap.input.safeParse(jobInput);
+                    if (!parsed.success) {
+                        await jobs.markFailed(payload.jobExecutionId, {
+                            code: 'validation',
+                            message: 'Invalid job input at dequeue',
+                        });
+                        throw new Error('Invalid job input');
+                    }
+                    const result = await executeCapability(cap, ctx, parsed.data);
+                    opts.metrics?.capabilityDuration.observe(Date.now() - started, {
+                        capability: cap.name,
+                        kind: 'job',
+                    });
+                    if (result.success) {
+                        await jobs.markCompleted(payload.jobExecutionId, result.data);
+                        await opts.onMcpJobComplete?.(payload.jobExecutionId, 'completed', result.data, undefined, record.tenantId);
+                        opts.metrics?.eventDelivered.inc({ consumer: consumerId });
+                    }
+                    else {
+                        await jobs.markFailed(payload.jobExecutionId, {
+                            code: result.error.code,
+                            message: result.error.message,
+                        });
+                        await opts.onMcpJobComplete?.(payload.jobExecutionId, 'failed', undefined, result.error, record.tenantId);
+                        opts.metrics?.eventFailed.inc({ consumer: consumerId });
+                        throw new Error(result.error.message);
+                    }
+                },
+            });
+        }
+    }
+}
+//# sourceMappingURL=register-consumers.js.map

package/dist/runtime/register-consumers.js.map

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

package/dist/runtime/start-worker-pool.d.ts

@@ -0,0 +1,32 @@
+import type { PostgresJsDatabase } from 'drizzle-orm/postgres-js';
+import type { PromptRegistry } from '../ai/prompt-registry.js';
+import type { ConsumerRegistry } from '../events/consumer-registry.js';
+import type { EventRegistry } from '../events/registry.js';
+import type { FlowRegistry } from '../flows/registry.js';
+import type { CapabilityRegistry } from '../execution/capability-registry.js';
+import type { EntityRegistry } from '../data/registry.js';
+import type { PlumbusConfig } from '../types/config.js';
+import type { WorkerPool } from '../worker/bootstrap.js';
+import { type ServerExtensions } from './bootstrap.js';
+import type { PlumbusMetrics } from '../observability/metrics.js';
+import type { RuntimeQueues } from './queue-factory.js';
+export interface StartWorkerPoolOptions {
+    config: PlumbusConfig;
+    db: PostgresJsDatabase;
+    queues: RuntimeQueues;
+    capabilities: CapabilityRegistry;
+    entities: EntityRegistry;
+    events: EventRegistry;
+    flows: FlowRegistry;
+    consumers: ConsumerRegistry;
+    promptRegistry?: PromptRegistry;
+    extensions?: ServerExtensions;
+    logger?: import('../types/context.js').LoggerService;
+    metrics?: PlumbusMetrics;
+}
+/**
+ * Register capability consumers and start the worker pool.
+ * Used by plumbus dev, start (role=all), and plumbus worker.
+ */
+export declare function startWorkerPool(options: StartWorkerPoolOptions): Promise<WorkerPool>;
+//# sourceMappingURL=start-worker-pool.d.ts.map

package/dist/runtime/start-worker-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-worker-pool.d.ts","sourceRoot":"","sources":["../../src/runtime/start-worker-pool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAC9E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEzD,OAAO,EAAuC,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAC5F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,aAAa,CAAC;IACtB,EAAE,EAAE,kBAAkB,CAAC;IACvB,MAAM,EAAE,aAAa,CAAC;IACtB,YAAY,EAAE,kBAAkB,CAAC;IACjC,QAAQ,EAAE,cAAc,CAAC;IACzB,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,EAAE,YAAY,CAAC;IACpB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,MAAM,CAAC,EAAE,OAAO,qBAAqB,EAAE,aAAa,CAAC;IACrD,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,UAAU,CAAC,CAyG1F"}

package/dist/runtime/start-worker-pool.js

@@ -0,0 +1,91 @@
+import { createAuditService } from '../audit/service.js';
+import { enqueueFlowStep } from '../flows/flow-queue.js';
+import { createWorkerPool } from '../worker/bootstrap.js';
+import { buildStepDeps, buildWorkerAiService } from './bootstrap.js';
+/**
+ * Register capability consumers and start the worker pool.
+ * Used by plumbus dev, start (role=all), and plumbus worker.
+ */
+export async function startWorkerPool(options) {
+    const { config, db, queues, capabilities, entities, events, flows, consumers, promptRegistry, extensions, logger, metrics, } = options;
+    const stepDeps = buildStepDeps(capabilities);
+    const systemAuth = {
+        userId: 'system-worker',
+        roles: ['system'],
+        scopes: [],
+        provider: 'worker',
+    };
+    let onMcpJobComplete;
+    try {
+        const mcp = await import('@plumbus/mcp');
+        const audit = createAuditService({ db, auth: systemAuth });
+        const data = entities.createDataService({ db, auth: systemAuth, audit });
+        onMcpJobComplete = mcp.createMcpJobCompletionSync({
+            auth: systemAuth,
+            data,
+            audit,
+            logger,
+            config: config,
+        });
+    }
+    catch {
+        /* @plumbus/mcp not installed */
+    }
+    const aiService = buildWorkerAiService({
+        config,
+        db,
+        promptRegistry,
+        onAICostRecorded: extensions?.onAICostRecorded,
+        resolveAiOverrides: extensions?.resolveAiOverrides,
+        enableStrictStructuredOutputs: extensions?.enableStrictStructuredOutputs,
+    });
+    const pool = createWorkerPool({
+        config,
+        db,
+        queue: queues.events,
+        jobsQueue: queues.jobs,
+        flowsQueue: queues.flows,
+        queuesDurable: queues.isDurable,
+        redisClient: queues.redisClient,
+        flowsPrefix: queues.flowsPrefix,
+        refreshQueueDepths: metrics && queues.getDepths
+            ? async () => {
+                const depths = await queues.getDepths?.();
+                if (!depths)
+                    return;
+                metrics.queueDepth.set(depths.events, { queue: 'events' });
+                metrics.queueDepth.set(depths.flows, { queue: 'flows' });
+                metrics.queueDepth.set(depths.jobs, { queue: 'jobs' });
+            }
+            : undefined,
+        onQueuesClose: () => queues.close(),
+        consumers,
+        flows,
+        stepDeps,
+        aiService,
+        createDataService: (auth) => {
+            const effectiveAuth = auth ?? {
+                userId: 'system-flow-runner',
+                roles: ['system'],
+                scopes: [],
+                provider: 'worker',
+            };
+            return entities.createDataService({
+                db,
+                auth: effectiveAuth,
+                bypassTenantScope: false,
+            });
+        },
+        eventRegistry: events,
+        onFlowError: extensions?.onFlowError,
+        logger,
+        metrics,
+        onFlowStepEnqueue: (executionId, correlationId) => enqueueFlowStep(queues.flows, executionId, correlationId),
+        capabilities,
+        entities,
+        onMcpJobComplete,
+    });
+    await pool.start();
+    return pool;
+}
+//# sourceMappingURL=start-worker-pool.js.map

package/dist/runtime/start-worker-pool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-worker-pool.js","sourceRoot":"","sources":["../../src/runtime/start-worker-pool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAKzD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAMzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAyB,MAAM,gBAAgB,CAAC;AAmB5F;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAA+B;IACnE,MAAM,EACJ,MAAM,EACN,EAAE,EACF,MAAM,EACN,YAAY,EACZ,QAAQ,EACR,MAAM,EACN,KAAK,EACL,SAAS,EACT,cAAc,EACd,UAAU,EACV,MAAM,EACN,OAAO,GACR,GAAG,OAAO,CAAC;IAEZ,MAAM,QAAQ,GAAG,aAAa,CAAC,YAAY,CAAC,CAAC;IAC7C,MAAM,UAAU,GAAG;QACjB,MAAM,EAAE,eAAe;QACvB,KAAK,EAAE,CAAC,QAAQ,CAAa;QAC7B,MAAM,EAAE,EAAc;QACtB,QAAQ,EAAE,QAAQ;KACnB,CAAC;IACF,IAAI,gBAOS,CAAC;IACd,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,CAAC;QACzC,MAAM,KAAK,GAAG,kBAAkB,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;QAC3D,MAAM,IAAI,GAAG,QAAQ,CAAC,iBAAiB,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;QACzE,gBAAgB,GAAG,GAAG,CAAC,0BAA0B,CAAC;YAChD,IAAI,EAAE,UAAU;YAChB,IAAI;YACJ,KAAK;YACL,MAAM;YACN,MAAM,EAAE,MAA4C;SACrD,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,gCAAgC;IAClC,CAAC;IAED,MAAM,SAAS,GAAG,oBAAoB,CAAC;QACrC,MAAM;QACN,EAAE;QACF,cAAc;QACd,gBAAgB,EAAE,UAAU,EAAE,gBAAgB;QAC9C,kBAAkB,EAAE,UAAU,EAAE,kBAAkB;QAClD,6BAA6B,EAAE,UAAU,EAAE,6BAA6B;KACzE,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,gBAAgB,CAAC;QAC5B,MAAM;QACN,EAAE;QACF,KAAK,EAAE,MAAM,CAAC,MAAM;QACpB,SAAS,EAAE,MAAM,CAAC,IAAI;QACtB,UAAU,EAAE,MAAM,CAAC,KAAK;QACxB,aAAa,EAAE,MAAM,CAAC,SAAS;QAC/B,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,kBAAkB,EAChB,OAAO,IAAI,MAAM,CAAC,SAAS;YACzB,CAAC,CAAC,KAAK,IAAI,EAAE;gBACT,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,SAAS,EAAE,EAAE,CAAC;gBAC1C,IAAI,CAAC,MAAM;oBAAE,OAAO;gBACpB,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;gBAC3D,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;gBACzD,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;YACzD,CAAC;YACH,CAAC,CAAC,SAAS;QACf,aAAa,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE;QACnC,SAAS;QACT,KAAK;QACL,QAAQ;QACR,SAAS;QACT,iBAAiB,EAAE,CAAC,IAAI,EAAE,EAAE;YAC1B,MAAM,aAAa,GAAG,IAAI,IAAI;gBAC5B,MAAM,EAAE,oBAAoB;gBAC5B,KAAK,EAAE,CAAC,QAAQ,CAAC;gBACjB,MAAM,EAAE,EAAE;gBACV,QAAQ,EAAE,QAAQ;aACnB,CAAC;YACF,OAAO,QAAQ,CAAC,iBAAiB,CAAC;gBAChC,EAAE;gBACF,IAAI,EAAE,aAAa;gBACnB,iBAAiB,EAAE,KAAK;aACzB,CAAC,CAAC;QACL,CAAC;QACD,aAAa,EAAE,MAAM;QACrB,WAAW,EAAE,UAAU,EAAE,WAAW;QACpC,MAAM;QACN,OAAO;QACP,iBAAiB,EAAE,CAAC,WAAW,EAAE,aAAa,EAAE,EAAE,CAChD,eAAe,CAAC,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,aAAa,CAAC;QAC3D,YAAY;QACZ,QAAQ;QACR,gBAAgB;KACjB,CAAC,CAAC;IAEH,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;IACnB,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/runtime/worker-health.d.ts

@@ -0,0 +1,19 @@
+import type { PostgresJsDatabase } from 'drizzle-orm/postgres-js';
+import { createPlumbusMetrics } from '../observability/metrics.js';
+import type { RuntimeQueues } from './queue-factory.js';
+import type { WorkerPool } from '../worker/bootstrap.js';
+export interface WorkerHealthServerConfig {
+    port: number;
+    host?: string;
+    db: PostgresJsDatabase;
+    queues?: RuntimeQueues;
+    workerPool?: WorkerPool;
+    metrics?: ReturnType<typeof createPlumbusMetrics>;
+}
+export interface WorkerHealthServer {
+    start(): Promise<string>;
+    stop(): Promise<void>;
+    metrics: ReturnType<typeof createPlumbusMetrics>;
+}
+export declare function createWorkerHealthServer(config: WorkerHealthServerConfig): WorkerHealthServer;
+//# sourceMappingURL=worker-health.d.ts.map

package/dist/runtime/worker-health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-health.d.ts","sourceRoot":"","sources":["../../src/runtime/worker-health.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEzD,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,kBAAkB,CAAC;IACvB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,OAAO,CAAC,EAAE,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC;CACnD;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACzB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,OAAO,EAAE,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC;CAClD;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,wBAAwB,GAAG,kBAAkB,CAqC7F"}

package/dist/runtime/worker-health.js

@@ -0,0 +1,41 @@
+// ── Worker Health / Metrics Server ──
+// Lightweight HTTP endpoints for split worker processes.
+import Fastify from 'fastify';
+import { sql } from 'drizzle-orm';
+import { createPlumbusMetrics } from '../observability/metrics.js';
+export function createWorkerHealthServer(config) {
+    const app = Fastify({ logger: false });
+    const metrics = config.metrics ?? createPlumbusMetrics();
+    const host = config.host ?? '0.0.0.0';
+    app.get('/health', async () => ({ status: 'ok' }));
+    app.get('/ready', async (_req, reply) => {
+        try {
+            await config.db.execute(sql `SELECT 1`);
+            if (config.queues?.isDurable && config.queues.pingRedis) {
+                await config.queues.pingRedis();
+            }
+            return { status: 'ready' };
+        }
+        catch (err) {
+            reply.status(503);
+            return {
+                status: 'not_ready',
+                error: err instanceof Error ? err.message : String(err),
+            };
+        }
+    });
+    app.get('/metrics', async () => {
+        return metrics.registry.serialize();
+    });
+    return {
+        metrics,
+        async start() {
+            const address = await app.listen({ port: config.port, host });
+            return typeof address === 'string' ? address : `http://${host}:${config.port}`;
+        },
+        async stop() {
+            await app.close();
+        },
+    };
+}
+//# sourceMappingURL=worker-health.js.map

package/dist/runtime/worker-health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-health.js","sourceRoot":"","sources":["../../src/runtime/worker-health.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,yDAAyD;AAEzD,OAAO,OAAO,MAAM,SAAS,CAAC;AAE9B,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAmBnE,MAAM,UAAU,wBAAwB,CAAC,MAAgC;IACvE,MAAM,GAAG,GAAG,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,oBAAoB,EAAE,CAAC;IACzD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,SAAS,CAAC;IAEtC,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAEnD,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QACtC,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAA,UAAU,CAAC,CAAC;YACvC,IAAI,MAAM,CAAC,MAAM,EAAE,SAAS,IAAI,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;gBACxD,MAAM,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;YAClC,CAAC;YACD,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;QAC7B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAClB,OAAO;gBACL,MAAM,EAAE,WAAW;gBACnB,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aACxD,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,GAAG,CAAC,UAAU,EAAE,KAAK,IAAI,EAAE;QAC7B,OAAO,OAAO,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,OAAO;QACP,KAAK,CAAC,KAAK;YACT,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YAC9D,OAAO,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,IAAI,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QACjF,CAAC;QACD,KAAK,CAAC,IAAI;YACR,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC;QACpB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/server/bootstrap.d.ts

@@ -4,6 +4,7 @@ import type { AICostRecord } from '../ai/cost-tracker.js';
 import type { AICostContext } from '../types/context.js';
 import type { PromptRegistry } from '../ai/prompt-registry.js';
 import type { RouteGeneratorConfig } from '../api/route-generator.js';
+import type { EventQueue } from '../events/queue.js';
 import type { AuthAdapter } from '../auth/adapter.js';
 import type { EntityRegistry } from '../data/registry.js';
 import type { ConsumerRegistry } from '../events/consumer-registry.js';
@@ -13,6 +14,7 @@ import type { FlowRegistry } from '../flows/registry.js';
 import type { PlumbusConfig } from '../types/config.js';
 import type { AIService, LoggerService } from '../types/context.js';
 import type { TranslationDefinition } from '../types/translation.js';
+import type { PlumbusMetrics } from '../observability/metrics.js';
 export interface ServerConfig {
     /** Plumbus framework config */
     config: PlumbusConfig;
@@ -38,6 +40,10 @@ export interface ServerConfig {
     port?: number;
     /** Trust proxy for X-Forwarded-For / X-Forwarded-Proto headers. Passed to Fastify's trustProxy option. */
     trustProxy?: boolean | string | string[] | number;
+    /** Jobs queue for async kind: 'job' capabilities (when API wires jobQueue). */
+    jobQueue?: EventQueue;
+    /** Expose Prometheus metrics at GET /metrics (colocated role=all deployments). */
+    metrics?: PlumbusMetrics;
     /** Called after all capability routes are registered. Use to add custom routes (e.g. streaming). */
     onRoutesRegistered?: (app: FastifyInstance, routeConfig: RouteGeneratorConfig) => void;
     /**

package/dist/server/bootstrap.d.ts.map

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

package/dist/server/bootstrap.js

@@ -7,11 +7,14 @@ import { createAIService, singleProviderConfig } from '../ai/ai-service.js';
 import { createCostTracker } from '../ai/cost-tracker.js';
 import { createProviderAdapter } from '../ai/provider.js';
 import { registerAllRoutes } from '../api/route-generator.js';
+import { registerJobStatusRoute } from '../jobs/routes.js';
 import { createAuditService } from '../audit/service.js';
 import { GENERIC_INTERNAL_MESSAGE } from '../errors/http.js';
 import { logHookError } from '../errors/hook-log.js';
 import { createJwtAdapter } from '../auth/adapter.js';
 import { createEventEmitter } from '../events/emitter.js';
+import { buildCapabilityRuntimeDeps } from '../execution/capability-invocation.js';
+import { createInvocationEmitScope, resolveInvocationCausationId, } from '../execution/invocation-emit-scope.js';
 import { createFlowEngine } from '../flows/engine.js';
 import { createFlowService } from '../flows/flow-service.js';
 import { createTranslationService, TranslationRegistry } from '../translations/index.js';
@@ -64,6 +67,9 @@ export function createServer(serverConfig) {
             return { status: 'not_ready', reason: 'database unavailable' };
         }
     });
+    if (serverConfig.metrics) {
+        app.get('/metrics', async () => serverConfig.metrics?.registry.serialize());
+    }
     // AI service wiring
     let aiService;
     // Adapt the consumer-facing `onAICostRecorded(record, ctx, db)` into the
@@ -143,7 +149,14 @@ export function createServer(serverConfig) {
                 audit,
                 bypassTenantScope: options?.bypassTenantScope,
             });
-            const eventService = createEventEmitter({ db, auth, registry: events, audit });
+            const invocationEmitScope = createInvocationEmitScope();
+            const eventService = createEventEmitter({
+                db,
+                auth,
+                registry: events,
+                audit,
+                getCausationId: () => resolveInvocationCausationId(invocationEmitScope),
+            });
             return {
                 auth,
                 data,
@@ -154,12 +167,16 @@ export function createServer(serverConfig) {
                 logger,
                 config: config,
                 translations: createTranslationService(translationRegistry, defaultLocale),
+                invocationEmitScope,
+                ...buildCapabilityRuntimeDeps(capabilities),
             };
         },
         onCapabilityError: serverConfig.onCapabilityError,
+        jobQueue: serverConfig.jobQueue,
     };
     // Register all capability routes
     registerAllRoutes(app, capabilities.getAll(), routeConfig);
+    registerJobStatusRoute(app, { db, authAdapter });
     // Fastify-level error handler — catches malformed requests, timeouts, uncaught route errors
     if (serverConfig.onProcessError) {
         const processErrorHook = serverConfig.onProcessError;