apcore-js 0.15.0 → 0.16.0

package/dist/builtin-steps.js

@@ -0,0 +1,582 @@
+/**
+ * Built-in pipeline steps extracted from the executor's hardcoded logic.
+ *
+ * Each class implements the Step interface and wraps one phase of the
+ * execution pipeline.  Dependencies are injected via the constructor so
+ * that each step is independently testable.
+ */
+import { Kind } from '@sinclair/typebox';
+import { Value } from '@sinclair/typebox/value';
+import { jsonSchemaToTypeBox } from './schema/loader.js';
+import { createApprovalRequest } from './approval.js';
+import { Context } from './context.js';
+import { ExecutionCancelledError } from './cancel.js';
+import { ModuleTimeoutError, SchemaValidationError, } from './errors.js';
+import { MiddlewareChainError } from './middleware/manager.js';
+import { guardCallChain } from './utils/call-chain.js';
+import { DEFAULT_ANNOTATIONS } from './module.js';
+import { ExecutionStrategy } from './pipeline.js';
+import { redactSensitive, CTX_GLOBAL_DEADLINE, CTX_TRACING_SPANS } from './executor.js';
+// ---------------------------------------------------------------------------
+// Helpers (shared with executor, kept minimal)
+// ---------------------------------------------------------------------------
+function resolveSchema(mod, key) {
+    const schema = mod[key];
+    if (schema == null)
+        return null;
+    if (Kind in schema)
+        return schema;
+    const converted = jsonSchemaToTypeBox(schema);
+    mod[key] = converted;
+    return converted;
+}
+function 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);
+}
+function needsApproval(mod) {
+    const annotations = mod['annotations'];
+    if (annotations == null)
+        return false;
+    if (typeof annotations !== 'object')
+        return false;
+    if ('requiresApproval' in annotations) {
+        return Boolean(annotations.requiresApproval);
+    }
+    if ('requires_approval' in annotations) {
+        return Boolean(annotations['requires_approval']);
+    }
+    return false;
+}
+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),
+        cacheable: Boolean(dict['cacheable'] ?? false),
+        cacheTtl: Number(dict['cacheTtl'] ?? dict['cache_ttl'] ?? 0),
+        cacheKeyFields: (dict['cacheKeyFields'] ?? dict['cache_key_fields'] ?? null),
+        paginated: Boolean(dict['paginated'] ?? false),
+        paginationStyle: (dict['paginationStyle'] ?? dict['pagination_style'] ?? 'cursor'),
+        extra: Object.freeze(dict['extra'] ?? {}),
+    };
+}
+// ---------------------------------------------------------------------------
+// 1. BuiltinContextCreation
+// ---------------------------------------------------------------------------
+/** Creates or inherits execution Context and sets the global deadline. */
+export class BuiltinContextCreation {
+    name = 'builtin.context_creation';
+    description = 'Create or inherit execution context and set global deadline';
+    removable = false;
+    replaceable = false;
+    _globalTimeout;
+    constructor(config) {
+        if (config !== null) {
+            this._globalTimeout = config.get('executor.global_timeout') ?? 60000;
+        }
+        else {
+            this._globalTimeout = 60000;
+        }
+    }
+    async execute(ctx) {
+        // If no context provided, create a fresh one
+        if (ctx.context == null) {
+            ctx.context = Context.create(null).child(ctx.moduleId);
+        }
+        // Set global deadline on root call only
+        if (!(CTX_GLOBAL_DEADLINE in ctx.context.data) && this._globalTimeout > 0) {
+            ctx.context.data[CTX_GLOBAL_DEADLINE] = Date.now() + this._globalTimeout;
+        }
+        return { action: 'continue' };
+    }
+}
+// ---------------------------------------------------------------------------
+// 2. BuiltinSafetyCheck
+// ---------------------------------------------------------------------------
+/** Validates call chain depth, repeat limits, and cancel token. */
+export class BuiltinSafetyCheck {
+    name = 'builtin.safety_check';
+    description = 'Call chain guard: depth, repeat limits, cancel token';
+    removable = true;
+    replaceable = true;
+    _maxCallDepth;
+    _maxModuleRepeat;
+    constructor(config) {
+        if (config !== null) {
+            this._maxCallDepth = config.get('executor.max_call_depth') ?? 32;
+            this._maxModuleRepeat = config.get('executor.max_module_repeat') ?? 3;
+        }
+        else {
+            this._maxCallDepth = 32;
+            this._maxModuleRepeat = 3;
+        }
+    }
+    async execute(ctx) {
+        // Check cancel token first
+        if (ctx.context.cancelToken !== null) {
+            try {
+                ctx.context.cancelToken.check();
+            }
+            catch (e) {
+                if (e instanceof ExecutionCancelledError) {
+                    return {
+                        action: 'abort',
+                        explanation: `Execution cancelled: ${e.message}`,
+                    };
+                }
+                throw e;
+            }
+        }
+        // Call chain safety guard
+        try {
+            guardCallChain(ctx.moduleId, ctx.context.callChain, this._maxCallDepth, this._maxModuleRepeat);
+        }
+        catch (e) {
+            return {
+                action: 'abort',
+                explanation: e instanceof Error ? e.message : String(e),
+            };
+        }
+        return { action: 'continue' };
+    }
+}
+// ---------------------------------------------------------------------------
+// 3. BuiltinModuleLookup
+// ---------------------------------------------------------------------------
+/** Resolves the module from the registry and sets ctx.module. */
+export class BuiltinModuleLookup {
+    name = 'builtin.module_lookup';
+    description = 'Resolve module from registry';
+    removable = false;
+    replaceable = false;
+    _registry;
+    constructor(registry) {
+        this._registry = registry;
+    }
+    async execute(ctx) {
+        const mod = this._registry.get(ctx.moduleId);
+        if (mod === null) {
+            return {
+                action: 'abort',
+                explanation: `Module not found: ${ctx.moduleId}`,
+            };
+        }
+        ctx.module = mod;
+        return { action: 'continue' };
+    }
+}
+// ---------------------------------------------------------------------------
+// 4. BuiltinACLCheck
+// ---------------------------------------------------------------------------
+/** Enforces access control via the ACL provider. */
+export class BuiltinACLCheck {
+    name = 'builtin.acl_check';
+    description = 'Access control list enforcement';
+    removable = true;
+    replaceable = true;
+    _acl;
+    constructor(acl) {
+        this._acl = acl;
+    }
+    async execute(ctx) {
+        if (this._acl === null) {
+            return { action: 'continue' };
+        }
+        const allowed = this._acl.check(ctx.context.callerId, ctx.moduleId, ctx.context);
+        if (!allowed) {
+            return {
+                action: 'abort',
+                explanation: `Access denied: ${ctx.context.callerId} -> ${ctx.moduleId}`,
+            };
+        }
+        return { action: 'continue' };
+    }
+}
+// ---------------------------------------------------------------------------
+// 5. BuiltinApprovalGate
+// ---------------------------------------------------------------------------
+/** Handles approval flow for modules that require explicit approval. */
+export class BuiltinApprovalGate {
+    name = 'builtin.approval_gate';
+    description = 'Approval handler flow';
+    removable = true;
+    replaceable = true;
+    _handler;
+    constructor(handler) {
+        this._handler = handler;
+    }
+    async execute(ctx) {
+        if (this._handler === null) {
+            return { action: 'continue' };
+        }
+        const mod = ctx.module;
+        if (!needsApproval(mod)) {
+            return { action: 'continue' };
+        }
+        let result;
+        let cleanInputs = ctx.inputs;
+        if ('_approval_token' in ctx.inputs) {
+            const token = ctx.inputs['_approval_token'];
+            const { _approval_token: _, ...rest } = ctx.inputs;
+            cleanInputs = rest;
+            result = await this._handler.checkApproval(token);
+        }
+        else {
+            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;
+            }
+            const request = createApprovalRequest({
+                moduleId: ctx.moduleId,
+                arguments: ctx.inputs,
+                context: ctx.context,
+                annotations: ann,
+                description: mod['description'] ?? null,
+                tags: mod['tags'] ?? [],
+            });
+            result = await this._handler.requestApproval(request);
+        }
+        // Emit audit event
+        const spansStack = ctx.context.data[CTX_TRACING_SPANS];
+        if (spansStack && spansStack.length > 0) {
+            spansStack[spansStack.length - 1].events.push({
+                name: 'approval_decision',
+                module_id: ctx.moduleId,
+                status: result.status,
+                approved_by: result.approvedBy ?? '',
+                reason: result.reason ?? '',
+                approval_id: result.approvalId ?? '',
+            });
+        }
+        if (result.status === 'approved') {
+            ctx.inputs = cleanInputs;
+            return { action: 'continue' };
+        }
+        if (result.status === 'timeout') {
+            return {
+                action: 'abort',
+                explanation: `Approval timed out for module ${ctx.moduleId}`,
+            };
+        }
+        if (result.status === 'pending') {
+            return {
+                action: 'abort',
+                explanation: `Approval pending for module ${ctx.moduleId}: ${result.approvalId ?? 'unknown'}`,
+            };
+        }
+        // rejected or unknown
+        return {
+            action: 'abort',
+            explanation: `Approval denied for module ${ctx.moduleId}: ${result.reason ?? 'no reason'}`,
+        };
+    }
+}
+// ---------------------------------------------------------------------------
+// 6. BuiltinInputValidation
+// ---------------------------------------------------------------------------
+/** Validates inputs against module schema and redacts sensitive fields. */
+export class BuiltinInputValidation {
+    name = 'builtin.input_validation';
+    description = 'Schema validation and redaction for inputs';
+    removable = true;
+    replaceable = true;
+    async execute(ctx) {
+        const mod = ctx.module;
+        const inputSchema = resolveSchema(mod, 'inputSchema');
+        if (inputSchema == null) {
+            ctx.validatedInputs = ctx.inputs;
+            return { action: 'continue' };
+        }
+        try {
+            validateSchema(inputSchema, ctx.inputs, 'Input');
+        }
+        catch (e) {
+            if (e instanceof SchemaValidationError) {
+                return {
+                    action: 'abort',
+                    explanation: e.message,
+                };
+            }
+            throw e;
+        }
+        ctx.context.redactedInputs = redactSensitive(ctx.inputs, inputSchema);
+        ctx.validatedInputs = ctx.inputs;
+        return { action: 'continue' };
+    }
+}
+// ---------------------------------------------------------------------------
+// 7. BuiltinMiddlewareBefore
+// ---------------------------------------------------------------------------
+/** Executes before-middleware chain via MiddlewareManager. */
+export class BuiltinMiddlewareBefore {
+    name = 'builtin.middleware_before';
+    description = 'Execute before-middleware chain';
+    removable = true;
+    replaceable = false;
+    _middlewareManager;
+    constructor(middlewares) {
+        this._middlewareManager = middlewares;
+    }
+    async execute(ctx) {
+        try {
+            const [effectiveInputs] = this._middlewareManager.executeBefore(ctx.moduleId, ctx.inputs, ctx.context);
+            ctx.inputs = effectiveInputs;
+        }
+        catch (e) {
+            if (e instanceof MiddlewareChainError) {
+                return {
+                    action: 'abort',
+                    explanation: `Middleware before-chain error: ${e.original.message}`,
+                };
+            }
+            throw e;
+        }
+        return { action: 'continue' };
+    }
+}
+// ---------------------------------------------------------------------------
+// 8. BuiltinExecute
+// ---------------------------------------------------------------------------
+/** Executes the module with timeout enforcement. Sets ctx.output. */
+export class BuiltinExecute {
+    name = 'builtin.execute';
+    description = 'Execute module with timeout';
+    removable = false;
+    replaceable = true;
+    _defaultTimeout;
+    constructor(config) {
+        if (config !== null) {
+            this._defaultTimeout = config.get('executor.default_timeout') ?? 30000;
+        }
+        else {
+            this._defaultTimeout = 30000;
+        }
+    }
+    async execute(ctx) {
+        const mod = ctx.module;
+        // Cancel check before execution
+        if (ctx.context.cancelToken !== null) {
+            try {
+                ctx.context.cancelToken.check();
+            }
+            catch (e) {
+                if (e instanceof ExecutionCancelledError) {
+                    return {
+                        action: 'abort',
+                        explanation: `Execution cancelled: ${e.message}`,
+                    };
+                }
+                throw e;
+            }
+        }
+        // Streaming path: store the generator on ctx.outputStream
+        if (ctx.stream) {
+            const streamFn = mod['stream'];
+            if (typeof streamFn === 'function') {
+                ctx.outputStream = streamFn.call(mod, ctx.inputs, ctx.context);
+                return { action: 'continue' };
+            }
+            // fallback: execute normally and wrap as single-chunk
+        }
+        // Regular execution with timeout
+        let timeoutMs = this._defaultTimeout;
+        const globalDeadline = ctx.context.data[CTX_GLOBAL_DEADLINE];
+        if (globalDeadline !== undefined) {
+            const remaining = globalDeadline - Date.now();
+            if (remaining <= 0) {
+                return {
+                    action: 'abort',
+                    explanation: `Module timed out: ${ctx.moduleId} (global deadline exceeded)`,
+                };
+            }
+            if (timeoutMs === 0 || remaining < timeoutMs) {
+                timeoutMs = remaining;
+            }
+        }
+        const executeFn = mod['execute'];
+        if (typeof executeFn !== 'function') {
+            return {
+                action: 'abort',
+                explanation: `Module '${ctx.moduleId}' has no execute method`,
+            };
+        }
+        const executionPromise = Promise.resolve(executeFn
+            .call(mod, ctx.inputs, ctx.context));
+        try {
+            if (timeoutMs === 0) {
+                ctx.output = await executionPromise;
+            }
+            else {
+                let timer;
+                const timeoutPromise = new Promise((_, reject) => {
+                    timer = setTimeout(() => {
+                        reject(new ModuleTimeoutError(ctx.moduleId, timeoutMs));
+                    }, timeoutMs);
+                });
+                ctx.output = await Promise.race([executionPromise, timeoutPromise]).finally(() => {
+                    clearTimeout(timer);
+                });
+            }
+        }
+        catch (e) {
+            if (e instanceof ModuleTimeoutError) {
+                return {
+                    action: 'abort',
+                    explanation: `Module timed out: ${ctx.moduleId} (${timeoutMs}ms)`,
+                };
+            }
+            throw e;
+        }
+        return { action: 'continue' };
+    }
+}
+// ---------------------------------------------------------------------------
+// 9. BuiltinOutputValidation
+// ---------------------------------------------------------------------------
+/** Validates output against module schema and redacts sensitive fields. */
+export class BuiltinOutputValidation {
+    name = 'builtin.output_validation';
+    description = 'Schema validation and redaction for output';
+    removable = true;
+    replaceable = true;
+    async execute(ctx) {
+        const mod = ctx.module;
+        const output = ctx.output ?? {};
+        const outputSchema = resolveSchema(mod, 'outputSchema');
+        if (outputSchema == null) {
+            ctx.validatedOutput = output;
+            return { action: 'continue' };
+        }
+        try {
+            validateSchema(outputSchema, output, 'Output');
+        }
+        catch (e) {
+            if (e instanceof SchemaValidationError) {
+                return {
+                    action: 'abort',
+                    explanation: e.message,
+                };
+            }
+            throw e;
+        }
+        ctx.validatedOutput = output;
+        return { action: 'continue' };
+    }
+}
+// ---------------------------------------------------------------------------
+// 10. BuiltinMiddlewareAfter
+// ---------------------------------------------------------------------------
+/** Executes after-middleware chain via MiddlewareManager. */
+export class BuiltinMiddlewareAfter {
+    name = 'builtin.middleware_after';
+    description = 'Execute after-middleware chain';
+    removable = true;
+    replaceable = false;
+    _middlewareManager;
+    constructor(middlewares) {
+        this._middlewareManager = middlewares;
+    }
+    async execute(ctx) {
+        const output = ctx.output ?? {};
+        const transformed = this._middlewareManager.executeAfter(ctx.moduleId, ctx.inputs, output, ctx.context);
+        ctx.output = transformed;
+        return { action: 'continue' };
+    }
+}
+// ---------------------------------------------------------------------------
+// 11. BuiltinReturnResult
+// ---------------------------------------------------------------------------
+/** Finalizes the pipeline result. Output is already on ctx.output. */
+export class BuiltinReturnResult {
+    name = 'builtin.return_result';
+    description = 'Finalize pipeline result';
+    removable = false;
+    replaceable = false;
+    async execute(_ctx) {
+        // No-op: output is already on ctx.output from previous steps
+        return { action: 'continue' };
+    }
+}
+/** Build the standard 11-step execution strategy matching the current Executor. */
+export function buildStandardStrategy(deps) {
+    return new ExecutionStrategy('standard', [
+        new BuiltinContextCreation(deps.config),
+        new BuiltinSafetyCheck(deps.config),
+        new BuiltinModuleLookup(deps.registry),
+        new BuiltinACLCheck(deps.acl),
+        new BuiltinApprovalGate(deps.approvalHandler),
+        new BuiltinInputValidation(),
+        new BuiltinMiddlewareBefore(deps.middlewareManager),
+        new BuiltinExecute(deps.config),
+        new BuiltinOutputValidation(),
+        new BuiltinMiddlewareAfter(deps.middlewareManager),
+        new BuiltinReturnResult(),
+    ]);
+}
+/**
+ * Build an internal-only strategy: skips ACL and approval gates.
+ * Suitable for trusted internal service-to-service calls.
+ */
+export function buildInternalStrategy(deps) {
+    return new ExecutionStrategy('internal', [
+        new BuiltinContextCreation(deps.config),
+        new BuiltinSafetyCheck(deps.config),
+        new BuiltinModuleLookup(deps.registry),
+        new BuiltinInputValidation(),
+        new BuiltinMiddlewareBefore(deps.middlewareManager),
+        new BuiltinExecute(deps.config),
+        new BuiltinOutputValidation(),
+        new BuiltinMiddlewareAfter(deps.middlewareManager),
+        new BuiltinReturnResult(),
+    ]);
+}
+/**
+ * Build a testing strategy: minimal pipeline with only lookup, execute, and return.
+ * No middleware, no validation, no ACL, no approval. Fast and predictable for tests.
+ */
+export function buildTestingStrategy(deps) {
+    return new ExecutionStrategy('testing', [
+        new BuiltinContextCreation(deps.config),
+        new BuiltinModuleLookup(deps.registry),
+        new BuiltinExecute(deps.config),
+        new BuiltinReturnResult(),
+    ]);
+}
+/**
+ * Build a performance strategy: skips approval gate and output validation.
+ * Retains ACL, input validation, and middleware for correctness where it matters.
+ */
+export function buildPerformanceStrategy(deps) {
+    return new ExecutionStrategy('performance', [
+        new BuiltinContextCreation(deps.config),
+        new BuiltinSafetyCheck(deps.config),
+        new BuiltinModuleLookup(deps.registry),
+        new BuiltinACLCheck(deps.acl),
+        new BuiltinInputValidation(),
+        new BuiltinMiddlewareBefore(deps.middlewareManager),
+        new BuiltinExecute(deps.config),
+        new BuiltinMiddlewareAfter(deps.middlewareManager),
+        new BuiltinReturnResult(),
+    ]);
+}
+//# sourceMappingURL=builtin-steps.js.map

