@hiai-gg/hiai-opencode 0.1.1 → 0.1.3

package/src/tools/grep/tools.ts

@@ -1,75 +1,75 @@
-import { resolve } from "node:path"
-import type { PluginInput } from "@opencode-ai/plugin"
-import { tool, type ToolDefinition } from "@opencode-ai/plugin/tool"
-import { runRg, runRgCount } from "./cli"
-import { resolveGrepCliWithAutoInstall } from "./constants"
-import { formatGrepResult, formatCountResult } from "./result-formatter"
-
-export function createGrepTools(ctx: PluginInput): Record<string, ToolDefinition> {
-  const grep: ToolDefinition = tool({
-    description:
-      "Fast content search tool with safety limits (60s timeout, 256KB output). " +
-      "Searches file contents using regular expressions. " +
-      "Supports full regex syntax (eg. \"log.*Error\", \"function\\s+\\w+\", etc.). " +
-      "Filter files by pattern with the include parameter (eg. \"*.js\", \"*.{ts,tsx}\"). " +
-      "Output modes: \"content\" shows matching lines, \"files_with_matches\" shows only file paths (default), \"count\" shows match counts per file.",
-    args: {
-      pattern: tool.schema.string().describe("The regex pattern to search for in file contents"),
-      include: tool.schema
-        .string()
-        .optional()
-        .describe("File pattern to include in the search (e.g. \"*.js\", \"*.{ts,tsx}\")"),
-      path: tool.schema
-        .string()
-        .optional()
-        .describe("The directory to search in. Defaults to the current working directory."),
-      output_mode: tool.schema
-        .enum(["content", "files_with_matches", "count"])
-        .optional()
-        .describe(
-          "Output mode: \"content\" shows matching lines, \"files_with_matches\" shows only file paths (default), \"count\" shows match counts per file."
-        ),
-      head_limit: tool.schema
-        .number()
-        .optional()
-        .describe("Limit output to first N entries. 0 or omitted means no limit."),
-    },
-    execute: async (args, context) => {
-      try {
-        const globs = args.include ? [args.include] : undefined
-        const runtimeCtx = context as Record<string, unknown>
-        const dir = typeof runtimeCtx.directory === "string" ? runtimeCtx.directory : ctx.directory
-        const searchPath = args.path ? resolve(dir, args.path) : dir
-        const paths = [searchPath]
-        const outputMode = args.output_mode ?? "files_with_matches"
-        const headLimit = args.head_limit ?? 0
-        const cli = await resolveGrepCliWithAutoInstall()
-
-        if (outputMode === "count") {
-          const results = await runRgCount({
-            pattern: args.pattern,
-            paths,
-            globs,
-          }, cli)
-          const limited = headLimit > 0 ? results.slice(0, headLimit) : results
-          return formatCountResult(limited)
-        }
-
-        const result = await runRg({
-          pattern: args.pattern,
-          paths,
-          globs,
-          context: 0,
-          outputMode,
-          headLimit,
-        }, cli)
-
-        return formatGrepResult(result)
-      } catch (e) {
-        return `Error: ${e instanceof Error ? e.message : String(e)}`
-      }
-    },
-  })
-
-  return { grep }
-}
+import { resolve } from "node:path"
+import type { PluginInput } from "@opencode-ai/plugin"
+import { tool, type ToolDefinition } from "@opencode-ai/plugin/tool"
+import { runRg, runRgCount } from "./cli"
+import { resolveGrepCliWithAutoInstall } from "./constants"
+import { formatGrepResult, formatCountResult } from "./result-formatter"
+
+export function createGrepTools(ctx: PluginInput): Record<string, ToolDefinition> {
+  const grep: ToolDefinition = tool({
+    description:
+      "Fast content search tool with safety limits (60s timeout, 256KB output). " +
+      "Searches file contents using regular expressions. " +
+      "Supports full regex syntax (eg. \"log.*Error\", \"function\\s+\\w+\", etc.). " +
+      "Filter files by pattern with the include parameter (eg. \"*.js\", \"*.{ts,tsx}\"). " +
+      "Output modes: \"content\" shows matching lines, \"files_with_matches\" shows only file paths (default), \"count\" shows match counts per file.",
+    args: {
+      pattern: tool.schema.string().describe("The regex pattern to search for in file contents"),
+      include: tool.schema
+        .string()
+        .optional()
+        .describe("File pattern to include in the search (e.g. \"*.js\", \"*.{ts,tsx}\")"),
+      path: tool.schema
+        .string()
+        .optional()
+        .describe("The directory to search in. Defaults to the current working directory."),
+      output_mode: tool.schema
+        .enum(["content", "files_with_matches", "count"])
+        .optional()
+        .describe(
+          "Output mode: \"content\" shows matching lines, \"files_with_matches\" shows only file paths (default), \"count\" shows match counts per file."
+        ),
+      head_limit: tool.schema
+        .number()
+        .optional()
+        .describe("Limit output to first N entries. 0 or omitted means no limit."),
+    },
+    execute: async (args, context) => {
+      try {
+        const globs = args.include ? [args.include] : undefined
+        const runtimeCtx = context as Record<string, unknown>
+        const dir = typeof runtimeCtx.directory === "string" ? runtimeCtx.directory : ctx.directory
+        const searchPath = args.path ? resolve(dir, args.path) : dir
+        const paths = [searchPath]
+        const outputMode = args.output_mode ?? "files_with_matches"
+        const headLimit = args.head_limit ?? 0
+        const cli = await resolveGrepCliWithAutoInstall()
+
+        if (outputMode === "count") {
+          const results = await runRgCount({
+            pattern: args.pattern,
+            paths,
+            globs,
+          }, cli)
+          const limited = headLimit > 0 ? results.slice(0, headLimit) : results
+          return formatCountResult(limited)
+        }
+
+        const result = await runRg({
+          pattern: args.pattern,
+          paths,
+          globs,
+          context: 0,
+          outputMode,
+          headLimit,
+        }, cli)
+
+        return formatGrepResult(result)
+      } catch (e) {
+        return `Error: ${e instanceof Error ? e.message : String(e)}`
+      }
+    },
+  })
+
+  return { grep }
+}

