@adhdev/daemon-core 0.9.82-rc.49 → 0.9.82-rc.491

package/src/providers/sdk/v1/schemas/primitives/tui-settled-prompt-v1.json

@@ -0,0 +1,71 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "adhdev:tui/settled-prompt@1",
+  "title": "tui/settled-prompt — v1",
+  "description": "Declares the screen patterns that indicate the agent is idle and ready for a new prompt. Combined with `tui/spinner` (negated) and `tui/modal` (negated) by the builder to decide `idle`. Codex `❯ <model> · /shortcuts`, Claude `? for shortcuts` + `❯`, Antigravity `>` + `? for shortcuts` are all expressible.",
+  "type": "object",
+  "required": ["$schema", "regex"],
+  "additionalProperties": false,
+  "properties": {
+    "$schema": {
+      "const": "adhdev:tui/settled-prompt@1"
+    },
+    "regex": {
+      "type": "string",
+      "description": "ECMAScript regex source. Matched within the scope window."
+    },
+    "flags": {
+      "type": "string",
+      "pattern": "^[gimsuy]*$",
+      "default": "m"
+    },
+    "withFooter": {
+      "type": "array",
+      "description": "Optional auxiliary substrings or regex sources that must also be present in the scope window for the prompt to count as settled. Use this to disambiguate from mid-stream prompt-like text.",
+      "items": {
+        "type": "object",
+        "required": ["pattern"],
+        "additionalProperties": false,
+        "properties": {
+          "pattern": {
+            "type": "string",
+            "description": "Plain substring (when `kind` is omitted or `substring`) or regex source (when `kind` is `regex`)."
+          },
+          "kind": {
+            "enum": ["substring", "regex"],
+            "default": "substring"
+          },
+          "flags": {
+            "type": "string",
+            "pattern": "^[gimsuy]*$",
+            "default": "i"
+          }
+        }
+      }
+    },
+    "scope": {
+      "default": "last-n-lines",
+      "enum": ["last-n-lines", "whole-screen"]
+    },
+    "scopeWindowLines": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 64,
+      "default": 8
+    }
+  },
+  "examples": [
+    {
+      "$schema": "adhdev:tui/settled-prompt@1",
+      "regex": "^[›❯>]\\s*$",
+      "withFooter": [
+        { "pattern": "? for shortcuts" }
+      ]
+    },
+    {
+      "$schema": "adhdev:tui/settled-prompt@1",
+      "regex": "(?:^|[›❯>]\\s*)\\b(?:gpt-|o\\d\\b|codex-)[\\w._-]*",
+      "scope": "last-n-lines"
+    }
+  ]
+}

package/src/providers/sdk/v1/schemas/primitives/tui-spinner-v1.json

