@plumbus/core 0.4.2 → 0.6.0

package/dist/jobs/dispatch.d.ts

@@ -0,0 +1,18 @@
+import type { PostgresJsDatabase } from 'drizzle-orm/postgres-js';
+import type { CapabilityContract } from '../types/capability.js';
+import type { EventQueue } from '../events/queue.js';
+import type { AuthContext } from '../types/security.js';
+import { JobExecutionSource } from './schema.js';
+export interface DispatchJobOptions {
+    db: PostgresJsDatabase;
+    jobQueue: EventQueue;
+    capability: CapabilityContract;
+    input: Record<string, unknown>;
+    auth: AuthContext;
+    jobId?: string;
+    source?: (typeof JobExecutionSource)[keyof typeof JobExecutionSource];
+    correlationId?: string;
+}
+/** Create job_executions row and publish to the jobs queue. */
+export declare function dispatchQueuedJob(options: DispatchJobOptions): Promise<string>;
+//# sourceMappingURL=dispatch.d.ts.map

package/dist/jobs/dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../../src/jobs/dispatch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAGjD,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,kBAAkB,CAAC;IACvB,QAAQ,EAAE,UAAU,CAAC;IACrB,UAAU,EAAE,kBAAkB,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAC;IACtE,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,+DAA+D;AAC/D,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAyDpF"}

package/dist/jobs/dispatch.js

@@ -0,0 +1,50 @@
+import { evaluateAccess } from '../execution/authorization.js';
+import { createJobService } from './service.js';
+import { JobExecutionSource } from './schema.js';
+import { jobEventType } from './types.js';
+/** Create job_executions row and publish to the jobs queue. */
+export async function dispatchQueuedJob(options) {
+    const { db, jobQueue, capability, input, auth, jobId = crypto.randomUUID(), source = JobExecutionSource.Http, correlationId, } = options;
+    if (capability.kind !== 'job') {
+        throw new Error(`Capability "${capability.name}" is not kind job`);
+    }
+    const authz = evaluateAccess(capability.access, auth);
+    if (!authz.allowed) {
+        throw new Error(authz.reason ?? 'Job access denied at enqueue');
+    }
+    const jobs = createJobService(db);
+    await jobs.create({
+        id: jobId,
+        capabilityDomain: capability.domain,
+        capabilityName: capability.name,
+        input,
+        auth,
+        correlationId: correlationId ?? jobId,
+        source,
+    });
+    const payload = {
+        input,
+        capability: { domain: capability.domain, name: capability.name },
+        jobExecutionId: jobId,
+        source,
+    };
+    try {
+        await jobQueue.publish({
+            id: jobId,
+            eventType: jobEventType(capability.domain, capability.name),
+            version: '1',
+            occurredAt: new Date(),
+            actor: auth.userId ?? 'anonymous',
+            tenantId: auth.tenantId,
+            correlationId: correlationId ?? jobId,
+            payload,
+        });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        await jobs.markPublishFailed(jobId, { code: 'queue_publish_failed', message });
+        throw err;
+    }
+    return jobId;
+}
+//# sourceMappingURL=dispatch.js.map

