@xortex/xcode 3.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 XortexAI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,171 @@
+# XCode
+
+**AI-powered coding assistant with persistent memory.**
+
+XCode is a terminal-based AI coding assistant that leverages **XMem** — a multi-modal, multi-agentic long-term memory layer — to remember context across sessions, projects, and platforms.
+
+## 🌟 Features
+
+- **🧠 Persistent Memory**: XMem integration remembers your preferences, codebase patterns, and conversation history
+- **🤖 Multi-Model Support**: Use Claude, Gemini, Kimi K2.5, DeepSeek V3.2, and more via OpenRouter
+- **💻 Code-First Design**: Built for developers with powerful code search, editing, and analysis tools
+- **🔧 Extensible**: Plugin system for custom agents, tools, and integrations
+- **🚀 Fast & Local**: Runs in your terminal with local file system access
+
+## 📦 Installation
+
+### Quick Install (Recommended)
+
+```bash
+# Using curl
+curl -fsSL https://raw.githubusercontent.com/XortexAI/XCode/main/install.sh | bash
+
+# Or using wget
+wget -qO- https://raw.githubusercontent.com/XortexAI/XCode/main/install.sh | bash
+```
+
+### Install via npm
+
+```bash
+npm install -g @xortex/xcode
+```
+
+### Manual Installation
+
+```bash
+# 1. Clone the repository
+git clone https://github.com/XortexAI/XCode.git ~/.xcode
+
+# 2. Install dependencies
+cd ~/.xcode
+bun install  # or: npm install
+
+# 3. Create symlink
+ln -s ~/.xcode/bin/xcode ~/.local/bin/xcode
+```
+
+## 🚀 Usage
+
+### Start a Session
+
+```bash
+xcode
+```
+
+### Use Specific Models
+
+```bash
+# Gemini 2.5 Pro (recommended for coding)
+xcode --model gemini-2.5-pro
+
+# Kimi K2.5 (256K context window)
+xcode --model kimi-k2.5
+
+# DeepSeek V3.2 (strong reasoning)
+xcode --model deepseek-v3.2
+
+# Claude models (via Anthropic or OpenRouter)
+xcode --model claude-sonnet-4.6
+xcode --model claude-opus-4.6
+```
+
+### OpenRouter Mode
+
+Enable OpenRouter for access to all models:
+
+```bash
+export CLAUDE_CODE_USE_OPENROUTER=1
+export OPENROUTER_API_KEY=your-api-key
+xcode
+```
+
+## 🔧 Configuration
+
+### Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `OPENROUTER_API_KEY` | OpenRouter API key | - |
+| `ANTHROPIC_API_KEY` | Anthropic API key (for Claude) | - |
+| `GEMINI_API_KEY` | Google Gemini API key | - |
+| `XMEM_API_URL` | XMem server URL | `http://localhost:8000` |
+| `XMEM_API_KEY` | XMem API key | - |
+| `CLAUDE_CODE_USE_OPENROUTER` | Enable OpenRouter | `false` |
+
+### Setup XMem Memory Server
+
+XCode works best with the XMem memory server:
+
+```bash
+# 1. Clone and start XMem
+git clone https://github.com/XortexAI/XMem.git
+cd XMem
+pip install -e .
+cp .env.example .env
+# Edit .env with your API keys
+uvicorn src.api.app:create_app --factory --host 0.0.0.0 --port 8000
+
+# 2. In another terminal, start XCode
+export XMEM_API_URL=http://localhost:8000
+xcode
+```
+
+## 🛠️ Commands
+
+Inside XCode, use these commands:
+
+| Command | Description |
+|---------|-------------|
+| `/model <name>` | Switch AI model |
+| `/memory` | Open memory file editor |
+| `/compact` | Compact conversation context |
+| `/clear` | Clear conversation history |
+| `/quit` | Exit XCode |
+
+## 🧪 Development
+
+```bash
+# Clone the repo
+git clone https://github.com/XortexAI/XCode.git
+cd XCode
+
+# Install dependencies
+bun install
+
+# Run in development mode
+bun run start
+
+# Build for distribution
+bun run build
+```
+
+## 📚 Architecture
+
+XCode consists of:
+
+1. **Terminal UI**: React + Ink-based interactive interface
+2. **Query Engine**: Multi-turn conversation loop with tool execution
+3. **Memory Layer**: XMem integration for long-term storage
+4. **Tool System**: Extensible tools for code search, editing, bash execution
+5. **Model Router**: Unified interface for multiple LLM providers
+
+## 🤝 Contributing
+
+Contributions are welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+## 📄 License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+## 🔗 Links
+
+- **GitHub**: https://github.com/XortexAI/XCode
+- **XMem**: https://github.com/XortexAI/XMem
+- **OpenRouter**: https://openrouter.ai
+- **Documentation**: https://github.com/XortexAI/XCode/tree/main/docs
+
+---
+
+**Made with ❤️ by XortexAI**
+
+*Forget forgetting. Build with XMem.*