package/src/tools/grep/types.ts

@@ -1,42 +1,42 @@
-export interface GrepMatch {
-  file: string
-  line: number
-  column?: number
-  text: string
-}
-
-export interface GrepResult {
-  matches: GrepMatch[]
-  totalMatches: number
-  filesSearched: number
-  truncated: boolean
-  error?: string
-}
-
-export interface GrepOptions {
-  pattern: string
-  paths?: string[]
-  globs?: string[]
-  excludeGlobs?: string[]
-  context?: number
-  maxDepth?: number
-  maxFilesize?: string
-  maxCount?: number
-  maxColumns?: number
-  caseSensitive?: boolean
-  wholeWord?: boolean
-  fixedStrings?: boolean
-  multiline?: boolean
-  hidden?: boolean
-  noIgnore?: boolean
-  fileType?: string[]
-  timeout?: number
-  threads?: number
-  outputMode?: "content" | "files_with_matches" | "count"
-  headLimit?: number
-}
-
-export interface CountResult {
-  file: string
-  count: number
-}
+export interface GrepMatch {
+  file: string
+  line: number
+  column?: number
+  text: string
+}
+
+export interface GrepResult {
+  matches: GrepMatch[]
+  totalMatches: number
+  filesSearched: number
+  truncated: boolean
+  error?: string
+}
+
+export interface GrepOptions {
+  pattern: string
+  paths?: string[]
+  globs?: string[]
+  excludeGlobs?: string[]
+  context?: number
+  maxDepth?: number
+  maxFilesize?: string
+  maxCount?: number
+  maxColumns?: number
+  caseSensitive?: boolean
+  wholeWord?: boolean
+  fixedStrings?: boolean
+  multiline?: boolean
+  hidden?: boolean
+  noIgnore?: boolean
+  fileType?: string[]
+  timeout?: number
+  threads?: number
+  outputMode?: "content" | "files_with_matches" | "count"
+  headLimit?: number
+}
+
+export interface CountResult {
+  file: string
+  count: number
+}

package/src/tools/hashline-edit/AGENTS.md

