apcore-js 0.5.0 → 0.7.0

package/dist/executor.js

@@ -0,0 +1,489 @@
+/**
+ * Executor and related utilities for apcore.
+ *
+ * Async-only execution pipeline. Python's call() + call_async() merge into one async call().
+ * Timeout uses Promise.race instead of threading.
+ */
+import { Value } from '@sinclair/typebox/value';
+import { createApprovalRequest } from './approval.js';
+import { Context } from './context.js';
+import { ExecutionCancelledError } from './cancel.js';
+import { ACLDeniedError, ApprovalDeniedError, ApprovalPendingError, ApprovalTimeoutError, CallDepthExceededError, CallFrequencyExceededError, CircularCallError, InvalidInputError, ModuleNotFoundError, ModuleTimeoutError, SchemaValidationError, } from './errors.js';
+import { AfterMiddleware, BeforeMiddleware } from './middleware/index.js';
+import { MiddlewareChainError, MiddlewareManager } from './middleware/manager.js';
+import { DEFAULT_ANNOTATIONS } from './module.js';
+export const REDACTED_VALUE = '***REDACTED***';
+export function redactSensitive(data, schemaDict) {
+    const redacted = JSON.parse(JSON.stringify(data));
+    redactFields(redacted, schemaDict);
+    redactSecretPrefix(redacted);
+    return redacted;
+}
+function redactFields(data, schemaDict) {
+    const properties = schemaDict['properties'];
+    if (!properties)
+        return;
+    for (const [fieldName, fieldSchema] of Object.entries(properties)) {
+        if (!(fieldName in data))
+            continue;
+        const value = data[fieldName];
+        if (fieldSchema['x-sensitive'] === true) {
+            if (value !== null && value !== undefined) {
+                data[fieldName] = REDACTED_VALUE;
+            }
+            continue;
+        }
+        if (fieldSchema['type'] === 'object' && 'properties' in fieldSchema && typeof value === 'object' && value !== null && !Array.isArray(value)) {
+            redactFields(value, fieldSchema);
+            continue;
+        }
+        if (fieldSchema['type'] === 'array' && 'items' in fieldSchema && Array.isArray(value)) {
+            const itemsSchema = fieldSchema['items'];
+            if (itemsSchema['x-sensitive'] === true) {
+                for (let i = 0; i < value.length; i++) {
+                    if (value[i] !== null && value[i] !== undefined) {
+                        value[i] = REDACTED_VALUE;
+                    }
+                }
+            }
+            else if (itemsSchema['type'] === 'object' && 'properties' in itemsSchema) {
+                for (const item of value) {
+                    if (typeof item === 'object' && item !== null) {
+                        redactFields(item, itemsSchema);
+                    }
+                }
+            }
+        }
+    }
+}
+function redactSecretPrefix(data) {
+    for (const key of Object.keys(data)) {
+        const value = data[key];
+        if (key.startsWith('_secret_') && value !== null && value !== undefined) {
+            data[key] = REDACTED_VALUE;
+        }
+        else if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
+            redactSecretPrefix(value);
+        }
+    }
+}
+/**
+ * Normalize a dict-form annotations object into a ModuleAnnotations interface.
+ * Handles both camelCase and snake_case keys (parallel to Python's
+ * ``ModuleAnnotations(**{k: v for k, v in annotations.items() if k in valid_fields})``).
+ */
+function dictToAnnotations(dict) {
+    return {
+        readonly: Boolean(dict['readonly'] ?? false),
+        destructive: Boolean(dict['destructive'] ?? false),
+        idempotent: Boolean(dict['idempotent'] ?? false),
+        requiresApproval: Boolean(dict['requiresApproval'] ?? dict['requires_approval'] ?? false),
+        openWorld: Boolean(dict['openWorld'] ?? dict['open_world'] ?? true),
+        streaming: Boolean(dict['streaming'] ?? false),
+    };
+}
+export class Executor {
+    _registry;
+    _middlewareManager;
+    _acl;
+    _config;
+    _approvalHandler;
+    _defaultTimeout;
+    _maxCallDepth;
+    _maxModuleRepeat;
+    constructor(options) {
+        this._registry = options.registry;
+        this._middlewareManager = new MiddlewareManager();
+        this._acl = options.acl ?? null;
+        this._config = options.config ?? null;
+        this._approvalHandler = options.approvalHandler ?? null;
+        if (options.middlewares) {
+            for (const mw of options.middlewares) {
+                this._middlewareManager.add(mw);
+            }
+        }
+        if (this._config !== null) {
+            this._defaultTimeout = this._config.get('executor.default_timeout') ?? 30000;
+            this._maxCallDepth = this._config.get('executor.max_call_depth') ?? 32;
+            this._maxModuleRepeat = this._config.get('executor.max_module_repeat') ?? 3;
+        }
+        else {
+            this._defaultTimeout = 30000;
+            this._maxCallDepth = 32;
+            this._maxModuleRepeat = 3;
+        }
+    }
+    get registry() {
+        return this._registry;
+    }
+    get middlewares() {
+        return this._middlewareManager.snapshot();
+    }
+    /** Set the access control provider. */
+    setAcl(acl) {
+        this._acl = acl;
+    }
+    /** Set the approval handler for Step 4.5 gate. */
+    setApprovalHandler(handler) {
+        this._approvalHandler = handler;
+    }
+    use(middleware) {
+        this._middlewareManager.add(middleware);
+        return this;
+    }
+    useBefore(callback) {
+        this._middlewareManager.add(new BeforeMiddleware(callback));
+        return this;
+    }
+    useAfter(callback) {
+        this._middlewareManager.add(new AfterMiddleware(callback));
+        return this;
+    }
+    remove(middleware) {
+        return this._middlewareManager.remove(middleware);
+    }
+    async call(moduleId, inputs, context) {
+        let effectiveInputs = inputs ?? {};
+        const ctx = this._createContext(moduleId, context);
+        this._checkSafety(moduleId, ctx);
+        const mod = this._lookupModule(moduleId);
+        this._checkAcl(moduleId, ctx);
+        // Step 4.5 -- Approval Gate
+        await this._checkApproval(mod, moduleId, effectiveInputs, ctx);
+        effectiveInputs = this._validateInputs(mod, effectiveInputs, ctx);
+        return this._executeWithMiddleware(mod, moduleId, effectiveInputs, ctx);
+    }
+    /**
+     * Alias for call(). Provided for compatibility with MCP bridge packages
+     * that may call callAsync() by convention.
+     */
+    async callAsync(moduleId, inputs, context) {
+        return this.call(moduleId, inputs, context);
+    }
+    /**
+     * Streaming execution pipeline. If the module exposes a stream() async generator,
+     * yields each chunk. Otherwise falls back to call() and yields a single chunk.
+     *
+     * Pipeline: context -> safety -> lookup -> ACL -> validate inputs -> before-middleware
+     *   -> stream (or fallback to execute) -> validate accumulated output -> after-middleware
+     *
+     * Note: In the streaming path, after-middleware runs on the accumulated output for
+     * validation/side-effects but its return value is not yielded since chunks were already
+     * emitted. In the non-streaming fallback, after-middleware can transform the output.
+     */
+    async *stream(moduleId, inputs, context) {
+        let effectiveInputs = inputs ?? {};
+        const ctx = this._createContext(moduleId, context);
+        this._checkSafety(moduleId, ctx);
+        const mod = this._lookupModule(moduleId);
+        this._checkAcl(moduleId, ctx);
+        // Step 4.5 -- Approval Gate
+        await this._checkApproval(mod, moduleId, effectiveInputs, ctx);
+        effectiveInputs = this._validateInputs(mod, effectiveInputs, ctx);
+        yield* this._streamWithMiddleware(mod, moduleId, effectiveInputs, ctx);
+    }
+    async *_streamWithMiddleware(mod, moduleId, inputs, ctx) {
+        let effectiveInputs = inputs;
+        let executedMiddlewares = [];
+        try {
+            try {
+                [effectiveInputs, executedMiddlewares] = this._middlewareManager.executeBefore(moduleId, effectiveInputs, ctx);
+            }
+            catch (e) {
+                if (e instanceof MiddlewareChainError) {
+                    executedMiddlewares = e.executedMiddlewares;
+                    const recovery = this._middlewareManager.executeOnError(moduleId, effectiveInputs, e.original, ctx, executedMiddlewares);
+                    if (recovery !== null) {
+                        yield recovery;
+                        return;
+                    }
+                    executedMiddlewares = [];
+                    throw e.original;
+                }
+                throw e;
+            }
+            // Cancel check before execution
+            if (ctx.cancelToken !== null) {
+                ctx.cancelToken.check();
+            }
+            const streamFn = mod['stream'];
+            if (typeof streamFn === 'function') {
+                // Module has a stream() method: iterate and yield each chunk
+                let accumulated = {};
+                for await (const chunk of streamFn.call(mod, effectiveInputs, ctx)) {
+                    accumulated = { ...accumulated, ...chunk };
+                    yield chunk;
+                }
+                // Validate accumulated output against output schema
+                this._validateOutput(mod, accumulated);
+                // Run after-middleware on the accumulated result
+                this._middlewareManager.executeAfter(moduleId, effectiveInputs, accumulated, ctx);
+            }
+            else {
+                // Fallback: execute normally and yield single chunk
+                let output = await this._executeWithTimeout(mod, moduleId, effectiveInputs, ctx);
+                this._validateOutput(mod, output);
+                output = this._middlewareManager.executeAfter(moduleId, effectiveInputs, output, ctx);
+                yield output;
+            }
+        }
+        catch (exc) {
+            if (exc instanceof ExecutionCancelledError)
+                throw exc;
+            if (executedMiddlewares.length > 0) {
+                const recovery = this._middlewareManager.executeOnError(moduleId, effectiveInputs, exc, ctx, executedMiddlewares);
+                if (recovery !== null) {
+                    yield recovery;
+                    return;
+                }
+            }
+            throw exc;
+        }
+    }
+    _createContext(moduleId, context) {
+        if (context == null) {
+            return Context.create(this).child(moduleId);
+        }
+        return context.child(moduleId);
+    }
+    _lookupModule(moduleId) {
+        const module = this._registry.get(moduleId);
+        if (module === null) {
+            throw new ModuleNotFoundError(moduleId);
+        }
+        return module;
+    }
+    _checkAcl(moduleId, ctx) {
+        if (this._acl !== null) {
+            const allowed = this._acl.check(ctx.callerId, moduleId, ctx);
+            if (!allowed) {
+                throw new ACLDeniedError(ctx.callerId, moduleId);
+            }
+        }
+    }
+    _validateInputs(mod, inputs, ctx) {
+        const inputSchema = mod['inputSchema'];
+        if (inputSchema == null)
+            return inputs;
+        this._validateSchema(inputSchema, inputs, 'Input');
+        ctx.redactedInputs = redactSensitive(inputs, inputSchema);
+        return inputs;
+    }
+    _validateSchema(schema, data, direction) {
+        if (Value.Check(schema, data))
+            return;
+        const errors = [];
+        for (const error of Value.Errors(schema, data)) {
+            errors.push({
+                field: error.path || '/',
+                code: String(error.type),
+                message: error.message,
+            });
+        }
+        throw new SchemaValidationError(`${direction} validation failed`, errors);
+    }
+    async _executeWithMiddleware(mod, moduleId, inputs, ctx) {
+        let effectiveInputs = inputs;
+        let executedMiddlewares = [];
+        try {
+            try {
+                [effectiveInputs, executedMiddlewares] = this._middlewareManager.executeBefore(moduleId, effectiveInputs, ctx);
+            }
+            catch (e) {
+                if (e instanceof MiddlewareChainError) {
+                    executedMiddlewares = e.executedMiddlewares;
+                    const recovery = this._middlewareManager.executeOnError(moduleId, effectiveInputs, e.original, ctx, executedMiddlewares);
+                    if (recovery !== null)
+                        return recovery;
+                    executedMiddlewares = [];
+                    throw e.original;
+                }
+                throw e;
+            }
+            // Cancel check before execution
+            if (ctx.cancelToken !== null) {
+                ctx.cancelToken.check();
+            }
+            let output = await this._executeWithTimeout(mod, moduleId, effectiveInputs, ctx);
+            this._validateOutput(mod, output);
+            output = this._middlewareManager.executeAfter(moduleId, effectiveInputs, output, ctx);
+            return output;
+        }
+        catch (exc) {
+            if (exc instanceof ExecutionCancelledError)
+                throw exc;
+            if (executedMiddlewares.length > 0) {
+                const recovery = this._middlewareManager.executeOnError(moduleId, effectiveInputs, exc, ctx, executedMiddlewares);
+                if (recovery !== null)
+                    return recovery;
+            }
+            throw exc;
+        }
+    }
+    _validateOutput(mod, output) {
+        const outputSchema = mod['outputSchema'];
+        if (outputSchema != null) {
+            this._validateSchema(outputSchema, output, 'Output');
+        }
+    }
+    validate(moduleId, inputs) {
+        const module = this._registry.get(moduleId);
+        if (module === null) {
+            throw new ModuleNotFoundError(moduleId);
+        }
+        const mod = module;
+        const inputSchema = mod['inputSchema'];
+        if (inputSchema == null) {
+            return { valid: true, errors: [] };
+        }
+        if (Value.Check(inputSchema, inputs)) {
+            return { valid: true, errors: [] };
+        }
+        const errors = [];
+        for (const error of Value.Errors(inputSchema, inputs)) {
+            errors.push({
+                field: error.path || '/',
+                code: String(error.type),
+                message: error.message,
+            });
+        }
+        return { valid: false, errors };
+    }
+    _checkSafety(moduleId, ctx) {
+        const callChain = ctx.callChain;
+        // Depth check
+        if (callChain.length > this._maxCallDepth) {
+            throw new CallDepthExceededError(callChain.length, this._maxCallDepth, [...callChain]);
+        }
+        // Circular detection (strict cycles of length >= 2)
+        const priorChain = callChain.slice(0, -1);
+        const lastIdx = priorChain.lastIndexOf(moduleId);
+        if (lastIdx !== -1) {
+            const subsequence = priorChain.slice(lastIdx + 1);
+            if (subsequence.length > 0) {
+                throw new CircularCallError(moduleId, [...callChain]);
+            }
+        }
+        // Frequency check
+        const count = callChain.filter((id) => id === moduleId).length;
+        if (count > this._maxModuleRepeat) {
+            throw new CallFrequencyExceededError(moduleId, count, this._maxModuleRepeat, [...callChain]);
+        }
+    }
+    /** Check if a module requires approval, handling both interface and dict annotations. */
+    _needsApproval(mod) {
+        const annotations = mod['annotations'];
+        if (annotations == null)
+            return false;
+        if (typeof annotations !== 'object')
+            return false;
+        // ModuleAnnotations interface (camelCase)
+        if ('requiresApproval' in annotations) {
+            return Boolean(annotations.requiresApproval);
+        }
+        // Dict-form annotations (snake_case)
+        if ('requires_approval' in annotations) {
+            return Boolean(annotations['requires_approval']);
+        }
+        return false;
+    }
+    /** Build an ApprovalRequest from module metadata. */
+    _buildApprovalRequest(mod, moduleId, inputs, ctx) {
+        const annotations = mod['annotations'];
+        let ann;
+        if (annotations != null && typeof annotations === 'object' && 'requiresApproval' in annotations) {
+            ann = annotations;
+        }
+        else if (annotations != null && typeof annotations === 'object') {
+            ann = dictToAnnotations(annotations);
+        }
+        else {
+            ann = DEFAULT_ANNOTATIONS;
+        }
+        return createApprovalRequest({
+            moduleId,
+            arguments: inputs,
+            context: ctx,
+            annotations: ann,
+            description: mod['description'] ?? null,
+            tags: mod['tags'] ?? [],
+        });
+    }
+    /** Map an ApprovalResult status to the appropriate action or error. */
+    _handleApprovalResult(result, moduleId) {
+        if (result.status === 'approved')
+            return;
+        if (result.status === 'rejected') {
+            throw new ApprovalDeniedError(result, moduleId);
+        }
+        if (result.status === 'timeout') {
+            throw new ApprovalTimeoutError(result, moduleId);
+        }
+        if (result.status === 'pending') {
+            throw new ApprovalPendingError(result, moduleId);
+        }
+        // Unknown status treated as denied
+        console.warn(`[apcore:executor] Unknown approval status '${result.status}' for module ${moduleId}, treating as denied`);
+        throw new ApprovalDeniedError(result, moduleId);
+    }
+    /** Emit an audit event for the approval decision (logging + span event). */
+    _emitApprovalEvent(result, moduleId, ctx) {
+        console.info(`[apcore:executor] Approval decision: module=${moduleId} status=${result.status} approved_by=${result.approvedBy} reason=${result.reason}`);
+        const spansStack = ctx.data['_tracing_spans'];
+        if (spansStack && spansStack.length > 0) {
+            spansStack[spansStack.length - 1].events.push({
+                name: 'approval_decision',
+                module_id: moduleId,
+                status: result.status,
+                approved_by: result.approvedBy ?? '',
+                reason: result.reason ?? '',
+                approval_id: result.approvalId ?? '',
+            });
+        }
+    }
+    /** Step 4.5: Approval gate. */
+    async _checkApproval(mod, moduleId, inputs, ctx) {
+        if (this._approvalHandler === null)
+            return;
+        if (!this._needsApproval(mod))
+            return;
+        let result;
+        if ('_approval_token' in inputs) {
+            const token = inputs['_approval_token'];
+            delete inputs['_approval_token'];
+            result = await this._approvalHandler.checkApproval(token);
+        }
+        else {
+            const request = this._buildApprovalRequest(mod, moduleId, inputs, ctx);
+            result = await this._approvalHandler.requestApproval(request);
+        }
+        this._emitApprovalEvent(result, moduleId, ctx);
+        this._handleApprovalResult(result, moduleId);
+    }
+    async _executeWithTimeout(mod, moduleId, inputs, ctx) {
+        const timeoutMs = this._defaultTimeout;
+        if (timeoutMs < 0) {
+            throw new InvalidInputError(`Negative timeout: ${timeoutMs}ms`);
+        }
+        const executeFn = mod['execute'];
+        if (typeof executeFn !== 'function') {
+            throw new InvalidInputError(`Module '${moduleId}' has no execute method`);
+        }
+        const executionPromise = Promise.resolve(executeFn
+            .call(mod, inputs, ctx));
+        if (timeoutMs === 0) {
+            console.warn('[apcore:executor] Timeout is 0, timeout limit disabled');
+            return executionPromise;
+        }
+        let timer;
+        const timeoutPromise = new Promise((_, reject) => {
+            timer = setTimeout(() => {
+                reject(new ModuleTimeoutError(moduleId, timeoutMs));
+            }, timeoutMs);
+        });
+        return Promise.race([executionPromise, timeoutPromise]).finally(() => {
+            clearTimeout(timer);
+        });
+    }
+}
+//# sourceMappingURL=executor.js.map

