@mono-agent/agent-app 0.6.2 → 0.9.0

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

@@ -12,6 +12,22 @@
     "$schema": {
       "type": "string"
     },
+    "agent": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "name": {
+          "description": "Public display identity used for trace labels and default A2A metadata; never used in paths or service ids.",
+          "examples": [
+            "Research Partner"
+          ],
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 80,
+          "pattern": "^[^\\u0000-\\u001f\\u007f]+$"
+        }
+      }
+    },
     "runtime": {
       "type": "object",
       "additionalProperties": false,
@@ -19,12 +35,12 @@
         "model": {
           "description": "Configures model for the runtime section.",
           "examples": [
-            "pi:openai-codex:gpt-5.5"
+            "codex:gpt-5.6-terra"
           ],
           "type": "string"
         },
         "fallbackModels": {
-          "description": "Configures fallbackModels for the runtime section.",
+          "description": "Legacy fallback list whose routes inherit runtime.effort. Prefer runtime.fallbacks for new configs.",
           "examples": [
             [
               "pi:ollama:gemma4:31b"
@@ -33,7 +49,62 @@
           "type": "array",
           "items": {
             "type": "string"
-          }
+          },
+          "default": []
+        },
+        "fallbacks": {
+          "description": "Canonical ordered fallback routes. Omitted per-route effort means that provider's default.",
+          "examples": [
+            [
+              {
+                "model": "codex:gpt-5.6-sol"
+              },
+              {
+                "model": "pi:openai-codex:gpt-5.6-terra",
+                "effort": "high"
+              }
+            ]
+          ],
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "model"
+            ],
+            "properties": {
+              "model": {
+                "type": "string",
+                "minLength": 1
+              },
+              "effort": {
+                "type": "string",
+                "enum": [
+                  "none",
+                  "minimal",
+                  "low",
+                  "medium",
+                  "high",
+                  "xhigh",
+                  "max",
+                  "ultra"
+                ]
+              }
+            }
+          },
+          "default": []
+        },
+        "routeSafety": {
+          "description": "Uniform preserves one shared safety contract; per-route-native uses and reports each provider's explicit contract.",
+          "examples": [
+            "per-route-native"
+          ],
+          "type": "string",
+          "default": "uniform",
+          "enum": [
+            "uniform",
+            "per-route-native"
+          ]
         },
         "executionMode": {
           "description": "Configures executionMode for the runtime section.",
@@ -48,7 +119,17 @@
           "examples": [
             "medium"
           ],
-          "type": "string"
+          "type": "string",
+          "enum": [
+            "none",
+            "minimal",
+            "low",
+            "medium",
+            "high",
+            "xhigh",
+            "max",
+            "ultra"
+          ]
         },
         "permissionMode": {
           "description": "Configures permissionMode for the runtime section.",
@@ -219,14 +300,24 @@
             "bujo"
           ],
           "type": "string",
-          "default": "bujo"
+          "default": "bujo",
+          "enum": [
+            "bujo",
+            "supermemory"
+          ]
         },
         "mode": {
           "description": "Configures mode for the memory section.",
           "examples": [
             "journal"
           ],
-          "type": "string"
+          "type": "string",
+          "default": "lite",
+          "enum": [
+            "lite",
+            "journal",
+            "bujo"
+          ]
         },
         "path": {
           "description": "Configures path for the memory section.",
@@ -246,10 +337,15 @@
         "writeMode": {
           "description": "Configures writeMode for the memory section.",
           "examples": [
-            "append-host-summary"
+            "disabled"
           ],
           "type": "string",
-          "default": "append-host-summary"
+          "default": "disabled",
+          "enum": [
+            "disabled",
+            "append-host-summary",
+            "capture"
+          ]
         },
         "supermemory": {
           "type": "object",
@@ -306,21 +402,26 @@
           "additionalProperties": false,
           "properties": {
             "provider": {
-              "description": "Configures embeddings.provider for the memory section.",
+              "description": "Embedding service used by Journal/BuJo memory: ollama, lmstudio, or openai.",
               "examples": [
                 "ollama"
               ],
-              "type": "string"
+              "type": "string",
+              "enum": [
+                "ollama",
+                "lmstudio",
+                "openai"
+              ]
             },
             "model": {
               "description": "Configures embeddings.model for the memory section.",
               "examples": [
-                "nomic-embed-text"
+                "nomic-embed-text:v1.5"
               ],
               "type": "string"
             },
             "endpoint": {
-              "description": "Configures embeddings.endpoint for the memory section.",
+              "description": "Provider service root. LM Studio uses <root>/v1/embeddings and defaults to http://localhost:1234.",
               "examples": [
                 "example"
               ],
@@ -334,7 +435,7 @@
               "type": "string"
             },
             "apiKeyEnv": {
-              "description": "Secret value for memory.embeddings.apiKeyEnv; prefer the env override.",
+              "description": "Environment-variable name containing an optional provider bearer token; an explicitly declared name must resolve before memory starts.",
               "examples": [
                 "example"
               ],
@@ -388,12 +489,16 @@
               "examples": [
                 "agent-host"
               ],
-              "type": "string"
+              "type": "string",
+              "enum": [
+                "ollama",
+                "agent-host"
+              ]
             },
             "model": {
               "description": "Configures llm.model for the memory section.",
               "examples": [
-                "pi:openai-codex:gpt-5.5"
+                "pi:openai-codex:gpt-5.6-terra"
               ],
               "type": "string"
             },
@@ -438,7 +543,8 @@
               "examples": [
                 true
               ],
-              "type": "boolean"
+              "type": "boolean",
+              "default": true
             }
           }
         },
