hankweave 0.5.7 → 0.6.2

package/dist/shims/gemini/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "gemini-cli-shim",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "bin": {
+    "gemini-cli-shim": "./index.js"
+  },
+  "files": [
+    "common",
+    "dist",
+    "docs",
+    "src",
+    "tests",
+    "index.js",
+    "README.md",
+    "THIRDPARTY.md",
+    "VERSION",
+    "rebuild.sh",
+    "tsconfig.json"
+  ],
+  "scripts": {
+    "build": "esbuild src/index.ts --bundle --platform=node --format=esm --target=node20 --outfile=dist/index.js --banner:js='#!/usr/bin/env node'",
+    "test": "bun test",
+    "typecheck": "tsc --noEmit",
+    "clean": "node -e \"const fs=require('node:fs'); fs.rmSync('dist',{recursive:true,force:true}); fs.rmSync('index.js',{force:true});\""
+  },
+  "dependencies": {
+    "@shims/common": "file:./common"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "@types/node": "^20.19.37",
+    "esbuild": "^0.27.0",
+    "typescript": "^5.9.3"
+  }
+}

package/dist/shims/opencode/README.md

@@ -0,0 +1,82 @@
+# opencode-shim
+
+A self-contained Hankweave shim package for the OpenCode CLI.
+
+This package wraps `opencode run --format json` and translates OpenCode events into the shim JSONL protocol expected by Hankweave and the eval suite.
+
+## What this package contains
+
+- `index.js` — drop-in compiled bundle for Hankweave
+- `dist/index.js` — normal build output
+- `src/` — shim source
+- `common/` — vendored `@shims/common`
+- `docs/` — usage, architecture, and validation notes
+- `rebuild.sh` — reinstalls deps, rebuilds, refreshes `VERSION`, and updates `index.js`
+
+## Quick start
+
+```bash
+cd shim
+./rebuild.sh
+
+echo "Say hello" | bun ./index.js --model google/gemini-2.5-flash
+```
+
+## Requirements
+
+- Bun
+- Node.js
+- OpenCode CLI available on PATH, or `OPENCODE_BIN` pointing to the executable
+- Provider auth available to OpenCode, typically via environment variables such as:
+  - `GOOGLE_API_KEY`
+  - `ANTHROPIC_API_KEY`
+  - `OPENAI_API_KEY`
+
+## Common commands
+
+### Rebuild the package
+
+```bash
+./rebuild.sh
+```
+
+### Run the shim
+
+```bash
+echo "Summarize this repository" | bun ./index.js --model google/gemini-2.5-flash
+```
+
+### Run self-test
+
+```bash
+bun ./index.js --self-test
+```
+
+### Run tests
+
+```bash
+bun test
+bun run typecheck
+```
+
+## Key behavior
+
+- Emits spec-compliant JSONL with `system` first and `result` last
+- Uses OpenCode native sessions by title when `--debug-dir` is not provided
+- Stores shim-managed session mappings only under `<debug-dir>/sessions/` when `--debug-dir` is provided
+- Forces headless permissions via `OPENCODE_CONFIG_CONTENT` without writing `opencode.json` into the workspace
+- Normalizes tool names and emits public `toolu_*` IDs instead of leaking native OpenCode `callID` values
+- Uses adaptive timeouts with a longer busy-step timeout than pre-work idle timeout
+- Requires a terminal OpenCode `step_finish` with `reason: "stop"` before reporting success
+- Includes Gemini/OpenCode retry hardening for empty cached responses and stale-workspace tool paths
+- Accepts `--sandbox`, but OpenCode `run` mode currently has no documented equivalent sandbox flag, so non-`none` values are logged and otherwise ignored
+
+## Documentation
+
+- `docs/USAGE.md` — CLI usage and behavior
+- `docs/ARCHITECTURE.md` — code layout and event flow
+- `docs/VALIDATION.md` — test and eval results
+
+## Packaging notes
+
+This is a thin subprocess shim. It does **not** bundle the OpenCode CLI itself. The generated `VERSION` file therefore contains `n/a`.

package/dist/shims/opencode/THIRDPARTY.md

@@ -0,0 +1,32 @@
+# Third-party notices
+
+## Primary SDK dependency
+
+This shim is a **thin subprocess wrapper** around the external OpenCode CLI.
+
+- Primary bundled SDK dependency: **none**
+- `VERSION`: `n/a`
+
+The compiled `index.js` bundle does **not** embed the OpenCode CLI itself. OpenCode must be installed separately and discovered at runtime via PATH or `OPENCODE_BIN`.
+
+## Bundled vendored dependency
+
+### `@shims/common`
+
+- Package: `@shims/common`
+- Version: `1.0.0`
+- Source: vendored from the local Hankweave shims workspace into `./common`
+- License metadata: not declared in `common/package.json`
+- Notes: this is a project-local shared utility package used for argument parsing, timeout handling, message typing, and session helpers
+
+## External runtime dependency
+
+### OpenCode CLI
+
+- Package/runtime: `opencode`
+- Bundled in `index.js`: **no**
+- License: see the OpenCode npm package and/or source repository
+
+## Full license texts
+
+For third-party components, consult the package metadata and source repositories distributed with those dependencies. For OpenCode specifically, use the license text published in the upstream package or repository because the CLI is not bundled into this shim package.

package/dist/shims/opencode/VERSION

@@ -0,0 +1 @@
+n/a

package/dist/shims/opencode/common/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "@shims/common",
+  "version": "1.0.0",
+  "description": "Shared utilities for agent shims",
+  "type": "module",
+  "main": "./src/index.ts",
+  "exports": {
+    ".": "./src/index.ts",
+    "./args": "./src/args.ts",
+    "./messages": "./src/messages.ts",
+    "./tools": "./src/tools.ts",
+    "./sessions": "./src/sessions.ts",
+    "./timeout": "./src/timeout.ts"
+  },
+  "scripts": {
+    "test": "bun test",
+    "typecheck": "tsc --noEmit",
+    "clean": "echo 'No build artifacts to clean'"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "typescript": "^5.3.0"
+  }
+}