@mono-agent/agent-app 0.1.0

package/README.md

@@ -0,0 +1,85 @@
+# @mono-agent/agent-app
+
+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
+hand-written composition code.
+
+## Category
+
+Category: `app`
+
+## Responsibility
+
+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`
+  (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.
+- Scaffold (`mono-agent init`) and validate (`mono-agent validate`) agent
+  folders non-destructively.
+
+## Install / Usage
+
+```bash
+# inside the workspace
+pnpm --filter @mono-agent/agent-app run build
+
+# scaffold and run an agent folder
+cd /path/to/agent-folder
+node <workspace>/packages/agent-app/dist/cli.js init --model claude:claude-sonnet-4-6
+node <workspace>/packages/agent-app/dist/cli.js validate
+node <workspace>/packages/agent-app/dist/cli.js start
+```
+
+Programmatic:
+
+```ts
+import { startMonoAgentApp } from "@mono-agent/agent-app";
+
+const app = await startMonoAgentApp({ cwd: "/path/to/agent-folder" });
+console.log(app.operatorConsole?.appUrl, app.channelStatuses());
+await app.stop();
+```
+
+## Public API
+
+- `startMonoAgentApp(options)` → `MonoAgentApp` (statuses, `applyConfigChange`,
+  `startChannelIfConfigured`, `stop`).
+- `defaultChannelDrivers(overrides)` plus per-channel
+  `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.
+- `runCli(argv)` / `parseCliArgs(argv)` backing the `mono-agent` bin.
+
+## Dependency Boundary
+
+Depends on `core`, `runtime`, `execution`, `observability`, `communication`,
+and `operator-surface` packages. It is the only publishable package allowed to
+compose communication adapters; adapters never depend on it.
+
+## What This Package Does Not Own
+
+- 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`).
+- Multi-agent orchestration (owned by `@mono-agent/agent-orchestrator`).
+
+## Verification
+
+```bash
+pnpm --filter @mono-agent/agent-app run typecheck
+pnpm --filter @mono-agent/agent-app run test
+pnpm run check:architecture
+```
+
+Smoke path: `mono-agent init` in a temp folder, `mono-agent validate`, then
+`mono-agent start` and a `curl` POST against the printed webhook invoke URL.

package/dist/app-config.d.ts

@@ -0,0 +1,36 @@
+import { MonoAgentConfigError } from "@mono-agent/config";
+import type { MonoAgentConfig } from "@mono-agent/config";
+import type { FieldGroup } from "@mono-agent/settings";
+/**
+ * Every settings group a config-first host edits through the operator console:
+ * the adapter-neutral core config plus one group per communication channel.
+ */
+export declare const MONO_AGENT_APP_FIELD_GROUPS: readonly FieldGroup[];
+export interface MonoAgentAppConfigInput {
+    readonly env: Record<string, string | undefined>;
+    readonly cwd: string;
+    readonly configPath: string;
+}
+export declare function loadAppCoreConfig(input: MonoAgentAppConfigInput): Promise<MonoAgentConfig>;
+export declare function isAppCoreConfigError(error: unknown): error is MonoAgentConfigError;
+/**
+ * Trace defaults a host can override without touching the user's config file
+ * (e.g. the final demo labels its source "Final Agent Demo").
+ */
+export interface AppTraceDefaults {
+    readonly sourceIdPrefix?: string;
+    readonly sourceLabel?: string;
+}
+/**
+ * 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.
+ */
+export declare function resolveAppArtifactDir(input: MonoAgentAppConfigInput): Promise<string>;
+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>;
+export declare function resolveAppTraceHeartbeatMs(input: MonoAgentAppConfigInput): Promise<number>;
+export declare function resolveAppTraceStaleAfterMs(input: MonoAgentAppConfigInput): Promise<number>;
+//# sourceMappingURL=app-config.d.ts.map

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

@@ -0,0 +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;AAC1D,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,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"}

package/dist/app-config.js

@@ -0,0 +1,164 @@
+import { createHash } from "node:crypto";
+import { homedir } from "node:os";
+import { resolve } from "node:path";
+import { CORE_AGENT_FIELD_GROUPS, loadMonoAgentConfigWithSources, MonoAgentConfigError, readMonoAgentConfigJson, } from "@mono-agent/config";
+import { a2aFieldGroup } from "@mono-agent/a2a-adapter";
+import { cronFieldGroup } from "@mono-agent/cron-adapter";
+import { openAIApiFieldGroup } from "@mono-agent/openai-api-adapter";
+import { slackFieldGroup } from "@mono-agent/slack-adapter";
+import { telegramFieldGroup } from "@mono-agent/telegram-adapter";
+import { webhookFieldGroup } from "@mono-agent/webhook-adapter";
+import { whatsappFieldGroup } from "@mono-agent/whatsapp-adapter";
+/**
+ * Every settings group a config-first host edits through the operator console:
+ * the adapter-neutral core config plus one group per communication channel.
+ */
+export const MONO_AGENT_APP_FIELD_GROUPS = [
+    ...CORE_AGENT_FIELD_GROUPS,
+    telegramFieldGroup,
+    slackFieldGroup,
+    a2aFieldGroup,
+    webhookFieldGroup,
+    openAIApiFieldGroup,
+    cronFieldGroup,
+    whatsappFieldGroup,
+];
+export async function loadAppCoreConfig(input) {
+    return await loadMonoAgentConfigWithSources({
+        env: input.env,
+        cwd: input.cwd,
+        jsonPath: input.configPath,
+    });
+}
+export function isAppCoreConfigError(error) {
+    return error instanceof MonoAgentConfigError;
+}
+const DEFAULT_TRACE_HEARTBEAT_MS = 10_000;
+const DEFAULT_TRACE_STALE_AFTER_MS = 30_000;
+const DEFAULT_TRACE_SOURCE_ID_PREFIX = "mono-agent";
+const DEFAULT_TRACE_SOURCE_LABEL = "Mono Agent";
+/**
+ * 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.
+ */
+export async function resolveAppArtifactDir(input) {
+    const envDir = input.env.MONO_AGENT_ARTIFACT_DIR?.trim();
+    if (envDir !== undefined && envDir.length > 0) {
+        return resolve(input.cwd, envDir);
+    }
+    try {
+        const { json } = await readMonoAgentConfigJson(input.configPath);
+        const configDir = typeof json.artifacts?.dir === "string" ? json.artifacts.dir.trim() : "";
+        if (configDir.length > 0) {
+            return resolve(input.cwd, configDir);
+        }
+    }
+    catch {
+        // Fall through to the default below.
+    }
+    return resolve(input.cwd, ".mono-agent", "artifacts");
+}
+export async function resolveAppTraceRegistryDir(input) {
+    const envDir = input.env.MONO_AGENT_TRACE_REGISTRY_DIR?.trim();
+    if (envDir !== undefined && envDir.length > 0) {
+        return resolve(input.cwd, envDir);
+    }
+    try {
+        const { json } = await readMonoAgentConfigJson(input.configPath);
+        const registryDir = typeof json.traceability?.registryDir === "string" ? json.traceability.registryDir.trim() : "";
+        if (registryDir.length > 0) {
+            return resolve(input.cwd, registryDir);
+        }
+    }
+    catch {
+        // Fall through to the default below.
+    }
+    return resolve(homedir(), ".mono-agent", "trace-sources");
+}
+export async function resolveAppTraceSourceId(input, defaults) {
+    const envSourceId = input.env.MONO_AGENT_TRACE_SOURCE_ID?.trim();
+    if (envSourceId !== undefined && envSourceId.length > 0) {
+        return envSourceId;
+    }
+    try {
+        const { json } = await readMonoAgentConfigJson(input.configPath);
+        const sourceId = typeof json.traceability?.sourceId === "string" ? json.traceability.sourceId.trim() : "";
+        if (sourceId.length > 0) {
+            return sourceId;
+        }
+    }
+    catch {
+        // Use the deterministic cwd/config fallback below.
+    }
+    const hash = createHash("sha256")
+        .update(resolve(input.cwd))
+        .update("\0")
+        .update(resolve(input.configPath))
+        .digest("hex")
+        .slice(0, 12);
+    return `${defaults?.sourceIdPrefix ?? DEFAULT_TRACE_SOURCE_ID_PREFIX}-${hash}`;
+}
+export async function resolveAppTraceSourceLabel(input, defaults) {
+    const envLabel = input.env.MONO_AGENT_TRACE_SOURCE_LABEL?.trim();
+    if (envLabel !== undefined && envLabel.length > 0) {
+        return envLabel;
+    }
+    try {
+        const { json } = await readMonoAgentConfigJson(input.configPath);
+        const label = typeof json.traceability?.sourceLabel === "string" ? json.traceability.sourceLabel.trim() : "";
+        if (label.length > 0) {
+            return label;
+        }
+    }
+    catch {
+        // Keep the default label below.
+    }
+    return defaults?.sourceLabel ?? DEFAULT_TRACE_SOURCE_LABEL;
+}
+export async function resolveAppTraceHeartbeatMs(input) {
+    return await resolveTraceInteger({
+        input,
+        envName: "MONO_AGENT_TRACE_HEARTBEAT_MS",
+        jsonKey: "heartbeatMs",
+        defaultValue: DEFAULT_TRACE_HEARTBEAT_MS,
+        min: 250,
+        max: 86_400_000,
+    });
+}
+export async function resolveAppTraceStaleAfterMs(input) {
+    return await resolveTraceInteger({
+        input,
+        envName: "MONO_AGENT_TRACE_STALE_AFTER_MS",
+        jsonKey: "staleAfterMs",
+        defaultValue: DEFAULT_TRACE_STALE_AFTER_MS,
+        min: 1_000,
+        max: 604_800_000,
+    });
+}
+async function resolveTraceInteger(options) {
+    const envValue = options.input.env[options.envName]?.trim();
+    if (envValue !== undefined && envValue.length > 0) {
+        return parseTraceInteger(envValue, options.envName, options.min, options.max);
+    }
+    try {
+        const { json } = await readMonoAgentConfigJson(options.input.configPath);
+        const value = json.traceability?.[options.jsonKey];
+        if (value !== undefined) {
+            return parseTraceInteger(value, `traceability.${options.jsonKey}`, options.min, options.max);
+        }
+    }
+    catch {
+        // Use the default while the user fixes an incomplete or invalid config.
+    }
+    return options.defaultValue;
+}
+function parseTraceInteger(value, name, min, max) {
+    const parsed = typeof value === "number" ? value : Number(value);
+    if (!Number.isInteger(parsed) || parsed < min || parsed > max) {
+        throw new MonoAgentConfigError("invalid_env", `${name} must be an integer between ${min} and ${max}.`, { env: name, reason: "integer_range" });
+    }
+    return parsed;
+}
+//# sourceMappingURL=app-config.js.map

package/dist/app-config.js.map

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

package/dist/app.d.ts

@@ -0,0 +1,60 @@
+import type { ConfigApplyResult, OperatorConsoleOptions, OperatorConsoleStartResult } from "@mono-agent/operator-console";
+import type { MonoRuntimeLike } from "@mono-agent/runtime-adapter";
+import type { FieldGroup } from "@mono-agent/settings";
+import type { AppTraceDefaults } from "./app-config.js";
+import type { ChannelDriver, ChannelId, ChannelStatus, MonoAgentAppLogger } from "./channels.js";
+export interface MonoAgentAppOptions {
+    readonly env?: Record<string, string | undefined>;
+    readonly cwd?: string;
+    /** Path to mono-agent.config.json; defaults to <cwd>/mono-agent.config.json. */
+    readonly configPath?: string;
+    readonly logger?: MonoAgentAppLogger;
+    /** Channel drivers to run. Defaults to every built-in channel. */
+    readonly drivers?: readonly ChannelDriver[];
+    /** Shared runtime override (testing / advanced composition). */
+    readonly runtime?: MonoRuntimeLike;
+    /** Set false to run headless without the local operator console. */
+    readonly operatorConsole?: boolean;
+    readonly operatorConsolePort?: number;
+    readonly operatorConsoleFactory?: (options: OperatorConsoleOptions) => Promise<OperatorConsoleStartResult>;
+    readonly fieldGroups?: readonly FieldGroup[];
+    readonly traceDefaults?: AppTraceDefaults;
+}
+export interface MonoAgentAppOperatorConsole {
+    /** Base loopback URL for API calls, without the token query string. */
+    readonly url: string;
+    /** Browser URL that includes the per-boot operator console token. */
+    readonly appUrl: string;
+    readonly token: string;
+    readonly configPath: string;
+}
+export type TraceabilityStatus = {
+    readonly kind: "running";
+    readonly sourceId: string;
+    readonly registryDir: string;
+    readonly artifactDir: string;
+} | {
+    readonly kind: "disabled";
+    readonly reason: string;
+} | {
+    readonly kind: "failed";
+    readonly reason: string;
+};
+export interface MonoAgentApp {
+    readonly operatorConsole: MonoAgentAppOperatorConsole | undefined;
+    readonly configPath: string;
+    readonly traceabilityStatus: TraceabilityStatus;
+    channelStatus(id: ChannelId): ChannelStatus;
+    channelStatuses(): ReadonlyMap<ChannelId, ChannelStatus>;
+    startChannelIfConfigured(id: ChannelId, reason: string): Promise<ChannelStatus>;
+    applyConfigChange(reason: string): Promise<ConfigApplyResult>;
+    stop(): Promise<void>;
+}
+/**
+ * Starts a config-first mono-agent host in `cwd`: operator console first (so
+ * an incomplete config can be fixed in the browser), then traceability, then
+ * every configured channel in parallel. Channels with incomplete config report
+ * `waiting_for_config` instead of blocking the rest.
+ */
+export declare function startMonoAgentApp(options?: MonoAgentAppOptions): Promise<MonoAgentApp>;
+//# sourceMappingURL=app.d.ts.map

package/dist/app.d.ts.map

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