humanish 0.94.0 → 0.96.0

package/dist/comms-connections.js

@@ -0,0 +1,123 @@
+import { constants } from "node:fs";
+import { lstat, open, unlink } from "node:fs/promises";
+import path from "node:path";
+import { parse, stringify } from "yaml";
+import { listUserKeys, probeKeySources } from "./key-resolution.js";
+import { assertPreparedSelectedOutputDirectory, bindExistingManagedHumanishOutputDirectory, prepareManagedHumanishOutputDirectory, readContainedRegularFile, writeContainedOutputFile } from "./selected-output-paths.js";
+export const COMMS_CONNECTIONS_SCHEMA = "humanish.comms-connections.v1";
+export const COMMS_CONFIG_PATH = ".humanish/local/comms.yaml";
+export const COMMS_PROVIDERS = [{
+        id: "agentmail", label: "AgentMail", channel: "email", keyEnv: "AGENTMAIL_API_KEY",
+        setupAvailable: true, receivingAvailable: true,
+        description: "A hosted email service with real inbox addresses.",
+        setupUrl: "https://console.agentmail.to",
+        limitation: "Fresh real inboxes for supported computer-use studies. Hosted processing; local evidence review only. Provider charges are separate."
+    }];
+const record = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const validName = (name) => /^[a-z][a-z0-9-]{0,47}$/.test(name) && name !== "constructor" && name !== "prototype";
+const empty = () => ({ schema: COMMS_CONNECTIONS_SCHEMA, connections: {} });
+async function exists(file) {
+    try {
+        await lstat(file);
+        return true;
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return false;
+        throw error;
+    }
+}
+function parseConnections(raw) {
+    if (!record(raw) || raw.schema !== COMMS_CONNECTIONS_SCHEMA || !record(raw.connections)
+        || Object.keys(raw).some(key => key !== "schema" && key !== "connections")
+        || Object.keys(raw.connections).length > 32)
+        throw new Error("Invalid connection configuration.");
+    const connections = {};
+    for (const [name, value] of Object.entries(raw.connections)) {
+        if (!validName(name) || !record(value) || value.provider !== "agentmail"
+            || typeof value.apiKeyEnv !== "string" || !/^[A-Z][A-Z0-9_]{0,99}$/.test(value.apiKeyEnv)
+            || Object.keys(value).some(key => key !== "provider" && key !== "apiKeyEnv"))
+            throw new Error("Invalid connection configuration.");
+        connections[name] = { provider: "agentmail", apiKeyEnv: value.apiKeyEnv };
+    }
+    return { schema: COMMS_CONNECTIONS_SCHEMA, connections };
+}
+/** Offline and non-mutating. Unsafe storage is an error, never an empty configuration. */
+export async function readCommsConnections(cwd) {
+    const root = await bindExistingManagedHumanishOutputDirectory(cwd, "local");
+    if (!root) {
+        if (await exists(path.resolve(cwd, ".humanish", "local")))
+            throw new Error("Unsafe connection directory.");
+        return empty();
+    }
+    const file = path.join(root.physicalPath, "comms.yaml");
+    if (!await exists(file))
+        return empty();
+    if ((await lstat(file)).size > 65_536)
+        throw new Error("Connection configuration is too large.");
+    const bytes = await readContainedRegularFile(root, "comms.yaml");
+    if (!bytes || bytes.length > 65_536)
+        throw new Error("Cannot safely read connection configuration.");
+    // YAML diagnostics may echo the offending value; do not let them reach a status or frame.
+    try {
+        return parseConnections(parse(bytes.toString("utf8"), { maxAliasCount: 0 }));
+    }
+    catch {
+        throw new Error("Invalid connection configuration.");
+    }
+}
+/** Add one exact profile. No lab mutation, network, provider resources or credential values. */
+export async function saveCommsConnection(cwd, name = "agentmail", apiKeyEnv = "AGENTMAIL_API_KEY") {
+    try {
+        parseConnections({ schema: COMMS_CONNECTIONS_SCHEMA, connections: { [name]: { provider: "agentmail", apiKeyEnv } } });
+        // Read before creating storage, so malformed or redirected existing configuration fails first.
+        await readCommsConnections(cwd);
+        const root = await prepareManagedHumanishOutputDirectory(cwd, "local");
+        const lockPath = path.join(root.physicalPath, ".comms-setup.lock");
+        const lock = await open(lockPath, constants.O_CREAT | constants.O_EXCL | constants.O_WRONLY | constants.O_NOFOLLOW, 0o600);
+        const identity = await lock.stat();
+        try {
+            await assertPreparedSelectedOutputDirectory(root);
+            const config = await readCommsConnections(cwd);
+            const previous = config.connections[name];
+            if (previous && (previous.provider !== "agentmail" || previous.apiKeyEnv !== apiKeyEnv)) {
+                return { ok: false, message: "That connection name already uses different settings. Choose another name." };
+            }
+            config.connections[name] = { provider: "agentmail", apiKeyEnv };
+            parseConnections(config);
+            await writeContainedOutputFile(root, "comms.yaml", stringify(config), "utf8");
+            return { ok: true, message: "Connection saved for this project. Select it in a supported lab to use fresh real inboxes." };
+        }
+        finally {
+            await lock.close();
+            await assertPreparedSelectedOutputDirectory(root);
+            const current = await lstat(lockPath);
+            if (current.dev === identity.dev && current.ino === identity.ino)
+                await unlink(lockPath);
+        }
+    }
+    catch (error) {
+        return { ok: false, message: error.code === "EEXIST"
+                ? "Connection setup is locked. Close another setup session; after an interrupted save, remove .humanish/local/.comms-setup.lock and retry."
+                : "Could not save the connection. Inspect .humanish/local/comms.yaml and its directory permissions before retrying." };
+    }
+}
+export async function readCommsSetup(cwd, env, deps) {
+    const base = { schema: "humanish.comms-setup.v1", configPath: COMMS_CONFIG_PATH, providers: COMMS_PROVIDERS };
+    const credential = { present: false, source: null, stored: false,
+        strict: env.HUMANISH_STRICT_KEYS?.trim() === "1", explicitlyEmpty: env.AGENTMAIL_API_KEY !== undefined && env.AGENTMAIL_API_KEY.trim() === "" };
+    try {
+        const config = await readCommsConnections(cwd);
+        const [probe] = await probeKeySources(["AGENTMAIL_API_KEY"], { cwd, env, ...(deps ? { deps } : {}) });
+        credential.source = probe?.source ?? null;
+        credential.present = credential.source !== null;
+        credential.stored = listUserKeys(env, deps).includes("AGENTMAIL_API_KEY");
+        return { ...base, ok: true, connections: Object.entries(config.connections).map(([name, value]) => ({ name, ...value })), credential,
+            message: "Checks are local. Authentication, permissions, capacity and delivery have not been verified." };
+    }
+    catch {
+        return { ...base, ok: false, connections: [], credential,
+            message: "Could not read connection setup. Check .humanish/local/comms.yaml and key-store permissions. No changes were made." };
+    }
+}
+//# sourceMappingURL=comms-connections.js.map

