@plumbus/core 0.4.2 → 0.5.0

package/dist/events/worker.js

@@ -1,3 +1,4 @@
+import { createJobService } from '../jobs/service.js';
 import { deadLetterTable } from './outbox.js';
 /**
  * Creates an event delivery worker that subscribes to the queue,
@@ -7,7 +8,7 @@ import { deadLetterTable } from './outbox.js';
  * Returns start/stop controls.
  */
 export function createEventWorker(config) {
-    const { db, queue, consumers, idempotency, defaultMaxRetries = 3, retryBackoffBaseMs = 100, retryBackoffMaxMs = 5000, } = config;
+    const { db, queue, consumers, idempotency, defaultMaxRetries = 3, metrics, audit, retryBackoffBaseMs = 100, retryBackoffMaxMs = 5000, } = config;
     let unsubscribe = null;
     /** Compute exponential backoff with jitter */
     function computeRetryDelay(attempt) {
@@ -20,6 +21,7 @@ export function createEventWorker(config) {
     }
     async function deliver(envelope) {
         const matched = consumers.getConsumers(envelope.eventType, envelope.version);
+        const deliveryStarted = Date.now();
         for (const consumer of matched) {
             const maxRetries = consumer.maxRetries ?? defaultMaxRetries;
             // Idempotency guard
@@ -32,6 +34,14 @@ export function createEventWorker(config) {
             while (attempt < maxRetries && !succeeded) {
                 attempt++;
                 try {
+                    await audit?.record('event.consumer.attempt', {
+                        eventId: envelope.id,
+                        eventType: envelope.eventType,
+                        consumerId: consumer.id,
+                        attempt,
+                        tenantId: envelope.tenantId,
+                        outcome: 'pending',
+                    });
                     await consumer.handler(envelope);
                     succeeded = true;
                 }
@@ -44,8 +54,34 @@ export function createEventWorker(config) {
             }
             if (succeeded) {
                 await idempotency.markProcessed(envelope.id, consumer.id);
+                metrics?.eventDelivered.inc({ consumer: consumer.id });
+                metrics?.eventDeliveryDuration.observe(Date.now() - deliveryStarted, {
+                    consumer: consumer.id,
+                    outcome: 'delivered',
+                });
+                await audit?.record('event.consumer.delivered', {
+                    eventId: envelope.id,
+                    eventType: envelope.eventType,
+                    consumerId: consumer.id,
+                    tenantId: envelope.tenantId,
+                    outcome: 'success',
+                });
             }
             else {
+                metrics?.eventFailed.inc({ consumer: consumer.id });
+                metrics?.eventDeliveryDuration.observe(Date.now() - deliveryStarted, {
+                    consumer: consumer.id,
+                    outcome: 'failed',
+                });
+                await audit?.record('event.consumer.dead_lettered', {
+                    eventId: envelope.id,
+                    eventType: envelope.eventType,
+                    consumerId: consumer.id,
+                    tenantId: envelope.tenantId,
+                    lastError,
+                    attempts: attempt,
+                    outcome: 'dead_lettered',
+                });
                 // Dead-letter
                 await db.insert(deadLetterTable).values({
                     eventId: envelope.id,
@@ -61,6 +97,16 @@ export function createEventWorker(config) {
                         tenantId: envelope.tenantId,
                     },
                 });
+                if (consumer.id.startsWith('job:')) {
+                    const payload = envelope.payload;
+                    if (payload.jobExecutionId) {
+                        const jobs = createJobService(db);
+                        await jobs.markDeadLettered(payload.jobExecutionId, {
+                            code: 'delivery_exhausted',
+                            message: lastError ?? 'Job delivery exhausted retries',
+                        });
+                    }
+                }
             }
         }
     }

package/dist/events/worker.js.map

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

package/dist/execution/canonical-name.d.ts

@@ -0,0 +1,13 @@
+/** Minimal shape for deriving a registered capability name. */
+export interface CanonicalCapabilityRef {
+    domain: string;
+    name: string;
+}
+/**
+ * Canonical registered capability name: `<domain>.<capabilityName>`.
+ * Used for registry lookup, effects.capabilities, flow steps, invoke, manifests, and audit.
+ */
+export declare function getCanonicalCapabilityName(ref: CanonicalCapabilityRef): string;
+/** True when `value` looks like a canonical capability name (contains a domain prefix). */
+export declare function isCanonicalCapabilityName(value: string): boolean;
+//# sourceMappingURL=canonical-name.d.ts.map

package/dist/execution/canonical-name.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical-name.d.ts","sourceRoot":"","sources":["../../src/execution/canonical-name.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,sBAAsB,GAAG,MAAM,CAE9E;AAED,2FAA2F;AAC3F,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAOhE"}

package/dist/execution/canonical-name.js

@@ -0,0 +1,17 @@
+/**
+ * Canonical registered capability name: `<domain>.<capabilityName>`.
+ * Used for registry lookup, effects.capabilities, flow steps, invoke, manifests, and audit.
+ */
+export function getCanonicalCapabilityName(ref) {
+    return `${ref.domain}.${ref.name}`;
+}
+/** True when `value` looks like a canonical capability name (contains a domain prefix). */
+export function isCanonicalCapabilityName(value) {
+    const trimmed = value.trim();
+    if (!trimmed.includes('.')) {
+        return false;
+    }
+    const dot = trimmed.indexOf('.');
+    return dot > 0 && dot < trimmed.length - 1;
+}
+//# sourceMappingURL=canonical-name.js.map

package/dist/execution/canonical-name.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical-name.js","sourceRoot":"","sources":["../../src/execution/canonical-name.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CAAC,GAA2B;IACpE,OAAO,GAAG,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;AACrC,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,yBAAyB,CAAC,KAAa;IACrD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACjC,OAAO,GAAG,GAAG,CAAC,IAAI,GAAG,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;AAC7C,CAAC"}

package/dist/execution/capability-executor.d.ts

@@ -15,7 +15,7 @@ export type CapabilityResult<T = unknown> = ExecutionResult<T> | ExecutionFailur
  * Execute a capability through the full pipeline:
  * 1. Validate input
  * 2. Evaluate access policy
- * 3. Execute handler
+ * 3. Execute handler (with scoped ctx.capabilities)
  * 4. Validate output
  * 5. Record audit
  */

package/dist/execution/capability-executor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"capability-executor.d.ts","sourceRoot":"","sources":["../../src/execution/capability-executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAG7B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAG3D,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,OAAO;IAC1C,OAAO,EAAE,IAAI,CAAC;IACd,IAAI,EAAE,CAAC,CAAC;CACT;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EAAE,gBAAgB,CAAC;CACzB;AAED,MAAM,MAAM,gBAAgB,CAAC,CAAC,GAAG,OAAO,IAAI,eAAe,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC;AAElF;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,SAAS,CAAC,CAAC,UAAU,EAAE,OAAO,SAAS,CAAC,CAAC,UAAU,EAC/F,UAAU,EAAE,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/C,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,OAAO,GAChB,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAkG7C"}
+{"version":3,"file":"capability-executor.d.ts","sourceRoot":"","sources":["../../src/execution/capability-executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAG7B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAU3D,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,OAAO;IAC1C,OAAO,EAAE,IAAI,CAAC;IACd,IAAI,EAAE,CAAC,CAAC;CACT;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EAAE,gBAAgB,CAAC;CACzB;AAED,MAAM,MAAM,gBAAgB,CAAC,CAAC,GAAG,OAAO,IAAI,eAAe,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC;AAElF;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,SAAS,CAAC,CAAC,UAAU,EAAE,OAAO,SAAS,CAAC,CAAC,UAAU,EAC/F,UAAU,EAAE,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/C,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,OAAO,GAChB,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CA6H7C"}

package/dist/execution/capability-executor.js

@@ -1,23 +1,26 @@
 import { isProviderAPIError } from '../ai/provider.js';
 import { isPlumbusError } from '../errors/index.js';
 import { evaluateAccess } from './authorization.js';
+import { getCanonicalCapabilityName } from './canonical-name.js';
+import { createCapabilityInvokeService, createUnavailableCapabilityService, stripHandlerRuntime, } from './capability-invocation.js';
 /**
  * Execute a capability through the full pipeline:
  * 1. Validate input
  * 2. Evaluate access policy
- * 3. Execute handler
+ * 3. Execute handler (with scoped ctx.capabilities)
  * 4. Validate output
  * 5. Record audit
  */
 export async function executeCapability(capability, ctx, rawInput) {
+    const canonicalName = getCanonicalCapabilityName(capability);
     // 1. Validate input against schema
     const inputResult = capability.input.safeParse(rawInput);
     if (!inputResult.success) {
         const error = ctx.errors.validation('Invalid input', {
-            capability: capability.name,
+            capability: canonicalName,
             issues: inputResult.error.issues,
         });
-        await recordAudit(ctx, capability, 'failure', { error });
+        await recordAudit(ctx, capability, canonicalName, 'failure', { error });
         return { success: false, error };
     }
     const input = inputResult.data;
@@ -25,26 +28,42 @@ export async function executeCapability(capability, ctx, rawInput) {
     const authResult = evaluateAccess(capability.access, ctx.auth);
     if (!authResult.allowed) {
         const error = ctx.errors.forbidden(authResult.reason ?? 'Access denied', {
-            capability: capability.name,
+            capability: canonicalName,
         });
-        await recordAudit(ctx, capability, 'denied', { error });
+        await recordAudit(ctx, capability, canonicalName, 'denied', { error });
         return { success: false, error };
     }
-    // 3. Execute handler
+    // 3. Execute handler with scoped capabilities service (invoker not exposed on __runtime)
+    const invoker = ctx.__runtime?.invokeCapability;
+    const resolveCapability = ctx.__runtime?.resolveCapability;
+    const emitScope = ctx.__runtime?.invocationEmitScope;
+    const invocationRuntime = invoker && resolveCapability
+        ? { invoker: invoker, resolveCapability, emitScope }
+        : undefined;
+    const handlerCtx = {
+        ...ctx,
+        capabilities: invocationRuntime
+            ? createCapabilityInvokeService(capability, ctx, invocationRuntime)
+            : createUnavailableCapabilityService(ctx),
+        __runtime: stripHandlerRuntime(ctx.__runtime),
+    };
+    if (emitScope) {
+        emitScope.executingCapability = canonicalName;
+    }
     let rawOutput;
     try {
-        rawOutput = await capability.handler(ctx, input);
+        rawOutput = await capability.handler(handlerCtx, input);
     }
     catch (err) {
         // If the handler threw a PlumbusError, surface it directly
         if (isPlumbusError(err)) {
-            await recordAudit(ctx, capability, 'failure', { error: err });
+            await recordAudit(ctx, capability, canonicalName, 'failure', { error: err });
             return { success: false, error: err };
         }
         if (isProviderAPIError(err) && err.retryable) {
             const statusCode = err.statusCode === 429 ? 503 : (err.statusCode ?? 503);
             const error = ctx.errors.internal('AI provider temporarily unavailable. Please try again in a moment.', {
-                capability: capability.name,
+                capability: canonicalName,
                 message: err.message,
                 provider: err.providerName,
                 retryAttempts: err.attempts,
@@ -52,13 +71,13 @@ export async function executeCapability(capability, ctx, rawInput) {
                 upstreamStatusCode: err.statusCode,
                 httpStatus: statusCode,
             });
-            ctx.logger.error(`Capability "${capability.name}" failed due to transient AI provider error`, {
+            ctx.logger.error(`Capability "${canonicalName}" failed due to transient AI provider error`, {
                 error: err.message,
                 provider: err.providerName,
                 upstreamStatusCode: err.statusCode,
                 attempts: err.attempts,
             });
-            await recordAudit(ctx, capability, 'failure', { error });
+            await recordAudit(ctx, capability, canonicalName, 'failure', { error });
             return { success: false, error };
         }
         const causeMessage = err instanceof Error && err.cause instanceof Error ? err.cause.message : undefined;
@@ -68,51 +87,60 @@ export async function executeCapability(capability, ctx, rawInput) {
                 ? err.message
                 : String(err);
         const error = ctx.errors.internal('Capability execution failed', {
-            capability: capability.name,
+            capability: canonicalName,
             message: errorMessage,
         });
-        ctx.logger.error(`Capability "${capability.name}" threw an error`, {
+        ctx.logger.error(`Capability "${canonicalName}" threw an error`, {
             error: errorMessage,
         });
-        await recordAudit(ctx, capability, 'failure', { error });
+        await recordAudit(ctx, capability, canonicalName, 'failure', { error });
         return { success: false, error };
     }
+    finally {
+        if (emitScope) {
+            emitScope.executingCapability = undefined;
+        }
+    }
     // 4. Validate output against schema
     const outputResult = capability.output.safeParse(rawOutput);
     if (!outputResult.success) {
         const error = ctx.errors.internal('Invalid output from capability', {
-            capability: capability.name,
+            capability: canonicalName,
             issues: outputResult.error.issues,
         });
-        ctx.logger.error(`Capability "${capability.name}" returned invalid output`, {
+        ctx.logger.error(`Capability "${canonicalName}" returned invalid output`, {
             issues: outputResult.error.issues,
         });
-        await recordAudit(ctx, capability, 'failure', { error });
+        await recordAudit(ctx, capability, canonicalName, 'failure', { error });
         return { success: false, error };
     }
     // 5. Record success audit
-    await recordAudit(ctx, capability, 'success');
+    await recordAudit(ctx, capability, canonicalName, 'success');
     return { success: true, data: outputResult.data };
 }
-async function recordAudit(ctx, capability, outcome, metadata) {
-    // Skip if audit is explicitly disabled for this capability
+async function recordAudit(ctx, capability, canonicalName, outcome, metadata) {
     if (capability.audit?.enabled === false)
         return;
-    const auditEvent = capability.audit?.event ?? `capability.${capability.name}`;
+    const auditEvent = capability.audit?.event ?? `capability.${canonicalName}`;
+    const stack = ctx.__runtime?.capabilityStack ?? [];
+    const caller = ctx.__runtime?.invocationCaller;
+    const correlationId = ctx.__runtime?.correlationId;
     try {
         await ctx.audit.record(auditEvent, {
-            capability: capability.name,
+            capability: canonicalName,
             domain: capability.domain,
             kind: capability.kind,
             outcome,
             actor: ctx.auth.userId,
             tenantId: ctx.auth.tenantId,
+            ...(caller ? { caller } : {}),
+            ...(stack.length > 0 ? { capabilityStack: stack } : {}),
+            ...(correlationId ? { correlationId } : {}),
             ...metadata,
         });
     }
     catch {
-        // Audit failures should not break capability execution
-        ctx.logger.error(`Failed to record audit for capability "${capability.name}"`);
+        ctx.logger.error(`Failed to record audit for capability "${canonicalName}"`);
     }
 }
 //# sourceMappingURL=capability-executor.js.map

package/dist/execution/capability-executor.js.map

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

package/dist/execution/capability-invocation.d.ts

@@ -0,0 +1,34 @@
+import type { CapabilityContract } from '../types/capability.js';
+import type { CapabilityService, ExecutionContext, ExecutionRuntimeMetadata } from '../types/context.js';
+import type { CapabilityRegistry } from './capability-registry.js';
+import type { CapabilityResult } from './capability-executor.js';
+import type { InvocationEmitScope } from './invocation-emit-scope.js';
+export type DependencyViolationReason = 'undeclaredInvocation' | 'circularInvocation' | 'missingCapability' | 'invocationUnavailable' | 'unsupportedTargetKind';
+export interface DependencyViolationMetadata {
+    caller?: string;
+    target: string;
+    reason: DependencyViolationReason;
+    capabilityStack: readonly string[];
+}
+export type InternalCapabilityInvoker = (name: string, ctx: ExecutionContext, input: unknown) => Promise<CapabilityResult<unknown>>;
+export interface CapabilityInvocationRuntime {
+    invoker: InternalCapabilityInvoker;
+    resolveCapability: (name: string) => CapabilityContract | undefined;
+    emitScope?: InvocationEmitScope;
+}
+/** Strip internal invoker/registry/emit scope from handler-visible runtime metadata. */
+export declare function stripHandlerRuntime(runtime?: ExecutionRuntimeMetadata): ExecutionRuntimeMetadata | undefined;
+/** Runtime deps for nested capability invocation (wire into ContextDependencies). */
+export declare function buildCapabilityRuntimeDeps(registry: CapabilityRegistry): {
+    invokeCapability: InternalCapabilityInvoker;
+    resolveCapability: (name: string) => CapabilityContract | undefined;
+};
+export declare function buildRegistryInvoker(registry: CapabilityRegistry): InternalCapabilityInvoker;
+export declare function buildDependencyViolationMessage(metadata: DependencyViolationMetadata): string;
+/**
+ * Build the public `ctx.capabilities` service for a running capability handler.
+ */
+export declare function createCapabilityInvokeService(capability: CapabilityContract, ctx: ExecutionContext, runtime: CapabilityInvocationRuntime): CapabilityService;
+/** Invoke surface that always reports invocation unavailability. */
+export declare function createUnavailableCapabilityService(ctx: ExecutionContext): CapabilityService;
+//# sourceMappingURL=capability-invocation.d.ts.map

package/dist/execution/capability-invocation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-invocation.d.ts","sourceRoot":"","sources":["../../src/execution/capability-invocation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EAChB,wBAAwB,EACzB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEtE,MAAM,MAAM,yBAAyB,GACjC,sBAAsB,GACtB,oBAAoB,GACpB,mBAAmB,GACnB,uBAAuB,GACvB,uBAAuB,CAAC;AAE5B,MAAM,WAAW,2BAA2B;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,yBAAyB,CAAC;IAClC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAED,MAAM,MAAM,yBAAyB,GAAG,CACtC,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,gBAAgB,EACrB,KAAK,EAAE,OAAO,KACX,OAAO,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;AAExC,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,yBAAyB,CAAC;IACnC,iBAAiB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,kBAAkB,GAAG,SAAS,CAAC;IACpE,SAAS,CAAC,EAAE,mBAAmB,CAAC;CACjC;AAED,wFAAwF;AACxF,wBAAgB,mBAAmB,CACjC,OAAO,CAAC,EAAE,wBAAwB,GACjC,wBAAwB,GAAG,SAAS,CAStC;AAED,qFAAqF;AACrF,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,kBAAkB,GAAG;IACxE,gBAAgB,EAAE,yBAAyB,CAAC;IAC5C,iBAAiB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,kBAAkB,GAAG,SAAS,CAAC;CACrE,CAKA;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,yBAAyB,CAW5F;AAED,wBAAgB,+BAA+B,CAAC,QAAQ,EAAE,2BAA2B,GAAG,MAAM,CAkB7F;AAcD;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,UAAU,EAAE,kBAAkB,EAC9B,GAAG,EAAE,gBAAgB,EACrB,OAAO,EAAE,2BAA2B,GACnC,iBAAiB,CA0EnB;AAED,oEAAoE;AACpE,wBAAgB,kCAAkC,CAAC,GAAG,EAAE,gBAAgB,GAAG,iBAAiB,CAU3F"}

package/dist/execution/capability-invocation.js

@@ -0,0 +1,138 @@
+import { CapabilityKind } from '../types/enums.js';
+import { getCanonicalCapabilityName } from './canonical-name.js';
+import { executeCapability } from './capability-executor.js';
+/** Strip internal invoker/registry/emit scope from handler-visible runtime metadata. */
+export function stripHandlerRuntime(runtime) {
+    if (!runtime)
+        return undefined;
+    const { invokeCapability: _invoker, resolveCapability: _resolve, invocationEmitScope: _emitScope, ...handlerVisible } = runtime;
+    return handlerVisible;
+}
+/** Runtime deps for nested capability invocation (wire into ContextDependencies). */
+export function buildCapabilityRuntimeDeps(registry) {
+    return {
+        invokeCapability: buildRegistryInvoker(registry),
+        resolveCapability: (name) => registry.get(name),
+    };
+}
+export function buildRegistryInvoker(registry) {
+    return async (name, ctx, input) => {
+        const capability = registry.get(name);
+        if (!capability) {
+            return {
+                success: false,
+                error: ctx.errors.notFound(`Capability "${name}" not found`, { capability: name }),
+            };
+        }
+        return executeCapability(capability, ctx, input);
+    };
+}
+export function buildDependencyViolationMessage(metadata) {
+    const { caller, target, reason, capabilityStack } = metadata;
+    switch (reason) {
+        case 'undeclaredInvocation':
+            return `Capability ${caller ?? '(unknown)'} attempted to invoke ${target}, but ${target} is not declared in ${caller ?? '(unknown)'} effects.capabilities.`;
+        case 'circularInvocation':
+            return `Circular capability invocation detected: ${[...capabilityStack, target].join(' -> ')}.`;
+        case 'missingCapability':
+            return `Capability ${caller ?? '(unknown)'} declared or attempted to invoke ${target}, but no registered capability with that name exists.`;
+        case 'invocationUnavailable':
+            return 'Capability invocation is unavailable in this execution context because no capability registry-backed invoker was provided.';
+        case 'unsupportedTargetKind':
+            return `Capability ${caller ?? '(unknown)'} attempted to invoke ${target}, but job capabilities cannot be invoked synchronously — use job dispatch, flows, or events instead.`;
+        default: {
+            const _exhaustive = reason;
+            return _exhaustive;
+        }
+    }
+}
+function throwDependencyViolation(ctx, metadata) {
+    const message = buildDependencyViolationMessage(metadata);
+    throw ctx.errors.dependencyViolation(message, { ...metadata });
+}
+function isDeclaredCapabilityDependency(capability, target) {
+    return (capability.effects.capabilities ?? []).includes(target);
+}
+/**
+ * Build the public `ctx.capabilities` service for a running capability handler.
+ */
+export function createCapabilityInvokeService(capability, ctx, runtime) {
+    const caller = getCanonicalCapabilityName(capability);
+    const { invoker, resolveCapability, emitScope } = runtime;
+    return {
+        async invoke(name, input) {
+            const stack = ctx.__runtime?.capabilityStack ?? [];
+            if (!isDeclaredCapabilityDependency(capability, name)) {
+                throwDependencyViolation(ctx, {
+                    caller,
+                    target: name,
+                    reason: 'undeclaredInvocation',
+                    capabilityStack: stack,
+                });
+            }
+            if (stack.includes(name)) {
+                throwDependencyViolation(ctx, {
+                    caller,
+                    target: name,
+                    reason: 'circularInvocation',
+                    capabilityStack: stack,
+                });
+            }
+            const targetCap = resolveCapability(name);
+            if (!targetCap) {
+                throwDependencyViolation(ctx, {
+                    caller,
+                    target: name,
+                    reason: 'missingCapability',
+                    capabilityStack: stack,
+                });
+            }
+            if (targetCap.kind === CapabilityKind.Job) {
+                throwDependencyViolation(ctx, {
+                    caller,
+                    target: name,
+                    reason: 'unsupportedTargetKind',
+                    capabilityStack: stack,
+                });
+            }
+            const nestedCtx = {
+                ...ctx,
+                __runtime: {
+                    ...ctx.__runtime,
+                    capabilityStack: [...stack, caller],
+                    invocationCaller: caller,
+                },
+            };
+            const prevInvocationCaller = emitScope?.invocationCaller;
+            if (emitScope) {
+                emitScope.invocationCaller = caller;
+            }
+            let result;
+            try {
+                result = await invoker(name, nestedCtx, input);
+            }
+            finally {
+                if (emitScope) {
+                    emitScope.invocationCaller = prevInvocationCaller;
+                }
+            }
+            if (!result.success) {
+                throw result.error;
+            }
+            return result.data;
+        },
+    };
+}
+/** Invoke surface that always reports invocation unavailability. */
+export function createUnavailableCapabilityService(ctx) {
+    return {
+        async invoke(name) {
+            throwDependencyViolation(ctx, {
+                target: name,
+                reason: 'invocationUnavailable',
+                capabilityStack: ctx.__runtime?.capabilityStack ?? [],
+            });
+        },
+    };
+}
+//# sourceMappingURL=capability-invocation.js.map

package/dist/execution/capability-invocation.js.map

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

package/dist/execution/capability-registry.d.ts

@@ -1,12 +1,12 @@
 import type { CapabilityContract } from '../types/capability.js';
 /**
  * Registry that holds all discovered/registered capabilities,
- * indexed by name for lookup during execution and route generation.
+ * indexed by canonical name (`<domain>.<capabilityName>`) for lookup during execution.
  */
 export declare class CapabilityRegistry {
     private capabilities;
     /**
-     * Register a capability contract. Throws on duplicate names.
+     * Register a capability contract. Throws on duplicate canonical names.
      */
     register(capability: CapabilityContract): void;
     /**
@@ -14,7 +14,7 @@ export declare class CapabilityRegistry {
      */
     registerAll(capabilities: CapabilityContract[]): void;
     /**
-     * Get a capability by name.
+     * Get a capability by canonical name.
      */
     get(name: string): CapabilityContract | undefined;
     /**
@@ -26,8 +26,10 @@ export declare class CapabilityRegistry {
      */
     getByDomain(domain: string): CapabilityContract[];
     /**
-     * Check if a capability is registered.
+     * Check if a capability is registered by canonical name.
      */
     has(name: string): boolean;
+    /** Canonical names of all registered capabilities. */
+    getCanonicalNames(): string[];
 }
 //# sourceMappingURL=capability-registry.d.ts.map

package/dist/execution/capability-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"capability-registry.d.ts","sourceRoot":"","sources":["../../src/execution/capability-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEjE;;;GAGG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,YAAY,CAAyC;IAE7D;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,kBAAkB,GAAG,IAAI;IAO9C;;OAEG;IACH,WAAW,CAAC,YAAY,EAAE,kBAAkB,EAAE,GAAG,IAAI;IAMrD;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAIjD;;OAEG;IACH,MAAM,IAAI,kBAAkB,EAAE;IAI9B;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,kBAAkB,EAAE;IAIjD;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;CAG3B"}
+{"version":3,"file":"capability-registry.d.ts","sourceRoot":"","sources":["../../src/execution/capability-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAGjE;;;GAGG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,YAAY,CAAyC;IAE7D;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,kBAAkB,GAAG,IAAI;IAQ9C;;OAEG;IACH,WAAW,CAAC,YAAY,EAAE,kBAAkB,EAAE,GAAG,IAAI;IAMrD;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAIjD;;OAEG;IACH,MAAM,IAAI,kBAAkB,EAAE;IAI9B;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,kBAAkB,EAAE;IAIjD;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,sDAAsD;IACtD,iBAAiB,IAAI,MAAM,EAAE;CAG9B"}

package/dist/execution/capability-registry.js

@@ -1,17 +1,19 @@
+import { getCanonicalCapabilityName } from './canonical-name.js';
 /**
  * Registry that holds all discovered/registered capabilities,
- * indexed by name for lookup during execution and route generation.
+ * indexed by canonical name (`<domain>.<capabilityName>`) for lookup during execution.
  */
 export class CapabilityRegistry {
     capabilities = new Map();
     /**
-     * Register a capability contract. Throws on duplicate names.
+     * Register a capability contract. Throws on duplicate canonical names.
      */
     register(capability) {
-        if (this.capabilities.has(capability.name)) {
-            throw new Error(`Capability "${capability.name}" is already registered`);
+        const canonical = getCanonicalCapabilityName(capability);
+        if (this.capabilities.has(canonical)) {
+            throw new Error(`Capability "${canonical}" is already registered`);
         }
-        this.capabilities.set(capability.name, capability);
+        this.capabilities.set(canonical, capability);
     }
     /**
      * Register multiple capabilities at once.
@@ -22,7 +24,7 @@ export class CapabilityRegistry {
         }
     }
     /**
-     * Get a capability by name.
+     * Get a capability by canonical name.
      */
     get(name) {
         return this.capabilities.get(name);
@@ -40,10 +42,14 @@ export class CapabilityRegistry {
         return this.getAll().filter((c) => c.domain === domain);
     }
     /**
-     * Check if a capability is registered.
+     * Check if a capability is registered by canonical name.
      */
     has(name) {
         return this.capabilities.has(name);
     }
+    /** Canonical names of all registered capabilities. */
+    getCanonicalNames() {
+        return Array.from(this.capabilities.keys());
+    }
 }
 //# sourceMappingURL=capability-registry.js.map