apcore-js 0.15.1 → 0.16.0

package/dist/builtin-steps.d.ts

@@ -0,0 +1,144 @@
+/**
+ * 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 type { ACL } from './acl.js';
+import type { ApprovalHandler } from './approval.js';
+import type { Config } from './config.js';
+import { MiddlewareManager } from './middleware/manager.js';
+import type { Registry } from './registry/registry.js';
+import type { Step, StepResult, PipelineContext } from './pipeline.js';
+import { ExecutionStrategy } from './pipeline.js';
+/** Creates or inherits execution Context and sets the global deadline. */
+export declare class BuiltinContextCreation implements Step {
+    readonly name = "builtin.context_creation";
+    readonly description = "Create or inherit execution context and set global deadline";
+    readonly removable = false;
+    readonly replaceable = false;
+    private _globalTimeout;
+    constructor(config: Config | null);
+    execute(ctx: PipelineContext): Promise<StepResult>;
+}
+/** Validates call chain depth, repeat limits, and cancel token. */
+export declare class BuiltinSafetyCheck implements Step {
+    readonly name = "builtin.safety_check";
+    readonly description = "Call chain guard: depth, repeat limits, cancel token";
+    readonly removable = true;
+    readonly replaceable = true;
+    private _maxCallDepth;
+    private _maxModuleRepeat;
+    constructor(config: Config | null);
+    execute(ctx: PipelineContext): Promise<StepResult>;
+}
+/** Resolves the module from the registry and sets ctx.module. */
+export declare class BuiltinModuleLookup implements Step {
+    readonly name = "builtin.module_lookup";
+    readonly description = "Resolve module from registry";
+    readonly removable = false;
+    readonly replaceable = false;
+    private _registry;
+    constructor(registry: Registry);
+    execute(ctx: PipelineContext): Promise<StepResult>;
+}
+/** Enforces access control via the ACL provider. */
+export declare class BuiltinACLCheck implements Step {
+    readonly name = "builtin.acl_check";
+    readonly description = "Access control list enforcement";
+    readonly removable = true;
+    readonly replaceable = true;
+    private _acl;
+    constructor(acl: ACL | null);
+    execute(ctx: PipelineContext): Promise<StepResult>;
+}
+/** Handles approval flow for modules that require explicit approval. */
+export declare class BuiltinApprovalGate implements Step {
+    readonly name = "builtin.approval_gate";
+    readonly description = "Approval handler flow";
+    readonly removable = true;
+    readonly replaceable = true;
+    private _handler;
+    constructor(handler: ApprovalHandler | null);
+    execute(ctx: PipelineContext): Promise<StepResult>;
+}
+/** Validates inputs against module schema and redacts sensitive fields. */
+export declare class BuiltinInputValidation implements Step {
+    readonly name = "builtin.input_validation";
+    readonly description = "Schema validation and redaction for inputs";
+    readonly removable = true;
+    readonly replaceable = true;
+    execute(ctx: PipelineContext): Promise<StepResult>;
+}
+/** Executes before-middleware chain via MiddlewareManager. */
+export declare class BuiltinMiddlewareBefore implements Step {
+    readonly name = "builtin.middleware_before";
+    readonly description = "Execute before-middleware chain";
+    readonly removable = true;
+    readonly replaceable = false;
+    private _middlewareManager;
+    constructor(middlewares: MiddlewareManager);
+    execute(ctx: PipelineContext): Promise<StepResult>;
+}
+/** Executes the module with timeout enforcement. Sets ctx.output. */
+export declare class BuiltinExecute implements Step {
+    readonly name = "builtin.execute";
+    readonly description = "Execute module with timeout";
+    readonly removable = false;
+    readonly replaceable = true;
+    private _defaultTimeout;
+    constructor(config: Config | null);
+    execute(ctx: PipelineContext): Promise<StepResult>;
+}
+/** Validates output against module schema and redacts sensitive fields. */
+export declare class BuiltinOutputValidation implements Step {
+    readonly name = "builtin.output_validation";
+    readonly description = "Schema validation and redaction for output";
+    readonly removable = true;
+    readonly replaceable = true;
+    execute(ctx: PipelineContext): Promise<StepResult>;
+}
+/** Executes after-middleware chain via MiddlewareManager. */
+export declare class BuiltinMiddlewareAfter implements Step {
+    readonly name = "builtin.middleware_after";
+    readonly description = "Execute after-middleware chain";
+    readonly removable = true;
+    readonly replaceable = false;
+    private _middlewareManager;
+    constructor(middlewares: MiddlewareManager);
+    execute(ctx: PipelineContext): Promise<StepResult>;
+}
+/** Finalizes the pipeline result. Output is already on ctx.output. */
+export declare class BuiltinReturnResult implements Step {
+    readonly name = "builtin.return_result";
+    readonly description = "Finalize pipeline result";
+    readonly removable = false;
+    readonly replaceable = false;
+    execute(_ctx: PipelineContext): Promise<StepResult>;
+}
+export interface StandardStrategyDeps {
+    config: Config | null;
+    registry: Registry;
+    acl: ACL | null;
+    approvalHandler: ApprovalHandler | null;
+    middlewareManager: MiddlewareManager;
+}
+/** Build the standard 11-step execution strategy matching the current Executor. */
+export declare function buildStandardStrategy(deps: StandardStrategyDeps): ExecutionStrategy;
+/**
+ * Build an internal-only strategy: skips ACL and approval gates.
+ * Suitable for trusted internal service-to-service calls.
+ */
+export declare function buildInternalStrategy(deps: StandardStrategyDeps): ExecutionStrategy;
+/**
+ * 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 declare function buildTestingStrategy(deps: StandardStrategyDeps): ExecutionStrategy;
+/**
+ * Build a performance strategy: skips approval gate and output validation.
+ * Retains ACL, input validation, and middleware for correctness where it matters.
+ */
+export declare function buildPerformanceStrategy(deps: StandardStrategyDeps): ExecutionStrategy;
+//# sourceMappingURL=builtin-steps.d.ts.map

package/dist/builtin-steps.d.ts.map

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