package/dist/comms-connections.js.map

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

package/dist/comms-lease-store.d.ts

@@ -0,0 +1,90 @@
+import type { ReceivingIdentity, ReceivingLease } from "./comms-receiving-types.js";
+declare const SCHEMA = "humanish.comms-lease-journal.v1";
+type PhysicalIdentity = {
+    path: string;
+    dev: number;
+    ino: number;
+};
+type Owner = {
+    pid: number;
+    host: string;
+    token: string;
+    active: boolean;
+};
+export type CommsLeaseState = "planned" | "intent" | "active" | "closing" | "not-created" | "absent" | "deleting" | "unresolved";
+export interface CommsLeaseRecord {
+    participantId: string;
+    leaseId: string;
+    clientId: string;
+    ownership: "fresh";
+    state: CommsLeaseState;
+    lease?: ReceivingLease;
+}
+export interface CommsLeaseJournal {
+    schema: typeof SCHEMA;
+    project: PhysicalIdentity;
+    runId: string;
+    incarnation: string;
+    connectionName: string;
+    apiKeyEnv: string;
+    identity: ReceivingIdentity;
+    owner: Owner;
+    state: "active" | "closed" | "unresolved";
+    createdAt: string;
+    updatedAt: string;
+    leases: CommsLeaseRecord[];
+}
+export interface CommsRecoveryEntry {
+    id: string;
+    runId: string;
+    connectionName: string;
+    status: "active" | "closed" | "unresolved";
+    participantCount: number;
+    unresolvedCount: number;
+    activeOwner: boolean | null;
+}
+export declare class CommsAuthorityError extends Error {
+    readonly code: "authority_unavailable" | "authority_changed" | "owner_active" | "owner_unknown" | "binding_mismatch";
+    constructor(code: "authority_unavailable" | "authority_changed" | "owner_active" | "owner_unknown" | "binding_mismatch");
+}
+export declare function sameReceivingIdentity(a: ReceivingIdentity, b: ReceivingIdentity): boolean;
+export declare function validReceivingIdentity(value: unknown): value is ReceivingIdentity;
+export declare function validReceivingLease(value: unknown, clientId: string): value is ReceivingLease;
+export declare class CommsLeaseStore {
+    private readonly dir;
+    private readonly name;
+    private readonly lock;
+    private journal;
+    private text;
+    private serial;
+    private released;
+    private constructor();
+    snapshot(): CommsLeaseJournal;
+    assertOwnership(): Promise<void>;
+    private update;
+    bind(participantId: string, lease: ReceivingLease): Promise<void>;
+    setState(participantId: string, state: CommsLeaseState): Promise<void>;
+    close(): Promise<void>;
+    releaseLock(): Promise<void>;
+    static create(options: {
+        cwd: string;
+        runId: string;
+        connectionName: string;
+        apiKeyEnv: string;
+        identity: ReceivingIdentity;
+        participants: string[];
+        stateDir?: string;
+    }): Promise<CommsLeaseStore>;
+    static recover(options: {
+        cwd: string;
+        runId: string;
+        connectionName: string;
+        apiKeyEnv: string;
+        stateDir?: string;
+    }): Promise<CommsLeaseStore>;
+}
+export declare function inspectCommsLeaseStore(options: {
+    cwd: string;
+    stateDir?: string;
+}): Promise<CommsRecoveryEntry[]>;
+export {};