@mono-agent/agent-app 0.3.0 → 0.4.0

package/dist/ui.js

@@ -0,0 +1,153 @@
+import process from "node:process";
+/**
+ * Tiny zero-dependency terminal styling layer for the CLI. Every helper returns
+ * a plain string, so callers can keep writing through `process.stdout.write` or
+ * the injected `deps.stdout`/`deps.stderr` sinks in background.ts. Color is a
+ * single global decision keyed on the REAL process stdout (see
+ * {@link computeColorEnabled}); when it is off — piped output, `NO_COLOR`, or a
+ * non-TTY test harness — every styling helper degrades to plain ASCII so logs
+ * and test assertions stay greppable.
+ */
+const ANSI = {
+    reset: "",
+    bold: "",
+    dim: "",
+    red: "",
+    green: "",
+    yellow: "",
+    cyan: "",
+    gray: "",
+};
+/**
+ * Decide whether ANSI color should be emitted. `NO_COLOR` (any value) always
+ * wins per the no-color.org convention; `FORCE_COLOR` forces the decision when
+ * set to a recognized truthy/falsy value; otherwise color follows the TTY-ness
+ * of the stream. Pure and env-injected so it is trivially testable.
+ */
+export function computeColorEnabled(env, isTty) {
+    if (env.NO_COLOR !== undefined) {
+        return false;
+    }
+    const force = env.FORCE_COLOR;
+    if (force === "1" || force === "true") {
+        return true;
+    }
+    if (force === "0" || force === "false") {
+        return false;
+    }
+    return Boolean(isTty);
+}
+const colorEnabled = computeColorEnabled(process.env, process.stdout.isTTY);
+export function isColorEnabled() {
+    return colorEnabled;
+}
+function paint(code, text) {
+    return colorEnabled ? `${code}${text}${ANSI.reset}` : text;
+}
+/** Color/weight helpers. Each is the identity function when color is disabled. */
+export const style = {
+    bold: (text) => paint(ANSI.bold, text),
+    dim: (text) => paint(ANSI.dim, text),
+    red: (text) => paint(ANSI.red, text),
+    green: (text) => paint(ANSI.green, text),
+    yellow: (text) => paint(ANSI.yellow, text),
+    cyan: (text) => paint(ANSI.cyan, text),
+    gray: (text) => paint(ANSI.gray, text),
+};
+const BADGES = {
+    ok: { glyph: "✓", paint: style.green, plain: "[ok]   " },
+    waiting: { glyph: "⚠", paint: style.yellow, plain: "[wait] " },
+    disabled: { glyph: "○", paint: style.dim, plain: "[off]  " },
+    error: { glyph: "✗", paint: style.red, plain: "[error]" },
+};
+/**
+ * Render a status badge as a fixed-width prefix (badge + trailing space). With
+ * color on it is a green/yellow/dim/red glyph; with color off it falls back to
+ * an equal-width ASCII tag so columns still line up in plain output.
+ */
+export function badge(status) {
+    const spec = BADGES[status];
+    return colorEnabled ? `${spec.paint(spec.glyph)} ` : `${spec.plain} `;
+}
+/**
+ * Render aligned `label  value` rows: labels are padded to the widest label so
+ * values line up, replacing the hand-tuned `padEnd` blocks. `indent` prefixes
+ * every row with that many spaces (used to nest rows under a section rule).
+ * Returns one string with a trailing newline per row (empty when there are no
+ * rows).
+ */
+export function keyValue(rows, indent = 0) {
+    if (rows.length === 0) {
+        return "";
+    }
+    const pad = " ".repeat(indent);
+    const width = rows.reduce((max, [label]) => Math.max(max, label.length), 0);
+    return rows
+        .map(([label, value]) => `${pad}${style.gray(label.padEnd(width))}  ${value}\n`)
+        .join("");
+}
+const RULE_FALLBACK_WIDTH = 44;
+const RULE_MAX_WIDTH = 72;
+/**
+ * A horizontal section divider, optionally labeled — `── instance ────────`.
+ * Width tracks the terminal (read at call time so resizes are honored), capped
+ * for readability and falling back to a fixed width when stdout is not a TTY.
+ * Rendered dim/gray (identity when color is off); the label appears verbatim so
+ * it stays greppable. Always ends with a newline.
+ */
+export function rule(label) {
+    const width = Math.min(process.stdout.columns ?? RULE_FALLBACK_WIDTH, RULE_MAX_WIDTH);
+    if (label === undefined) {
+        return `${style.gray("─".repeat(width))}\n`;
+    }
+    const prefix = `── ${label} `;
+    const fill = Math.max(0, width - prefix.length);
+    return `${style.gray(`${prefix}${"─".repeat(fill)}`)}\n`;
+}
+/** Badge for a channel status *kind* string (running/waiting…/disabled/error). */
+export function channelBadge(kind) {
+    if (kind === "running") {
+        return badge("ok");
+    }
+    if (kind.startsWith("waiting")) {
+        return badge("waiting");
+    }
+    if (kind === "disabled") {
+        return badge("disabled");
+    }
+    if (/error|fail|crash/u.test(kind)) {
+        return badge("error");
+    }
+    return badge("waiting");
+}
+/** Badge for a trace-source health word (running/stale/stopped/…). */
+export function healthBadge(health) {
+    switch (health) {
+        case "running":
+            return badge("ok");
+        case "stale":
+            return badge("waiting");
+        case "stopped":
+            return badge("disabled");
+        default:
+            return badge("error");
+    }
+}
+/** A bold/cyan section heading with a trailing newline. */
+export function heading(text) {
+    return `${style.bold(style.cyan(text))}\n`;
+}
+/** The CLI title block: bold title plus an optional dim subtitle. */
+export function banner(title, subtitle) {
+    const head = style.bold(style.cyan(title));
+    return subtitle === undefined ? `${head}\n` : `${head} ${style.dim(`— ${subtitle}`)}\n`;
+}
+/** A red error line (✗ prefix) with a trailing newline — write to stderr. */
+export function errorLine(message) {
+    return `${style.red(`✗ ${message}`)}\n`;
+}
+/** A dim hint line (→ prefix) with a trailing newline. */
+export function hint(message) {
+    return `${style.dim(`→ ${message}`)}\n`;
+}
+//# sourceMappingURL=ui.js.map

