@mono-agent/agent-app 0.3.0 → 0.4.1

package/README.md

@@ -2,8 +2,8 @@
 
 Config-first mono-agent host. Reads one `mono-agent.config.json` in a folder,
 builds the configured responder, and starts every configured communication
-channel plus the local operator console and traceability. Ships the
-`mono-agent` CLI (`init`, `validate`, `start`) so an agent folder works without
+channel plus traceability. Ships the
+`mono-agent` CLI (`init`, `validate`, `memory`, `start`) so an agent folder works without
 hand-written composition code.
 
 ## Category
@@ -15,13 +15,21 @@ Category: `app`
 Turn a folder's `mono-agent.config.json` into a running agent host:
 
 - Aggregate the adapter-neutral core config and every channel section
-  (`telegram`, `slack`, `a2a`, `webhook`, `openaiApi`, `cron`, `whatsapp`).
-- Build the shared runtime/responder through `@mono-agent/agent-host`
+  (`telegram`, `slack`, `webhook`, `openaiApi`, `cron`) plus configured
+  external channel plugins from `channels.plugins[]`.
+- Build the shared runtime/responder/memory stack through app-owned configured
+  composition
   (including `runtime.fallbackModels` backup chains).
 - Drive each channel through a uniform driver contract with per-channel
   `disabled` / `waiting_for_config` / `running` / `failed` status.
-- Start the operator console first and re-apply config writes in-process.
-- Register the host as a traceability source.
+- Register the host as a traceability source. Config edits are made directly in
+  `mono-agent.config.json` and take effect on the next `mono-agent restart`.
+- Resolve and surface any configured `observability.exporters` (the Phoenix
+  preset): `start`/`status` report the configured endpoint and a note that JSONL
+  artifacts remain local; `validate` performs the live reachability probe. Export
+  is best-effort and never changes a run outcome.
+- Preview the configured memory backend from the same config/env resolution path
+  via `mono-agent memory` (`stats`, `today`, `show`, `search`, `top`).
 - Scaffold (`mono-agent init`) and validate (`mono-agent validate`) agent
   folders non-destructively.
 
@@ -44,7 +52,7 @@ Programmatic:
 import { startMonoAgentApp } from "@mono-agent/agent-app";
 
 const app = await startMonoAgentApp({ cwd: "/path/to/agent-folder" });