@@ -1,92 +1,92 @@
-# src/tools/hashline-edit/ — Hash-Anchored File Edit Tool
-
-**Generated:** 2026-04-11
-
-## OVERVIEW
-
-24 files. Implements the `hashline_edit` tool — hash-anchored file editing where every line reference includes a content hash (`LINE#ID`). Validates hashes before applying edits, rejecting stale references.
-
-## THREE-OP MODEL
-
-All edits use exactly 3 operations:
-
-| Op | pos | end | lines | Effect |
-|----|-----|-----|-------|--------|
-| `replace` | required | optional | required | Replace single line or range pos..end |
-| `append` | optional | optional | required | Insert after anchor (or EOF if no anchor) |
-| `prepend` | optional | optional | required | Insert before anchor (or BOF if no anchor) |
-
-`lines: null` or `lines: []` with `replace` = delete. `delete: true` at tool level = delete file.
-
-## EXECUTION PIPELINE
-
-```
-hashline-edit-executor.ts
-  → normalize-edits.ts       # Parse RawHashlineEdit → HashlineEdit (validate op schema)
-  → validation.ts            # Validate LINE#ID references (hash match, line exists)
-  → edit-ordering.ts         # Sort bottom-up (by line number, descending)
-  → edit-deduplication.ts    # Remove duplicate ops
-  → edit-operations.ts       # Apply each op using edit-operation-primitives.ts
-  → autocorrect-replacement-lines.ts  # Auto-fix indentation/formatting
-  → hashline-edit-diff.ts    # Build diff output using diff-utils.ts
-```
-
-## KEY FILES
-
-| File | Purpose |
-|------|---------|
-| `tools.ts` | `createHashlineEditTool()` factory — tool schema + entry point |
-| `hashline-edit-executor.ts` | Main execution: normalize → validate → order → apply → diff |
-| `normalize-edits.ts` | Parse `RawHashlineEdit[]` (allows string `op` variants) → typed `HashlineEdit[]` |
-| `validation.ts` | Validate LINE#ID: parse hash, verify line content matches stored hash |
-| `hash-computation.ts` | `computeLineHash(line)` → 2-char CID from set `ZPMQVRWSNKTXJBYH` |
-| `edit-operations.ts` | Apply replace/append/prepend to file lines array |
-| `edit-operation-primitives.ts` | Low-level line array mutation primitives |
-| `edit-ordering.ts` | Sort edits bottom-up to preserve line numbers during multi-edit |
-| `edit-deduplication.ts` | Deduplicate overlapping/identical operations |
-| `edit-text-normalization.ts` | Normalize line content (CRLF, BOM, trailing whitespace) |
-| `file-text-canonicalization.ts` | Canonicalize full file content before hashing |
-| `autocorrect-replacement-lines.ts` | Auto-restore indentation from original lines |
-| `hashline-edit-diff.ts` | Generate unified diff for error/success messages |
-| `diff-utils.ts` | Thin wrapper around `diff` npm library |
-| `hashline-chunk-formatter.ts` | Format line chunks with `LINE#ID` tags |
-| `tool-description.ts` | `HASHLINE_EDIT_DESCRIPTION` constant |
-| `types.ts` | `HashlineEdit`, `ReplaceEdit`, `AppendEdit`, `PrependEdit` |
-| `constants.ts` | Hash alphabet, separator character (`#`), pipe separator (`|`) |
-
-## LINE#ID FORMAT
-
-```
-{line_number}#{hash_id}
-```
-
-- `hash_id`: two chars from `ZPMQVRWSNKTXJBYH` (CID letters)
-- Example: `42#VK` means line 42 with hash `VK`
-- Validation: recompute hash of current line content → must match stored hash
-- Content separator: `|` (pipe) between hash tag and content in read output
-
-## AUTOCORRECT BEHAVIORS (built-in)
-
-- Merged lines auto-expanded back to original count
-- Indentation restored from original lines
-- BOM and CRLF line endings preserved
-- `>>>` prefix and diff markers in `lines` text auto-stripped
-
-## ERROR CASES
-
-- Hash mismatch → edit rejected, diff shown with current state
-- Overlapping ranges → detected and rejected
-- Missing `pos` for `replace` → schema error
-- `lines: null` with `append`/`prepend` → schema error
-
-## HOW LINE HASHES WORK
-
-```typescript
-// Reading: every line gets tagged
-"42#VK| function hello() {"
-
-// Editing: reference by tag
-{ op: "replace", pos: "42#VK", lines: "function hello(name: string) {" }
-
-// If file changed since read: hash won't match → rejected before corruption
-```
+# src/tools/hashline-edit/ — Hash-Anchored File Edit Tool
+
+**Generated:** 2026-04-11
+
+## OVERVIEW
+
+24 files. Implements the `hashline_edit` tool — hash-anchored file editing where every line reference includes a content hash (`LINE#ID`). Validates hashes before applying edits, rejecting stale references.
+
+## THREE-OP MODEL
+
+All edits use exactly 3 operations:
+
+| Op | pos | end | lines | Effect |
+|----|-----|-----|-------|--------|
+| `replace` | required | optional | required | Replace single line or range pos..end |
+| `append` | optional | optional | required | Insert after anchor (or EOF if no anchor) |
+| `prepend` | optional | optional | required | Insert before anchor (or BOF if no anchor) |
+
+`lines: null` or `lines: []` with `replace` = delete. `delete: true` at tool level = delete file.
+
+## EXECUTION PIPELINE
+
+```
+hashline-edit-executor.ts
+  → normalize-edits.ts       # Parse RawHashlineEdit → HashlineEdit (validate op schema)
+  → validation.ts            # Validate LINE#ID references (hash match, line exists)
+  → edit-ordering.ts         # Sort bottom-up (by line number, descending)
+  → edit-deduplication.ts    # Remove duplicate ops
+  → edit-operations.ts       # Apply each op using edit-operation-primitives.ts
+  → autocorrect-replacement-lines.ts  # Auto-fix indentation/formatting
+  → hashline-edit-diff.ts    # Build diff output using diff-utils.ts
+```
+
+## KEY FILES
+
+| File | Purpose |
+|------|---------|
+| `tools.ts` | `createHashlineEditTool()` factory — tool schema + entry point |
+| `hashline-edit-executor.ts` | Main execution: normalize → validate → order → apply → diff |
+| `normalize-edits.ts` | Parse `RawHashlineEdit[]` (allows string `op` variants) → typed `HashlineEdit[]` |
+| `validation.ts` | Validate LINE#ID: parse hash, verify line content matches stored hash |
+| `hash-computation.ts` | `computeLineHash(line)` → 2-char CID from set `ZPMQVRWSNKTXJBYH` |
+| `edit-operations.ts` | Apply replace/append/prepend to file lines array |
+| `edit-operation-primitives.ts` | Low-level line array mutation primitives |
+| `edit-ordering.ts` | Sort edits bottom-up to preserve line numbers during multi-edit |
+| `edit-deduplication.ts` | Deduplicate overlapping/identical operations |
+| `edit-text-normalization.ts` | Normalize line content (CRLF, BOM, trailing whitespace) |
+| `file-text-canonicalization.ts` | Canonicalize full file content before hashing |
+| `autocorrect-replacement-lines.ts` | Auto-restore indentation from original lines |
+| `hashline-edit-diff.ts` | Generate unified diff for error/success messages |
+| `diff-utils.ts` | Thin wrapper around `diff` npm library |
+| `hashline-chunk-formatter.ts` | Format line chunks with `LINE#ID` tags |
+| `tool-description.ts` | `HASHLINE_EDIT_DESCRIPTION` constant |
+| `types.ts` | `HashlineEdit`, `ReplaceEdit`, `AppendEdit`, `PrependEdit` |
+| `constants.ts` | Hash alphabet, separator character (`#`), pipe separator (`|`) |
+
+## LINE#ID FORMAT
+
+```
+{line_number}#{hash_id}
+```
+
+- `hash_id`: two chars from `ZPMQVRWSNKTXJBYH` (CID letters)
+- Example: `42#VK` means line 42 with hash `VK`
+- Validation: recompute hash of current line content → must match stored hash
+- Content separator: `|` (pipe) between hash tag and content in read output
+
+## AUTOCORRECT BEHAVIORS (built-in)
+
+- Merged lines auto-expanded back to original count
+- Indentation restored from original lines
+- BOM and CRLF line endings preserved
+- `>>>` prefix and diff markers in `lines` text auto-stripped
+
+## ERROR CASES
+
+- Hash mismatch → edit rejected, diff shown with current state
+- Overlapping ranges → detected and rejected
+- Missing `pos` for `replace` → schema error
+- `lines: null` with `append`/`prepend` → schema error
+
+## HOW LINE HASHES WORK
+
+```typescript
+// Reading: every line gets tagged
+"42#VK| function hello() {"
+
+// Editing: reference by tag
+{ op: "replace", pos: "42#VK", lines: "function hello(name: string) {" }
+
+// If file changed since read: hash won't match → rejected before corruption
+```