@neta-art/cohub-cli 9.1.0 → 9.1.1

package/dist/network-error.d.ts

@@ -0,0 +1,3 @@
+export declare const isFetchFailure: (error: unknown) => error is Error;
+export declare function fetchFailureReason(error: unknown): string | null;
+export declare function describeError(error: unknown): string;

package/dist/network-error.js

@@ -0,0 +1,22 @@
+const text = (value) => (typeof value === "string" && value ? value : null);
+export const isFetchFailure = (error) => error instanceof Error && error.message === "fetch failed";
+export function fetchFailureReason(error) {
+    if (!isFetchFailure(error) || typeof error.cause !== "object" || !error.cause)
+        return null;
+    const cause = error.cause;
+    const message = text(cause.message);
+    const code = text(cause.code);
+    const hostname = text(cause.hostname);
+    const parts = [
+        code && !message?.includes(code) ? code : null,
+        hostname && !message?.includes(hostname) ? `host: ${hostname}` : null,
+        message,
+    ].filter(Boolean);
+    return parts.length > 0 ? parts.join(" · ") : null;
+}
+export function describeError(error) {
+    if (!(error instanceof Error))
+        return String(error);
+    const reason = fetchFailureReason(error);
+    return reason ? `${error.message} (${reason})` : error.message;
+}

package/dist/output.js

@@ -1,5 +1,6 @@
 import process from "node:process";
 import { extractBillingPayload } from "@neta-art/cohub";
+import { fetchFailureReason, isFetchFailure } from "./network-error.js";
 /**
  * Timestamp → local ISO-style date and time with the system's UTC offset.
  *
@@ -146,16 +147,10 @@ function debugErrorMetaFromBody(body) {
     return items;
 }
 function fetchFailureDetail(e) {
-    if (!(e instanceof Error) || e.message !== "fetch failed")
+    if (!isFetchFailure(e))
         return null;
-    const cause = e.cause;
-    const code = typeof cause?.code === "string" ? cause.code : null;
-    const hostname = typeof cause?.hostname === "string" ? cause.hostname : null;
-    const message = typeof cause?.message === "string" ? cause.message : null;
-    const parts = [code, hostname && `host: ${hostname}`, message].filter(Boolean);
-    return parts.length > 0
-        ? `Network request failed (${parts.join(" · ")}). Check DNS/proxy/firewall settings and try again.`
-        : "Network request failed. Check DNS/proxy/firewall settings and try again.";
+    const reason = fetchFailureReason(e);
+    return `Network request failed${reason ? ` (${reason})` : ""}. Check DNS/proxy/firewall settings and try again.`;
 }
 function errorPresentationFromHttpError(e) {
     const httpError = e;

package/dist/runtime/connection.js

@@ -1,6 +1,7 @@
 import { randomUUID } from "node:crypto";
 import { setTimeout as delay } from "node:timers/promises";
 import { RUNTIME_MAX_FRAME_BYTES, RUNTIME_PROTOCOL_VERSION, runtimeCommandSchema, runtimeReadySchema, runtimeNativeStopSchema, } from "@neta-art/cohub";
+import { describeError } from "../network-error.js";
 import { executeTurn } from "./native/execution.js";
 import { ContextRequiredError } from "./native/results.js";
 import { ProcessCleanupUncertainError } from "./process-group.js";
@@ -579,7 +580,7 @@ async function connect(options) {
                         error: serializeDiagnosticError(error),
                     }, context);
                     try {
-                        emit({ type: "turn.error", message: error instanceof Error ? error.message : String(error), uncertain: !!execution.result || frame.resumeOnly === true || error instanceof ProcessCleanupUncertainError });
+                        emit({ type: "turn.error", message: describeError(error), uncertain: !!execution.result || frame.resumeOnly === true || error instanceof ProcessCleanupUncertainError });
                     }
                     catch {
                         // Native files remain for recovery.

package/dist/runtime/native/execution.js

@@ -1,5 +1,6 @@
 import { imageForPi } from "../harness.js";
 import { JsonRpcProcess, record, RpcProcessClosedError } from "../json-rpc.js";
+import { describeError } from "../../network-error.js";
 import { ProcessCleanupUncertainError } from "../process-group.js";
 import { serializeDiagnosticError } from "../diagnostics.js";
 import { openPrivateServer } from "./codex-link.js";
@@ -164,7 +165,7 @@ async function runPi(executor, turn, context) {
                 await closeHost(host, null).catch(() => undefined);
             throw error;
         }
-        message = { ...message, stopReason: signal.aborted ? "aborted" : "error", errorMessage: signal.aborted ? null : error instanceof Error ? error.message : String(error) };
+        message = { ...message, stopReason: signal.aborted ? "aborted" : "error", errorMessage: signal.aborted ? null : describeError(error) };
     }
     return { session, resume: prepared.resume, message, host };
 }
@@ -306,7 +307,7 @@ async function runCodex(executor, turn, context) {
                 await closeHost(host, null).catch(() => undefined);
             throw error;
         }
-        message = { ...message, stopReason: signal.aborted ? "aborted" : "error", errorMessage: signal.aborted ? null : error instanceof Error ? error.message : String(error) };
+        message = { ...message, stopReason: signal.aborted ? "aborted" : "error", errorMessage: signal.aborted ? null : describeError(error) };
     }
     return { session, resume: prepared.resume, message, host };
 }

package/dist/safe-remote-image.d.ts

@@ -1,22 +1,26 @@
+import { type LookupFunction } from "node:net";
 export declare const REMOTE_IMAGE_MAX_BYTES: number;
 export declare const REMOTE_IMAGE_TIMEOUT_MS = 15000;
 type ResolvedAddress = {
     address: string;
     family: 4 | 6;
 };
+type PinnedAddresses = readonly [ResolvedAddress, ...ResolvedAddress[]];
 type Lookup = (hostname: string) => Promise<readonly ResolvedAddress[]>;
 type RemoteResponse = {
     status: number;
     headers: Headers;
     bytes: Uint8Array;
 };
-type Requester = (url: URL, address: ResolvedAddress, timeoutMs: number, maxBytes: number) => Promise<RemoteResponse>;
+type Requester = (url: URL, addresses: PinnedAddresses, timeoutMs: number, maxBytes: number) => Promise<RemoteResponse>;
 export type RemoteImageDownloadOptions = {
     lookup?: Lookup;
     requester?: Requester;
     maxBytes?: number;
     timeoutMs?: number;
 };
+/** Async like `dns.lookup`: a synchronous answer crashes TLS on an immediate connect failure. */
+export declare function pinnedLookup(addresses: PinnedAddresses): LookupFunction;
 export declare function downloadPublicImage(input: string, options?: RemoteImageDownloadOptions): Promise<{
     bytes: Uint8Array;
     mimeType: string;

package/dist/safe-remote-image.js

@@ -34,15 +34,22 @@ function responseHeaders(input) {
     }
     return headers;
 }
