@mono-agent/agent-app 0.2.2 → 0.4.0

package/README.md

@@ -2,7 +2,7 @@
 
 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
+channel plus traceability. Ships the
 `mono-agent` CLI (`init`, `validate`, `start`) so an agent folder works without
 hand-written composition code.
 
@@ -20,8 +20,12 @@ Turn a folder's `mono-agent.config.json` into a running agent host:
   (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.
 - Scaffold (`mono-agent init`) and validate (`mono-agent validate`) agent
   folders non-destructively.
 
@@ -44,7 +48,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();
 ```
 
@@ -56,7 +60,7 @@ await app.stop();
   `create<Channel>ChannelDriver(overrides)` factories with test seams.
 - `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

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 = createAdapterSendToolsClients(settings);
+    const server = createAdapterSendToolsServer(settings, clients);
+    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,6BAA6B,CAAC,QAAQ,CAAC,CAAC;IACxD,MAAM,MAAM,GAAG,4BAA4B,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC/D,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,59 @@
+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;
+}
+export interface AdapterSendToolsSettings {
+    readonly slack?: SlackSendToolSettings;
+    readonly telegram?: TelegramSendToolSettings;
+}
+export interface AdapterSendToolsClients {
+    readonly slack?: Pick<SlackWebApi, "chatPostMessage">;
+    readonly telegram?: Pick<TelegramMessageSender, "sendMessage">;
+}
+export interface AdapterSendToolsRuntimeExtension {
+    readonly runtimeOptions: {
+        readonly mcpServers: Record<string, unknown>;
+    };
+    readonly cleanup: () => Promise<void>;
+}
+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[];
+export declare function adapterSendToolsMcpEnv(configPath: string, allowedTools: readonly string[]): Record<string, string>;
+export interface AdapterSendToolsChildConfig {
+    readonly input: MonoAgentAppConfigInput;
+    readonly allowedTools: readonly string[];
+}
+export declare function adapterSendToolsChildConfigFromEnv(env: Record<string, string | undefined>, cwd: string): AdapterSendToolsChildConfig;
+export declare function adapterSendToolsMcpServerSpec(configPath: string, cwd: string, allowedTools: readonly string[]): Record<string, unknown>;
+export declare function createAdapterSendToolsRuntimeExtension(configPath: string, cwd: string, allowedTools: readonly string[]): () => Promise<AdapterSendToolsRuntimeExtension>;
+export declare function createAdapterSendToolsClients(settings: AdapterSendToolsSettings): AdapterSendToolsClients;
+export declare function createAdapterSendToolsServer(settings: AdapterSendToolsSettings, clients: AdapterSendToolsClients): McpServer;
+//# 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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"}

package/dist/adapter-send-tools.js

