Function beginContext

A higher-order function that ensures a provided function executes outside of existing method and execution contexts. Wraps the input function to isolate its execution from any active MethodContextService or ExecutionContextService contexts, using AsyncResource to create a new, untracked async scope when necessary.

Throws

Propagates any errors thrown by the wrapped run function during execution.

Example

// Basic usage with a simple logging function
const logMessage = (message: string) => console.log(message);
const safeLog = beginContext(logMessage);
safeLog("Hello, world!"); // Logs "Hello, world!" outside any existing contexts

Example

// Usage with an async function
const fetchData = async (id: number) => {
  const response = await fetch(`https://api.example.com/data/${id}`);
  return response.json();
};
const safeFetch = beginContext(fetchData);
safeFetch(42).then(data => console.log(data)); // Fetches data in a clean context

Remarks

This utility leverages AsyncResource from Node.js’s async_hooks to create a new async scope when either MethodContextService.hasContext() or ExecutionContextService.hasContext() returns true. This ensures the wrapped function runs in an isolated environment, free from inherited context state, which is critical for operations requiring a clean slate (e.g., resetting tracking in the agent swarm system). If no contexts are active, the function executes directly without overhead. The resource.emitDestroy() call ensures proper cleanup of the async resource.

See

  • beginContext<T extends (...args: any[]) => any>(
        run: T,
    ): (...args: Parameters<T>) => ReturnType<T>

    Type Parameters

    • T extends (...args: any[]) => any

      The type of the function to be wrapped, extending any function with arbitrary arguments and return type.

    Parameters

    • run: T

      The function to execute outside of existing contexts.

    Returns (...args: Parameters<T>) => ReturnType<T>

    A wrapped function that preserves the original function's signature and executes it outside of any existing contexts if detected, otherwise runs it directly.

Settings

Member Visibility