@mono-agent/agent-app 0.14.0 → 0.15.0

package/schema/mono-agent.config.schema.json

@@ -637,6 +637,18 @@
               "default": "0 */2 * * *"
             }
           }
+        },
+        "reflection": {
+          "type": "object",
+          "deprecated": true,
+          "additionalProperties": true,
+          "description": "Removed memory.reflection settings are tolerated only to emit a migration warning."
+        },
+        "migration": {
+          "type": "object",
+          "deprecated": true,
+          "additionalProperties": true,
+          "description": "Removed memory.migration settings are tolerated only to emit a migration warning."
         }
       },
       "allOf": [
@@ -1132,14 +1144,41 @@
       "additionalProperties": false,
       "properties": {
         "exporters": {
-          "description": "Configures exporters for the observability section.",
-          "examples": [
-            []
-          ],
           "type": "array",
+          "maxItems": 1,
           "items": {
             "type": "object",
-            "additionalProperties": true
+            "additionalProperties": false,
+            "properties": {
+              "type": {
+                "const": "phoenix"
+              },
+              "endpoint": {
+                "type": "string"
+              },
+              "headers": {
+                "type": "object",
+                "additionalProperties": {
+                  "type": "string",
+                  "minLength": 1
+                }
+              },
+              "includeSensitiveData": {
+                "type": "boolean"
+              },
+              "contentPatternRedaction": {
+                "type": "boolean"
+              },
+              "timeoutMs": {
+                "type": "integer",
+                "minimum": 1,
+                "maximum": 60000
+              },
+              "projectName": {
+                "type": "string",
+                "minLength": 1
+              }
+            }
           }
         }
       }
@@ -1199,14 +1238,77 @@
           }
         },
         "local": {
-          "description": "Configures local for the providers section.",
-          "examples": [
-            []
-          ],
           "type": "array",
           "items": {
             "type": "object",
-            "additionalProperties": true
+            "additionalProperties": false,
+            "required": [
+              "id",
+              "type"
+            ],
+            "properties": {
+              "id": {
+                "type": "string",
+                "minLength": 1
+              },
+              "type": {
+                "enum": [
+                  "ollama",
+                  "lmstudio",
+                  "openai_compat"
+                ]
+              },
+              "baseUrl": {
+                "type": "string"
+              },
+              "enabled": {
+                "type": "boolean"
+              },
+              "trustPublicUrl": {
+                "type": "boolean"
+              },
+              "apiKey": {
+                "type": "string"
+              },
+              "apiKeyEnv": {
+                "type": "string"
+              },
+              "models": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "required": [
+                    "name"
+                  ],
+                  "properties": {
+                    "name": {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    "alias": {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    "displayName": {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    "enabled": {
+                      "type": "boolean"
+                    },
+                    "capabilities": {
+                      "type": "object",
+                      "additionalProperties": true
+                    },
+                    "pricing": {
+                      "type": "object",
+                      "additionalProperties": true
+                    }
+                  }
+                }
+              }
+            }
           }
         }
       }
