@maka/maka-cli 5.69.0 → 5.71.0

package/bundle/typescript/src/tools/ai/ai.class.d.ts

@@ -84,6 +84,77 @@ export declare class AI {
      * generation entry points; the server's token clamp is the belt.
      */
     static canGenerate(): boolean;
+    /** How much of an unparseable body to quote back. Enough to
+     *  recognize a gateway page or a captive portal, short enough that an
+     *  error line stays an error line -- a 50 KB HTML dump in the session
+     *  log is not a diagnostic. */
+    private static readonly BODY_SNIFF;
+    /**
+     * The message for a reply that was not JSON at all. There is no
+     * provider envelope to read in this case, so this says the two things
+     * that are actually known: WHO was called and WHAT the transport
+     * answered.
+     *
+     * A 502/503/504 in front of a JSON API is a gateway, not the API --
+     * the service is down or mid-deploy and the request was never seen.
+     * It gets its own wording because the alternative is a player reading
+     * "the AI refused" and going to check a login that is perfectly fine.
+     */
+    private static describeUnparseable;
+    /**
+     * The message for a request that FAILED at the HTTP level while
+     * returning perfectly well-formed JSON that simply says nothing about
+     * why (4MADSCbQMT2gzcGFW).
+     *
+     * This used to fall all the way through to the content check and come
+     * out as "No content returned from <provider>", which describes a
+     * malformed SUCCESS -- the wrong diagnosis for a request that never
+     * succeeded, with HTTP 503 sitting unread in the response the whole
+     * time. The status was only ever consulted on the relay path, and
+     * only when the body happened to carry a `message`.
+     *
+     * Same wording as the non-JSON path above, deliberately: whether the
+     * failure arrived as an nginx HTML page or as a tidy `{"detail": ...}`
+     * is not the player's problem and must not change the diagnosis.
+     */
+    private static describeHttpFailure;
+    private static providerLabel;
+    /**
+     * A 502/503/504 in front of a JSON API is a GATEWAY, not the API --
+     * the service is down or mid-deploy and the request was never seen.
+     * It gets its own wording because the alternative is a player reading
+     * "the AI refused" and going to check a login that is perfectly fine.
+     */
+    private static gatewayNote;
+    private static sniff;
+    /**
+     * What to DO about a relay failure: stop asking, and/or say it out
+     * loud once. The contract's three-line mapping, with `retryable`
+     * checked FIRST so an unrecognised future kind lands in the right
+     * bucket instead of an unknown one.
+     *
+     * `upstream_billing` stops the relay as well as raising the notice,
+     * which the contract does not require and this client does. The
+     * reason is local: game.ts's notice text states that NPC voices are
+     * OFFLINE. Firing it while continuing to call the relay on every line
+     * would make the sentence a lie -- so here, notifying and stopping
+     * are one decision. Credit exhausted at the provider does not refill
+     * itself mid-session either.
+     *
+     * With no envelope, every answer is exactly what it was before: the
+     * relay's 401/403 stop it, nothing else does.
+     */
+    private static relayVerdict;
+    /**
+     * What a failed reply actually SAID, if anything -- the one thing
+     * always worth more than a status number.
+     *
+     * Providers disagree on where it lives: Anthropic and OpenAI nest it
+     * under `error`, the maka-cli.com relay puts it at the top level.
+     * Only the nested form was ever read on the direct providers, so a
+     * bare top-level {message} was lost along with the status.
+     */
+    private static statedError;
     /**
      * Sends `prompt` to whichever provider is configured and returns the
      * completion text. Throws if no provider is configured, the request

package/bundle/typescript/src/tools/ai/ai.class.js

@@ -223,6 +223,148 @@ export class AI {
             return true;
         return this.serverAccess === 'full';
     }
+    /** How much of an unparseable body to quote back. Enough to
+     *  recognize a gateway page or a captive portal, short enough that an
+     *  error line stays an error line -- a 50 KB HTML dump in the session
+     *  log is not a diagnostic. */
+    static BODY_SNIFF = 140;
+    /**
+     * The message for a reply that was not JSON at all. There is no
+     * provider envelope to read in this case, so this says the two things
+     * that are actually known: WHO was called and WHAT the transport
+     * answered.
+     *
+     * A 502/503/504 in front of a JSON API is a gateway, not the API --
+     * the service is down or mid-deploy and the request was never seen.
+     * It gets its own wording because the alternative is a player reading
+     * "the AI refused" and going to check a login that is perfectly fine.
+     */
+    static describeUnparseable(provider, statusCode, body) {
+        return this.gatewayNote(provider, statusCode)
+            ?? `${this.providerLabel(provider)} answered HTTP ${statusCode} with a body that is not JSON: `
+                + `${this.sniff(body)}`;
+    }
+    /**
+     * The message for a request that FAILED at the HTTP level while
+     * returning perfectly well-formed JSON that simply says nothing about
+     * why (4MADSCbQMT2gzcGFW).
+     *
+     * This used to fall all the way through to the content check and come
+     * out as "No content returned from <provider>", which describes a
+     * malformed SUCCESS -- the wrong diagnosis for a request that never
+     * succeeded, with HTTP 503 sitting unread in the response the whole
+     * time. The status was only ever consulted on the relay path, and
+     * only when the body happened to carry a `message`.
+     *
+     * Same wording as the non-JSON path above, deliberately: whether the
+     * failure arrived as an nginx HTML page or as a tidy `{"detail": ...}`
+     * is not the player's problem and must not change the diagnosis.
+     */
+    static describeHttpFailure(provider, statusCode, body) {
+        return this.gatewayNote(provider, statusCode)
+            ?? `${this.providerLabel(provider)} answered HTTP ${statusCode} with no error to read: `
+                + `${this.sniff(body)}`;
+    }
+    static providerLabel(provider) {
+        return provider === 'server' ? 'The maka-cli.com AI relay' : `The ${provider} API`;
+    }
+    /**
+     * A 502/503/504 in front of a JSON API is a GATEWAY, not the API --
+     * the service is down or mid-deploy and the request was never seen.
+     * It gets its own wording because the alternative is a player reading
+     * "the AI refused" and going to check a login that is perfectly fine.
+     */
+    static gatewayNote(provider, statusCode) {
+        if (statusCode !== 502 && statusCode !== 503 && statusCode !== 504)
+            return undefined;
+        return `${this.providerLabel(provider)} is unreachable right now (HTTP ${statusCode}) -- `
+            + `the service is down or mid-deploy. `
+            + `Nothing is wrong with your account or your request; try again shortly.`;
+    }
+    static sniff(body) {
+        const text = (body ?? '').replace(/\s+/g, ' ').trim();
+        // `""` is a body that parses fine and says nothing. Quoting it back
+        // yields `""""`, which reads as a mangled message rather than an
+        // absent one -- and "the server said nothing" is the actual fact.
+        const meaningful = text === '""' ? '' : text.slice(0, this.BODY_SNIFF);
+        return meaningful.length > 0 ? `"${meaningful}"` : '(empty)';
+    }
+    /**
+     * What to DO about a relay failure: stop asking, and/or say it out
+     * loud once. The contract's three-line mapping, with `retryable`
+     * checked FIRST so an unrecognised future kind lands in the right
+     * bucket instead of an unknown one.
+     *
+     * `upstream_billing` stops the relay as well as raising the notice,
+     * which the contract does not require and this client does. The
+     * reason is local: game.ts's notice text states that NPC voices are
+     * OFFLINE. Firing it while continuing to call the relay on every line
+     * would make the sentence a lie -- so here, notifying and stopping
+     * are one decision. Credit exhausted at the provider does not refill
+     * itself mid-session either.
+     *
+     * With no envelope, every answer is exactly what it was before: the
+     * relay's 401/403 stop it, nothing else does.
+     */
+    static relayVerdict(provider, parsed, statusCode) {
+        const none = { envelope: false, stop: false, notify: false };
+        // The envelope belongs to maka-cli.com. A direct provider body that
+        // happened to carry `kind` must never steer the relay switch.
+        if (provider !== 'server')
+            return none;
+        if (typeof parsed !== 'object' || parsed === null || !('kind' in parsed)) {
+            const terminal = statusCode === 401 || statusCode === 403;
+            return { envelope: false, stop: terminal, notify: terminal };
+        }
+        const body = parsed;
+        // AUTHORITATIVE, and never re-derived from the status: a kind that
+        // says retryable is transient even on a status that looks fatal.
+        if (body.retryable === true)
+            return { envelope: true, stop: false, notify: false };
+        const kind = typeof body.kind === 'string' ? body.kind : '';
+        // `status` is mirrored into the body for clients whose transport
+        // loses it -- ours has a known bug that does exactly that, so
+        // prefer the body's own number when it gives one.
+        const status = typeof body.status === 'number' ? body.status : statusCode;
+        // The contract's own mapping, in its own order: billing first
+        // (whose account it is changes what the player is told), then the
+        // login statuses. NOT a list of terminal KIND NAMES -- a mutation
+        // proved such a set could never fire on its own, because every kind
+        // in the contract's terminal table carries 401 or 403 anyway. A
+        // check that cannot fail is not a safeguard, it is decoration that
+        // reads like one.
+        const fatal = kind === 'upstream_billing' || status === 401 || status === 403;
+        return { envelope: true, stop: fatal, notify: fatal };
+    }
+    /**
+     * What a failed reply actually SAID, if anything -- the one thing
+     * always worth more than a status number.
+     *
+     * Providers disagree on where it lives: Anthropic and OpenAI nest it
+     * under `error`, the maka-cli.com relay puts it at the top level.
+     * Only the nested form was ever read on the direct providers, so a
+     * bare top-level {message} was lost along with the status.
+     */
+    static statedError(parsed) {
+        // A BARE JSON STRING IS A REAL BODY. maka:rest answers its own
+        // framework failures with a quoted string and nothing else --
+        // `"Unauthorized"` (401), `"Forbidden"` (403), `"Too many requests"`
+        // (429), `"Server Error"` (500). JSON.parse succeeds and hands back
+        // a string, so every `parsed?.x` read below it is undefined. The
+        // 429 can fire today: the relay limits 20 points per 10s per IP.
+        if (typeof parsed === 'string') {
+            const bare = parsed.trim();
+            return bare.length > 0 ? bare : undefined;
+        }
+        if (typeof parsed !== 'object' || parsed === null)
+            return undefined;
+        const shape = parsed;
+        const raw = typeof shape.error?.message === 'string' ? shape.error.message
+            : typeof shape.message === 'string' ? shape.message
+                : undefined;
+        const trimmed = raw?.trim();
+        return trimmed !== undefined && trimmed.length > 0 ? trimmed : undefined;
+    }
     /**
      * Sends `prompt` to whichever provider is configured and returns the
      * completion text. Throws if no provider is configured, the request
@@ -249,23 +391,76 @@ export class AI {
                 : config.provider === 'deepseek'
                     ? await HTTPS.askDeepSeek({ prompt, apiKey: config.apiKey, model: config.model, maxTokens: opts?.maxTokens })
                     : await HTTPS.askMakaServer({ prompt, authToken: config.apiKey, model: config.model, maxTokens: opts?.maxTokens });
-        const parsedRaw = JSON.parse(result.data);
+        // A BODY THAT IS NOT JSON IS AN HTTP PROBLEM, NOT A PARSE PROBLEM.
+        // This parse used to run bare, AHEAD of the statusCode guard below
+        // -- so that guard only ever protected JSON-shaped failures. When
+        // maka-cli.com went mid-deploy on 2026-08-29, nginx answered with a
+        // 502 HTML page, JSON.parse threw first, and the SyntaxError rode
+        // out of a fire-and-forget NPC reaction into ui.ts's fatal handler
+        // and killed the session twice.
+        //
+        // Deliberately in FRONT of the branches below rather than replacing
+        // them: every provider reports its own 4xx as a JSON error envelope
+        // (Anthropic's spent-credits 400, the relay's expired-login 401),
+        // and those must keep routing to onProviderRefusal exactly as they
+        // do. Only a body with no envelope to read at all lands here, and
+        // then the status is the one thing left that can explain it.
+        // Untyped on purpose: JSON.parse hands back `any`, and every read
+        // below is a defensive `?.` against a shape we do not control.
+        let parsedRaw;
+        try {
+            parsedRaw = JSON.parse(result.data);
+        }
+        catch {
+            throw new Error(this.describeUnparseable(config.provider, result.statusCode, result.data));
+        }
         // The relay wraps Anthropic's verbatim response in the REST API's
         // {data} envelope; unwrap so the shared parsing below sees the same
         // shape a direct Anthropic call returns.
         const parsed = config.provider === 'server' ? (parsedRaw?.data ?? parsedRaw) : parsedRaw;
-        // Relay-level refusals (role missing, expired login) arrive as HTTP
-        // errors with a {message}, not an Anthropic error envelope. One loud
-        // notice, then the server provider stays off for the session.
-        if (config.provider === 'server' && result.statusCode >= 400) {
-            const message = parsed?.message ?? `The maka-cli.com AI relay refused (${result.statusCode}).`;
-            if (result.statusCode === 401 || result.statusCode === 403) {
+        // THE TRANSPORT FAILED -- ask the body for content only once HTTP
+        // has agreed the exchange worked (4MADSCbQMT2gzcGFW).
+        //
+        // This was the relay's branch alone, and only fired when the body
+        // happened to carry a `message`. Everything else with a 4xx/5xx --
+        // a direct provider's 503, a body of `{}`, the REST framework's
+        // bare `"Too many requests"` string -- sailed past an unread status
+        // code and came out the far end as "No content returned from
+        // <provider>", which describes a malformed SUCCESS. Wrong
+        // diagnosis, and it sent at least one investigation looking at the
+        // wrong layer.
+        //
+        // What the body SAID still outranks the status: the status-naming
+        // message is the fallback for when nothing was said, never a
+        // replacement for a real diagnosis.
+        if (result.statusCode >= 400) {
+            const stated = this.statedError(parsed) ?? this.statedError(parsedRaw);
+            const message = stated ?? this.describeHttpFailure(config.provider, result.statusCode, result.data);
+            // WHEN IS THE RELAY FINISHED? Read the contract's envelope if it
+            // sent one, and fall back to 401/403 if it did not. Deliberately
+            // NOT extended to 5xx by status: a mid-deploy 502 is not an
+            // expired login, and treating it as one leaves every NPC canned
+            // until the player restarts.
+            const verdict = this.relayVerdict(config.provider, parsed, result.statusCode);
+            if (verdict.stop) {
                 AI.serverAccess = 'denied';
+            }
+            if (verdict.notify) {
                 try {
                     this.onProviderRefusal?.(message);
                 }
                 catch { /* notice must never mask the throw */ }
             }
