Interface PendingExternalToolExecutionOptions

interface PendingExternalToolExecutionOptions {
    userContext?: Partial<UserContext>;
    organizationId?: string;
    correlationId?: string;
    fallbackExternalToolHandler?: PendingExternalToolHandler;
    externalTools?: ExternalToolRegistry;
}

Hierarchy (view full)

Properties

userContext?: Partial<UserContext>

Optional additional user-context fields to merge into the execution context. pendingRequest.userId always wins.

organizationId?: string

Trusted runtime-only organization context to propagate into both userContext.organizationId and sessionData.organizationId.

correlationId?: string

Optional correlation ID for tool execution tracing. Defaults to the pending stream ID when omitted.

fallbackExternalToolHandler?: PendingExternalToolHandler

Optional fallback for pending external tool calls that are not registered in AgentOS. Use this when the same persisted pause can mix AgentOS- registered tools with custom host-managed tools.

externalTools?: ExternalToolRegistry

Optional map, array, or iterable of host-managed external tools to use when a tool name is not registered in AgentOS itself.