package/bin/xcode

@@ -0,0 +1,127 @@
+#!/usr/bin/env node
+/**
+ * XCode CLI Entry Point
+ * 
+ * This is the executable that gets installed when users run:
+ * - npm install -g @xortex/xcode
+ * - Or use the curl installer
+ */
+
+const { execSync } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+// Get the project root (where this script is located)
+const projectRoot = path.resolve(__dirname, '..');
+const mainScript = path.join(projectRoot, 'entrypoints', 'cli.tsx');
+
+// Check if bun is available
+function getRuntime() {
+  try {
+    execSync('bun --version', { stdio: 'ignore' });
+    return 'bun';
+  } catch {
+    try {
+      execSync('node --version', { stdio: 'ignore' });
+      // Check if tsx is available for Node
+      execSync('npx tsx --version', { stdio: 'ignore' });
+      return 'node';
+    } catch {
+      console.error('❌ Error: Neither Bun nor Node.js with tsx is installed.');
+      console.error('');
+      console.error('Please install one of the following:');
+      console.error('  • Bun (recommended): curl -fsSL https://bun.sh/install | bash');
+      console.error('  • Node.js + tsx: npm install -g tsx');
+      console.error('');
+      console.error('Then try running xcode again.');
+      process.exit(1);
+    }
+  }
+}
+
+// Set up environment
+process.env.XCODE_CLI = 'true';
+process.env.NODE_ENV = process.env.NODE_ENV || 'production';
+
+// Handle special commands
+const args = process.argv.slice(2);
+const command = args[0];
+
+if (command === '--version' || command === '-v') {
+  const pkg = JSON.parse(fs.readFileSync(path.join(projectRoot, 'package.json'), 'utf8'));
+  console.log(`xcode v${pkg.version}`);
+  process.exit(0);
+}
+
+if (command === '--help' || command === '-h') {
+  console.log(`
+XCode - AI-powered coding assistant with XMem memory
+
+Usage: xcode [options] [command]
+
+Options:
+  -v, --version     Show version number
+  -h, --help        Show help
+  --model <model>   Start with specific model (e.g., gemini-2.5-pro, kimi-k2.5)
+  --openrouter      Use OpenRouter for model access
+
+Commands:
+  (none)            Start interactive session
+  --model gemini-2.5-pro    Use Gemini 2.5 Pro via OpenRouter
+  --model kimi-k2.5         Use Kimi K2.5 via OpenRouter  
+  --model deepseek-v3.2     Use DeepSeek V3.2 via OpenRouter
+
+Environment Variables:
+  OPENROUTER_API_KEY      OpenRouter API key (for non-Anthropic models)
+  XMEM_API_URL           XMem memory server URL (default: http://localhost:8000)
+  XMEM_API_KEY           XMem memory API key
+  ANTHROPIC_API_KEY      Anthropic API key (for Claude models)
+  GEMINI_API_KEY         Gemini API key (for Google models)
+
+Examples:
+  xcode                                    # Start with default model
+  xcode --model gemini-2.5-pro            # Use Gemini via OpenRouter
+  OPENROUTER_API_KEY=xxx xcode --model kimi-k2.5   # Use specific API key
+`);
+  process.exit(0);
+}
+
+// Check for model argument
+const modelIndex = args.indexOf('--model');
+if (modelIndex !== -1 && args[modelIndex + 1]) {
+  const model = args[modelIndex + 1];
+  process.env.ANTHROPIC_MODEL = model;
+  
+  // If using OpenRouter models, auto-enable OpenRouter
+  const openRouterModels = ['kimi', 'deepseek', 'gemini', 'moonshot', 'google/gemini'];
+  if (openRouterModels.some(m => model.toLowerCase().includes(m.toLowerCase()))) {
+    process.env.CLAUDE_CODE_USE_OPENROUTER = 'true';
+  }
+}
+
+// Check for explicit OpenRouter flag
+if (args.includes('--openrouter')) {
+  process.env.CLAUDE_CODE_USE_OPENROUTER = 'true';
+}
+
+// Run the main application
+const runtime = getRuntime();
+
+try {
+  if (runtime === 'bun') {
+    execSync(`bun run "${mainScript}"`, {
+      cwd: projectRoot,
+      stdio: 'inherit',
+      env: process.env,
+    });
+  } else {
+    execSync(`npx tsx "${mainScript}"`, {
+      cwd: projectRoot,
+      stdio: 'inherit',
+      env: process.env,
+    });
+  }
+} catch (error) {
+  // Exit with the same code as the child process
+  process.exit(error.status || 1);
+}