+            else if (!verdict.envelope && stated !== undefined && this.REFUSAL_RE.test(stated)) {
+                // Out-of-money wording, wherever the provider chose to put it.
+                // REFUSAL_RE used to run against `error.message` only, so the
+                // same spent-credits sentence got the one loud notice when
+                // nested and silence when top-level.
+                try {
+                    this.onProviderRefusal?.(stated);
+                }
+                catch { /* notice must never mask the throw */ }
+            }
             throw new Error(message);
         }
         if (parsed?.error) {

package/bundle/typescript/src/tools/ai/ai.class.js.map

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

package/bundle/typescript/src/tools/https/connection-error.d.ts

@@ -0,0 +1,79 @@
+/**
+ * WHY A CALL TO maka-cli.com DID NOT ARRIVE, in one sentence naming the
+ * origin actually dialled (board item KYaqmxeW343owAnsn).
+ *
+ * `maka login`, `maka logout` and `maka register` each print the right
+ * banner now (KtbaziFuKHh8WheFn) -- and then, when nothing answers,
+ * report the failure three DIFFERENT wrong ways:
+ *
+ *   login     exit 0, `console.log(e)` dumping the raw error object as a
+ *             wall of node:net stack, then "If you need to reset your
+ *             password..." -- advice for a failure that never happened.
+ *   logout    exit 0, `Log.error(e)` stringifying to the bare word
+ *             "AggregateError", then "You may not be logged in...".
+ *   register  exit 1 (the only honest code of the three) and NO MESSAGE
+ *             AT ALL, because `err.message` on an AggregateError is the
+ *             empty string.
+ *
+ * Three spellings of one bug is worse than one uniform bug: it reads as
+ * three unrelated quirks, so nobody fixes the shape. Hence one helper
+ * all three share.
+ *
+ * THE EMPTY MESSAGE IS THE TRAP WORTH NAMING. Node raises AggregateError
+ * when a host resolves to several addresses (::1 and 127.0.0.1 for
+ * localhost) and every attempt fails; the real codes live on `.errors`,
+ * and `.message` is `''`. So the obvious `err.message` prints nothing,
+ * looks like a silent success, and is exactly how `register` came to
+ * announce a dead server by saying nothing whatsoever.
+ */
+/**
+ * The transport-level code buried in a thrown error, wherever it is.
+ *
+ * Looks in three places because Node uses all three: `code` on the error
+ * itself, `errors[]` on an AggregateError (the multi-address case), and
+ * `cause` on a wrapper. Depth-limited rather than trusting the shape --
+ * a cyclic `cause` is rare and a hung CLI is worse than a vague message.
+ */
+export declare function networkErrorCode(err: unknown, depth?: number): string | undefined;
+/** Did this fail because the request never reached the server? Used to
+ *  decide whether advice about PASSWORDS or SESSIONS is relevant -- it
+ *  is not, when nobody was listening to hear the credentials. */
+export declare function isUnreachable(err: unknown): boolean;
+/**
+ * One sentence, for a human, naming the origin that was actually
+ * dialled.
+ *
+ * NEVER RETURNS AN EMPTY STRING, and that is the load-bearing
+ * guarantee rather than a nicety: the bug being fixed here is a command
+ * that reported a dead server by printing nothing, and any fix that can
+ * still produce '' just moves that failure somewhere new.
+ */
+export declare function describeFailure(err: unknown, origin: string): string;
+/** What a command should print and exit with, given a thrown error. */
+export interface IFailureReport {
+    /** The one sentence. Never empty. */
+    message: string;
+    /** Follow-up advice, when any is warranted -- omitted for a failure the
+     *  advice cannot explain. */
+    hint?: string;
+    /** Always non-zero: this is the failure path. */
+    exitCode: number;
+}
+/**
+ * THE WHOLE FAILURE DECISION IN ONE PLACE, so the part with real cases
+ * in it can be tested without spawning a CLI.
+ *
+ * `login` and `logout` each ended their catch with `process.exit(0)`,
+ * which is the load-bearing half of KYaqmxeW343owAnsn: a login that
+ * never reached the server reported success, so `maka login && <next>`
+ * ran the next step regardless and nothing scripted could gate on it.
+ * A wrong exit code is a lie an automation acts on; a wrong message is
+ * only a lie a person reads.
+ *
+ * `hint` is dropped when the request never arrived, because both hints
+ * these commands carry -- "reset your password", "you may not be logged
+ * in" -- are guesses about CREDENTIALS or SESSION STATE, and neither is
+ * a sensible guess when nobody was listening to hear them. Advice that
+ * points the diagnosis away from a dead server is worse than none.
+ */
+export declare function failureReport(err: unknown, origin: string, hint?: string): IFailureReport;

package/bundle/typescript/src/tools/https/connection-error.js

@@ -0,0 +1,134 @@
+/**
+ * WHY A CALL TO maka-cli.com DID NOT ARRIVE, in one sentence naming the
+ * origin actually dialled (board item KYaqmxeW343owAnsn).
+ *
+ * `maka login`, `maka logout` and `maka register` each print the right
+ * banner now (KtbaziFuKHh8WheFn) -- and then, when nothing answers,
+ * report the failure three DIFFERENT wrong ways:
+ *
+ *   login     exit 0, `console.log(e)` dumping the raw error object as a
+ *             wall of node:net stack, then "If you need to reset your
+ *             password..." -- advice for a failure that never happened.
+ *   logout    exit 0, `Log.error(e)` stringifying to the bare word
+ *             "AggregateError", then "You may not be logged in...".
+ *   register  exit 1 (the only honest code of the three) and NO MESSAGE
+ *             AT ALL, because `err.message` on an AggregateError is the
+ *             empty string.
+ *
+ * Three spellings of one bug is worse than one uniform bug: it reads as
+ * three unrelated quirks, so nobody fixes the shape. Hence one helper
+ * all three share.
+ *
+ * THE EMPTY MESSAGE IS THE TRAP WORTH NAMING. Node raises AggregateError
+ * when a host resolves to several addresses (::1 and 127.0.0.1 for
+ * localhost) and every attempt fails; the real codes live on `.errors`,
+ * and `.message` is `''`. So the obvious `err.message` prints nothing,
+ * looks like a silent success, and is exactly how `register` came to
+ * announce a dead server by saying nothing whatsoever.
+ */
+/** The failures that mean "the request never got there", mapped to what
+ *  a person should do about it. Deliberately about REACHABILITY -- an
+ *  HTTP status is a different thing and is reported by its own code. */
+const NETWORK_REASONS = {
+    ECONNREFUSED: 'nothing is listening on that port',
+    ENOTFOUND: 'that host name does not resolve',
+    EAI_AGAIN: 'the DNS lookup failed',
+    ETIMEDOUT: 'it did not answer in time',
+    ECONNRESET: 'the connection was reset',
+    EHOSTUNREACH: 'that host is unreachable',
+    ENETUNREACH: 'that network is unreachable',
+    EPIPE: 'the connection closed mid-request',
+    CERT_HAS_EXPIRED: 'its TLS certificate has expired',
+    DEPTH_ZERO_SELF_SIGNED_CERT: 'its TLS certificate is self-signed',
+    UNABLE_TO_VERIFY_LEAF_SIGNATURE: 'its TLS certificate could not be verified',
+};
+/**
+ * The transport-level code buried in a thrown error, wherever it is.
+ *
+ * Looks in three places because Node uses all three: `code` on the error
+ * itself, `errors[]` on an AggregateError (the multi-address case), and
+ * `cause` on a wrapper. Depth-limited rather than trusting the shape --
+ * a cyclic `cause` is rare and a hung CLI is worse than a vague message.
+ */
+export function networkErrorCode(err, depth = 0) {
+    if (err === null || typeof err !== 'object' || depth > 4)
+        return undefined;
+    const e = err;
+    if (typeof e.code === 'string' && e.code in NETWORK_REASONS)
+        return e.code;
+    if (Array.isArray(e.errors)) {
+        for (const inner of e.errors) {
+            const found = networkErrorCode(inner, depth + 1);
+            if (found)
+                return found;
+        }
+    }
+    if (e.cause !== undefined)
+        return networkErrorCode(e.cause, depth + 1);
+    // A code we do not have prose for still beats nothing: report it as
+    // itself rather than pretending the error was untyped.
+    if (typeof e.code === 'string' && e.code.length > 0)
+        return e.code;
+    return undefined;
+}
+/** Did this fail because the request never reached the server? Used to
+ *  decide whether advice about PASSWORDS or SESSIONS is relevant -- it
+ *  is not, when nobody was listening to hear the credentials. */
+export function isUnreachable(err) {
+    return networkErrorCode(err) !== undefined;
+}
+/**
+ * One sentence, for a human, naming the origin that was actually
+ * dialled.
+ *
+ * NEVER RETURNS AN EMPTY STRING, and that is the load-bearing
+ * guarantee rather than a nicety: the bug being fixed here is a command
+ * that reported a dead server by printing nothing, and any fix that can
+ * still produce '' just moves that failure somewhere new.
+ */
+export function describeFailure(err, origin) {
+    const code = networkErrorCode(err);
+    if (code !== undefined) {
+        const reason = NETWORK_REASONS[code];
+        return reason !== undefined
+            ? `Could not reach ${origin} -- ${reason} (${code}).`
+            : `Could not reach ${origin} (${code}).`;
+    }
+    // Not a transport failure: the server answered and said no. Its own
+    // words are better than anything invented here.
+    const e = (err ?? {});
+    if (typeof e.statusMessage === 'string' && e.statusMessage.trim().length > 0) {
+        return e.statusMessage;
+    }
+    if (typeof e.message === 'string' && e.message.trim().length > 0) {
+        return e.message;
+    }
+    if (typeof err === 'string' && err.trim().length > 0)
+        return err;
+    return `Something went wrong talking to ${origin}.`;
+}
+/**
+ * THE WHOLE FAILURE DECISION IN ONE PLACE, so the part with real cases
+ * in it can be tested without spawning a CLI.
+ *
+ * `login` and `logout` each ended their catch with `process.exit(0)`,
+ * which is the load-bearing half of KYaqmxeW343owAnsn: a login that
+ * never reached the server reported success, so `maka login && <next>`
+ * ran the next step regardless and nothing scripted could gate on it.
+ * A wrong exit code is a lie an automation acts on; a wrong message is
+ * only a lie a person reads.
+ *
+ * `hint` is dropped when the request never arrived, because both hints
+ * these commands carry -- "reset your password", "you may not be logged
+ * in" -- are guesses about CREDENTIALS or SESSION STATE, and neither is
+ * a sensible guess when nobody was listening to hear them. Advice that
+ * points the diagnosis away from a dead server is worse than none.
+ */
+export function failureReport(err, origin, hint) {
+    return {
+        message: describeFailure(err, origin),
+        hint: hint !== undefined && !isUnreachable(err) ? hint : undefined,
+        exitCode: 1,
+    };
+}
+//# sourceMappingURL=connection-error.js.map

package/bundle/typescript/src/tools/https/connection-error.js.map

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

package/bundle/typescript/src/tools/https/https.class.d.ts

@@ -1,6 +1,6 @@
 import { IHTTPSPost, IHTTPSGet, IHTTPSResponse, IHTPSAskGPT, IHTPSAskClaude, IHTTPSDownload } from './https.interface';
 export declare class HTTPS {
-    static post({ hostname, path, data, headers, cert, timeout }: IHTTPSPost): Promise<IHTTPSResponse>;
+    static post({ hostname, path, data, headers, cert, timeout, port, protocol }: IHTTPSPost): Promise<IHTTPSResponse>;
     static get({ url, headers, cert, timeout }: IHTTPSGet): Promise<IHTTPSResponse>;
     static downloadFile({ url, headers, cert, destPath, timeout }: IHTTPSDownload): Promise<void>;
     static checkAvailability({ url, headers, cert, maxRedirects, timeout }: IHTTPSGet & {