@vectorize-io/hindsight-coding-agents 0.8.0 → 0.8.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +73 -8
- package/dist/antigravity-hook.js +444 -80
- package/dist/antigravity-statusline.js +9 -4
- package/dist/antigravity-stop-hook.js +444 -95
- package/dist/claude-hook.js +444 -80
- package/dist/claude-sessionstart-hook.js +476 -93
- package/dist/claude-stop-hook.js +444 -95
- package/dist/cline.js +322 -122
- package/dist/codebuddy-hook.js +4273 -0
- package/dist/codebuddy-sessionstart-hook.js +5033 -0
- package/dist/codebuddy-stop-hook.js +4567 -0
- package/dist/codex-hook.js +444 -80
- package/dist/codex-sessionstart-hook.js +476 -93
- package/dist/codex-stop-hook.js +444 -95
- package/dist/copilot-hook.js +444 -80
- package/dist/copilot-sessionstart-hook.js +476 -93
- package/dist/copilot-stop-hook.js +444 -95
- package/dist/cursor-hook.js +444 -80
- package/dist/cursor-sessionstart-hook.js +476 -93
- package/dist/cursor-stop-hook.js +444 -95
- package/dist/daemon-start.js +16 -8
- package/dist/dcode-hook.js +444 -80
- package/dist/dcode-sessionstart-hook.js +476 -93
- package/dist/dcode-stop-hook.js +444 -95
- package/dist/deepen.js +252 -79
- package/dist/devin-hook.js +444 -80
- package/dist/devin-sessionstart-hook.js +476 -93
- package/dist/devin-stop-hook.js +444 -95
- package/dist/droid-hook.js +444 -80
- package/dist/droid-sessionstart-hook.js +476 -93
- package/dist/droid-stop-hook.js +444 -95
- package/dist/dsh.js +329 -122
- package/dist/grok-hook.js +444 -80
- package/dist/grok-sessionstart-hook.js +476 -93
- package/dist/grok-stop-hook.js +444 -95
- package/dist/hindsight-seed.js +9 -4
- package/dist/index.js +331 -131
- package/dist/installer.js +1046 -647
- package/dist/kilo.js +331 -131
- package/dist/kimi-hook.js +444 -80
- package/dist/kimi-sessionstart-hook.js +476 -93
- package/dist/kimi-stop-hook.js +444 -95
- package/dist/mcp-server.js +272 -89
- package/dist/opencode2.js +328 -128
- package/dist/pi.js +384 -134
- package/dist/prime-agent.js +384 -134
- package/dist/qwen-hook.js +444 -80
- package/dist/qwen-sessionstart-hook.js +476 -93
- package/dist/qwen-stop-hook.js +444 -95
- package/dist/status.js +124 -43
- package/dist/traecode-hook.js +444 -80
- package/dist/traecode-sessionstart-hook.js +476 -93
- package/dist/traecode-stop-hook.js +444 -95
- package/dist/workbuddy-hook.js +4273 -0
- package/dist/workbuddy-sessionstart-hook.js +5033 -0
- package/dist/workbuddy-stop-hook.js +4567 -0
- package/dist/zcode-hook.js +444 -80
- package/dist/zcode-sessionstart-hook.js +476 -93
- package/dist/zcode-stop-hook.js +444 -95
- package/package.json +9 -3
- package/plugin.json +1 -1
- package/skill/SKILL.md +10 -6
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@vectorize-io/hindsight-coding-agents",
|
|
3
|
-
"version": "0.8.
|
|
3
|
+
"version": "0.8.2",
|
|
4
4
|
"repository": {
|
|
5
5
|
"type": "git",
|
|
6
6
|
"url": "https://github.com/vectorize-io/hindsight.git",
|
|
@@ -38,6 +38,12 @@
|
|
|
38
38
|
"hindsight-traecode-hook": "dist/traecode-hook.js",
|
|
39
39
|
"hindsight-traecode-sessionstart-hook": "dist/traecode-sessionstart-hook.js",
|
|
40
40
|
"hindsight-traecode-stop-hook": "dist/traecode-stop-hook.js",
|
|
41
|
+
"hindsight-workbuddy-hook": "dist/workbuddy-hook.js",
|
|
42
|
+
"hindsight-workbuddy-sessionstart-hook": "dist/workbuddy-sessionstart-hook.js",
|
|
43
|
+
"hindsight-workbuddy-stop-hook": "dist/workbuddy-stop-hook.js",
|
|
44
|
+
"hindsight-codebuddy-hook": "dist/codebuddy-hook.js",
|
|
45
|
+
"hindsight-codebuddy-sessionstart-hook": "dist/codebuddy-sessionstart-hook.js",
|
|
46
|
+
"hindsight-codebuddy-stop-hook": "dist/codebuddy-stop-hook.js",
|
|
41
47
|
"hindsight-droid-hook": "dist/droid-hook.js",
|
|
42
48
|
"hindsight-droid-sessionstart-hook": "dist/droid-sessionstart-hook.js",
|
|
43
49
|
"hindsight-droid-stop-hook": "dist/droid-stop-hook.js",
|
|
@@ -95,7 +101,7 @@
|
|
|
95
101
|
"@opencode-ai/sdk": "^1.18.9",
|
|
96
102
|
"@opencode/plugin": "^2.0.3",
|
|
97
103
|
"@types/node": "^26.1.0",
|
|
98
|
-
"@vectorize-io/hindsight-all": "^0.
|
|
104
|
+
"@vectorize-io/hindsight-all": "^0.10.2",
|
|
99
105
|
"jsonc-parser": "^3.3.1",
|
|
100
106
|
"smol-toml": "^1.8.0",
|
|
101
107
|
"tsup": "^8.3.0",
|
|
@@ -107,7 +113,7 @@
|
|
|
107
113
|
"esbuild": ">=0.25.0 <1.0.0",
|
|
108
114
|
"fast-uri": ">=3.1.6 <4.0.0",
|
|
109
115
|
"hono": ">=4.13.5 <5.0.0",
|
|
110
|
-
"ip-address": ">=10.
|
|
116
|
+
"ip-address": ">=10.5.1 <11.0.0",
|
|
111
117
|
"postcss": ">=8.5.23 <9.0.0",
|
|
112
118
|
"vite": ">=6.4.3 <7.0.0"
|
|
113
119
|
}
|
package/plugin.json
CHANGED
package/skill/SKILL.md
CHANGED
|
@@ -215,12 +215,12 @@ hook by Codex...), so one shared config serves several agents side by side:
|
|
|
215
215
|
| `reflectToolTimeoutMs` | `330000` | timeout for the agent-invoked `hindsight_reflect` tool — a call the agent waits on, whose high-budget synthesis on a populated bank runs for minutes. Defaults above the server's own reflect wall timeout (`HINDSIGHT_API_REFLECT_WALL_TIMEOUT`, 300s) so the server decides when to give up. Unset, it inherits an explicitly raised `reflectTimeoutMs`, but a short one never lowers it |
|
|
216
216
|
| `injectTimeoutMs` | `7000` | retrieval timeout in milliseconds for `autoInject: "pages"` and `autoInject: "recall"`; also the **shared** budget for page search then recall after a reflect timeout/5xx (recall gets only the time left after page search). Set e.g. `2000` to limit turn latency or `15000` for a slower self-hosted bank. Environment fallback: `HINDSIGHT_INJECT_TIMEOUT_MS`. On hook harnesses, injection must fit the host's prompt-hook timeout (30s by default); for reflect with fallback, allow for **`reflectTimeoutMs` + `injectTimeoutMs`**, and raise the host hook's `timeout` when needed |
|
|
217
217
|
| `reflectBudget` | `"high"` | reflect budget for the `hindsight_reflect` tool: `"low"`, `"mid"` or `"high"`. Drop it on a large bank where high-budget synthesis exceeds the server's wall timeout. The automatic session-start reflect always uses `"low"` to fit its hook window and is unaffected |
|
|
218
|
-
| `autoInject` | `"reflect"` | what to inject once, on the session's **first prompt**: `"reflect"` = a low-budget reflect synthesis (on timeout/5xx it falls back to page search, then recall); `"pages"` = the knowledge pages matching the prompt by search; `"recall"` = the bank's memories recalled for the prompt (what it asks for is `recallOptions`, observations by default); `"none"` = nothing — the agent searches knowledge pages first and reflects only when they are too shallow. `"pages"` and `"recall"` are retrieval only (no LLM), their time budget is `injectTimeoutMs
|
|
218
|
+
| `autoInject` | `"reflect"` | what to inject once, on the session's **first prompt**: `"reflect"` = a low-budget reflect synthesis (on timeout/5xx it falls back to page search, then recall); `"pages"` = the knowledge pages matching the prompt by search; `"recall"` = the bank's memories recalled for the prompt (what it asks for is `recallOptions`, observations by default); `"none"` = nothing — the agent searches knowledge pages first and reflects only when they are too shallow. `"pages"` and `"recall"` are retrieval only (no LLM), their time budget is `injectTimeoutMs`, and when one finds nothing for the prompt it tries again on the next one, up to 5 prompts |
|
|
219
219
|
| `autoReflect` | `true` | **deprecated** — use `autoInject`. Still honoured (`false` = `autoInject: "none"`), ignored when `autoInject` is set, and logs a deprecation warning |
|
|
220
220
|
| `pageSearchLimit` | `3` | knowledge pages ONE search returns. Applies to every search of the bank — the `autoInject: "pages"` injection, the reflect fallback, and the agent's own `hindsight_search_knowledge_pages` tool — because the limit lives on the client they all share |
|
|
221
221
|
| `recallOptions` | see description | overrides merged key-by-key into the body of every recall — the `autoInject: "recall"` source and the reflect fallback. Keys are the API's own recall parameters, passed straight through, so anything recall accepts is settable without a new option here; `query` is the one field it cannot replace. The default body is `{"types": ["observation"], "budget": "low", "max_tokens": 2000, "include": {"entities": null}}`, and what you set is merged over it one key at a time — `{"max_tokens": 4000}` changes the budget and leaves the rest alone. Observations are the consolidated layer, so they answer best per token, but a bank with **consolidation disabled never grows any** and the default recall comes back empty on it: set `{"types": ["world", "experience"]}` there, or `{"types": null}` for every type. File-only, like `retainMetadata` — an object does not flatten into an env var |
|
|
222
222
|
| `toolGuideExtra` | — | your own guidance on how the agent should treat memory, added **after** the built-in tool guide (at session start and on every refresh) and after the crediting note returned with `hindsight_search_knowledge_pages` results. It adds to the built-in text, never replaces it. Set it per harness or per bank like any other key, e.g. `"Memory is a past record, not current state: verify any claim against the code before acting on it."` |
|
|
223
|
-
| `pageRefreshEveryTurns` | `
|
|
223
|
+
| `pageRefreshEveryTurns` | `1` | refetch the knowledge pages and re-inject the page roster + tool guide every N user turns (`0` also means 1) |
|
|
224
224
|
| `pageTriggerType` | `"cron"` | when NEW knowledge pages refresh, i.e. what keeping them current costs — `"cron"` (default) on `pageTriggerCron` only and only when actually stale, `"auto-refresh"` after every consolidation that produced new material, `"manual"` never on their own. Auto-refresh is the most current and by far the most expensive: one synthesis per page per consolidation. Maps to the page's `trigger.refresh_cron`, or `trigger.refresh_after_consolidation` in the Hindsight API (`true` for auto-refresh, `false` for manual) |
|
|
225
225
|
| `pageTriggerCron` | `"H * * * *"` | schedule for `pageTriggerType: "cron"` — UTC, standard 5-field cron, e.g. `"0 3 * * *"`. The default is hourly, each page on its own hashed minute. Sets the page's `trigger.refresh_cron`, which the API treats as mutually exclusive with `refresh_after_consolidation`; a scheduled refresh is skipped when nothing changed. Write a field as `H` to give each page its own value there — see **Spreading refreshes with `H`** below |
|
|
226
226
|
| `pages` | every page | per-page configuration for the seeded knowledge pages, keyed by page name (case-insensitive): `false` skips a page entirely, `{"source_query": "..."}` seeds it with your question instead of the built-in one. Omitted, all five pages are seeded with their built-in queries. This is the supported way to own a page's wording — the plugin re-syncs a page whose live query differs from the one it is configured to have, so a query edited through the API or the control plane is replaced on the next session. A skipped page is **not deleted**: one already seeded keeps its content and stops being re-synced. The scoping clause is appended to your query too, so a reworded page cannot start reporting a dependency's decisions as this project's. File-only, like `recallOptions`; in a `banks.<id>` section it replaces the global map rather than merging into it |
|
|
@@ -688,8 +688,8 @@ event is written on those turns — nothing reflected.
|
|
|
688
688
|
`~/.hindsight/coding-agents-logs/usage.jsonl` (override `HINDSIGHT_USAGE_FILE`) — the `hindsight_*`
|
|
689
689
|
tools the agent called during that turn, and whether its reply credited Hindsight memory ("From
|
|
690
690
|
Hindsight memory"). The credit rate counts only turns that called a retrieval tool (search, list,
|
|
691
|
-
read, reflect); saving a document is not expected to be credited. Recorded
|
|
692
|
-
`retainSessions
|
|
691
|
+
read, reflect); saving a document is not expected to be credited. Recorded at the end of each turn,
|
|
692
|
+
whether or not `retainSessions` writes the session back. It never leaves your machine. Summarize it per agent with:
|
|
693
693
|
|
|
694
694
|
```bash
|
|
695
695
|
npx @vectorize-io/hindsight-coding-agents stats
|
|
@@ -718,8 +718,12 @@ delete:
|
|
|
718
718
|
"✅ completed" once its findings land. It is retained under the `survey` strategy, whose marker
|
|
719
719
|
rule extracts **nothing** from a status marker, and it drives the re-survey cadence
|
|
720
720
|
(`surveyRefreshCommits`) and `surveyBaseline` in sync status.
|
|
721
|
-
- `gitlog:<repo>` — the aggregated commit-message seed document,
|
|
722
|
-
|
|
721
|
+
- `gitlog:<repo>` — the aggregated commit-message seed document, oldest commit first. Once seeded it
|
|
722
|
+
is kept current by **appending** only the commits since the one its `gitlog-head:<sha>` tag
|
|
723
|
+
names, so a new commit costs the extraction of its own message, not of the whole log. It is
|
|
724
|
+
written in full again (bounded by `seedLimit`) only when an append cannot describe HEAD: the
|
|
725
|
+
recorded commit is no longer an ancestor of HEAD (a rebase, a force-push), more than `seedLimit`
|
|
726
|
+
commits are new, or the server cannot append safely.
|
|
723
727
|
|
|
724
728
|
### When memory seems to be missing
|
|
725
729
|
|