Skip to main content

Interface: BALConfig

Defined in: packages/tools/src/baleybots-dsl-v2/types.ts:394

Properties​

availableTools?​

optional availableTools?: Record<string, ZodToolDefinition<ZodType<unknown, unknown, $ZodTypeInternals<unknown, unknown>>, unknown> | ToolDefinition<(...args) => unknown> | Processable<unknown, unknown>>

Defined in: packages/tools/src/baleybots-dsl-v2/types.ts:402

Available tools that bots can reference

eventQueueOverflow?​

optional eventQueueOverflow?: "warn" | "throw"

Defined in: packages/tools/src/baleybots-dsl-v2/types.ts:421

What to do when the event queue overflows.

  • 'warn' (default): Drop oldest event and emit a console.warn.
  • 'throw': Throw an error immediately, aborting execution.

input?​

optional input?: string

Defined in: packages/tools/src/baleybots-dsl-v2/types.ts:411

Runtime input to pass to the execution (overrides run("...") in BAL code)

maxEventQueueSize?​

optional maxEventQueueSize?: number

Defined in: packages/tools/src/baleybots-dsl-v2/types.ts:414

Maximum number of events to buffer during execution. Default: 1000.

maxLoopIterations?​

optional maxLoopIterations?: number

Defined in: packages/tools/src/baleybots-dsl-v2/types.ts:405

Maximum loop iterations (default: 10)

model?​

optional model?: string | ModelConfig

Defined in: packages/tools/src/baleybots-dsl-v2/types.ts:396

Model to use for created bots

providerConfig?​

optional providerConfig?: ProviderConfig

Defined in: packages/tools/src/baleybots-dsl-v2/types.ts:399

Provider configuration (API keys, etc.)

strictToolNames?​

optional strictToolNames?: boolean | "warn" | "throw"

Defined in: packages/tools/src/baleybots-dsl-v2/types.ts:429

Controls behavior when an entity declares a tool name not found in availableTools.

  • 'warn' (default): console.warn with the missing tool name and available tools list.
  • 'throw': Throw an InterpreterError immediately. Useful in CI/test environments.
  • true: Shorthand for 'throw'.

verbose?​

optional verbose?: boolean

Defined in: packages/tools/src/baleybots-dsl-v2/types.ts:408

Enable verbose logging