humanish 0.95.0 → 0.96.1

package/dist/comms-setup.js

@@ -0,0 +1,121 @@
+import { createHash } from "node:crypto";
+import { constants } from "node:fs";
+import { lstat, open, unlink } from "node:fs/promises";
+import path from "node:path";
+import { parse, stringify } from "yaml";
+import { readCommsConnections } from "./comms-connections.js";
+import { discoverProviderKeys } from "./key-resolution.js";
+import { AgentMailReceivingError, createAgentMailReceiver } from "./comms-agentmail.js";
+import { parseLabConfig } from "./lab-config.js";
+import { resolveLabManifest } from "./labs.js";
+import { assertPreparedSelectedOutputDirectory, prepareManagedHumanishOutputDirectory, prepareSelectedOutputDirectory, readContainedRegularFile, writeContainedOutputFile } from "./selected-output-paths.js";
+export async function checkCommsConnection(args) {
+    const base = { schema: "humanish.comms-check.v1", ok: false,
+        connection: args.connection ?? "agentmail", online: args.online === true,
+        credentialPresent: false, authenticated: null, ready: null, permissions: "unknown", capacity: "unknown",
+        checkedAt: null, code: "configuration_unavailable", message: "Could not read this email connection. Check Connections or .humanish/local/comms.yaml." };
+    try {
+        const connection = (await readCommsConnections(args.cwd)).connections[base.connection];
+        if (!connection)
+            return { ...base, ready: false, code: "connection_missing", message: "Save an AgentMail connection in Connections first." };
+        const env = { ...args.env };
+        await discoverProviderKeys({ cwd: args.cwd, env, announce: () => { } });
+        const key = env[connection.apiKeyEnv]?.trim();
+        if (!key)
+            return { ...base, ready: false, code: "credential_missing", message: "The configured credential is missing. Add it in Connections or provide it with --env-file." };
+        base.credentialPresent = true;
+        if (!args.online)
+            return { ...base, ok: true, code: "local_setup_present", message: "Connection and key are present. Authentication, permissions, capacity and delivery are not checked. Use --online for a read-only authentication check." };
+        base.checkedAt = new Date().toISOString();
+        const identity = await (args.makeAdapter ?? (apiKey => createAgentMailReceiver({ apiKey })))(key).authenticate({ timeoutMs: 8_000 });
+        if (identity.scopeType !== "organization")
+            return { ...base, ready: false, authenticated: true, code: "scope_unsupported", message: "Authenticated, but this release requires an organization-scoped key to acquire fresh inboxes." };
+        return { ...base, ok: true, authenticated: true, code: "authenticated", message: "Authentication passed. Inbox permissions, available capacity and delivery remain untested; this check created no resources." };
+    }
+    catch (error) {
+        const code = error instanceof AgentMailReceivingError ? error.code : "check_unavailable";
+        const rejected = code === "agentmail_auth_rejected";
+        return { ...base, code, ...(rejected ? { authenticated: false, ready: false } : {}),
+            message: rejected ? "AgentMail rejected this credential or its permissions. Check the effective key source and replace it if needed. The saved key was kept."
+                : "The connection check could not complete. The saved key was kept; retry when the provider is available." };
+    }
+}
+export async function receivingRequiredKey(cwd, connectionName) {
+    try {
+        return (await readCommsConnections(cwd)).connections[connectionName]?.apiKeyEnv ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Save a local copy, never rewrite a committed manifest or silently shadow it by handle. */
+export async function configureCommsLab(args) {
+    const base = { schema: "humanish.comms-configure.v1", ok: false, applied: false };
+    try {
+        if (!(await readCommsConnections(args.cwd)).connections[args.connection])
+            return { ...base, message: "Save the selected connection first." };
+        const source = await resolveLabManifest(args.cwd, args.lab);
+        if (!source.ok)
+            return { ...base, message: "The selected lab could not be read safely." };
+        const root = await prepareSelectedOutputDirectory(args.cwd, args.cwd);
+        const rel = path.relative(root.requestedPath, path.resolve(args.cwd, source.path)).replace(/\\/g, "/");
+        const bytes = await readContainedRegularFile(root, rel);
+        if (!bytes || bytes.length > 1024 * 1024)
+            return { ...base, message: "The lab is missing or too large." };
+        const raw = parse(bytes.toString("utf8"));
+        if (!raw || typeof raw !== "object" || Array.isArray(raw))
+            return { ...base, message: "The lab must be a mapping." };
+        const lab = raw;
+        const existing = lab.comms;
+        if (existing?.email && existing.email.connection === undefined)
+            return { ...base, message: "This lab uses local capture. Preserve it or make a separate lab before selecting real email." };
+        lab.comms = { ...(existing ?? {}), email: { ...existing?.email, connection: args.connection } };
+        const validated = parseLabConfig(lab);
+        if (!validated.ok)
+            return { ...base, message: "This lab does not support real email receiving. Use a hosted computer-use app-url, clone or local-tree route; shared-world must be concurrent." };
+        const filename = path.basename(source.path).replace(/\.ya?ml$/, "").replace(/-receiving$/, "") + "-receiving.yaml";
+        if (!/^[A-Za-z0-9_][A-Za-z0-9._-]{0,110}\.yaml$/.test(filename))
+            return { ...base, message: "Use a simple lab filename before configuring email." };
+        const destination = `.humanish/local/labs/${filename}`;
+        if (rel === destination)
+            return { ...base, message: "This is already the local receiving copy. Select its original lab to configure a separate copy, or edit this manifest directly." };
+        let prior;
+        try {
+            prior = await readContainedRegularFile(root, destination);
+        }
+        catch {
+            return { ...base, message: "The local destination could not be read safely." };
+        }
+        const content = stringify(lab);
+        const token = createHash("sha256").update(bytes).update("\0").update(prior ?? "missing").update("\0").update(destination).update("\0").update(args.connection).digest("hex");
+        const plan = { ...base, ok: true, path: destination, planToken: token, connection: args.connection,
+            message: `Save ${destination} with fresh AgentMail inboxes. Email is hosted; actor and analysis models may see content. Recordings require local review and cannot be automatically published. Provider charges are separate. Launch this exact path.` };
+        if (!args.apply)
+            return plan;
+        if (args.planToken !== undefined && args.planToken !== token)
+            return { ...base, message: "The lab or destination changed since preview. Preview again before saving." };
+        const directory = await prepareManagedHumanishOutputDirectory(args.cwd, "local", "labs");
+        const lockPath = path.join(directory.physicalPath, ".comms-configure.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 {
+            const currentSource = await readContainedRegularFile(root, rel);
+            const currentDestination = await readContainedRegularFile(root, destination);
+            if (!currentSource?.equals(bytes) || (prior === null ? currentDestination !== null : !currentDestination?.equals(prior)))
+                return { ...base, message: "Files changed while saving. Preview again." };
+            await writeContainedOutputFile(directory, filename, content, "utf8");
+        }
+        finally {
+            await lock.close();
+            await assertPreparedSelectedOutputDirectory(directory);
+            const current = await lstat(lockPath);
+            if (current.dev === identity.dev && current.ino === identity.ino)
+                await unlink(lockPath);
+        }
+        return { ...plan, applied: true, message: `Saved ${destination}. Start that exact lab path; the original manifest was preserved.` };
+    }
+    catch {
+        return { ...base, message: "Could not configure this lab safely. Check configuration, paths and permissions; no provider resources were created." };
+    }
+}
+//# sourceMappingURL=comms-setup.js.map

package/dist/comms-setup.js.map

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