@@ -464,7 +570,178 @@
             }
           }
         }
-      }
+      },
+      "allOf": [
+        {
+          "if": {
+            "properties": {
+              "backend": {
+                "const": "bujo"
+              },
+              "mode": {
+                "const": "lite"
+              }
+            }
+          },
+          "then": {
+            "not": {
+              "anyOf": [
+                {
+                  "properties": {
+                    "embeddings": {}
+                  },
+                  "required": [
+                    "embeddings"
+                  ]
+                },
+                {
+                  "properties": {
+                    "llm": {}
+                  },
+                  "required": [
+                    "llm"
+                  ]
+                },
+                {
+                  "properties": {
+                    "consolidation": {}
+                  },
+                  "required": [
+                    "consolidation"
+                  ]
+                },
+                {
+                  "properties": {
+                    "writeMode": {
+                      "const": "capture"
+                    }
+                  },
+                  "required": [
+                    "writeMode"
+                  ]
+                }
+              ]
+            }
+          }
+        },
+        {
+          "if": {
+            "properties": {
+              "backend": {
+                "const": "bujo"
+              },
+              "mode": {
+                "const": "journal"
+              }
+            },
+            "required": [
+              "mode"
+            ]
+          },
+          "then": {
+            "required": [
+              "embeddings"
+            ],
+            "properties": {
+              "embeddings": {
+                "type": "object",
+                "minProperties": 1
+              }
+            },
+            "not": {
+              "anyOf": [
+                {
+                  "properties": {
+                    "llm": {}
+                  },
+                  "required": [
+                    "llm"
+                  ]
+                },
+                {
+                  "properties": {
+                    "consolidation": {}
+                  },
+                  "required": [
+                    "consolidation"
+                  ]
+                },
+                {
+                  "properties": {
+                    "writeMode": {
+                      "const": "capture"
+                    }
+                  },
+                  "required": [
+                    "writeMode"
+                  ]
+                }
+              ]
+            }
+          }
+        },
+        {
+          "if": {
+            "properties": {
+              "backend": {
+                "const": "bujo"
+              },
+              "mode": {
+                "const": "bujo"
+              }
+            },
+            "required": [
+              "mode"
+            ]
+          },
+          "then": {
+            "required": [
+              "embeddings",
+              "llm"
+            ],
+            "properties": {
+              "embeddings": {
+                "type": "object",
+                "minProperties": 1
+              },
+              "llm": {
+                "type": "object",
+                "properties": {
+                  "model": {}
+                },
+                "required": [
+                  "model"
+                ]
+              }
+            }
+          }
+        },
+        {
+          "if": {
+            "properties": {
+              "backend": {
+                "const": "bujo"
+              },
+              "writeMode": {
+                "const": "capture"
+              }
+            },
+            "required": [
+              "writeMode"
+            ]
+          },
+          "then": {
+            "properties": {
+              "mode": {
+                "const": "bujo"
+              }
+            },
+            "required": [
+              "mode"
+            ]
+          }
+        }
+      ]
     },
     "tools": {
       "type": "object",
@@ -507,6 +784,33 @@
           ],
           "type": "string"
         },
+        "mcpRequestContextServers": {
+          "description": "Configured stdio MCP server names that receive trusted per-request conversation, run, output-directory, and scoped progress context.",
+          "examples": [
+            [
+              "transcribe"
+            ]
+          ],
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          },
+          "default": [],
+          "uniqueItems": true
+        },
+        "continuationServers": {
+          "description": "Configures continuationServers for the tools section.",
+          "examples": [
+            [
+              "example"
+            ]
+          ],
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
         "mcpCallTimeoutMs": {
           "description": "Configures mcpCallTimeoutMs for the tools section.",
           "examples": [
@@ -534,7 +838,11 @@
           "examples": [
             "native"
           ],
-          "type": "string"
+          "type": "string",
+          "enum": [
+            "native",
+            "off"
+          ]
         },
         "network": {
           "type": "object",
@@ -546,7 +854,12 @@
                 "none"
               ],
               "type": "string",
-              "default": "none"
+              "default": "none",
+              "enum": [
+                "none",
+                "localhost",
+                "allowlist"
+              ]
             },
             "allowlist": {
               "description": "Configures network.allowlist for the sandbox section.",
@@ -604,7 +917,11 @@
             "fail-closed"
           ],
           "type": "string",
-          "default": "fail-closed"
+          "default": "fail-closed",
+          "enum": [
+            "fail-closed",
+            "unsafe-host-process"
+          ]
         },
         "unsafeAllowHostProcess": {
           "description": "Configures unsafeAllowHostProcess for the sandbox section.",
@@ -868,6 +1185,196 @@
         }
       }
     },
