@mono-agent/agent-app 0.13.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
+                    }
+                  }
+                }
+              }
+            }
           }
         }
       }
@@ -1220,7 +1322,7 @@
           "additionalProperties": false,
           "properties": {
             "host": {
-              "description": "Loopback host for the app-owned AskUser/tool-progress bridge.",
+              "description": "Bind host for the app-owned AskUser/tool-progress bridge. Defaults to loopback; keep it local because non-loopback values are not rejected.",
               "examples": [
                 "127.0.0.1"
               ],
@@ -1242,7 +1344,7 @@
           "additionalProperties": false,
           "properties": {
             "timeoutMs": {
-              "description": "Maximum wait for one AskUser question.",
+              "description": "Maximum wait for one AskUser interaction (one to five questions).",
               "examples": [
                 600000
               ],
@@ -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/SKILL.md

@@ -9,7 +9,7 @@ Construct a working mono-agent in the user's current folder — empty or already
 
 ## Authoritative Sources — Search, Then References, Never Package Source
 
-When the `search_mono_agent_docs` MCP tool is available, use it **before** opening files or following website links. Its version-matched offline corpus contains the canonical public documentation plus the `references/*.md` bundled beside this skill. For "can it do X?", "what is the key for Y?", and "how is Z configured?", search with `scope: "composer"`; returned composer chunks have the same authority as the bundled references. Use `scope: "all"` for broader conceptual or troubleshooting questions. Results include complete Markdown excerpts, so links are provenance rather than a required second retrieval step.
+When the `mono_agent_docs` MCP tool is available, use it **before** opening files or following website links. Its version-matched offline corpus contains the canonical public documentation plus the `references/*.md` bundled beside this skill. Start with `{"action":"search","query":"...","scope":"composer"}` for "can it do X?", "what is the key for Y?", and "how is Z configured?"; use `scope: "all"` for broader conceptual or troubleshooting questions. Search excerpts are a map, not the complete answer: call `{"action":"read","target":"<readTarget>"}` on the best result, follow the returned `internalLinks` with `action: "read"`, and use exact `previousTarget` / `nextTarget` actions when a long section continues. Composer-scoped content has the same authority as the bundled references.
 
 The bundled `references/*.md` remain the source of truth and the fallback when the MCP tool is unavailable. They are maintained in lockstep with the framework and are **complete for configuration and capabilities**. If the tool's `docsVersion` differs from the installed `mono-agent` version, use search for general context but verify version-specific config and CLI details against these local references. Reformulate a weak search once before falling back; never compensate by grepping package source.
 
@@ -17,13 +17,13 @@ Do **not** read or grep the `@mono-agent` TypeScript/package source — `package
 
 - `references/feature-coverage.md` is the **exhaustive** map of every feature to a `config` key, `cli` flag, `auto` behavior, or `code`-only escape hatch. If a capability is listed `config`/`cli`, use that key/flag verbatim. If it is **not in the table, or is marked `code`**, it is not reachable through `mono-agent.config.json` — say so plainly and name the escape hatch. Absence from the table means "not configurable," never "go check the source."
 - The real exception: if the user is **modifying the framework itself** (changing `@mono-agent` package code), that is framework development, not composing an agent — outside this skill. Only then is reading `packages/*/src` correct.
-- The published docs site (<https://mono-agent-docs.vercel.app/>) is the human-facing companion. Do not browse it just to discover links: `search_mono_agent_docs` returns the indexed content directly, and the bundled references work offline when the tool is absent.
+- The published docs site (<https://mono-agent-docs.vercel.app/>) is the human-facing companion. Do not browse it just to discover links: `mono_agent_docs` searches, expands, and resolves internal links offline, and the bundled references work when the tool is absent.
 
 **Red flags — STOP, you are about to grep source you should not:**
 
 | Thought | Reality |
 | --- | --- |
-| "Let me browse the docs navigation until I find the right page." | Search `search_mono_agent_docs`; it returns the matching excerpts directly. |
+| "Let me browse the docs navigation until I find the right page." | Search with `mono_agent_docs`, read the best `readTarget`, then follow its structured `internalLinks`. |
 | "Let me verify the key name against the source." | The references give the exact key. Trust them; don't re-derive from source. |
 | "The references might be incomplete — I'll double-check `packages/.../src`." | `feature-coverage.md` is exhaustive for config/CLI. Not in it = not configurable. |
 | "I'll confirm the docs and source agree." | You are composing an agent, not auditing the framework. The references are the contract. |
@@ -31,7 +31,7 @@ Do **not** read or grep the `@mono-agent` TypeScript/package source — `package
 
 ## Operating Rules
 
-- Answer capability/config questions from `search_mono_agent_docs` with `scope: "composer"`, falling back to the bundled `references/*.md` (authoritative and complete) — never grep or read the `@mono-agent` package source to compose an agent. See "Authoritative Sources" above.
+- Answer capability/config questions through `mono_agent_docs`: search with `scope: "composer"`, read the best target, and continue through structured links/windows as needed. Fall back to the bundled `references/*.md` (authoritative and complete) — never grep or read the `@mono-agent` package source to compose an agent. See "Authoritative Sources" above.
 
 - The deliverable is a folder that works: `mono-agent.config.json` + `IDENTITY.md` (+ optional `skills/`, `mcp.json`), validated and started — not a tutorial.
 - Start by discovering the intended agent product, not by naming packages.
@@ -105,7 +105,7 @@ Config-first covers one responder served over any combination of the seven chann
 - `references/package-map.md` — which package owns what, for programmatic composition and troubleshooting.
 - `references/validation.md` — validation commands and per-channel smoke tests; read before claiming the agent works.
 
-`search_mono_agent_docs` is the primary discovery interface when present; its composer-scoped results are built from these same versioned references. The bundled `references/*` files remain authoritative and self-sufficient when the tool is absent or version-mismatched, so use them rather than package source or a remote site. The published documentation site at <https://mono-agent-docs.vercel.app/> is the human-facing companion, not an AI retrieval dependency.
+`mono_agent_docs` is the primary discovery and reading interface when present; its composer-scoped results are built from these same versioned references. Always progress from `action: "search"` to `action: "read"` before concluding from a short hit, and use the response's exact navigation actions rather than inventing chunk or page locations. The bundled `references/*` files remain authoritative and self-sufficient when the tool is absent or version-mismatched, so use them rather than package source or a remote site. The published documentation site at <https://mono-agent-docs.vercel.app/> is the human-facing companion, not an AI retrieval dependency.
 
 ## Done Criteria