@@ -0,0 +1,83 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "adhdev:tui/spinner@1",
+  "title": "tui/spinner — v1",
+  "description": "Declares which patterns in the PTY/screen text indicate the agent is actively generating. The daemon's status state machine fires `generating` when any pattern matches inside the configured scope window. Codex's `Working (8m 56s • esc to interrupt)`, Claude's braille spinner, and Antigravity's `Thinking…` are all expressible with this primitive.",
+  "type": "object",
+  "required": ["$schema", "patterns"],
+  "additionalProperties": false,
+  "properties": {
+    "$schema": {
+      "const": "adhdev:tui/spinner@1"
+    },
+    "patterns": {
+      "type": "array",
+      "minItems": 1,
+      "description": "List of patterns. Any match within the scope window classifies the screen as generating.",
+      "items": {
+        "type": "object",
+        "required": ["regex"],
+        "additionalProperties": false,
+        "properties": {
+          "regex": {
+            "type": "string",
+            "description": "ECMAScript regex source. Daemon compiles with the flags below."
+          },
+          "flags": {
+            "type": "string",
+            "pattern": "^[gimsuy]*$",
+            "default": "i"
+          },
+          "description": {
+            "type": "string",
+            "description": "Author-facing note explaining when this pattern fires."
+          }
+        }
+      }
+    },
+    "scope": {
+      "description": "Where in the text the patterns are searched. Defaults to `live-frame-tail` which mirrors the safest production behaviour (avoids matching scrollback or earlier turns).",
+      "default": "live-frame-tail",
+      "oneOf": [
+        {
+          "const": "live-frame-tail",
+          "title": "Live frame tail",
+          "description": "Last N lines of the visible screen, where N is `scopeWindowLines` (default 8). Recommended for most providers."
+        },
+        {
+          "const": "whole-screen",
+          "title": "Whole screen",
+          "description": "Match anywhere in the current screen text. Use with caution; tends to false-positive on scrollback."
+        },
+        {
+          "const": "recent-buffer",
+          "title": "Recent buffer",
+          "description": "Last ~1000 chars of accumulated buffer. Useful when the spinner is in raw byte stream but not in the rendered screen yet."
+        }
+      ]
+    },
+    "scopeWindowLines": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 64,
+      "default": 8,
+      "description": "Number of trailing lines considered the live frame when scope is `live-frame-tail`."
+    }
+  },
+  "examples": [
+    {
+      "$schema": "adhdev:tui/spinner@1",
+      "patterns": [
+        { "regex": "(?:Thinking|Working) \\([0-9hms\\s]+", "flags": "i", "description": "Codex/Claude elapsed-time spinner" },
+        { "regex": "esc to (?:cancel|interrupt|stop)", "flags": "i" }
+      ]
+    },
+    {
+      "$schema": "adhdev:tui/spinner@1",
+      "scope": "whole-screen",
+      "patterns": [
+        { "regex": "[⠁-⣿]", "description": "Braille spinner glyphs" }
+      ]
+    }
+  ]
+}

package/src/providers/sdk/v1/schemas/primitives/tui-transcript-pty-v1.json

@@ -0,0 +1,83 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "adhdev:tui/transcript-pty@1",
+  "title": "TUI transcript extraction (PTY screen)",
+  "description": "Declarative rules for extracting user/assistant/tool messages from a PTY screen buffer. Composed with detect-status + parse-approval to yield a full parseSession output without provider-specific JavaScript.\n\nThe extraction model: each line in the screen is classified as one of {assistant, user, tool, chrome, continuation}. Adjacent lines of the same role (or marked as continuations) get grouped into a single message. Chrome lines are skipped.\n\nWith just this primitive declared, a verified/declarative-only provider can produce a working transcript from PTY output alone, no parse_output.js required.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["assistantPrefix"],
+  "properties": {
+    "$schema": { "const": "adhdev:tui/transcript-pty@1" },
+    "assistantPrefix": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["regex"],
+      "description": "Regex that matches the leading character/string of an assistant message line. Capture group 1 is the rest of the line (the message content for this line). Examples: Claude `^[⏺]\\s+(.*)$`, Codex `^>\\s+(.*)$`.",
+      "properties": {
+        "regex": { "type": "string" },
+        "flags": { "type": "string", "default": "" }
+      }
+    },
+    "userPrefix": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["regex"],
+      "description": "Optional: regex that matches the user's submitted prompt line on screen (post-echo). When omitted, user messages are tracked via input echo correlation only.",
+      "properties": {
+        "regex": { "type": "string" },
+        "flags": { "type": "string", "default": "" }
+      }
+    },
+    "toolPrefix": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["regex"],
+      "description": "Optional: regex that matches lines emitted by tool calls. By default these are surfaced as `kind: 'tool'` messages. Examples: Claude `^[⎿]\\s+(.*)$`, Codex `^[•]\\s+(.*)$`.",
+      "properties": {
+        "regex": { "type": "string" },
+        "flags": { "type": "string", "default": "" },
+        "skip": {
+          "type": "boolean",
+          "default": false,
+          "description": "When true, tool lines are silently dropped from the transcript instead of being emitted as `kind: 'tool'` messages."
+        }
+      }
+    },
+    "continuationLine": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "How to recognize continuation lines (no prefix) that belong to the previous message. Default rule: any non-empty line that is not chrome and has no role prefix continues the previous message.",
+      "properties": {
+        "indented": {
+          "type": "boolean",
+          "default": false,
+          "description": "When true, only lines starting with whitespace are continuation lines. When false (default), any unprefixed non-chrome non-empty line is a continuation."
+        }
+      }
+    },
+    "chromePatterns": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["regex"],
+        "properties": {
+          "regex": { "type": "string" },
+          "flags": { "type": "string", "default": "" },
+          "label": { "type": "string" }
+        }
+      },
+      "description": "Lines matching any of these regexes are treated as chrome and excluded from messages. Use this for shell prompts, footer hints, copyright banners, etc."
+    },
+    "stripLeadingChrome": {
+      "type": "boolean",
+      "default": true,
+      "description": "When true, leading welcome/banner lines (before the first user or assistant prefix is seen) are dropped."
+    },
+    "scope": {
+      "enum": ["screen", "buffer", "tail"],
+      "default": "buffer",
+      "description": "Which input field to parse: rendered screen text, full buffer (default), or tail string. Most providers use buffer because the screen alone loses scrollback."
+    }
+  }
+}