package/dist/jobs/dispatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.js","sourceRoot":"","sources":["../../src/jobs/dispatch.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAI/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,YAAY,EAAwB,MAAM,YAAY,CAAC;AAahE,+DAA+D;AAC/D,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAA2B;IACjE,MAAM,EACJ,EAAE,EACF,QAAQ,EACR,UAAU,EACV,KAAK,EACL,IAAI,EACJ,KAAK,GAAG,MAAM,CAAC,UAAU,EAAE,EAC3B,MAAM,GAAG,kBAAkB,CAAC,IAAI,EAChC,aAAa,GACd,GAAG,OAAO,CAAC;IAEZ,IAAI,UAAU,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,eAAe,UAAU,CAAC,IAAI,mBAAmB,CAAC,CAAC;IACrE,CAAC;IAED,MAAM,KAAK,GAAG,cAAc,CAAC,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACtD,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,IAAI,8BAA8B,CAAC,CAAC;IAClE,CAAC;IAED,MAAM,IAAI,GAAG,gBAAgB,CAAC,EAAE,CAAC,CAAC;IAClC,MAAM,IAAI,CAAC,MAAM,CAAC;QAChB,EAAE,EAAE,KAAK;QACT,gBAAgB,EAAE,UAAU,CAAC,MAAM;QACnC,cAAc,EAAE,UAAU,CAAC,IAAI;QAC/B,KAAK;QACL,IAAI;QACJ,aAAa,EAAE,aAAa,IAAI,KAAK;QACrC,MAAM;KACP,CAAC,CAAC;IAEH,MAAM,OAAO,GAAoB;QAC/B,KAAK;QACL,UAAU,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE;QAChE,cAAc,EAAE,KAAK;QACrB,MAAM;KACP,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,QAAQ,CAAC,OAAO,CAAC;YACrB,EAAE,EAAE,KAAK;YACT,SAAS,EAAE,YAAY,CAAC,UAAU,CAAC,MAAM,EAAE,UAAU,CAAC,IAAI,CAAC;YAC3D,OAAO,EAAE,GAAG;YACZ,UAAU,EAAE,IAAI,IAAI,EAAE;YACtB,KAAK,EAAE,IAAI,CAAC,MAAM,IAAI,WAAW;YACjC,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,aAAa,EAAE,aAAa,IAAI,KAAK;YACrC,OAAO;SACR,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,MAAM,IAAI,CAAC,iBAAiB,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,sBAAsB,EAAE,OAAO,EAAE,CAAC,CAAC;QAC/E,MAAM,GAAG,CAAC;IACZ,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/jobs/index.d.ts

@@ -0,0 +1,9 @@
+export { dispatchQueuedJob } from './dispatch.js';
+export type { DispatchJobOptions } from './dispatch.js';
+export { createJobService } from './service.js';
+export type { CreateJobExecutionInput, JobService } from './service.js';
+export { jobExecutionsTable, JobExecutionSource, JobExecutionStatus, } from './schema.js';
+export { jobEventType } from './types.js';
+export type { JobExecutionRecord, JobQueuePayload } from './types.js';
+export { registerJobStatusRoute } from './routes.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/jobs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/jobs/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,YAAY,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,YAAY,EAAE,uBAAuB,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACxE,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,YAAY,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC"}

package/dist/jobs/index.js

@@ -0,0 +1,8 @@
+// ── Jobs Module ──
+// Async capability job persistence and queue envelope types.
+export { dispatchQueuedJob } from './dispatch.js';
+export { createJobService } from './service.js';
+export { jobExecutionsTable, JobExecutionSource, JobExecutionStatus, } from './schema.js';
+export { jobEventType } from './types.js';
+export { registerJobStatusRoute } from './routes.js';
+//# sourceMappingURL=index.js.map

package/dist/jobs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/jobs/index.ts"],"names":[],"mappings":"AAAA,oBAAoB;AACpB,6DAA6D;AAE7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAElD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC"}

package/dist/jobs/routes.d.ts

@@ -0,0 +1,10 @@
+import type { PostgresJsDatabase } from 'drizzle-orm/postgres-js';
+import type { FastifyInstance } from 'fastify';
+import type { AuthAdapter } from '../auth/adapter.js';
+export interface JobStatusRouteConfig {
+    db: PostgresJsDatabase;
+    authAdapter: AuthAdapter;
+}
+/** Register GET /api/jobs/:jobId — additive job status endpoint. */
+export declare function registerJobStatusRoute(app: FastifyInstance, config: JobStatusRouteConfig): void;
+//# sourceMappingURL=routes.d.ts.map

package/dist/jobs/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/jobs/routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtD,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,kBAAkB,CAAC;IACvB,WAAW,EAAE,WAAW,CAAC;CAC1B;AAED,oEAAoE;AACpE,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,eAAe,EAAE,MAAM,EAAE,oBAAoB,GAAG,IAAI,CA6C/F"}

package/dist/jobs/routes.js