package/bin/xcode-test

@@ -0,0 +1,84 @@
+#!/usr/bin/env node
+/**
+ * XCode Installation Test Script
+ * 
+ * Run this after installation to verify everything is working:
+ *   xcode-test
+ */
+
+const { execSync } = require('child_process');
+const path = require('path');
+
+const GREEN = '\x1b[32m';
+const RED = '\x1b[31m';
+const YELLOW = '\x1b[33m';
+const NC = '\x1b[0m';
+
+let passed = 0;
+let failed = 0;
+
+function test(name, fn) {
+  try {
+    fn();
+    console.log(`${GREEN}✓${NC} ${name}`);
+    passed++;
+  } catch (error) {
+    console.log(`${RED}✗${NC} ${name}`);
+    console.log(`  ${YELLOW}Error:${NC} ${error.message}`);
+    failed++;
+  }
+}
+
+console.log('🧪 Testing XCode Installation...\n');
+
+// Test 1: Check if xcode command exists
+test('xcode command is in PATH', () => {
+  execSync('which xcode', { stdio: 'ignore' });
+});
+
+// Test 2: Check if runtime exists
+test('Runtime available (Bun or Node)', () => {
+  try {
+    execSync('bun --version', { stdio: 'ignore' });
+  } catch {
+    execSync('node --version', { stdio: 'ignore' });
+  }
+});
+
+// Test 3: Check installation directory
+test('Installation directory exists', () => {
+  const fs = require('fs');
+  const installDir = path.join(require('os').homedir(), '.xcode');
+  if (!fs.existsSync(installDir)) {
+    throw new Error(`~/.xcode not found`);
+  }
+});
+
+// Test 4: Check dependencies
+test('Node modules installed', () => {
+  const fs = require('fs');
+  const nodeModules = path.join(require('os').homedir(), '.xcode', 'node_modules');
+  if (!fs.existsSync(nodeModules)) {
+    throw new Error('node_modules not found, run: cd ~/.xcode && bun install');
+  }
+});
+
+// Test 5: Version check
+test('xcode --version works', () => {
+  const output = execSync('xcode --version', { encoding: 'utf8' });
+  if (!output.includes('xcode')) {
+    throw new Error('Unexpected version output');
+  }
+});
+
+// Summary
+console.log('\n' + '─'.repeat(40));
+if (failed === 0) {
+  console.log(`${GREEN}✅ All tests passed!${NC}`);
+  console.log('\nYou can now run: xcode');
+} else {
+  console.log(`${RED}❌ ${failed} test(s) failed${NC}`);
+  console.log(`${GREEN}✓ ${passed} test(s) passed${NC}`);
+  console.log(`\n${YELLOW}Fix the issues above, then try again.${NC}`);
+  process.exit(1);
+}

