agent-bios 0.15.0 → 0.17.0

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.
Files changed (66) hide show
  1. package/DEPENDENCIES.md +37 -13
  2. package/README.md +421 -32
  3. package/claude/CLAUDE.md +3 -3
  4. package/claude/agents/frontier.md +1 -1
  5. package/claude/agents/sweep.md +3 -3
  6. package/claude/agents/workhorse.md +2 -2
  7. package/claude/guides/claude-prompting.md +72 -39
  8. package/claude/guides/cli-multi-model-workflow.md +33 -15
  9. package/claude/guides/gpt-prompting.md +103 -39
  10. package/claude/guides/review-request.md +27 -0
  11. package/claude/guides/session-distill-workflow.md +54 -2
  12. package/claude/guides/slide-writing/RUNBOOK.md +137 -0
  13. package/claude/guides/slide-writing/scripts/pair.py +979 -0
  14. package/claude/guides/slide-writing/scripts/render.mjs +82 -0
  15. package/claude/guides/slide-writing.md +195 -0
  16. package/claude/guides/svg-visualization-guide.md +9 -0
  17. package/claude/guides/tooling-gotchas.md +1 -1
  18. package/claude/guides/verification-discipline.md +5 -1
  19. package/claude/hooks/tooling-gotchas-hook.py +9 -14
  20. package/claude/skills/understand/SKILL.md +83 -0
  21. package/codex/AGENTS.md +3 -3
  22. package/codex/agents/frontier.toml +2 -1
  23. package/codex/agents/reviewer.toml +1 -1
  24. package/codex/agents/sweep.toml +3 -3
  25. package/codex/agents/workhorse.toml +1 -1
  26. package/codex/config-additions.toml +1 -1
  27. package/codex/guides/claude-prompting.md +72 -39
  28. package/codex/guides/cli-multi-model-workflow.md +33 -15
  29. package/codex/guides/gpt-prompting.md +103 -39
  30. package/codex/guides/review-request.md +27 -0
  31. package/codex/guides/session-distill-workflow.md +54 -2
  32. package/codex/guides/slide-writing/RUNBOOK.md +137 -0
  33. package/codex/guides/slide-writing/scripts/pair.py +979 -0
  34. package/codex/guides/slide-writing/scripts/render.mjs +82 -0
  35. package/codex/guides/slide-writing.md +195 -0
  36. package/codex/guides/svg-visualization-guide.md +9 -0
  37. package/codex/guides/tooling-gotchas.md +1 -1
  38. package/codex/guides/verification-discipline.md +5 -1
  39. package/compose/assemble.py +290 -14
  40. package/compose/bootstrap/SKILL.md +129 -0
  41. package/compose/check-domains.py +102 -9
  42. package/compose/corpus-state.py +4 -0
  43. package/compose/corpus.py +387 -0
  44. package/compose/corpus_catalog.py +931 -0
  45. package/compose/corpus_install.py +1670 -0
  46. package/compose/corpus_session.py +825 -0
  47. package/compose/corpus_store.py +1423 -0
  48. package/compose/corpus_transaction.py +256 -0
  49. package/compose/corpus_ui.py +655 -0
  50. package/compose/corpus_understand.py +522 -0
  51. package/compose/domains.json +102 -100
  52. package/compose/register-hooks.py +6 -8
  53. package/install.sh +84 -18
  54. package/launch/agent-launch.py +1413 -193
  55. package/launch/agent-launch.toml +12 -16
  56. package/launch/agent-launch.zsh +16 -2
  57. package/launch/i18n/en.toml +135 -7
  58. package/launch/i18n/ja.toml +135 -7
  59. package/launch/i18n/ko.toml +135 -7
  60. package/launch/shell_integration.py +267 -0
  61. package/learn/collect-learning.py +46 -19
  62. package/learn/migrate-learnings.py +10 -1
  63. package/package.json +13 -3
  64. package/provenance.json +1 -1
  65. package/session-cost.py +22 -2
  66. package/wrappers/codex-helm.sh +3 -3
package/package.json CHANGED
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "name": "agent-bios",
3
- "version": "0.15.0",
4
- "releaseDate": "2026-09-01",
5
- "description": "A thin, low-level instruction layer for LLM CLI agents: one set of principles and behavior whichever model you run. Deploys into $HOME by copy via an explicit `agent-bios install`.",
3
+ "version": "0.17.0",
4
+ "releaseDate": "2026-09-11",
5
+ "description": "A thin, low-level instruction layer for LLM CLI agents: one set of principles and behavior whichever model you run. Stores a private, editable corpus for explicitly activated sessions.",
6
6
  "bin": {
7
7
  "agent-bios": "install.sh"
8
8
  },
@@ -24,6 +24,7 @@
24
24
  "learn/promotions.json",
25
25
  "launch/agent-launch.zsh",
26
26
  "launch/agent-launch.py",
27
+ "launch/shell_integration.py",
27
28
  "compose/pkgid.py",
28
29
  "compose/register-hooks.py",
29
30
  "compose/assemble.py",
@@ -32,6 +33,15 @@
32
33
  "compose/corpus-state.py",
33
34
  "compose/write-update-cache.py",
34
35
  "compose/canary.sh",
36
+ "compose/corpus.py",
37
+ "compose/corpus_ui.py",
38
+ "compose/corpus_store.py",
39
+ "compose/corpus_catalog.py",
40
+ "compose/corpus_session.py",
41
+ "compose/corpus_install.py",
42
+ "compose/corpus_transaction.py",
43
+ "compose/corpus_understand.py",
44
+ "compose/bootstrap/",
35
45
  "launch/check-prompting-targets.sh",