package/dist/ui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.js","sourceRoot":"","sources":["../src/ui.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mono-agent/agent-app",
-  "version": "0.3.0",
-  "description": "Config-first mono-agent host: builds a responder and starts every configured communication channel, operator console, and traceability from one mono-agent.config.json.",
+  "version": "0.4.0",
+  "description": "Config-first mono-agent host: builds a responder and starts every configured communication channel and traceability from one mono-agent.config.json.",
   "type": "module",
   "license": "UNLICENSED",
   "private": false,
@@ -14,7 +14,8 @@
     }
   },
   "bin": {
-    "mono-agent": "./dist/cli.js"
+    "mono-agent": "./dist/cli.js",
+    "mono-agent-memory-recall": "./dist/memory-recall-main.js"
   },
   "files": [
     "dist",
@@ -22,20 +23,24 @@
     "README.md"
   ],
   "dependencies": {
-    "@mono-agent/a2a-adapter": "0.3.0",
-    "@mono-agent/agent-contracts": "0.3.0",
-    "@mono-agent/agent-host": "0.3.0",
-    "@mono-agent/config": "0.3.0",
-    "@mono-agent/cron-adapter": "0.3.0",
-    "@mono-agent/observability": "0.3.0",
-    "@mono-agent/openai-api-adapter": "0.3.0",
-    "@mono-agent/operator-console": "0.3.0",
-    "@mono-agent/runtime-adapter": "0.3.0",
-    "@mono-agent/settings": "0.3.0",
-    "@mono-agent/slack-adapter": "0.3.0",
-    "@mono-agent/telegram-adapter": "0.3.0",
-    "@mono-agent/webhook-adapter": "0.3.0",
-    "@mono-agent/whatsapp-adapter": "0.3.0"
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@mono-agent/a2a-adapter": "0.4.0",
+    "@mono-agent/agent-contracts": "0.4.0",
+    "@mono-agent/agent-host": "0.4.0",
+    "@mono-agent/config": "0.4.0",
+    "@mono-agent/cron-adapter": "0.4.0",
+    "@mono-agent/memory-bujo": "0.4.0",
+    "@mono-agent/memory-search": "0.4.0",
+    "@mono-agent/observability": "0.4.0",
+    "@mono-agent/observability-otel": "0.4.0",
+    "@mono-agent/openai-api-adapter": "0.4.0",
+    "@mono-agent/runtime-adapter": "0.4.0",
+    "@mono-agent/settings": "0.4.0",
+    "@mono-agent/slack-adapter": "0.4.0",
+    "@mono-agent/telegram-adapter": "0.4.0",
+    "@mono-agent/webhook-adapter": "0.4.0",
+    "@mono-agent/whatsapp-adapter": "0.4.0",
+    "zod": "^4.4.3"
   },
   "publishConfig": {
     "access": "public"

package/skills/mono-agent-composer/SKILL.md

@@ -5,7 +5,7 @@ description: Construct a working mono-agent in the current folder from one mono-
 
 # Mono Agent Composer
 
-Construct a working mono-agent in the user's current folder — empty or already holding knowledge — from one `mono-agent.config.json`. Discover what the user wants (runtime with backup models, communication channels incl. crons and webhooks, skills, MCP servers, memory strategy incl. semantic search, sandbox, operator console, observability), write the config, then make it run with the `mono-agent` CLI. No hand-written host code unless the user genuinely needs programmatic composition. `references/feature-coverage.md` maps every framework feature to a config key, CLI flag, or the programmatic escape hatch — consult it before declaring anything impossible or inventing keys.
+Construct a working mono-agent in the user's current folder — empty or already holding knowledge — from one `mono-agent.config.json`. Discover what the user wants (runtime with backup models, communication channels incl. crons and webhooks, skills, MCP servers, memory strategy incl. semantic search, sandbox, observability), write the config, then make it run with the `mono-agent` CLI. The config is JSON-first: edit `mono-agent.config.json` directly (agents can edit it too); changes apply on the next `mono-agent restart`. No hand-written host code unless the user genuinely needs programmatic composition. `references/feature-coverage.md` maps every framework feature to a config key, CLI flag, or the programmatic escape hatch — consult it before declaring anything impossible or inventing keys.
 
 ## Operating Rules
 
@@ -25,11 +25,12 @@ The `mono-agent` CLI ships with `@mono-agent/agent-app` on npm:
 npm install -g @mono-agent/agent-app   # or: npx @mono-agent/agent-app …
 ```
 
-To run an unreleased build instead, use a clone of the mono-agent workspace:
+To run an unreleased build instead, use a clone of the mono-agent workspace with Node 20+ and pnpm 10 or newer already installed:
 
 ```bash
 git clone <mono-agent-repo> ~/mono-agent && cd ~/mono-agent
-corepack enable && pnpm install --frozen-lockfile && pnpm run build
+pnpm install --frozen-lockfile
+pnpm run build
 alias mono-agent="node ~/mono-agent/packages/agent-app/dist/cli.js"
 ```
 
@@ -59,11 +60,11 @@ Everything below runs in the user's agent folder, not the workspace.
    mono-agent start
    ```
 
-   Then run the acceptance smoke test matching the chosen channel (see `references/validation.md`). The operator console URL printed at start lets the user edit config in the browser; saves re-apply live.
+   Then run the acceptance smoke test matching the chosen channel (see `references/validation.md`). To change anything, edit `mono-agent.config.json` directly and run `mono-agent restart`; there is no live browser re-apply.
 
 ## When Config Is Not Enough
 
-Config-first covers one responder served over any combination of the seven channels (webhook, OpenAI-compatible API, Telegram, Slack, WhatsApp, A2A, cron) plus the operator console, sandbox, memory (lite with FTS-only recall, journal with hybrid BM25+vector recall + Ollama embeddings, or bujo with SQLite-indexed hybrid recall + LLM capture/reconcile + entity graph + auto-scheduled reflection/migration), and traceability. Drop to programmatic composition only for: custom runtimes (`MonoRuntimeLike`, incl. the OpenAI Agents SDK), request-scoped runtime extensions, tool approval gates, structured output schemas, multi-agent orchestration (`@mono-agent/agent-orchestrator`), custom channel message texts, or bespoke transports — `references/feature-coverage.md` lists which features are config keys and which are code-only. Read `references/package-map.md` for the package boundaries, and start from `startMonoAgentApp({ drivers, runtime, ... })` or `@mono-agent/agent-host` rather than re-writing lifecycle glue. For eval suites over the composed agent, use `@mono-agent/agent-evals`.
+Config-first covers one responder served over any combination of the seven channels (webhook, OpenAI-compatible API, Telegram, Slack, WhatsApp, A2A, cron) plus sandbox, memory (lite with FTS-only recall, journal with hybrid BM25+vector recall + configured embeddings, or bujo with SQLite-indexed hybrid recall + LLM capture/reconcile + entity graph + auto-scheduled reflection/migration), and traceability. Drop to programmatic composition only for: custom `MonoRuntimeLike` implementations, request-scoped runtime extensions, tool approval gates, structured output schemas, multi-agent orchestration (`@mono-agent/agent-orchestrator`), custom channel message texts, or bespoke transports — `references/feature-coverage.md` lists which features are config keys and which are code-only. Read `references/package-map.md` for the package boundaries, and start from `startMonoAgentApp({ drivers, runtime, ... })` or `@mono-agent/agent-host` rather than re-writing lifecycle glue. For eval suites over the composed agent, use `@mono-agent/agent-evals`.
 
 ## Implementation References
 

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

@@ -9,6 +9,7 @@ my-agent/
   mono-agent.config.json   # the single declaration below
   IDENTITY.md              # role, boundaries, references to existing knowledge
   skills/                  # optional: <skill-name>/SKILL.md per selected skill
+  cron/                    # optional: <job-id>.md scheduled prompts
   mcp.json                 # optional: MCP server definitions
   .env                     # optional: secrets; auto-loaded by the CLI, never committed
   .mono-agent/
@@ -40,6 +41,12 @@ my-agent/
   // Local/self-hosted providers for pi:<provider>:<model> references.
   "providers": {
     "piAuthPath": "~/.pi/agent/auth.json", // Pi OAuth credentials (openai-codex, ...)
+    // Pi-native bridge tuning (all optional).
+    "piNative": {
+      "piMaxRetries": 2,                   // 0-8; transient provider-transport retries
+      "maxRetryDelayMs": 60000,            // backoff cap between retries (ms)
+      "piSessionsRoot": ".mono-agent/sessions" // durable JSONL sessions → resume across restarts (unset = in-memory)
+    },
     "local": [
       {
         "id": "ollama",
@@ -65,13 +72,13 @@ my-agent/
   // Memory strategy. Omit the section for no memory.
   // Three tiers over one substrate (memory-store + memory-bujo):
   //   lite    — FTS keyword recall + rapid-log; no external deps.
-  //   journal — + hybrid recall (BM25+vector) + decay; needs Ollama embeddings.
+  //   journal — + hybrid recall (BM25+vector) + decay; needs embeddings.
   //   bujo    — + LLM capture/reconcile + entity graph + auto-scheduled
-  //             reflection/migration; needs Ollama embeddings + chat model.
+  //             reflection/migration; needs embeddings + an app-level memory.llm.
   "memory": {
     "mode": "bujo",                        // lite | journal | bujo
     "path": "./.mono-agent/memory",        // root directory for all tiers
-    "writeMode": "append-host-summary",    // disabled | append-host-summary
+    "writeMode": "capture",                // disabled | append-host-summary | capture (bujo only)
     "maxBytes": 64000,
     "embeddings": {                        // required for journal and bujo
       "provider": "ollama",                // ollama | openai
@@ -80,10 +87,12 @@ my-agent/
       "apiKeyEnv": "OPENAI_API_KEY",       // or inline "apiKey"; required for openai
       "dim": 768                           // nomic-embed-text:v1.5 output dimension
     },
-    "llm": {                               // required for bujo; omit for lite/journal
-      "provider": "ollama",
-      "model": "qwen3.6:latest",           // any local Ollama chat model; also set MONO_AGENT_MEMORY_LLM_MODEL for CLI
-      "endpoint": "http://localhost:11434" // optional; defaults to http://localhost:11434
+    "llm": {                               // enables bujo capture/rituals; omit for lite/journal
+      // Env: MONO_AGENT_MEMORY_LLM_PROVIDER / _MODEL / _EXECUTION_MODE / _ENDPOINT.
+      "provider": "ollama",                // ollama | agent-host
+      "model": "qwen3.6:latest",           // ollama: model string; agent-host: runtime ref, e.g. pi:openai-codex:gpt-5.5
+      "endpoint": "http://localhost:11434" // ollama only; invalid for agent-host
+      // For agent-host, use: "model": "pi:openai-codex:gpt-5.5", "executionMode": "sdk"; omit endpoint.
     },
     // Bujo auto-scheduler — override defaults or disable per-ritual.
     // Rituals run in-app; no external cron or launchd needed.
@@ -109,7 +118,8 @@ my-agent/
     "unsafeAllowHostProcess": false        // explicit opt-in required for the unsafe fallback
   },
 
-  // Observability: JSONL artifacts + the trace-source registry dashboards read.
+  // Observability: JSONL artifacts (always written; the local fallback) + the
+  // trace-source registry that `mono-agent status` reads.
   "artifacts": { "dir": "./.mono-agent/artifacts" },
   "traceability": {
     "registryDir": "./.mono-agent/trace-sources",
@@ -119,10 +129,12 @@ my-agent/
     "staleAfterMs": 30000
   },
 
-  // Local operator console (browser settings + traceability). On by default.
-  "console": {
-    "enabled": true,
-    "port": 0                              // 0 or omitted picks a free loopback port
+  // Optional trace viewer: add a Phoenix (OTLP) exporter to browse traces in
+  // Phoenix. Omit this entry to keep only the local JSONL artifacts.
+  "observability": {
+    "exporters": [
+      { "type": "phoenix", "endpoint": "http://127.0.0.1:6006/v1/traces" }
+    ]
   },
 
   // ----- Channels: one section per channel; all independent. An unconfigured
@@ -149,6 +161,11 @@ my-agent/
     "apiKey": "..."                        // optional bearer required from clients
   },
 
+  // Telegram & Slack deliver only the FINAL answer by default (no streamed
+  // interim edits) while showing a working indicator — Telegram a "typing…"
+  // action, Slack a 👀 "seen" reaction. This is built-in behavior (not a JSON
+  // field); restoring live interim streaming needs a custom channel driver with
+  // stream.finalOnly=false. The OpenAI-compatible endpoint still streams tokens.
   "telegram": {
     "enabled": true,                       // opt-in; defaults to false (off → "disabled")
     "botToken": "...",
@@ -223,13 +240,15 @@ my-agent/
 
 ```bash
 mono-agent init --model claude:claude-sonnet-4-6 --fallback-models pi:ollama:gemma4:31b [--memory lite|journal|bujo]
-mono-agent validate     # per-section report incl. sandbox, console, every channel; exit 0 means ready
-mono-agent start        # console + traceability + every configured channel
-mono-agent start --no-console   # headless (or "console": { "enabled": false })
-mono-agent start --port 4400    # fixed console port (or "console": { "port": 4400 })
+mono-agent validate     # per-section report incl. sandbox, observability, every channel; exit 0 means ready
+mono-agent start        # traceability + every configured channel
+mono-agent restart      # apply config edits (config is JSON-first; restart to re-apply)
+mono-agent restart --force  # restart AND purge persisted pi sessions (fresh start; durable memory kept)
 ```
 
-A `.env` file in the folder is loaded automatically (exported shell variables win); use `--env-file <path>` for an alternate file. `start` prints the operator console URL (config editing in the browser; saves re-apply live without restarting), the traceability source, and one status line per channel: `running` with its endpoint facts, `waiting_for_config` with the exact missing setting, `disabled`, or `failed` with the reason.
+A `.env` file in the folder is loaded automatically (exported shell variables win); use `--env-file <path>` for an alternate file. `start` prints the traceability source (Phoenix when an `observability.exporters` Phoenix entry is configured, otherwise the local JSONL artifacts) and one status line per channel: `running` with its endpoint facts, `waiting_for_config` with the exact missing setting, `disabled`, or `failed` with the reason. Config is JSON-first: edit `mono-agent.config.json` directly (agents can edit it) and run `mono-agent restart` to apply — there is no live browser re-apply.
+
+For BuJo capture and rituals, 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`. The standalone `memory-bujo` maintenance CLI remains Ollama-only; `agent-host` LLM capture is an in-app composition path that injects the `LlmComplete` implementation into the BuJo store.
 
 For a local terminal chat against the same config, `@mono-agent/tui` ships a `mono-agent-tui` bin: `mono-agent-tui --config ./mono-agent.config.json`.
 
@@ -242,7 +261,7 @@ import { startMonoAgentApp, defaultChannelDrivers } from "@mono-agent/agent-app"
 
 const app = await startMonoAgentApp({
   cwd: process.cwd(),
-  runtime: myCustomRuntime,            // any MonoRuntimeLike (incl. createOpenAIAgentsRuntime)
+  runtime: myCustomRuntime,            // any MonoRuntimeLike
   drivers: [...defaultChannelDrivers(), myCustomDriver],
 });
 ```

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

@@ -74,7 +74,7 @@ What tools or MCP servers does the agent actually need?
 4. Both
 ```
 
-Fills: `tools.allowedTools`, `tools.disallowedTools` (denylist wins), `tools.mcpConfigPath`. Record exact tool names; do not broaden access as a convenience.
+Fills: `tools.allowedTools`, `tools.disallowedTools` (denylist wins), `tools.mcpConfigPath`. Record exact tool names; do not broaden access as a convenience. To expose adapter-derived send tools, include `slack_send_message` / `telegram_send_message`; valid enabled Slack/Telegram adapter config and destination allowlists are still required.
 
 ## 6. Memory Strategy
 
@@ -85,14 +85,14 @@ Should the agent remember anything between conversations?
 
 1. No durable memory yet (recommended for first integration)
 2. Lite memory — FTS keyword recall + rapid-log capture; zero external deps
-3. Journal memory — hybrid recall (BM25+vector) + salience decay; requires local Ollama embeddings
+3. Journal memory — hybrid recall (BM25+vector) + salience decay; requires embeddings
 4. BuJo memory — full tier: journal + LLM capture/reconcile + entity graph + auto-scheduled
-   reflection/migration; requires Ollama embeddings AND a local chat model
+   reflection/migration; requires embeddings AND a chat model
 ```
 
 All tiers share the same `@mono-agent/memory-bujo` substrate. Fills: `memory.mode`
 (`lite`/`journal`/`bujo`), `memory.path`, `memory.writeMode`
-(`disabled`/`append-host-summary`), and tier-specific blocks below.
+(`disabled`/`append-host-summary`/`capture`), and tier-specific blocks below.
 
 **Tier 2 — lite (no external deps):**
 
@@ -110,9 +110,11 @@ No prerequisites. No Ollama. SQLite is bundled.
 
 **Tier 3 — journal (embeddings required):**
 
-- Ask: which local Ollama embeddings model? (default `nomic-embed-text:v1.5` — use the
-  exact `:v1.5` tag; pull first with `ollama pull nomic-embed-text:v1.5`).
-- Default `memory.embeddings.dim` to `768` for `nomic-embed-text:v1.5`.
+- Ask: which embeddings provider/model?
+  - Ollama default: `provider: "ollama"`, model `nomic-embed-text:v1.5`, dim `768`
+    (use the exact `:v1.5` tag; pull first with `ollama pull nomic-embed-text:v1.5`).
+  - OpenAI option: `provider: "openai"`, model `text-embedding-3-small`, API key via
+    `apiKeyEnv`, dim matching the model.
 
 Write:
 
@@ -129,8 +131,8 @@ Write:
 }
 ```
 
-After writing, remind the user to run `mono-agent validate` (checks Ollama reachability
-and that the model is pulled — warns loudly on any failure, never silently falls back).
+After writing, remind the user to run `mono-agent validate` (checks root writability and
+provider-specific liveness; Ollama model pulls are checked only when using Ollama).
 
 **Tier 4 — bujo (embeddings + chat model + auto-rituals):**
 
@@ -140,11 +142,15 @@ migration (promote/reschedule/cluster/forget), living `index.md` + `future-log.m
 The reflection and migration rituals are **auto-scheduled in-app** — no external cron or
 launchd setup needed.
 
-- Ask: which local Ollama embeddings model? (default `nomic-embed-text:v1.5` — exact
-  `:v1.5` tag; `ollama pull nomic-embed-text:v1.5`).
-- Ask: which local chat model for LLM pipelines? (e.g. `qwen3.6:latest`;
-  `ollama pull qwen3.6:latest`). A chat model is required — without it the `bujo` tier
-  cannot run capture/reflect/migrate.
+- Ask: which embeddings provider/model? Use the same choices as journal.
+- Ask: which chat LLM provider/model for LLM pipelines?
+  - Ollama: local model string such as `qwen3.6:latest`; pull it first with
+    `ollama pull qwen3.6:latest`.
+  - agent-host: SDK runtime model reference such as `pi:openai-codex:gpt-5.5` with
+    `executionMode: "sdk"`. Do not use CLI-backed refs such as `codex:gpt-5.5`; they are
+    rejected for memory LLMs until runtimes can enforce no external actions.
+- Ask: should per-turn intelligent capture be enabled (`writeMode: "capture"`), or only
+  deterministic rapid-log summaries (`append-host-summary`) plus scheduled rituals?
 - Ask: should we keep the default reflection/migration schedule (nightly `0 3 * * *` /
   monthly `0 4 1 * *`), or customise the cron expressions?
 
@@ -154,7 +160,7 @@ Write (embeddings + chat model):
 "memory": {
   "mode": "bujo",
   "path": "./.mono-agent/memory",
-  "writeMode": "append-host-summary",
+  "writeMode": "capture",
   "embeddings": {
     "provider": "ollama",
     "model": "nomic-embed-text:v1.5",
@@ -167,6 +173,16 @@ Write (embeddings + chat model):
 }
 ```
 
+For an agent-host memory LLM, write the `llm` block as:
+
+```jsonc
+"llm": {
+  "provider": "agent-host",
+  "model": "pi:openai-codex:gpt-5.5",
+  "executionMode": "sdk"
+}
+```
+
 If the user customises the ritual schedule, add the `reflection`/`migration` blocks:
 
 ```jsonc
@@ -179,11 +195,11 @@ After writing, append a prerequisite note:
 ```
 Before running mono-agent validate, pull the required models:
   ollama pull nomic-embed-text:v1.5
-  ollama pull qwen3.6:latest          # (or whichever chat model you chose)
+  ollama pull qwen3.6:latest          # only if using llm.provider: "ollama"
 ```
 
-Then run `mono-agent validate` — the Memory section confirms Ollama reachability, both
-models are present, the root is writable, and the ritual cadence (with next-run times).
+Then run `mono-agent validate` — the Memory section confirms the root is writable,
+provider-specific liveness, and the ritual cadence (with next-run times).
 See `docs/memory.md` for the full tier table, config shapes, and CLI subcommands
 (`memory-bujo rebuild|recall|index|reflect|migrate`).
 
@@ -207,14 +223,13 @@ Fills: the `sandbox` section — `mode`, `network.mode` (`none`/`localhost`/`all
 Question:
 
 ```text
-Do you need browsable traceability or just local artifacts?
+Do you need a browsable trace viewer or just local artifacts?
 
-1. JSONL artifacts and the operator console (recommended; console is on by default)
-2. JSONL artifacts and the console on a fixed port
-3. JSONL artifacts only (headless)
+1. JSONL artifacts plus Phoenix as the trace viewer (recommended; add an `observability.exporters` Phoenix entry)
+2. JSONL artifacts only (the local fallback; no external viewer)
 ```
 
-Fills: `artifacts.dir`, `traceability.registryDir` / `sourceId` / `sourceLabel`, and the `console` section — `console.port` for a fixed loopback port, `console.enabled: false` (or `start --no-console`) for headless. Artifacts record runtime/tool/message events and summaries, not private chain-of-thought. For a local terminal chat instead of (or alongside) the browser console, mention `mono-agent-tui --config ./mono-agent.config.json`.
+Fills: `artifacts.dir`, `traceability.registryDir` / `sourceId` / `sourceLabel`, and — when Phoenix is wanted — an `observability.exporters` (phoenix) OTLP entry. Local JSONL artifacts are always written and are the fallback when no exporter is configured. Artifacts record runtime/tool/message events and summaries, not private chain-of-thought. For a local terminal chat, mention `mono-agent-tui --config ./mono-agent.config.json`. Config is JSON-first — edit `mono-agent.config.json` directly and run `mono-agent restart` to apply changes.
 
 ## 9. Acceptance Smoke Test
 

package/skills/mono-agent-composer/references/feature-coverage.md

@@ -14,10 +14,11 @@ Every framework capability and how a composed agent reaches it. Use this to answ
 | Continuous provider sessions with idle eviction | config | `runtime.session.{mode,idleTimeoutMs}` |
 | Local providers (Ollama / LM Studio / OpenAI-compatible) | config | `providers.local[]` |
 | Pi OAuth credentials | config | `providers.piAuthPath` |
-| Context compaction, tool-output bloat guard, cost tracking | auto | built into every run |
+| Tool-output bloat guard, cost tracking | auto | built into every run |
+| Context handling | provider | delegated to the provider; the pi bridge (pi-agent-core AgentHarness) runs no automatic in-loop summarization, so runs report `context_compaction_applied: null` |
 | Structured output (JSON schema), live input steering | code | harness `runtimeOptions` |
 | Tool approval gates (risk tiers, timeouts, always-allow) | code | `createMonoRuntime({ onToolApprovalRequest, ... })` — needs a host UI |
-| OpenAI Agents SDK backend / fully custom runtime | code | `startMonoAgentApp({ runtime })` |
+| Fully custom runtime | code | `startMonoAgentApp({ runtime })` |
 
 ## Context, skills, memory
 
@@ -28,13 +29,14 @@ Every framework capability and how a composed agent reaches it. Use this to answ
 | Per-skill byte cap | config | `context.skillMaxBytes` |
 | Conversation history (in-memory; unlimited unless turns are capped) | auto | sized from `runtime.maxTurns`; custom store via code |
 | Lite memory (FTS keyword recall + rapid-log capture; no external deps) | config | `memory.mode: "lite"`, `path`, `maxBytes`, `writeMode` |
-| Journal memory (hybrid recall BM25+vector + salience decay; needs Ollama embeddings) | config | `memory.mode: "journal"`, `path`, `memory.embeddings.{provider,model,dim}` |
-| BuJo memory (journal + LLM capture/reconcile ADD/UPDATE/SUPERSEDE/NOOP + entity graph + auto-scheduled reflection/migration; needs Ollama embeddings + chat model) | config | `memory.mode: "bujo"`, `path`, `memory.embeddings.{provider,model,dim}`, `memory.llm.{provider,model,endpoint}` — see `docs/memory.md` |
+| Journal memory (hybrid recall BM25+vector + salience decay; needs configured embeddings) | config | `memory.mode: "journal"`, `path`, `memory.embeddings.{provider,model,dim}` (`provider: "ollama" | "openai"`) |
+| BuJo memory (journal + LLM capture/reconcile ADD/UPDATE/SUPERSEDE/NOOP + entity graph + auto-scheduled reflection/migration; needs embeddings + an app-level `memory.llm`) | config | `memory.mode: "bujo"`, `path`, `memory.embeddings.{provider,model,dim}`, `memory.llm` with `provider: "ollama"` (`model`, optional `endpoint`) or `provider: "agent-host"` (`model` is an SDK runtime model ref, e.g. `pi:openai-codex:gpt-5.5`, optional `executionMode: "sdk"`) — see `docs/memory.md` |
 | BuJo reflection auto-scheduler (nightly decay + insight synthesis; in-app, no external cron needed) | config | `memory.reflection.{enabled,cron}` (default `0 3 * * *`); env `MONO_AGENT_MEMORY_REFLECTION_CRON`, `MONO_AGENT_MEMORY_REFLECTION_ENABLED` |
 | BuJo migration auto-scheduler (monthly promote/reschedule/cluster/forget; in-app) | config | `memory.migration.{enabled,cron}` (default `0 4 1 * *`); env `MONO_AGENT_MEMORY_MIGRATION_CRON`, `MONO_AGENT_MEMORY_MIGRATION_ENABLED` |
-| Memory out-of-band maintenance CLI (rebuild/recall/index/reflect/migrate) | cli | `memory-bujo <subcommand> <root>`; opt-in `MONO_AGENT_MEMORY_EMBEDDINGS_PROVIDER`/`_MODEL`/`_DIM` for semantic recall; `MONO_AGENT_MEMORY_LLM_MODEL`, `MONO_AGENT_MEMORY_LLM_ENDPOINT` required for reflect/migrate |
-| Memory liveness check (root writable; Ollama + models for journal/bujo; ritual cadence for bujo — loud warn, no silent fallback) | cli | `mono-agent validate` |
+| Memory out-of-band maintenance CLI (rebuild/recall/index/reflect/migrate) | cli | `memory-bujo <subcommand> <root>`; opt-in `MONO_AGENT_MEMORY_EMBEDDINGS_PROVIDER`/`_MODEL`/`_DIM` for semantic recall; reflect/migrate are Ollama-only and require `MONO_AGENT_MEMORY_LLM_MODEL` (optional `MONO_AGENT_MEMORY_LLM_ENDPOINT`) |
+| Memory liveness check (root writable; provider-specific Ollama checks only when embeddings/chat use Ollama; BuJo LLM config + ritual cadence — loud warn, no silent fallback) | cli | `mono-agent validate` |
 | Host summaries appended after runs | config | `memory.writeMode: "append-host-summary"` |
+| Auto-provisioned read-only `memory_recall` tool (hybrid keyword+semantic search) exposed to the agent from the single memory config; no chat LLM | config | `config.memory.recallTool.enabled` (`MONO_AGENT_MEMORY_RECALL_TOOL_ENABLED`, default on for journal/bujo with embeddings) |
 
 ## Tools, MCP, sandbox
 
@@ -43,6 +45,7 @@ Every framework capability and how a composed agent reaches it. Use this to answ
 | Fail-closed tool policy (empty allowlist = no tools) | auto | default |
 | Tool allow/deny lists (deny wins) | config | `tools.allowedTools`, `tools.disallowedTools` |
 | MCP servers (stdio/sse/http) from a JSON file | config | `tools.mcpConfigPath` |
+| Adapter-derived send tools for enabled Slack/Telegram adapters | config | `tools.allowedTools` must include `slack_send_message` / `telegram_send_message`; valid `slack.*` / `telegram.*` config and existing adapter allowlists provide credentials and destination bounds |
 | Sandbox on/off + srt engine | config | `sandbox.mode` |
 | Network policy (none/localhost/allowlist/all) | config | `sandbox.network.{mode,allowlist}` |
 | Filesystem scopes (readable/writable roots, deny-write globs) | config | `sandbox.readableRoots`, `sandbox.writableRoots`, `sandbox.denyWrite` |
@@ -60,7 +63,7 @@ Every framework capability and how a composed agent reaches it. Use this to answ
 | WhatsApp (Baileys, QR login, group mention/any triggers) | config | `whatsapp` section |
 | A2A provider (Agent Card, JSON-RPC + REST, streaming, bearer) | config | `a2a.provider` + `a2a.agent` + `a2a.skill` |
 | A2A consumer settings (remote agent URLs, timeouts) | config + code | `a2a.consumer` holds settings; calls via `createA2AConsumerResponder` |
-| Cron jobs (five-field expressions, timezones, overlap skip) | config | `cron.jobs[]` |
+| Cron jobs (five-field expressions, timezones, overlap skip) | config | `cron.jobs[]`, single-job `MONO_AGENT_CRON_*`, or one markdown file per job in `cron.dir` / `MONO_AGENT_CRON_DIR` (default `cron/`) |
 | Channel message texts / stream tuning (welcome, debounce, ...) | code | channel driver overrides |
 | Custom transports | code | implement `ChannelDriver`, pass via `startMonoAgentApp({ drivers })` |
 
@@ -69,8 +72,8 @@ Every framework capability and how a composed agent reaches it. Use this to answ
 | Capability | Coverage | Where |
 | --- | --- | --- |
 | JSONL run artifacts (events + summaries, secrets redacted) | config | `artifacts.dir` |
-| Trace-source registry (heartbeat manifests for dashboards) | config | `traceability.{registryDir,sourceId,sourceLabel,heartbeatMs,staleAfterMs}` |
-| Operator console (browser settings editor, traceability views, live config re-apply, bearer token) | config + cli | `console.{enabled,port}`; `--port`, `--no-console` |
+| Trace-source registry (heartbeat manifests `mono-agent status` reads) | config | `traceability.{registryDir,sourceId,sourceLabel,heartbeatMs,staleAfterMs}` |
+| Phoenix trace viewer (OTLP exporter; local JSONL artifacts are the fallback) | config | `observability.exporters` (phoenix entry) |
 | Terminal chat (TUI with transcript + redacted config pane) | cli | `mono-agent-tui --config ./mono-agent.config.json` |
 | Scaffold / validate / start / install-skill | cli | `mono-agent init|validate|start|install-skill` |
 | `.env` auto-loading | cli | automatic; `--env-file <path>` |

package/skills/mono-agent-composer/references/package-map.md

@@ -4,7 +4,7 @@ Use this map to select the smallest mono-agent package set for a host. Package c
 
 ## App Join (default)
 
-`@mono-agent/agent-app` is the config-first host: it loads `mono-agent.config.json`, builds the responder through `agent-host`, and drives every configured channel plus the operator console and traceability. It ships the `mono-agent` CLI (`init`, `validate`, `start`) and is the only publishable package allowed to compose communication adapters.
+`@mono-agent/agent-app` is the config-first host: it loads `mono-agent.config.json`, builds the responder through `agent-host`, and drives every configured channel plus traceability and any configured observability exporters. It ships the `mono-agent` CLI (`init`, `validate`, `start`) and is the only publishable package allowed to compose communication adapters.
 
 ```ts
 import { startMonoAgentApp } from "@mono-agent/agent-app";
@@ -51,6 +51,7 @@ Use this path when the agent needs identity, selected skills, history, and optio
 | Memory substrate (schema, migrations, FTS+vector db, RRF) | `@mono-agent/memory-store` | SQLite storage, BM25 FTS, optional vector index, hybrid recall; `MemoryStore`/`MemoryBlock`/`MemoryWriteResult` contract |
 | Memory engine (all tiers: lite/journal/bujo) | `@mono-agent/memory-bujo` | `BujoMemoryStore` — tier-aware: FTS recall (lite), hybrid recall + decay (journal), LLM capture/reconcile + entity graph + reflection/migration + auto-scheduler (bujo) |
 | Embedding providers | `@mono-agent/memory-search` | Ollama/OpenAI embedding providers used by memory-store for vector recall |
+| Recall tool surface | `@mono-agent/agent-app` (bundled) | Auto-provisions a read-only `memory_recall` tool (hybrid keyword+semantic search) from `config.memory.recallTool.enabled`; spawns the bundled `mono-agent-memory` stdio child using the same memory root + embeddings as the in-app memory |
 
 Mono-agent selected skills are not auto-selected by description. The host chooses `context.selectedSkills`, and the harness loads those exact bodies.
 
@@ -103,15 +104,14 @@ Communication adapters are edge packages. They accept an `AgentResponder` and ow
 
 Adapters must not import the harness, runtime adapter, memory packages (`memory-store`, `memory-bujo`, `memory-search`), or other adapters. `@mono-agent/agent-app` composes them from config; custom hosts and demos may compose them directly.
 
-## Operator And Observability Join
+## Observability Join
 
 Use:
 
-- `@mono-agent/operator-console` for local browser settings and traceability (`console` config section; per-boot bearer token; saves re-apply live).
 - `@mono-agent/tui` for local terminal chat and redacted read-only config (`mono-agent-tui --config ./mono-agent.config.json`).
-- `@mono-agent/observability` for JSONL event artifacts, summaries, and trace-source registration.
+- `@mono-agent/observability` for JSONL event artifacts, summaries, and trace-source registration; add `@mono-agent/observability-otel` for the Phoenix OTLP exporter configured via `observability.exporters`.
 
-Traceability is local-first. A running host registers a source manifest; the operator console reads artifacts by `(sourceId, runId)` so duplicate run ids do not collide.
+Traceability is local-first. A running host registers a source manifest; `mono-agent status` reads the trace-source registry to report live sources, and artifacts are keyed by `(sourceId, runId)` so duplicate run ids do not collide. Phoenix is the recommended trace viewer when an `observability.exporters` (phoenix) entry is configured; local JSONL artifacts are the fallback otherwise.
 
 ## Evaluation Join