apcore-js 0.19.0 → 0.21.0

package/dist/events/subscribers.js

@@ -1,6 +1,26 @@
 /**
- * Event subscribers for webhook and A2A protocol delivery.
+ * Event subscribers for webhook, A2A, file, stdout, and filter delivery.
  */
+import * as fs from 'node:fs';
+const SEVERITY_ORDER = { info: 0, warn: 1, error: 2, fatal: 3 };
+const _patternCache = new Map();
+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);
+}
 /**
  * Delivers events via HTTP POST to a webhook URL.
  *
@@ -129,4 +149,107 @@ export class A2ASubscriber {
         }
     }
 }
+/** Writes events to a local file (built-in type: 'file'). */
+export class FileSubscriber {
+    _path;
+    _append;
+    _format;
+    _rotateBytes;
+    constructor(path, append = true, format = 'json', rotateBytes) {
+        this._path = path;
+        this._append = append;
+        this._format = format;
+        this._rotateBytes = rotateBytes ?? null;
+    }
+    async onEvent(event) {
+        try {
+            if (this._rotateBytes !== null) {
+                try {
+                    const stat = fs.statSync(this._path);
+                    if (stat.size >= this._rotateBytes) {
+                        fs.renameSync(this._path, `${this._path}.1`);
+                    }
+                }
+                catch {
+                    // file doesn't exist yet — no rotation needed
+                }
+            }
+            const line = this._format === 'json'
+                ? JSON.stringify({
+                    event_type: event.eventType,
+                    module_id: event.moduleId,
+                    timestamp: event.timestamp,
+                    severity: event.severity,
+                    data: event.data,
+                }) + '\n'
+                : `[${event.timestamp}] [${event.severity.toUpperCase()}] ${event.eventType} module=${event.moduleId} data=${JSON.stringify(event.data)}\n`;
+            fs.writeFileSync(this._path, line, { flag: this._append ? 'a' : 'w', encoding: 'utf-8' });
+        }
+        catch (err) {
+            console.warn('[apcore:events]', `FileSubscriber failed to write event ${event.eventType} to ${this._path}:`, err);
+        }
+    }
+}
+/** Writes events to stdout (built-in type: 'stdout'). */
+export class StdoutSubscriber {
+    _format;
+    _levelFilter;
+    constructor(format = 'text', levelFilter) {
+        this._format = format;
+        if (levelFilter !== undefined && !(levelFilter in SEVERITY_ORDER)) {
+            console.warn(`[apcore:events] StdoutSubscriber: unknown level_filter '${levelFilter}' — valid values: info, warn, error, fatal. All events will pass.`);
+        }
+        this._levelFilter = levelFilter ?? null;
+    }
+    async onEvent(event) {
+        if (this._levelFilter !== null) {
+            const minLevel = SEVERITY_ORDER[this._levelFilter] ?? 0;
+            const eventLevel = SEVERITY_ORDER[event.severity] ?? 0;
+            if (eventLevel < minLevel)
+                return;
+        }
+        const line = this._format === 'json'
+            ? JSON.stringify({
+                event_type: event.eventType,
+                module_id: event.moduleId,
+                timestamp: event.timestamp,
+                severity: event.severity,
+                data: event.data,
+            })
+            : `[${event.timestamp}] [${event.severity.toUpperCase()}] ${event.eventType} module=${event.moduleId} data=${JSON.stringify(event.data)}`;
+        process.stdout.write(line + '\n');
+    }
+}
+/**
+ * Wraps a delegate subscriber with event-name filtering (built-in type: 'filter').
+ *
+ * Matching rules (evaluated in order):
+ *   1. If include_events is set, forward only events matching any pattern.
+ *   2. Otherwise if exclude_events is set, discard events matching any pattern.
+ *   3. If neither is set, forward all events.
+ */
+export class FilterSubscriber {
+    _delegate;
+    _includeEvents;
+    _excludeEvents;
+    constructor(delegate, includeEvents, excludeEvents) {
+        this._delegate = delegate;
+        this._includeEvents = includeEvents ?? null;
+        this._excludeEvents = excludeEvents ?? null;
+    }
+    async onEvent(event) {
+        if (this._matches(event.eventType)) {
+            await this._delegate.onEvent(event);
+        }
+    }
+    _matches(eventType) {
+        if (this._includeEvents !== null) {
+            return this._includeEvents.some((pattern) => fnmatch(eventType, pattern));
+        }
+        if (this._excludeEvents !== null) {
+            return !this._excludeEvents.some((pattern) => fnmatch(eventType, pattern));
+        }
+        return true;
+    }
+}
 //# sourceMappingURL=subscribers.js.map

