tool property

AgentTool tool

The compact_expand tool bound to this controller.

Implementation

late final AgentTool tool = AgentTool(
  name: compactExpandToolName,
  description: compactExpandToolDescriptionPrompt,
  tier: ApprovalTier.read,
  parameters: const {
    'type': 'object',
    'properties': {
      'target': {
        'type': 'string',
        'description':
            'Numeric id or range from a context marker, '
            'e.g. "5" or "2-6". Omit to list the hidden-segment index.',
      },
      'action': {
        'type': 'string',
        'description':
            'Tier 2 segment management (issue #1379). With a target: '
            '"hide" folds a dead-weight segment into its expandable '
            'marker right now, without waiting for pressure; "pin" '
            'shields a segment from every hide/compact path; "unpin" '
            'releases it. Omit to expand the target.',
      },
      'query': {
        'type': 'string',
        'description':
            'Search the hidden segments (preview and full content) when '
            'you know WHAT you need but not the id. Free — no budget.',
      },
      'page': {
        'type': 'integer',
        'description': '1-based page for giant segments (default 1)',
        'minimum': 1,
      },
    },
    'required': [],
  },
  execute: _execute,
);