-function requestPinned(url, address, timeoutMs, maxBytes) {
+/** Async like `dns.lookup`: a synchronous answer crashes TLS on an immediate connect failure. */
+export function pinnedLookup(addresses) {
+    const [first] = addresses;
+    return (_hostname, options, callback) => {
+        process.nextTick(() => options.all
+            ? callback(null, [...addresses])
+            : callback(null, first.address, first.family));
+    };
+}
+function requestPinned(url, addresses, timeoutMs, maxBytes) {
     return new Promise((resolve, reject) => {
         const client = url.protocol === "https:" ? https : http;
         const request = client.request(url, {
             agent: false,
             headers: { Accept: "image/avif,image/webp,image/png,image/jpeg,image/gif" },
-            lookup: (_hostname, _options, callback) => {
-                callback(null, address.address, address.family);
-            },
+            lookup: pinnedLookup(addresses),
         }, (response) => {
             const status = response.statusCode ?? 0;
             const headers = responseHeaders(response.headers);
@@ -116,11 +123,12 @@ async function resolvePublicUrl(value, lookup, deadline) {
     const addresses = isIP(hostname)
         ? [{ address: hostname, family: isIP(hostname) }]
         : await withDeadline(lookup(hostname), deadline);
-    if (addresses.length === 0 ||
+    const [first, ...rest] = addresses;
+    if (!first ||
         addresses.some((entry) => !isPublicBoardRemoteAddress(entry.address))) {
         throw new Error("Image URL resolves to a private address");
     }
-    return { url, address: addresses[0] };
+    return { url, addresses: [first, ...rest] };
 }
 export async function downloadPublicImage(input, options = {}) {
     const lookup = options.lookup ?? defaultLookup;
@@ -129,8 +137,8 @@ export async function downloadPublicImage(input, options = {}) {
     const deadline = Date.now() + (options.timeoutMs ?? REMOTE_IMAGE_TIMEOUT_MS);
     let current = input;
     for (let redirect = 0; redirect <= MAX_REDIRECTS; redirect += 1) {
-        const { url, address } = await resolvePublicUrl(current, lookup, deadline);
-        const response = await withDeadline(requester(url, address, remainingMs(deadline), maxBytes), deadline);
+        const { url, addresses } = await resolvePublicUrl(current, lookup, deadline);
+        const response = await withDeadline(requester(url, addresses, remainingMs(deadline), maxBytes), deadline);
         if (REDIRECT_STATUSES.has(response.status)) {
             const location = response.headers.get("location");
             if (!location)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neta-art/cohub-cli",
-  "version": "9.1.0",
+  "version": "9.1.1",
   "description": "CLI for Cohub — spaces, sessions, and agent collaboration.",
   "type": "module",
   "engines": {
@@ -18,11 +18,11 @@
     "NOTICE"
   ],
   "dependencies": {
+    "@neta-art/cohub": "9.0.1",
     "@neta-art/generation": "^0.1.30",
     "commander": "^15.0.0",
     "sharp": "^0.35.4",
-    "ws": "^8.21.3",
-    "@neta-art/cohub": "9.0.0"
+    "ws": "^8.21.3"
   },
   "publishConfig": {
     "access": "public"
@@ -30,7 +30,7 @@
   "devDependencies": {
     "@fontsource/geist": "^5.3.0",
     "@fontsource/geist-mono": "^5.3.0",
-    "@types/node": "^26.4.0",
+    "@types/node": "26.6.4",
     "@types/ws": "^8.18.1",
     "pixi.js": "^8.20.1",
     "tsdown": "^0.22.14",