-console.log(app.operatorConsole?.appUrl, app.channelStatuses());
+console.log(app.channelStatuses());
 await app.stop();
 ```
 
@@ -52,11 +60,16 @@ await app.stop();
 
 - `startMonoAgentApp(options)` → `MonoAgentApp` (statuses, `applyConfigChange`,
   `startChannelIfConfigured`, `stop`).
-- `defaultChannelDrivers(overrides)` plus per-channel
+- `defaultChannelDrivers(overrides)` plus built-in per-channel
   `create<Channel>ChannelDriver(overrides)` factories with test seams.
+- `createConfiguredAgentRuntime`, `createConfiguredAgentHarness`,
+  `createConfiguredAgentResponder`, and `createConfiguredMemory` for
+  transport-free programmatic composition from a loaded `MonoAgentConfig`.
+- `createBroadcastRunRecorder` for publishing recorder lifecycle events to a
+  live run-event sink.
 - `initMonoAgentFolder(options)` / `validateMonoAgentFolder(options)`.
 - `MONO_AGENT_APP_FIELD_GROUPS` and the `resolveApp*` traceability/artifact
-  resolvers for operator-console wiring.
+  resolvers.
 - `runCli(argv)` / `parseCliArgs(argv)` backing the `mono-agent` bin.
 
 ## Dependency Boundary
@@ -70,7 +83,8 @@ compose communication adapters; adapters never depend on it.
 - Adapter transports, credentials, or allowlists (owned by each
   `*-adapter` package).
 - Core config schema and loading (owned by `@mono-agent/config`).
-- Harness/runtime composition internals (owned by `@mono-agent/agent-host`).
+- Low-level prompt/session/tool execution internals (owned by
+  `@mono-agent/agent-harness` and `@mono-agent/runtime-adapter`).
 - Multi-agent orchestration (owned by `@mono-agent/agent-orchestrator`).
 
 ## Verification

package/dist/adapter-send-tools-main.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=adapter-send-tools-main.d.ts.map

package/dist/adapter-send-tools-main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-send-tools-main.d.ts","sourceRoot":"","sources":["../src/adapter-send-tools-main.ts"],"names":[],"mappings":""}

package/dist/adapter-send-tools-main.js

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { adapterSendToolsChildConfigFromEnv, createAdapterSendToolsClients, createAdapterSendToolsServer, resolveAdapterSendToolsSettings, } from "./adapter-send-tools.js";
+async function main() {
+    const childConfig = adapterSendToolsChildConfigFromEnv(process.env, process.cwd());
+    const settings = await resolveAdapterSendToolsSettings(childConfig.input, {
+        allowedTools: childConfig.allowedTools,
+    });
+    if (settings === undefined) {
+        throw new Error("no adapter send tools configured.");
+    }
+    const clients = await createAdapterSendToolsClients(settings);
+    const server = await createAdapterSendToolsServer(settings, clients, childConfig.indexing);
+    await server.connect(new StdioServerTransport());
+}
+main().catch((error) => {
+    process.stderr.write(`mono-agent-adapter-send-tools: fatal: ${error instanceof Error ? error.message : String(error)}\n`);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=adapter-send-tools-main.js.map

package/dist/adapter-send-tools-main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-send-tools-main.js","sourceRoot":"","sources":["../src/adapter-send-tools-main.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EACL,kCAAkC,EAClC,6BAA6B,EAC7B,4BAA4B,EAC5B,+BAA+B,GAChC,MAAM,yBAAyB,CAAC;AAEjC,KAAK,UAAU,IAAI;IACjB,MAAM,WAAW,GAAG,kCAAkC,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACnF,MAAM,QAAQ,GAAG,MAAM,+BAA+B,CAAC,WAAW,CAAC,KAAK,EAAE;QACxE,YAAY,EAAE,WAAW,CAAC,YAAY;KACvC,CAAC,CAAC;IACH,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACvD,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,6BAA6B,CAAC,QAAQ,CAAC,CAAC;IAC9D,MAAM,MAAM,GAAG,MAAM,4BAA4B,CAAC,QAAQ,EAAE,OAAO,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC3F,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC;AACnD,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC9B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,yCAAyC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1H,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}

package/dist/adapter-send-tools.d.ts

@@ -0,0 +1,125 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { SlackWebApi } from "@mono-agent/slack-adapter";
+import type { TelegramMessageSender } from "@mono-agent/telegram-adapter";
+import type { MonoAgentAppConfigInput } from "./app-config.js";
+/**
+ * Model-visible send tools for explicitly allowed, already-enabled communication adapters.
+ *
+ * This mirrors `memory_recall`: agent-app injects a stdio MCP server through
+ * per-request runtime options. The adapter config remains the source of truth:
+ * if Slack or Telegram is disabled, invalid, blocked by tool policy, or lacks an
+ * allowed destination policy, the corresponding send tool is not exposed. When
+ * exposed, each tool enforces the same adapter allowlist before calling the
+ * adapter-owned sender.
+ */
+export declare const ADAPTER_SEND_TOOLS_MCP_SERVER_NAME = "mono-agent-adapter-send";
+export interface SlackSendToolSettings {
+    readonly botToken: string;
+    readonly allowedChannelIds: readonly string[];
+    readonly allowAllChannels: boolean;
+}
+export interface TelegramSendToolSettings {
+    readonly botToken: string;
+    readonly allowedChatIds: readonly string[];
+    readonly allowAllChats: boolean;
+    /** Self-hosted Bot API server base URL (also unlocks file:// path uploads). */
+    readonly apiRoot?: string;
+    /** Upload cap for send_document/send_photo; the resolver fills the 20 MiB default. */
+    readonly maxUploadBytes?: number;
+    /** Which telegram tools the policy permits (the adapter config gates the rest). */
+    readonly tools: {
+        readonly send: boolean;
+        readonly ask: boolean;
+        readonly document: boolean;
+        readonly photo: boolean;
+    };
+}
+/**
+ * Blocking ask-the-user tool, backed by the app's interaction bridge. Channel
+ * agnostic: the tool only talks to the bridge; the bridge posts the question
+ * through whichever channel sink owns the conversation. `conversationId` is
+ * present only in the spawned child (from the per-request env) — without it the
+ * tool has no target and is not registered.
+ */
+export interface AskUserToolSettings {
+    readonly bridgeUrl: string;
+    readonly bridgeToken: string;
+    readonly timeoutMs: number;
+    readonly conversationId?: string;
+}
+export interface AdapterSendToolsSettings {
+    readonly slack?: SlackSendToolSettings;
+    readonly telegram?: TelegramSendToolSettings;
+    readonly askUser?: AskUserToolSettings;
+}
+export interface AdapterSendToolsClients {
+    readonly slack?: Pick<SlackWebApi, "chatPostMessage">;
+    readonly telegram?: Pick<TelegramMessageSender, "sendMessage" | "sendDocument" | "sendPhoto">;
+}
+export interface AdapterSendToolsRuntimeExtension {
+    readonly runtimeOptions: {
+        readonly mcpServers: Record<string, unknown>;
+    };
+    readonly cleanup: () => Promise<void>;
+}
+/**
+ * Where a posted message should be linked back to its producing conversation.
+ * Forwarded to the stdio child so `slack_send_message` can record
+ * `(channel, ts) → conversationId` — see {@link appendPostedMessage}.
+ */
+export interface AdapterSendToolsIndexing {
+    readonly conversationId: string;
+    readonly indexPath: string;
+}
+/** Minimal shape of the per-request runtime-options input we read (the producing conversationId). */
+interface AdapterSendToolsRequestInput {
+    readonly request?: {
+        readonly conversationId?: string;
+    };
+}
+export interface AdapterSendToolsResolveOptions {
+    readonly allowedTools?: readonly string[] | undefined;
+    readonly disallowedTools?: readonly string[] | undefined;
+    readonly logger?: {
+        warn?: (message: string, metadata?: Record<string, unknown>) => void;
+    } | undefined;
+}
+export declare function resolveAdapterSendToolsSettings(input: MonoAgentAppConfigInput, options?: AdapterSendToolsResolveOptions): Promise<AdapterSendToolsSettings | undefined>;
+export declare function adapterSendToolNames(settings: AdapterSendToolsSettings): readonly string[];
+/**
+ * Public re-export of the per-tool allow check so callers (e.g. the Telegram
+ * channel driver) can gate behavior on whether a specific adapter send tool is
+ * permitted by `tools.allowedTools`/`disallowedTools`, matching this module's policy.
+ */
+export declare function isAdapterSendToolAllowed(name: string, policy: {
+    readonly allowedTools?: readonly string[];
+    readonly disallowedTools?: readonly string[];
+}): boolean;
+/**
+ * Per-request context forwarded to the stdio child. `conversationId` alone
+ * targets ask_user at the producing conversation; `indexPath` additionally
+ * enables the posted-message index (Slack reply continuity).
+ */
+export interface AdapterSendToolsChildContext {
+    readonly conversationId?: string;
+    readonly indexPath?: string;
+}
+export declare function adapterSendToolsMcpEnv(configPath: string, allowedTools: readonly string[], context?: AdapterSendToolsChildContext): Record<string, string>;
+export interface AdapterSendToolsChildConfig {
+    readonly input: MonoAgentAppConfigInput;
+    readonly allowedTools: readonly string[];
+    readonly indexing?: AdapterSendToolsIndexing;
+}
+export declare function adapterSendToolsChildConfigFromEnv(env: Record<string, string | undefined>, cwd: string): AdapterSendToolsChildConfig;
+export declare function adapterSendToolsMcpServerSpec(configPath: string, cwd: string, allowedTools: readonly string[], context?: AdapterSendToolsChildContext): Record<string, unknown>;
+/**
+ * Per-request runtime extension that injects the adapter-send stdio MCP server. It
+ * reads the request's producing conversationId and, when an `indexPath` is
+ * configured, forwards both to the child so a `slack_send_message` post is linked
+ * back to this conversation (so a later in-thread reply resumes it).
+ */
+export declare function createAdapterSendToolsRuntimeExtension(configPath: string, cwd: string, allowedTools: readonly string[], indexPath?: string): (input: AdapterSendToolsRequestInput) => Promise<AdapterSendToolsRuntimeExtension>;
+export declare function createAdapterSendToolsClients(settings: AdapterSendToolsSettings): Promise<AdapterSendToolsClients>;
+export declare function createAdapterSendToolsServer(settings: AdapterSendToolsSettings, clients: AdapterSendToolsClients, indexing?: AdapterSendToolsIndexing): Promise<McpServer>;
+export {};
+//# sourceMappingURL=adapter-send-tools.d.ts.map

package/dist/adapter-send-tools.d.ts.map

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