@@ -0,0 +1,44 @@
+import { createJobService } from './service.js';
+/** Register GET /api/jobs/:jobId — additive job status endpoint. */
+export function registerJobStatusRoute(app, config) {
+    const jobs = createJobService(config.db);
+    app.get('/api/jobs/:jobId', async (request, reply) => {
+        const authHeader = request.headers.authorization;
+        const auth = await config.authAdapter.authenticate(authHeader);
+        if (!auth?.userId) {
+            reply.status(401);
+            return { error: { code: 'unauthorized', message: 'Authentication required' } };
+        }
+        const { jobId } = request.params;
+        const record = await jobs.getById(jobId);
+        if (!record) {
+            reply.status(404);
+            return { error: { code: 'not_found', message: 'Job not found' } };
+        }
+        const isOwner = record.authSnapshotJson?.userId === auth.userId;
+        const isAdmin = auth.roles.includes('admin') || auth.roles.includes('system');
+        const tenantMatch = !record.tenantId || !auth.tenantId || record.tenantId === auth.tenantId;
+        if (!isOwner && !isAdmin) {
+            reply.status(403);
+            return { error: { code: 'forbidden', message: 'Access denied' } };
+        }
+        if (!tenantMatch && !isAdmin) {
+            reply.status(403);
+            return { error: { code: 'forbidden', message: 'Tenant mismatch' } };
+        }
+        return {
+            data: {
+                jobId: record.id,
+                status: record.status,
+                capability: { domain: record.capabilityDomain, name: record.capabilityName },
+                source: record.source,
+                createdAt: record.createdAt.toISOString(),
+                startedAt: record.startedAt?.toISOString() ?? null,
+                completedAt: record.completedAt?.toISOString() ?? null,
+                output: record.outputJson ?? null,
+                error: record.errorJson ?? null,
+            },
+        };
+    });
+}
+//# sourceMappingURL=routes.js.map

package/dist/jobs/routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.js","sourceRoot":"","sources":["../../src/jobs/routes.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAOhD,oEAAoE;AACpE,MAAM,UAAU,sBAAsB,CAAC,GAAoB,EAAE,MAA4B;IACvF,MAAM,IAAI,GAAG,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAEzC,GAAG,CAAC,GAAG,CAAC,kBAAkB,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;QACnD,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC;QACjD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;QAC/D,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;YAClB,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAClB,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,yBAAyB,EAAE,EAAE,CAAC;QACjF,CAAC;QAED,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,MAA2B,CAAC;QACtD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACzC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAClB,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,eAAe,EAAE,EAAE,CAAC;QACpE,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,CAAC,gBAAgB,EAAE,MAAM,KAAK,IAAI,CAAC,MAAM,CAAC;QAChE,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC9E,MAAM,WAAW,GAAG,CAAC,MAAM,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,KAAK,IAAI,CAAC,QAAQ,CAAC;QAE5F,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;YACzB,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAClB,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,eAAe,EAAE,EAAE,CAAC;QACpE,CAAC;QACD,IAAI,CAAC,WAAW,IAAI,CAAC,OAAO,EAAE,CAAC;YAC7B,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAClB,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,iBAAiB,EAAE,EAAE,CAAC;QACtE,CAAC;QAED,OAAO;YACL,IAAI,EAAE;gBACJ,KAAK,EAAE,MAAM,CAAC,EAAE;gBAChB,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,UAAU,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,gBAAgB,EAAE,IAAI,EAAE,MAAM,CAAC,cAAc,EAAE;gBAC5E,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,WAAW,EAAE;gBACzC,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,WAAW,EAAE,IAAI,IAAI;gBAClD,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,WAAW,EAAE,IAAI,IAAI;gBACtD,MAAM,EAAE,MAAM,CAAC,UAAU,IAAI,IAAI;gBACjC,KAAK,EAAE,MAAM,CAAC,SAAS,IAAI,IAAI;aAChC;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/jobs/schema.d.ts

