apcore-js 0.21.1 → 0.23.0

package/dist/events/emitter.js

@@ -1,6 +1,7 @@
 /**
- * Global event bus with fan-out delivery and subscriber error isolation.
+ * Global event bus with fan-out delivery, per-subscriber retry, and DLQ.
  */
+import { resolveRetry, computeDelayMs, fnmatch } from './retry.js';
 export function createEvent(eventType, moduleId, severity, data) {
     return {
         eventType,
@@ -10,35 +11,26 @@ export function createEvent(eventType, moduleId, severity, data) {
         data,
     };
 }
-/**
- * Emit a canonical event AND a legacy alias for the same event during the
- * deprecation window. The legacy event payload is augmented with
- * `deprecated: true` and `canonical_event: <canonicalType>` so subscribers
- * still listening to the legacy name can migrate.
- *
- * The two emissions share an identical timestamp so they appear atomic to
- * downstream consumers ordering by `timestamp`.
- */
-export function emitWithLegacy(emitter, canonicalType, legacyType, moduleId, severity, data) {
-    const timestamp = new Date().toISOString();
-    emitter.emit({ eventType: canonicalType, moduleId, timestamp, severity, data });
-    emitter.emit({
-        eventType: legacyType,
-        moduleId,
-        timestamp,
-        severity,
-        data: { ...data, deprecated: true, canonical_event: canonicalType },
-    });
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
 }
 const DEFAULT_MAX_PENDING = 1000;
 /**
- * Global event bus with non-blocking fan-out delivery.
- * Errors in one subscriber do not affect others.
+ * Global event bus with fan-out delivery, per-subscriber retry, and DLQ.
+ *
+ * Key behaviors:
+ * - All subscribers get exponential-backoff retries up to `maxAttempts`. A subscriber
+ *   that omits `retry` receives the spec default policy (max_attempts=3); one that sets
+ *   `maxAttempts: 1` disables retry (single attempt).
+ * - After retry exhaustion: DLQ event + optional `onFailure` callback.
+ * - `eventPattern` (glob) filters which events a subscriber receives.
+ * - `flush()` drains all in-flight async deliveries.
  */
 export class EventEmitter {
     _subscribers = [];
     _pending = [];
     _maxPending;
+    _shutdown = false;
     constructor(maxPending = DEFAULT_MAX_PENDING) {
         this._maxPending = maxPending;
     }
@@ -51,72 +43,157 @@ export class EventEmitter {
             this._subscribers.splice(idx, 1);
         }
     }
+    /**
+     * Stop accepting new emits. After shutdown, {@link emit} is a no-op (A-D-028,
+     * cross-SDK canonical with Python/Rust which drop post-shutdown emits). Drains
+     * any in-flight deliveries via {@link flush}.
+     */
+    async shutdown(timeoutMs = 5000) {
+        if (this._shutdown)
+            return;
+        this._shutdown = true;
+        await this.flush(timeoutMs);
+    }
     emit(event) {
-        const snapshot = [...this._subscribers];
+        // A-D-028: silently drop emits after shutdown.
+        if (this._shutdown)
+            return;
+        const snapshot = this._getMatchingSubscribers(event.eventType);
         for (const subscriber of snapshot) {
+            // Every subscriber — built-in and user-registered, with or without an explicit
+            // `retry` block — goes through the unified retry/backoff/DLQ delivery path.
+            // A subscriber that omits `retry` receives the spec default policy
+            // (max_attempts=3); one that explicitly sets maxAttempts:1 disables retry.
+            // (event-system.md §Per-Subscriber Retry Policy; sync finding A-D-005)
+            if (this._pending.length >= this._maxPending) {
+                // A-D-06: the pending buffer is full. The event was accepted by emit(),
+                // so it MUST NOT be silently discarded (event-system.md §Overflow). Route
+                // the affected delivery through the dead-letter path with
+                // reason: "pending_overflow" instead of a log-only drop. `maxPending`
+                // remains a legitimate memory bound — we just fail through the DLQ.
+                const overflowPromise = this._emitOverflowDLQ(subscriber, event);
+                const tracked = overflowPromise.catch(() => {
+                    // DLQ subscriber errors handled inside _emitOverflowDLQ
+                });
+                this._pending.push(tracked);
+                tracked.then(() => {
+                    const idx = this._pending.indexOf(tracked);
+                    if (idx !== -1)
+                        this._pending.splice(idx, 1);
+                });
+            }
+            else {
+                const tracked = this._deliver(subscriber, event).catch(() => {
+                    // errors handled inside _deliver
+                });
+                this._pending.push(tracked);
+                tracked.then(() => {
+                    const idx = this._pending.indexOf(tracked);
+                    if (idx !== -1)
+                        this._pending.splice(idx, 1);
+                });
+            }
+        }
+    }
+    _getMatchingSubscribers(eventType, isDlq = false) {
+        return this._subscribers.filter((sub) => {
+            // A-D-026: DLQ events (apcore.event.delivery_failed) are delivered ONLY
+            // to subscribers with an explicit, non-wildcard pattern. Catch-all
+            // subscribers (no pattern, or pattern '*') never receive DLQ events —
+            // this prevents cascading failures where a catch-all subscriber would
+            // recursively fail on the DLQ event about its own delivery failure.
+            const pattern = sub.eventPattern ?? '*';
+            if (isDlq && pattern === '*')
+                return false;
+            return fnmatch(eventType, pattern);
+        });
+    }
+    async _deliver(subscriber, event) {
+        const retry = resolveRetry(subscriber.retry);
+        let lastError = new Error('Unknown error');
+        for (let attempt = 0; attempt < retry.maxAttempts; attempt++) {
             try {
-                const result = subscriber.onEvent(event);
-                if (result instanceof Promise) {
-                    if (this._pending.length >= this._maxPending) {
-                        // Overflow: instead of silently dropping, emit a structured event
-                        // so observers can track delivery loss. (sync finding A-D-504)
-                        console.warn(`[apcore:events] _pending cap (${this._maxPending}) reached — dropping async delivery for event ${event.eventType}`);
-                        this._dispatchDroppedEvent(subscriber, event);
-                    }
-                    else {
-                        const tracked = result.catch((err) => {
-                            console.warn(`[apcore:events] Subscriber failed handling event ${event.eventType}:`, err);
-                        });
-                        this._pending.push(tracked);
-                        // Auto-cleanup when resolved to prevent unbounded growth
-                        tracked.then(() => {
-                            const idx = this._pending.indexOf(tracked);
-                            if (idx !== -1)
-                                this._pending.splice(idx, 1);
-                        });
-                    }
+                await subscriber.onEvent(event);
+                return;
+            }
+            catch (e) {
+                lastError = e instanceof Error ? e : new Error(String(e));
+                if (attempt + 1 < retry.maxAttempts) {
+                    await sleep(computeDelayMs(retry, attempt));
                 }
             }
-            catch (err) {
-                console.warn(`[apcore:events] Subscriber failed handling event ${event.eventType}:`, err);
+        }
+        // All attempts exhausted — emit DLQ event and invoke onFailure callback
+        await this._emitDLQ(subscriber, event, lastError, retry.maxAttempts);
+        if (subscriber.onFailure) {
+            try {
+                await subscriber.onFailure(event, lastError, retry.maxAttempts);
+            }
+            catch (cbError) {
+                console.error('[apcore:events] onFailure callback raised:', cbError);
             }
         }
     }
     /**
-     * Synchronously dispatch an `apcore.subscriber.delivery_dropped` event to all
-     * subscribers (except the one whose delivery was dropped, to avoid feedback
-     * loops). Sync emit only — never tracked in `_pending`. (sync finding A-D-504)
+     * Route an overflowed delivery through the dead-letter path (A-D-06).
+     *
+     * When the pending buffer is at capacity, the affected delivery cannot be
+     * tracked normally, so instead of dropping it we emit
+     * `apcore.event.delivery_failed` with `reason: "pending_overflow"`. This keeps
+     * the "accepted events are never silently lost" guarantee while preserving
+     * `maxPending` as a memory bound (event-system.md §Overflow, normative).
      */
-    _dispatchDroppedEvent(droppedFor, originalEvent) {
-        const droppedEvent = createEvent('apcore.subscriber.delivery_dropped', null, 'warning', {
-            subscriber_id: this._identifySubscriber(droppedFor),
-            event_type: originalEvent.eventType,
-            original_module_id: originalEvent.moduleId,
+    async _emitOverflowDLQ(subscriber, originalEvent) {
+        const error = new Error(`pending buffer at capacity (${this._maxPending}) — delivery routed to dead-letter`);
+        await this._emitDLQ(subscriber, originalEvent, error, 0, 'pending_overflow');
+    }
+    async _emitDLQ(subscriber, originalEvent, error, attemptCount, reason) {
+        // A-D-029: prefer the declared `subscriberType` field; fall back to the
+        // constructor-name derivation only when it is absent.
+        const subscriberType = typeof subscriber.subscriberType === 'string'
+            ? subscriber.subscriberType
+            : (subscriber.constructor?.name ?? 'unknown')
+                .replace('Subscriber', '')
+                .toLowerCase();
+        const subscriberId = subscriber.subscriberId ?? this._identifySubscriber(subscriber);
+        const dlqEvent = createEvent('apcore.event.delivery_failed', null, 'error', {
+            subscriber_type: subscriberType,
+            subscriber_id: subscriberId,
+            original_event: {
+                name: originalEvent.eventType,
+                payload: originalEvent.data,
+                metadata: {
+                    module_id: originalEvent.moduleId,
+                    timestamp: originalEvent.timestamp,
+                },
+            },
+            error: { type: error.constructor?.name ?? 'Error', message: error.message },
+            attempt_count: attemptCount,
+            timestamp: new Date().toISOString(),
+            // A-D-06: present only on pending-buffer overflow ("pending_overflow").
+            ...(reason !== undefined ? { reason } : {}),
         });
-        for (const sub of this._subscribers) {
-            if (sub === droppedFor)
-                continue; // avoid recursive drop on the same sink
+        // Deliver DLQ event with NO retry — single attempt only; DLQ subscriber errors are logged.
+        // isDlq=true excludes catch-all ('*'/no-pattern) subscribers (A-D-026).
+        const dlqSubscribers = this._getMatchingSubscribers(dlqEvent.eventType, true);
+        for (const dlqSub of dlqSubscribers) {
             try {
-                const r = sub.onEvent(droppedEvent);
-                // Intentionally do not track this Promise in _pending — at-cap by design.
-                // Async handlers swallow their own errors; attach a guard so unhandled
-                // rejections don't escape.
+                const r = dlqSub.onEvent(dlqEvent);
                 if (r instanceof Promise) {
-                    r.catch((err) => {
-                        console.warn(`[apcore:events] Subscriber failed handling delivery_dropped:`, err);
-                    });
+                    await r;
                 }
             }
-            catch (err) {
-                console.warn(`[apcore:events] Subscriber failed handling delivery_dropped:`, err);
+            catch (dlqErr) {
+                console.error('[apcore:events] DLQ subscriber raised:', dlqErr);
             }
         }
     }
     _identifySubscriber(sub) {
+        if (sub.subscriberId)
+            return sub.subscriberId;
         const ctorName = sub.constructor?.name;
         if (ctorName && ctorName !== 'Object')
             return ctorName;
-        // Fall back to a stable hash-ish string based on identity.
         return `subscriber@${this._subscribers.indexOf(sub)}`;
     }
     /**
@@ -128,13 +205,25 @@ export class EventEmitter {
      *                   (sync finding A-D-503)
      */
     async flush(timeoutMs = 5000) {
-        const deadline = timeoutMs > 0 ? Date.now() + timeoutMs : Infinity;
-        while (this._pending.length > 0) {
-            if (Date.now() >= deadline)
-                return;
-            const pending = [...this._pending];
-            this._pending = [];
-            await Promise.allSettled(pending);
+        // A-D-027: per-pending semantics (Python canonical) — each pending delivery
+        // gets up to `timeoutMs` to settle, rather than sharing one total deadline.
+        // A delivery that exceeds its budget is abandoned (the next call to flush
+        // can re-await any that are still tracked).
+        const pending = [...this._pending];
+        this._pending = [];
+        for (const p of pending) {
+            if (timeoutMs > 0) {
+                let timer;
+                const timeout = new Promise((resolve) => {
+                    timer = setTimeout(resolve, timeoutMs);
+                });
+                await Promise.race([p.catch(() => { }), timeout]);
+                if (timer !== undefined)
+                    clearTimeout(timer);
+            }
+            else {
+                await p.catch(() => { });
+            }
         }
     }
 }

package/dist/events/emitter.js.map

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

package/dist/events/index.d.ts

@@ -1,6 +1,7 @@
-export { EventEmitter, createEvent, emitWithLegacy } from './emitter.js';
+export { EventEmitter, createEvent } from './emitter.js';
 export type { ApCoreEvent, EventSubscriber } from './emitter.js';
 export { WebhookSubscriber, A2ASubscriber, FileSubscriber, StdoutSubscriber, FilterSubscriber } from './subscribers.js';
 export { CircuitBreakerWrapper, CircuitState } from './circuit-breaker.js';
 export type { CircuitBreakerConfig } from './circuit-breaker.js';
+export type { RetryConfig } from './retry.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACzE,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,cAAc,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACxH,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAC3E,YAAY,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACzD,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,cAAc,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACxH,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAC3E,YAAY,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/dist/events/index.js

@@ -1,4 +1,4 @@
-export { EventEmitter, createEvent, emitWithLegacy } from './emitter.js';
+export { EventEmitter, createEvent } from './emitter.js';
 export { WebhookSubscriber, A2ASubscriber, FileSubscriber, StdoutSubscriber, FilterSubscriber } from './subscribers.js';
 export { CircuitBreakerWrapper, CircuitState } from './circuit-breaker.js';
 //# sourceMappingURL=index.js.map

package/dist/events/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEzE,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,cAAc,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACxH,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEzD,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,cAAc,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACxH,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/events/retry.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Retry configuration types and helpers for event delivery.
+ */
+export interface RetryConfig {
+    maxAttempts?: number;
+    initialBackoffMs?: number;
+    maxBackoffMs?: number;
+    backoffMultiplier?: number;
+}
+export interface ResolvedRetryConfig {
+    maxAttempts: number;
+    initialBackoffMs: number;
+    maxBackoffMs: number;
+    backoffMultiplier: number;
+}
+/**
+ * Spec default retry policy (event-system.md §Per-Subscriber Retry Policy).
+ * Applied when a subscriber omits the `retry` block entirely, and as the base
+ * for merging when individual fields are omitted. `max_attempts` default is 3 —
+ * uniform across Python/TypeScript/Rust SDKs.
+ */
+export declare const DEFAULT_RETRY: ResolvedRetryConfig;
+/**
+ * Merge caller-supplied retry config with the spec defaults.
+ * A subscriber that does NOT supply `retry` receives the full DEFAULT_RETRY
+ * policy (max_attempts=3), per event-system.md §Per-Subscriber Retry Policy —
+ * built-in and user-registered subscribers share the same default. A subscriber
+ * that explicitly sets `maxAttempts: 1` disables retry (single attempt).
+ */
+export declare function resolveRetry(config?: RetryConfig): ResolvedRetryConfig;
+/** Glob pattern matching supporting * (any chars) and ? (single char). Cached per pattern. */
+export declare function fnmatch(text: string, pattern: string): boolean;
+/** Exponential-backoff delay for attempt `attempt` (0-based, clamped to ≥ 0). */
+export declare function computeDelayMs(cfg: ResolvedRetryConfig, attempt: number): number;
+//# sourceMappingURL=retry.d.ts.map

package/dist/events/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/events/retry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,WAAW;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;GAKG;AACH,eAAO,MAAM,aAAa,EAAE,mBAK3B,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,mBAAmB,CAKtE;AAID,8FAA8F;AAC9F,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAc9D;AAED,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,GAAG,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAKhF"}

package/dist/events/retry.js

@@ -0,0 +1,52 @@
+/**
+ * Retry configuration types and helpers for event delivery.
+ */
+/**
+ * Spec default retry policy (event-system.md §Per-Subscriber Retry Policy).
+ * Applied when a subscriber omits the `retry` block entirely, and as the base
+ * for merging when individual fields are omitted. `max_attempts` default is 3 —
+ * uniform across Python/TypeScript/Rust SDKs.
+ */
+export const DEFAULT_RETRY = {
+    maxAttempts: 3,
+    initialBackoffMs: 100,
+    maxBackoffMs: 30_000,
+    backoffMultiplier: 2.0,
+};
+/**
+ * Merge caller-supplied retry config with the spec defaults.
+ * A subscriber that does NOT supply `retry` receives the full DEFAULT_RETRY
+ * policy (max_attempts=3), per event-system.md §Per-Subscriber Retry Policy —
+ * built-in and user-registered subscribers share the same default. A subscriber
+ * that explicitly sets `maxAttempts: 1` disables retry (single attempt).
+ */
+export function resolveRetry(config) {
+    if (config === undefined) {
+        return { ...DEFAULT_RETRY };
+    }
+    return { ...DEFAULT_RETRY, ...config };
+}
+const _patternCache = new Map();
+/** Glob pattern matching supporting * (any chars) and ? (single char). Cached per pattern. */
+export function fnmatch(text, pattern) {
+    let regex = _patternCache.get(pattern);
+    if (regex === undefined) {
+        const regexStr = Array.from(pattern)
+            .map((c) => {
+            if (c === '*')
+                return '.*';
+            if (c === '?')
+                return '.';
+            return c.replace(/[$()*+.?[\]^{|}-]/g, '\\$&');
+        })
+            .join('');
+        regex = new RegExp(`^${regexStr}$`);
+        _patternCache.set(pattern, regex);
+    }
+    return regex.test(text);
+}
+/** Exponential-backoff delay for attempt `attempt` (0-based, clamped to ≥ 0). */
+export function computeDelayMs(cfg, attempt) {
+    return Math.min(cfg.maxBackoffMs, Math.floor(cfg.initialBackoffMs * Math.pow(cfg.backoffMultiplier, Math.max(0, attempt))));
+}
+//# sourceMappingURL=retry.js.map

package/dist/events/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../src/events/retry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAgBH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAwB;IAChD,WAAW,EAAE,CAAC;IACd,gBAAgB,EAAE,GAAG;IACrB,YAAY,EAAE,MAAM;IACpB,iBAAiB,EAAE,GAAG;CACvB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,MAAoB;IAC/C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,EAAE,GAAG,aAAa,EAAE,CAAC;IAC9B,CAAC;IACD,OAAO,EAAE,GAAG,aAAa,EAAE,GAAG,MAAM,EAAE,CAAC;AACzC,CAAC;AAED,MAAM,aAAa,GAAG,IAAI,GAAG,EAAkB,CAAC;AAEhD,8FAA8F;AAC9F,MAAM,UAAU,OAAO,CAAC,IAAY,EAAE,OAAe;IACnD,IAAI,KAAK,GAAG,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACvC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC;aACjC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACT,IAAI,CAAC,KAAK,GAAG;gBAAE,OAAO,IAAI,CAAC;YAC3B,IAAI,CAAC,KAAK,GAAG;gBAAE,OAAO,GAAG,CAAC;YAC1B,OAAO,CAAC,CAAC,OAAO,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC;QACjD,CAAC,CAAC;aACD,IAAI,CAAC,EAAE,CAAC,CAAC;QACZ,KAAK,GAAG,IAAI,MAAM,CAAC,IAAI,QAAQ,GAAG,CAAC,CAAC;QACpC,aAAa,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,cAAc,CAAC,GAAwB,EAAE,OAAe;IACtE,OAAO,IAAI,CAAC,GAAG,CACb,GAAG,CAAC,YAAY,EAChB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,gBAAgB,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,iBAAiB,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CACzF,CAAC;AACJ,CAAC"}

package/dist/events/subscribers.d.ts

@@ -2,47 +2,83 @@
  * Event subscribers for webhook, A2A, file, stdout, and filter delivery.
  */
 import type { ApCoreEvent, EventSubscriber } from './emitter.js';
+import type { RetryConfig } from './retry.js';
 /**
  * Delivers events via HTTP POST to a webhook URL.
  *
- * Retries on 5xx and connection errors up to `retryCount` times.
- * Does not retry on 4xx responses. Enforces `timeoutMs`.
+ * Retries on 5xx and connection errors. As of v0.22.0 finding A-D-EVT-001,
+ * the retry policy is unified across event subscribers: the subscriber MUST
+ * NOT loop internally. Instead, it rethrows on 5xx / network errors and the
+ * outer `EventEmitter._deliver` applies the spec retry policy declared via
+ * the `retry` field (defaults to `DEFAULT_RETRY` — 3 attempts, 100 ms initial
+ * backoff, 2× multiplier, 30 s cap). 4xx responses are treated as
+ * non-retryable: a warning is logged and the call returns normally.
  */
 export declare class WebhookSubscriber implements EventSubscriber {
+    /** Declared subscriber kind for DLQ payloads (A-D-029). */
+    readonly subscriberType = "webhook";
+    readonly subscriberId: string;
+    readonly retry: RetryConfig;
     private readonly _url;
     private readonly _headers;
-    private readonly _retryCount;
     private readonly _timeoutMs;
-    constructor(url: string, headers?: Record<string, string>, retryCount?: number, timeoutMs?: number);
+    constructor(url: string, headers?: Record<string, string>, timeoutMsOrOpts?: number | {
+        timeoutMs?: number;
+        retry?: RetryConfig;
+        id?: string;
+    }, id?: string);
     onEvent(event: ApCoreEvent): Promise<void>;
 }
 /**
  * Delivers events via the A2A protocol to the platform.
  *
  * Sends a POST with `skillId="apevo.event_receiver"` and the
- * serialized event in the payload. Failures are logged, not raised.
+ * serialized event in the payload. As of v0.22.0 finding A-D-EVT-001 the
+ * subscriber no longer silently swallows errors. Mirroring
+ * `WebhookSubscriber`, it rethrows on 5xx / network errors so the unified
+ * `EventEmitter._deliver` retry policy applies (defaults to `DEFAULT_RETRY`
+ * — 3 attempts, 100 ms initial backoff, 2× multiplier, 30 s cap); after
+ * exhaustion the EventEmitter routes the failure through the DLQ +
+ * `onFailure` path. 4xx responses are treated as non-retryable: a warning
+ * is logged and the call returns normally (no retry, no DLQ).
  */
 export declare class A2ASubscriber implements EventSubscriber {
+    /** Declared subscriber kind for DLQ payloads (A-D-029). */
+    readonly subscriberType = "a2a";
+    readonly subscriberId: string;
+    readonly retry: RetryConfig;
     private readonly _platformUrl;
     private readonly _auth;
     private readonly _timeoutMs;
-    constructor(platformUrl: string, auth?: string | Record<string, string | unknown>, timeoutMs?: number);
+    private readonly _skillId;
+    constructor(platformUrl: string, auth?: string | Record<string, string | unknown>, timeoutMsOrOpts?: number | {
+        timeoutMs?: number;
+        retry?: RetryConfig;
+        id?: string;
+        skillId?: string;
+    }, id?: string, skillId?: string);
     onEvent(event: ApCoreEvent): Promise<void>;
 }
 /** Writes events to a local file (built-in type: 'file'). */
 export declare class FileSubscriber implements EventSubscriber {
+    /** Declared subscriber kind for DLQ payloads (A-D-029). */
+    readonly subscriberType = "file";
+    readonly subscriberId: string;
     private readonly _path;
     private readonly _append;
     private readonly _format;
     private readonly _rotateBytes;
-    constructor(path: string, append?: boolean, format?: string, rotateBytes?: number);
+    constructor(path: string, append?: boolean, format?: string, rotateBytes?: number, id?: string);
     onEvent(event: ApCoreEvent): Promise<void>;
 }
 /** Writes events to stdout (built-in type: 'stdout'). */
 export declare class StdoutSubscriber implements EventSubscriber {
+    /** Declared subscriber kind for DLQ payloads (A-D-029). */
+    readonly subscriberType = "stdout";
+    readonly subscriberId: string;
     private readonly _format;
     private readonly _levelFilter;
-    constructor(format?: string, levelFilter?: string);
+    constructor(format?: string, levelFilter?: string, id?: string);
     onEvent(event: ApCoreEvent): Promise<void>;
 }
 /**
@@ -54,10 +90,19 @@ export declare class StdoutSubscriber implements EventSubscriber {
  *   3. If neither is set, forward all events.
  */
 export declare class FilterSubscriber implements EventSubscriber {
+    /** Declared subscriber kind for DLQ payloads (A-D-029). */
+    readonly subscriberType = "filter";
+    /** Stable identity for DLQ payloads and dedup (A-D-022). */
+    readonly subscriberId: string;
+    /** Retry policy applied by EventEmitter._deliver (A-D-022). */
+    readonly retry: RetryConfig;
     private readonly _delegate;
     private readonly _includeEvents;
     private readonly _excludeEvents;
-    constructor(delegate: EventSubscriber, includeEvents?: string[], excludeEvents?: string[]);
+    constructor(delegate: EventSubscriber, includeEvents?: string[], excludeEvents?: string[], opts?: {
+        id?: string;
+        retry?: RetryConfig;
+    });
     onEvent(event: ApCoreEvent): Promise<void>;
     private _matches;
 }

package/dist/events/subscribers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"subscribers.d.ts","sourceRoot":"","sources":["../../src/events/subscribers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAsBjE;;;;;GAKG;AACH,qBAAa,iBAAkB,YAAW,eAAe;IACvD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyB;IAClD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAGlC,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAChC,UAAU,GAAE,MAAU,EACtB,SAAS,GAAE,MAAa;IAQpB,OAAO,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;CA+DjD;AAED;;;;;GAKG;AACH,qBAAa,aAAc,YAAW,eAAe;IACnD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA8C;IACpE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAGlC,WAAW,EAAE,MAAM,EACnB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,EAChD,SAAS,GAAE,MAAa;IAOpB,OAAO,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;CAwDjD;AAED,6DAA6D;AAC7D,qBAAa,cAAe,YAAW,eAAe;IACpD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAgB;gBAEjC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,OAAc,EAAE,MAAM,GAAE,MAAe,EAAE,WAAW,CAAC,EAAE,MAAM;IAOzF,OAAO,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;CAiCjD;AAED,yDAAyD;AACzD,qBAAa,gBAAiB,YAAW,eAAe;IACtD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAgB;gBAEjC,MAAM,GAAE,MAAe,EAAE,WAAW,CAAC,EAAE,MAAM;IAUnD,OAAO,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;CAoBjD;AAED;;;;;;;GAOG;AACH,qBAAa,gBAAiB,YAAW,eAAe;IACtD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAC5C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAkB;IACjD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAkB;gBAErC,QAAQ,EAAE,eAAe,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE;IAMnF,OAAO,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAMhD,OAAO,CAAC,QAAQ;CASjB"}
+{"version":3,"file":"subscribers.d.ts","sourceRoot":"","sources":["../../src/events/subscribers.ts"],"names":[],"mappings":"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"}