Context for AI Agents

123456789101112
interface AgentState {
  // Goal State - Rarely changes
  goal: {
    objective: string;
    constraints: string[];
    successCriteria: {
      metric: string;
      threshold: number;
      required: boolean;
    }[];
    deadline?: Date;
    resourceLimits: {

123456789101112
{
  "name": "get_order_status",
  "trigger": "When user asks about order status, delivery time, or package location",
  "description": "Retrieves current status and tracking information for a customer order",
  "inputs": {
    "order_id": {
      "type": "string",
      "required": true,
      "format": "ORD-XXXXX (9 characters, alphanumeric after prefix)",
      "example": "ORD-A1B2C",
      "validation": "Must match regex ^ORD-[A-Z0-9]{5}$"
    },

123456789101112
interface ToolDescription {
  name: string;
  category: 'data' | 'action' | 'analysis' | 'communication';
  description: {
    purpose: string;        // What it does (1-2 sentences)
    useWhen: string[];      // Conditions favoring this tool
    avoidWhen: string[];    // Conditions against this tool
    alternatives: string[]; // Related tools for comparison
  };
  parameters: {
    name: string;
    type: string;

123456789101112
interface ErrorRecoveryContext {
  currentError: {
    type: string;
    message: string;
    tool: string;
    timestamp: Date;
    attemptNumber: number;
  } | null;
  
  errorHistory: {
    type: string;
    tool: string;

123456789101112
interface AgentScratchpad {
  // Persistent structured sections
  hypotheses: {
    id: string;
    statement: string;
    confidence: number;  // 0-1
    supportingEvidence: string[];
    contradictingEvidence: string[];
    status: 'active' | 'confirmed' | 'rejected';
  }[];
  
  extractedFacts: {

123456789101112
interface AgentContext {
  // Identity and capabilities
  identity: {
    role: string;
    capabilities: string[];
    limitations: string[];
  };
  
  // Tool ecosystem
  tools: {
    available: ToolDescription[];
    recentlyUsed: ToolUsage[];

123456789101112
from typing import List, Dict, Optional
from dataclasses import dataclass

@dataclass
class ToolCategory:
    name: str
    description: str
    tools: List[str]
    load_triggers: List[str]  # Keywords that suggest this category

class DynamicToolLoader:
    def __init__(self, all_tools: Dict[str, ToolDescription]):