package/bin/xcode.cmd

@@ -0,0 +1,31 @@
+@echo off
+:: XCode CLI for Windows
+:: Launcher script for npm global installation
+
+setlocal enabledelayedexpansion
+
+:: Get the directory where this script is located
+set "SCRIPT_DIR=%~dp0"
+set "PROJECT_ROOT=%SCRIPT_DIR%.."
+
+:: Check for Bun
+where bun >nul 2>nul
+if %errorlevel% == 0 (
+    bun run "%PROJECT_ROOT%\entrypoints\cli.tsx" %*
+    exit /b %errorlevel%
+)
+
+:: Check for Node + tsx
+where npx >nul 2>nul
+if %errorlevel% == 0 (
+    npx tsx "%PROJECT_ROOT%\entrypoints\cli.tsx" %*
+    exit /b %errorlevel%
+)
+
+echo ❌ Error: Neither Bun nor Node.js with tsx is installed.
+echo.
+echo Please install one of the following:
+echo   • Bun ^(recommended^): https://bun.sh/docs/installation
+echo   • Node.js + tsx: npm install -g tsx
+echo.
+exit /b 1

package/constants/apiLimits.ts

@@ -0,0 +1,94 @@
+/**
+ * Anthropic API Limits
+ *
+ * These constants define server-side limits enforced by the Anthropic API.
+ * Keep this file dependency-free to prevent circular imports.
+ *
+ * Last verified: 2025-12-22
+ * Source: api/api/schemas/messages/blocks/ and api/api/config.py
+ *
+ * Future: See issue #13240 for dynamic limits fetching from server.
+ */
+
+// =============================================================================
+// IMAGE LIMITS
+// =============================================================================
+
+/**
+ * Maximum base64-encoded image size (API enforced).
+ * The API rejects images where the base64 string length exceeds this value.
+ * Note: This is the base64 length, NOT raw bytes. Base64 increases size by ~33%.
+ */
+export const API_IMAGE_MAX_BASE64_SIZE = 5 * 1024 * 1024 // 5 MB
+
+/**
+ * Target raw image size to stay under base64 limit after encoding.
+ * Base64 encoding increases size by 4/3, so we derive the max raw size:
+ * raw_size * 4/3 = base64_size → raw_size = base64_size * 3/4
+ */
+export const IMAGE_TARGET_RAW_SIZE = (API_IMAGE_MAX_BASE64_SIZE * 3) / 4 // 3.75 MB
+
+/**
+ * Client-side maximum dimensions for image resizing.
+ *
+ * Note: The API internally resizes images larger than 1568px (source:
+ * encoding/full_encoding.py), but this is handled server-side and doesn't
+ * cause errors. These client-side limits (2000px) are slightly larger to
+ * preserve quality when beneficial.
+ *
+ * The API_IMAGE_MAX_BASE64_SIZE (5MB) is the actual hard limit that causes
+ * API errors if exceeded.
+ */
+export const IMAGE_MAX_WIDTH = 2000
+export const IMAGE_MAX_HEIGHT = 2000
+
+// =============================================================================
+// PDF LIMITS
+// =============================================================================
+
+/**
+ * Maximum raw PDF file size that fits within the API request limit after encoding.
+ * The API has a 32MB total request size limit. Base64 encoding increases size by
+ * ~33% (4/3), so 20MB raw → ~27MB base64, leaving room for conversation context.
+ */
+export const PDF_TARGET_RAW_SIZE = 20 * 1024 * 1024 // 20 MB
+
+/**
+ * Maximum number of pages in a PDF accepted by the API.
+ */
+export const API_PDF_MAX_PAGES = 100
+
+/**
+ * Size threshold above which PDFs are extracted into page images
+ * instead of being sent as base64 document blocks. This applies to
+ * first-party API only; non-first-party always uses extraction.
+ */
+export const PDF_EXTRACT_SIZE_THRESHOLD = 3 * 1024 * 1024 // 3 MB
+
+/**
+ * Maximum PDF file size for the page extraction path. PDFs larger than
+ * this are rejected to avoid processing extremely large files.
+ */
+export const PDF_MAX_EXTRACT_SIZE = 100 * 1024 * 1024 // 100 MB
+
+/**
+ * Max pages the Read tool will extract in a single call with the pages parameter.
+ */
+export const PDF_MAX_PAGES_PER_READ = 20
+
+/**
+ * PDFs with more pages than this get the reference treatment on @ mention
+ * instead of being inlined into context.
+ */
+export const PDF_AT_MENTION_INLINE_THRESHOLD = 10
+
+// =============================================================================
+// MEDIA LIMITS
+// =============================================================================
+
+/**
+ * Maximum number of media items (images + PDFs) allowed per API request.
+ * The API rejects requests exceeding this limit with a confusing error.
+ * We validate client-side to provide a clear error message.
+ */
+export const API_MAX_MEDIA_PER_REQUEST = 100