package/dist/events/subscribers.js.map

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

package/dist/executor.d.ts

@@ -8,11 +8,11 @@ import type { ACL } from './acl.js';
 import type { ApprovalHandler } from './approval.js';
 import type { Config } from './config.js';
 import { Context } from './context.js';
-import { Middleware } from './middleware/index.js';
+import { type Middleware } from './middleware/index.js';
 import type { PreflightResult } from './module.js';
-import type { Registry } from './registry/registry.js';
 import type { PipelineTrace, StrategyInfo } from './pipeline.js';
 import { ExecutionStrategy } from './pipeline.js';
+import type { Registry } from './registry/registry.js';
 import type { ToggleState } from './sys-modules/toggle.js';
 export declare const REDACTED_VALUE: string;
 /** Well-known context.data keys used internally by the runtime. */
@@ -62,6 +62,14 @@ export declare class Executor {
     useAfter(callback: (moduleId: string, inputs: Record<string, unknown>, output: Record<string, unknown>, context: Context) => Record<string, unknown> | null): Executor;
     remove(middleware: Middleware): boolean;
     call(moduleId: string, inputs?: Record<string, unknown> | null, context?: Context | null, versionHint?: string | null): Promise<Record<string, unknown>>;
+    /**
+     * Reset PipelineContext for another attempt triggered by a RetrySignal.
+     *
+     * Preserves the top-level Context (so retry counters in context.data carry
+     * across attempts) while clearing per-run fields that the next attempt
+     * will re-populate. (sync finding A-D-017)
+     */
+    private _resetPipeCtxForRetry;
     /**
      * Alias for call(). Provided for compatibility with MCP bridge packages
      * that may call callAsync() by convention.

package/dist/executor.d.ts.map

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

package/dist/executor.js

@@ -4,15 +4,15 @@
  * Async-only execution pipeline. Python's call() + call_async() merge into one async call().
  * Timeout uses Promise.race instead of threading.
  */
-import { Context } from './context.js';
+import { BuiltinACLCheck, BuiltinApprovalGate, buildInternalStrategy, buildMinimalStrategy, buildPerformanceStrategy, buildStandardStrategy, buildTestingStrategy, } from './builtin-steps.js';
 import { ExecutionCancelledError } from './cancel.js';
-import { InvalidInputError, ModuleError, } from './errors.js';
-import { AfterMiddleware, BeforeMiddleware } from './middleware/index.js';
+import { Context } from './context.js';
+import { InvalidInputError, ModuleError, ModuleTimeoutError } from './errors.js';
+import { AfterMiddleware, BeforeMiddleware, RetrySignal, } from './middleware/index.js';
 import { MiddlewareChainError, MiddlewareManager } from './middleware/manager.js';
 import { createPreflightResult } from './module.js';
+import { ExecutionStrategy, PipelineAbortError, PipelineEngine, PipelineStepError, StrategyNotFoundError, } from './pipeline.js';
 import { MODULE_ID_PATTERN } from './registry/registry.js';
-import { ExecutionStrategy, PipelineEngine, PipelineAbortError, StrategyNotFoundError } from './pipeline.js';
-import { BuiltinACLCheck, BuiltinApprovalGate, buildStandardStrategy, buildInternalStrategy, buildTestingStrategy, buildPerformanceStrategy, buildMinimalStrategy, } from './builtin-steps.js';
 import { propagateError } from './utils/error-propagation.js';
 export const REDACTED_VALUE = '***REDACTED***';
 /** Well-known context.data keys used internally by the runtime. */
@@ -38,7 +38,11 @@ function redactFields(data, schemaDict) {
             }
             continue;
         }
