agent-bios 0.18.0 → 0.19.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 (53) hide show
  1. package/DEPENDENCIES.md +236 -80
  2. package/INSTALL.md +112 -0
  3. package/README.md +184 -524
  4. package/claude/CLAUDE.md +1 -1
  5. package/claude/guides/cli-multi-model-workflow.md +1 -1
  6. package/claude/guides/learning-flow.md +23 -12
  7. package/claude/guides/session-distill-workflow.md +22 -12
  8. package/codex/AGENTS.md +1 -1
  9. package/codex/guides/cli-multi-model-workflow.md +1 -1
  10. package/codex/guides/learning-flow.md +23 -12
  11. package/codex/guides/session-distill-workflow.md +22 -12
  12. package/compose/app_bridge/SKILL.md +75 -0
  13. package/compose/app_bridge/agents/openai.yaml +2 -0
  14. package/compose/app_bridge/scripts/bridge.py +76 -0
  15. package/compose/bootstrap/SKILL.md +12 -1
  16. package/compose/corpus.py +31 -9
  17. package/compose/corpus_app.py +456 -0
  18. package/compose/corpus_import.py +529 -0
  19. package/compose/corpus_install.py +196 -18
  20. package/compose/corpus_session.py +27 -0
  21. package/compose/corpus_setup.py +674 -0
  22. package/compose/corpus_setup_cli.py +582 -0
  23. package/compose/corpus_setup_i18n.py +318 -0
  24. package/compose/corpus_setup_ui.py +633 -0
  25. package/compose/corpus_store.py +167 -29
  26. package/compose/corpus_transaction.py +43 -10
  27. package/compose/corpus_ui_runtime.py +278 -0
  28. package/compose/setup/START.md +147 -0
  29. package/compose/ui_runtime/linkify_it_py-2.2.0-py3-none-any.whl +0 -0
  30. package/compose/ui_runtime/manifest.json +238 -0
  31. package/compose/ui_runtime/markdown_it_py-4.2.0-py3-none-any.whl +0 -0
  32. package/compose/ui_runtime/mdit_py_plugins-0.6.1-py3-none-any.whl +0 -0
  33. package/compose/ui_runtime/mdurl-0.1.2-py3-none-any.whl +0 -0
  34. package/compose/ui_runtime/platformdirs-4.11.8-py3-none-any.whl +0 -0
  35. package/compose/ui_runtime/pygments-2.21.0-py3-none-any.whl +0 -0
  36. package/compose/ui_runtime/rich-15.0.0-py3-none-any.whl +0 -0
  37. package/compose/ui_runtime/textual-8.2.8-py3-none-any.whl +0 -0
  38. package/compose/ui_runtime/typing_extensions-4.16.0-py3-none-any.whl +0 -0
  39. package/docs/advanced-launch.md +131 -0
  40. package/docs/assets/corpus-studio.svg +227 -0
  41. package/docs/corpus.md +117 -0
  42. package/docs/recovery.md +201 -0
  43. package/docs/session-model.md +120 -0
  44. package/docs/setup.md +190 -0
  45. package/docs/understand.md +40 -0
  46. package/install.sh +75 -46
  47. package/launch/agent-launch.py +91 -47
  48. package/launch/provision-venv.sh +44 -13
  49. package/learn/collect-learning.py +14 -5
  50. package/learn/learning.schema.json +2 -2
  51. package/package.json +14 -2
  52. package/provenance.json +1 -1
  53. package/wrappers/claude-run.sh +10 -13
package/wrappers/claude-run.sh CHANGED
@@ -1,23 +1,18 @@
1
1
  #!/usr/bin/env bash
2
2
  # claude-run.sh — thin, controllable raw adapter around `claude -p`.
3
3
  #
4
- # The claude-side twin of codex-run. Both exist for the same reason: a review
5
- # dispatch has to name the seat it actually ran on, and a raw CLI call does not.
6
- # Until this file existed the asymmetry was silent — the codex host dispatched
7
- # reviews through our adapter while the claude host dispatched the bare binary,
8
- # so half of every cross-family review had no place to report from.
4
+ # Records the selected review seat and observed dispatch result when both seat
5
+ # pins and receipt configuration are present.
9
6
  #
10
7
  # It is an adapter, not a policy boundary. Callers passing expert overrides after
11
8
  # `--` are making expert decisions, exactly as with codex-run.
12
9
  #
13
- # (1) seat --model + --effort, both REQUIRED (see below)
10
+ # (1) seat --model + --effort, both needed for a receipt
14
11
  # (2) mutation reach --permission-mode, defaulting to a no-edit posture
15
12
  # (3) prompt read from stdin; the final message goes to stdout
16
13
  #
17
- # --model and --effort are required rather than optional, which is the one place
18
- # this diverges from codex-run. codex-run tolerates an unpinned dispatch and warns,
19
- # and that warning goes to a channel nobody reads; an unpinned review is the exact
20
- # failure the receipt contract exists to catch, so here it is refused up front.
14
+ # If either pin is missing, warn on stderr and dispatch without a receipt.
15
+ # An unpinned invocation cannot provide a named-seat review claim.
21
16
  #
22
17
  # NOT A SANDBOX. codex-run's `--sandbox read-only` is enforced by the OS; Claude Code
23
18
  # has no equivalent, so the default here denies the mutating TOOLS and nothing more.
@@ -34,15 +29,17 @@ set -euo pipefail
34
29
 
35
30
  usage() {
36
31
  cat <<'USAGE'
37
- Usage: claude-run.sh --model M --effort E [--permission-mode MODE] [--cd DIR]
32
+ Usage: claude-run.sh [--model M --effort E] [--permission-mode MODE] [--cd DIR]
38
33
  [-- ARG ...] < packet
39
- --model M model to pin (required)
40
- --effort E reasoning effort to pin (required)
34
+ --model M model to pin (required for a receipt)
35
+ --effort E reasoning effort to pin (required for a receipt)
41
36
  --permission-mode MODE
42
37
  claude permission mode (default: the no-edit posture below)
43
38
  --cd DIR working root
44
39
  -- everything after is passed to claude verbatim (expert override)
45
40
 
41
+ If either seat pin is missing, dispatch continues with a warning and no receipt.
42
+
46
43
  Environment (the adapter calling convention; all optional):
47
44
  REVIEW_RECEIPT_DIR directory to write one ReviewReceipt/v1 into
48
45
  REVIEW_METHOD_ID the review method this dispatch serves