fno-agents 0.3.1

PTY supervisor substrate for persistent, attachable multi-CLI coding agents (codex, gemini, claude)
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74

# opencode readiness manifest (x-8f7f) - adapted from the reference's
# src/detect/manifests/opencode.toml per manifests/ADAPTING.md.
#
# STAGED / INERT (AC2-FR): opencode is not a hosted fno provider yet (its
# buildout is node x-51f6: READABLE_PROVIDERS membership + provider impl +
# readiness detector + mux-pane argv). Until x-51f6 lands, `scrape_targets`
# selects no opencode row, so this manifest parses and is bundled but never
# fires. It is staged here so the badge derives with zero further change to
# this node's files the moment opencode becomes mux-hostable.
#
# Translation notes (reference -> ours):
#   - dropped reference metadata (id/version/updated_at/aliases/visible_*); kept
#     min_engine_version (we support it).
#   - rule-level predicates (any/regex/line_regex) moved under a single `gate`.
#   - `contains = ["x"]` (the reference "any of") expanded to a plain `contains = "x"`
#     for a single element; the multi-key AND rule wraps its keys under `all`.
#   - opencode's screens are groundable from source (~/code/tools/opencode +
#     ctx7 `opencode`); markers mirror the reference's, still to be pinned against a
#     live opencode TUI when it is hosted (capture-readiness-grid.sh).
#
# State vocabulary + arbitration (same contract as codex.toml):
#   permission_required (300, blocked) > interrupt_hint (110) > progress_bar (100)

min_engine_version = 1

[[rule]]
id = "permission_required"
state = "blocked"
priority = 300
region = "whole_recent"
gate = { any = [
  { contains = "△ Permission required" },
  { all = [
    { contains = "esc dismiss" },
    { any = [
      { contains = "enter confirm" },
      { contains = "enter submit" },
      { contains = "enter toggle" },
    ] },
    { any = [
      { contains = "↑↓ select" },
      { contains = "⇆ tab" },
    ] },
  ] },
] }
# No [rule.answer] (x-5103): validated from opencode source
# (packages/tui/src/routes/session/permission.tsx) - the permission dialog is a
# horizontal Allow once / Allow always / Reject button row navigated with
# left/right (or vim h/l) + Enter, NOT a numbered-digit menu. Like agy, that is
# arrow-only and stays focus-only (the Open Q1 no-op); only codex/gemini got a
# digit grammar. The footer markers above already prove this ("↑↓ select" /
# "⇆ tab"). Author one here only if opencode ever ships a numbered-digit prompt.

[[rule]]
id = "interrupt_hint_working"
state = "working"
priority = 110
region = "whole_recent"
gate = { any = [
  { contains = "esc to interrupt" },
  # live 1.14.50 footer says "esc interrupt" (no "to") - pinned from a
  # mux-pane capture at the hosting buildout; "to" variants kept for older builds.
  { contains = "esc interrupt" },
  { contains = "ctrl+c to interrupt" },
  { contains = "press esc to interrupt" },
  { line_regex = '(?i).*opencode.*esc (again to )?interrupt' },
] }

[[rule]]
id = "progress_bar_working"
state = "working"
priority = 100
region = "whole_recent"
gate = { regex = '(■|⬝){4,}' }