-        if (fieldSchema['type'] === 'object' && 'properties' in fieldSchema && typeof value === 'object' && value !== null && !Array.isArray(value)) {
+        if (fieldSchema['type'] === 'object' &&
+            'properties' in fieldSchema &&
+            typeof value === 'object' &&
+            value !== null &&
+            !Array.isArray(value)) {
             redactFields(value, fieldSchema);
             continue;
         }
@@ -171,7 +175,7 @@ export class Executor {
     }
     /** List info for all registered strategies. */
     static listStrategies() {
-        return [...Executor._strategyRegistry.values()].map(s => s.info());
+        return [...Executor._strategyRegistry.values()].map((s) => s.info());
     }
     /** Describe the pipeline of the executor's current strategy. */
     describePipeline() {
@@ -252,29 +256,54 @@ export class Executor {
             trace: null,
             versionHint: versionHint ?? null,
         };
-        try {
-            const [output, _trace] = await this._pipelineEngine.run(this._strategy, pipeCtx);
-            return (output ?? {});
-        }
-        catch (exc) {
-            if (exc instanceof ExecutionCancelledError)
-                throw exc;
-            // Pipeline errors propagate with their original types (ModuleNotFoundError, etc.)
-            // because builtin steps now throw directly. MiddlewareChainError wraps the
-            // original; unwrap it so callers see the real error class/code instead of a
-            // generic MODULE_EXECUTE_ERROR.
-            const ctxObj = pipeCtx.context;
-            const underlying = exc instanceof MiddlewareChainError ? exc.original : exc;
-            const wrapped = propagateError(underlying, moduleId, ctxObj);
-            const executedMw = pipeCtx.executedMiddlewares;
-            if (executedMw && executedMw.length > 0) {
-                const recovery = this._middlewareManager.executeOnError(moduleId, pipeCtx.inputs, wrapped, ctxObj, executedMw);
-                if (recovery !== null)
-                    return recovery;
+        // Loop iterates only when a RetrySignal is returned from middleware
+        // onError; every other path returns or throws on the first attempt
+        // (sync finding A-D-017).
+        while (true) {
+            try {
+                const [output, _trace] = await this._pipelineEngine.run(this._strategy, pipeCtx);
+                return (output ?? {});
+            }
+            catch (exc) {
+                if (exc instanceof ExecutionCancelledError)
+                    throw exc;
+                // PipelineStepError is the engine-level contract (§1.1). Unwrap the cause
+                // so the executor's public API surfaces the original typed error.
+                const unwrapped = exc instanceof PipelineStepError ? (exc.cause instanceof Error ? exc.cause : exc) : exc;
+                // MiddlewareChainError wraps the original; unwrap it so callers see the
+                // real error class/code instead of a generic MODULE_EXECUTE_ERROR.
+                const ctxObj = pipeCtx.context;
+                const underlying = unwrapped instanceof MiddlewareChainError ? unwrapped.original : unwrapped;
+                const wrapped = propagateError(underlying, moduleId, ctxObj);
+                const executedMw = pipeCtx.executedMiddlewares;
+                if (executedMw && executedMw.length > 0) {
+                    const recovery = await this._middlewareManager.executeOnError(moduleId, pipeCtx.inputs, wrapped, ctxObj, executedMw);
+                    if (recovery instanceof RetrySignal) {
+                        this._resetPipeCtxForRetry(pipeCtx, recovery.inputs);
+                        continue;
+                    }
+                    if (recovery !== null)
+                        return recovery;
+                }
+                throw wrapped;
             }
-            throw wrapped;
         }
     }
+    /**
+     * Reset PipelineContext for another attempt triggered by a RetrySignal.
+     *
+     * Preserves the top-level Context (so retry counters in context.data carry
+     * across attempts) while clearing per-run fields that the next attempt
+     * will re-populate. (sync finding A-D-017)
+     */
+    _resetPipeCtxForRetry(pipeCtx, newInputs) {
+        pipeCtx.inputs = newInputs;
+        pipeCtx.validatedInputs = null;
+        pipeCtx.module = null;
+        pipeCtx.output = null;
+        pipeCtx.validatedOutput = null;
+        pipeCtx.executedMiddlewares = [];
+    }
     /**
      * Alias for call(). Provided for compatibility with MCP bridge packages
      * that may call callAsync() by convention.
@@ -303,8 +332,18 @@ export class Executor {
             strategy,
             trace: null,
         };
-        const [output, trace] = await this._pipelineEngine.run(strategy, pipelineCtx);
-        return [(output ?? {}), trace];
+        try {
+            const [output, trace] = await this._pipelineEngine.run(strategy, pipelineCtx);
+            return [(output ?? {}), trace];
+        }
+        catch (exc) {
+            // Unwrap PipelineStepError so callers see the original typed cause, consistent
+            // with call() behaviour (§1.1 engine-level contract vs public API surface).
+            if (exc instanceof PipelineStepError && exc.cause instanceof Error) {
+                throw exc.cause;
+            }
+            throw exc;
+        }
     }
     /**
      * Streaming execution pipeline. If the module exposes a stream() async generator,
@@ -352,10 +391,15 @@ export class Executor {
             if (exc instanceof ExecutionCancelledError)
                 throw exc;
             const ctxObj = pipeCtx.context;
-            const wrapped = propagateError(exc, moduleId, ctxObj);
+            // Unwrap PipelineStepError to expose the original typed cause (§1.1).
+            const unwrapped = exc instanceof PipelineStepError ? (exc.cause instanceof Error ? exc.cause : exc) : exc;
+            const wrapped = propagateError(unwrapped, moduleId, ctxObj);
             if (pipeCtx.executedMiddlewares && pipeCtx.executedMiddlewares.length > 0) {
-                const recovery = this._middlewareManager.executeOnError(moduleId, pipeCtx.inputs, wrapped, ctxObj, pipeCtx.executedMiddlewares);
-                if (recovery !== null) {
+                const recovery = await this._middlewareManager.executeOnError(moduleId, pipeCtx.inputs, wrapped, ctxObj, pipeCtx.executedMiddlewares);
+                // RetrySignal is not supported in stream mode — re-running a stream
+                // mid-flight is not well-defined. Fall through to throwing the wrapped
+                // error so the caller sees a normal failure (sync finding A-D-017).
+                if (recovery !== null && !(recovery instanceof RetrySignal)) {
                     yield recovery;
                     return;
                 }
@@ -370,8 +414,22 @@ export class Executor {
         // Phase 2: Iterate stream, accumulate chunks
         const outputStream = pipeCtx.outputStream;
         const accumulated = {};
+        // Read the canonical deadline slot written by BuiltinContextCreation
+        // (ms-since-epoch). The earlier `pipeCtx.context.globalDeadline` read was
+        // always null in the executor pipeline path because that field is a
+        // separate context attribute that the pipeline never populates — and the
+        // subsequent `Date.now() / 1000` divisor pretended the value was epoch
+        // seconds. (sync finding A-D-202.)
+        const globalDeadline = pipeCtx.context?.data?.[CTX_GLOBAL_DEADLINE] ?? null;
         try {
             for await (const chunk of outputStream) {
+                // Enforce global_deadline between chunks — matches apcore-python
+                // executor.py:872-879 (sync finding A-D-014). The slot is stored as
+                // ms-since-epoch (Date.now() + globalTimeout in BuiltinContextCreation),
+                // so compare against Date.now() directly.
+                if (globalDeadline !== null && Date.now() > globalDeadline) {
+                    throw new ModuleTimeoutError(moduleId, 0);
+                }
                 deepMergeChunk(accumulated, chunk);
                 yield chunk;
             }
@@ -382,8 +440,9 @@ export class Executor {
             const ctxObj = pipeCtx.context;
             const wrapped = propagateError(exc, moduleId, ctxObj);
             if (pipeCtx.executedMiddlewares && pipeCtx.executedMiddlewares.length > 0) {
-                const recovery = this._middlewareManager.executeOnError(moduleId, pipeCtx.inputs, wrapped, ctxObj, pipeCtx.executedMiddlewares);
-                if (recovery !== null) {
+                const recovery = await this._middlewareManager.executeOnError(moduleId, pipeCtx.inputs, wrapped, ctxObj, pipeCtx.executedMiddlewares);
+                // RetrySignal not supported mid-stream (sync finding A-D-017).
+                if (recovery !== null && !(recovery instanceof RetrySignal)) {
                     yield recovery;
                     return;
                 }
@@ -392,25 +451,39 @@ export class Executor {
         }
         // Phase 3: Output validation + middleware_after on accumulated result
         pipeCtx.output = accumulated;
-        const postSteps = this._strategy.steps.filter((s) => s.name === 'output_validation' || s.name === 'middleware_after' || s.name === 'return_result');
+        const postSteps = this._strategy.steps.filter((s) => s.name === 'output_validation' ||
+            s.name === 'middleware_after' ||
+            s.name === 'return_result');
         if (postSteps.length > 0) {
-            const postStrategy = new ExecutionStrategy('post_stream', postSteps);
+            // The post-stream sub-strategy starts with module + output already
+            // populated on pipeCtx (set by Phase 1 / Phase 2 above), so seed those
+            // names into the dependency check (§2.1).
+            const postStrategy = new ExecutionStrategy('post_stream', postSteps, {
+                seedProvides: ['module', 'output'],
+            });
             try {
                 await this._pipelineEngine.run(postStrategy, pipeCtx);
             }
             catch (exc) {
                 if (exc instanceof ExecutionCancelledError)
                     throw exc;
-                // Chunks already yielded cannot be un-yielded, but silently swallowing
-                // hides real schema violations and after-middleware failures. Rethrow so
-                // the consumer's async-iteration loop surfaces the error on the final
-                // next() call (post-completion rejection in an async generator).
+                // Chunks are already delivered to the caller and cannot be recalled.
+                // Swallow the phase-3 error and log a warning — matches apcore-python
+                // executor.py:920 which emits an ApCoreEvent("apcore.stream.post_validation_failed")
+                // and does NOT re-raise (sync finding A-D-012).
+                // TODO: emit ApCoreEvent via injected EventEmitter when Executor gains
+                // an optional eventEmitter constructor field (pending architectural wiring).
                 const ctxObj = pipeCtx.context;
-                const wrapped = propagateError(exc, moduleId, ctxObj);
-                if (pipeCtx.executedMiddlewares && pipeCtx.executedMiddlewares.length > 0) {
-                    this._middlewareManager.executeOnError(moduleId, pipeCtx.inputs, wrapped, ctxObj, pipeCtx.executedMiddlewares);
-                }
-                throw wrapped;
+                const unwrappedPost = exc instanceof PipelineStepError ? (exc.cause instanceof Error ? exc.cause : exc) : exc;
+                const wrapped = propagateError(unwrappedPost, moduleId, ctxObj);
+                // Sync finding A-D-011: phase-3 errors must NOT invoke middleware
+                // `on_error` once chunks have already been yielded. The middleware
+                // recovery contract is "produce a recovery output before any output is
+                // visible"; running on_error after partial-output emission breaks that
+                // contract. apcore-python and apcore-rust only log/emit at this point;
+                // TS now matches.
+                console.warn(`[apcore:executor] stream phase-3 failure for '${moduleId}' (chunks already delivered): ${wrapped.message}`);
+                // Do not rethrow — phase-3 errors are swallowed per spec.
             }
         }
     }
@@ -427,7 +500,8 @@ export class Executor {
         // Check 0: module_id format (before pipeline)
         if (!MODULE_ID_PATTERN.test(moduleId)) {
             checks.push({
-                check: 'module_id', passed: false,
+                check: 'module_id',
+                passed: false,
                 error: { code: 'INVALID_INPUT', message: `Invalid module ID: "${moduleId}"` },
             });
             return createPreflightResult(checks);
@@ -459,10 +533,17 @@ export class Executor {
                 trace = e.pipelineTrace;
             }
             else {
-                const errorDict = (e instanceof ModuleError)
-                    ? { code: e.code, message: e.message }
-                    : { code: e.constructor?.name ?? 'Error', message: String(e) };
-                const code = (e instanceof ModuleError) ? e.code : e.constructor?.name ?? 'Error';
+                // Unwrap PipelineStepError to expose the original typed cause (§1.1).
+                const underlying = e instanceof PipelineStepError ? (e.cause instanceof Error ? e.cause : e) : e;
+                const errorDict = underlying instanceof ModuleError
+                    ? { code: underlying.code, message: underlying.message }
+                    : {
+                        code: underlying.constructor?.name ?? 'Error',
+                        message: String(underlying),
+                    };
+                const code = underlying instanceof ModuleError
+                    ? underlying.code
+                    : (underlying.constructor?.name ?? 'Error');
                 let checkName;
                 if (code === 'MODULE_NOT_FOUND')
                     checkName = 'module_lookup';
@@ -470,7 +551,9 @@ export class Executor {
                     checkName = 'acl';
                 else if (code === 'SCHEMA_VALIDATION_ERROR' || code === 'INVALID_INPUT')
                     checkName = 'schema';
-                else if (code === 'CALL_DEPTH_EXCEEDED' || code === 'CIRCULAR_CALL' || code === 'CALL_FREQUENCY_EXCEEDED')
+                else if (code === 'CALL_DEPTH_EXCEEDED' ||
+                    code === 'CIRCULAR_CALL' ||
+                    code === 'CALL_FREQUENCY_EXCEEDED')
                     checkName = 'call_chain';
                 else
                     checkName = 'unknown';
@@ -511,7 +594,45 @@ export class Executor {
                 }
             }
         }
-        return createPreflightResult(checks, requiresApproval);
+        // Module-level preview() (optional, RFC `rfc-preview-method.md` — Draft / RFC).
+        // Invoked only after the standard validation pipeline has been processed.
+        // Returning null is equivalent to omitting the method. Exceptions (sync
+        // throws or async rejections) are treated as advisory warnings and do NOT
+        // fail validation, mirroring `preflight()` semantics (RFC Open Question 1).
+        let predictedChanges;
+        if (pipeCtx.module != null) {
+            const mod = pipeCtx.module;
+            const modWithPreview = mod;
+            if (typeof modWithPreview.preview === 'function') {
+                try {
+                    const raw = modWithPreview.preview(effectiveInputs, pipeCtx.context);
+                    // Support both sync and async preview() implementations.
+                    const result = raw != null && typeof raw.then === 'function'
+                        ? await raw
+                        : raw;
+                    if (result != null && Array.isArray(result.changes) && result.changes.length > 0) {
+                        predictedChanges = result.changes;
+                        checks.push({ check: 'module_preview', passed: true });
+                    }
+                    else {
+                        // Method present but returned null / empty — record the no-op
+                        // check so consumers can distinguish "module has preview()" from
+                        // "module does not implement preview()" if desired.
+                        checks.push({ check: 'module_preview', passed: true });
+                    }
+                }
+                catch (exc) {
+                    const excName = exc instanceof Error ? exc.constructor.name : 'Error';
+                    const excMsg = exc instanceof Error ? exc.message : String(exc);
+                    checks.push({
+                        check: 'module_preview',
+                        passed: true,
+                        warnings: [`preview() raised ${excName}: ${excMsg}`],
+                    });
+                }
+            }
+        }
+        return createPreflightResult(checks, requiresApproval, predictedChanges);
     }
     /** Map pipeline step names to PreflightResult check names. */
     static _STEP_TO_CHECK = {