jaitus 0.3.23 → 0.3.24

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jaitus",
-  "version": "0.3.23",
+  "version": "0.3.24",
   "description": "Jaitus — a coding agent in your terminal.",
   "type": "module",
   "bin": {
@@ -16,7 +16,7 @@
     "node": ">=20"
   },
   "scripts": {
-    "test": "node tests/source-sanity.js && node tests/react-build.js && node tests/stalls.js && node tests/clipboard-write.js && node tests/rewind-images.js && node tests/rules.js && node tests/run.js && node tests/commands.js && node tests/login.js && node tests/session.js && node tests/openUrl.js && node tests/ink-tui.js && node tests/tui-render.js && node tests/mouse-e2e.js && node tests/environment.js && node tests/update.js && node tests/service-notices.js && node tests/continuation.js && node tests/steps.js && node tests/files.js && node tests/processes.js && node tests/security.js && node tests/context-budget.js && node tests/context-trim.js && node tests/compaction.js && node tests/copy-clean.js && node tests/parallel-tools.js && node tests/plan-percent.js && node tests/orb.js && node tests/update-required.js && node tests/select-scroll.js && node tests/project-identity.js",
+    "test": "node tests/source-sanity.js && node tests/react-build.js && node tests/stalls.js && node tests/clipboard-write.js && node tests/rewind-images.js && node tests/rules.js && node tests/run.js && node tests/commands.js && node tests/login.js && node tests/session.js && node tests/openUrl.js && node tests/ink-tui.js && node tests/tui-render.js && node tests/mouse-e2e.js && node tests/environment.js && node tests/update.js && node tests/service-notices.js && node tests/continuation.js && node tests/steps.js && node tests/files.js && node tests/processes.js && node tests/security.js && node tests/context-budget.js && node tests/context-trim.js && node tests/compaction.js && node tests/copy-clean.js && node tests/parallel-tools.js && node tests/plan-percent.js && node tests/orb.js && node tests/update-required.js && node tests/update-policy.js && node tests/select-scroll.js && node tests/project-identity.js",
     "preview": "node scripts/tui-preview.js",
     "prepublishOnly": "npm test"
   },

package/src/errors.js