package/src/providers/sdk/v1/schemas/primitives/tui-visible-region-v1.json

@@ -0,0 +1,57 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "adhdev:tui/visible-region@1",
+  "title": "TUI visible region",
+  "description": "Defines which portion of the rendered terminal screen counts as 'visible' for detectStatus / parseApproval / parseSession dispatch. Used to scope matchers away from off-screen scrollback or header chrome. Without a visible-region declaration, daemon falls back to the entire accumulator buffer.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["scope"],
+  "properties": {
+    "$schema": { "const": "adhdev:tui/visible-region@1" },
+    "scope": {
+      "enum": ["screen", "tail", "buffer", "between-anchors"],
+      "description": "screen=current rendered viewport, tail=last N chars, buffer=full accumulated buffer, between-anchors=between most recent top/bottom anchor lines."
+    },
+    "tailChars": {
+      "type": "integer",
+      "minimum": 1,
+      "default": 4000,
+      "description": "Used when scope=tail."
+    },
+    "anchors": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Used when scope=between-anchors.",
+      "properties": {
+        "top": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["pattern"],
+          "properties": {
+            "pattern": { "type": "string" },
+            "flags": { "type": "string" }
+          }
+        },
+        "bottom": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["pattern"],
+          "properties": {
+            "pattern": { "type": "string" },
+            "flags": { "type": "string" }
+          }
+        }
+      }
+    },
+    "selectAnchor": {
+      "enum": ["first", "last"],
+      "default": "first",
+      "description": "When multiple matches exist for the anchor pair, pick the first or last. Antigravity uses `last` to anchor on the most recent prompt separator and exclude scrollback above it; codex's similar pattern also benefits from `last`."
+    },
+    "stripCues": {
+      "type": "array",
+      "description": "Optional list of primitive $ids whose matches should be masked out of the visible region before downstream dispatch. Common: footer-chrome, welcome-screen.",
+      "items": { "type": "string" }
+    }
+  }
+}

package/src/providers/sdk/v1/schemas/primitives/tui-welcome-screen-v1.json

@@ -0,0 +1,35 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "adhdev:tui/welcome-screen@1",
+  "title": "TUI welcome screen",
+  "description": "Declares cues that identify the cold-start welcome / splash region of a CLI agent. Daemon uses this to suppress assistant-block / message extraction during the boot phase, so the splash banner is not turned into a fake assistant message.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["cues"],
+  "properties": {
+    "$schema": { "const": "adhdev:tui/welcome-screen@1" },
+    "cues": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["pattern"],
+        "properties": {
+          "pattern": { "type": "string" },
+          "flags": { "type": "string" }
+        }
+      }
+    },
+    "dismissAfter": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "How the welcome state ends. Default: first prompt-marker sighting.",
+      "properties": {
+        "onPromptMarker": { "type": "boolean", "default": true },
+        "onUserEcho": { "type": "boolean", "default": true },
+        "onAssistantBlock": { "type": "boolean", "default": false }
+      }
+    }
+  }
+}