@mono-agent/agent-app 0.3.0 → 0.4.1

package/dist/consumer-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consumer-contract.d.ts","sourceRoot":"","sources":["../src/consumer-contract.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAEtD,eAAO,MAAM,qBAAqB,oDAAqD,CAAC;AAExF,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1E,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;CACnC;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CACnD;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,SAAS,6BAA6B,EAAE,CAAC;IAC5D,QAAQ,CAAC,MAAM,EAAE,SAAS,qBAAqB,EAAE,CAAC;CACnD;AAKD,eAAO,MAAM,kCAAkC;;;;;;CAML,CAAC;AAE3C,KAAK,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAC,CAAC;AAC5E,KAAK,gBAAgB,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC;AA+EvE,wBAAsB,+BAA+B,CACnD,OAAO,EAAE,8BAA8B,GACtC,OAAO,CAAC,6BAA6B,CAAC,CAgDxC"}

package/dist/consumer-contract.js

@@ -0,0 +1,290 @@
+import { cp, mkdtemp, readdir, readFile, rm } from "node:fs/promises";
+import { readFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join, relative } from "node:path";
+import { readMonoAgentConfigJson } from "@mono-agent/config";
+import { loadAppCoreConfig } from "./app-config.js";
+import { validateMonoAgentFolder } from "./doctor.js";
+export const consumerContractNames = ["local-agent-alpha", "local-agent-beta"];
+const forbiddenFixtureSecretPattern = /(sk-|xoxb-|bot[0-9]+:|apiKey|token)/u;
+const forbiddenMcpMemoryPattern = /@mono-agent\/memory-mcp|\bmemory-mcp\b|\bmemory_note\b|\bmemory_recall\b/u;
+export const consumerContractRunSummaryStatuses = {
+    running: true,
+    succeeded: true,
+    failed: true,
+    cancelled: true,
+    interrupted: true,
+};
+const expectedContracts = {
+    "local-agent-alpha": {
+        memoryMode: "bujo",
+        allowedTools: [
+            "Read",
+            "Write",
+            "Edit",
+            "Glob",
+            "Grep",
+            "Bash",
+            "WebFetch",
+            "WebSearch",
+            "telegram_send_message",
+        ],
+        channels: {
+            telegram: "active",
+            slack: "disabled",
+            webhook: "active",
+            "openai-api": "active",
+            cron: "active",
+            // Default-ON operator surfaces: active with no `tui`/`live` section in the fixture.
+            tui: "active",
+            live: "active",
+        },
+        enabledFlags: {
+            telegram: true,
+            slack: false,
+            webhook: true,
+            "openai-api": true,
+        },
+    },
+    "local-agent-beta": {
+        memoryMode: "journal",
+        allowedTools: [
+            "Read",
+            "Write",
+            "Edit",
+            "Glob",
+            "Grep",
+            "Bash",
+            "WebFetch",
+            "WebSearch",
+            "slack_send_message",
+            "memory_recall",
+        ],
+        channels: {
+            telegram: "disabled",
+            slack: "active",
+            webhook: "disabled",
+            "openai-api": "active",
+            cron: "active",
+            // Default-ON operator surfaces: active with no `tui`/`live` section in the fixture.
+            tui: "active",
+            live: "active",
+        },
+        enabledFlags: {
+            telegram: false,
+            slack: true,
+            webhook: false,
+            "openai-api": true,
+        },
+    },
+};
+export async function validateConsumerContractFixture(options) {
+    const issues = [];
+    let reportOk;
+    let sections = [];
+    let networkCallCount = 0;
+    const secretHits = await scanConsumerFixtureSecrets(options.fixtureDir);
+    if (secretHits.length > 0) {
+        issues.push(issue("fixture-secrets", `Fixture contains forbidden secret markers: ${secretHits.join(", ")}`));
+    }
+    const dir = await mkdtemp(join(tmpdir(), `agent-app-consumer-${options.name}-`));
+    const restoreFetch = installNetworkGuard(() => {
+        networkCallCount += 1;
+    });
+    try {
+        await cp(options.fixtureDir, dir, { recursive: true });
+        const configPath = join(dir, "mono-agent.config.json");
+        const sourceJson = (await readMonoAgentConfigJson(configPath)).json;
+        const config = await loadAppCoreConfig({ env: options.env ?? {}, cwd: dir, configPath });
+        const report = await validateMonoAgentFolder({
+            env: options.env ?? {},
+            cwd: dir,
+            configPath,
+            liveness: false,
+        });
+        reportOk = report.ok;
+        sections = sectionStatuses(report);
+        issues.push(...consumerContractIssues({ name: options.name, sourceJson, config, report }));
+    }
+    catch (error) {
+        issues.push(issue("consumer-contract", reasonOf(error)));
+    }
+    finally {
+        restoreFetch();
+        await rm(dir, { recursive: true, force: true });
+    }
+    if (networkCallCount > 0) {
+        issues.push(issue("offline", `Validation attempted ${networkCallCount} network call(s) under liveness:false.`));
+    }
+    return {
+        name: options.name,
+        ok: issues.length === 0,
+        ...(reportOk === undefined ? {} : { reportOk }),
+        networkCallCount,
+        sections,
+        issues,
+    };
+}
+function consumerContractIssues(fixture) {
+    const issues = [];
+    const expected = expectedContracts[fixture.name];
+    if (!fixture.report.ok) {
+        issues.push(issue("validation", "validateMonoAgentFolder returned ok=false."));
+    }
+    issues.push(...channelContractIssues(fixture.report, expected.channels));
+    issues.push(...sourceEnabledFlagIssues(fixture.sourceJson, expected.enabledFlags));
+    issues.push(...arrayEqualsIssues("tools.allowedTools", fixture.config.tools.allowedTools, expected.allowedTools));
+    issues.push(...arrayEqualsIssues("tools.disallowedTools", fixture.config.tools.disallowedTools, []));
+    if (fixture.config.tools.allowedTools.length === 0) {
+        issues.push(issue("tools.allowedTools", "Allowed tools must not be empty."));
+    }
+    if (fixture.config.memory?.mode !== expected.memoryMode) {
+        issues.push(issue("memory.mode", `Expected ${expected.memoryMode}, got ${String(fixture.config.memory?.mode)}.`));
+    }
+    if (fixture.config.memory?.recallTool?.enabled !== true) {
+        issues.push(issue("memory.recallTool.enabled", "Expected memory recall tool to be enabled."));
+    }
+    if (!["ok", "waiting"].includes(sectionStatus(fixture.report, "memory") ?? "")) {
+        issues.push(issue("memory.section", "Memory doctor section must be ok or waiting."));
+    }
+    if (typeof fixture.sourceJson.artifacts?.dir !== "string" || fixture.sourceJson.artifacts.dir.trim().length === 0) {
+        issues.push(issue("artifacts.dir", "Source fixture must explicitly include artifacts.dir."));
+    }
+    if (fixture.config.observability?.exporters[0]?.type !== "phoenix") {
+        issues.push(issue("observability.exporters", "Expected first observability exporter type to be phoenix."));
+    }
+    issues.push(...retiredMcpMemorySurfaceIssues(fixture));
+    return issues;
+}
+function channelContractIssues(report, expected) {
+    const issues = [];
+    const statuses = channelStatuses(report);
+    const actualKeys = [...statuses.keys()].sort();
+    const expectedKeys = Object.keys(expected).sort();
+    if (!arraysEqual(actualKeys, expectedKeys)) {
+        issues.push(issue("channels", `Expected channel ids ${expectedKeys.join(", ")}, got ${actualKeys.join(", ")}.`));
+    }
+    for (const [id, expectedState] of Object.entries(expected)) {
+        const status = statuses.get(id);
+        if (status === undefined) {
+            issues.push(issue(`channel:${id}`, "Missing channel section."));
+            continue;
+        }
+        if (status === "error") {
+            issues.push(issue(`channel:${id}`, "Channel section must not be error."));
+        }
+        if (expectedState === "active") {
+            if (status !== "ok" && status !== "waiting") {
+                issues.push(issue(`channel:${id}`, `Expected active channel to be ok or waiting, got ${status}.`));
+            }
+        }
+        else if (status !== "disabled") {
+            issues.push(issue(`channel:${id}`, `Expected disabled channel, got ${status}.`));
+        }
+    }
+    return issues;
+}
+function sourceEnabledFlagIssues(sourceJson, expected) {
+    const issues = [];
+    for (const [id, enabled] of Object.entries(expected)) {
+        const actual = sourceEnabledFlag(sourceJson, id);
+        if (actual !== enabled) {
+            issues.push(issue(`${id}.enabled`, `Expected ${String(enabled)}, got ${String(actual)}.`));
+        }
+    }
+    return issues;
+}
+function sourceEnabledFlag(sourceJson, id) {
+    switch (id) {
+        case "telegram":
+            return sourceJson.telegram?.enabled === true;
+        case "slack":
+            return sourceJson.slack?.enabled === true;
+        case "webhook":
+            return sourceJson.webhook?.enabled === true;
+        case "openai-api":
+            return sourceJson.openaiApi?.enabled === true;
+        default:
+            throw new Error(`unknown channel enabled flag: ${id}`);
+    }
+}
+function retiredMcpMemorySurfaceIssues(fixture) {
+    const issues = [];
+    if (fixture.config.tools.allowedTools.includes("memory_note")) {
+        issues.push(issue("tools.allowedTools", "Allowed tools must not expose retired memory_note."));
+    }
+    if (fixture.config.tools.mcpConfigPath === undefined) {
+        issues.push(issue("tools.mcpConfigPath", "Expected fixture to resolve tools.mcpConfigPath."));
+        return issues;
+    }
+    const mcpText = readFileSync(fixture.config.tools.mcpConfigPath, "utf8");
+    if (forbiddenMcpMemoryPattern.test(mcpText)) {
+        issues.push(issue("tools.mcpConfigPath", "MCP config exposes a retired memory MCP surface."));
+    }
+    return issues;
+}
+function channelStatuses(report) {
+    const result = new Map();
+    for (const section of report.sections) {
+        if (section.id.startsWith("channel:")) {
+            result.set(section.id.slice("channel:".length), section.status);
+        }
+    }
+    return result;
+}
+function sectionStatus(report, id) {
+    return report.sections.find((section) => section.id === id)?.status;
+}
+function sectionStatuses(report) {
+    return report.sections.map(({ id, status }) => ({ id, status }));
+}
+function arrayEqualsIssues(check, actual, expected) {
+    if (arraysEqual(actual, expected)) {
+        return [];
+    }
+    return [issue(check, `Expected ${JSON.stringify(expected)}, got ${JSON.stringify(actual)}.`)];
+}
+function arraysEqual(actual, expected) {
+    return actual.length === expected.length && actual.every((value, index) => value === expected[index]);
+}
+async function scanConsumerFixtureSecrets(root) {
+    const files = await readFixtureFiles(root);
+    return files.flatMap(({ path, content }) => forbiddenFixtureSecretPattern.test(content) ? [relative(root, path)] : []);
+}
+async function readFixtureFiles(root) {
+    const entries = await readdir(root, { withFileTypes: true });
+    const files = await Promise.all(entries.map(async (entry) => {
+        const path = join(root, entry.name);
+        if (entry.isDirectory()) {
+            return await readFixtureFiles(path);
+        }
+        if (!entry.isFile()) {
+            return [];
+        }
+        return [{ path, content: await readFile(path, "utf8") }];
+    }));
+    return files.flat();
+}
+function installNetworkGuard(onCall) {
+    const globalWithFetch = globalThis;
+    const originalFetch = globalWithFetch.fetch;
+    globalWithFetch.fetch = (() => {
+        onCall();
+        throw new Error("consumer contract fixtures must validate without network access");
+    });
+    return () => {
+        if (originalFetch === undefined) {
+            delete globalWithFetch.fetch;
+        }
+        else {
+            globalWithFetch.fetch = originalFetch;
+        }
+    };
+}
+function issue(check, message) {
+    return { check, message };
+}
+function reasonOf(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=consumer-contract.js.map

package/dist/consumer-contract.js.map

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

package/dist/doctor.d.ts

@@ -1,3 +1,4 @@
+import type { SandboxEngine } from "@mono-agent/runtime-adapter";
 import type { MonoAgentAppConfigInput } from "./app-config.js";
 import type { ChannelDriver } from "./channels.js";
 export type ValidationStatus = "ok" | "waiting" | "disabled" | "error";
@@ -14,6 +15,22 @@ export interface ValidationReport {
 }
 export interface ValidateMonoAgentFolderOptions extends MonoAgentAppConfigInput {
     readonly drivers?: readonly ChannelDriver[];
+    /** Optional sandbox engine override for deterministic validation tests. */
+    readonly sandboxEngine?: SandboxEngine;
+    /**
+     * When false, validation must not create directories or otherwise mutate the
+     * target filesystem. This is used for downstream consumer validation from a
+     * different working directory. Defaults to true.
+     */
+    readonly allowFilesystemWrites?: boolean;
+    /**
+     * When false, skip the live network probes (Ollama reachability and the
+     * Phoenix export probe) and validate only structure/shape. Those probes can
+     * only ever downgrade a section to `waiting`, never `error`, so skipping them
+     * leaves the pass/fail verdict (`ok`) unchanged while removing up to two
+     * 3s timeouts — the start preflight relies on this. Defaults to true.
+     */
+    readonly liveness?: boolean;
 }
 /**
  * Loads every config section the app would use at start and reports it

package/dist/doctor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../src/doctor.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAE/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,MAAM,MAAM,gBAAgB,GAAG,IAAI,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,CAAC;AAEvE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAChD,iFAAiF;IACjF,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,8BAA+B,SAAQ,uBAAuB;IAC7E,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;CAC7C;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,8BAA8B,GACtC,OAAO,CAAC,gBAAgB,CAAC,CAiC3B"}
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../src/doctor.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAUjE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAI/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAInD,MAAM,MAAM,gBAAgB,GAAG,IAAI,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,CAAC;AAEvE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAChD,iFAAiF;IACjF,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,8BAA+B,SAAQ,uBAAuB;IAC7E,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;IAC5C,2EAA2E;IAC3E,QAAQ,CAAC,aAAa,CAAC,EAAE,aAAa,CAAC;IACvC;;;;OAIG;IACH,QAAQ,CAAC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IACzC;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,8BAA8B,GACtC,OAAO,CAAC,gBAAgB,CAAC,CAuD3B"}