@link-assistant/agent 0.0.8

package/EXAMPLES.md

@@ -0,0 +1,383 @@
+# Usage Examples
+
+This document provides practical examples for using each tool with both `@link-assistant/agent` and `opencode` commands.
+
+> ⚠️ **Bun-only** - `@link-assistant/agent` requires [Bun](https://bun.sh) and does NOT support Node.js or Deno.
+
+## Table of Contents
+
+- [Basic Usage](#basic-usage)
+- [File Operations](#file-operations)
+- [Search Tools](#search-tools)
+- [Execution Tools](#execution-tools)
+- [Utility Tools](#utility-tools)
+
+## Basic Usage
+
+### Simplest Examples - Start Here!
+
+**Plain text (@link-assistant/agent only, easiest!):**
+```bash
+echo "hi" | agent
+```
+
+**Simple JSON message (both @link-assistant/agent and opencode):**
+
+@link-assistant/agent:
+```bash
+echo '{"message":"hi"}' | agent
+```
+
+opencode:
+```bash
+echo '{"message":"hi"}' | opencode run --format json --model opencode/grok-code
+```
+
+### Plain Text Input (@link-assistant/agent only)
+
+```bash
+# Simple message
+echo "hello world" | agent
+
+# Ask a question
+echo "what is TypeScript?" | agent
+
+# Request web search
+echo "search the web for latest React news" | agent
+```
+
+### JSON Input Examples
+
+**@link-assistant/agent:**
+```bash
+echo '{"message":"hello world"}' | agent
+```
+
+**opencode:**
+```bash
+echo '{"message":"hello world"}' | opencode run --format json --model opencode/grok-code
+```
+
+## File Operations
+
+### bash Tool
+
+Execute shell commands.
+
+**@link-assistant/agent:**
+```bash
+echo '{"message":"run command","tools":[{"name":"bash","params":{"command":"echo hello world"}}]}' | agent
+```
+
+**opencode:**
+```bash
+echo '{"message":"run command","tools":[{"name":"bash","params":{"command":"echo hello world"}}]}' | opencode run --format json --model opencode/grok-code
+```
+
+**Example with description:**
+```bash
+echo '{"message":"list files","tools":[{"name":"bash","params":{"command":"ls -la","description":"List all files in current directory"}}]}' | agent
+```
+
+### read Tool
+
+Read file contents.
+
+**@link-assistant/agent:**
+```bash
+echo '{"message":"read file","tools":[{"name":"read","params":{"file_path":"/path/to/file.txt"}}]}' | agent
+```
+
+**opencode:**
+```bash
+echo '{"message":"read file","tools":[{"name":"read","params":{"file_path":"/path/to/file.txt"}}]}' | opencode run --format json --model opencode/grok-code
+```
+
+### write Tool
+
+Write content to a file.
+
+**@link-assistant/agent:**
+```bash
+echo '{"message":"write file","tools":[{"name":"write","params":{"file_path":"/tmp/test.txt","content":"Hello World"}}]}' | agent
+```
+
+**opencode:**
+```bash
+echo '{"message":"write file","tools":[{"name":"write","params":{"file_path":"/tmp/test.txt","content":"Hello World"}}]}' | opencode run --format json --model opencode/grok-code
+```
+
+### edit Tool
+
+Edit file with string replacement.
+
+**@link-assistant/agent:**
+```bash
+echo '{"message":"edit file","tools":[{"name":"edit","params":{"file_path":"/tmp/test.txt","old_string":"Hello","new_string":"Hi"}}]}' | agent
+```
+
+**opencode:**
+```bash
+echo '{"message":"edit file","tools":[{"name":"edit","params":{"file_path":"/tmp/test.txt","old_string":"Hello","new_string":"Hi"}}]}' | opencode run --format json --model opencode/grok-code
+```
+
+### list Tool
+
+List directory contents.
+
+**@link-assistant/agent:**
+```bash
+echo '{"message":"list directory","tools":[{"name":"list","params":{"path":"."}}]}' | agent
+```
+
+**opencode:**
+```bash
+echo '{"message":"list directory","tools":[{"name":"list","params":{"path":"."}}]}' | opencode run --format json --model opencode/grok-code
+```
+
+## Search Tools
+
+### glob Tool
+
+Find files using glob patterns.
+
+**@link-assistant/agent:**
+```bash
+# Find all JavaScript files
+echo '{"message":"find js files","tools":[{"name":"glob","params":{"pattern":"**/*.js"}}]}' | agent
+
+# Find TypeScript files in src directory
+echo '{"message":"find ts files","tools":[{"name":"glob","params":{"pattern":"src/**/*.ts"}}]}' | agent
+```
+
+**opencode:**
+```bash
+echo '{"message":"find js files","tools":[{"name":"glob","params":{"pattern":"**/*.js"}}]}' | opencode run --format json --model opencode/grok-code
+```
+
+### grep Tool
+
+Search text in files with regex.
+
+**@link-assistant/agent:**
+```bash
+# Search for pattern in files
+echo '{"message":"search pattern","tools":[{"name":"grep","params":{"pattern":"function","output_mode":"files_with_matches"}}]}' | agent
+
+# Search with content display
+echo '{"message":"search TODO","tools":[{"name":"grep","params":{"pattern":"TODO","output_mode":"content"}}]}' | agent
+
+# Case-insensitive search in JavaScript files
+echo '{"message":"search error","tools":[{"name":"grep","params":{"pattern":"error","-i":true,"type":"js","output_mode":"content"}}]}' | agent
+```
+
+**opencode:**
+```bash
+echo '{"message":"search pattern","tools":[{"name":"grep","params":{"pattern":"TODO","output_mode":"content"}}]}' | opencode run --format json --model opencode/grok-code
+```
+
+### websearch Tool
+
+Search the web using Exa API.
+
+**@link-assistant/agent (no environment variable needed!):**
+```bash
+echo '{"message":"search web","tools":[{"name":"websearch","params":{"query":"TypeScript latest features"}}]}' | agent
+
+echo '{"message":"search web","tools":[{"name":"websearch","params":{"query":"React hooks best practices"}}]}' | agent
+```
+
+**opencode (requires OPENCODE_EXPERIMENTAL_EXA=true):**
+```bash
+echo '{"message":"search web","tools":[{"name":"websearch","params":{"query":"TypeScript latest features"}}]}' | OPENCODE_EXPERIMENTAL_EXA=true opencode run --format json --model opencode/grok-code
+```
+
+### codesearch Tool
+
+Search code repositories and documentation.
+
+**@link-assistant/agent (no environment variable needed!):**
+```bash
+echo '{"message":"search code","tools":[{"name":"codesearch","params":{"query":"React hooks implementation"}}]}' | agent
+
+echo '{"message":"search code","tools":[{"name":"codesearch","params":{"query":"async/await patterns"}}]}' | agent
+```
+
+**opencode (requires OPENCODE_EXPERIMENTAL_EXA=true):**
+```bash
+echo '{"message":"search code","tools":[{"name":"codesearch","params":{"query":"React hooks implementation"}}]}' | OPENCODE_EXPERIMENTAL_EXA=true opencode run --format json --model opencode/grok-code
+```
+
+## Execution Tools
+
+### batch Tool
+
+Batch multiple tool calls together for optimal performance.
+
+**@link-assistant/agent (no configuration needed!):**
+```bash
+echo '{"message":"run batch","tools":[{"name":"batch","params":{"tool_calls":[{"tool":"bash","parameters":{"command":"echo hello"}},{"tool":"bash","parameters":{"command":"echo world"}}]}}]}' | agent
+```
+
+**opencode (requires experimental config):**
+```bash
+# Create config file first
+mkdir -p .opencode
+echo '{"experimental":{"batch_tool":true}}' > .opencode/config.json
+
+# Then run
+echo '{"message":"run batch","tools":[{"name":"batch","params":{"tool_calls":[{"tool":"bash","parameters":{"command":"echo hello"}},{"tool":"bash","parameters":{"command":"echo world"}}]}}]}' | opencode run --format json --model opencode/grok-code
+```
+
+### task Tool
+
+Launch specialized agents for complex tasks.
+
+**@link-assistant/agent:**
+```bash
+echo '{"message":"launch task","tools":[{"name":"task","params":{"description":"Analyze codebase","prompt":"Find all TODO comments in JavaScript files","subagent_type":"general-purpose"}}]}' | agent
+```
+
+**opencode:**
+```bash
+echo '{"message":"launch task","tools":[{"name":"task","params":{"description":"Analyze codebase","prompt":"Find all TODO comments in JavaScript files","subagent_type":"general-purpose"}}]}' | opencode run --format json --model opencode/grok-code
+```
+
+## Utility Tools
+
+### todo Tool
+
+Read and write TODO items for task tracking.
+
+**@link-assistant/agent:**
+```bash
+# Write todos
+echo '{"message":"add todos","tools":[{"name":"todowrite","params":{"todos":[{"content":"Implement feature X","status":"pending","activeForm":"Implementing feature X"},{"content":"Write tests","status":"pending","activeForm":"Writing tests"}]}}]}' | agent
+
+# Read todos
+echo '{"message":"read todos","tools":[{"name":"todoread","params":{}}]}' | agent
+```
+
+**opencode:**
+```bash
+echo '{"message":"add todos","tools":[{"name":"todowrite","params":{"todos":[{"content":"Implement feature X","status":"pending","activeForm":"Implementing feature X"}]}}]}' | opencode run --format json --model opencode/grok-code
+```
+
+### webfetch Tool
+
+Fetch and process web content.
+
+**@link-assistant/agent:**
+```bash
+echo '{"message":"fetch url","tools":[{"name":"webfetch","params":{"url":"https://example.com","prompt":"Summarize the content"}}]}' | agent
+```
+
+**opencode:**
+```bash
+echo '{"message":"fetch url","tools":[{"name":"webfetch","params":{"url":"https://example.com","prompt":"Summarize the content"}}]}' | opencode run --format json --model opencode/grok-code
+```
+
+## Output Format
+
+### JSON Event Streaming (Pretty-Printed)
+
+@link-assistant/agent outputs JSON events in pretty-printed streaming format for easy readability, 100% compatible with OpenCode's event structure:
+
+```bash
+echo "hi" | agent
+```
+
+Output (pretty-printed JSON events):
+```json
+{
+  "type": "step_start",
+  "timestamp": 1763618628840,
+  "sessionID": "ses_560236487ffe3ROK1ThWvPwTEF",
+  "part": {
+    "id": "prt_a9fdca4e8001APEs6AriJx67me",
+    "type": "step-start",
+    ...
+  }
+}
+{
+  "type": "text",
+  "timestamp": 1763618629886,
+  "sessionID": "ses_560236487ffe3ROK1ThWvPwTEF",
+  "part": {
+    "type": "text",
+    "text": "Hi! How can I help with your coding tasks today?",
+    ...
+  }
+}
+{
+  "type": "step_finish",
+  "timestamp": 1763618629916,
+  "sessionID": "ses_560236487ffe3ROK1ThWvPwTEF",
+  "part": {
+    "type": "step-finish",
+    "reason": "stop",
+    ...
+  }
+}
+```
+
+This format is designed for:
+- **Readability**: Pretty-printed JSON is easy to read and debug
+- **Streaming**: Events output in real-time as they occur
+- **Compatibility**: 100% compatible with OpenCode's event structure
+- **Automation**: Can be parsed using standard JSON tools (see filtering examples below)
+
+### Filtering Output
+
+Extract specific event types using `jq`:
+
+```bash
+# Get only text responses
+echo '{"message":"hello"}' | agent | jq -r 'select(.type=="text") | .part.text'
+
+# Get tool use events
+echo '{"message":"run","tools":[{"name":"bash","params":{"command":"ls"}}]}' | agent | jq 'select(.type=="tool_use")'
+
+# Get bash tool output
+echo '{"message":"run","tools":[{"name":"bash","params":{"command":"echo test"}}]}' | agent | jq -r 'select(.type=="tool_use" and .part.tool=="bash") | .part.state.output'
+
+# Pretty print all events
+echo "hello" | agent | jq
+```
+
+## Tips
+
+### @link-assistant/agent Advantages
+
+1. **No Configuration**: WebSearch, CodeSearch, and Batch tools work without any setup
+2. **Plain Text Input**: Can use simple text instead of JSON
+3. **Always Enabled**: All tools available by default
+4. **Bun-only**: Optimized for Bun runtime (no Node.js/Deno overhead)
+
+### Working with JSON
+
+Use single quotes for the outer shell command and double quotes inside JSON:
+
+```bash
+echo '{"message":"test","tools":[{"name":"bash","params":{"command":"echo hello"}}]}' | agent
+```
+
+### Debugging
+
+Add `| jq` to prettify JSON output:
+
+```bash
+echo "hello" | agent | jq
+```
+
+### Chaining Commands
+
+Process output with standard Unix tools:
+
+```bash
+# Count events
+echo "hello" | agent | wc -l
+
+# Filter and format
+echo "hello" | agent | jq -r 'select(.type=="text") | .part.text'
+```

package/LICENSE

@@ -0,0 +1,24 @@
+This is free and unencumbered software released into the public domain.
+
+Anyone is free to copy, modify, publish, use, compile, sell, or
+distribute this software, either in source code form or as a compiled
+binary, for any purpose, commercial or non-commercial, and by any
+means.
+
+In jurisdictions that recognize copyright laws, the author or authors
+of this software dedicate any and all copyright interest in the
+software to the public domain. We make this dedication for the benefit
+of the public at large and to the detriment of our heirs and
+successors. We intend this dedication to be an overt act of
+relinquishment in perpetuity of all present and future rights to this
+software under copyright law.
+
+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 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.
+
+For more information, please refer to <https://unlicense.org>

package/MODELS.md

@@ -0,0 +1,95 @@
+# Models
+
+This agent uses models from the [OpenCode Zen](https://opencode.ai/docs/zen/) subscription service. OpenCode Zen provides access to a wide variety of AI models through a unified API.
+
+## Available Models
+
+All models are accessed using the format `opencode/<model-id>`. Use the `--model` option to specify which model to use:
+
+```bash
+echo "hi" | agent --model opencode/grok-code
+```
+
+## OpenCode Zen Pricing
+
+Below are the prices per 1M tokens for OpenCode Zen models. Models are sorted by output price (lowest first) for best pricing visibility.
+
+| Model | Model ID | Input | Output | Cached Read | Cached Write |
+|-------|----------|-------|--------|-------------|--------------|
+| **Free Models (Output: $0.00)** |
+| Grok Code Fast 1 | `opencode/grok-code` | Free | Free | Free | - |
+| GPT 5 Nano | `opencode/gpt-5-nano` | Free | Free | Free | - |
+| Big Pickle | `opencode/big-pickle` | Free | Free | Free | - |
+| **Paid Models (sorted by output price)** |
+| Qwen3 Coder 480B | `opencode/qwen3-coder-480b` | $0.45 | $1.50 | - | - |
+| GLM 4.6 | `opencode/glm-4-6` | $0.60 | $2.20 | $0.10 | - |
+| Kimi K2 | `opencode/kimi-k2` | $0.60 | $2.50 | $0.36 | - |
+| Claude Haiku 3.5 | `opencode/claude-haiku-3-5` | $0.80 | $4.00 | $0.08 | $1.00 |
+| Claude Haiku 4.5 | `opencode/haiku` | $1.00 | $5.00 | $0.10 | $1.25 |
+| GPT 5.1 | `opencode/gpt-5-1` | $1.25 | $10.00 | $0.125 | - |
+| GPT 5.1 Codex | `opencode/gpt-5-1-codex` | $1.25 | $10.00 | $0.125 | - |
+| GPT 5 | `opencode/gpt-5` | $1.25 | $10.00 | $0.125 | - |
+| GPT 5 Codex | `opencode/gpt-5-codex` | $1.25 | $10.00 | $0.125 | - |
+| Gemini 3 Pro (≤ 200K tokens) | `opencode/gemini-3-pro` | $2.00 | $12.00 | $0.20 | - |
+| Claude Sonnet 4.5 (≤ 200K tokens) | `opencode/sonnet` | $3.00 | $15.00 | $0.30 | $3.75 |
+| Claude Sonnet 4 (≤ 200K tokens) | `opencode/claude-sonnet-4` | $3.00 | $15.00 | $0.30 | $3.75 |
+| Gemini 3 Pro (> 200K tokens) | `opencode/gemini-3-pro` | $4.00 | $18.00 | $0.40 | - |
+| Claude Sonnet 4.5 (> 200K tokens) | `opencode/sonnet` | $6.00 | $22.50 | $0.60 | $7.50 |
+| Claude Sonnet 4 (> 200K tokens) | `opencode/claude-sonnet-4` | $6.00 | $22.50 | $0.60 | $7.50 |
+| Claude Opus 4.1 | `opencode/opus` | $15.00 | $75.00 | $1.50 | $18.75 |
+
+## Default Model
+
+The default model is **Grok Code Fast 1** (`opencode/grok-code`), which is completely free. This model provides excellent performance for coding tasks with no cost.
+
+## Usage Examples
+
+### Using the Default Model (Free)
+
+```bash
+# Uses opencode/grok-code by default
+echo "hello" | agent
+```
+
+### Using Other Free Models
+
+```bash
+# Big Pickle (free)
+echo "hello" | agent --model opencode/big-pickle
+
+# GPT 5 Nano (free)
+echo "hello" | agent --model opencode/gpt-5-nano
+```
+
+### Using Paid Models
+
+```bash
+# Claude Sonnet 4.5 (best quality)
+echo "hello" | agent --model opencode/sonnet
+
+# Claude Haiku 4.5 (fast and affordable)
+echo "hello" | agent --model opencode/haiku
+
+# Claude Opus 4.1 (most capable)
+echo "hello" | agent --model opencode/opus
+
+# Gemini 3 Pro
+echo "hello" | agent --model opencode/gemini-3-pro
+
+# GPT 5.1
+echo "hello" | agent --model opencode/gpt-5-1
+
+# Qwen3 Coder (specialized for coding)
+echo "hello" | agent --model opencode/qwen3-coder-480b
+```
+
+## More Information
+
+For complete details about OpenCode Zen subscription and pricing, visit the [OpenCode Zen Documentation](https://opencode.ai/docs/zen/).
+
+## Notes
+
+- All prices are per 1 million tokens
+- Cache pricing applies when using prompt caching features
+- Token context limits vary by model
+- Free models have no token costs but may have rate limits