@forwardimpact/libutil 0.1.89 → 0.1.91

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/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@forwardimpact/libutil",
3
- "version": "0.1.89",
3
+ "version": "0.1.91",
4
4
  "description": "Cross-cutting utilities: retry, hashing, token counting, and project discovery.",
5
5
  "keywords": [
6
6
  "util",
@@ -21,6 +21,7 @@
21
21
  "main": "./src/index.js",
22
22
  "exports": {
23
23
  ".": "./src/index.js",
24
+ "./models": "./src/models.js",
24
25
  "./runtime": "./src/runtime.js",
25
26
  "./trusted-origins": "./src/trusted-origins.js",
26
27
  "./completion-ticket": "./src/completion-ticket.js",
package/src/models.js ADDED
@@ -0,0 +1,46 @@
1
+ /**
2
+ * Canonical Claude model identifiers, named by role. One home for every
3
+ * model default in the monorepo — a model upgrade edits the values here
4
+ * (plus any docs flagged by `scripts/check-model-defaults.mjs`) and
5
+ * nothing else.
6
+ *
7
+ * Markdown docs cannot import these constants, so the invariant script
8
+ * cross-checks every model ID mentioned in docs and skills against the
9
+ * values exported below.
10
+ */
11
+
12
+ /**
13
+ * Long-horizon agents under direct evaluation (eval sessions) — most
14
+ * capable model with the 1M-context suffix.
15
+ */
16
+ export const AGENT_MODEL = "claude-fable-5[1m]";
17
+
18
+ /**
19
+ * Lead roles — supervisor, facilitator, discussion lead, benchmark
20
+ * lead, and judge. Leads orchestrate whole multi-agent sessions, so
21
+ * they get the most capable model with the 1M-context suffix. The
22
+ * suffix is an Agent SDK identifier; use CHAT_MODEL or FAST_MODEL for
23
+ * direct Messages API calls.
24
+ */
25
+ export const LEAD_MODEL = "claude-fable-5[1m]";
26
+
27
+ /**
28
+ * Benchmark agent-under-test — a pinned reference model so pass@k
29
+ * results stay comparable across runs. Deliberately separate from
30
+ * AGENT_MODEL: upgrading the agent tier must not silently move the
31
+ * benchmark baseline.
32
+ */
33
+ export const BENCHMARK_AGENT_MODEL = "claude-sonnet-4-6";
34
+
35
+ /**
36
+ * Interactive chat (fit-guide) and direct Messages API calls — best
37
+ * speed/intelligence balance, valid both as an Agent SDK and a raw
38
+ * API model ID.
39
+ */
40
+ export const CHAT_MODEL = "claude-sonnet-4-6";
41
+
42
+ /**
43
+ * Cheap mechanical tasks (wiki prose fixes, synthetic-data generation)
44
+ * — fastest and most cost-effective model.
45
+ */
46
+ export const FAST_MODEL = "claude-haiku-4-5";
package/src/runtime.js CHANGED
@@ -20,7 +20,7 @@ import { Finder } from "./finder.js";
20
20
  * @property {Object} fs
21
21
  * Async filesystem surface (the `node:fs/promises` shape): `readFile`,
22
22
  * `writeFile`, `readdir`, `stat`, `mkdir`, `access`, `copyFile`, `cp`, `rm`,
23
- * `lstat`, `unlink`, `symlink`, `utimes`, `chmod`, plus the two stream
23
+ * `lstat`, `unlink`, `rename`, `symlink`, `utimes`, `chmod`, plus the two stream
24
24
  * factories `createReadStream` / `createWriteStream` (the `node:fs` shape —
25
25
  * the promises API has no stream factories, so they live on the async
26
26
  * surface as the canonical streaming seam). A module destructures `fs` xor