@plumbus/core 0.4.1 → 0.5.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +14 -1
- package/dist/.tsbuildinfo +1 -1
- package/dist/api/exposure.d.ts +4 -0
- package/dist/api/exposure.d.ts.map +1 -0
- package/dist/api/exposure.js +5 -0
- package/dist/api/exposure.js.map +1 -0
- package/dist/api/index.d.ts +1 -0
- package/dist/api/index.d.ts.map +1 -1
- package/dist/api/index.js +2 -1
- package/dist/api/index.js.map +1 -1
- package/dist/api/route-generator.d.ts.map +1 -1
- package/dist/api/route-generator.js +27 -14
- package/dist/api/route-generator.js.map +1 -1
- package/dist/cli/cli.d.ts.map +1 -1
- package/dist/cli/cli.js +3 -1
- package/dist/cli/cli.js.map +1 -1
- package/dist/cli/commands/api-manifest.d.ts +26 -0
- package/dist/cli/commands/api-manifest.d.ts.map +1 -0
- package/dist/cli/commands/api-manifest.js +54 -0
- package/dist/cli/commands/api-manifest.js.map +1 -0
- package/dist/cli/commands/api.d.ts +3 -0
- package/dist/cli/commands/api.d.ts.map +1 -0
- package/dist/cli/commands/api.js +179 -0
- package/dist/cli/commands/api.js.map +1 -0
- package/dist/cli/commands/dev.d.ts.map +1 -1
- package/dist/cli/commands/dev.js +38 -149
- package/dist/cli/commands/dev.js.map +1 -1
- package/dist/cli/commands/doctor.d.ts +6 -0
- package/dist/cli/commands/doctor.d.ts.map +1 -1
- package/dist/cli/commands/doctor.js +92 -4
- package/dist/cli/commands/doctor.js.map +1 -1
- package/dist/cli/commands/event.d.ts.map +1 -1
- package/dist/cli/commands/event.js +3 -0
- package/dist/cli/commands/event.js.map +1 -1
- package/dist/cli/commands/events-ops.d.ts +4 -0
- package/dist/cli/commands/events-ops.d.ts.map +1 -0
- package/dist/cli/commands/events-ops.js +203 -0
- package/dist/cli/commands/events-ops.js.map +1 -0
- package/dist/cli/commands/flow.d.ts.map +1 -1
- package/dist/cli/commands/flow.js +49 -1
- package/dist/cli/commands/flow.js.map +1 -1
- package/dist/cli/commands/generate.d.ts +4 -0
- package/dist/cli/commands/generate.d.ts.map +1 -1
- package/dist/cli/commands/generate.js +94 -3
- package/dist/cli/commands/generate.js.map +1 -1
- package/dist/cli/commands/index.d.ts +2 -0
- package/dist/cli/commands/index.d.ts.map +1 -1
- package/dist/cli/commands/index.js +3 -0
- package/dist/cli/commands/index.js.map +1 -1
- package/dist/cli/commands/init.d.ts +1 -1
- package/dist/cli/commands/init.d.ts.map +1 -1
- package/dist/cli/commands/init.js +41 -4
- package/dist/cli/commands/init.js.map +1 -1
- package/dist/cli/commands/mcp.d.ts.map +1 -1
- package/dist/cli/commands/mcp.js +2 -0
- package/dist/cli/commands/mcp.js.map +1 -1
- package/dist/cli/commands/start.d.ts +3 -6
- package/dist/cli/commands/start.d.ts.map +1 -1
- package/dist/cli/commands/start.js +71 -180
- package/dist/cli/commands/start.js.map +1 -1
- package/dist/cli/commands/verify.d.ts +3 -1
- package/dist/cli/commands/verify.d.ts.map +1 -1
- package/dist/cli/commands/verify.js +25 -3
- package/dist/cli/commands/verify.js.map +1 -1
- package/dist/cli/commands/worker.d.ts +19 -0
- package/dist/cli/commands/worker.d.ts.map +1 -0
- package/dist/cli/commands/worker.js +234 -0
- package/dist/cli/commands/worker.js.map +1 -0
- package/dist/cli/mcp-serve-context.d.ts +3 -0
- package/dist/cli/mcp-serve-context.d.ts.map +1 -1
- package/dist/cli/mcp-serve-context.js +16 -1
- package/dist/cli/mcp-serve-context.js.map +1 -1
- package/dist/cli/templates/resources.d.ts.map +1 -1
- package/dist/cli/templates/resources.js +13 -2
- package/dist/cli/templates/resources.js.map +1 -1
- package/dist/cli/utils.d.ts +4 -0
- package/dist/cli/utils.d.ts.map +1 -1
- package/dist/cli/utils.js +9 -0
- package/dist/cli/utils.js.map +1 -1
- package/dist/data/drift-inspector.d.ts +2 -2
- package/dist/data/drift-inspector.d.ts.map +1 -1
- package/dist/data/drift-inspector.js +2 -1
- package/dist/data/drift-inspector.js.map +1 -1
- package/dist/data/migration.d.ts.map +1 -1
- package/dist/data/migration.js +2 -0
- package/dist/data/migration.js.map +1 -1
- package/dist/define/defineCapability.d.ts +8 -2
- package/dist/define/defineCapability.d.ts.map +1 -1
- package/dist/define/defineCapability.js +104 -1
- package/dist/define/defineCapability.js.map +1 -1
- package/dist/errors/http.d.ts.map +1 -1
- package/dist/errors/http.js +1 -0
- package/dist/errors/http.js.map +1 -1
- package/dist/errors/index.d.ts.map +1 -1
- package/dist/errors/index.js +1 -0
- package/dist/errors/index.js.map +1 -1
- package/dist/events/dispatcher.d.ts +4 -0
- package/dist/events/dispatcher.d.ts.map +1 -1
- package/dist/events/dispatcher.js +24 -1
- package/dist/events/dispatcher.js.map +1 -1
- package/dist/events/emitter.d.ts +2 -0
- package/dist/events/emitter.d.ts.map +1 -1
- package/dist/events/emitter.js +6 -3
- package/dist/events/emitter.js.map +1 -1
- package/dist/events/queue-adapter.d.ts +7 -0
- package/dist/events/queue-adapter.d.ts.map +1 -0
- package/dist/events/queue-adapter.js +4 -0
- package/dist/events/queue-adapter.js.map +1 -0
- package/dist/events/queue.d.ts +16 -13
- package/dist/events/queue.d.ts.map +1 -1
- package/dist/events/queue.js +79 -22
- package/dist/events/queue.js.map +1 -1
- package/dist/events/worker.d.ts +4 -0
- package/dist/events/worker.d.ts.map +1 -1
- package/dist/events/worker.js +47 -1
- package/dist/events/worker.js.map +1 -1
- package/dist/execution/canonical-name.d.ts +13 -0
- package/dist/execution/canonical-name.d.ts.map +1 -0
- package/dist/execution/canonical-name.js +17 -0
- package/dist/execution/canonical-name.js.map +1 -0
- package/dist/execution/capability-executor.d.ts +1 -1
- package/dist/execution/capability-executor.d.ts.map +1 -1
- package/dist/execution/capability-executor.js +52 -24
- package/dist/execution/capability-executor.js.map +1 -1
- package/dist/execution/capability-invocation.d.ts +34 -0
- package/dist/execution/capability-invocation.d.ts.map +1 -0
- package/dist/execution/capability-invocation.js +138 -0
- package/dist/execution/capability-invocation.js.map +1 -0
- package/dist/execution/capability-registry.d.ts +6 -4
- package/dist/execution/capability-registry.d.ts.map +1 -1
- package/dist/execution/capability-registry.js +13 -7
- package/dist/execution/capability-registry.js.map +1 -1
- package/dist/execution/context-factory.d.ts.map +1 -1
- package/dist/execution/context-factory.js +12 -1
- package/dist/execution/context-factory.js.map +1 -1
- package/dist/execution/index.d.ts +4 -0
- package/dist/execution/index.d.ts.map +1 -1
- package/dist/execution/index.js +2 -0
- package/dist/execution/index.js.map +1 -1
- package/dist/execution/invocation-emit-scope.d.ts +11 -0
- package/dist/execution/invocation-emit-scope.d.ts.map +1 -0
- package/dist/execution/invocation-emit-scope.js +8 -0
- package/dist/execution/invocation-emit-scope.js.map +1 -0
- package/dist/flows/engine.d.ts +7 -1
- package/dist/flows/engine.d.ts.map +1 -1
- package/dist/flows/engine.js +73 -10
- package/dist/flows/engine.js.map +1 -1
- package/dist/flows/flow-delayed.d.ts +34 -0
- package/dist/flows/flow-delayed.d.ts.map +1 -0
- package/dist/flows/flow-delayed.js +60 -0
- package/dist/flows/flow-delayed.js.map +1 -0
- package/dist/flows/flow-queue.d.ts +10 -0
- package/dist/flows/flow-queue.d.ts.map +1 -0
- package/dist/flows/flow-queue.js +25 -0
- package/dist/flows/flow-queue.js.map +1 -0
- package/dist/flows/scheduler.d.ts +0 -12
- package/dist/flows/scheduler.d.ts.map +1 -1
- package/dist/flows/scheduler.js +15 -0
- package/dist/flows/scheduler.js.map +1 -1
- package/dist/flows/schema.d.ts +17 -0
- package/dist/flows/schema.d.ts.map +1 -1
- package/dist/flows/schema.js +2 -0
- package/dist/flows/schema.js.map +1 -1
- package/dist/flows/step-consumer.d.ts +24 -0
- package/dist/flows/step-consumer.d.ts.map +1 -0
- package/dist/flows/step-consumer.js +72 -0
- package/dist/flows/step-consumer.js.map +1 -0
- package/dist/flows/triggers.d.ts +1 -1
- package/dist/flows/triggers.d.ts.map +1 -1
- package/dist/flows/triggers.js +5 -7
- package/dist/flows/triggers.js.map +1 -1
- package/dist/governance/capability-source-scan.d.ts +7 -0
- package/dist/governance/capability-source-scan.d.ts.map +1 -0
- package/dist/governance/capability-source-scan.js +80 -0
- package/dist/governance/capability-source-scan.js.map +1 -0
- package/dist/governance/index.d.ts +1 -1
- package/dist/governance/index.d.ts.map +1 -1
- package/dist/governance/index.js +1 -1
- package/dist/governance/index.js.map +1 -1
- package/dist/governance/rules/api.d.ts +13 -0
- package/dist/governance/rules/api.d.ts.map +1 -0
- package/dist/governance/rules/api.js +124 -0
- package/dist/governance/rules/api.js.map +1 -0
- package/dist/governance/rules/architecture.d.ts.map +1 -1
- package/dist/governance/rules/architecture.js +2 -0
- package/dist/governance/rules/architecture.js.map +1 -1
- package/dist/governance/rules/capability-dependencies.d.ts +8 -0
- package/dist/governance/rules/capability-dependencies.d.ts.map +1 -0
- package/dist/governance/rules/capability-dependencies.js +195 -0
- package/dist/governance/rules/capability-dependencies.js.map +1 -0
- package/dist/governance/rules/index.d.ts +3 -0
- package/dist/governance/rules/index.d.ts.map +1 -1
- package/dist/governance/rules/index.js +3 -0
- package/dist/governance/rules/index.js.map +1 -1
- package/dist/governance/rules/worker.d.ts +9 -0
- package/dist/governance/rules/worker.d.ts.map +1 -0
- package/dist/governance/rules/worker.js +89 -0
- package/dist/governance/rules/worker.js.map +1 -0
- package/dist/index.d.ts +8 -3
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +5 -3
- package/dist/index.js.map +1 -1
- package/dist/jobs/dispatch.d.ts +18 -0
- package/dist/jobs/dispatch.d.ts.map +1 -0
- package/dist/jobs/dispatch.js +50 -0
- package/dist/jobs/dispatch.js.map +1 -0
- package/dist/jobs/index.d.ts +9 -0
- package/dist/jobs/index.d.ts.map +1 -0
- package/dist/jobs/index.js +8 -0
- package/dist/jobs/index.js.map +1 -0
- package/dist/jobs/routes.d.ts +10 -0
- package/dist/jobs/routes.d.ts.map +1 -0
- package/dist/jobs/routes.js +44 -0
- package/dist/jobs/routes.js.map +1 -0
- package/dist/jobs/schema.d.ts +264 -0
- package/dist/jobs/schema.d.ts.map +1 -0
- package/dist/jobs/schema.js +34 -0
- package/dist/jobs/schema.js.map +1 -0
- package/dist/jobs/service.d.ts +52 -0
- package/dist/jobs/service.d.ts.map +1 -0
- package/dist/jobs/service.js +168 -0
- package/dist/jobs/service.js.map +1 -0
- package/dist/jobs/types.d.ts +30 -0
- package/dist/jobs/types.d.ts.map +1 -0
- package/dist/jobs/types.js +4 -0
- package/dist/jobs/types.js.map +1 -0
- package/dist/mcp/manifest-generator.d.ts.map +1 -1
- package/dist/mcp/manifest-generator.js +3 -2
- package/dist/mcp/manifest-generator.js.map +1 -1
- package/dist/observability/metrics.d.ts +9 -1
- package/dist/observability/metrics.d.ts.map +1 -1
- package/dist/observability/metrics.js +28 -1
- package/dist/observability/metrics.js.map +1 -1
- package/dist/runtime/bootstrap.d.ts +51 -0
- package/dist/runtime/bootstrap.d.ts.map +1 -0
- package/dist/runtime/bootstrap.js +140 -0
- package/dist/runtime/bootstrap.js.map +1 -0
- package/dist/runtime/index.d.ts +7 -0
- package/dist/runtime/index.d.ts.map +1 -0
- package/dist/runtime/index.js +6 -0
- package/dist/runtime/index.js.map +1 -0
- package/dist/runtime/load-extensions.d.ts +4 -0
- package/dist/runtime/load-extensions.d.ts.map +1 -0
- package/dist/runtime/load-extensions.js +41 -0
- package/dist/runtime/load-extensions.js.map +1 -0
- package/dist/runtime/queue-factory.d.ts +44 -0
- package/dist/runtime/queue-factory.d.ts.map +1 -0
- package/dist/runtime/queue-factory.js +156 -0
- package/dist/runtime/queue-factory.js.map +1 -0
- package/dist/runtime/register-consumers.d.ts +29 -0
- package/dist/runtime/register-consumers.d.ts.map +1 -0
- package/dist/runtime/register-consumers.js +233 -0
- package/dist/runtime/register-consumers.js.map +1 -0
- package/dist/runtime/start-worker-pool.d.ts +32 -0
- package/dist/runtime/start-worker-pool.d.ts.map +1 -0
- package/dist/runtime/start-worker-pool.js +91 -0
- package/dist/runtime/start-worker-pool.js.map +1 -0
- package/dist/runtime/worker-health.d.ts +19 -0
- package/dist/runtime/worker-health.d.ts.map +1 -0
- package/dist/runtime/worker-health.js +41 -0
- package/dist/runtime/worker-health.js.map +1 -0
- package/dist/server/bootstrap.d.ts +6 -0
- package/dist/server/bootstrap.d.ts.map +1 -1
- package/dist/server/bootstrap.js +18 -1
- package/dist/server/bootstrap.js.map +1 -1
- package/dist/testing/context.d.ts +3 -0
- package/dist/testing/context.d.ts.map +1 -1
- package/dist/testing/context.js +10 -0
- package/dist/testing/context.js.map +1 -1
- package/dist/testing/simulate-flow.d.ts.map +1 -1
- package/dist/testing/simulate-flow.js +10 -0
- package/dist/testing/simulate-flow.js.map +1 -1
- package/dist/types/capability.d.ts +67 -1
- package/dist/types/capability.d.ts.map +1 -1
- package/dist/types/capability.js +15 -1
- package/dist/types/capability.js.map +1 -1
- package/dist/types/config.d.ts +2 -0
- package/dist/types/config.d.ts.map +1 -1
- package/dist/types/context.d.ts +34 -1
- package/dist/types/context.d.ts.map +1 -1
- package/dist/types/enums.d.ts +1 -0
- package/dist/types/enums.d.ts.map +1 -1
- package/dist/types/enums.js +1 -0
- package/dist/types/enums.js.map +1 -1
- package/dist/types/errors.d.ts +1 -0
- package/dist/types/errors.d.ts.map +1 -1
- package/dist/types/event.d.ts +10 -0
- package/dist/types/event.d.ts.map +1 -1
- package/dist/types/event.js +5 -1
- package/dist/types/event.js.map +1 -1
- package/dist/types/index.d.ts +1 -1
- package/dist/types/index.d.ts.map +1 -1
- package/dist/types/index.js.map +1 -1
- package/dist/worker/bootstrap.d.ts +32 -1
- package/dist/worker/bootstrap.d.ts.map +1 -1
- package/dist/worker/bootstrap.js +166 -2
- package/dist/worker/bootstrap.js.map +1 -1
- package/instructions/api.md +19 -0
- package/instructions/capabilities.md +36 -1
- package/instructions/deployment.md +96 -11
- package/instructions/events.md +11 -0
- package/instructions/flows.md +12 -4
- package/instructions/governance.md +6 -0
- package/instructions/mcp.md +1 -1
- package/instructions/patterns.md +1 -0
- package/instructions/security.md +9 -0
- package/instructions/testing.md +12 -1
- package/instructions/upgrading-0.5-capabilities.md +181 -0
- package/package.json +16 -3
|
@@ -0,0 +1,89 @@
|
|
|
1
|
+
// ── Worker / queue governance rules ──
|
|
2
|
+
import { z } from 'zod';
|
|
3
|
+
import { CapabilityKind, GovernanceSeverity } from '../../types/enums.js';
|
|
4
|
+
function zodObjectKeys(schema) {
|
|
5
|
+
if (schema instanceof z.ZodObject) {
|
|
6
|
+
return new Set(Object.keys(schema.shape));
|
|
7
|
+
}
|
|
8
|
+
return null;
|
|
9
|
+
}
|
|
10
|
+
/** Warn when eventHandler capabilities lack trigger.event (no auto-registration). */
|
|
11
|
+
export const ruleEventHandlerMissingTrigger = {
|
|
12
|
+
id: 'worker.event-handler-missing-trigger',
|
|
13
|
+
category: 'architecture',
|
|
14
|
+
severity: GovernanceSeverity.Warning,
|
|
15
|
+
description: 'eventHandler capabilities should declare trigger.event for auto-registration',
|
|
16
|
+
evaluate(inventory) {
|
|
17
|
+
return inventory.capabilities
|
|
18
|
+
.filter((cap) => cap.kind === CapabilityKind.EventHandler && !cap.trigger?.event)
|
|
19
|
+
.map((cap) => ({
|
|
20
|
+
severity: GovernanceSeverity.Warning,
|
|
21
|
+
rule: 'worker.event-handler-missing-trigger',
|
|
22
|
+
description: `eventHandler "${cap.name}" has no trigger.event — it will not auto-register`,
|
|
23
|
+
affectedComponent: `capability:${cap.name}`,
|
|
24
|
+
remediation: 'Add `trigger: { event: "your.event" }` or register a ConsumerRegistry handler in app/server.ts',
|
|
25
|
+
}));
|
|
26
|
+
},
|
|
27
|
+
};
|
|
28
|
+
/** Warn eventHandlers with data/event side effects about at-least-once delivery idempotency. */
|
|
29
|
+
export const ruleEventHandlerSideEffects = {
|
|
30
|
+
id: 'worker.event-handler-side-effects',
|
|
31
|
+
category: 'architecture',
|
|
32
|
+
severity: GovernanceSeverity.Info,
|
|
33
|
+
description: 'eventHandler capabilities with write effects should be idempotent (at-least-once delivery)',
|
|
34
|
+
evaluate(inventory) {
|
|
35
|
+
return inventory.capabilities
|
|
36
|
+
.filter((cap) => cap.kind === CapabilityKind.EventHandler &&
|
|
37
|
+
((cap.effects?.data?.length ?? 0) > 0 || (cap.effects?.events?.length ?? 0) > 0))
|
|
38
|
+
.map((cap) => ({
|
|
39
|
+
severity: GovernanceSeverity.Info,
|
|
40
|
+
rule: 'worker.event-handler-side-effects',
|
|
41
|
+
description: `eventHandler "${cap.name}" mutates data/events — ensure handler logic is idempotent`,
|
|
42
|
+
affectedComponent: `capability:${cap.name}`,
|
|
43
|
+
remediation: 'Design handlers to tolerate duplicate delivery (natural keys, upserts, or idempotency checks)',
|
|
44
|
+
}));
|
|
45
|
+
},
|
|
46
|
+
};
|
|
47
|
+
/** Advisory: handler input schema should be compatible with event payload schema. */
|
|
48
|
+
export const ruleEventHandlerPayloadCompatibility = {
|
|
49
|
+
id: 'worker.event-handler-payload-compatibility',
|
|
50
|
+
category: 'architecture',
|
|
51
|
+
severity: GovernanceSeverity.Warning,
|
|
52
|
+
description: 'eventHandler input schema should align with the triggered event payload schema',
|
|
53
|
+
evaluate(inventory) {
|
|
54
|
+
const eventByName = new Map(inventory.events.map((evt) => [evt.name, evt]));
|
|
55
|
+
const signals = [];
|
|
56
|
+
for (const cap of inventory.capabilities) {
|
|
57
|
+
if (cap.kind !== CapabilityKind.EventHandler || !cap.trigger?.event) {
|
|
58
|
+
continue;
|
|
59
|
+
}
|
|
60
|
+
const eventDef = eventByName.get(cap.trigger.event);
|
|
61
|
+
if (!eventDef) {
|
|
62
|
+
continue;
|
|
63
|
+
}
|
|
64
|
+
const handlerKeys = zodObjectKeys(cap.input);
|
|
65
|
+
const eventKeys = zodObjectKeys(eventDef.payload);
|
|
66
|
+
if (!handlerKeys || !eventKeys) {
|
|
67
|
+
continue;
|
|
68
|
+
}
|
|
69
|
+
const missingOnEvent = [...handlerKeys].filter((key) => !eventKeys.has(key));
|
|
70
|
+
if (missingOnEvent.length === 0) {
|
|
71
|
+
continue;
|
|
72
|
+
}
|
|
73
|
+
signals.push({
|
|
74
|
+
severity: GovernanceSeverity.Warning,
|
|
75
|
+
rule: 'worker.event-handler-payload-compatibility',
|
|
76
|
+
description: `eventHandler "${cap.name}" expects input keys [${missingOnEvent.join(', ')}] not present on event "${cap.trigger.event}" payload`,
|
|
77
|
+
affectedComponent: `capability:${cap.name}`,
|
|
78
|
+
remediation: 'Align handler input with the event payload schema, or narrow handler input to a subset of event fields',
|
|
79
|
+
});
|
|
80
|
+
}
|
|
81
|
+
return signals;
|
|
82
|
+
},
|
|
83
|
+
};
|
|
84
|
+
export const workerRules = [
|
|
85
|
+
ruleEventHandlerMissingTrigger,
|
|
86
|
+
ruleEventHandlerSideEffects,
|
|
87
|
+
ruleEventHandlerPayloadCompatibility,
|
|
88
|
+
];
|
|
89
|
+
//# sourceMappingURL=worker.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"worker.js","sourceRoot":"","sources":["../../../src/governance/rules/worker.ts"],"names":[],"mappings":"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"}
|
package/dist/index.d.ts
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
export type { AICostRecord, AIExplainabilityTracker, AIInvocationRecord, AIProviderAdapter, AISecurityConfig, AIServiceConfig, AnthropicAdapterConfig, BudgetCheckResult, BudgetConfig, ChunkConfig, ChatMessage, CostTracker, DailyUsage, DocumentChunk, EmbeddingRequest, EmbeddingResponse, ExplainabilityConfig, IngestDocumentInput, Kind, ListModelsFilter, ModelRate, OpenAIAdapterConfig, ProviderJsonSchemaOptions, ProviderJsonSchemaResult, ProviderModel, ProviderRequest, ProviderResponse, ProviderStreamEvent, RAGPipeline, RAGPipelineConfig, RetrievalQuery, SecurityCheckResult, SecurityWarning, StoredChunk, TokenUsage, UsageAPIClient, UsageClientConfig, UsageData, UsageEntry, UsageSyncResult, ValidatedResponse, ValidationRetryConfig, VectorStore, } from './ai/index.js';
|
|
2
2
|
export { PromptRegistry, UsageAPIError, allKnownModels, calculateModelCost, checkPromptSecurity, chunkDocument, createAIService, createAnthropicAdapter, createCostTracker, createExplainabilityTracker, createInMemoryVectorStore, createOpenAIAdapter, createProviderAdapter, createRAGPipeline, createUsageAPIClient, documentChunksTable, documentsTable, findModelRate, generateWithValidation, joinAndFilterModels, zodToProviderJsonSchema, singleProviderConfig, ProviderJsonSchemaError, AIIncompleteOutputError, AIRefusalError, } from './ai/index.js';
|
|
3
3
|
export type { RouteGeneratorConfig } from './api/index.js';
|
|
4
|
-
export { registerAllRoutes, registerCapabilityRoute, registerStreamingRoute } from './api/index.js';
|
|
4
|
+
export { isApiExposed, registerAllRoutes, registerCapabilityRoute, registerStreamingRoute, } from './api/index.js';
|
|
5
5
|
export type { AuditServiceConfig } from './audit/index.js';
|
|
6
6
|
export { auditRecords, createAuditService } from './audit/index.js';
|
|
7
7
|
export type { AuthAdapter, JwtAdapterConfig, JwtClaimMapping, OidcAdapterConfig, OidcJwk, PasswordHashOptions, SamlAdapterConfig, ScimEmail, ScimError, ScimListResponse, ScimService, ScimServiceConfig, ScimUser, ScimUserRepository, ScimUserResource, SignJwtOptions, } from './auth/index.js';
|
|
@@ -22,7 +22,8 @@ export { PlumbusError, LeaseLostError, createErrorService, isPlumbusError, } fro
|
|
|
22
22
|
export type { DispatcherConfig, EventConsumer, EventConsumerHandler, EventEmitterConfig, EventQueue, IdempotencyService, RedisClient, RedisQueueConfig, WorkerConfig, } from './events/index.js';
|
|
23
23
|
export { ConsumerRegistry, EventRegistry, createEventEmitter, createEventWorker, createIdempotencyService, createInMemoryQueue, createOutboxDispatcher, createRedisQueue, deadLetterTable, idempotencyTable, outboxTable, } from './events/index.js';
|
|
24
24
|
export type { AuthorizationResult, CapabilityResult, ContextDependencies, ExecutionFailure, ExecutionResult, } from './execution/index.js';
|
|
25
|
-
export { CapabilityRegistry, createExecutionContext, evaluateAccess, executeCapability, } from './execution/index.js';
|
|
25
|
+
export { buildCapabilityRuntimeDeps, CapabilityRegistry, createExecutionContext, evaluateAccess, executeCapability, getCanonicalCapabilityName, isCanonicalCapabilityName, } from './execution/index.js';
|
|
26
|
+
export type { DependencyViolationMetadata, DependencyViolationReason, } from './execution/index.js';
|
|
26
27
|
export type { AIInvocationExplanation, AuthorizationExplanation, ExplanationFilter, ExplanationRecord, ExplanationTracker, ExplanationTrackerConfig, ExplanationType, FlowBranchExplanation, GovernanceExplanation, } from './explanation/index.js';
|
|
27
28
|
export { createExplanationTracker } from './explanation/index.js';
|
|
28
29
|
export { field } from './fields/index.js';
|
|
@@ -36,8 +37,12 @@ export { TranslationRegistry, createTranslationResolver, createTranslationServic
|
|
|
36
37
|
export * from './types/index.js';
|
|
37
38
|
export type { WorkerPool, WorkerPoolConfig } from './worker/index.js';
|
|
38
39
|
export { createWorkerPool } from './worker/index.js';
|
|
40
|
+
export type { BuildWorkerAiServiceOptions, RegisterCapabilityConsumersOptions, ResolveRuntimeQueuesOptions, RuntimeCommand, RuntimeQueues, ServerExtensions, } from './runtime/index.js';
|
|
41
|
+
export { RuntimeRole, buildStepDeps, buildWorkerAiService, discoverRuntimeResources, needsWorkerPool, registerCapabilityConsumers, resolveRuntimeQueues, resolveRuntimeRole, shouldStartApiServer, shouldStartWorkerPool, shouldUseRedisBackend, tryCreateRedisClient, } from './runtime/index.js';
|
|
42
|
+
export type { CreateJobExecutionInput, DispatchJobOptions, JobExecutionRecord, JobQueuePayload, JobService, } from './jobs/index.js';
|
|
43
|
+
export { JobExecutionSource, JobExecutionStatus, createJobService, dispatchQueuedJob, jobEventType, jobExecutionsTable, registerJobStatusRoute, } from './jobs/index.js';
|
|
39
44
|
export type { AgentFormat, CreateOptions, DevOptions, DoctorCheck, InitOptions, PolicyContext, PolicyRule, } from './cli/index.js';
|
|
40
45
|
export { assertInsidePlumbusProject, capabilityTemplate, capabilityTestTemplate, checkAppStructure, checkConfig, checkLegacyArtifacts, checkNodeVersion, checkPackageJson, checkPlumbusCore, checkPlumbusUi, checkPostgreSQL, checkRedis, checkTypeScript, commandRequiresProject, createCli, entityTemplate, evaluatePolicy, eventTemplate, findPlumbusProjectRoot, flowTemplate, generateAgentsMd, generateAll, generateCapabilityBrief, generateCapabilityNameType, generateCapabilityTypes, generateClientFunction, generateCopilotInstructions, generateCursorCapabilityRule, generateCursorRule, generateDataServiceMap, generateEntityBrief, generateEntityInterface, generateEntityTypeFile, generateManifestEntry, generateOpenApiPath, generateProjectBrief, generateProjectBriefFromResources, generateProjectStructure, generateReactHook, promptTemplate, ruleCapabilityAccessPolicy, ruleCapabilityEffects, ruleEncryptedSensitiveFields, ruleEntityFieldClassification, ruleEntityTenantIsolation, runDev, runDoctorChecks, runFullDoctorChecks, runGovernanceRules, startDevServer, toCamelCase, toKebabCase, toPascalCase, translationTemplate, writeAgentFiles, zodTypeToString, } from './cli/index.js';
|
|
41
46
|
export type { GovernanceResult, GovernanceRule, GovernanceRuleEngine, OverrideEntry, OverrideStore, PolicyProfileDefinition, PolicyProfileRule, ReportOptions, RuleCategory, SystemInventory, } from './governance/index.js';
|
|
42
|
-
export { aiRules, applyOverrides, architectureRules, builtInProfiles, createGovernanceRuleEngine, createOverrideStore, evaluatePolicyProfile, formatPolicyReport, generateAllPolicyReports, generatePolicyReport, ruleCapabilityMissingAccessPolicy as govRuleCapabilityMissingAccessPolicy, ruleEntityTenantIsolation as govRuleEntityTenantIsolation, privacyRules, ruleAIWithoutExplanation, ruleCrossTenantDataAccess, ruleEntityMissingDescription, ruleExcessiveAIUsage, ruleExcessiveDataRetention, ruleExcessiveEffects, ruleExcessiveFlowBranching, ruleExcessiveFlowSteps, ruleMissingAuditConfig, ruleMissingFieldClassification, ruleOverlyPermissiveRoles, rulePersonalDataInLogs, ruleSensitiveFieldUnencrypted, securityRules, } from './governance/index.js';
|
|
47
|
+
export { aiRules, apiRules, applyOverrides, architectureRules, builtInProfiles, createGovernanceRuleEngine, createOverrideStore, evaluatePolicyProfile, formatPolicyReport, generateAllPolicyReports, generatePolicyReport, ruleCapabilityMissingAccessPolicy as govRuleCapabilityMissingAccessPolicy, ruleEntityTenantIsolation as govRuleEntityTenantIsolation, privacyRules, ruleAIWithoutExplanation, ruleApiDeprecatedWithoutReplacement, ruleApiMetadataWithoutExposure, ruleApiMissingAuth, ruleApiMissingOperationId, ruleApiPublicMutationWithoutIdempotency, ruleCrossTenantDataAccess, ruleEntityMissingDescription, ruleExcessiveAIUsage, ruleExcessiveDataRetention, ruleExcessiveEffects, ruleExcessiveFlowBranching, ruleExcessiveFlowSteps, ruleMissingAuditConfig, ruleMissingFieldClassification, ruleOverlyPermissiveRoles, rulePersonalDataInLogs, ruleSensitiveFieldUnencrypted, securityRules, } from './governance/index.js';
|
|
43
48
|
//# sourceMappingURL=index.d.ts.map
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAoBA,YAAY,EACV,YAAY,EACZ,uBAAuB,EACvB,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,sBAAsB,EACtB,iBAAiB,EACjB,YAAY,EACZ,WAAW,EACX,WAAW,EACX,WAAW,EACX,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,IAAI,EACJ,gBAAgB,EAChB,SAAS,EACT,mBAAmB,EACnB,yBAAyB,EACzB,wBAAwB,EACxB,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,WAAW,EACX,UAAU,EACV,cAAc,EACd,iBAAiB,EACjB,SAAS,EACT,UAAU,EACV,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EACrB,WAAW,GACZ,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,cAAc,EACd,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,EACb,eAAe,EACf,sBAAsB,EACtB,iBAAiB,EACjB,2BAA2B,EAC3B,yBAAyB,EACzB,mBAAmB,EACnB,qBAAqB,EACrB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,EACd,aAAa,EACb,sBAAsB,EACtB,mBAAmB,EACnB,uBAAuB,EACvB,oBAAoB,EACpB,uBAAuB,EACvB,uBAAuB,EACvB,cAAc,GACf,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAE3D,OAAO,
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|
package/dist/index.js
CHANGED
|
@@ -16,7 +16,7 @@
|
|
|
16
16
|
// ── AI Runtime ──
|
|
17
17
|
export { PromptRegistry, UsageAPIError, allKnownModels, calculateModelCost, checkPromptSecurity, chunkDocument, createAIService, createAnthropicAdapter, createCostTracker, createExplainabilityTracker, createInMemoryVectorStore, createOpenAIAdapter, createProviderAdapter, createRAGPipeline, createUsageAPIClient, documentChunksTable, documentsTable, findModelRate, generateWithValidation, joinAndFilterModels, zodToProviderJsonSchema, singleProviderConfig, ProviderJsonSchemaError, AIIncompleteOutputError, AIRefusalError, } from './ai/index.js';
|
|
18
18
|
// ── API (HTTP route generation) ──
|
|
19
|
-
export { registerAllRoutes, registerCapabilityRoute, registerStreamingRoute } from './api/index.js';
|
|
19
|
+
export { isApiExposed, registerAllRoutes, registerCapabilityRoute, registerStreamingRoute, } from './api/index.js';
|
|
20
20
|
// ── Audit ──
|
|
21
21
|
export { auditRecords, createAuditService } from './audit/index.js';
|
|
22
22
|
// ── Auth ──
|
|
@@ -39,7 +39,7 @@ export { PlumbusError, LeaseLostError, createErrorService, isPlumbusError, } fro
|
|
|
39
39
|
// ── Events ──
|
|
40
40
|
export { ConsumerRegistry, EventRegistry, createEventEmitter, createEventWorker, createIdempotencyService, createInMemoryQueue, createOutboxDispatcher, createRedisQueue, deadLetterTable, idempotencyTable, outboxTable, } from './events/index.js';
|
|
41
41
|
// ── Execution Engine ──
|
|
42
|
-
export { CapabilityRegistry, createExecutionContext, evaluateAccess, executeCapability, } from './execution/index.js';
|
|
42
|
+
export { buildCapabilityRuntimeDeps, CapabilityRegistry, createExecutionContext, evaluateAccess, executeCapability, getCanonicalCapabilityName, isCanonicalCapabilityName, } from './execution/index.js';
|
|
43
43
|
// ── Explanation ──
|
|
44
44
|
export { createExplanationTracker } from './explanation/index.js';
|
|
45
45
|
// ── Field Constructors ──
|
|
@@ -56,6 +56,8 @@ export { TranslationRegistry, createTranslationResolver, createTranslationServic
|
|
|
56
56
|
export * from './types/index.js';
|
|
57
57
|
// ── Worker Bootstrap ──
|
|
58
58
|
export { createWorkerPool } from './worker/index.js';
|
|
59
|
+
export { RuntimeRole, buildStepDeps, buildWorkerAiService, discoverRuntimeResources, needsWorkerPool, registerCapabilityConsumers, resolveRuntimeQueues, resolveRuntimeRole, shouldStartApiServer, shouldStartWorkerPool, shouldUseRedisBackend, tryCreateRedisClient, } from './runtime/index.js';
|
|
60
|
+
export { JobExecutionSource, JobExecutionStatus, createJobService, dispatchQueuedJob, jobEventType, jobExecutionsTable, registerJobStatusRoute, } from './jobs/index.js';
|
|
59
61
|
// ── CLI (entry point + scaffolding + code generation) ──
|
|
60
62
|
export {
|
|
61
63
|
// CLI project guard
|
|
@@ -85,5 +87,5 @@ ruleCapabilityAccessPolicy, ruleCapabilityEffects, ruleEncryptedSensitiveFields,
|
|
|
85
87
|
// Dev server
|
|
86
88
|
runDev, runDoctorChecks, runFullDoctorChecks, runGovernanceRules, startDevServer, toCamelCase, toKebabCase, toPascalCase, translationTemplate, writeAgentFiles, zodTypeToString, } from './cli/index.js';
|
|
87
89
|
// ── Governance Engine (advisory governance rules + policy reports) ──
|
|
88
|
-
export { aiRules, applyOverrides, architectureRules, builtInProfiles, createGovernanceRuleEngine, createOverrideStore, evaluatePolicyProfile, formatPolicyReport, generateAllPolicyReports, generatePolicyReport, ruleCapabilityMissingAccessPolicy as govRuleCapabilityMissingAccessPolicy, ruleEntityTenantIsolation as govRuleEntityTenantIsolation, privacyRules, ruleAIWithoutExplanation, ruleCrossTenantDataAccess, ruleEntityMissingDescription, ruleExcessiveAIUsage, ruleExcessiveDataRetention, ruleExcessiveEffects, ruleExcessiveFlowBranching, ruleExcessiveFlowSteps, ruleMissingAuditConfig, ruleMissingFieldClassification, ruleOverlyPermissiveRoles, rulePersonalDataInLogs, ruleSensitiveFieldUnencrypted, securityRules, } from './governance/index.js';
|
|
90
|
+
export { aiRules, apiRules, applyOverrides, architectureRules, builtInProfiles, createGovernanceRuleEngine, createOverrideStore, evaluatePolicyProfile, formatPolicyReport, generateAllPolicyReports, generatePolicyReport, ruleCapabilityMissingAccessPolicy as govRuleCapabilityMissingAccessPolicy, ruleEntityTenantIsolation as govRuleEntityTenantIsolation, privacyRules, ruleAIWithoutExplanation, ruleApiDeprecatedWithoutReplacement, ruleApiMetadataWithoutExposure, ruleApiMissingAuth, ruleApiMissingOperationId, ruleApiPublicMutationWithoutIdempotency, ruleCrossTenantDataAccess, ruleEntityMissingDescription, ruleExcessiveAIUsage, ruleExcessiveDataRetention, ruleExcessiveEffects, ruleExcessiveFlowBranching, ruleExcessiveFlowSteps, ruleMissingAuditConfig, ruleMissingFieldClassification, ruleOverlyPermissiveRoles, rulePersonalDataInLogs, ruleSensitiveFieldUnencrypted, securityRules, } from './governance/index.js';
|
|
89
91
|
//# sourceMappingURL=index.js.map
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,4BAA4B;AAC5B,EAAE;AACF,2CAA2C;AAC3C,EAAE;AACF,qDAAqD;AACrD,wEAAwE;AACxE,0EAA0E;AAC1E,EAAE;AACF,6DAA6D;AAC7D,4EAA4E;AAC5E,2DAA2D;AAC3D,EAAE;AACF,2DAA2D;AAC3D,+EAA+E;AAmD/E,mBAAmB;AACnB,OAAO,EACL,cAAc,EACd,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,EACb,eAAe,EACf,sBAAsB,EACtB,iBAAiB,EACjB,2BAA2B,EAC3B,yBAAyB,EACzB,mBAAmB,EACnB,qBAAqB,EACrB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,EACd,aAAa,EACb,sBAAsB,EACtB,mBAAmB,EACnB,uBAAuB,EACvB,oBAAoB,EACpB,uBAAuB,EACvB,uBAAuB,EACvB,cAAc,GACf,MAAM,eAAe,CAAC;AAEvB,oCAAoC;AACpC,OAAO,
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
import type { PostgresJsDatabase } from 'drizzle-orm/postgres-js';
|
|
2
|
+
import type { CapabilityContract } from '../types/capability.js';
|
|
3
|
+
import type { EventQueue } from '../events/queue.js';
|
|
4
|
+
import type { AuthContext } from '../types/security.js';
|
|
5
|
+
import { JobExecutionSource } from './schema.js';
|
|
6
|
+
export interface DispatchJobOptions {
|
|
7
|
+
db: PostgresJsDatabase;
|
|
8
|
+
jobQueue: EventQueue;
|
|
9
|
+
capability: CapabilityContract;
|
|
10
|
+
input: Record<string, unknown>;
|
|
11
|
+
auth: AuthContext;
|
|
12
|
+
jobId?: string;
|
|
13
|
+
source?: (typeof JobExecutionSource)[keyof typeof JobExecutionSource];
|
|
14
|
+
correlationId?: string;
|
|
15
|
+
}
|
|
16
|
+
/** Create job_executions row and publish to the jobs queue. */
|
|
17
|
+
export declare function dispatchQueuedJob(options: DispatchJobOptions): Promise<string>;
|
|
18
|
+
//# sourceMappingURL=dispatch.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
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"}
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
import { evaluateAccess } from '../execution/authorization.js';
|
|
2
|
+
import { createJobService } from './service.js';
|
|
3
|
+
import { JobExecutionSource } from './schema.js';
|
|
4
|
+
import { jobEventType } from './types.js';
|
|
5
|
+
/** Create job_executions row and publish to the jobs queue. */
|
|
6
|
+
export async function dispatchQueuedJob(options) {
|
|
7
|
+
const { db, jobQueue, capability, input, auth, jobId = crypto.randomUUID(), source = JobExecutionSource.Http, correlationId, } = options;
|
|
8
|
+
if (capability.kind !== 'job') {
|
|
9
|
+
throw new Error(`Capability "${capability.name}" is not kind job`);
|
|
10
|
+
}
|
|
11
|
+
const authz = evaluateAccess(capability.access, auth);
|
|
12
|
+
if (!authz.allowed) {
|
|
13
|
+
throw new Error(authz.reason ?? 'Job access denied at enqueue');
|
|
14
|
+
}
|
|
15
|
+
const jobs = createJobService(db);
|
|
16
|
+
await jobs.create({
|
|
17
|
+
id: jobId,
|
|
18
|
+
capabilityDomain: capability.domain,
|
|
19
|
+
capabilityName: capability.name,
|
|
20
|
+
input,
|
|
21
|
+
auth,
|
|
22
|
+
correlationId: correlationId ?? jobId,
|
|
23
|
+
source,
|
|
24
|
+
});
|
|
25
|
+
const payload = {
|
|
26
|
+
input,
|
|
27
|
+
capability: { domain: capability.domain, name: capability.name },
|
|
28
|
+
jobExecutionId: jobId,
|
|
29
|
+
source,
|
|
30
|
+
};
|
|
31
|
+
try {
|
|
32
|
+
await jobQueue.publish({
|
|
33
|
+
id: jobId,
|
|
34
|
+
eventType: jobEventType(capability.domain, capability.name),
|
|
35
|
+
version: '1',
|
|
36
|
+
occurredAt: new Date(),
|
|
37
|
+
actor: auth.userId ?? 'anonymous',
|
|
38
|
+
tenantId: auth.tenantId,
|
|
39
|
+
correlationId: correlationId ?? jobId,
|
|
40
|
+
payload,
|
|
41
|
+
});
|
|
42
|
+
}
|
|
43
|
+
catch (err) {
|
|
44
|
+
const message = err instanceof Error ? err.message : String(err);
|
|
45
|
+
await jobs.markPublishFailed(jobId, { code: 'queue_publish_failed', message });
|
|
46
|
+
throw err;
|
|
47
|
+
}
|
|
48
|
+
return jobId;
|
|
49
|
+
}
|
|
50
|
+
//# sourceMappingURL=dispatch.js.map
|
|
@@ -0,0 +1 @@
|
|
|
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"}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
export { dispatchQueuedJob } from './dispatch.js';
|
|
2
|
+
export type { DispatchJobOptions } from './dispatch.js';
|
|
3
|
+
export { createJobService } from './service.js';
|
|
4
|
+
export type { CreateJobExecutionInput, JobService } from './service.js';
|
|
5
|
+
export { jobExecutionsTable, JobExecutionSource, JobExecutionStatus, } from './schema.js';
|
|
6
|
+
export { jobEventType } from './types.js';
|
|
7
|
+
export type { JobExecutionRecord, JobQueuePayload } from './types.js';
|
|
8
|
+
export { registerJobStatusRoute } from './routes.js';
|
|
9
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
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"}
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
// ── Jobs Module ──
|
|
2
|
+
// Async capability job persistence and queue envelope types.
|
|
3
|
+
export { dispatchQueuedJob } from './dispatch.js';
|
|
4
|
+
export { createJobService } from './service.js';
|
|
5
|
+
export { jobExecutionsTable, JobExecutionSource, JobExecutionStatus, } from './schema.js';
|
|
6
|
+
export { jobEventType } from './types.js';
|
|
7
|
+
export { registerJobStatusRoute } from './routes.js';
|
|
8
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
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"}
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
import type { PostgresJsDatabase } from 'drizzle-orm/postgres-js';
|
|
2
|
+
import type { FastifyInstance } from 'fastify';
|
|
3
|
+
import type { AuthAdapter } from '../auth/adapter.js';
|
|
4
|
+
export interface JobStatusRouteConfig {
|
|
5
|
+
db: PostgresJsDatabase;
|
|
6
|
+
authAdapter: AuthAdapter;
|
|
7
|
+
}
|
|
8
|
+
/** Register GET /api/jobs/:jobId — additive job status endpoint. */
|
|
9
|
+
export declare function registerJobStatusRoute(app: FastifyInstance, config: JobStatusRouteConfig): void;
|
|
10
|
+
//# sourceMappingURL=routes.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
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"}
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
import { createJobService } from './service.js';
|
|
2
|
+
/** Register GET /api/jobs/:jobId — additive job status endpoint. */
|
|
3
|
+
export function registerJobStatusRoute(app, config) {
|
|
4
|
+
const jobs = createJobService(config.db);
|
|
5
|
+
app.get('/api/jobs/:jobId', async (request, reply) => {
|
|
6
|
+
const authHeader = request.headers.authorization;
|
|
7
|
+
const auth = await config.authAdapter.authenticate(authHeader);
|
|
8
|
+
if (!auth?.userId) {
|
|
9
|
+
reply.status(401);
|
|
10
|
+
return { error: { code: 'unauthorized', message: 'Authentication required' } };
|
|
11
|
+
}
|
|
12
|
+
const { jobId } = request.params;
|
|
13
|
+
const record = await jobs.getById(jobId);
|
|
14
|
+
if (!record) {
|
|
15
|
+
reply.status(404);
|
|
16
|
+
return { error: { code: 'not_found', message: 'Job not found' } };
|
|
17
|
+
}
|
|
18
|
+
const isOwner = record.authSnapshotJson?.userId === auth.userId;
|
|
19
|
+
const isAdmin = auth.roles.includes('admin') || auth.roles.includes('system');
|
|
20
|
+
const tenantMatch = !record.tenantId || !auth.tenantId || record.tenantId === auth.tenantId;
|
|
21
|
+
if (!isOwner && !isAdmin) {
|
|
22
|
+
reply.status(403);
|
|
23
|
+
return { error: { code: 'forbidden', message: 'Access denied' } };
|
|
24
|
+
}
|
|
25
|
+
if (!tenantMatch && !isAdmin) {
|
|
26
|
+
reply.status(403);
|
|
27
|
+
return { error: { code: 'forbidden', message: 'Tenant mismatch' } };
|
|
28
|
+
}
|
|
29
|
+
return {
|
|
30
|
+
data: {
|
|
31
|
+
jobId: record.id,
|
|
32
|
+
status: record.status,
|
|
33
|
+
capability: { domain: record.capabilityDomain, name: record.capabilityName },
|
|
34
|
+
source: record.source,
|
|
35
|
+
createdAt: record.createdAt.toISOString(),
|
|
36
|
+
startedAt: record.startedAt?.toISOString() ?? null,
|
|
37
|
+
completedAt: record.completedAt?.toISOString() ?? null,
|
|
38
|
+
output: record.outputJson ?? null,
|
|
39
|
+
error: record.errorJson ?? null,
|
|
40
|
+
},
|
|
41
|
+
};
|
|
42
|
+
});
|
|
43
|
+
}
|
|
44
|
+
//# sourceMappingURL=routes.js.map
|
|
@@ -0,0 +1 @@
|
|
|
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"}
|