@@ -1,126 +1,126 @@
-// ─── What the CLI says when something fails ─────────────────────────────────────
-//
-// The gateway answers every failure with a `jaitus_*` code from one catalog. This file
-// is the CLI's half of that contract: a code maps to a title and a hint written here,
-// and anything WITHOUT a known code — an HTML page from a proxy, a body in some other
-// shape, a code this build has never heard of — becomes "something went wrong in
-// Jaitus" plus the request id. The CLI never prints an error body it does not
-// recognise, because the only text that is safe to show is text we wrote.
-
-const CATALOG = {
-  auth_required: { title: 'Not signed in', hint: 'Type /login to sign in (or run `jaitus login`).' },
-  session_expired: { title: 'Signed out', hint: 'Type /login to sign in again (or run `jaitus login`).' },
-  account_suspended: { title: 'Account suspended', hint: 'Contact support@jaitus.com if you think this is a mistake.' },
-  email_unverified: { title: 'Email not verified', hint: 'Open the verification link in your inbox, then retry.' },
-  free_limit_reached: { title: 'Free allowance used up', hint: 'Subscribe at jaitus.com/billing, then retry this turn. Pay by UPI, card, net banking or wallet; the plan starts as soon as the payment goes through.' },
-  free_machine_limit: { title: 'No free prompts on this account', hint: 'Subscribe at jaitus.com/billing to keep using Jaitus on this account.' },
-  free_needs_check: { title: 'Unlock your free prompts', hint: 'A one-time ₹1 UPI check at jaitus.com/billing (refunded). Or subscribe.' },
-  free_needs_cli: { title: 'Update Jaitus for free prompts', hint: 'Run npm i -g jaitus, then try again.' },
-  // This version is below what Jaitus now requires; the message names both versions.
-  update_required: { title: 'Update Jaitus to continue', hint: 'Run npm i -g jaitus@latest, then start jaitus again.' },
-  free_request_too_large: { title: 'Too large for the free plan', hint: 'Run /compact or start a new session, or subscribe at jaitus.com/billing.' },
-  plan_limit_reached: { title: 'Monthly usage used up', hint: 'To keep going now, switch plans at jaitus.com/billing — what is left of this plan carries over. Buying another 30 days of the same plan adds days but does not refill this month. /usage shows where you are.' },
-  rate_limited: { title: 'Slow down', hint: 'Wait a moment, then retry.' },
-  context_too_long: { title: 'Conversation too long', hint: 'Run /compact, or start a new session.' },
-  request_too_large: { title: 'Request too large', hint: 'Usually images: remove some, or run /compact to drop old ones. Images over 3.5 MB are shrunk automatically.' },
-  daily_limit_reached: { title: 'Usage limit reached', hint: 'It refills automatically. /usage shows where you are.' },
-  plan_expired: { title: 'Your plan has ended', hint: 'Plans last 30 days and do not renew by themselves. Renew at jaitus.com/billing, then retry this turn.' },
-  window_limit_reached: { title: 'Usage limit reached', hint: 'It resets by itself — /usage shows your 5-hour window, week and month, and when each resets.' },
-  token_expired: { title: 'Signed out', hint: 'Type /login to sign in again (or run `jaitus login`).' },
-  refresh_race: { title: 'Sign-in was being renewed', hint: 'Try again.' },
-  content_blocked: { title: 'Request refused', hint: 'Rephrase the request and try again.' },
-  bad_request: { title: 'Request not accepted', hint: 'Try again; if it repeats, run /debug and send the output to support@jaitus.com.' },
-  model_unavailable: { title: 'Model unavailable', hint: 'Run `jaitus config model --unset` so Jaitus picks the model automatically.' },
-  busy: { title: 'Jaitus is busy', hint: 'Try again in a minute.' },
-  unavailable: { title: 'Jaitus is unavailable', hint: 'Try again shortly. `jaitus doctor` checks your side.' },
-  maintenance: { title: 'Down for maintenance', hint: 'Try again shortly.' },
-  timeout: { title: 'Timed out', hint: 'Try again.' },
-  interrupted: { title: 'Response interrupted', hint: 'Try again.' },
-  internal: { title: 'Something went wrong', hint: 'Try again; if it keeps happening, email support@jaitus.com with the request id.' },
-};
-
-const GENERIC = 'Something went wrong in Jaitus.';
-
-export class JaitusError extends Error {
-  constructor({ code = 'internal', message, status = 0, requestId = '', retryAfter = null } = {}) {
-    const known = Object.prototype.hasOwnProperty.call(CATALOG, code) ? code : 'internal';
-    super(message || GENERIC);
-    this.name = 'JaitusError';
-    this.code = known;
-    this.status = status;
-    this.requestId = requestId;
-    this.retryAfter = retryAfter;
-    this.title = CATALOG[known].title;
-    this.hint = CATALOG[known].hint;
-  }
-}
-
-/**
- * An error body from the gateway → a JaitusError.
- *
- * The gateway's message is shown ONLY when the body carries a recognised `jaitus_`
- * code, because only then is it guaranteed to be our wording (it may carry specifics,
- * like how many free prompts there were). Otherwise the message is ours, generic.
- */
-export function fromGatewayBody(status, body, { requestId = '', retryAfter = null } = {}) {
-  let parsed = body;
-  if (typeof body === 'string') {
-    try { parsed = JSON.parse(body); } catch { parsed = null; }
-  }
-  const err = parsed?.error || null;
-  const rawCode = String(err?.code || '');
-  const code = rawCode.startsWith('jaitus_') ? rawCode.slice(7) : '';
-  const known = code && Object.prototype.hasOwnProperty.call(CATALOG, code);
-  const id = String(parsed?.request_id || requestId || '');
-  // No Jaitus code on a gateway-class status: the answer came from the proxy in front of
-  // the gateway (its timeout page, a 502 while a deploy restarts the server), not from
-  // the gateway. Those are "not right now" — said plainly and retried — never the
-  // dead-end "Something went wrong" they used to read as.
-  if (!known && (status === 504 || status === 524)) {
-    return new JaitusError({ code: 'timeout', status, requestId: id, retryAfter, message: 'Jaitus took too long to answer and the connection was closed on the way. Try again.' });
-  }
-  if (!known && (status === 502 || status === 503 || (status >= 520 && status <= 530))) {
-    return new JaitusError({ code: 'unavailable', status, requestId: id, retryAfter, message: 'Jaitus could not be reached just now. Try again in a moment.' });
-  }
-  return new JaitusError({
-    code: known ? code : 'internal',
-    message: known && typeof err?.message === 'string' && err.message.trim() ? err.message.trim() : GENERIC,
-    status,
-    requestId: id,
-    retryAfter,
-  });
-}
-
-/** A failed fetch Response → a JaitusError, reading the body once. */
-export async function fromResponse(res) {
-  const text = await res.text().catch(() => '');
-  const requestId = res.headers?.get?.('x-request-id') || '';
-  const retryAfter = Number(res.headers?.get?.('retry-after')) || null;
-  const error = fromGatewayBody(res.status, text, { requestId, retryAfter });
-  // The gateway says trying again cannot help yet (e.g. no provider is switched on):
-  // report it at once instead of retrying behind "Working…".
-  if (res.headers?.get?.('x-jaitus-retry') === 'no') error.noRetry = true;
-  return error;
-}
-
-/**
- * fetch() threw before any response — the network, not the service. This is the one
- * failure where the true cause is on the user's side and worth naming plainly.
- */
-export function fromNetwork(cause) {
-  if (cause?.name === 'AbortError') return cause;
-  const error = new JaitusError({
-    code: 'unavailable',
-    message: 'Could not reach Jaitus. Check your internet connection.',
-  });
-  error.title = 'Cannot reach Jaitus';
-  error.hint = 'Check your connection, then run `jaitus doctor`.';
-  error.cause = cause;
-  return error;
-}
-
-export function isJaitusError(e) {
-  return e instanceof JaitusError || e?.name === 'JaitusError';
-}
-
-export const ERROR_CODES = Object.freeze(Object.keys(CATALOG));
+// ─── What the CLI says when something fails ─────────────────────────────────────
+//
+// The gateway answers every failure with a `jaitus_*` code from one catalog. This file
+// is the CLI's half of that contract: a code maps to a title and a hint written here,
+// and anything WITHOUT a known code — an HTML page from a proxy, a body in some other
+// shape, a code this build has never heard of — becomes "something went wrong in
+// Jaitus" plus the request id. The CLI never prints an error body it does not
+// recognise, because the only text that is safe to show is text we wrote.
+
+const CATALOG = {
+  auth_required: { title: 'Not signed in', hint: 'Type /login to sign in (or run `jaitus login`).' },
+  session_expired: { title: 'Signed out', hint: 'Type /login to sign in again (or run `jaitus login`).' },
+  account_suspended: { title: 'Account suspended', hint: 'Contact support@jaitus.com if you think this is a mistake.' },
+  email_unverified: { title: 'Email not verified', hint: 'Open the verification link in your inbox, then retry.' },
+  free_limit_reached: { title: 'Free allowance used up', hint: 'Subscribe at jaitus.com/billing, then retry this turn. Pay by UPI, card, net banking or wallet; the plan starts as soon as the payment goes through.' },
+  free_machine_limit: { title: 'No free prompts on this account', hint: 'Subscribe at jaitus.com/billing to keep using Jaitus on this account.' },
+  free_needs_check: { title: 'Unlock your free prompts', hint: 'A one-time ₹1 UPI check at jaitus.com/billing (refunded). Or subscribe.' },
+  free_needs_cli: { title: 'Update Jaitus for free prompts', hint: 'Run npm i -g jaitus, then try again.' },
+  // This version is below what Jaitus now requires; the message names both versions.
+  update_required: { title: 'Update Jaitus to continue', hint: 'Run npm i -g jaitus@latest, then start jaitus again.' },
+  free_request_too_large: { title: 'Too large for the free plan', hint: 'Run /compact or start a new session, or subscribe at jaitus.com/billing.' },
+  plan_limit_reached: { title: 'Monthly usage used up', hint: 'To keep going now, switch plans at jaitus.com/billing — the new plan starts fresh today, for 30 days. Buying another 30 days of the same plan adds days but does not refill this month. /usage shows where you are.' },
+  rate_limited: { title: 'Slow down', hint: 'Wait a moment, then retry.' },
+  context_too_long: { title: 'Conversation too long', hint: 'Run /compact, or start a new session.' },
+  request_too_large: { title: 'Request too large', hint: 'Usually images: remove some, or run /compact to drop old ones. Images over 3.5 MB are shrunk automatically.' },
+  daily_limit_reached: { title: 'Usage limit reached', hint: 'It refills automatically. /usage shows where you are.' },
+  plan_expired: { title: 'Your plan has ended', hint: 'Plans last 30 days and do not renew by themselves. Renew at jaitus.com/billing, then retry this turn.' },
+  window_limit_reached: { title: 'Usage limit reached', hint: 'It resets by itself — /usage shows your 5-hour window, week and month, and when each resets.' },
+  token_expired: { title: 'Signed out', hint: 'Type /login to sign in again (or run `jaitus login`).' },
+  refresh_race: { title: 'Sign-in was being renewed', hint: 'Try again.' },
+  content_blocked: { title: 'Request refused', hint: 'Rephrase the request and try again.' },
+  bad_request: { title: 'Request not accepted', hint: 'Try again; if it repeats, run /debug and send the output to support@jaitus.com.' },
+  model_unavailable: { title: 'Model unavailable', hint: 'Run `jaitus config model --unset` so Jaitus picks the model automatically.' },
+  busy: { title: 'Jaitus is busy', hint: 'Try again in a minute.' },
+  unavailable: { title: 'Jaitus is unavailable', hint: 'Try again shortly. `jaitus doctor` checks your side.' },
+  maintenance: { title: 'Down for maintenance', hint: 'Try again shortly.' },
+  timeout: { title: 'Timed out', hint: 'Try again.' },
+  interrupted: { title: 'Response interrupted', hint: 'Try again.' },
+  internal: { title: 'Something went wrong', hint: 'Try again; if it keeps happening, email support@jaitus.com with the request id.' },
+};
+
+const GENERIC = 'Something went wrong in Jaitus.';
+
+export class JaitusError extends Error {
+  constructor({ code = 'internal', message, status = 0, requestId = '', retryAfter = null } = {}) {
+    const known = Object.prototype.hasOwnProperty.call(CATALOG, code) ? code : 'internal';
+    super(message || GENERIC);
+    this.name = 'JaitusError';
+    this.code = known;
+    this.status = status;
+    this.requestId = requestId;
+    this.retryAfter = retryAfter;
+    this.title = CATALOG[known].title;
+    this.hint = CATALOG[known].hint;
+  }
+}
+
+/**
+ * An error body from the gateway → a JaitusError.
+ *
+ * The gateway's message is shown ONLY when the body carries a recognised `jaitus_`
+ * code, because only then is it guaranteed to be our wording (it may carry specifics,
+ * like how many free prompts there were). Otherwise the message is ours, generic.
+ */
+export function fromGatewayBody(status, body, { requestId = '', retryAfter = null } = {}) {
+  let parsed = body;
+  if (typeof body === 'string') {
+    try { parsed = JSON.parse(body); } catch { parsed = null; }
+  }
+  const err = parsed?.error || null;
+  const rawCode = String(err?.code || '');
+  const code = rawCode.startsWith('jaitus_') ? rawCode.slice(7) : '';
+  const known = code && Object.prototype.hasOwnProperty.call(CATALOG, code);
+  const id = String(parsed?.request_id || requestId || '');
+  // No Jaitus code on a gateway-class status: the answer came from the proxy in front of
+  // the gateway (its timeout page, a 502 while a deploy restarts the server), not from
+  // the gateway. Those are "not right now" — said plainly and retried — never the
+  // dead-end "Something went wrong" they used to read as.
+  if (!known && (status === 504 || status === 524)) {
+    return new JaitusError({ code: 'timeout', status, requestId: id, retryAfter, message: 'Jaitus took too long to answer and the connection was closed on the way. Try again.' });
+  }
+  if (!known && (status === 502 || status === 503 || (status >= 520 && status <= 530))) {
+    return new JaitusError({ code: 'unavailable', status, requestId: id, retryAfter, message: 'Jaitus could not be reached just now. Try again in a moment.' });
+  }
+  return new JaitusError({
+    code: known ? code : 'internal',
+    message: known && typeof err?.message === 'string' && err.message.trim() ? err.message.trim() : GENERIC,
+    status,
+    requestId: id,
+    retryAfter,
+  });
+}
+
+/** A failed fetch Response → a JaitusError, reading the body once. */
+export async function fromResponse(res) {
+  const text = await res.text().catch(() => '');
+  const requestId = res.headers?.get?.('x-request-id') || '';
+  const retryAfter = Number(res.headers?.get?.('retry-after')) || null;
+  const error = fromGatewayBody(res.status, text, { requestId, retryAfter });
+  // The gateway says trying again cannot help yet (e.g. no provider is switched on):
+  // report it at once instead of retrying behind "Working…".
+  if (res.headers?.get?.('x-jaitus-retry') === 'no') error.noRetry = true;
+  return error;
+}
+
+/**
+ * fetch() threw before any response — the network, not the service. This is the one
+ * failure where the true cause is on the user's side and worth naming plainly.
+ */
+export function fromNetwork(cause) {
+  if (cause?.name === 'AbortError') return cause;
+  const error = new JaitusError({
+    code: 'unavailable',
+    message: 'Could not reach Jaitus. Check your internet connection.',
+  });
+  error.title = 'Cannot reach Jaitus';
+  error.hint = 'Check your connection, then run `jaitus doctor`.';
+  error.cause = cause;
+  return error;
+}
+
+export function isJaitusError(e) {
+  return e instanceof JaitusError || e?.name === 'JaitusError';
+}
+
+export const ERROR_CODES = Object.freeze(Object.keys(CATALOG));