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

package/src/providers/sdk/v1/schemas/cli/provider.schema.json

@@ -0,0 +1,538 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "adhdev:cli/provider@1",
+  "title": "CLI provider.json — v1",
+  "description": "Schema for CLI provider manifests. Validates the contract documented in docs/provider-contract/cli/v1.md. All 4 production CLI providers (codex, claude, hermes, antigravity) pass this schema without modification.",
+  "type": "object",
+  "required": ["type", "name", "category", "binary", "spawn"],
+  "additionalProperties": false,
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "Schema URL. Hint for editor tooling; not consumed by the daemon."
+    },
+    "links": {
+      "type": "object",
+      "additionalProperties": { "type": "string" },
+      "description": "Documentation URLs. Surfaced in marketplace UI."
+    },
+    "install": {
+      "type": "object",
+      "additionalProperties": { "type": "string" },
+      "description": "Install instructions by channel (npm/pip/manual/brew). UI-only."
+    },
+    "source": {
+      "type": "object",
+      "description": "GitHub source descriptor. Daemon uses this to fetch script files on install.",
+      "additionalProperties": false,
+      "properties": {
+        "type": { "const": "github" },
+        "repo": { "type": "string", "pattern": "^[\\w.-]+/[\\w.-]+$" },
+        "ref":  { "type": "string" },
+        "subdir": { "type": "string" }
+      },
+      "required": ["type", "repo", "ref"]
+    },
+    "type": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9-]*$",
+      "description": "Stable identifier. Lowercase kebab-case."
+    },
+    "name": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Short canonical name."
+    },
+    "displayName": {
+      "type": "string",
+      "description": "Optional UI label. Defaults to name."
+    },
+    "category": {
+      "const": "cli",
+      "description": "Must be \"cli\" for this schema."
+    },
+    "icon": {
+      "type": "string",
+      "maxLength": 4,
+      "description": "Single emoji or short glyph."
+    },
+    "aliases": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Alternative identifiers accepted at launch."
+    },
+    "engines": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "adhdev": {
+          "type": "string",
+          "description": "SemVer range against the ADHDev contract version. Required for marketplace-published providers."
+        }
+      },
+      "description": "Optional today; required by marketplace publish flow once registry is live."
+    },
+    "providerVersion": {
+      "type": "string",
+      "description": "Provider package SemVer."
+    },
+    "contractVersion": {
+      "type": ["number", "string"],
+      "description": "Legacy contract version. Reserved."
+    },
+    "status": {
+      "enum": ["Stable", "Beta", "Experimental", "Deprecated"]
+    },
+    "details": {
+      "type": "string",
+      "description": "Short blurb shown in marketplace."
+    },
+    "disableUpstream": {
+      "type": "boolean",
+      "description": "When true, daemon does not auto-sync this provider from registry. claude-cli uses this for explicit-version pinning."
+    },
+    "binary": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Binary basename used for which-style detection."
+    },
+    "versionCommand": {
+      "type": "string",
+      "description": "Command the daemon runs to probe installed version. Example: \"my-cli --version\"."
+    },
+    "spawn": {
+      "type": "object",
+      "required": ["command"],
+      "additionalProperties": false,
+      "properties": {
+        "command": { "type": "string", "minLength": 1 },
+        "args": {
+          "type": "array",
+          "items": { "type": "string" },
+          "default": []
+        },
+        "shell": { "type": "boolean", "default": false },
+        "env": {
+          "type": "object",
+          "additionalProperties": { "type": "string" },
+          "default": {}
+        }
+      }
+    },
+    "sendDelayMs": {
+      "type": "number",
+      "minimum": 0,
+      "description": "Delay between pasting prompt text and pressing Enter."
+    },
+    "modelLaunchArgs": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Template for expanding an initialModel selection into launch args. '{{model}}' is substituted with the model string (e.g. ['--model', '{{model}}'] → --model opus). Applied at launch when a model is requested for this CLI provider (MAGI kind-panel model axis). Absent → no launch-time model selection."
+    },
+    "modelOptions": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Suggested model values shown as dropdown options in the new-session dialog (brain-routing model axis), e.g. ['opus','sonnet','haiku']. Advisory — the UI still accepts free text, so a stale list never blocks an accepted model."
+    },
+    "thinkingLaunchArgs": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Template for expanding an initialThinkingLevel selection into launch args (brain-routing thinking axis, parallel to modelLaunchArgs). '{{level}}' is substituted with the provider-mapped reasoning-effort value (e.g. ['--effort', '{{level}}'] → --effort high; ['-c', 'model_reasoning_effort={{level}}']). Applied at launch when a thinking level is requested. Absent → no launch-time thinking selection."
+    },
+    "thinkingLevelMap": {
+      "type": "object",
+      "properties": {
+        "low": { "type": "string" },
+        "medium": { "type": "string" },
+        "high": { "type": "string" }
+      },
+      "additionalProperties": false,
+      "description": "Optional map from the standard thinking levels (low/medium/high) to this provider's own reasoning-effort vocabulary, used to fill {{level}} in thinkingLaunchArgs. A level absent from the map passes through unchanged."
+    },
+    "thinkingLevelOptions": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Reasoning-effort values this provider accepts, shown as the thinking-level dropdown in the new-session dialog (e.g. ['low','medium','high','max']). Absent → the UI falls back to standard low/medium/high. Provider's own vocabulary, passed through verbatim."
+    },
+    "thinkingControlId": {
+      "type": "string",
+      "description": "For a provider with no thinkingLaunchArgs but a runtime reasoning-effort control (e.g. hermes 'reasoning'), the controls[].id to drive at launch for the thinking level. The control's setScript is invoked with { value: <mapped level> }."
+    },
+    "scriptCallBudgetMs": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 5000,
+      "default": 50,
+      "description": "Per-invocation wall-clock budget (ms) for provider scripts (detectStatus, parseSession, parseApproval). Default 50. Scripts that exceed the budget are flagged in the runner's invocation trace and surfaced via the debug bundle so operators can identify a hanging settle loop. The budget is NOT a hard kill — Node CJS cannot interrupt synchronous code without a worker thread."
+    },
+    "sendKey": {
+      "type": "string",
+      "default": "\r",
+      "description": "Character sent to submit a prompt. Default carriage return."
+    },
+    "submitStrategy": {
+      "enum": ["wait_for_echo", "immediate"],
+      "default": "immediate"
+    },
+    "requirePromptEchoBeforeSubmit": {
+      "type": "boolean",
+      "default": false,
+      "description": "When true, daemon waits for the typed prompt to be visible in the PTY screen before sending sendKey."
+    },
+    "allowInputDuringGeneration": {
+      "type": "boolean",
+      "default": false,
+      "description": "When true, daemon permits sending a new prompt mid-generation."
+    },
+    "requiresFinalAssistantBeforeIdle": {
+      "type": "boolean",
+      "default": false,
+      "description": "When true, daemon defers generating→idle until parseSession includes a final standard assistant message."
+    },
+    "augmentStaleSnapshot": {
+      "type": "boolean",
+      "description": "Reserved for future use."
+    },
+    "transcriptAuthority": {
+      "enum": ["provider", "daemon"],
+      "description": "When 'provider', daemon treats parsed output as canonical and suppresses fallback parsing."
+    },
+    "transcriptContext": {
+      "enum": ["full", "tail"],
+      "description": "When 'full', provider-owned parser receives the entire accumulated transcript context."
+    },
+    "patterns": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Optional regex hints for the legacy fallback detector. Modern providers express these via primitives.",
+      "properties": {
+        "prompt":     { "$ref": "#/$defs/patternList" },
+        "generating": { "$ref": "#/$defs/patternList" },
+        "approval":   { "$ref": "#/$defs/patternList" },
+        "ready":      { "$ref": "#/$defs/patternList" },
+        "dialog":     { "$ref": "#/$defs/patternList" }
+      }
+    },
+    "approvalKeys": {
+      "type": "object",
+      "patternProperties": {
+        "^[0-9]+$": { "type": "string" }
+      },
+      "additionalProperties": false,
+      "description": "Map of button index → key sequence to send."
+    },
+    "approvalPositiveHints": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Lowercase substrings considered \"positive\" (accept). Auto-approve picks the matching button."
+    },
+    "timeouts": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "ptyFlush":           { "type": "number", "minimum": 0 },
+        "dialogAccept":       { "type": "number", "minimum": 0 },
+        "approvalCooldown":   { "type": "number", "minimum": 0 },
+        "generatingIdle":     { "type": "number", "minimum": 0 },
+        "idleFinish":         { "type": "number", "minimum": 0 },
+        "idleFinishConfirm":  { "type": "number", "minimum": 0 },
+        "statusActivityHold": { "type": "number", "minimum": 0 },
+        "maxResponse":        { "type": "number", "minimum": 0 },
+        "shutdownGrace":      { "type": "number", "minimum": 0 },
+        "outputSettle":       { "type": "number", "minimum": 0 }
+      }
+    },
+    "resume": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["supported"],
+      "properties": {
+        "supported": { "type": "boolean" },
+        "stopStrategy": { "enum": ["command", "ctrl_c", "signal"] },
+        "stopCommand": { "type": "string" },
+        "shutdownGraceMs": { "type": "number", "minimum": 0 },
+        "sessionIdFormat": { "enum": ["uuid", "free", "string"] },
+        "newSessionArgs": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "resumeSessionArgs": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "resumeArgs": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      }
+    },
+    "compatibility": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "required": ["ideVersion"],
+        "additionalProperties": false,
+        "properties": {
+          "ideVersion": { "type": "string", "description": "SemVer range." },
+          "scriptDir":  { "type": "string", "pattern": "^scripts/[^/]+$" },
+          "spec":       { "type": "string", "pattern": "^specs/[^/]+\\.json$", "description": "Path to declarative spec.json driving SpecCliAdapter for this version range." }
+        }
+      },
+      "description": "Maps installed agent versions to script subdirectories and/or declarative specs."
+    },
+    "defaultScriptDir": {
+      "type": "string",
+      "pattern": "^scripts/[^/]+$",
+      "description": "Fallback when no compatibility[] entry matches."
+    },
+    "capabilities": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "input": {
+          "type": "object",
+          "additionalProperties": true,
+          "properties": {
+            "multipart": { "type": "boolean" },
+            "mediaTypes": {
+              "type": "array",
+              "items": { "type": "string" }
+            },
+            "strategies": { "type": "array" }
+          }
+        },
+        "output": {
+          "type": "object",
+          "additionalProperties": true,
+          "properties": {
+            "richContent": { "type": "boolean" },
+            "mediaTypes": {
+              "type": "array",
+              "items": { "type": "string" }
+            }
+          }
+        },
+        "controls": {
+          "type": "object",
+          "additionalProperties": true,
+          "properties": {
+            "typedResults": { "type": "boolean" }
+          }
+        }
+      }
+    },
+    "meshCoordinator": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["supported"],
+      "properties": {
+        "supported": { "type": "boolean" },
+        "mcpConfig": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "mode":                { "enum": ["manual", "auto_import"] },
+            "format":              { "type": "string" },
+            "path":                { "type": "string" },
+            "configPathCommand":   { "type": "string" },
+            "serverName":          { "type": "string" },
+            "requiresRestart":     { "type": "boolean" },
+            "instructions":        { "type": "string" },
+            "template":            { "type": "string" }
+          }
+        },
+        "systemPromptInjection": {
+          "description": "How the coordinator system prompt reaches the launched CLI. Replaces hard-coded router branches per CLI type; users may override the prompt body or the injection mechanism here.",
+          "oneOf": [
+            { "type": "object", "additionalProperties": false, "required": ["mode", "flag"],
+              "properties": { "mode": { "const": "cli_arg" }, "flag": { "type": "string" } } },
+            { "type": "object", "additionalProperties": false, "required": ["mode", "flag", "template"],
+              "properties": { "mode": { "const": "config_override" }, "flag": { "type": "string" }, "template": { "type": "string" } } },
+            { "type": "object", "additionalProperties": false, "required": ["mode", "path"],
+              "properties": { "mode": { "const": "context_file" }, "path": { "type": "string" }, "wrapper": { "type": "string" } } },
+            { "type": "object", "additionalProperties": false, "required": ["mode", "name"],
+              "properties": { "mode": { "const": "env_var" }, "name": { "type": "string" } } }
+          ]
+        },
+        "delegatedWorkerIsolation": {
+          "description": "Provider-declared launch isolation for coordinator-spawned worker sessions. Keeps worker-only sessions from inheriting coordinator MCP/tools/config.",
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "env": {
+              "type": "object",
+              "additionalProperties": false,
+              "properties": {
+                "unset": {
+                  "type": "array",
+                  "items": { "type": "string", "minLength": 1 }
+                }
+              }
+            },
+            "args": {
+              "type": "array",
+              "items": {
+                "oneOf": [
+                  {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "required": ["mode", "flag"],
+                    "properties": {
+                      "mode": { "const": "empty_mcp_config" },
+                      "flag": { "type": "string", "minLength": 1 },
+                      "strictFlag": { "type": "string", "minLength": 1 }
+                    }
+                  },
+                  {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "required": ["mode", "flag", "key", "value"],
+                    "properties": {
+                      "mode": { "const": "config_override" },
+                      "flag": { "type": "string", "minLength": 1 },
+                      "key": { "type": "string", "minLength": 1 },
+                      "value": { "type": "string", "minLength": 1 },
+                      "dedupeKey": { "type": "string", "minLength": 1 }
+                    }
+                  }
+                ]
+              }
+            }
+          }
+        }
+      }
+    },
+    "nativeHistory": {
+      "type": "object",
+      "description": "Native transcript adapter declaration. v1 canonical field name. Daemon reads/lists provider-native history files via the named scripts (or the built-in adapter identified by $schema).",
+      "additionalProperties": true,
+      "properties": {
+        "$schema":          { "type": "string" },
+        "format":           { "type": "string" },
+        "watchPath":        { "type": "string" },
+        "mode":             { "enum": ["native-source", "materialized-mirror", "disabled", "daemon-mirror"] },
+        "contractVersion":  { "type": "string" },
+        "scripts": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "readSession":  { "type": "string" },
+            "listSessions": { "type": "string" }
+          }
+        }
+      }
+    },
+    "canonicalHistory": {
+      "type": "object",
+      "description": "Deprecated v0 alias for `nativeHistory`. The loader copies this block into `nativeHistory` at load time. New manifests should use `nativeHistory` directly.",
+      "additionalProperties": true,
+      "properties": {
+        "format":           { "type": "string" },
+        "watchPath":        { "type": "string" },
+        "mode":             { "enum": ["native-source", "materialized-mirror", "disabled", "daemon-mirror"] },
+        "contractVersion":  { "type": "string" },
+        "scripts": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "readSession":  { "type": "string" },
+            "listSessions": { "type": "string" }
+          }
+        }
+      }
+    },
+    "settings": {
+      "type": "object",
+      "additionalProperties": { "$ref": "#/$defs/settingDef" }
+    },
+    "controls": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/controlDef" }
+    },
+    "tui": {
+      "type": "object",
+      "description": "Declarative TUI parsing primitives. When present, daemon's builder synthesises detectStatus / parseApproval / parseSession from these blocks. Each block is identified by its $schema.",
+      "additionalProperties": true
+    },
+    "overrides": {
+      "type": "object",
+      "description": "Optional JS override pointers. Presence promotes the provider tier to `extended`. Each value identifies the handler being overridden and the relative path to the JS file implementing it.",
+      "additionalProperties": {
+        "oneOf": [
+          { "type": "string", "description": "Relative path to the override JS file." },
+          {
+            "type": "object",
+            "required": ["path"],
+            "additionalProperties": false,
+            "properties": {
+              "$schema": { "type": "string" },
+              "path":    { "type": "string" },
+              "reason":  { "type": "string" }
+            }
+          }
+        ]
+      }
+    }
+  },
+  "$defs": {
+    "patternList": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["source"],
+        "additionalProperties": false,
+        "properties": {
+          "source": { "type": "string", "description": "Regex source." },
+          "flags":  { "type": "string", "pattern": "^[gimsuy]*$" }
+        }
+      }
+    },
+    "settingDef": {
+      "type": "object",
+      "required": ["type"],
+      "additionalProperties": false,
+      "properties": {
+        "type":        { "enum": ["boolean", "number", "string", "select"] },
+        "default":     {},
+        "public":      { "type": "boolean" },
+        "label":       { "type": "string" },
+        "description": { "type": "string" },
+        "options":     { "type": "array" },
+        "min":         { "type": "number" },
+        "max":         { "type": "number" }
+      },
+      "allOf": [
+        {
+          "if": { "properties": { "type": { "const": "select" } } },
+          "then": { "required": ["options"] }
+        }
+      ]
+    },
+    "controlDef": {
+      "type": "object",
+      "required": ["id", "type", "label"],
+      "additionalProperties": false,
+      "properties": {
+        "id":              { "type": "string" },
+        "type":            { "enum": ["select", "action", "toggle"] },
+        "label":           { "type": "string" },
+        "icon":            { "type": "string" },
+        "placement":       { "type": "string" },
+        "order":           { "type": "number" },
+        "dynamic":         { "type": "boolean" },
+        "hidden":          { "type": "boolean", "description": "When true, dashboard does not render the control directly. Used for commands triggered by other UI (slash menu, etc.)." },
+        "options":         { "type": "array" },
+        "listScript":      { "type": "string" },
+        "setScript":       { "type": "string" },
+        "invokeScript":    { "type": "string" },
+        "readFrom":        { "type": "string" },
+        "resultDisplay":   { "type": "string" },
+        "defaultValue":    {},
+        "confirmTitle":    { "type": "string" },
+        "confirmMessage":  { "type": "string" },
+        "confirmLabel":    { "type": "string" }
+      }
+    }
+  }
+}

