apcore-js 0.6.0 → 0.7.1

package/README.md

@@ -15,6 +15,7 @@ apcore provides a unified task orchestration framework with schema validation, a
 - **Registry system** — File-based module discovery with metadata, dependencies, and topological ordering
 - **Binding loader** — YAML-based module registration for no-code integration
 - **Access control (ACL)** — Pattern-based rules with identity types, roles, and call-depth conditions
+- **Approval system** — Pluggable approval gate in the executor pipeline with sync and async (polling) flows, built-in handlers, and tracing integration
 - **Middleware** — Onion-model middleware with before/after/onError hooks and error recovery
 - **Observability** — Tracing (spans + exporters), metrics (counters + histograms + Prometheus export), structured logging with redaction
 - **Schema export** — JSON/YAML schema export with strict and compact modes
@@ -63,6 +64,7 @@ src/
   context.ts            # Execution context and identity
   config.ts             # Dot-path configuration accessor
   acl.ts                # Access control with pattern matching
+  approval.ts           # Pluggable approval gate (handlers, request/result types)
   decorator.ts          # FunctionModule class and helpers
   bindings.ts           # YAML binding loader
   errors.ts             # Error hierarchy (20+ typed errors)
@@ -128,4 +130,4 @@ npm run build
 
 ## License
 
-MIT
+Apache-2.0

package/dist/approval.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Approval system: interfaces, data types, built-in handlers.
+ *
+ * Provides a pluggable gate at Executor Step 4.5, between ACL enforcement
+ * and input validation. When a module declares requiresApproval=true and
+ * an ApprovalHandler is configured, the handler is invoked before execution.
+ */
+import type { Context } from './context.js';
+import type { ModuleAnnotations } from './module.js';
+/**
+ * Carries invocation context to the approval handler.
+ */
+export interface ApprovalRequest {
+    readonly moduleId: string;
+    readonly arguments: Record<string, unknown>;
+    readonly context: Context;
+    readonly annotations: ModuleAnnotations;
+    readonly description: string | null;
+    readonly tags: readonly string[];
+}
+/**
+ * Create a frozen ApprovalRequest.
+ */
+export declare function createApprovalRequest(options: {
+    moduleId: string;
+    arguments: Record<string, unknown>;
+    context: Context;
+    annotations: ModuleAnnotations;
+    description?: string | null;
+    tags?: string[];
+}): ApprovalRequest;
+/**
+ * Carries the approval handler's decision.
+ */
+export interface ApprovalResult {
+    readonly status: 'approved' | 'rejected' | 'timeout' | 'pending';
+    readonly approvedBy: string | null;
+    readonly reason: string | null;
+    readonly approvalId: string | null;
+    readonly metadata: Record<string, unknown> | null;
+}
+/**
+ * Create a frozen ApprovalResult.
+ */
+export declare function createApprovalResult(options: {
+    status: 'approved' | 'rejected' | 'timeout' | 'pending';
+    approvedBy?: string | null;
+    reason?: string | null;
+    approvalId?: string | null;
+    metadata?: Record<string, unknown> | null;
+}): ApprovalResult;
+/**
+ * Protocol for pluggable approval handlers.
+ *
+ * Implementations receive an ApprovalRequest and return an ApprovalResult.
+ * Both methods are asynchronous.
+ */
+export interface ApprovalHandler {
+    requestApproval(request: ApprovalRequest): Promise<ApprovalResult>;
+    checkApproval(approvalId: string): Promise<ApprovalResult>;
+}
+/**
+ * Built-in handler that always rejects. Safe default for enforcement.
+ */
+export declare class AlwaysDenyHandler implements ApprovalHandler {
+    requestApproval(_request: ApprovalRequest): Promise<ApprovalResult>;
+    checkApproval(_approvalId: string): Promise<ApprovalResult>;
+}
+/**
+ * Built-in handler that always approves. For testing and development.
+ */
+export declare class AutoApproveHandler implements ApprovalHandler {
+    requestApproval(_request: ApprovalRequest): Promise<ApprovalResult>;
+    checkApproval(_approvalId: string): Promise<ApprovalResult>;
+}
+/**
+ * Built-in handler that delegates to a user-provided async callback.
+ */
+export declare class CallbackApprovalHandler implements ApprovalHandler {
+    private _callback;
+    constructor(callback: (request: ApprovalRequest) => Promise<ApprovalResult>);
+    requestApproval(request: ApprovalRequest): Promise<ApprovalResult>;
+    checkApproval(_approvalId: string): Promise<ApprovalResult>;
+}
+//# sourceMappingURL=approval.d.ts.map