+    "continuations": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "default": true,
+          "description": "Enable the durable continuation service when continuation functionality is configured."
+        },
+        "host": {
+          "type": "string",
+          "enum": [
+            "127.0.0.1",
+            "::1",
+            "localhost"
+          ],
+          "default": "127.0.0.1",
+          "description": "Loopback-only continuation service host."
+        },
+        "port": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 65535,
+          "default": 4319,
+          "description": "Fixed continuation service port; 0 is intentionally invalid."
+        },
+        "stateDir": {
+          "type": "string",
+          "minLength": 1,
+          "default": ".mono-agent/continuations",
+          "description": "Owner-only durable continuation state directory."
+        },
+        "namedRoutes": {
+          "type": "object",
+          "default": {},
+          "propertyNames": {
+            "minLength": 1,
+            "maxLength": 128
+          },
+          "additionalProperties": {
+            "oneOf": [
+              {
+                "type": "object",
+                "additionalProperties": false,
+                "required": [
+                  "mode",
+                  "conversationId"
+                ],
+                "properties": {
+                  "mode": {
+                    "const": "notify_if_actionable"
+                  },
+                  "conversationId": {
+                    "type": "string",
+                    "minLength": 1
+                  }
+                }
+              },
+              {
+                "type": "object",
+                "additionalProperties": false,
+                "required": [
+                  "mode",
+                  "conversationId"
+                ],
+                "properties": {
+                  "mode": {
+                    "const": "capture"
+                  },
+                  "conversationId": {
+                    "type": "string",
+                    "minLength": 1
+                  }
+                }
+              },
+              {
+                "type": "object",
+                "additionalProperties": false,
+                "required": [
+                  "mode"
+                ],
+                "properties": {
+                  "mode": {
+                    "const": "silent"
+                  }
+                }
+              }
+            ]
+          }
+        },
+        "detachedServices": {
+          "type": "array",
+          "default": [],
+          "uniqueItems": true,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "name",
+              "tokenEnv"
+            ],
+            "properties": {
+              "name": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 128
+              },
+              "tokenEnv": {
+                "type": "string",
+                "pattern": "^[A-Z_][A-Z0-9_]*$"
+              }
+            }
+          }
+        },
+        "limits": {
+          "type": "object",
+          "additionalProperties": false,
+          "default": {},
+          "properties": {
+            "maxActiveRecords": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 1000000,
+              "default": 10000
+            },
+            "maxActivePerOrigin": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 1000000,
+              "default": 500
+            },
+            "maxConcurrent": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 256,
+              "default": 16
+            },
+            "synthesisTimeoutMs": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 86400000,
+              "default": 600000
+            },
+            "deliveryTimeoutMs": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 86400000,
+              "default": 120000
+            },
+            "operatorPageSize": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 500,
+              "default": 100
+            }
+          }
+        },
+        "retention": {
+          "type": "object",
+          "additionalProperties": false,
+          "default": {},
+          "properties": {
+            "terminalMaxRecords": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 9007199254740991,
+              "default": 50000
+            },
+            "terminalMaxAgeMs": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 9007199254740991,
+              "default": 31536000000
+            },
+            "capturedTextMaxRecords": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 9007199254740991,
+              "default": 1000
+            },
+            "capturedTextMaxAgeMs": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 9007199254740991,
+              "default": 2592000000
+            }
+          }
+        }
+      }
+    },
     "channels": {
       "type": "object",
       "additionalProperties": false,
@@ -1426,6 +1933,32 @@
           "type": "object",
           "additionalProperties": true
         },
+        "sendTools": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "scope": {
+              "description": "Bind Telegram send tools to the chat that produced the current run.",
+              "examples": [
+                "producing-conversation"
+              ],
+              "type": "string",
+              "enum": [
+                "producing-conversation"
+              ]
+            },
+            "pathScope": {
+              "description": "Confine Telegram path uploads to the current run output directory.",
+              "examples": [
+                "run-output"
+              ],
+              "type": "string",
+              "enum": [
+                "run-output"
+              ]
+            }
+          }
+        },
         "enabled": {
           "description": "Enables the telegram capability.",
           "examples": [
@@ -1514,6 +2047,40 @@
               "type": "integer"
             }
           }
+        },
+        "transcription": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "endpoint": {
+              "description": "Configures transcription.endpoint for the telegram section.",
+              "examples": [
+                "example"
+              ],
+              "type": "string"
+            },
+            "model": {
+              "description": "Configures transcription.model for the telegram section.",
+              "examples": [
+                "example"
+              ],
+              "type": "string"
+            },
+            "language": {
+              "description": "Configures transcription.language for the telegram section.",
+              "examples": [
+                "example"
+              ],
+              "type": "string"
+            },
+            "timeoutMs": {
+              "description": "Configures transcription.timeoutMs for the telegram section.",
+              "examples": [
+                1
+              ],
+              "type": "integer"
+            }
+          }
         }
       }
     },