@@ -1498,20 +1600,10 @@
       "additionalProperties": false,
       "properties": {
         "jobs": {
-          "description": "Inline scheduled jobs. Folder-based cron jobs still merge from cron.dir.",
-          "examples": [
-            [
-              {
-                "id": "daily",
-                "expression": "0 8 * * *",
-                "prompt": "Summarize the overnight queue."
-              }
-            ]
-          ],
           "type": "array",
           "items": {
             "type": "object",
-            "additionalProperties": true,
+            "additionalProperties": false,
             "required": [
               "id",
               "expression",
@@ -1519,44 +1611,53 @@
             ],
             "properties": {
               "id": {
-                "type": "string"
+                "type": "string",
+                "minLength": 1
               },
               "enabled": {
                 "type": "boolean"
               },
               "expression": {
-                "type": "string"
+                "type": "string",
+                "minLength": 1
               },
               "timezone": {
-                "type": "string"
+                "type": "string",
+                "minLength": 1
               },
               "prompt": {
-                "type": "string"
+                "type": "string",
+                "minLength": 1
               },
               "conversationId": {
-                "type": "string"
+                "type": "string",
+                "minLength": 1
               },
               "maxRunMs": {
-                "type": "integer"
+                "type": "integer",
+                "minimum": 1
               },
               "notify": {
                 "type": "boolean"
               },
               "notifyConversationId": {
-                "type": "string"
+                "type": "string",
+                "minLength": 1
               },
               "notifyFailureCooldownHours": {
-                "type": "integer"
+                "type": "integer",
+                "minimum": 1
               },
               "model": {
-                "type": "string"
+                "type": "string",
+                "minLength": 1
               },
               "effort": {
-                "type": "string"
+                "type": "string",
+                "minLength": 1
               }
             }
-          },
-          "default": []
+          }
         },
         "enabled": {
           "description": "Enables the cron capability.",
@@ -1647,29 +1748,21 @@
       "additionalProperties": false,
       "properties": {
         "endpoints": {
-          "description": "Named webhook endpoints with per-endpoint prompt, model/effort, and maxRunMs overrides.",
-          "examples": [
-            [
-              {
-                "name": "triage",
-                "path": "/webhook/triage",
-                "prompt": "Triage this payload."
-              }
-            ]
-          ],
           "type": "array",
           "items": {
             "type": "object",
-            "additionalProperties": true,
+            "additionalProperties": false,
             "required": [
               "path"
             ],
             "properties": {
               "name": {
-                "type": "string"
+                "type": "string",
+                "minLength": 1
               },
               "path": {
-                "type": "string"
+                "type": "string",
+                "minLength": 1
               },
               "mode": {
                 "enum": [
@@ -1681,19 +1774,23 @@
                 "type": "boolean"
               },
               "prompt": {
-                "type": "string"
+                "type": "string",
+                "minLength": 1
               },
               "notify": {
                 "type": "boolean"
               },
               "notifyConversationId": {
-                "type": "string"
+                "type": "string",
+                "minLength": 1
               },
               "model": {
-                "type": "string"
+                "type": "string",
+                "minLength": 1
               },
               "effort": {
-                "type": "string"
+                "type": "string",
+                "minLength": 1
               },
               "maxRunMs": {
                 "type": "integer",
@@ -1701,8 +1798,7 @@
                 "maximum": 86400000
               }
             }
-          },
-          "default": []
+          }
         },
         "enabled": {
           "description": "Enables the webhook capability.",
@@ -1831,41 +1927,86 @@
       "additionalProperties": false,
       "properties": {
         "shortcuts": {
-          "description": "JSON-only global/message Slack shortcut bindings; there is no environment-variable form.",
-          "examples": [
-            [
-              {
-                "callbackId": "triage",
-                "prompt": "Prepare the daily support triage checklist.",
-                "channelId": "C0123"
-              }
-            ]
-          ],
           "type": "array",
           "items": {
             "type": "object",
-            "additionalProperties": true
-          },
-          "default": []
+            "additionalProperties": false,
+            "required": [
+              "callbackId",
+              "prompt"
+            ],
+            "properties": {
+              "callbackId": {
+                "type": "string",
+                "minLength": 1
+              },
+              "prompt": {
+                "type": "string",
+                "minLength": 1
+              },
+              "channelId": {
+                "type": "string",
+                "minLength": 1
+              },
+              "ackText": {
+                "type": "string",
+                "minLength": 1
+              },
+              "threadReply": {
+                "type": "boolean"
+              }
+            }
+          }
         },
         "homeTab": {
-          "description": "JSON-only Slack App Home configuration; enabled is optional (default false), buttons is optional (default []), and there is no environment-variable form.",
-          "examples": [
-            {
-              "enabled": true,
-              "headerText": "*Quick actions*",
-              "buttons": [
-                {
-                  "actionId": "triage",
-                  "label": "Triage",
-                  "prompt": "Triage today's requests.",
-                  "channelId": "C0123"
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "enabled": {
+              "type": "boolean"
+            },
+            "headerText": {
+              "type": "string",
+              "minLength": 1
+            },
+            "buttons": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "additionalProperties": false,
+                "required": [
+                  "actionId",
+                  "label",
+                  "prompt"
+                ],
+                "properties": {
+                  "actionId": {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "label": {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "prompt": {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "channelId": {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "ackText": {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "threadReply": {
+                    "type": "boolean"
+                  }
                 }
-              ]
+              }
             }
-          ],
-          "type": "object",
-          "additionalProperties": true
+          }
         },
         "enabled": {
           "description": "Enables the slack capability.",
@@ -1996,45 +2137,75 @@
       "additionalProperties": false,
       "properties": {
         "commands": {
-          "description": "Telegram command definitions handled by the Telegram adapter.",
-          "examples": [
-            [
-              {
-                "command": "status",
-                "prompt": "Report current status."
-              }
-            ]
-          ],
           "type": "array",
           "items": {
             "type": "object",
-            "additionalProperties": true
-          },
-          "default": []
+            "additionalProperties": false,
+            "required": [
+              "command",
+              "description"
+            ],
+            "properties": {
+              "command": {
+                "type": "string",
+                "pattern": "^[a-z0-9_]{1,32}$"
+              },
+              "description": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 256
+              },
+              "prompt": {
+                "type": "string",
+                "minLength": 1
+              }
+            }
+          }
         },
         "reactions": {
-          "description": "Telegram lifecycle reactions. The env override is boolean and toggles all states.",
-          "examples": [
+          "oneOf": [
             {
-              "working": true,
-              "done": true,
-              "error": true
+              "type": "boolean"
+            },
+            {
+              "type": "object",
+              "additionalProperties": false,
+              "properties": {
+                "working": {
+                  "type": "boolean"
+                },
+                "done": {
+                  "type": "boolean"
+                },
+                "error": {
+                  "type": "boolean"
+                }
+              }
             }
-          ],
-          "type": "object",
-          "additionalProperties": true
+          ]
         },
         "quietHours": {
-          "description": "Quiet-hours rules for Telegram notifications.",
-          "examples": [
-            {
-              "timezone": "Europe/Amsterdam",
-              "start": "22:00",
-              "end": "07:00"
-            }
-          ],
           "type": "object",
-          "additionalProperties": true
+          "additionalProperties": false,
+          "required": [
+            "start",
+            "end",
+            "timezone"
+          ],
+          "properties": {
+            "start": {
+              "type": "string",
+              "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$"
+            },
+            "end": {
+              "type": "string",
+              "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$"
+            },
+            "timezone": {
+              "type": "string",
+              "minLength": 1
+            }
+          }
         },
         "sendTools": {
           "type": "object",
@@ -2300,59 +2471,6 @@
           "type": "string"
         }
       }
-    },
-    "live": {
-      "type": "object",
-      "additionalProperties": false,
-      "properties": {
-        "enabled": {
-          "description": "Enables the live capability.",
-          "examples": [
-            true
-          ],
-          "type": "boolean",
-          "default": true
-        },
-        "host": {
-          "description": "Configures host for the live section.",
-          "examples": [
-            "127.0.0.1"
-          ],
-          "type": "string",
-          "default": "127.0.0.1"
-        },
-        "port": {
-          "description": "Configures port for the live section.",
-          "examples": [
-            0
-          ],
-          "type": "integer",
-          "default": 0
-        },
-        "basePath": {
-          "description": "Configures basePath for the live section.",
-          "examples": [
-            "/live"
-          ],
-          "type": "string",
-          "default": "/live"
-        },
-        "allowNonLoopback": {
-          "description": "Configures allowNonLoopback for the live section.",
-          "examples": [
-            true
-          ],
-          "type": "boolean",
-          "default": false
-        },
-        "apiKey": {
-          "description": "Secret value for live.apiKey; prefer the env override.",
-          "examples": [
-            "example"
-          ],
-          "type": "string"
-        }
-      }
     }
   }
 }

package/skills/mono-agent-composer/references/config-blueprint.md

@@ -183,7 +183,8 @@ new agent.
   },
 
   // Observability: the recorder writes empty events + a running summary at start,
-  // buffers key-redacted/capped events in RAM, then replaces both files at finish/fail.
+  // buffers sensitive-key-redacted, credential-scanned, capped events in RAM,
+  // then replaces both files at finish/fail.
   // A pre-terminal crash can lose buffered events. `mono-agent status` reads the
   // separate trace-source registry.
   "artifacts": {
@@ -213,7 +214,7 @@ new agent.
   },
 
   // ----- Channels: one section per channel; all independent. Most channels are
-  // ----- opt-in; operator surfaces (`tui`, `live`) default on and can opt out.
+  // ----- opt-in; the `tui` operator surface defaults on and can opt out.
   // ----- A waiting/disabled channel never blocks the others.
 
   "tui": {
@@ -224,14 +225,6 @@ new agent.
     "allowNonLoopback": false              // set MONO_AGENT_TUI_API_KEY in .env when needed
   },
 
-  "live": {
-    "enabled": true,                       // default-on read-only SSE relay (run-event operator surface)
-    "host": "127.0.0.1",
-    "port": 0,
-    "basePath": "/live",
-    "allowNonLoopback": false              // set MONO_AGENT_LIVE_API_KEY in .env when needed
-  },
-
   "webhook": {
     // For bearer auth, put MONO_AGENT_WEBHOOK_API_KEY=<strong-random-secret> in
     // the owner-only .env file; JSON strings are literal and do not interpolate env: values.
@@ -416,7 +409,7 @@ A `.env` file in the folder is loaded automatically (exported shell variables wi
 
 For BuJo capture and the effective `bujo` tier that runs scheduled consolidation, configure `memory.llm`. Use `provider: "ollama"` with a local Ollama chat model string and optional `endpoint`, or `provider: "agent-host"` with `model` as a normal SDK runtime model reference such as `pi:openai-codex:gpt-5.5` and `executionMode: "sdk"`. `endpoint` is Ollama-only, and CLI-backed refs such as `codex:gpt-5.5` are rejected for memory LLMs until runtimes can enforce no external actions. The same values can be supplied via `MONO_AGENT_MEMORY_LLM_PROVIDER`, `MONO_AGENT_MEMORY_LLM_MODEL`, `MONO_AGENT_MEMORY_LLM_EXECUTION_MODE`, and `MONO_AGENT_MEMORY_LLM_ENDPOINT`. Routine BuJo consolidation runs via the in-app scheduler; the standalone `memory-bujo` maintenance CLI was removed (use `mono-agent memory <subcommand>` from the agent folder). `agent-host` LLM capture is an in-app composition path that injects the `LlmComplete` implementation into the BuJo store.
 
-For operator views, run `mono-agent tui` or `mono-agent web` from any directory once the agent is started. Both discover running agents via the trace-source registry. The TUI and assistant-ui web console chat over the default-on `tui` stream endpoint (`"tui": {"enabled": false}` opts out); on macOS, `mono-agent tui --configure` opens a persistent, visibly marked proposal-only SELF-CONFIG conversation against the managed background agent and must not be combined with `--local`. Approval, rejection, and no-change turns continue that session; only quitting exits it. `mono-agent web` is an always-on service namespace, binds `0.0.0.0:5050` by default, and has no app login; use `--loopback` to narrow it. The `mono-agent sessions` Session Recorder command was removed; use `mono-agent tui` (recorded-run replay) or `mono-agent web` (live console). Its `@mono-agent/session-web` package still ships and reads artifacts plus live updates from the default-on `live` relay (`"live": {"enabled": false}` opts out), but has no CLI launcher. The low-level `mono-agent-tui` bin also supports `--responder <file>` (embedded, an ESM module default-exporting an `AgentResponderLike` or exporting `createResponder(env, cwd, configJson)`) and `--url <baseUrl>` (direct connect).
+For operator views, run `mono-agent tui` or `mono-agent web` from any directory once the agent is started. Both discover running agents via the trace-source registry. The TUI and assistant-ui web console chat over the default-on `tui` stream endpoint (`"tui": {"enabled": false}` opts out); on macOS, `mono-agent tui --configure` opens a persistent, visibly marked proposal-only SELF-CONFIG conversation against the managed background agent and must not be combined with `--local`. Approval, rejection, and no-change turns continue that session; only quitting exits it. `mono-agent web` is an always-on service namespace, binds `0.0.0.0:5050` by default, and has no app login; use `--loopback` to narrow it. The former read-only recorder command, package, and relay were removed; use `mono-agent tui` (recorded-run replay) or `mono-agent web` (live console). The low-level `mono-agent-tui` bin also supports `--responder <file>` (embedded, an ESM module default-exporting an `AgentResponderLike` or exporting `createResponder(env, cwd, configJson)`) and `--url <baseUrl>` (direct connect).
 
 ## Programmatic Escape Hatch
 

package/skills/mono-agent-composer/references/discovery-questions.md

@@ -252,7 +252,7 @@ Do you need a browsable trace viewer or just local artifacts?
 2. JSONL artifacts only (bounded terminal snapshots; no external viewer)
 ```
 
-Fills: `artifacts.dir`, `traceability.registryDir` / `sourceId` / `sourceLabel`, and — when Phoenix is wanted — an `observability.exporters` (phoenix) OTLP entry. The local recorder starts with empty events plus a `running` summary, applies key-based redaction and caps event strings at 4,096 bytes by default, buffers events in RAM, and replaces the artifacts at finish/fail; a pre-terminal crash can lose buffered events. Phoenix adds a best-effort terminal batch, not a crash-safe stream. Artifacts record runtime/tool/message events and summaries, not private chain-of-thought. For a terminal operator console, mention `mono-agent tui` (run from anywhere once the agent is started; live chat with thinking/tool insight, run replay, config view). Config is JSON-first — edit `mono-agent.config.json` directly and run `mono-agent restart` to apply changes.
+Fills: `artifacts.dir`, `traceability.registryDir` / `sourceId` / `sourceLabel`, and — when Phoenix is wanted — an `observability.exporters` (phoenix) OTLP entry. The local recorder starts with empty events plus a `running` summary, applies sensitive-key redaction, scans retained free text for high-confidence credential shapes, and caps event strings at 4,096 bytes by default. It buffers events in RAM and replaces the artifacts at finish/fail; a pre-terminal crash can lose buffered events. Phoenix adds a best-effort terminal batch, not a crash-safe stream. Artifacts record runtime/tool/message events and summaries, not private chain-of-thought. For a terminal operator console, mention `mono-agent tui` (run from anywhere once the agent is started; live chat with thinking/tool insight, run replay, config view). Config is JSON-first — edit `mono-agent.config.json` directly and run `mono-agent restart` to apply changes.
 
 ## 9. Acceptance Smoke Test