package/constants/betas.ts

@@ -0,0 +1,52 @@
+import { feature } from 'bun:bundle'
+
+export const CLAUDE_CODE_20250219_BETA_HEADER = 'claude-code-20250219'
+export const INTERLEAVED_THINKING_BETA_HEADER =
+  'interleaved-thinking-2025-05-14'
+export const CONTEXT_1M_BETA_HEADER = 'context-1m-2025-08-07'
+export const CONTEXT_MANAGEMENT_BETA_HEADER = 'context-management-2025-06-27'
+export const STRUCTURED_OUTPUTS_BETA_HEADER = 'structured-outputs-2025-12-15'
+export const WEB_SEARCH_BETA_HEADER = 'web-search-2025-03-05'
+// Tool search beta headers differ by provider:
+// - Claude API / Foundry: advanced-tool-use-2025-11-20
+// - Vertex AI / Bedrock: tool-search-tool-2025-10-19
+export const TOOL_SEARCH_BETA_HEADER_1P = 'advanced-tool-use-2025-11-20'
+export const TOOL_SEARCH_BETA_HEADER_3P = 'tool-search-tool-2025-10-19'
+export const EFFORT_BETA_HEADER = 'effort-2025-11-24'
+export const TASK_BUDGETS_BETA_HEADER = 'task-budgets-2026-03-13'
+export const PROMPT_CACHING_SCOPE_BETA_HEADER =
+  'prompt-caching-scope-2026-01-05'
+export const FAST_MODE_BETA_HEADER = 'fast-mode-2026-02-01'
+export const REDACT_THINKING_BETA_HEADER = 'redact-thinking-2026-02-12'
+export const TOKEN_EFFICIENT_TOOLS_BETA_HEADER =
+  'token-efficient-tools-2026-03-28'
+export const SUMMARIZE_CONNECTOR_TEXT_BETA_HEADER = feature('CONNECTOR_TEXT')
+  ? 'summarize-connector-text-2026-03-13'
+  : ''
+export const AFK_MODE_BETA_HEADER = feature('TRANSCRIPT_CLASSIFIER')
+  ? 'afk-mode-2026-01-31'
+  : ''
+export const CLI_INTERNAL_BETA_HEADER =
+  process.env.USER_TYPE === 'ant' ? 'cli-internal-2026-02-09' : ''
+export const ADVISOR_BETA_HEADER = 'advisor-tool-2026-03-01'
+
+/**
+ * Bedrock only supports a limited number of beta headers and only through
+ * extraBodyParams. This set maintains the beta strings that should be in
+ * Bedrock extraBodyParams *and not* in Bedrock headers.
+ */
+export const BEDROCK_EXTRA_PARAMS_HEADERS = new Set([
+  INTERLEAVED_THINKING_BETA_HEADER,
+  CONTEXT_1M_BETA_HEADER,
+  TOOL_SEARCH_BETA_HEADER_3P,
+])
+
+/**
+ * Betas allowed on Vertex countTokens API.
+ * Other betas will cause 400 errors.
+ */
+export const VERTEX_COUNT_TOKENS_ALLOWED_BETAS = new Set([
+  CLAUDE_CODE_20250219_BETA_HEADER,
+  INTERLEAVED_THINKING_BETA_HEADER,
+  CONTEXT_MANAGEMENT_BETA_HEADER,
+])