package/dist/executor.js.map

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

package/dist/extensions.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Extension point framework for apcore.
+ *
+ * Provides a centralized mechanism to register, query, and wire custom
+ * extensions (discoverers, middleware, ACL providers, span exporters, and
+ * module validators) into the apcore runtime.
+ */
+import type { Executor } from './executor.js';
+import type { Registry } from './registry/registry.js';
+/**
+ * Describes a named slot where extensions can be registered.
+ */
+export interface ExtensionPoint {
+    readonly name: string;
+    readonly description: string;
+    readonly multiple: boolean;
+}
+/**
+ * Manages extension points and their registered implementations.
+ *
+ * Pre-registers six built-in extension points: discoverer, middleware,
+ * acl, span_exporter, module_validator, and approval_handler.
+ */
+export declare class ExtensionManager {
+    private _points;
+    private _extensions;
+    constructor();
+    /**
+     * Register an extension for the given extension point.
+     *
+     * @throws Error if point_name is unknown.
+     * @throws Error if extension does not satisfy the type constraint.
+     */
+    register(pointName: string, extension: unknown): void;
+    /**
+     * Return the single extension for a non-multiple point, or null.
+     */
+    get(pointName: string): unknown | null;
+    /**
+     * Return all extensions for a multiple-type point.
+     */
+    getAll(pointName: string): unknown[];
+    /**
+     * Remove a specific extension from an extension point.
+     * Returns true if found and removed, false otherwise.
+     */
+    unregister(pointName: string, extension: unknown): boolean;
+    /**
+     * Return all registered extension points.
+     */
+    listPoints(): ExtensionPoint[];
+    /**
+     * Wire all registered extensions into the given registry and executor.
+     */
+    apply(registry: Registry, executor: Executor): void;
+    private _findTracingMiddleware;
+}
+//# sourceMappingURL=extensions.d.ts.map

package/dist/extensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensions.d.ts","sourceRoot":"","sources":["../src/extensions.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAI9C,OAAO,KAAK,EAA+B,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAuBpF;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AA0FD;;;;;GAKG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,OAAO,CAAsC;IACrD,OAAO,CAAC,WAAW,CAAyB;;IAU5C;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,IAAI;IAqBrD;;OAEG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI;IAQtC;;OAEG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,EAAE;IAOpC;;;OAGG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,OAAO;IAW1D;;OAEG;IACH,UAAU,IAAI,cAAc,EAAE;IAQ9B;;OAEG;IACH,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAgDnD,OAAO,CAAC,sBAAsB;CAQ/B"}