@@ -0,0 +1,254 @@
+import process from "node:process";
+import { fileURLToPath } from "node:url";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { SlackWebApiClient, loadSlackAdapterConfig, } from "@mono-agent/slack-adapter";
+import { createTelegramMessageSender, loadTelegramAdapterConfig, } from "@mono-agent/telegram-adapter";
+import * as z from "zod/v4";
+/**
+ * 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 const ADAPTER_SEND_TOOLS_MCP_SERVER_NAME = "mono-agent-adapter-send";
+export async function resolveAdapterSendToolsSettings(input, options = {}) {
+    const [slack, telegram] = await Promise.all([
+        isAdapterToolAllowed("slack_send_message", options)
+            ? resolveSlackSendToolSettings(input, options)
+            : undefined,
+        isAdapterToolAllowed("telegram_send_message", options)
+            ? resolveTelegramSendToolSettings(input, options)
+            : undefined,
+    ]);
+    if (slack === undefined && telegram === undefined) {
+        return undefined;
+    }
+    return {
+        ...(slack === undefined ? {} : { slack }),
+        ...(telegram === undefined ? {} : { telegram }),
+    };
+}
+export function adapterSendToolNames(settings) {
+    const names = [];
+    if (settings.slack !== undefined) {
+        names.push("slack_send_message");
+    }
+    if (settings.telegram !== undefined) {
+        names.push("telegram_send_message");
+    }
+    return names;
+}
+export function adapterSendToolsMcpEnv(configPath, allowedTools) {
+    return {
+        MONO_AGENT_ADAPTER_TOOLS_CONFIG_PATH: configPath,
+        MONO_AGENT_ADAPTER_TOOLS_ALLOWED_TOOLS: JSON.stringify(allowedTools),
+    };
+}
+export function adapterSendToolsChildConfigFromEnv(env, cwd) {
+    const configPath = optionalString(env.MONO_AGENT_ADAPTER_TOOLS_CONFIG_PATH);
+    if (configPath === undefined) {
+        throw new Error("adapter-send-tools: missing required environment (MONO_AGENT_ADAPTER_TOOLS_CONFIG_PATH).");
+    }
+    return {
+        input: { env, cwd, configPath },
+        allowedTools: parseAllowedToolNames(env.MONO_AGENT_ADAPTER_TOOLS_ALLOWED_TOOLS),
+    };
+}
+export function adapterSendToolsMcpServerSpec(configPath, cwd, allowedTools) {
+    return {
+        type: "stdio",
+        command: process.execPath,
+        args: [fileURLToPath(new URL("./adapter-send-tools-main.js", import.meta.url))],
+        cwd,
+        env: adapterSendToolsMcpEnv(configPath, allowedTools),
+    };
+}
+export function createAdapterSendToolsRuntimeExtension(configPath, cwd, allowedTools) {
+    return async () => ({
+        runtimeOptions: {
+            mcpServers: {
+                [ADAPTER_SEND_TOOLS_MCP_SERVER_NAME]: adapterSendToolsMcpServerSpec(configPath, cwd, allowedTools),
+            },
+        },
+        cleanup: async () => { },
+    });
+}
+export function createAdapterSendToolsClients(settings) {
+    return {
+        ...(settings.slack === undefined
+            ? {}
+            : {
+                slack: new SlackWebApiClient({
+                    botToken: settings.slack.botToken,
+                }),
+            }),
+        ...(settings.telegram === undefined
+            ? {}
+            : {
+                telegram: createTelegramMessageSender(settings.telegram.botToken),
+            }),
+    };
+}
+export function createAdapterSendToolsServer(settings, clients) {
+    const server = new McpServer({ name: "agent-adapter-send-tools", version: "0.3.0" });
+    if (settings.slack !== undefined && clients.slack !== undefined) {
+        registerSlackSendTool(server, settings.slack, clients.slack);
+    }
+    if (settings.telegram !== undefined && clients.telegram !== undefined) {
+        registerTelegramSendTool(server, settings.telegram, clients.telegram);
+    }
+    return server;
+}
+function registerSlackSendTool(server, settings, client) {
+    server.registerTool("slack_send_message", {
+        title: "Send Slack message",
+        description: "Send a message to an allowed Slack channel or DM ID using the configured Slack adapter bot token.",
+        inputSchema: {
+            channel: z.string().min(1).describe("Slack channel or DM ID, e.g. C123456 or D123456."),
+            text: z.string().min(1).describe("Message text to send."),
+            thread_ts: z.string().min(1).optional().describe("Optional Slack thread timestamp to reply in."),
+            mrkdwn: z.boolean().optional().describe("Whether Slack mrkdwn formatting is enabled."),
+            unfurl_links: z.boolean().optional().describe("Whether Slack should unfurl links."),
+            unfurl_media: z.boolean().optional().describe("Whether Slack should unfurl media."),
+        },
+    }, async (args) => {
+        assertSlackChannelAllowed(settings, args.channel);
+        const result = await client.chatPostMessage({
+            channel: args.channel.trim(),
+            text: args.text,
+            ...(args.thread_ts === undefined ? {} : { thread_ts: args.thread_ts }),
+            ...(args.mrkdwn === undefined ? {} : { mrkdwn: args.mrkdwn }),
+            ...(args.unfurl_links === undefined ? {} : { unfurl_links: args.unfurl_links }),
+            ...(args.unfurl_media === undefined ? {} : { unfurl_media: args.unfurl_media }),
+        });
+        return {
+            content: [{ type: "text", text: `Sent Slack message to ${result.channel} at ${result.ts}.` }],
+            structuredContent: { ok: true, channel: result.channel, ts: result.ts },
+        };
+    });
+}
+function registerTelegramSendTool(server, settings, client) {
+    server.registerTool("telegram_send_message", {
+        title: "Send Telegram message",
+        description: "Send a message to an allowed Telegram chat using the configured Telegram adapter bot token.",
+        inputSchema: {
+            chat_id: z.union([z.string().min(1), z.number().int()]).describe("Telegram chat id from the adapter allowlist."),
+            text: z.string().min(1).describe("Message text to send."),
+            parse_mode: z.string().min(1).optional().describe("Optional Telegram parse mode, e.g. MarkdownV2 or HTML."),
+            reply_to_message_id: z.number().int().optional().describe("Optional message id to reply to."),
+            disable_web_page_preview: z.boolean().optional().describe("Disable Telegram link previews."),
+        },
+    }, async (args) => {
+        assertTelegramChatAllowed(settings, args.chat_id);
+        const result = await client.sendMessage({
+            chat_id: args.chat_id,
+            text: args.text,
+            ...(args.parse_mode === undefined ? {} : { parse_mode: args.parse_mode }),
+            ...(args.reply_to_message_id === undefined ? {} : { reply_to_message_id: args.reply_to_message_id }),
+            ...(args.disable_web_page_preview === undefined ? {} : { disable_web_page_preview: args.disable_web_page_preview }),
+        });
+        return {
+            content: [{ type: "text", text: `Sent Telegram message ${result.message_id} to ${String(result.chat.id)}.` }],
+            structuredContent: { ok: true, chat_id: result.chat.id, message_id: result.message_id },
+        };
+    });
+}
+async function resolveSlackSendToolSettings(input, options) {
+    try {
+        const config = await loadSlackAdapterConfig({ env: input.env, jsonPath: input.configPath });
+        if (!config.enabled) {
+            return undefined;
+        }
+        return {
+            botToken: config.botToken,
+            allowedChannelIds: config.allowedChannelIds.map(normalizeSlackChannelId),
+            allowAllChannels: config.allowAllChannels,
+        };
+    }
+    catch (error) {
+        options.logger?.warn?.("Slack send tool skipped because Slack adapter config is unavailable.", {
+            reason: reasonOf(error),
+        });
+        return undefined;
+    }
+}
+async function resolveTelegramSendToolSettings(input, options) {
+    try {
+        const config = await loadTelegramAdapterConfig({ env: input.env, jsonPath: input.configPath });
+        if (!config.enabled) {
+            return undefined;
+        }
+        return {
+            botToken: config.botToken,
+            allowedChatIds: config.allowedChatIds,
+            allowAllChats: config.allowAllChats,
+        };
+    }
+    catch (error) {
+        options.logger?.warn?.("Telegram send tool skipped because Telegram adapter config is unavailable.", {
+            reason: reasonOf(error),
+        });
+        return undefined;
+    }
+}
+function assertSlackChannelAllowed(settings, channel) {
+    if (settings.allowAllChannels || settings.allowedChannelIds.includes(normalizeSlackChannelId(channel))) {
+        return;
+    }
+    throw new Error("slack_send_message: channel is not allowed by Slack adapter config.");
+}
+function assertTelegramChatAllowed(settings, chatId) {
+    const normalized = String(chatId);
+    if (settings.allowAllChats || settings.allowedChatIds.includes(normalized)) {
+        return;
+    }
+    throw new Error("telegram_send_message: chat_id is not allowed by Telegram adapter config.");
+}
+function optionalString(value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    const trimmed = value.trim();
+    return trimmed.length === 0 ? undefined : trimmed;
+}
+function normalizeSlackChannelId(value) {
+    return value.trim().toLowerCase();
+}
+function isAdapterToolAllowed(name, options) {
+    const wildcard = `mcp__${ADAPTER_SEND_TOOLS_MCP_SERVER_NAME}__*`;
+    const aliases = [name, `mcp__${ADAPTER_SEND_TOOLS_MCP_SERVER_NAME}__${name}`];
+    const allowed = options.allowedTools ?? [];
+    const disallowed = options.disallowedTools ?? [];
+    if (disallowed.includes(wildcard) || aliases.some((alias) => disallowed.includes(alias))) {
+        return false;
+    }
+    if (aliases.some((alias) => allowed.includes(alias))) {
+        return true;
+    }
+    return allowed.includes(wildcard);
+}
+function parseAllowedToolNames(raw) {
+    const value = optionalString(raw);
+    if (value === undefined) {
+        throw new Error("adapter-send-tools: missing required environment (MONO_AGENT_ADAPTER_TOOLS_ALLOWED_TOOLS).");
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(value);
+    }
+    catch {
+        throw new Error("adapter-send-tools: invalid MONO_AGENT_ADAPTER_TOOLS_ALLOWED_TOOLS (expected a JSON string array).");
+    }
+    if (!Array.isArray(parsed) || parsed.some((item) => typeof item !== "string")) {
+        throw new Error("adapter-send-tools: invalid MONO_AGENT_ADAPTER_TOOLS_ALLOWED_TOOLS (expected a JSON string array).");
+    }
+    return parsed;
+}
+function reasonOf(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=adapter-send-tools.js.map

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

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

package/dist/app-config.d.ts

@@ -1,11 +1,9 @@
 import { MonoAgentConfigError } from "@mono-agent/config";
-import type { MonoAgentConfig } from "@mono-agent/config";
+import type { MonoAgentConfig, ObservabilityExporterConfig } from "@mono-agent/config";
 import type { FieldGroup } from "@mono-agent/settings";
-export declare const consoleFieldGroup: FieldGroup;
 /**
- * Every settings group a config-first host edits through the operator console:
- * the adapter-neutral core config, the console itself, plus one group per
- * communication channel.
+ * Every settings group a config-first host exposes: the adapter-neutral core
+ * config plus one group per communication channel.
  */
 export declare const MONO_AGENT_APP_FIELD_GROUPS: readonly FieldGroup[];
 export interface MonoAgentAppConfigInput {
@@ -25,22 +23,47 @@ export interface AppTraceDefaults {
 }
 /**
  * The resolvers below intentionally tolerate an incomplete or invalid config
- * file: observability and the operator console must stay usable while the
- * user is still fixing their config, so they fall back to defaults instead of
- * throwing on unreadable JSON.
+ * file: observability and traceability must stay usable while the user is still
+ * fixing their config, so they fall back to defaults instead of throwing on
+ * unreadable JSON.
  */
 export declare function resolveAppArtifactDir(input: MonoAgentAppConfigInput): Promise<string>;
-export interface AppConsoleSettings {
-    readonly enabled: boolean;
-    readonly port?: number;
-}
 /**
- * Operator console settings: env wins, then the `console` section of the
- * config file, then defaults (enabled, auto-selected port). Tolerates an
- * unreadable config file like the other app-level resolvers so the console
- * stays available while the user fixes their config.
+ * Resolve the durable pi-session store the runtime resumes from, the same way the
+ * runtime does: the `MONO_AGENT_PI_SESSIONS_ROOT` env override first, then
+ * `providers.piNative.piSessionsRoot` from the config file. Returns undefined when
+ * neither is set — that means sessions are kept in-memory only, so there is nothing
+ * on disk to purge. Tolerates an unreadable config like the resolvers above.
+ */
+export declare function resolveAppSessionsRoot(input: MonoAgentAppConfigInput): Promise<string | undefined>;
+/**
+ * A validated observability exporter resolved for app startup/status/validate.
+ * Mirrors {@link ObservabilityExporterConfig} but with the endpoint always
+ * resolved (defaults applied) so callers never re-derive it.
+ */
+export type ResolvedExporter = ObservabilityExporterConfig & {
+    readonly endpoint: string;
+};
+/**
+ * Resolve observability exporters for the app: env-first
+ * (`MONO_AGENT_OBSERVABILITY_EXPORTERS`, JSON array), then the
+ * `observability.exporters` block of the config file, then `[]`. Like the other
+ * app-level resolvers it tolerates an unreadable config file (returns `[]` so the
+ * host stays usable while the user fixes their config), but it DOES throw
+ * a {@link MonoAgentConfigError} for a present-but-invalid exporter shape so bad
+ * config fails clearly before startup. No reachability probe runs here —
+ * reachability is `validate`'s job (Phoenix may start after the agent).
+ */
+export declare function resolveAppObservabilityExporters(input: MonoAgentAppConfigInput): Promise<readonly ResolvedExporter[]>;
+/**
+ * Derive the Phoenix app base URL (origin) from an OTLP traces endpoint so the
+ * CLI/status can point operators at the trace UI — e.g.
+ * `http://127.0.0.1:6006/v1/traces` -> `http://127.0.0.1:6006`. Returns
+ * undefined when the endpoint is not a parseable URL. Note: Phoenix does not
+ * return a stable per-run trace URL from the OTLP ingest endpoint, so callers
+ * print only the app base URL plus run identifiers.
  */
-export declare function resolveAppConsoleSettings(input: MonoAgentAppConfigInput): Promise<AppConsoleSettings>;
+export declare function phoenixAppBaseUrl(endpoint: string): string | undefined;
 export declare function resolveAppTraceRegistryDir(input: MonoAgentAppConfigInput): Promise<string>;
 export declare function resolveAppTraceSourceId(input: MonoAgentAppConfigInput, defaults?: AppTraceDefaults): Promise<string>;
 export declare function resolveAppTraceSourceLabel(input: MonoAgentAppConfigInput, defaults?: AppTraceDefaults): Promise<string>;

package/dist/app-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app-config.d.ts","sourceRoot":"","sources":["../src/app-config.ts"],"names":[],"mappings":"AAIA,OAAO,EAGL,oBAAoB,EAErB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AASvD,eAAO,MAAM,iBAAiB,YAuB5B,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,EAAE,SAAS,UAAU,EAU5D,CAAC;AAEF,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACjD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,eAAe,CAAC,CAMhG;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,oBAAoB,CAElF;AAOD;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC,CAiB3F;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;GAKG;AACH,wBAAsB,yBAAyB,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA0B3G;AAuBD,wBAAsB,0BAA0B,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC,CAiBhG;AAED,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,uBAAuB,EAC9B,QAAQ,CAAC,EAAE,gBAAgB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAuBjB;AAED,wBAAsB,0BAA0B,CAC9C,KAAK,EAAE,uBAAuB,EAC9B,QAAQ,CAAC,EAAE,gBAAgB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAiBjB;AAED,wBAAsB,0BAA0B,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC,CAShG;AAED,wBAAsB,2BAA2B,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC,CASjG"}
+{"version":3,"file":"app-config.d.ts","sourceRoot":"","sources":["../src/app-config.ts"],"names":[],"mappings":"AAIA,OAAO,EAGL,oBAAoB,EAErB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,eAAe,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAC;AACvF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AASvD;;;GAGG;AACH,eAAO,MAAM,2BAA2B,EAAE,SAAS,UAAU,EAS5D,CAAC;AAEF,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACjD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,eAAe,CAAC,CAMhG;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,oBAAoB,CAElF;AAOD;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC,CAiB3F;AAED;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAoBxG;AAMD;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,2BAA2B,GAAG;IAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3F;;;;;;;;;GASG;AACH,wBAAsB,gCAAgC,CACpD,KAAK,EAAE,uBAAuB,GAC7B,OAAO,CAAC,SAAS,gBAAgB,EAAE,CAAC,CAkBtC;AA0FD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMtE;AAoED,wBAAsB,0BAA0B,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC,CAiBhG;AAED,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,uBAAuB,EAC9B,QAAQ,CAAC,EAAE,gBAAgB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAuBjB;AAED,wBAAsB,0BAA0B,CAC9C,KAAK,EAAE,uBAAuB,EAC9B,QAAQ,CAAC,EAAE,gBAAgB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAiBjB;AAED,wBAAsB,0BAA0B,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC,CAShG;AAED,wBAAsB,2BAA2B,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC,CASjG"}