package/constants/common.ts

@@ -0,0 +1,33 @@
+import memoize from 'lodash-es/memoize.js'
+
+// This ensures you get the LOCAL date in ISO format
+export function getLocalISODate(): string {
+  // Check for ant-only date override
+  if (process.env.CLAUDE_CODE_OVERRIDE_DATE) {
+    return process.env.CLAUDE_CODE_OVERRIDE_DATE
+  }
+
+  const now = new Date()
+  const year = now.getFullYear()
+  const month = String(now.getMonth() + 1).padStart(2, '0')
+  const day = String(now.getDate()).padStart(2, '0')
+  return `${year}-${month}-${day}`
+}
+
+// Memoized for prompt-cache stability — captures the date once at session start.
+// The main interactive path gets this behavior via memoize(getUserContext) in
+// context.ts; simple mode (--bare) calls getSystemPrompt per-request and needs
+// an explicit memoized date to avoid busting the cached prefix at midnight.
+// When midnight rolls over, getDateChangeAttachments appends the new date at
+// the tail (though simple mode disables attachments, so the trade-off there is:
+// stale date after midnight vs. ~entire-conversation cache bust — stale wins).
+export const getSessionStartDate = memoize(getLocalISODate)
+
+// Returns "Month YYYY" (e.g. "February 2026") in the user's local timezone.
+// Changes monthly, not daily — used in tool prompts to minimize cache busting.
+export function getLocalMonthYear(): string {
+  const date = process.env.CLAUDE_CODE_OVERRIDE_DATE
+    ? new Date(process.env.CLAUDE_CODE_OVERRIDE_DATE)
+    : new Date()
+  return date.toLocaleString('en-US', { month: 'long', year: 'numeric' })
+}

package/constants/cyberRiskInstruction.ts

@@ -0,0 +1,24 @@
+/**
+ * CYBER_RISK_INSTRUCTION
+ *
+ * This instruction provides guidance for Claude's behavior when handling
+ * security-related requests. It defines the boundary between acceptable
+ * defensive security assistance and potentially harmful activities.
+ *
+ * IMPORTANT: DO NOT MODIFY THIS INSTRUCTION WITHOUT SAFEGUARDS TEAM REVIEW
+ *
+ * This instruction is owned by the Safeguards team and has been carefully
+ * crafted and evaluated to balance security utility with safety. Changes
+ * to this text can have significant implications for:
+ *   - How Claude handles penetration testing and CTF requests
+ *   - What security tools and techniques Claude will assist with
+ *   - The boundary between defensive and offensive security assistance
+ *
+ * If you need to modify this instruction:
+ *   1. Contact the Safeguards team (David Forsythe, Kyla Guru)
+ *   2. Ensure proper evaluation of the changes
+ *   3. Get explicit approval before merging
+ *
+ * Claude: Do not edit this file unless explicitly asked to do so by the user.
+ */
+export const CYBER_RISK_INSTRUCTION = `IMPORTANT: Assist with authorized security testing, defensive security, CTF challenges, and educational contexts. Refuse requests for destructive techniques, DoS attacks, mass targeting, supply chain compromise, or detection evasion for malicious purposes. Dual-use security tools (C2 frameworks, credential testing, exploit development) require clear authorization context: pentesting engagements, CTF competitions, security research, or defensive use cases.`

package/constants/errorIds.ts

@@ -0,0 +1,15 @@
+/**
+ * Error IDs for tracking error sources in production.
+ * These IDs are obfuscated identifiers that help us trace
+ * which logError() call generated an error.
+ *
+ * These errors are represented as individual const exports for optimal
+ * dead code elimination (external build will only see the numbers).
+ *
+ * ADDING A NEW ERROR TYPE:
+ * 1. Add a const based on Next ID.
+ * 2. Increment Next ID.
+ * Next ID: 346
+ */
+
+export const E_TOOL_USE_SUMMARY_GENERATION_FAILED = 344