@@ -0,0 +1,264 @@
+export declare const JobExecutionStatus: {
+    readonly Queued: "queued";
+    readonly Running: "running";
+    readonly Completed: "completed";
+    readonly Failed: "failed";
+    readonly DeadLettered: "dead_lettered";
+};
+export type JobExecutionStatus = (typeof JobExecutionStatus)[keyof typeof JobExecutionStatus];
+export declare const JobExecutionSource: {
+    readonly Http: "http";
+    readonly Mcp: "mcp";
+    readonly Flow: "flow";
+    readonly Schedule: "schedule";
+};
+export type JobExecutionSource = (typeof JobExecutionSource)[keyof typeof JobExecutionSource];
+/**
+ * Framework job_executions table — tracks async capability job lifecycle.
+ */
+export declare const jobExecutionsTable: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "job_executions";
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/pg-core").PgColumn<{
+            name: "id";
+            tableName: "job_executions";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        capabilityDomain: import("drizzle-orm/pg-core").PgColumn<{
+            name: "capability_domain";
+            tableName: "job_executions";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        capabilityName: import("drizzle-orm/pg-core").PgColumn<{
+            name: "capability_name";
+            tableName: "job_executions";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        status: import("drizzle-orm/pg-core").PgColumn<{
+            name: "status";
+            tableName: "job_executions";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        inputJson: import("drizzle-orm/pg-core").PgColumn<{
+            name: "input_json";
+            tableName: "job_executions";
+            dataType: "json";
+            columnType: "PgJsonb";
+            data: unknown;
+            driverParam: unknown;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        outputJson: import("drizzle-orm/pg-core").PgColumn<{
+            name: "output_json";
+            tableName: "job_executions";
+            dataType: "json";
+            columnType: "PgJsonb";
+            data: unknown;
+            driverParam: unknown;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        errorJson: import("drizzle-orm/pg-core").PgColumn<{
+            name: "error_json";
+            tableName: "job_executions";
+            dataType: "json";
+            columnType: "PgJsonb";
+            data: unknown;
+            driverParam: unknown;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        authSnapshotJson: import("drizzle-orm/pg-core").PgColumn<{
+            name: "auth_snapshot_json";
+            tableName: "job_executions";
+            dataType: "json";
+            columnType: "PgJsonb";
+            data: unknown;
+            driverParam: unknown;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        tenantId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "tenant_id";
+            tableName: "job_executions";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        correlationId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "correlation_id";
+            tableName: "job_executions";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        source: import("drizzle-orm/pg-core").PgColumn<{
+            name: "source";
+            tableName: "job_executions";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        createdAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "created_at";
+            tableName: "job_executions";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        startedAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "started_at";
+            tableName: "job_executions";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        completedAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "completed_at";
+            tableName: "job_executions";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: "pg";
+}>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/jobs/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/jobs/schema.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,kBAAkB;;;;;;CAMrB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAC;AAE9F,eAAO,MAAM,kBAAkB;;;;;CAKrB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAC;AAE9F;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAe7B,CAAC"}

package/dist/jobs/schema.js

@@ -0,0 +1,34 @@
+import { jsonb, pgTable, text, timestamp, uuid } from 'drizzle-orm/pg-core';
+export const JobExecutionStatus = {
+    Queued: 'queued',
+    Running: 'running',
+    Completed: 'completed',
+    Failed: 'failed',
+    DeadLettered: 'dead_lettered',
+};
+export const JobExecutionSource = {
+    Http: 'http',
+    Mcp: 'mcp',
+    Flow: 'flow',
+    Schedule: 'schedule',
+};
+/**
+ * Framework job_executions table — tracks async capability job lifecycle.
+ */
+export const jobExecutionsTable = pgTable('job_executions', {
+    id: uuid('id').primaryKey(),
+    capabilityDomain: text('capability_domain').notNull(),
+    capabilityName: text('capability_name').notNull(),
+    status: text('status').notNull().default(JobExecutionStatus.Queued),
+    inputJson: jsonb('input_json'),
+    outputJson: jsonb('output_json'),
+    errorJson: jsonb('error_json'),
+    authSnapshotJson: jsonb('auth_snapshot_json'),
+    tenantId: text('tenant_id'),
+    correlationId: text('correlation_id'),
+    source: text('source').notNull().default(JobExecutionSource.Http),
+    createdAt: timestamp('created_at', { withTimezone: true }).defaultNow().notNull(),
+    startedAt: timestamp('started_at', { withTimezone: true }),
+    completedAt: timestamp('completed_at', { withTimezone: true }),
+});
+//# sourceMappingURL=schema.js.map

package/dist/jobs/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/jobs/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAE5E,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,WAAW;IACtB,MAAM,EAAE,QAAQ;IAChB,YAAY,EAAE,eAAe;CACrB,CAAC;AAIX,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,IAAI,EAAE,MAAM;IACZ,GAAG,EAAE,KAAK;IACV,IAAI,EAAE,MAAM;IACZ,QAAQ,EAAE,UAAU;CACZ,CAAC;AAIX;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,OAAO,CAAC,gBAAgB,EAAE;IAC1D,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE;IAC3B,gBAAgB,EAAE,IAAI,CAAC,mBAAmB,CAAC,CAAC,OAAO,EAAE;IACrD,cAAc,EAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC,OAAO,EAAE;IACjD,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,kBAAkB,CAAC,MAAM,CAAC;IACnE,SAAS,EAAE,KAAK,CAAC,YAAY,CAAC;IAC9B,UAAU,EAAE,KAAK,CAAC,aAAa,CAAC;IAChC,SAAS,EAAE,KAAK,CAAC,YAAY,CAAC;IAC9B,gBAAgB,EAAE,KAAK,CAAC,oBAAoB,CAAC;IAC7C,QAAQ,EAAE,IAAI,CAAC,WAAW,CAAC;IAC3B,aAAa,EAAE,IAAI,CAAC,gBAAgB,CAAC;IACrC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,kBAAkB,CAAC,IAAI,CAAC;IACjE,SAAS,EAAE,SAAS,CAAC,YAAY,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC,OAAO,EAAE;IACjF,SAAS,EAAE,SAAS,CAAC,YAAY,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;IAC1D,WAAW,EAAE,SAAS,CAAC,cAAc,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;CAC/D,CAAC,CAAC"}

package/dist/jobs/service.d.ts

@@ -0,0 +1,52 @@
+import type { PostgresJsDatabase } from 'drizzle-orm/postgres-js';
+import type { AuthContext } from '../types/security.js';
+import { type JobExecutionSource as JobSource } from './schema.js';
+import type { JobExecutionRecord } from './types.js';
+export interface CreateJobExecutionInput {
+    id: string;
+    capabilityDomain: string;
+    capabilityName: string;
+    input: Record<string, unknown>;
+    auth: AuthContext;
+    correlationId?: string;
+    source?: JobSource;
+}
+export declare function createJobService(db: PostgresJsDatabase): {
+    create(input: CreateJobExecutionInput): Promise<JobExecutionRecord>;
+    getById(id: string): Promise<JobExecutionRecord | undefined>;
+    /**
+     * Atomically transition queued → running. Returns true when this worker won the claim.
+     */
+    markRunning(id: string): Promise<boolean>;
+    /**
+     * Reclaim a stale running job after worker crash (visibility timeout exceeded).
+     * Returns true when this worker won the reclaim.
+     */
+    reclaimStaleRunning(id: string, staleAfterMs: number): Promise<boolean>;
+    /**
+     * Atomically claim a job for execution, or decide whether to ack or retry delivery.
+     */
+    tryClaimForExecution(id: string, staleAfterMs: number): Promise<JobClaimResult>;
+    markPublishFailed(id: string, error: {
+        code: string;
+        message: string;
+    }): Promise<void>;
+    deleteQueued(id: string): Promise<boolean>;
+    markCompleted(id: string, output: unknown): Promise<void>;
+    markFailed(id: string, error: {
+        code: string;
+        message: string;
+    }): Promise<void>;
+    markDeadLettered(id: string, error: {
+        code: string;
+        message: string;
+    }): Promise<void>;
+};
+export declare const JobClaimResult: {
+    readonly Claimed: "claimed";
+    readonly Terminal: "terminal";
+    readonly Retry: "retry";
+};
+export type JobClaimResult = (typeof JobClaimResult)[keyof typeof JobClaimResult];
+export type JobService = ReturnType<typeof createJobService>;
+//# sourceMappingURL=service.d.ts.map

package/dist/jobs/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/jobs/service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAIL,KAAK,kBAAkB,IAAI,SAAS,EACrC,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,IAAI,EAAE,WAAW,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB;AA6BD,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,kBAAkB;kBAE/B,uBAAuB,GAAG,OAAO,CAAC,kBAAkB,CAAC;gBAqBvD,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC;IAUlE;;OAEG;oBACmB,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAc/C;;;OAGG;4BAC2B,MAAM,gBAAgB,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAe7E;;OAEG;6BAC4B,MAAM,gBAAgB,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;0BAiCzD,MAAM,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;qBAgBrE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;sBAaxB,MAAM,UAAU,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;mBAW1C,MAAM,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;yBAW1D,MAAM,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;EAW9F;AAED,eAAO,MAAM,cAAc;;;;CAIjB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,OAAO,cAAc,CAAC,CAAC;AAElF,MAAM,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC"}