@link-assistant/agent 0.0.8 → 0.0.11

package/README.md

@@ -8,6 +8,7 @@
 > 🚨 **SECURITY WARNING: 100% UNSAFE AND AUTONOMOUS** 🚨
 >
 > This agent operates with **ZERO RESTRICTIONS** and **FULL AUTONOMY**:
+>
 > - ❌ **No Sandbox** - Complete unrestricted file system access
 > - ❌ **No Permissions System** - No approval required for any actions
 > - ❌ **No Safety Guardrails** - Can execute ANY command with full privileges
@@ -21,7 +22,7 @@ This is an MVP implementation of an OpenCode-compatible CLI agent, focused on ma
 
 - ✅ **JSON Input/Output**: Compatible with `opencode run --format json --model opencode/grok-code`
 - ✅ **Plain Text Input**: Also accepts plain text messages (auto-converted to JSON format)
-- ✅ **Flexible Model Selection**: Defaults to free OpenCode Zen Grok Code Fast 1, supports all [OpenCode Zen models](https://opencode.ai/docs/zen/)
+- ✅ **Flexible Model Selection**: Defaults to free OpenCode Zen Grok Code Fast 1, supports [OpenCode Zen](https://opencode.ai/docs/zen/), [Claude OAuth](docs/claude-oauth.md), and [Groq](docs/groq.md) providers
 - ✅ **No Restrictions**: Fully unrestricted file system and command execution access (no sandbox)
 - ✅ **Minimal Footprint**: Built with Bun.sh for maximum efficiency
 - ✅ **Full Tool Support**: 13 tools including websearch, codesearch, batch - all enabled by default
@@ -75,7 +76,7 @@ The agent streams events as they occur, providing the same real-time experience
 - **Plain Text Input**: Also accepts plain text messages (auto-converted to JSON format)
 - **Unrestricted Access**: Full file system and command execution access (no sandbox, no restrictions)
 - **Tool Support**: 13 tools including websearch, codesearch, batch - all enabled by default
-- **Flexible Model Selection**: Defaults to free Grok Code Fast 1, supports all [OpenCode Zen models](https://opencode.ai/docs/zen/) - see [MODELS.md](MODELS.md)
+- **Flexible Model Selection**: Defaults to free Grok Code Fast 1, supports [OpenCode Zen](https://opencode.ai/docs/zen/), [Claude OAuth](docs/claude-oauth.md), and [Groq](docs/groq.md) - see [MODELS.md](MODELS.md)
 - **Bun.sh First**: Built with Bun for maximum efficiency and minimal resource usage
 - **No TUI**: Pure JSON CLI interface for automation and integration
 - **Public Domain**: Unlicense - use it however you want
@@ -83,6 +84,7 @@ The agent streams events as they occur, providing the same real-time experience
 ## Installation
 
 **Requirements:**
+
 - [Bun](https://bun.sh) >= 1.0.0 (Node.js and Deno are NOT supported)
 
 ```bash
@@ -103,16 +105,19 @@ After installation, the `agent` command will be available globally.
 ### Simplest Examples
 
 **Plain text (easiest):**
+
 ```bash
 echo "hi" | agent
 ```
 
 **Simple JSON message:**
+
 ```bash
 echo '{"message":"hi"}' | agent
 ```
 
 **With custom model:**
+
 ```bash
 echo "hi" | agent --model opencode/grok-code
 ```
@@ -120,17 +125,20 @@ echo "hi" | agent --model opencode/grok-code
 ### More Examples
 
 **Plain Text Input:**
+
 ```bash
 echo "hello world" | agent
 echo "search the web for TypeScript news" | agent
 ```
 
 **JSON Input with tool calls:**
+
 ```bash
 echo '{"message":"run command","tools":[{"name":"bash","params":{"command":"ls -la"}}]}' | agent
 ```
 
 **Using different models:**
+
 ```bash
 # Default model (free Grok Code Fast 1)
 echo "hi" | agent
@@ -144,9 +152,30 @@ echo "hi" | agent --model opencode/sonnet        # Claude Sonnet 4.5
 echo "hi" | agent --model opencode/haiku         # Claude Haiku 4.5
 echo "hi" | agent --model opencode/opus          # Claude Opus 4.1
 echo "hi" | agent --model opencode/gemini-3-pro  # Gemini 3 Pro
+
+# Groq models (requires GROQ_API_KEY)
+echo "hi" | agent --model groq/llama-3.3-70b-versatile  # Llama 3.3 70B
+echo "hi" | agent --model groq/llama-3.1-8b-instant     # Llama 3.1 8B (fast)
+
+# Anthropic direct (requires ANTHROPIC_API_KEY)
+echo "hi" | agent --model anthropic/claude-sonnet-4-5  # Claude Sonnet 4.5
+echo "hi" | agent --model anthropic/claude-opus-4-1    # Claude Opus 4.1
+
+# Anthropic OAuth (requires Claude Pro/Max subscription)
+agent auth login                                       # Select Anthropic > Claude Pro/Max
+echo "hi" | agent --model anthropic/claude-sonnet-4-5  # Uses OAuth credentials
+
+# Use existing Claude Code CLI credentials
+echo "hi" | agent --use-existing-claude-oauth          # Reads from ~/.claude/.credentials.json
+
+# GitHub Copilot (requires Copilot subscription)
+agent auth login                                       # Select GitHub Copilot
+echo "hi" | agent --model github-copilot/gpt-4o        # Uses Copilot
 ```
 
 See [MODELS.md](MODELS.md) for complete list of available models and pricing.
+See [docs/groq.md](docs/groq.md) for Groq provider documentation.
+See [docs/claude-oauth.md](docs/claude-oauth.md) for Claude OAuth provider documentation.
 
 ### CLI Options
 
@@ -156,22 +185,65 @@ agent [options]
 Options:
   --model                        Model to use in format providerID/modelID
                                  Default: opencode/grok-code
+  --json-standard                JSON output format standard
+                                 Choices: "opencode" (default), "claude" (experimental)
+  --use-existing-claude-oauth    Use existing Claude OAuth credentials
+                                 from ~/.claude/.credentials.json
   --system-message               Full override of the system message
   --system-message-file          Full override of the system message from file
   --append-system-message        Append to the default system message
   --append-system-message-file   Append to the default system message from file
   --help                         Show help
   --version                      Show version number
+
+Commands:
+  auth login           Authenticate with a provider (Anthropic, GitHub Copilot, etc.)
+  auth logout          Remove credentials for a provider
+  auth list            List configured credentials
+  auth status          Check authentication status (experimental)
+  mcp                  MCP server commands
+```
+
+### JSON Output Standards
+
+The agent supports two JSON output format standards via the `--json-standard` option:
+
+#### OpenCode Standard (default)
+
+The OpenCode format is the default JSON output format, compatible with `opencode run --format json`:
+
+```bash
+echo "hi" | agent --json-standard opencode
+```
+
+- **Format**: Pretty-printed JSON (human-readable with indentation)
+- **Event Types**: `step_start`, `step_finish`, `text`, `tool_use`, `error`
+- **Timestamps**: Unix milliseconds (number)
+- **Session ID**: `sessionID` (camelCase)
+
+#### Claude Standard (experimental)
+
+The Claude format provides compatibility with Anthropic's Claude CLI `--output-format stream-json`:
+
+```bash
+echo "hi" | agent --json-standard claude
 ```
 
+- **Format**: NDJSON (Newline-Delimited JSON - compact, one JSON per line)
+- **Event Types**: `init`, `message`, `tool_use`, `tool_result`, `result`
+- **Timestamps**: ISO 8601 strings
+- **Session ID**: `session_id` (snake_case)
+
 ### Input Formats
 
 **Plain Text (auto-converted):**
+
 ```bash
 echo "your message here" | agent
 ```
 
 **JSON Format:**
+
 ```json
 {
   "message": "Your message here",
@@ -189,23 +261,27 @@ echo "your message here" | agent
 All 13 tools are **enabled by default** with **no configuration required**. See [TOOLS.md](TOOLS.md) for complete documentation.
 
 ### File Operations
+
 - **`read`** - Read file contents
 - **`write`** - Write files
 - **`edit`** - Edit files with string replacement
 - **`list`** - List directory contents
 
 ### Search Tools
+
 - **`glob`** - File pattern matching (`**/*.js`)
 - **`grep`** - Text search with regex support
 - **`websearch`** ✨ - Web search via Exa API (no config needed!)
 - **`codesearch`** ✨ - Code search via Exa API (no config needed!)
 
 ### Execution Tools
+
 - **`bash`** - Execute shell commands
 - **`batch`** ✨ - Batch multiple tool calls (no config needed!)
 - **`task`** - Launch subagent tasks
 
 ### Utility Tools
+
 - **`todo`** - Task tracking
 - **`webfetch`** - Fetch and process URLs
 
@@ -222,21 +298,26 @@ See [EXAMPLES.md](EXAMPLES.md) for detailed usage examples of each tool with bot
 bun test
 
 # Run specific test file
+bun test tests/mcp.test.js
 bun test tests/websearch.tools.test.js
 bun test tests/batch.tools.test.js
 bun test tests/plaintext.input.test.js
 ```
 
+For detailed testing information including how to run tests manually and trigger CI tests, see [TESTING.md](TESTING.md).
+
 ## Maintenance
 
 ### Development
 
 Run the agent in development mode:
+
 ```bash
 bun run dev
 ```
 
 Or run directly:
+
 ```bash
 bun run src/index.js
 ```
@@ -244,6 +325,7 @@ bun run src/index.js
 ### Testing
 
 Simply run:
+
 ```bash
 bun test
 ```
@@ -255,6 +337,7 @@ Bun automatically discovers and runs all `*.test.js` files in the project.
 - ✅ 13 tool implementation tests
 - ✅ Plain text input support test
 - ✅ OpenCode compatibility tests for websearch/codesearch
+- ✅ JSON standard unit tests (opencode and claude formats)
 - ✅ All tests pass with 100% OpenCode JSON format compatibility
 
 ### Publishing
@@ -262,11 +345,13 @@ Bun automatically discovers and runs all `*.test.js` files in the project.
 To publish a new version to npm:
 
 1. **Update version** in `package.json`:
+
    ```bash
    # Update version field manually (e.g., 0.0.3 -> 0.0.4)
    ```
 
 2. **Commit changes**:
+
    ```bash
    git add .
    git commit -m "Release v0.0.4"
@@ -283,18 +368,22 @@ The package publishes source files directly (no build step required). Bun handle
 ## Key Features
 
 ### No Configuration Required
+
 - **WebSearch/CodeSearch**: Work without `OPENCODE_EXPERIMENTAL_EXA` environment variable
 - **Batch Tool**: Always enabled, no experimental flag needed
 - **All Tools**: No config files, API keys handled automatically
 
 ### OpenCode 100% Compatible
+
 - All tools produce JSON output matching OpenCode's exact format
 - WebSearch and CodeSearch tools are verified 100% compatible
 - Tool event structure matches OpenCode specifications
 - Can be used as drop-in replacement for `opencode run --format json`
 
 ### Plain Text Support
+
 Both plain text and JSON input work:
+
 ```bash
 # Plain text
 echo "hello" | bun run src/index.js
@@ -306,12 +395,15 @@ echo '{"message":"hello"}' | bun run src/index.js
 Plain text is automatically converted to `{"message":"your text"}` format.
 
 ### JSON Event Streaming Output
+
 JSON output is pretty-printed for easy readability while maintaining OpenCode compatibility:
+
 ```bash
 echo "hi" | agent
 ```
 
 Output (pretty-printed JSON events):
+
 ```json
 {
   "type": "step_start",
@@ -377,6 +469,7 @@ This repository includes official reference implementations as git submodules to
 - **reference-qwen3-coder** - [Qwen3-Coder](https://github.com/QwenLM/Qwen3-Coder) - Official Qwen3 code model from Alibaba Cloud
 
 To initialize all submodules:
+
 ```bash
 git submodule update --init --recursive
 ```

package/TOOLS.md

@@ -7,24 +7,28 @@ This document lists all tools supported by `@link-assistant/agent`. All tools ar
 ## File Operations
 
 ### read
+
 Reads file contents from the filesystem.
 
 **Status:** ✅ Fully supported and tested
 **Test:** [tests/read.tools.test.js](tests/read.tools.test.js)
 
 ### write
+
 Writes content to files in the filesystem.
 
 **Status:** ✅ Fully supported and tested
 **Test:** [tests/write.tools.test.js](tests/write.tools.test.js)
 
 ### edit
+
 Performs exact string replacements in files.
 
 **Status:** ✅ Fully supported and tested
 **Test:** [tests/edit.tools.test.js](tests/edit.tools.test.js)
 
 ### list (ls)
+
 Lists files and directories.
 
 **Status:** ✅ Fully supported and tested
@@ -33,18 +37,21 @@ Lists files and directories.
 ## Search Tools
 
 ### glob
+
 Fast file pattern matching tool that works with any codebase size. Supports glob patterns like `**/*.js` or `src/**/*.ts`.
 
 **Status:** ✅ Fully supported and tested
 **Test:** [tests/glob.tools.test.js](tests/glob.tools.test.js)
 
 ### grep
+
 Powerful search tool built on ripgrep. Supports full regex syntax and can filter by file type or glob pattern.
 
 **Status:** ✅ Fully supported and tested
 **Test:** [tests/grep.tools.test.js](tests/grep.tools.test.js)
 
 ### websearch
+
 Searches the web using Exa API for current information. Always enabled, no environment variables required.
 
 **Status:** ✅ Fully supported and tested
@@ -52,6 +59,7 @@ Searches the web using Exa API for current information. Always enabled, no envir
 **OpenCode Compatibility:** ✅ 100% compatible
 
 ### codesearch
+
 Searches code repositories and documentation using Exa API. Always enabled.
 
 **Status:** ✅ Fully supported and tested
@@ -61,18 +69,21 @@ Searches code repositories and documentation using Exa API. Always enabled.
 ## Execution Tools
 
 ### bash
+
 Executes bash commands in a persistent shell session with optional timeout.
 
 **Status:** ✅ Fully supported and tested
 **Test:** [tests/bash.tools.test.js](tests/bash.tools.test.js)
 
 ### batch
+
 Batches multiple tool calls together for optimal performance. Executes multiple tools in a single operation. Always enabled.
 
 **Status:** ✅ Fully supported and tested
 **Test:** [tests/batch.tools.test.js](tests/batch.tools.test.js)
 
 ### task
+
 Launches specialized agents to handle complex, multi-step tasks autonomously.
 
 **Status:** ✅ Fully supported and tested
@@ -81,12 +92,14 @@ Launches specialized agents to handle complex, multi-step tasks autonomously.
 ## Utility Tools
 
 ### todo (todowrite/todoread)
+
 Reads and writes TODO items for task tracking during execution.
 
 **Status:** ✅ Fully supported and tested
 **Test:** [tests/todo.tools.test.js](tests/todo.tools.test.js)
 
 ### webfetch
+
 Fetches content from a specified URL and processes it using an AI model.
 
 **Status:** ✅ Fully supported and tested
@@ -95,18 +108,22 @@ Fetches content from a specified URL and processes it using an AI model.
 ## Testing
 
 ### Run All Tool Tests
+
 ```bash
 bun test tests/*.tools.test.js
 ```
 
 ### Run Specific Tool Test
+
 ```bash
 bun test tests/bash.tools.test.js
 bun test tests/websearch.tools.test.js
 ```
 
 ### Test Coverage
+
 Each tool test verifies:
+
 - ✅ Correct JSON output structure
 - ✅ OpenCode compatibility (where applicable)
 - ✅ Proper input/output handling
@@ -115,16 +132,19 @@ Each tool test verifies:
 ## Key Features
 
 ### No Configuration Required
+
 - All tools work without environment variables or configuration files
 - WebSearch and CodeSearch work without `OPENCODE_EXPERIMENTAL_EXA`
 - Batch tool is always enabled, no experimental flag needed
 
 ### OpenCode Compatible
+
 - All tools produce JSON output compatible with OpenCode's format
 - WebSearch and CodeSearch tools are 100% compatible with OpenCode output
 - Tool event structure matches OpenCode specifications
 
 ### Plain Text Input Support
+
 `@link-assistant/agent` also accepts plain text input (not just JSON):
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@link-assistant/agent",
-  "version": "0.0.8",
+  "version": "0.0.11",
   "description": "A minimal, public domain AI CLI agent compatible with OpenCode's JSON interface. Bun-only runtime.",
   "main": "src/index.js",
   "type": "module",
@@ -8,7 +8,19 @@
     "agent": "./src/index.js"
   },
   "scripts": {
-    "dev": "bun run src/index.js"
+    "dev": "bun run src/index.js",
+    "test": "bun test",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "check:file-size": "node scripts/check-file-size.mjs",
+    "check": "npm run lint && npm run format:check && npm run check:file-size",
+    "prepare": "husky || true",
+    "changeset": "changeset",
+    "changeset:version": "node scripts/changeset-version.mjs",
+    "changeset:publish": "changeset publish",
+    "changeset:status": "changeset status --since=origin/main"
   },
   "engines": {
     "bun": ">=1.0.0"
@@ -43,6 +55,7 @@
     "@agentclientprotocol/sdk": "^0.5.1",
     "@ai-sdk/mcp": "^0.0.8",
     "@ai-sdk/xai": "^2.0.33",
+    "@clack/prompts": "^0.11.0",
     "@hono/standard-validator": "^0.2.0",
     "@hono/zod-validator": "^0.7.5",
     "@modelcontextprotocol/sdk": "^1.22.0",
@@ -85,5 +98,26 @@
     "yargs": "^18.0.0",
     "zod": "^4.1.12"
   },
+  "devDependencies": {
+    "@changesets/cli": "^2.29.7",
+    "@eslint/js": "^9.18.0",
+    "eslint": "^9.38.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.4",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.2.6",
+    "prettier": "^3.6.2"
+  },
+  "lint-staged": {
+    "*.{js,mjs,cjs}": [
+      "eslint --fix --max-warnings 0",
+      "prettier --write",
+      "prettier --check"
+    ],
+    "*.md": [
+      "prettier --write",
+      "prettier --check"
+    ]
+  },
   "license": "Unlicense"
 }