llm.rb 12.0.0 → 12.2.0

data/data/openai.json

@@ -10,6 +10,7 @@
     "o3": {
       "id": "o3",
       "name": "o3",
+      "description": "Deliberate o-series reasoner for hard math, coding, and multi-step analysis",
       "family": "o",
       "attachment": true,
       "reasoning": true,
@@ -53,6 +54,7 @@
     "text-embedding-3-large": {
       "id": "text-embedding-3-large",
       "name": "text-embedding-3-large",
+      "description": "Embedding model for semantic search, retrieval, clustering, and ranking pipelines",
       "family": "text-embedding",
       "attachment": false,
       "reasoning": false,
@@ -82,6 +84,7 @@
     "gpt-5.2-pro": {
       "id": "gpt-5.2-pro",
       "name": "GPT-5.2 Pro",
+      "description": "Higher-accuracy GPT-5.2 variant for tougher reasoning and review workflows",
       "family": "gpt-pro",
       "attachment": true,
       "reasoning": true,
@@ -124,6 +127,7 @@
     "gpt-5": {
       "id": "gpt-5",
       "name": "GPT-5",
+      "description": "Original GPT-5 workhorse for reasoning, coding, writing, and tool workflows",
       "family": "gpt",
       "attachment": true,
       "reasoning": true,
@@ -168,6 +172,7 @@
     "gpt-3.5-turbo": {
       "id": "gpt-3.5-turbo",
       "name": "GPT-3.5-turbo",
+      "description": "Compact GPT model for low-latency assistance and high-volume workloads",
       "family": "gpt",
       "attachment": false,
       "reasoning": false,
@@ -199,6 +204,7 @@
     "gpt-5-pro": {
       "id": "gpt-5-pro",
       "name": "GPT-5 Pro",
+      "description": "Higher-accuracy GPT-5 tier for tough analysis, coding reviews, and planning",
       "family": "gpt-pro",
       "attachment": true,
       "reasoning": true,
@@ -239,6 +245,7 @@
     "gpt-4o": {
       "id": "gpt-4o",
       "name": "GPT-4o",
+      "description": "Omni-era GPT for multimodal chat, practical coding, and general assistants",
       "family": "gpt",
       "attachment": true,
       "reasoning": false,
@@ -272,6 +279,7 @@
     "gpt-4": {
       "id": "gpt-4",
       "name": "GPT-4",
+      "description": "GPT model for general reasoning, writing, coding, and tool-assisted tasks",
       "family": "gpt",
       "attachment": true,
       "reasoning": false,
@@ -302,6 +310,7 @@
     "o4-mini": {
       "id": "o4-mini",
       "name": "o4-mini",
+      "description": "Fast o-series model for compact reasoning, coding, and tool use",
       "family": "o-mini",
       "attachment": true,
       "reasoning": true,
@@ -344,6 +353,7 @@
     "o3-pro": {
       "id": "o3-pro",
       "name": "o3-pro",
+      "description": "High-effort o3 tier for difficult technical reasoning and careful answers",
       "family": "o-pro",
       "attachment": true,
       "reasoning": true,
@@ -385,6 +395,7 @@
     "chatgpt-image-latest": {
       "id": "chatgpt-image-latest",
       "name": "chatgpt-image-latest",
+      "description": "Image model for prompt-driven generation, editing, and visual design workflows",
       "family": "gpt-image",
       "attachment": true,
       "reasoning": false,
@@ -412,6 +423,7 @@
     "gpt-4o-2024-05-13": {
       "id": "gpt-4o-2024-05-13",
       "name": "GPT-4o (2024-05-13)",
+      "description": "GPT model for general reasoning, writing, coding, and tool-assisted tasks",
       "family": "gpt",
       "attachment": true,
       "reasoning": false,
@@ -443,6 +455,7 @@
     "gpt-5.4-nano": {
       "id": "gpt-5.4-nano",
       "name": "GPT-5.4 nano",
+      "description": "Cheapest GPT-5.4 lane for simple routing, extraction, and bulk automation",
       "family": "gpt-nano",
       "attachment": true,
       "reasoning": true,
@@ -488,6 +501,7 @@
     "gpt-5-chat-latest": {
       "id": "gpt-5-chat-latest",
       "name": "GPT-5 Chat (latest)",
+      "description": "Chat-tuned GPT model for conversational assistance, writing, and tool workflows",
       "family": "gpt-codex",
       "attachment": true,
       "reasoning": true,
@@ -522,6 +536,7 @@
     "gpt-5.1-codex": {
       "id": "gpt-5.1-codex",
       "name": "GPT-5.1 Codex",
+      "description": "Codex GPT for repository edits, code review, and practical software agents",
       "family": "gpt-codex",
       "attachment": true,
       "reasoning": true,
@@ -565,6 +580,7 @@
     "gpt-5.3-codex-spark": {
       "id": "gpt-5.3-codex-spark",
       "name": "GPT-5.3 Codex Spark",
+      "description": "Coding-optimized GPT model for repository edits, reviews, and agentic software work",
       "family": "gpt-codex-spark",
       "attachment": true,
       "reasoning": true,
@@ -611,6 +627,7 @@
     "gpt-5.1-codex-max": {
       "id": "gpt-5.1-codex-max",
       "name": "GPT-5.1 Codex Max",
+      "description": "Coding-optimized GPT model for repository edits, reviews, and agentic software work",
       "family": "gpt-codex",
       "attachment": true,
       "reasoning": true,
@@ -655,6 +672,7 @@
     "gpt-5.3-chat-latest": {
       "id": "gpt-5.3-chat-latest",
       "name": "GPT-5.3 Chat (latest)",
+      "description": "Chat-tuned GPT model for conversational assistance, writing, and tool workflows",
       "family": "gpt",
       "attachment": true,
       "reasoning": false,
@@ -687,6 +705,7 @@
     "gpt-4o-2024-08-06": {
       "id": "gpt-4o-2024-08-06",
       "name": "GPT-4o (2024-08-06)",
+      "description": "GPT model for general reasoning, writing, coding, and tool-assisted tasks",
       "family": "gpt",
       "attachment": true,
       "reasoning": false,
@@ -719,6 +738,7 @@
     "text-embedding-ada-002": {
       "id": "text-embedding-ada-002",
       "name": "text-embedding-ada-002",
+      "description": "Embedding model for semantic search, retrieval, clustering, and ranking pipelines",
       "family": "text-embedding",
       "attachment": false,
       "reasoning": false,
@@ -748,6 +768,7 @@
     "o3-mini": {
       "id": "o3-mini",
       "name": "o3-mini",
+      "description": "Smaller o-series reasoner for economical coding, math, and planning tasks",
       "family": "o-mini",
       "attachment": false,
       "reasoning": true,
@@ -789,6 +810,7 @@
     "gpt-5.2": {
       "id": "gpt-5.2",
       "name": "GPT-5.2",
+      "description": "Reliable GPT generation for broad coding, writing, and tool-assisted product work",
       "family": "gpt",
       "attachment": true,
       "reasoning": true,
@@ -834,6 +856,7 @@
     "gpt-5.3-codex": {
       "id": "gpt-5.3-codex",
       "name": "GPT-5.3 Codex",
+      "description": "Coding-optimized GPT model for repository edits, reviews, and agentic software work",
       "family": "gpt-codex",
       "attachment": true,
       "reasoning": true,
@@ -880,6 +903,7 @@
     "text-embedding-3-small": {
       "id": "text-embedding-3-small",
       "name": "text-embedding-3-small",
+      "description": "Embedding model for semantic search, retrieval, clustering, and ranking pipelines",
       "family": "text-embedding",
       "attachment": false,
       "reasoning": false,
@@ -909,6 +933,7 @@
     "gpt-5.1-codex-mini": {
       "id": "gpt-5.1-codex-mini",
       "name": "GPT-5.1 Codex mini",
+      "description": "Coding-optimized GPT model for repository edits, reviews, and agentic software work",
       "family": "gpt-codex",
       "attachment": true,
       "reasoning": true,
@@ -952,6 +977,7 @@
     "gpt-5.1-chat-latest": {
       "id": "gpt-5.1-chat-latest",
       "name": "GPT-5.1 Chat",
+      "description": "Chat-tuned GPT-5.1 for polished assistants, writing, and product conversations",
       "family": "gpt-codex",
       "attachment": true,
       "reasoning": true,
@@ -992,6 +1018,7 @@
     "gpt-5.2-chat-latest": {
       "id": "gpt-5.2-chat-latest",
       "name": "GPT-5.2 Chat",
+      "description": "Chat-tuned GPT model for conversational assistance, writing, and tool workflows",
       "family": "gpt-codex",
       "attachment": true,
       "reasoning": true,
@@ -1032,6 +1059,7 @@
     "o4-mini-deep-research": {
       "id": "o4-mini-deep-research",
       "name": "o4-mini-deep-research",
+      "description": "Research model for long-horizon investigation, synthesis, and analytical reports",
       "family": "o-mini",
       "attachment": true,
       "reasoning": true,
@@ -1071,6 +1099,7 @@
     "gpt-image-1.5": {
       "id": "gpt-image-1.5",
       "name": "gpt-image-1.5",
+      "description": "Image model for prompt-driven generation, editing, and visual design workflows",
       "family": "gpt-image",
       "attachment": true,
       "reasoning": false,
@@ -1098,6 +1127,7 @@
     "gpt-4.1-nano": {
       "id": "gpt-4.1-nano",
       "name": "GPT-4.1 nano",
+      "description": "Tiny GPT-4.1 option for classification, routing, and very high-volume tasks",
       "family": "gpt-nano",
       "attachment": true,
       "reasoning": false,
@@ -1130,6 +1160,7 @@
     "gpt-4o-2024-11-20": {
       "id": "gpt-4o-2024-11-20",
       "name": "GPT-4o (2024-11-20)",
+      "description": "GPT model for general reasoning, writing, coding, and tool-assisted tasks",
       "family": "gpt",
       "attachment": true,
       "reasoning": false,
@@ -1162,6 +1193,7 @@
     "o1": {
       "id": "o1",
       "name": "o1",
+      "description": "O-series reasoning model for hard analysis, math, coding, and planning",
       "family": "o",
       "attachment": true,
       "reasoning": true,
@@ -1205,6 +1237,7 @@
     "o1-pro": {
       "id": "o1-pro",
       "name": "o1-pro",
+      "description": "O-series reasoning model for hard analysis, math, coding, and planning",
       "family": "o-pro",
       "attachment": true,
       "reasoning": true,
@@ -1246,6 +1279,7 @@
     "gpt-5.4": {
       "id": "gpt-5.4",
       "name": "GPT-5.4",
+      "description": "Agent-ready GPT for coding and computer-use workflows at a lower cost",
       "family": "gpt",
       "attachment": true,
       "reasoning": true,
@@ -1324,6 +1358,7 @@
     "gpt-5.4-mini": {
       "id": "gpt-5.4-mini",
       "name": "GPT-5.4 mini",
+      "description": "Strong small GPT for coding subagents, quick tool use, and high-volume work",
       "family": "gpt-mini",
       "attachment": true,
       "reasoning": true,
@@ -1385,6 +1420,7 @@
     "gpt-4.1": {
       "id": "gpt-4.1",
       "name": "GPT-4.1",
+      "description": "Long-lived GPT workhorse for coding, instruction following, and production apps",
       "family": "gpt",
       "attachment": true,
       "reasoning": false,
@@ -1418,6 +1454,7 @@
     "o3-deep-research": {
       "id": "o3-deep-research",
       "name": "o3-deep-research",
+      "description": "Research model for long-horizon investigation, synthesis, and analytical reports",
       "family": "o",
       "attachment": true,
       "reasoning": true,
@@ -1457,6 +1494,7 @@
     "gpt-5-mini": {
       "id": "gpt-5-mini",
       "name": "GPT-5 Mini",
+      "description": "Small GPT-5 for responsive agents, coding help, and everyday automation",
       "family": "gpt-mini",
       "attachment": true,
       "reasoning": true,
@@ -1501,6 +1539,7 @@
     "gpt-image-1": {
       "id": "gpt-image-1",
       "name": "gpt-image-1",
+      "description": "OpenAI image model for production generation, edits, and brand-safe visual workflows",
       "family": "gpt-image",
       "attachment": true,
       "reasoning": false,
@@ -1527,6 +1566,7 @@
     "gpt-4.1-mini": {
       "id": "gpt-4.1-mini",
       "name": "GPT-4.1 mini",
+      "description": "Affordable GPT-4.1 lane for fast coding help and structured extraction",
       "family": "gpt-mini",
       "attachment": true,
       "reasoning": false,
@@ -1560,6 +1600,7 @@
     "gpt-4-turbo": {
       "id": "gpt-4-turbo",
       "name": "GPT-4 Turbo",
+      "description": "Compact GPT model for low-latency assistance and high-volume workloads",
       "family": "gpt",
       "attachment": true,
       "reasoning": false,
@@ -1591,6 +1632,7 @@
     "gpt-image-1-mini": {
       "id": "gpt-image-1-mini",
       "name": "gpt-image-1-mini",
+      "description": "Image model for prompt-driven generation, editing, and visual design workflows",
       "family": "gpt-image",
       "attachment": true,
       "reasoning": false,
@@ -1618,6 +1660,7 @@
     "gpt-5-nano": {
       "id": "gpt-5-nano",
       "name": "GPT-5 Nano",
+      "description": "Tiny GPT-5 lane for routing, extraction, classification, and bulk jobs",
       "family": "gpt-nano",
       "attachment": true,
       "reasoning": true,
@@ -1662,6 +1705,7 @@
     "gpt-5.4-pro": {
       "id": "gpt-5.4-pro",
       "name": "GPT-5.4 Pro",
+      "description": "More exact GPT-5.4 tier for demanding professional reasoning and agent tasks",
       "family": "gpt-pro",
       "attachment": true,
       "reasoning": true,
@@ -1718,6 +1762,7 @@
     "gpt-5.5-pro": {
       "id": "gpt-5.5-pro",
       "name": "GPT-5.5 Pro",
+      "description": "Highest-accuracy GPT-5.5 tier for slower, precision-heavy reasoning and coding",
       "family": "gpt-pro",
       "attachment": true,
       "reasoning": true,
@@ -1775,6 +1820,7 @@
     "gpt-4o-mini": {
       "id": "gpt-4o-mini",
       "name": "GPT-4o mini",
+      "description": "Small omni GPT for cheap multimodal assistance and production-scale traffic",
       "family": "gpt-mini",
       "attachment": true,
       "reasoning": false,
@@ -1808,6 +1854,7 @@
     "gpt-5-codex": {
       "id": "gpt-5-codex",
       "name": "GPT-5-Codex",
+      "description": "Coding-optimized GPT model for repository edits, reviews, and agentic software work",
       "family": "gpt-codex",
       "attachment": false,
       "reasoning": true,
@@ -1851,6 +1898,7 @@
     "gpt-5.2-codex": {
       "id": "gpt-5.2-codex",
       "name": "GPT-5.2 Codex",
+      "description": "Code-specialist GPT for repository edits, reviews, and long-running software agents",
       "family": "gpt-codex",
       "attachment": true,
       "reasoning": true,
@@ -1896,6 +1944,7 @@
     "gpt-image-2": {
       "id": "gpt-image-2",
       "name": "gpt-image-2",
+      "description": "Image model for prompt-driven generation, editing, and visual design workflows",
       "family": "gpt-image",
       "attachment": true,
       "reasoning": false,
@@ -1927,6 +1976,7 @@
     "gpt-5.1": {
       "id": "gpt-5.1",
       "name": "GPT-5.1",
+      "description": "Sharper GPT-5 generation for coding, product work, and tool-assisted tasks",
       "family": "gpt",
       "attachment": true,
       "reasoning": true,
@@ -1971,6 +2021,7 @@
     "gpt-5.5": {
       "id": "gpt-5.5",
       "name": "GPT-5.5",
+      "description": "Default frontier GPT for coding, computer use, research, and knowledge work",
       "family": "gpt",
       "attachment": true,
       "reasoning": true,

data/data/xai.json

@@ -10,6 +10,7 @@
     "grok-4.20-multi-agent-0309": {
       "id": "grok-4.20-multi-agent-0309",
       "name": "Grok 4.20 Multi-Agent",
+      "description": "Grok model for agentic tool use, reasoning, coding, and live assistance",
       "family": "grok",
       "attachment": true,
       "reasoning": true,
@@ -69,6 +70,7 @@
     "grok-4.20-0309-non-reasoning": {
       "id": "grok-4.20-0309-non-reasoning",
       "name": "Grok 4.20 (Non-Reasoning)",
+      "description": "Grok model for agentic tool use, reasoning, coding, and live assistance",
       "family": "grok",
       "attachment": true,
       "reasoning": false,
@@ -117,6 +119,7 @@
     "grok-4.3": {
       "id": "grok-4.3",
       "name": "Grok 4.3",
+      "description": "xAI's Grok for chat, coding, agentic tools, and lower hallucination risk",
       "family": "grok",
       "attachment": true,
       "reasoning": true,
@@ -176,6 +179,7 @@
     "grok-imagine-image-quality": {
       "id": "grok-imagine-image-quality",
       "name": "Grok Imagine Image Quality",
+      "description": "Image model for prompt-driven generation, editing, and visual design workflows",
       "family": "grok",
       "attachment": true,
       "reasoning": false,
@@ -203,6 +207,7 @@
     "grok-imagine-video": {
       "id": "grok-imagine-video",
       "name": "Grok Imagine Video",
+      "description": "Image model for prompt-driven generation, editing, and visual design workflows",
       "family": "grok",
       "attachment": true,
       "reasoning": false,
@@ -227,9 +232,69 @@
         "output": 0
       }
     },
+    "grok-4.5": {
+      "id": "grok-4.5",
+      "name": "Grok 4.5",
+      "description": "xAI's latest Grok for chat, coding, agentic tools, and lower hallucination risk",
+      "family": "grok",
+      "attachment": true,
+      "reasoning": true,
+      "reasoning_options": [
+        {
+          "type": "effort",
+          "values": [
+            "low",
+            "medium",
+            "high"
+          ]
+        }
+      ],
+      "tool_call": true,
+      "structured_output": true,
+      "temperature": true,
+      "release_date": "2026-07-08",
+      "last_updated": "2026-07-08",
+      "modalities": {
+        "input": [
+          "text",
+          "image",
+          "pdf"
+        ],
+        "output": [
+          "text"
+        ]
+      },
+      "open_weights": false,
+      "limit": {
+        "context": 500000,
+        "output": 500000
+      },
+      "cost": {
+        "input": 2,
+        "output": 6,
+        "cache_read": 0.5,
+        "tiers": [
+          {
+            "input": 4,
+            "output": 12,
+            "cache_read": 1,
+            "tier": {
+              "type": "context",
+              "size": 200000
+            }
+          }
+        ],
+        "context_over_200k": {
+          "input": 4,
+          "output": 12,
+          "cache_read": 1
+        }
+      }
+    },
     "grok-4.20-0309-reasoning": {
       "id": "grok-4.20-0309-reasoning",
       "name": "Grok 4.20 (Reasoning)",
+      "description": "Reasoning Grok for document-heavy analysis and long-horizon tool use",
       "family": "grok",
       "attachment": true,
       "reasoning": true,
@@ -279,6 +344,7 @@
     "grok-imagine-image": {
       "id": "grok-imagine-image",
       "name": "Grok Imagine Image",
+      "description": "Image model for prompt-driven generation, editing, and visual design workflows",
       "family": "grok",
       "attachment": true,
       "reasoning": false,
@@ -306,6 +372,7 @@
     "grok-build-0.1": {
       "id": "grok-build-0.1",
       "name": "Grok Build 0.1",
+      "description": "Fast Grok coding model tuned for agentic engineering and iterative edits",
       "family": "grok-build",
       "attachment": true,
       "reasoning": true,

data/data/zai.json

@@ -11,6 +11,7 @@
     "glm-4.7": {
       "id": "glm-4.7",
       "name": "GLM-4.7",
+      "description": "Mature GLM model for dependable coding, reasoning, and structured agent tasks",
       "family": "glm",
       "attachment": false,
       "reasoning": true,
@@ -50,6 +51,7 @@
     "glm-4.5v": {
       "id": "glm-4.5v",
       "name": "GLM-4.5V",
+      "description": "GLM vision model for visual reasoning, documents, and multimodal agents",
       "family": "glm",
       "attachment": true,
       "reasoning": true,
@@ -86,6 +88,7 @@
     "glm-4.5": {
       "id": "glm-4.5",
       "name": "GLM-4.5",
+      "description": "Hybrid-reasoning GLM release that made the 4.5 line broadly useful",
       "family": "glm",
       "attachment": false,
       "reasoning": true,
@@ -122,6 +125,7 @@
     "glm-4.7-flashx": {
       "id": "glm-4.7-flashx",
       "name": "GLM-4.7-FlashX",
+      "description": "Efficient GLM model for fast reasoning, coding, and agent workflows",
       "family": "glm-flash",
       "attachment": false,
       "reasoning": true,
@@ -158,6 +162,7 @@
     "glm-5.1": {
       "id": "glm-5.1",
       "name": "GLM-5.1",
+      "description": "Strong GLM coding model for agentic engineering, terminals, and repository generation",
       "family": "glm",
       "attachment": false,
       "reasoning": true,
@@ -197,6 +202,7 @@
     "glm-4.6": {
       "id": "glm-4.6",
       "name": "GLM-4.6",
+      "description": "Late GLM-4 workhorse for coding agents, reasoning, and structured tasks",
       "family": "glm",
       "attachment": false,
       "reasoning": true,
@@ -233,6 +239,7 @@
     "glm-5.2": {
       "id": "glm-5.2",
       "name": "GLM-5.2",
+      "description": "Open flagship GLM for long-horizon coding agents and million-token context work",
       "family": "glm",
       "attachment": false,
       "reasoning": true,
@@ -276,6 +283,7 @@
     "glm-4.6v": {
       "id": "glm-4.6v",
       "name": "GLM-4.6V",
+      "description": "GLM vision model for visual reasoning, documents, and multimodal agents",
       "family": "glm",
       "attachment": true,
       "reasoning": true,
@@ -312,6 +320,7 @@
     "glm-5v-turbo": {
       "id": "glm-5v-turbo",
       "name": "GLM-5V-Turbo",
+      "description": "Fast GLM vision model for screenshots, documents, and multimodal agent tasks",
       "family": "glm",
       "attachment": true,
       "reasoning": true,
@@ -353,6 +362,7 @@
     "glm-4.5-air": {
       "id": "glm-4.5-air",
       "name": "GLM-4.5-Air",
+      "description": "Lighter GLM-4.5 variant for fast coding assistance and cheaper agents",
       "family": "glm-air",
       "attachment": false,
       "reasoning": true,
@@ -389,6 +399,7 @@
     "glm-4.7-flash": {
       "id": "glm-4.7-flash",
       "name": "GLM-4.7-Flash",
+      "description": "Budget GLM lane for fast coding help, routing, and everyday automation",
       "family": "glm-flash",
       "attachment": false,
       "reasoning": true,
@@ -425,6 +436,7 @@
     "glm-4.5-flash": {
       "id": "glm-4.5-flash",
       "name": "GLM-4.5-Flash",
+      "description": "Efficient GLM model for fast reasoning, coding, and agent workflows",
       "family": "glm-flash",
       "attachment": false,
       "reasoning": true,
@@ -461,6 +473,7 @@
     "glm-5": {
       "id": "glm-5",
       "name": "GLM-5",
+      "description": "General GLM flagship for coding, analysis, and tool-heavy engineering workflows",
       "family": "glm",
       "attachment": false,
       "reasoning": true,
@@ -499,6 +512,7 @@
     "glm-5-turbo": {
       "id": "glm-5-turbo",
       "name": "GLM-5-Turbo",
+      "description": "Faster GLM-5 lane for coding agents that need lower latency",
       "family": "glm",
       "attachment": false,
       "reasoning": true,

data/lib/llm/agent.rb

@@ -61,7 +61,11 @@ module LLM
     #  Returns the current tools when no argument is provided
     def self.tools(*tools, &block)
       return @tools || [] if tools.empty? && !block
-      @tools = block || tools.flatten
+      if tools.size == 1 and tools.grep(Symbol).any?
+        @tools = tools.first
+      else
+        @tools = block || tools.flatten
+      end
     end
 
     ##
@@ -334,6 +338,15 @@ module LLM
       @tracer || @ctx.tracer
     end
 
+    ##
+    # @param [LLM::Tracer, nil] other
+    #  A tracer, or nil.
+    # @return [void]
+    def tracer=(other)
+      @ctx.tracer = other
+      @tracer = other
+    end
+
     ##
     # @return [LLM::Stream, #<<, nil]
     #  Returns a stream object, or nil
@@ -375,6 +388,33 @@ module LLM
       @ctx.context_window
     end
 
+    ##
+    # Start a minimalist repl that can interact
+    # with the agent and its current state. This
+    # method requires the 'curses' gem to be installed
+    # and available to require.
+    #
+    # @note
+    #  By default this method disables the tracer for
+    #  the duration of the repl session, and restores
+    #  it afterwards.
+    # @param [Boolean] trace
+    #  When true, the tracer is kept alive during the
+    #  repl session. Default is false.
+    # @return [void]
+    def repl(trace: false)
+      if !trace
+        previous    = tracer
+        self.tracer = nil
+      end
+      require_relative "repl" unless defined?(::LLM::Repl)
+      LLM::Repl.new(self).start
+    ensure
+      if !trace
+        self.tracer = previous
+      end
+    end
+
     ##
     # @see LLM::Context#params
     # @return [Hash]