Skip to content

The open-source agent harness - the runtime layer that turns an LLM into a working agent.

2.6 KB
Raw Blame
/**
 * Maps AgentSpec runtime config flags to public harness builtin capabilities.
 * Plan / ask-user-secret stay gateway-side (extraCapabilities on the resolver).
 */
import type { Logger } from 'winston';
import type { AgentCapability } from '../core/capabilities/AgentCapability';
import { askUserQuestion } from '../core/capabilities/builtins/AskUserQuestion';
import { contextCompaction } from '../core/capabilities/builtins/ContextCompaction';
import { currentDateTime } from '../core/capabilities/builtins/CurrentDateTime';
import { dynamicSubAgents } from '../core/capabilities/builtins/DynamicSubAgents';
import { largeToolResponse } from '../core/capabilities/builtins/LargeToolResponse';
import { openUI } from '../core/capabilities/builtins/OpenUI';
import { webSearch } from '../core/capabilities/builtins/WebSearch';
import type { AgentDefinition } from '../core/runtime/AgentDefinition';
import type { AgentTracing } from '../core/tracing/AgentTracing';
import type { IWebSearchProvider } from '../core/web-search/WebSearchProvider';
import type { AgentSpec } from './schemas/agentSpec';

export function builtinsFromSpec(input: {
  spec: AgentSpec;
  definition: AgentDefinition;
  /** Root thread only — child threads omit interactive builtins. */
  isChild: boolean;
  sandboxAvailable: boolean;
  tracing: AgentTracing;
  webSearchProvider: IWebSearchProvider | undefined;
  logger: Logger;
}): AgentCapability[] {
  const { spec, definition, isChild, sandboxAvailable, tracing, webSearchProvider, logger } = input;
  const config = spec.config;
  const capabilities: AgentCapability[] = [currentDateTime({ tracing })];

  if (config.context_management.compaction.enabled) {
    capabilities.push(
      contextCompaction({
        definition,
        compactionThresholdTokens: config.context_management.compaction.trigger?.value,
      }),
    );
  }

  if (!isChild && config.ask_user_questions.enabled) {
    capabilities.push(askUserQuestion());
  }

  const dynamicSubAgentsEnabled = config.dynamic_sub_agents.enabled;
  if (!isChild && dynamicSubAgentsEnabled) {
    capabilities.push(
      dynamicSubAgents({
        sandboxAvailable,
        tracing,
      }),
    );
  }

  if (config.context_management.large_tool_response.enabled) {
    capabilities.push(
      largeToolResponse({
        dynamicSubAgentsPresent: !isChild && dynamicSubAgentsEnabled,
        logger,
      }),
    );
  }

  if (!isChild && config.generative_ui.enabled) {
    capabilities.push(openUI({ preload: false, tracing }));
  }

  if (webSearchProvider && config.web_search.enabled) {
    capabilities.push(webSearch({ provider: webSearchProvider, tracing }));
  }

  return capabilities;
}