package/dist/approval.d.ts.map

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

package/dist/approval.js

@@ -0,0 +1,73 @@
+/**
+ * Approval system: interfaces, data types, built-in handlers.
+ *
+ * Provides a pluggable gate at Executor Step 4.5, between ACL enforcement
+ * and input validation. When a module declares requiresApproval=true and
+ * an ApprovalHandler is configured, the handler is invoked before execution.
+ */
+/**
+ * Create a frozen ApprovalRequest.
+ */
+export function createApprovalRequest(options) {
+    return Object.freeze({
+        moduleId: options.moduleId,
+        arguments: options.arguments,
+        context: options.context,
+        annotations: options.annotations,
+        description: options.description ?? null,
+        tags: Object.freeze([...(options.tags ?? [])]),
+    });
+}
+/**
+ * Create a frozen ApprovalResult.
+ */
+export function createApprovalResult(options) {
+    return Object.freeze({
+        status: options.status,
+        approvedBy: options.approvedBy ?? null,
+        reason: options.reason ?? null,
+        approvalId: options.approvalId ?? null,
+        metadata: options.metadata ?? null,
+    });
+}
+/**
+ * Built-in handler that always rejects. Safe default for enforcement.
+ */
+export class AlwaysDenyHandler {
+    async requestApproval(_request) {
+        return createApprovalResult({ status: 'rejected', reason: 'Always denied' });
+    }
+    async checkApproval(_approvalId) {
+        return createApprovalResult({ status: 'rejected', reason: 'Always denied' });
+    }
+}
+/**
+ * Built-in handler that always approves. For testing and development.
+ */
+export class AutoApproveHandler {
+    async requestApproval(_request) {
+        return createApprovalResult({ status: 'approved', approvedBy: 'auto' });
+    }
+    async checkApproval(_approvalId) {
+        return createApprovalResult({ status: 'approved', approvedBy: 'auto' });
+    }
+}
+/**
+ * Built-in handler that delegates to a user-provided async callback.
+ */
+export class CallbackApprovalHandler {
+    _callback;
+    constructor(callback) {
+        this._callback = callback;
+    }
+    async requestApproval(request) {
+        return this._callback(request);
+    }
+    async checkApproval(_approvalId) {
+        return createApprovalResult({
+            status: 'rejected',
+            reason: 'Phase B not supported by callback handler',
+        });
+    }
+}
+//# sourceMappingURL=approval.js.map

package/dist/approval.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval.js","sourceRoot":"","sources":["../src/approval.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAiBH;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAOrC;IACC,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,IAAI;QACxC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;KAC/C,CAAC,CAAC;AACL,CAAC;AAaD;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAMpC;IACC,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,IAAI;QACtC,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI;QAC9B,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,IAAI;QACtC,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,IAAI;KACnC,CAAC,CAAC;AACL,CAAC;AAaD;;GAEG;AACH,MAAM,OAAO,iBAAiB;IAC5B,KAAK,CAAC,eAAe,CAAC,QAAyB;QAC7C,OAAO,oBAAoB,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC,CAAC;IAC/E,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,WAAmB;QACrC,OAAO,oBAAoB,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC,CAAC;IAC/E,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,kBAAkB;IAC7B,KAAK,CAAC,eAAe,CAAC,QAAyB;QAC7C,OAAO,oBAAoB,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC;IAC1E,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,WAAmB;QACrC,OAAO,oBAAoB,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC;IAC1E,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,uBAAuB;IAC1B,SAAS,CAAwD;IAEzE,YAAY,QAA+D;QACzE,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,OAAwB;QAC5C,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,WAAmB;QACrC,OAAO,oBAAoB,CAAC;YAC1B,MAAM,EAAE,UAAU;YAClB,MAAM,EAAE,2CAA2C;SACpD,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/errors.d.ts

