humanish 0.94.0 → 0.96.0

package/README.md

@@ -217,6 +217,16 @@ interactive stdin/stdout, and refuses detected coding-agent sessions even with
 a TTY. Agents should use `lab list --json`, `lab inspect <lab> --json`, and
 `runs --json`. Read [TUI behavior and JSON alternatives](https://humanish.dev/docs/review-surfaces#for-coding-agents-and-scripts).
 
+Press **c** for Connections, then choose **Add API key** to enter an AgentMail
+key with input hidden. Humanish saves the key in its user-level store (shared
+across your projects) and non-secret connection metadata in
+`.humanish/local/comms.yaml`. Ctrl+C cancels entry and returns to the TUI.
+Existing environment or project keys take precedence over the saved key.
+Saving a key runs a read-only authentication check. Choose **Configure a lab**
+to preview a local copy that gives each participant a fresh real inbox. Email
+is hosted by AgentMail and may be processed by actor/analysis models; these
+recordings require local review. [Setup, tradeoffs and recovery](docs/architecture/real-email-receiving.md).
+
 ## Serve the Library
 
 `humanish serve` serves your run library on loopback. The [Observer and terminal guide](https://humanish.dev/docs/review-surfaces#serve-the-run-library)

package/dist/comms-agentmail.d.ts

@@ -0,0 +1,25 @@
+import type { ReceivingAdapter } from "./comms-receiving-types.js";
+/** Bounds apply to a whole operation, including every page, message and download. */
+export declare const AGENTMAIL_RECEIVING_LIMITS: Readonly<{
+    timeoutMs: 30000;
+    maxTimeoutMs: 60000;
+    pages: 4;
+    pageSize: 25;
+    messages: 100;
+    requests: 160;
+    operationBytes: number;
+    responseBytes: number;
+    textBytes: number;
+    downloadRedirects: 2;
+}>;
+export type AgentMailReceivingErrorCode = "agentmail_auth_rejected" | "agentmail_rate_limited" | "agentmail_unavailable" | "agentmail_timeout" | "agentmail_cancelled" | "agentmail_invalid_response" | "agentmail_ownership_mismatch" | "agentmail_not_found" | "agentmail_resource_deleting" | "agentmail_download_blocked" | "agentmail_size_limit" | "agentmail_invalid_input" | "agentmail_request_limit";
+/** Safe for callers to report. Never retains the response body, URL, key or caught cause. */
+export declare class AgentMailReceivingError extends Error {
+    readonly code: AgentMailReceivingErrorCode;
+    constructor(code: AgentMailReceivingErrorCode);
+}
+/** Host-only transport; the management credential is never sent to a desktop or download host. */
+export declare function createAgentMailReceiver(options: {
+    apiKey: string;
+    fetch?: typeof globalThis.fetch;
+}): ReceivingAdapter;

package/dist/comms-agentmail.js

@@ -0,0 +1,418 @@
+import { inlineImageData, MAX_INLINE_IMAGE_BYTES, MAX_INLINE_IMAGES_BYTES, MAX_INLINE_IMAGES } from "./comms-images.js";
+const API_ORIGIN = "https://api.agentmail.to";
+const DOWNLOAD_ORIGIN = "https://cdn.agentmail.to";
+/** Bounds apply to a whole operation, including every page, message and download. */
+export const AGENTMAIL_RECEIVING_LIMITS = Object.freeze({
+    timeoutMs: 30_000, maxTimeoutMs: 60_000, pages: 4, pageSize: 25, messages: 100,
+    requests: 160, operationBytes: 12 * 1024 * 1024, responseBytes: 2 * 1024 * 1024,
+    textBytes: 256 * 1024, downloadRedirects: 2,
+});
+/** Safe for callers to report. Never retains the response body, URL, key or caught cause. */
+export class AgentMailReceivingError extends Error {
+    code;
+    constructor(code) {
+        super(code);
+        this.code = code;
+        this.name = "AgentMailReceivingError";
+    }
+}
+function fail(code) { throw new AgentMailReceivingError(code); }
+function safeCode(error) {
+    return error instanceof AgentMailReceivingError ? error.code : "agentmail_unavailable";
+}
+function object(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        fail("agentmail_invalid_response");
+    return value;
+}
+function identifier(value) {
+    if (typeof value !== "string" || !value.length || value.length > 1024 || /[\u0000-\u0020\u007f]/.test(value))
+        fail("agentmail_invalid_response");
+    return value;
+}
+function inputId(value) {
+    try {
+        return identifier(value);
+    }
+    catch {
+        return fail("agentmail_invalid_input");
+    }
+}
+function checkLease(lease) {
+    inputId(lease.resourceId);
+    inputId(lease.address);
+    inputId(lease.clientId);
+}
+const inboxPath = (lease) => `/v0/inboxes/${encodeURIComponent(lease.resourceId)}`;
+const messagePath = (lease, id) => `${inboxPath(lease)}/messages/${encodeURIComponent(id)}`;
+function abortCode(budget) { return budget.cancelled() ? "agentmail_cancelled" : "agentmail_timeout"; }
+function checkAbort(budget) { if (budget.signal.aborted)
+    fail(abortCode(budget)); }
+function bounded(promise, budget) {
+    if (budget.signal.aborted)
+        return Promise.reject(new AgentMailReceivingError(abortCode(budget)));
+    return new Promise((resolve, reject) => {
+        const onAbort = () => reject(new AgentMailReceivingError(abortCode(budget)));
+        budget.signal.addEventListener("abort", onAbort, { once: true });
+        promise.then(resolve, reject).finally(() => budget.signal.removeEventListener("abort", onAbort)).catch(() => { });
+    });
+}
+async function operation(context, action) {
+    const timeout = context?.timeoutMs ?? AGENTMAIL_RECEIVING_LIMITS.timeoutMs;
+    if (!Number.isFinite(timeout) || timeout <= 0)
+        fail("agentmail_invalid_input");
+    const controller = new AbortController();
+    const onAbort = () => controller.abort();
+    const timer = setTimeout(onAbort, Math.min(timeout, AGENTMAIL_RECEIVING_LIMITS.maxTimeoutMs));
+    const budget = { signal: controller.signal, bytes: 0, requests: 0, cancelled: () => context?.signal?.aborted === true };
+    context?.signal?.addEventListener("abort", onAbort, { once: true });
+    if (context?.signal?.aborted)
+        controller.abort();
+    try {
+        checkAbort(budget);
+        return await action(budget);
+    }
+    catch (error) {
+        throw new AgentMailReceivingError(safeCode(error));
+    }
+    finally {
+        clearTimeout(timer);
+        context?.signal?.removeEventListener("abort", onAbort);
+        controller.abort();
+    }
+}
+async function bodyBytes(response, budget, maximum) {
+    checkAbort(budget);
+    const length = response.headers.get("content-length");
+    if (length && /^\d+$/.test(length) && Number(length) > maximum) {
+        void response.body?.cancel().catch(() => { });
+        fail("agentmail_size_limit");
+    }
+    if (!response.body)
+        return Buffer.alloc(0);
+    const reader = response.body.getReader();
+    const chunks = [];
+    let size = 0;
+    try {
+        while (true) {
+            const result = await bounded(reader.read(), budget);
+            if (result.done)
+                break;
+            size += result.value.byteLength;
+            budget.bytes += result.value.byteLength;
+            if (size > maximum || budget.bytes > AGENTMAIL_RECEIVING_LIMITS.operationBytes)
+                fail("agentmail_size_limit");
+            chunks.push(result.value);
+        }
+        return Buffer.concat(chunks, size);
+    }
+    finally {
+        void reader.cancel().catch(() => { });
+    }
+}
+function statusError(reply) {
+    if ([401, 403].includes(reply.status))
+        fail("agentmail_auth_rejected");
+    if (reply.status === 429)
+        fail("agentmail_rate_limited");
+    if (reply.status === 404 && object(reply.body).code === "not_found")
+        fail("agentmail_not_found");
+    if (reply.status === 409 && object(reply.body).code === "resource_deleting")
+        fail("agentmail_resource_deleting");
+    if (reply.status >= 500 || reply.status === 408)
+        fail("agentmail_unavailable");
+    fail("agentmail_invalid_response");
+}
+function success(reply) {
+    if (reply.status < 200 || reply.status >= 300)
+        statusError(reply);
+    return object(reply.body);
+}
+function absentOrDeleting(reply) {
+    if (reply.status === 404 && object(reply.body).code === "not_found")
+        return "absent";
+    if (reply.status === 409 && object(reply.body).code === "resource_deleting")
+        return "deleting";
+    return undefined;
+}
+function assertOwnership(raw, lease) {
+    if (raw.inbox_id !== lease.resourceId || raw.client_id !== lease.clientId || raw.email !== lease.address)
+        fail("agentmail_ownership_mismatch");
+}
+function limitedText(value, limitations) {
+    if (value === undefined || value === null)
+        return undefined;
+    if (typeof value !== "string")
+        fail("agentmail_invalid_response");
+    if (Buffer.byteLength(value) <= AGENTMAIL_RECEIVING_LIMITS.textBytes)
+        return value;
+    limitations.push("agentmail_content_truncated");
+    // Leave no partial UTF-8 sequence at the boundary.
+    return Buffer.from(value).subarray(0, AGENTMAIL_RECEIVING_LIMITS.textBytes).toString("utf8").replace(/\ufffd$/, "");
+}
+const transient = (code) => code === "agentmail_unavailable" || code === "agentmail_timeout";
+/** Host-only transport; the management credential is never sent to a desktop or download host. */
+export function createAgentMailReceiver(options) {
+    if (!options.apiKey || options.apiKey.length > 4096 || /[\u0000-\u0020\u007f]/.test(options.apiKey))
+        fail("agentmail_invalid_input");
+    const fetcher = options.fetch ?? globalThis.fetch;
+    const key = options.apiKey;
+    async function request(url, init, budget) {
+        checkAbort(budget);
+        if (++budget.requests > AGENTMAIL_RECEIVING_LIMITS.requests)
+            fail("agentmail_request_limit");
+        try {
+            return await bounded(fetcher(url, { ...init, signal: budget.signal, credentials: "omit" }).then((response) => {
+                if (budget.signal.aborted) {
+                    void response.body?.cancel().catch(() => { });
+                    fail(abortCode(budget));
+                }
+                return response;
+            }), budget);
+        }
+        catch (error) {
+            if (budget.signal.aborted)
+                fail(abortCode(budget));
+            throw new AgentMailReceivingError(safeCode(error));
+        }
+    }
+    async function api(path, method, budget, payload) {
+        const response = await request(`${API_ORIGIN}${path}`, {
+            method, redirect: "error", headers: { Authorization: `Bearer ${key}`, Accept: "application/json", ...(payload === undefined ? {} : { "Content-Type": "application/json" }) },
+            ...(payload === undefined ? {} : { body: JSON.stringify(payload) }),
+        }, budget);
+        const bytes = await bodyBytes(response, budget, AGENTMAIL_RECEIVING_LIMITS.responseBytes);
+        let body = null;
+        if (bytes.length) {
+            try {
+                body = JSON.parse(bytes.toString("utf8"));
+            }
+            catch {
+                if (response.ok)
+                    fail("agentmail_invalid_response");
+            }
+        }
+        return { status: response.status, body };
+    }
+    async function download(rawUrl, budget) {
+        if (typeof rawUrl !== "string" || rawUrl.length > 16_384)
+            fail("agentmail_download_blocked");
+        let url;
+        try {
+            url = new URL(rawUrl);
+        }
+        catch {
+            return fail("agentmail_download_blocked");
+        }
+        for (let redirect = 0; redirect <= AGENTMAIL_RECEIVING_LIMITS.downloadRedirects; redirect++) {
+            // Exact origin established by live capture. No inferred S3 wildcard and no email-body fetches.
+            if (url.origin !== DOWNLOAD_ORIGIN || url.username || url.password || url.hash)
+                fail("agentmail_download_blocked");
+            const response = await request(url.href, { method: "GET", redirect: "manual" }, budget);
+            if ([301, 302, 303, 307, 308].includes(response.status)) {
+                void response.body?.cancel().catch(() => { });
+                const next = response.headers.get("location");
+                if (!next || redirect === AGENTMAIL_RECEIVING_LIMITS.downloadRedirects)
+                    fail("agentmail_download_blocked");
+                try {
+                    url = new URL(next, url);
+                }
+                catch {
+                    return fail("agentmail_download_blocked");
+                }
+                continue;
+            }
+            if (!response.ok) {
+                void response.body?.cancel().catch(() => { });
+                fail("agentmail_unavailable");
+            }
+            return bodyBytes(response, budget, MAX_INLINE_IMAGE_BYTES);
+        }
+        return fail("agentmail_download_blocked");
+    }
+    async function getMessage(lease, id, budget) {
+        const raw = success(await api(messagePath(lease, id), "GET", budget));
+        if (raw.inbox_id !== lease.resourceId || raw.message_id !== id || !Array.isArray(raw.labels) || !raw.labels.includes("received"))
+            fail("agentmail_ownership_mismatch");
+        const limitations = [];
+        const from = limitedText(raw.from, limitations);
+        if (!from)
+            fail("agentmail_invalid_response");
+        const text = limitedText(raw.text, limitations) ?? "";
+        const html = limitedText(raw.html, limitations);
+        const subject = limitedText(raw.subject, limitations);
+        const message = { channel: "email", providerMessageId: id, from, text, ...(html === undefined ? {} : { html }), ...(subject === undefined ? {} : { subject }), inlineImages: [], limitations };
+        if (!text && !html)
+            limitations.push("agentmail_content_missing");
+        if (typeof raw.timestamp === "string" && raw.timestamp.length <= 64 && Number.isFinite(Date.parse(raw.timestamp)))
+            message.providerTimestamp = new Date(raw.timestamp).toISOString();
+        else
+            limitations.push("agentmail_timestamp_missing");
+        if (raw.attachments !== undefined && !Array.isArray(raw.attachments))
+            fail("agentmail_invalid_response");
+        const attachments = (raw.attachments ?? []);
+        if (attachments.length > MAX_INLINE_IMAGES)
+            limitations.push("agentmail_attachment_limit");
+        let imageBytes = 0;
+        for (const item of attachments.slice(0, MAX_INLINE_IMAGES)) {
+            try {
+                const attachment = object(item);
+                if (attachment.content_disposition !== "inline" || !["image/png", "image/jpeg", "image/gif", "image/webp"].includes(String(attachment.content_type))) {
+                    limitations.push("agentmail_attachment_unsupported");
+                    continue;
+                }
+                const attachmentId = identifier(attachment.attachment_id);
+                const cid = identifier(attachment.content_id).replace(/^<|>$/g, "");
+                if (cid.length > 256)
+                    fail("agentmail_invalid_response");
+                if (typeof attachment.size !== "number" || !Number.isSafeInteger(attachment.size) || attachment.size <= 0 || attachment.size > MAX_INLINE_IMAGE_BYTES || imageBytes + attachment.size > MAX_INLINE_IMAGES_BYTES)
+                    fail("agentmail_size_limit");
+                const descriptor = success(await api(`${messagePath(lease, id)}/attachments/${encodeURIComponent(attachmentId)}`, "GET", budget));
+                if (descriptor.attachment_id !== attachmentId || descriptor.content_type !== attachment.content_type || descriptor.content_id !== attachment.content_id || descriptor.size !== attachment.size)
+                    fail("agentmail_invalid_response");
+                const bytes = await download(descriptor.download_url, budget);
+                if (bytes.length !== attachment.size || imageBytes + bytes.length > MAX_INLINE_IMAGES_BYTES)
+                    fail("agentmail_size_limit");
+                const image = { contentId: cid, contentType: String(attachment.content_type), base64: bytes.toString("base64") };
+                if (!inlineImageData(image))
+                    fail("agentmail_invalid_response");
+                imageBytes += bytes.length;
+                message.inlineImages.push(image);
+            }
+            catch (error) {
+                const code = safeCode(error);
+                if (code === "agentmail_cancelled")
+                    throw error;
+                limitations.push(code, "agentmail_attachment_unavailable");
+                if (budget.signal.aborted || budget.bytes >= AGENTMAIL_RECEIVING_LIMITS.operationBytes || budget.requests >= AGENTMAIL_RECEIVING_LIMITS.requests)
+                    break;
+            }
+        }
+        message.limitations = [...new Set(limitations)];
+        return message;
+    }
+    return {
+        provider: "agentmail",
+        authenticate: (context) => operation(context, async (budget) => {
+            const raw = success(await api("/v0/auth/me", "GET", budget));
+            if (raw.scope_type !== "organization" && raw.scope_type !== "pod" && raw.scope_type !== "inbox")
+                fail("agentmail_invalid_response");
+            return { provider: "agentmail", accountId: identifier(raw.organization_id), scopeType: raw.scope_type, scopeId: identifier(raw.scope_id) };
+        }),
+        acquire: (clientId, context) => operation(context, async (budget) => {
+            inputId(clientId);
+            for (let attempt = 0; attempt < 2; attempt++) {
+                try {
+                    const raw = success(await api("/v0/inboxes", "POST", budget, { client_id: clientId }));
+                    const lease = { resourceId: identifier(raw.inbox_id), address: identifier(raw.email), clientId };
+                    if (raw.client_id !== clientId)
+                        fail("agentmail_ownership_mismatch");
+                    if (!/^[^@\s]+@[^@\s]+\.[^@\s]+$/.test(lease.address))
+                        fail("agentmail_invalid_response");
+                    return lease;
+                }
+                catch (error) {
+                    if (attempt || !transient(safeCode(error)) || budget.signal.aborted)
+                        throw error;
+                }
+            }
+            return fail("agentmail_unavailable");
+        }),
+        read: (lease, context) => operation(context, async (budget) => {
+            checkLease(lease);
+            const batch = { messages: [], complete: true, limitations: [] };
+            const ids = new Set();
+            const tokens = new Set();
+            let token;
+            for (let page = 0; page < AGENTMAIL_RECEIVING_LIMITS.pages; page++) {
+                try {
+                    const query = new URLSearchParams({ limit: String(AGENTMAIL_RECEIVING_LIMITS.pageSize), labels: "received", ...(token === undefined ? {} : { page_token: token }) });
+                    const raw = success(await api(`${inboxPath(lease)}/messages?${query}`, "GET", budget));
+                    if (!Array.isArray(raw.messages) || raw.messages.length > AGENTMAIL_RECEIVING_LIMITS.pageSize)
+                        fail("agentmail_invalid_response");
+                    for (const item of raw.messages) {
+                        const entry = object(item);
+                        if (entry.inbox_id !== lease.resourceId)
+                            fail("agentmail_ownership_mismatch");
+                        if (!Array.isArray(entry.labels))
+                            fail("agentmail_invalid_response");
+                        if (!entry.labels.includes("received"))
+                            continue;
+                        const id = identifier(entry.message_id);
+                        if (ids.has(id))
+                            continue;
+                        if (ids.size >= AGENTMAIL_RECEIVING_LIMITS.messages)
+                            fail("agentmail_size_limit");
+                        ids.add(id);
+                        try {
+                            const message = await getMessage(lease, id, budget);
+                            batch.messages.push(message);
+                            if (message.limitations.length) {
+                                batch.complete = false;
+                                batch.limitations.push(...message.limitations);
+                            }
+                        }
+                        catch (error) {
+                            if (safeCode(error) === "agentmail_cancelled")
+                                throw error;
+                            batch.complete = false;
+                            batch.limitations.push(safeCode(error), "agentmail_message_unavailable");
+                            if (budget.signal.aborted || budget.bytes >= AGENTMAIL_RECEIVING_LIMITS.operationBytes || budget.requests >= AGENTMAIL_RECEIVING_LIMITS.requests)
+                                throw error;
+                        }
+                    }
+                    if (raw.next_page_token === undefined || raw.next_page_token === null || raw.next_page_token === "")
+                        break;
+                    token = identifier(raw.next_page_token);
+                    if (tokens.has(token)) {
+                        batch.complete = false;
+                        batch.limitations.push("agentmail_pagination_stalled");
+                        break;
+                    }
+                    tokens.add(token);
+                    if (page + 1 === AGENTMAIL_RECEIVING_LIMITS.pages) {
+                        batch.complete = false;
+                        batch.limitations.push("agentmail_page_limit");
+                    }
+                }
+                catch (error) {
+                    if (safeCode(error) === "agentmail_cancelled")
+                        throw error;
+                    batch.complete = false;
+                    batch.limitations.push(safeCode(error));
+                    break;
+                }
+            }
+            batch.limitations = [...new Set(batch.limitations)];
+            return batch;
+        }),
+        release: (lease, context) => operation(context, async (budget) => {
+            checkLease(lease);
+            const before = await api(inboxPath(lease), "GET", budget);
+            const existing = absentOrDeleting(before);
+            if (existing)
+                return { status: existing };
+            assertOwnership(success(before), lease);
+            const deleted = await api(inboxPath(lease), "DELETE", budget);
+            const state = absentOrDeleting(deleted);
+            if (state)
+                return { status: state };
+            if (![200, 202, 204].includes(deleted.status))
+                statusError(deleted);
+            try {
+                const after = await api(inboxPath(lease), "GET", budget);
+                const result = absentOrDeleting(after);
+                if (result)
+                    return { status: result };
+                assertOwnership(success(after), lease);
+                return { status: "deleting" };
+            }
+            catch (error) {
+                if (transient(safeCode(error)))
+                    return { status: "deleting" };
+                throw error;
+            }
+        }),
+    };
+}
+//# sourceMappingURL=comms-agentmail.js.map

package/dist/comms-agentmail.js.map

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

package/dist/comms-connections.d.ts

@@ -0,0 +1,52 @@
+import { type KeyResolutionDeps } from "./key-resolution.js";
+import type { CommsCheckResult } from "./comms-setup.js";
+export declare const COMMS_CONNECTIONS_SCHEMA = "humanish.comms-connections.v1";
+export declare const COMMS_CONFIG_PATH = ".humanish/local/comms.yaml";
+export declare const COMMS_PROVIDERS: readonly [{
+    readonly id: "agentmail";
+    readonly label: "AgentMail";
+    readonly channel: "email";
+    readonly keyEnv: "AGENTMAIL_API_KEY";
+    readonly setupAvailable: true;
+    readonly receivingAvailable: true;
+    readonly description: "A hosted email service with real inbox addresses.";
+    readonly setupUrl: "https://console.agentmail.to";
+    readonly limitation: "Fresh real inboxes for supported computer-use studies. Hosted processing; local evidence review only. Provider charges are separate.";
+}];
+export interface CommsConnection {
+    provider: "agentmail";
+    apiKeyEnv: string;
+}
+export interface CommsConnections {
+    schema: typeof COMMS_CONNECTIONS_SCHEMA;
+    connections: Record<string, CommsConnection>;
+}
+export interface CommsSetupStatus {
+    authentication?: CommsCheckResult;
+    schema: "humanish.comms-setup.v1";
+    ok: boolean;
+    configPath: string;
+    providers: typeof COMMS_PROVIDERS;
+    connections: {
+        name: string;
+        provider: "agentmail";
+        apiKeyEnv: string;
+    }[];
+    credential: {
+        present: boolean;
+        source: string | null;
+        stored: boolean;
+        strict: boolean;
+        explicitlyEmpty: boolean;
+    };
+    message: string;
+}
+export interface CommsSetupResult {
+    ok: boolean;
+    message: string;
+}
+/** Offline and non-mutating. Unsafe storage is an error, never an empty configuration. */
+export declare function readCommsConnections(cwd: string): Promise<CommsConnections>;
+/** Add one exact profile. No lab mutation, network, provider resources or credential values. */
+export declare function saveCommsConnection(cwd: string, name?: string, apiKeyEnv?: string): Promise<CommsSetupResult>;
+export declare function readCommsSetup(cwd: string, env: NodeJS.ProcessEnv, deps?: KeyResolutionDeps): Promise<CommsSetupStatus>;