package/dist/builtin-steps.js.map

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

package/dist/config.d.ts

@@ -2,6 +2,35 @@
  * Configuration loading, validation, and environment variable overrides (Algorithm A12).
  * Supports legacy mode (flat YAML) and namespace mode (apcore top-level key).
  */
+export type EnvStyle = 'nested' | 'flat' | 'auto';
+interface NamespaceRegistration {
+    name: string;
+    schema: object | string | null;
+    envPrefix: string;
+    defaults: Record<string, unknown> | null;
+    envStyle: EnvStyle;
+    maxDepth: number;
+    envMap: Record<string, string> | null;
+}
+export declare const _globalNsRegistry: Map<string, NamespaceRegistration>;
+export declare const _globalEnvMap: Map<string, string>;
+export declare const _envMapClaimed: Map<string, string>;
+export declare const _envPrefixUsed: Set<string>;
+export declare function applyEnvOverrides(data: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Apply per-namespace env overrides using longest-prefix-match dispatch.
+ *
+ * For each env var, finds the registered namespace whose envPrefix is the
+ * longest matching prefix, strips it, converts separators, and writes to
+ * that namespace's subtree in data.
+ */
+/**
+ * Convert env var suffix to dot-path with a depth limit.
+ * After max_depth segments, remaining _ are preserved as literal.
+ * Double __ always becomes literal _.
+ */
+export declare function envSuffixToDotPathWithDepth(suffix: string, maxDepth: number): string;
+export declare function applyNamespaceEnvOverrides(data: Record<string, unknown>): Record<string, unknown>;
 /**
  * Search for a config file in the standard discovery order (§9.14).
  * Returns the path of the first found file, or null if none found.
@@ -23,7 +52,8 @@ export declare class Config {
     private _yamlPath;
     private _mode;
     private _mounts;
-    constructor(data?: Record<string, unknown>);
+    private _envStyle;
+    constructor(data?: Record<string, unknown>, envStyle?: EnvStyle);
     /**
      * Register a namespace globally.
      *
@@ -31,14 +61,21 @@ export declare class Config {
      * - ConfigNamespaceReservedError if name is in the reserved set.
      * - ConfigNamespaceDuplicateError if name is already registered.
      * - ConfigEnvPrefixConflictError if envPrefix is already used or matches the
-     *   APCORE_[A-Z0-9] pattern.
+     *   an already-registered prefix.
      */
     static registerNamespace(options: {
         name: string;
         schema?: object | string | null;
         envPrefix?: string | null;
         defaults?: Record<string, unknown> | null;
+        envStyle?: EnvStyle | null;
+        maxDepth?: number | null;
+        envMap?: Record<string, string> | null;
     }): void;
+    /**
+     * Register global bare env var → top-level config key mappings.
+     */
+    static envMap(mapping: Record<string, string>): void;
     /**
      * Return a snapshot of all registered namespaces.
      */
@@ -110,4 +147,5 @@ export declare class Config {
      */
     reload(): void;
 }
+export {};
 //# sourceMappingURL=config.d.ts.map