36
46
  "learn/check-learning.py",
37
47
  "learn/collect-learning.py",
package/provenance.json CHANGED
@@ -1 +1 @@
1
- {"commit":"ff09dd50ec264eee660513f8a6768d3481a4e9c8","committedAt":"2026-09-01T14:37:00+09:00","dirty":false}
1
+ {"commit":"7b616f4ae5366b1395560b3a88556287ac36122d","committedAt":"2026-09-11T15:52:49+09:00","dirty":false}
package/session-cost.py CHANGED
@@ -18,12 +18,14 @@ the bill: measured over two real sessions here, cache read + cache write were
18
18
  92-94% of cost and output 6-8%, so context size is the cost, and the only lever
19
19
  on it is how long a session is allowed to grow before it is reset.
20
20
  """
21
- import json, sys, glob, os, itertools, tempfile
21
+ import json, sys, glob, os, itertools, tempfile, subprocess
22
22
  from datetime import datetime, timezone
23
23
 
24
24
  # $/MTok: input, output, cache_read, cache_write_5m, cache_write_1h
25
25
  PRICES = {
26
26
  "claude-fable-5": (10.0, 50.0, 1.00, 12.50, 20.0),
27
+ # Fable 5.1 model overview, verified 2026-09-08.
28
+ "claude-fable-5-1": (10.0, 50.0, 0.25, 12.50, 20.0),
27
29
  "claude-mythos-5": (10.0, 50.0, 1.00, 12.50, 20.0),
28
30
  "claude-opus-5": (5.0, 25.0, 0.50, 6.25, 10.0),
29
31
  "claude-opus-4-8": (5.0, 25.0, 0.50, 6.25, 10.0),
@@ -35,7 +37,8 @@ PRICES = {
35
37
  }
36
38
 
37
39
  def price_for(model):
38
- for k, v in PRICES.items():
40
+ # Version-specific rates take precedence over their family prefix.
41
+ for k, v in sorted(PRICES.items(), key=lambda item: len(item[0]), reverse=True):
39
42
  if model.startswith(k):
40
43
  return v
41
44
  return None
@@ -393,6 +396,23 @@ def _self_test():
393
396
  return p
394
397
 
395
398
  with tempfile.TemporaryDirectory() as td:
399
+ # A version-specific cache rate must reach the public report without
400
+ # changing the older model's rate. Run the real CLI/scan/cost path.
401
+ for model, expected in (("claude-fable-5-1", "$0.25"),
402
+ ("claude-fable-5", "$1.00")):
403
+ transcript = write(td, model + ".jsonl", [
404
+ {"type": "assistant", "message": {
405
+ "id": "cache-price", "model": model,
406
+ "usage": {"cache_read_input_tokens": 1_000_000}}},
407
+ ])
408
+ result = subprocess.run(
409
+ [sys.executable, os.path.abspath(__file__), transcript],
410
+ capture_output=True, text=True)
411
+ check(model + " cache price reaches the report",
412
+ (result.returncode,
413
+ "modeled total cost: " + expected in result.stdout),
414
+ (0, True))
415
+
396
416
  # Claude: two requests. The first is written twice as it streams, the
397
417
  # second is a sidechain that must not be counted.
398
418
  claude = write(td, "claude.jsonl", [
@@ -233,9 +233,9 @@ EOF
233
233
  if [ "$fanout" -eq 1 ]; then
234
234
  cat <<EOF
235
235
  - Fan-out is authorized when delegation gates fire; do de-minimis work directly. Native multi-agent is off unless the main is explicit Ultra.
236
- - Internal roles via codex-run --profile inherit and bounded stdin packet: WORKHORSE=gpt-5.6-terra/high/read-only-or-workspace-write; SWEEP=gpt-5.6-luna/low/read-only; REVIEWER=gpt-5.6-terra/high/read-only.
237
- - Native spawn cannot pin role/effort. Do not use native spawn_agent for FRONTIER. Use codex-run with gpt-5.6-sol/read-only and task-fit effort: max default, Ultra for divisible work, lower when cost/latency dominates.
238
- - Internal FRONTIER command base: $codex_run --profile inherit --model gpt-5.6-sol --effort <effort> --multi-agent auto --sandbox read-only --cd "\$PWD" -c agents.max_threads=$max_threads -c agents.max_depth=$max_depth. The adapter enables native multi-agent only for ultra. Send a self-contained packet on stdin; never full-history resume.
236
+ - Internal roles via codex-run --profile inherit and bounded stdin packet: WORKHORSE=gpt-5.6-terra/xhigh/read-only-or-workspace-write; SWEEP=gpt-5.6-luna/max/read-only; REVIEWER=gpt-5.6-terra/xhigh/read-only.
237
+ - Native spawn cannot pin role/effort. Do not use native spawn_agent for FRONTIER. Use codex-run with gpt-6-astra/read-only and task-fit effort: max default, Ultra for divisible work, lower when cost/latency dominates.
238
+ - Internal FRONTIER command base: $codex_run --profile inherit --model gpt-6-astra --effort <effort> --multi-agent auto --sandbox read-only --cd "\$PWD" -c agents.max_threads=$max_threads -c agents.max_depth=$max_depth. The adapter enables native multi-agent only for ultra. Send a self-contained packet on stdin; never full-history resume.
239
239
  - Run independent units in parallel; respect depth/thread limits; wait and synthesize bounded reports.
240
240
  EOF
241
241
  else