package/src/providers/sdk/v1/schemas/primitives/acp-session-protocol-v1.json

@@ -0,0 +1,131 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "adhdev:acp/session-protocol@1",
+  "title": "acp/session-protocol — v1",
+  "description": "Describes how to detect ACP stdio session status from line-oriented process output. Supports json-rpc, plain-text, and mcp prompt styles. The daemon compiles the regex patterns at builder time and uses them at runtime to classify each incoming line as idle, generating, or an error verdict.",
+  "type": "object",
+  "required": ["$schema"],
+  "additionalProperties": false,
+  "properties": {
+    "$schema": {
+      "const": "adhdev:acp/session-protocol@1"
+    },
+    "idlePattern": {
+      "type": "object",
+      "description": "Regex pattern that matches a line emitted when the agent finishes a turn and is waiting for the next user message.",
+      "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": "Optional ECMAScript regex flags (default: 'i')."
+        },
+        "description": {
+          "type": "string",
+          "description": "Author-facing note explaining when this pattern fires."
+        }
+      }
+    },
+    "generatingPattern": {
+      "type": "object",
+      "description": "Regex pattern that matches a line emitted while the agent is actively working (streaming tokens, calling tools, etc.).",
+      "required": ["regex"],
+      "additionalProperties": false,
+      "properties": {
+        "regex": {
+          "type": "string",
+          "description": "ECMAScript regex source."
+        },
+        "flags": {
+          "type": "string",
+          "pattern": "^[gimsuy]*$",
+          "default": "i"
+        },
+        "description": {
+          "type": "string"
+        }
+      }
+    },
+    "errorPatterns": {
+      "type": "array",
+      "description": "List of error-signal patterns. Each entry provides a regex and the status verdict to return on match. Checked in order; first match wins.",
+      "items": {
+        "type": "object",
+        "required": ["regex", "verdict"],
+        "additionalProperties": false,
+        "properties": {
+          "regex": {
+            "type": "string",
+            "description": "ECMAScript regex source."
+          },
+          "flags": {
+            "type": "string",
+            "pattern": "^[gimsuy]*$",
+            "default": "i"
+          },
+          "verdict": {
+            "type": "string",
+            "enum": ["idle", "generating", "waiting_approval"],
+            "description": "Status verdict to return when this error pattern fires."
+          },
+          "description": {
+            "type": "string",
+            "description": "Author-facing note explaining what condition this pattern represents."
+          }
+        }
+      }
+    },
+    "promptStyle": {
+      "description": "Wire format used by the agent on stdio. Affects how lines are parsed (e.g. json-rpc messages are newline-delimited JSON objects; plain-text is freeform; mcp is the Model Context Protocol framing).",
+      "default": "plain-text",
+      "oneOf": [
+        {
+          "const": "json-rpc",
+          "title": "JSON-RPC",
+          "description": "Each line is a newline-delimited JSON-RPC 2.0 object."
+        },
+        {
+          "const": "plain-text",
+          "title": "Plain text",
+          "description": "Freeform text output — patterns are matched against each line directly."
+        },
+        {
+          "const": "mcp",
+          "title": "MCP",
+          "description": "Model Context Protocol stdio framing (Content-Length + JSON body)."
+        }
+      ]
+    },
+    "messageDelimiter": {
+      "type": "string",
+      "default": "\n",
+      "description": "String used to delimit messages in the stdio stream. Defaults to newline ('\\n'). For MCP framing this is effectively the Content-Length header separator, but the builder uses this field to split incoming bytes into logical lines for regex matching."
+    }
+  },
+  "examples": [
+    {
+      "$schema": "adhdev:acp/session-protocol@1",
+      "promptStyle": "plain-text",
+      "idlePattern": { "regex": "^\\$\\s*$", "flags": "m", "description": "Shell prompt — agent returned to idle" },
+      "generatingPattern": { "regex": "thinking|processing|calling tool", "flags": "i" },
+      "errorPatterns": [
+        { "regex": "error:|exception:", "flags": "i", "verdict": "idle", "description": "Unrecoverable error — treat as idle so user can retry" }
+      ]
+    },
+    {
+      "$schema": "adhdev:acp/session-protocol@1",
+      "promptStyle": "json-rpc",
+      "idlePattern": { "regex": "\"method\"\\s*:\\s*\"agent/ready\"" },
+      "generatingPattern": { "regex": "\"method\"\\s*:\\s*\"agent/(?:thinking|toolCall)\"" },
+      "errorPatterns": [
+        { "regex": "\"method\"\\s*:\\s*\"agent/approvalRequired\"", "verdict": "waiting_approval" }
+      ]
+    }
+  ]
+}