@@ -1,180 +1,166 @@
 /**
  * Error hierarchy for the apcore framework.
  */
+export interface ErrorOptions {
+    cause?: Error;
+    traceId?: string;
+    retryable?: boolean | null;
+    aiGuidance?: string | null;
+    userFixable?: boolean | null;
+    suggestion?: string | null;
+}
 export declare class ModuleError extends Error {
+    static readonly DEFAULT_RETRYABLE: boolean | null;
     readonly code: string;
     readonly details: Record<string, unknown>;
     readonly cause?: Error;
     readonly traceId?: string;
     readonly timestamp: string;
-    constructor(code: string, message: string, details?: Record<string, unknown>, cause?: Error, traceId?: string);
+    readonly retryable: boolean | null;
+    readonly aiGuidance: string | null;
+    readonly userFixable: boolean | null;
+    readonly suggestion: string | null;
+    constructor(code: string, message: string, details?: Record<string, unknown>, cause?: Error, traceId?: string, retryable?: boolean | null, aiGuidance?: string | null, userFixable?: boolean | null, suggestion?: string | null);
     toString(): string;
+    toJSON(): Record<string, unknown>;
 }
 export declare class ConfigNotFoundError extends ModuleError {
-    constructor(configPath: string, options?: {
-        cause?: Error;
-        traceId?: string;
-    });
+    static readonly DEFAULT_RETRYABLE: boolean | null;
+    constructor(configPath: string, options?: ErrorOptions);
 }
 export declare class ConfigError extends ModuleError {
-    constructor(message: string, options?: {
-        cause?: Error;
-        traceId?: string;
-    });
+    static readonly DEFAULT_RETRYABLE: boolean | null;
+    constructor(message: string, options?: ErrorOptions);
 }
 export declare class ACLRuleError extends ModuleError {
-    constructor(message: string, options?: {
-        cause?: Error;
-        traceId?: string;
-    });
+    static readonly DEFAULT_RETRYABLE: boolean | null;
+    constructor(message: string, options?: ErrorOptions);
 }
 export declare class ACLDeniedError extends ModuleError {
-    constructor(callerId: string | null, targetId: string, options?: {
-        cause?: Error;
-        traceId?: string;
-    });
+    static readonly DEFAULT_RETRYABLE: boolean | null;
+    constructor(callerId: string | null, targetId: string, options?: ErrorOptions);
     get callerId(): string | null;
     get targetId(): string;
 }
 export declare class ModuleNotFoundError extends ModuleError {
-    constructor(moduleId: string, options?: {
-        cause?: Error;
-        traceId?: string;
-    });
+    static readonly DEFAULT_RETRYABLE: boolean | null;
+    constructor(moduleId: string, options?: ErrorOptions);
 }
 export declare class ModuleTimeoutError extends ModuleError {
-    constructor(moduleId: string, timeoutMs: number, options?: {
-        cause?: Error;
-        traceId?: string;
-    });
+    static readonly DEFAULT_RETRYABLE: boolean | null;
+    constructor(moduleId: string, timeoutMs: number, options?: ErrorOptions);
     get moduleId(): string;
     get timeoutMs(): number;
 }
 export declare class SchemaValidationError extends ModuleError {
-    constructor(message?: string, errors?: Array<Record<string, unknown>>, options?: {
-        cause?: Error;
-        traceId?: string;
-    });
+    static readonly DEFAULT_RETRYABLE: boolean | null;
+    constructor(message?: string, errors?: Array<Record<string, unknown>>, options?: ErrorOptions);
 }
 export declare class SchemaNotFoundError extends ModuleError {
-    constructor(schemaId: string, options?: {
-        cause?: Error;
-        traceId?: string;
-    });
+    static readonly DEFAULT_RETRYABLE: boolean | null;
+    constructor(schemaId: string, options?: ErrorOptions);
 }
 export declare class SchemaParseError extends ModuleError {
-    constructor(message: string, options?: {
-        cause?: Error;
-        traceId?: string;
-    });
+    static readonly DEFAULT_RETRYABLE: boolean | null;
+    constructor(message: string, options?: ErrorOptions);
 }
 export declare class SchemaCircularRefError extends ModuleError {
-    constructor(refPath: string, options?: {
-        cause?: Error;
-        traceId?: string;
-    });
+    static readonly DEFAULT_RETRYABLE: boolean | null;
+    constructor(refPath: string, options?: ErrorOptions);
 }
 export declare class CallDepthExceededError extends ModuleError {
-    constructor(depth: number, maxDepth: number, callChain: string[], options?: {
-        cause?: Error;
-        traceId?: string;
-    });
+    static readonly DEFAULT_RETRYABLE: boolean | null;
+    constructor(depth: number, maxDepth: number, callChain: string[], options?: ErrorOptions);
     get currentDepth(): number;
     get maxDepth(): number;
 }
 export declare class CircularCallError extends ModuleError {
-    constructor(moduleId: string, callChain: string[], options?: {
-        cause?: Error;
-        traceId?: string;
-    });
+    static readonly DEFAULT_RETRYABLE: boolean | null;
+    constructor(moduleId: string, callChain: string[], options?: ErrorOptions);
     get moduleId(): string;
 }
 export declare class CallFrequencyExceededError extends ModuleError {
-    constructor(moduleId: string, count: number, maxRepeat: number, callChain: string[], options?: {
-        cause?: Error;
-        traceId?: string;
-    });
+    static readonly DEFAULT_RETRYABLE: boolean | null;
+    constructor(moduleId: string, count: number, maxRepeat: number, callChain: string[], options?: ErrorOptions);
     get moduleId(): string;
     get count(): number;
     get maxRepeat(): number;
 }
 export declare class InvalidInputError extends ModuleError {
-    constructor(message?: string, options?: {
-        cause?: Error;
-        traceId?: string;
-    });
+    static readonly DEFAULT_RETRYABLE: boolean | null;
+    constructor(message?: string, options?: ErrorOptions);
 }
 export declare class FuncMissingTypeHintError extends ModuleError {
-    constructor(functionName: string, parameterName: string, options?: {
-        cause?: Error;
-        traceId?: string;
-    });
+    static readonly DEFAULT_RETRYABLE: boolean | null;
+    constructor(functionName: string, parameterName: string, options?: ErrorOptions);
 }
 export declare class FuncMissingReturnTypeError extends ModuleError {
-    constructor(functionName: string, options?: {
-        cause?: Error;
-        traceId?: string;
-    });
+    static readonly DEFAULT_RETRYABLE: boolean | null;
+    constructor(functionName: string, options?: ErrorOptions);
 }
 export declare class BindingInvalidTargetError extends ModuleError {
-    constructor(target: string, options?: {
-        cause?: Error;
-        traceId?: string;
-    });
+    static readonly DEFAULT_RETRYABLE: boolean | null;
+    constructor(target: string, options?: ErrorOptions);
 }
 export declare class BindingModuleNotFoundError extends ModuleError {
-    constructor(modulePath: string, options?: {
-        cause?: Error;
-        traceId?: string;
-    });
+    static readonly DEFAULT_RETRYABLE: boolean | null;
+    constructor(modulePath: string, options?: ErrorOptions);
 }
 export declare class BindingCallableNotFoundError extends ModuleError {
-    constructor(callableName: string, modulePath: string, options?: {
-        cause?: Error;
-        traceId?: string;
-    });
+    static readonly DEFAULT_RETRYABLE: boolean | null;
+    constructor(callableName: string, modulePath: string, options?: ErrorOptions);
 }
 export declare class BindingNotCallableError extends ModuleError {
-    constructor(target: string, options?: {
-        cause?: Error;
-        traceId?: string;
-    });
+    static readonly DEFAULT_RETRYABLE: boolean | null;
+    constructor(target: string, options?: ErrorOptions);
 }
 export declare class BindingSchemaMissingError extends ModuleError {
-    constructor(target: string, options?: {
-        cause?: Error;
-        traceId?: string;
-    });
+    static readonly DEFAULT_RETRYABLE: boolean | null;
+    constructor(target: string, options?: ErrorOptions);
 }
 export declare class BindingFileInvalidError extends ModuleError {
-    constructor(filePath: string, reason: string, options?: {
-        cause?: Error;
-        traceId?: string;
-    });
+    static readonly DEFAULT_RETRYABLE: boolean | null;
+    constructor(filePath: string, reason: string, options?: ErrorOptions);
 }
 export declare class CircularDependencyError extends ModuleError {
-    constructor(cyclePath: string[], options?: {
-        cause?: Error;
-        traceId?: string;
-    });
+    static readonly DEFAULT_RETRYABLE: boolean | null;
+    constructor(cyclePath: string[], options?: ErrorOptions);
 }
 export declare class ModuleLoadError extends ModuleError {
-    constructor(moduleId: string, reason: string, options?: {
-        cause?: Error;
-        traceId?: string;
-    });
+    static readonly DEFAULT_RETRYABLE: boolean | null;
+    constructor(moduleId: string, reason: string, options?: ErrorOptions);
 }
 export declare class ModuleExecuteError extends ModuleError {
-    constructor(moduleId: string, reason: string, options?: {
-        cause?: Error;
-        traceId?: string;
-    });
+    static readonly DEFAULT_RETRYABLE: boolean | null;
+    constructor(moduleId: string, reason: string, options?: ErrorOptions);
 }
 export declare class InternalError extends ModuleError {
-    constructor(message?: string, options?: {
-        cause?: Error;
-        traceId?: string;
-    });
+    static readonly DEFAULT_RETRYABLE: boolean | null;
+    constructor(message?: string, options?: ErrorOptions);
+}
+/**
+ * Base error for all approval-related errors.
+ * Carries the full ApprovalResult for inspection by callers.
+ */
+export declare class ApprovalError extends ModuleError {
+    static readonly DEFAULT_RETRYABLE: boolean | null;
+    readonly result: unknown;
+    constructor(code: string, message: string, result: unknown, moduleId?: string, options?: ErrorOptions);
+    get moduleId(): string | null;
+    get reason(): string | null;
+}
+export declare class ApprovalDeniedError extends ApprovalError {
+    static readonly DEFAULT_RETRYABLE: boolean | null;
+    constructor(result: unknown, moduleId?: string, options?: ErrorOptions);
+}
+export declare class ApprovalTimeoutError extends ApprovalError {
+    static readonly DEFAULT_RETRYABLE: boolean | null;
+    constructor(result: unknown, moduleId?: string, options?: ErrorOptions);
+}
+export declare class ApprovalPendingError extends ApprovalError {
+    static readonly DEFAULT_RETRYABLE: boolean | null;
+    constructor(result: unknown, moduleId?: string, options?: ErrorOptions);
+    get approvalId(): string | null;
 }
 /**
  * All framework error codes as constants.
@@ -208,6 +194,9 @@ export declare const ErrorCodes: Readonly<{
     readonly BINDING_FILE_INVALID: "BINDING_FILE_INVALID";
     readonly CIRCULAR_DEPENDENCY: "CIRCULAR_DEPENDENCY";
     readonly MIDDLEWARE_CHAIN_ERROR: "MIDDLEWARE_CHAIN_ERROR";
+    readonly APPROVAL_DENIED: "APPROVAL_DENIED";
+    readonly APPROVAL_TIMEOUT: "APPROVAL_TIMEOUT";
+    readonly APPROVAL_PENDING: "APPROVAL_PENDING";
     readonly GENERAL_NOT_IMPLEMENTED: "GENERAL_NOT_IMPLEMENTED";
     readonly DEPENDENCY_NOT_FOUND: "DEPENDENCY_NOT_FOUND";
 }>;

package/dist/errors.d.ts.map

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