surface-cli 0.1.0

package/dist/config.js

@@ -0,0 +1,156 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, resolve } from "node:path";
+import { parse as parseToml } from "smol-toml";
+import { z } from "zod";
+const summarizerBackendSchema = z.enum(["openrouter", "openclaw", "none"]);
+const sendModeSchema = z.enum(["draft_only", "allow_send"]);
+const stringListSchema = z.union([z.string(), z.array(z.string())]);
+const fileConfigSchema = z.object({
+    cache_dir: z.string().optional(),
+    default_result_limit: z.number().int().positive().optional(),
+    provider_timeout_ms: z.number().int().positive().optional(),
+    summarizer: z
+        .object({
+        backend: summarizerBackendSchema.optional(),
+        model: z.string().min(1).optional(),
+        timeout_ms: z.number().int().positive().optional(),
+    })
+        .optional(),
+    summary_input_max_bytes: z.number().int().positive().optional(),
+    summarizer_backend: summarizerBackendSchema.optional(),
+    summarizer_model: z.string().min(1).optional(),
+    summarizer_timeout_ms: z.number().int().positive().optional(),
+    writes_enabled: z.boolean().optional(),
+    send_mode: sendModeSchema.optional(),
+    test_recipients: stringListSchema.optional(),
+    test_account_allowlist: stringListSchema.optional(),
+});
+export function defaultConfigPath() {
+    return resolve(homedir(), ".surface-cli", "config.toml");
+}
+function defaultConfigTemplate() {
+    return [
+        "# Surface CLI local config",
+        "#",
+        "# This file stores local policy and preference knobs only.",
+        "# Account registry and auth state live in SQLite plus ~/.surface-cli/auth/.",
+        "",
+        "cache_dir = \"~/.surface-cli\"",
+        "default_result_limit = 50",
+        "provider_timeout_ms = 30000",
+        "summary_input_max_bytes = 16384",
+        "summarizer_backend = \"none\"",
+        "summarizer_model = \"openai/gpt-4o-mini\"",
+        "summarizer_timeout_ms = 20000",
+        "writes_enabled = false",
+        "send_mode = \"draft_only\"",
+        "test_recipients = []",
+        "test_account_allowlist = []",
+        "",
+    ].join("\n");
+}
+function ensureConfigFileExists(configPath) {
+    if (existsSync(configPath)) {
+        return;
+    }
+    mkdirSync(dirname(configPath), { recursive: true });
+    writeFileSync(configPath, defaultConfigTemplate(), "utf8");
+}
+function expandHomePath(value) {
+    if (value === "~") {
+        return homedir();
+    }
+    if (value.startsWith("~/")) {
+        return resolve(homedir(), value.slice(2));
+    }
+    return resolve(value);
+}
+function parseConfigFile(rawText) {
+    const parsed = parseToml(rawText);
+    return fileConfigSchema.parse(parsed);
+}
+function envInt(name) {
+    const rawValue = process.env[name];
+    if (rawValue === undefined || rawValue.trim() === "") {
+        return undefined;
+    }
+    const parsed = Number.parseInt(rawValue, 10);
+    if (Number.isNaN(parsed) || parsed <= 0) {
+        throw new Error(`Environment variable ${name} must be a positive integer.`);
+    }
+    return parsed;
+}
+function envBoolean(name) {
+    const rawValue = process.env[name];
+    if (rawValue === undefined || rawValue.trim() === "") {
+        return undefined;
+    }
+    const normalized = rawValue.trim().toLowerCase();
+    if (["1", "true", "yes", "on"].includes(normalized)) {
+        return true;
+    }
+    if (["0", "false", "no", "off"].includes(normalized)) {
+        return false;
+    }
+    throw new Error(`Environment variable ${name} must be a boolean.`);
+}
+function parseStringList(value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (Array.isArray(value)) {
+        return value.map((entry) => entry.trim()).filter((entry) => entry.length > 0);
+    }
+    return value
+        .split(",")
+        .map((entry) => entry.trim())
+        .filter((entry) => entry.length > 0);
+}
+export function loadConfig(options = {}) {
+    const configPath = expandHomePath(options.configPath ?? process.env.SURFACE_CONFIG_PATH ?? defaultConfigPath());
+    ensureConfigFileExists(configPath);
+    let fileConfig = {};
+    try {
+        fileConfig = parseConfigFile(readFileSync(configPath, "utf8"));
+    }
+    catch (error) {
+        if (error.code !== "ENOENT") {
+            throw error;
+        }
+    }
+    const config = {
+        cacheDir: expandHomePath(process.env.SURFACE_CACHE_DIR ?? fileConfig.cache_dir ?? resolve(homedir(), ".surface-cli")),
+        defaultResultLimit: envInt("SURFACE_DEFAULT_RESULT_LIMIT") ?? fileConfig.default_result_limit ?? 50,
+        providerTimeoutMs: envInt("SURFACE_PROVIDER_TIMEOUT_MS") ?? fileConfig.provider_timeout_ms ?? 30_000,
+        summarizerBackend: process.env.SURFACE_SUMMARIZER_BACKEND ??
+            fileConfig.summarizer?.backend ??
+            fileConfig.summarizer_backend ??
+            "none",
+        summarizerModel: process.env.SURFACE_SUMMARIZER_MODEL ??
+            fileConfig.summarizer?.model ??
+            fileConfig.summarizer_model ??
+            "openai/gpt-4o-mini",
+        summaryInputMaxBytes: envInt("SURFACE_SUMMARY_INPUT_MAX_BYTES") ??
+            fileConfig.summary_input_max_bytes ??
+            16_384,
+        summarizerTimeoutMs: envInt("SURFACE_SUMMARIZER_TIMEOUT_MS") ??
+            fileConfig.summarizer?.timeout_ms ??
+            fileConfig.summarizer_timeout_ms ??
+            20_000,
+        writesEnabled: envBoolean("SURFACE_WRITES_ENABLED") ??
+            fileConfig.writes_enabled ??
+            false,
+        sendMode: process.env.SURFACE_SEND_MODE ??
+            fileConfig.send_mode ??
+            "draft_only",
+        testRecipients: parseStringList(process.env.SURFACE_TEST_RECIPIENTS) ??
+            parseStringList(fileConfig.test_recipients) ??
+            [],
+        testAccountAllowlist: parseStringList(process.env.SURFACE_TEST_ACCOUNT_ALLOWLIST) ??
+            parseStringList(fileConfig.test_account_allowlist) ??
+            [],
+    };
+    return { config, configPath };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/contracts/account.js

@@ -0,0 +1,9 @@
+import { z } from "zod";
+export const providerSchema = z.enum(["gmail", "outlook"]);
+export const accountInputSchema = z.object({
+    name: z.string().trim().min(1),
+    provider: providerSchema,
+    transport: z.string().trim().min(1),
+    email: z.email(),
+});
+//# sourceMappingURL=account.js.map

package/dist/contracts/account.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"account.js","sourceRoot":"","sources":["../../src/contracts/account.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC;AAG3D,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,QAAQ,EAAE,cAAc;IACxB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACnC,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE;CACjB,CAAC,CAAC"}

package/dist/contracts/mail.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=mail.js.map

package/dist/contracts/mail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mail.js","sourceRoot":"","sources":["../../src/contracts/mail.ts"],"names":[],"mappings":""}

package/dist/e2e/gmail-v1.js

@@ -0,0 +1,247 @@
+import { existsSync } from "node:fs";
+import { spawn } from "node:child_process";
+import { fileURLToPath } from "node:url";
+import { dirname, resolve } from "node:path";
+import { createRuntimeContext } from "../runtime.js";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const repoRoot = resolve(__dirname, "..", "..");
+function fail(message) {
+    throw new Error(message);
+}
+function assert(condition, message) {
+    if (!condition) {
+        fail(message);
+    }
+}
+function sleep(ms) {
+    return new Promise((resolvePromise) => {
+        setTimeout(resolvePromise, ms);
+    });
+}
+function uniqueSubject(prefix) {
+    return `[surface-e2e] ${prefix} ${Date.now()}`;
+}
+function parseCsv(value) {
+    return value
+        .split(",")
+        .map((entry) => entry.trim())
+        .filter((entry) => entry.length > 0);
+}
+function normalizeAssertionText(value) {
+    return value.replace(/\s+/g, " ").trim().toLowerCase();
+}
+function resolveTestRecipients() {
+    const fromEnv = process.env.SURFACE_TEST_RECIPIENTS?.trim();
+    if (fromEnv) {
+        return parseCsv(fromEnv);
+    }
+    const runtime = createRuntimeContext(process.env.SURFACE_CONFIG_PATH ? { configPath: process.env.SURFACE_CONFIG_PATH } : {});
+    try {
+        return runtime.config.testRecipients;
+    }
+    finally {
+        runtime.db.close();
+    }
+}
+async function runSurfaceJson(args, env) {
+    return await new Promise((resolvePromise, rejectPromise) => {
+        const child = spawn(process.execPath, ["dist/cli.js", ...args], {
+            cwd: repoRoot,
+            env,
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        let stdout = "";
+        let stderr = "";
+        child.stdout.on("data", (chunk) => {
+            stdout += chunk.toString("utf8");
+        });
+        child.stderr.on("data", (chunk) => {
+            stderr += chunk.toString("utf8");
+        });
+        child.on("error", rejectPromise);
+        child.on("close", (code) => {
+            let parsed = null;
+            try {
+                parsed = stdout.trim() ? JSON.parse(stdout) : null;
+            }
+            catch (error) {
+                rejectPromise(new Error(`surface ${args.join(" ")} returned non-JSON stdout.\nSTDOUT:\n${stdout}\nSTDERR:\n${stderr}\n${String(error)}`));
+                return;
+            }
+            if (code !== 0) {
+                rejectPromise(new Error(`surface ${args.join(" ")} failed with exit code ${code}.\nSTDOUT:\n${stdout}\nSTDERR:\n${stderr}`));
+                return;
+            }
+            resolvePromise(parsed);
+        });
+    });
+}
+async function pollThreadBySubject(env, account, subject, predicate) {
+    for (let attempt = 0; attempt < 12; attempt += 1) {
+        const search = await runSurfaceJson(["mail", "search", "--account", account, "--text", subject, "--limit", "10"], env);
+        const thread = search.threads.find((candidate) => candidate.envelope.subject.includes(subject));
+        if (thread && predicate(thread)) {
+            return thread;
+        }
+        await sleep(2_500);
+    }
+    fail(`Timed out waiting for a Gmail thread matching subject '${subject}'.`);
+}
+async function findAttachmentMessage(env, account) {
+    const search = await runSurfaceJson(["mail", "search", "--account", account, "--text", "has:attachment newer_than:3650d", "--limit", "10"], env);
+    for (const thread of search.threads) {
+        for (const message of thread.messages) {
+            const attachment = message.attachments[0];
+            if (attachment) {
+                return {
+                    message_ref: message.message_ref,
+                    attachment_id: attachment.attachment_id,
+                };
+            }
+        }
+    }
+    fail("Could not find a Gmail message with an attachment for live download verification.");
+}
+async function findInboxMessage(env, account) {
+    const search = await runSurfaceJson(["mail", "search", "--account", account, "--text", "in:inbox newer_than:3650d", "--limit", "10"], env);
+    for (const thread of search.threads) {
+        const message = thread.messages[0];
+        if (message) {
+            return {
+                thread_ref: thread.thread_ref,
+                message_ref: message.message_ref,
+            };
+        }
+    }
+    fail("Could not find a Gmail inbox message for archive/read-state verification.");
+}
+async function main() {
+    assert(process.env.SURFACE_E2E_ENABLE === "1", "Refusing to run live Gmail e2e without SURFACE_E2E_ENABLE=1.");
+    const account = process.env.SURFACE_E2E_ACCOUNT?.trim() || "personal_2";
+    const recipients = resolveTestRecipients();
+    assert(recipients.length >= 1, "Need at least one address in SURFACE_TEST_RECIPIENTS for Gmail e2e.");
+    const primaryRecipient = recipients[0];
+    const childEnv = {
+        ...process.env,
+        SURFACE_WRITES_ENABLED: "1",
+        SURFACE_SEND_MODE: "allow_send",
+        SURFACE_SUMMARIZER_BACKEND: "none",
+    };
+    const baseSubject = uniqueSubject("gmail-v1");
+    const sendBody = `surface gmail e2e send body ${Date.now()}`;
+    const replyBody = `surface gmail e2e reply body ${Date.now()}`;
+    const replyAllBody = `surface gmail e2e reply-all body ${Date.now()}`;
+    const forwardBody = `surface gmail e2e forward body ${Date.now()}`;
+    const draftSubject = uniqueSubject("gmail-v1-draft");
+    console.log(`Running live Gmail v1 e2e on account '${account}' with subject '${baseSubject}'.`);
+    const sendResult = await runSurfaceJson([
+        "mail",
+        "send",
+        "--account",
+        account,
+        "--to",
+        primaryRecipient,
+        "--subject",
+        baseSubject,
+        "--body",
+        sendBody,
+    ], childEnv);
+    assert(sendResult.status === "sent", "send did not report status=sent");
+    assert(sendResult.thread_ref, "send did not resolve a thread_ref");
+    assert(sendResult.message_ref, "send did not resolve a message_ref");
+    console.log(`send: ${sendResult.message_ref} in ${sendResult.thread_ref}`);
+    const sentThread = await pollThreadBySubject(childEnv, account, baseSubject, (thread) => thread.messages.length >= 1);
+    const baseMessageCount = sentThread.messages.length;
+    console.log(`search: found thread ${sentThread.thread_ref} with ${baseMessageCount} message(s)`);
+    const readResult = await runSurfaceJson(["mail", "read", sendResult.message_ref], childEnv);
+    assert(readResult.message.envelope.subject === baseSubject, "read returned the wrong subject after send");
+    assert(normalizeAssertionText(readResult.message.body.text).includes(normalizeAssertionText(sendBody)), "read did not expose the sent body text in the cached Gmail message");
+    console.log("read: verified sent body and subject");
+    const replyResult = await runSurfaceJson(["mail", "reply", sendResult.message_ref, "--body", replyBody], childEnv);
+    assert(replyResult.status === "sent", "reply did not report status=sent");
+    assert(replyResult.thread_ref === sendResult.thread_ref, "reply resolved a different thread_ref");
+    const repliedThread = await pollThreadBySubject(childEnv, account, baseSubject, (thread) => thread.messages.length > baseMessageCount);
+    console.log(`reply: thread now has ${repliedThread.messages.length} message(s)`);
+    const replyAllResult = await runSurfaceJson(["mail", "reply-all", sendResult.message_ref, "--body", replyAllBody], childEnv);
+    assert(replyAllResult.status === "sent", "reply-all did not report status=sent");
+    assert(replyAllResult.thread_ref === sendResult.thread_ref, "reply-all resolved a different thread_ref");
+    const replyAllThread = await pollThreadBySubject(childEnv, account, baseSubject, (thread) => thread.messages.length > repliedThread.messages.length);
+    console.log(`reply-all: thread now has ${replyAllThread.messages.length} message(s)`);
+    const forwardResult = await runSurfaceJson([
+        "mail",
+        "forward",
+        sendResult.message_ref,
+        "--to",
+        primaryRecipient,
+        "--body",
+        forwardBody,
+    ], childEnv);
+    assert(forwardResult.status === "sent", "forward did not report status=sent");
+    assert(forwardResult.subject.startsWith("Fwd:"), "forward subject did not start with 'Fwd:'");
+    await pollThreadBySubject(childEnv, account, forwardResult.subject, (thread) => thread.messages.length >= 1);
+    console.log(`forward: verified search visibility for '${forwardResult.subject}'`);
+    const sendDraftResult = await runSurfaceJson([
+        "mail",
+        "send",
+        "--account",
+        account,
+        "--to",
+        primaryRecipient,
+        "--subject",
+        draftSubject,
+        "--body",
+        `surface gmail e2e draft body ${Date.now()}`,
+        "--draft",
+    ], {
+        ...childEnv,
+        SURFACE_SEND_MODE: "draft_only",
+    });
+    assert(sendDraftResult.status === "drafted", "send --draft did not report status=drafted");
+    assert(sendDraftResult.message_ref, "send --draft did not resolve a message_ref");
+    console.log(`send --draft: ${sendDraftResult.message_ref}`);
+    const replyDraftResult = await runSurfaceJson(["mail", "reply", sendResult.message_ref, "--body", `surface gmail e2e reply draft ${Date.now()}`, "--draft"], {
+        ...childEnv,
+        SURFACE_SEND_MODE: "draft_only",
+    });
+    assert(replyDraftResult.status === "drafted", "reply --draft did not report status=drafted");
+    console.log(`reply --draft: ${replyDraftResult.message_ref}`);
+    const attachmentTarget = await findAttachmentMessage(childEnv, account);
+    const attachmentList = await runSurfaceJson(["attachment", "list", attachmentTarget.message_ref], childEnv);
+    assert(attachmentList.attachments.length > 0, "attachment list returned no attachments for the chosen Gmail message");
+    const attachmentDownload = await runSurfaceJson(["attachment", "download", attachmentTarget.message_ref, attachmentTarget.attachment_id], childEnv);
+    assert(existsSync(attachmentDownload.attachment.saved_to), "attachment download did not create the expected file");
+    console.log(`attachment download: ${attachmentDownload.attachment.saved_to}`);
+    const inboxTarget = await findInboxMessage(childEnv, account);
+    const markReadResult = await runSurfaceJson(["mail", "mark-read", inboxTarget.message_ref], childEnv);
+    assert(markReadResult.updated[0]?.unread === false, "mark-read did not return unread=false");
+    const readAfterMarkRead = await runSurfaceJson(["mail", "read", inboxTarget.message_ref, "--refresh"], childEnv);
+    assert(readAfterMarkRead.message.envelope.unread === false, "mark-read was not reflected by a refreshed read");
+    const markUnreadResult = await runSurfaceJson(["mail", "mark-unread", inboxTarget.message_ref], childEnv);
+    assert(markUnreadResult.updated[0]?.unread === true, "mark-unread did not return unread=true");
+    const readAfterMarkUnread = await runSurfaceJson(["mail", "read", inboxTarget.message_ref, "--refresh"], childEnv);
+    assert(readAfterMarkUnread.message.envelope.unread === true, "mark-unread was not reflected by a refreshed read");
+    const readMarked = await runSurfaceJson(["mail", "read", inboxTarget.message_ref, "--mark-read"], childEnv);
+    assert(readMarked.message.envelope.unread === false, "read --mark-read did not return unread=false");
+    console.log("mark-read/mark-unread/read --mark-read: verified read-state mutation");
+    const archiveResult = await runSurfaceJson(["mail", "archive", inboxTarget.message_ref], childEnv);
+    assert(archiveResult.status === "archived", "archive did not report status=archived");
+    const runtime = createRuntimeContext(process.env.SURFACE_CONFIG_PATH ? { configPath: process.env.SURFACE_CONFIG_PATH } : {});
+    try {
+        const archived = runtime.db.connection
+            .prepare("SELECT mailbox FROM threads WHERE thread_ref = ? LIMIT 1")
+            .get(archiveResult.thread_ref);
+        assert(archived?.mailbox === "archive", "archive did not persist mailbox=archive in local state");
+    }
+    finally {
+        runtime.db.close();
+    }
+    console.log("archive: verified local thread mailbox state");
+    console.log("Gmail v1 e2e completed successfully.");
+}
+main().catch((error) => {
+    const message = error instanceof Error ? error.stack ?? error.message : String(error);
+    console.error(message);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=gmail-v1.js.map

package/dist/e2e/gmail-v1.js.map

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

package/dist/e2e/outlook-v1.js

@@ -0,0 +1,179 @@
+import { spawn } from "node:child_process";
+import { fileURLToPath } from "node:url";
+import { dirname, resolve } from "node:path";
+import { createRuntimeContext } from "../runtime.js";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const repoRoot = resolve(__dirname, "..", "..");
+function fail(message) {
+    throw new Error(message);
+}
+function assert(condition, message) {
+    if (!condition) {
+        fail(message);
+    }
+}
+function sleep(ms) {
+    return new Promise((resolvePromise) => {
+        setTimeout(resolvePromise, ms);
+    });
+}
+function uniqueSubject(prefix) {
+    return `[surface-e2e] ${prefix} ${Date.now()}`;
+}
+function requireEnv(name) {
+    const value = process.env[name]?.trim();
+    if (!value) {
+        fail(`Missing required environment variable ${name}.`);
+    }
+    return value;
+}
+function parseCsv(value) {
+    return value
+        .split(",")
+        .map((entry) => entry.trim())
+        .filter((entry) => entry.length > 0);
+}
+function normalizeAssertionText(value) {
+    return value.replace(/\s+/g, " ").trim().toLowerCase();
+}
+async function runSurfaceJson(args, env) {
+    return await new Promise((resolvePromise, rejectPromise) => {
+        const child = spawn(process.execPath, ["dist/cli.js", ...args], {
+            cwd: repoRoot,
+            env,
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        let stdout = "";
+        let stderr = "";
+        child.stdout.on("data", (chunk) => {
+            stdout += chunk.toString("utf8");
+        });
+        child.stderr.on("data", (chunk) => {
+            stderr += chunk.toString("utf8");
+        });
+        child.on("error", rejectPromise);
+        child.on("close", (code) => {
+            let parsed = null;
+            try {
+                parsed = stdout.trim() ? JSON.parse(stdout) : null;
+            }
+            catch (error) {
+                rejectPromise(new Error(`surface ${args.join(" ")} returned non-JSON stdout.\nSTDOUT:\n${stdout}\nSTDERR:\n${stderr}\n${String(error)}`));
+                return;
+            }
+            if (code !== 0) {
+                rejectPromise(new Error(`surface ${args.join(" ")} failed with exit code ${code}.\nSTDOUT:\n${stdout}\nSTDERR:\n${stderr}`));
+                return;
+            }
+            resolvePromise(parsed);
+        });
+    });
+}
+async function pollThreadBySubject(env, account, subject, predicate) {
+    for (let attempt = 0; attempt < 12; attempt += 1) {
+        const search = await runSurfaceJson(["mail", "search", "--account", account, "--text", subject, "--limit", "10"], env);
+        const thread = search.threads.find((candidate) => candidate.envelope.subject.includes(subject));
+        if (thread && predicate(thread)) {
+            return thread;
+        }
+        await sleep(2_500);
+    }
+    fail(`Timed out waiting for a search result thread matching subject '${subject}'.`);
+}
+async function main() {
+    assert(process.env.SURFACE_E2E_ENABLE === "1", "Refusing to run live Outlook e2e without SURFACE_E2E_ENABLE=1.");
+    const account = process.env.SURFACE_E2E_ACCOUNT?.trim() || "uni";
+    const recipients = parseCsv(requireEnv("SURFACE_TEST_RECIPIENTS"));
+    assert(recipients.length >= 2, "Need at least two addresses in SURFACE_TEST_RECIPIENTS for reply-all coverage.");
+    const [primaryRecipient, ccRecipient, bccRecipient] = recipients;
+    const childEnv = {
+        ...process.env,
+        SURFACE_WRITES_ENABLED: "1",
+        SURFACE_SEND_MODE: "allow_send",
+    };
+    const baseSubject = uniqueSubject("outlook-v1");
+    const sendBody = `surface e2e send body ${Date.now()}`;
+    const replyBody = `surface e2e reply body ${Date.now()}`;
+    const replyAllBody = `surface e2e reply-all body ${Date.now()}`;
+    const forwardBody = `surface e2e forward body ${Date.now()}`;
+    console.log(`Running live Outlook v1 e2e on account '${account}' with subject '${baseSubject}'.`);
+    const sendResult = await runSurfaceJson([
+        "mail",
+        "send",
+        "--account",
+        account,
+        "--to",
+        primaryRecipient,
+        "--cc",
+        ccRecipient,
+        ...(bccRecipient ? ["--bcc", bccRecipient] : []),
+        "--subject",
+        baseSubject,
+        "--body",
+        sendBody,
+    ], childEnv);
+    assert(sendResult.status === "sent", "send did not report status=sent");
+    assert(sendResult.thread_ref, "send did not resolve a thread_ref");
+    assert(sendResult.message_ref, "send did not resolve a message_ref");
+    console.log(`send: ${sendResult.message_ref} in ${sendResult.thread_ref}`);
+    const sentThread = await pollThreadBySubject(childEnv, account, baseSubject, (thread) => thread.messages.length >= 1);
+    const baseMessageCount = sentThread.messages.length;
+    console.log(`search: found thread ${sentThread.thread_ref} with ${baseMessageCount} message(s)`);
+    const readResult = await runSurfaceJson(["mail", "read", sendResult.message_ref], childEnv);
+    assert(readResult.message.envelope.subject === baseSubject, "read returned the wrong subject after send");
+    assert(normalizeAssertionText(readResult.message.body.text).includes(normalizeAssertionText(sendBody)), "read did not expose the sent body text in the cached message");
+    console.log("read: verified sent body and subject");
+    const markUnreadResult = await runSurfaceJson(["mail", "mark-unread", sendResult.message_ref], childEnv);
+    assert(markUnreadResult.updated[0]?.unread === true, "mark-unread did not return unread=true");
+    const markReadViaRead = await runSurfaceJson(["mail", "read", sendResult.message_ref, "--mark-read"], childEnv);
+    assert(markReadViaRead.message.envelope.unread === false, "read --mark-read did not return unread=false");
+    console.log("mark-unread/read --mark-read: verified read-state mutation");
+    const replyResult = await runSurfaceJson(["mail", "reply", sendResult.message_ref, "--body", replyBody], childEnv);
+    assert(replyResult.status === "sent", "reply did not report status=sent");
+    assert(replyResult.thread_ref === sendResult.thread_ref, "reply resolved a different thread_ref");
+    const repliedThread = await pollThreadBySubject(childEnv, account, baseSubject, (thread) => thread.messages.length > baseMessageCount);
+    console.log(`reply: thread now has ${repliedThread.messages.length} message(s)`);
+    const replyAllResult = await runSurfaceJson(["mail", "reply-all", sendResult.message_ref, "--body", replyAllBody], childEnv);
+    assert(replyAllResult.status === "sent", "reply-all did not report status=sent");
+    assert(replyAllResult.thread_ref === sendResult.thread_ref, "reply-all resolved a different thread_ref");
+    assert(replyAllResult.recipients.cc.length > 0, "reply-all did not preserve any non-primary recipients");
+    const replyAllThread = await pollThreadBySubject(childEnv, account, baseSubject, (thread) => thread.messages.length > repliedThread.messages.length);
+    console.log(`reply-all: thread now has ${replyAllThread.messages.length} message(s)`);
+    const forwardResult = await runSurfaceJson([
+        "mail",
+        "forward",
+        sendResult.message_ref,
+        "--to",
+        primaryRecipient,
+        "--cc",
+        ccRecipient,
+        ...(bccRecipient ? ["--bcc", bccRecipient] : []),
+        "--body",
+        forwardBody,
+    ], childEnv);
+    assert(forwardResult.status === "sent", "forward did not report status=sent");
+    assert(forwardResult.subject.startsWith("Fw:"), "forward subject did not start with 'Fw:'");
+    await pollThreadBySubject(childEnv, account, forwardResult.subject, (thread) => thread.messages.length >= 1);
+    console.log(`forward: verified search visibility for '${forwardResult.subject}'`);
+    const archiveResult = await runSurfaceJson(["mail", "archive", sendResult.message_ref], childEnv);
+    assert(archiveResult.status === "archived", "archive did not report status=archived");
+    const runtime = createRuntimeContext(process.env.SURFACE_CONFIG_PATH ? { configPath: process.env.SURFACE_CONFIG_PATH } : {});
+    try {
+        const archived = runtime.db.connection
+            .prepare("SELECT mailbox FROM threads WHERE thread_ref = ? LIMIT 1")
+            .get(archiveResult.thread_ref);
+        assert(archived?.mailbox === "archive", "archive did not persist mailbox=archive in local state");
+    }
+    finally {
+        runtime.db.close();
+    }
+    console.log("archive: verified local thread mailbox state");
+    console.log("Outlook v1 e2e completed successfully.");
+}
+main().catch((error) => {
+    const message = error instanceof Error ? error.stack ?? error.message : String(error);
+    console.error(message);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=outlook-v1.js.map