@neta-art/cohub-cli 9.1.0 → 9.1.2

package/dist/commands/me.js

@@ -1,5 +1,6 @@
 import { createClient } from "../client.js";
 import { formatLocalDateTime, handleHttp, json as outJson, jsonRequested, table } from "../output.js";
+import { SESSION_STATUS_COLUMN } from "../session-status.js";
 function parseInteger(value, name, min) {
     const parsed = Number.parseInt(value, 10);
     if (!Number.isSafeInteger(parsed) || parsed < min) {
@@ -34,6 +35,7 @@ export function registerMe(program) {
                 { key: "id", label: "ID" },
                 { key: "spaceId", label: "Space" },
                 { key: "title", label: "Title" },
+                SESSION_STATUS_COLUMN,
                 { key: "totalMessages", label: "Messages" },
                 { key: "createdAt", label: "Created" },
             ]);

package/dist/commands/spaces.js

@@ -4,6 +4,7 @@ import { readSentTurns, readSessionTurnOrigin, resolveCohubEnvironment } from "@
 import { uploadAvatarAsset, uploadChatImageAsset } from "../avatar.js";
 import { createClient } from "../client.js";
 import { table, json as outJson, jsonRequested, ok, error, handleHttp, formatEpochMs, truncateText } from "../output.js";
+import { SESSION_STATUS_COLUMN } from "../session-status.js";
 import { resolveSpace } from "../space.js";
 import { uploadLocalFiles } from "../space-files/upload.js";
 import { registerSpaceCommerce } from "./space-commerce.js";
@@ -1329,6 +1330,7 @@ function registerSessions(spacesCmd) {
             table(result.sessions, [
                 { key: "id", label: "ID" },
                 { key: "title", label: "Title" },
+                SESSION_STATUS_COLUMN,
                 { key: "totalMessages", label: "Messages" },
                 { key: "createdAt", label: "Created" },
             ]);
@@ -1376,6 +1378,7 @@ function registerSessions(spacesCmd) {
             table([result.session], [
                 { key: "id", label: "ID" },
                 { key: "title", label: "Title" },
+                SESSION_STATUS_COLUMN,
                 { key: "totalMessages", label: "Messages" },
                 { key: "totalToolCalls", label: "Tool Calls" },
                 { key: "createdAt", label: "Created" },

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/harness.js

@@ -2,7 +2,7 @@ import { access, stat } from "node:fs/promises";
 import { constants } from "node:fs";
 import { delimiter, join, resolve, win32 } from "node:path";
 import { JsonRpcProcess, record } from "./json-rpc.js";
-import { codexModelCatalog } from "./model-catalog.js";
+import { codexModelCatalog, piModelCatalog } from "./model-catalog.js";
 import { downloadPublicImage } from "../safe-remote-image.js";
 export function harnessExecutableCandidates(binary, cwd, path, platform = process.platform, pathExt = process.env.PATHEXT) {
     const windows = platform === "win32";
@@ -68,11 +68,8 @@ export async function discoverHarnesses(harnesses, options, cwd) {
         try {
             if (harness === "pi") {
                 const result = await rpc.request("get_available_models");
-                for (const value of array(result.models)) {
-                    const model = record(value);
-                    if (model.id && model.provider)
-                        models.push({ harness, id: text(model.id), provider: text(model.provider), name: text(model.name) || text(model.id) });
-                }
+                const state = await rpc.request("get_state");
+                models.push(...piModelCatalog(array(result.models), state));
             }
             else {
                 await initializeCodex(rpc);

package/dist/runtime/model-catalog.d.ts

@@ -1,6 +1,14 @@
 import type { RuntimeCapabilities } from "@neta-art/cohub";
 import { type JsonRecord } from "./json-rpc.js";
 type Model = RuntimeCapabilities["models"][number];
+/**
+ * Publish only picker metadata, never provider credentials or request configuration.
+ * `state` is a fresh Pi's `get_state`: its model is what Pi runs when Cohub requests
+ * nothing, and its level is resolved and clamped for that model only. Pi's levels for
+ * other models live in its settings, which RPC does not expose; those models fall back
+ * to the picker's rule, and Cohub always sends the chosen level explicitly.
+ */
+export declare function piModelCatalog(entries: unknown[], state: JsonRecord): Model[];
 /** Codex's built-in catalog is not authoritative for an arbitrary custom provider. */
 export declare function codexModelCatalog(configResponse: JsonRecord, entries: unknown[]): Model[];
 export {};

package/dist/runtime/model-catalog.js

@@ -1,4 +1,50 @@
 import { record } from "./json-rpc.js";
+const thinkingLevels = ["off", "minimal", "low", "medium", "high", "xhigh", "max"];
+const thinkingLevel = (value) => thinkingLevels.includes(value) ? value : undefined;
+/**
+ * Publish only picker metadata, never provider credentials or request configuration.
+ * `state` is a fresh Pi's `get_state`: its model is what Pi runs when Cohub requests
+ * nothing, and its level is resolved and clamped for that model only. Pi's levels for
+ * other models live in its settings, which RPC does not expose; those models fall back
+ * to the picker's rule, and Cohub always sends the chosen level explicitly.
+ */
+export function piModelCatalog(entries, state) {
+    const current = record(state.model);
+    const currentLevel = thinkingLevel(state.thinkingLevel);
+    return entries.flatMap((value) => {
+        const model = record(value);
+        if (typeof model.id !== "string" || !model.id || typeof model.provider !== "string" || !model.provider)
+            return [];
+        const map = record(model.thinkingLevelMap);
+        const thinkingLevelMap = Object.fromEntries(thinkingLevels.flatMap((level) => map[level] === null || typeof map[level] === "string" ? [[level, map[level]]] : []));
+        const isDefault = current.provider === model.provider && current.id === model.id;
+        return [{
+                harness: "pi", id: model.id, provider: model.provider, name: typeof model.name === "string" ? model.name : model.id,
+                ...(isDefault ? { isDefault } : {}),
+                ...(typeof model.reasoning === "boolean" ? { reasoning: model.reasoning } : {}),
+                ...(isDefault && currentLevel ? { defaultThinkingLevel: currentLevel } : {}),
+                ...(Object.keys(thinkingLevelMap).length ? { thinkingLevelMap } : {}),
+            }];
+    });
+}
+function codexThinking(model, configuredEffort) {
+    if (!Array.isArray(model.supportedReasoningEfforts))
+        return {};
+    const efforts = new Set(model.supportedReasoningEfforts.map((entry) => record(entry).reasoningEffort));
+    const thinkingLevelMap = Object.fromEntries(thinkingLevels.map((level) => {
+        const effort = level === "off" ? "none" : level;
+        return [level, efforts.has(effort) ? effort : null];
+    }));
+    const normalize = (value) => thinkingLevel(value === "none" ? "off" : value);
+    const configured = normalize(configuredEffort);
+    const fallback = normalize(model.defaultReasoningEffort);
+    const defaultThinkingLevel = [configured, fallback].find((level) => level && thinkingLevelMap[level] != null);
+    return {
+        reasoning: thinkingLevels.some((level) => level !== "off" && thinkingLevelMap[level] != null),
+        thinkingLevelMap,
+        ...(defaultThinkingLevel ? { defaultThinkingLevel } : {}),
+    };
+}
 /** Codex's built-in catalog is not authoritative for an arbitrary custom provider. */
 export function codexModelCatalog(configResponse, entries) {
     const config = record(configResponse.config);
@@ -11,9 +57,11 @@ export function codexModelCatalog(configResponse, entries) {
         const id = typeof model.model === "string" ? model.model : typeof model.id === "string" ? model.id : null;
         if (!id || model.hidden)
             return [];
-        return [{ harness: "codex", provider, id, name: typeof model.displayName === "string" ? model.displayName : id }];
+        // A configured model replaces the catalog's own default.
+        const isDefault = configuredModel ? id === configuredModel : model.isDefault === true;
+        return [{ harness: "codex", provider, id, name: typeof model.displayName === "string" ? model.displayName : id, ...(isDefault ? { isDefault } : {}), ...codexThinking(model, config.model_reasoning_effort) }];
     });
     if (configuredModel && !models.some((model) => model.id === configuredModel))
-        models.unshift({ harness: "codex", provider, id: configuredModel, name: configuredModel });
+        models.unshift({ harness: "codex", provider, id: configuredModel, name: configuredModel, isDefault: true });
     return models;
 }

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 };
 }
@@ -293,7 +294,7 @@ async function runCodex(executor, turn, context) {
                     escalation = setTimeout(() => void host?.close().catch(() => undefined), ABORT_ESCALATION_MS);
             };
             signal.addEventListener("abort", abort, { once: true });
-            codex.request("turn/start", { threadId, clientUserMessageId: input.turnId, input: content, ...(input.thinkingLevel ? { effort: input.thinkingLevel } : {}) })
+            codex.request("turn/start", { threadId, clientUserMessageId: input.turnId, input: content, ...(input.thinkingLevel ? { effort: input.thinkingLevel === "off" ? "none" : input.thinkingLevel } : {}) })
                 .then((result) => { nativeTurnId ??= text(record(result.turn).id) || null; if (signal.aborted)
                 interrupt(); })
                 .catch(finish);
@@ -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/dist/session-status.d.ts

@@ -0,0 +1,6 @@
+import type { SessionRecord } from "@neta-art/cohub";
+import type { Column } from "./output.js";
+type SessionStatusFields = Pick<SessionRecord, "activeTurn" | "lastTurnIssue">;
+export declare function sessionStatusText(session: Partial<SessionStatusFields>): string;
+export declare const SESSION_STATUS_COLUMN: Column;
+export {};

package/dist/session-status.js

@@ -0,0 +1,14 @@
+export function sessionStatusText(session) {
+    const turn = session.activeTurn;
+    if (turn)
+        return turn.status === "abort_requested" ? "stopping" : turn.status;
+    const issue = session.lastTurnIssue;
+    if (issue?.status === "failed")
+        return "failed";
+    return issue?.reason === "stale_active_recovered" ? "interrupted" : "";
+}
+export const SESSION_STATUS_COLUMN = {
+    key: "activeTurn",
+    label: "Status",
+    format: (_value, row) => sessionStatusText(row),
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neta-art/cohub-cli",
-  "version": "9.1.0",
+  "version": "9.1.2",
   "description": "CLI for Cohub — spaces, sessions, and agent collaboration.",
   "type": "module",
   "engines": {
@@ -18,11 +18,11 @@
     "NOTICE"
   ],
   "dependencies": {
+    "@neta-art/cohub": "10.0.0",
     "@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",