elanous 0.2.22 → 0.2.24

package/src/nexus/tools-kind.ts

@@ -0,0 +1,78 @@
+import { readUserConfig, readSwitchValue } from './config/user-config.js';
+import type { DaemonToolSurfaceKind } from '../boot/daemon-tools/types.js';
+
+/** Resolve the active daemon tool surface kind for runNexus.
+ *
+ *  Resolution order (parity with `deriveChildEnv` for daemon tab spawn —
+ *  the same switch fed into a daemon child env should govern the in-
+ *  process path too):
+ *
+ *    1. CLI flag (`opts.tools`)                                     ← 1회 boot
+ *    2. `ELANOUS_TOOLS` env                                           ← shell session
+ *    3. UserConfig switch `global.tools` (PWA Settings 토글이 여기) ← 영구
+ *    4. switch default = `'webterm'` (`builtins/global.ts:12`)       ← fallback
+ *
+ *  Pre-fix the in-process branch fell back to `'none'` while
+ *  `deriveChildEnv` fell back to the switch default `'webterm'`. That
+ *  meant a clean-machine `elanous nexus` (no flag/env) gave the in-process
+ *  LLM call an empty tool catalog while a separately-launched
+ *  `elanous serve` daemon honored the switch default's full surface —
+ *  surprising divergence the user had no way to discover.
+ *
+ *  `'all'` is in the switch enum but has no `toolSurface()` impl yet;
+ *  fall back to `'webterm'` (the most-capable wired surface). */
+const daemonToolSurfaceKinds: Record<DaemonToolSurfaceKind, true> = {
+  none: true,
+  readonly: true,
+  chat: true,
+  webterm: true,
+};
+
+function resolveKnownToolsKind(raw: string): DaemonToolSurfaceKind | undefined {
+  return Object.hasOwn(daemonToolSurfaceKinds, raw)
+    ? raw as DaemonToolSurfaceKind
+    : undefined;
+}
+
+export function resolveToolsKind(opts: { tools?: string }): DaemonToolSurfaceKind {
+  let raw: string | undefined = opts.tools;
+  if (!raw) raw = process.env.ELANOUS_TOOLS?.trim();
+  if (!raw) {
+    try {
+      const cfg = readUserConfig();
+      const v = readSwitchValue(cfg, 'global.tools');
+      if (typeof v === 'string') raw = v;
+    } catch { /* swallow — boot must not fail on a malformed config */ }
+  }
+  if (!raw) raw = 'webterm';
+  return resolveKnownToolsKind(raw) ?? 'webterm';
+}
+
+/** Resolve the `:agent` (통합 모드 webterm dock) tool surface kind.
+ *
+ *  Distinct from {@link resolveToolsKind} because the integrated
+ *  webterm-dock chat is **defined by** its PTY surface — WebTerminal*
+ *  tools (Snapshot · Input · Screenshot) are what make `:agent`
+ *  meaningful next to a live terminal. If the user has narrowed their
+ *  user-config (`global.tools chat` / `readonly`) to keep the
+ *  standalone `/chat` lighter, that preference must NOT bleed into the
+ *  integrated dock — otherwise the `:agent` LLM loses access to the
+ *  very terminal it's supposed to drive.
+ *
+ *  Resolution order:
+ *    1. CLI flag (`opts.tools`)         ← explicit operator intent wins
+ *    2. **`'webterm'`** (hardcoded)     ← env + global.tools intentionally
+ *                                         skipped vs. resolveToolsKind
+ *
+ *  CLI flag is honored so a developer debugging tool selection
+ *  (`elanous nexus run --tools readonly`) still sees a readonly `:agent`;
+ *  but a clean-machine boot or a config-narrowed boot always gets
+ *  webterm for the integrated dock. */
+export function resolveAgentTurnToolsKind(opts: { tools?: string }): DaemonToolSurfaceKind {
+  const raw = opts.tools?.trim();
+  if (!raw) return 'webterm';
+  // 'all' (or any unrecognized string) → webterm fallback, same as
+  // resolveToolsKind so the two resolvers stay consistent for valid
+  // CLI input.
+  return resolveKnownToolsKind(raw) ?? 'webterm';
+}

package/src/oauth/codex-account-rotation.ts

@@ -4,7 +4,7 @@
 //   주간 창이 찬 계정으로 계속 쏘면 런이 「구현 결손」으로 죽는다(그 어휘는 `#7123` 이 냈다).
 //
 // ⛔⭐⭐ **결정 다섯** (대표):
-//   ① 계정 «전환»만 자동이다 — 리셋 크레딧의 실제 소비는 이 판정 밖의 기존 경로가 맡는다.
+//   ① 리셋권 소비는 순수 판정 밖의 적용 경로가 기존 소비 연산으로 맡는다.
 //   ② 기본 ON. config `llm.codexAccountRotation: false` 로 끈다.
 //   ③ 사람이 «명시»한 계정은 전환하지 않는다 — 의도가 이긴다.
 //   ④ 현재 사용률을 모르면 안전한 기본 계정에 고정하지 않는다 — 쓸 후보가 있으면 넘긴다.
@@ -29,6 +29,7 @@ export interface RotationCandidate {
   /** 선불 크레딧 잔액·보유(모르면 없다). 크레딧 정책에서 «어느 계정 크레딧으로» 갈지 고른다. */
   readonly creditBalance?: number;
   readonly hasCredits?: boolean;
+  readonly resetCreditAvailability?: 'available' | 'unavailable' | 'unknown';
 }
 
 /** ⛔ 비공개 — 밖에서 이름으로 부를 소비처가 없다(리뷰 must-fix: dead export 금지). */
@@ -69,6 +70,10 @@ interface RotationDecision {
   }[];
   /** 넘겼을 때만 있다. */
   readonly to?: RotationCandidate;
+  /** 다른 계정의 리셋권이 이 판정을 연 경우의 관측용 이름. 소비 대상은 소비기가 별도로 고른다. */
+  readonly resetCreditAccount?: string;
+  /** SUBSCRIPTION-EXHAUST-REROUTE — 크레딧 예비분에 닿아 `no-candidate` 로 넘겼을 때만 있다(잔액은 «알려진» 값). */
+  readonly creditReserveHit?: { readonly balance: number; readonly reserve: number };
 }
 
 /** ⛔ 비공개 — 호출자는 객체 리터럴로 준다(구조적 타이핑). */
@@ -104,6 +109,9 @@ interface RotationInput {
   readonly currentCreditBalance?: number;
   readonly currentHasCredits?: boolean;
   readonly creditPace?: { active: boolean };
+  /** SUBSCRIPTION-EXHAUST-REROUTE (`llm.codexCreditReserve`) — 크레딧 잔액이 이 값 «이하»면 크레딧을 쓰지 않는다.
+   *  ⛔ 없으면 종전(잔액 > 0 이면 쓴다). 잔액을 «모르면» 이 값으로 막지 않는다(fail-open). */
+  readonly creditReserve?: number;
 }
 
 /**
@@ -185,23 +193,6 @@ export function decideCodexRotation(input: RotationInput): RotationDecision {
   });
   if (input.explicit) return { reason: 'explicit', candidateCount, accountThresholds };
   if (!input.enabled) return { reason: 'disabled', candidateCount, accountThresholds, ...(input.disabledProvenance ? { disabledProvenance: input.disabledProvenance } : {}) };
-  if (input.creditPace?.active) {
-    const self = input.candidates.find((candidate) => candidate.name === input.current.name);
-    const eligible = (name: string, balance: number | undefined, hasCredits: boolean | undefined, home: string | undefined): boolean =>
-      !!home?.trim() && typeof balance === 'number' && Number.isFinite(balance) && balance > 0
-      && hasCredits !== false && accountThresholds.some((row) => row.name === name
-        && (row.status === 'reached' || row.status === 'threshold-reached'));
-    const currentBalance = input.currentCreditBalance ?? self?.creditBalance;
-    const currentHas = input.currentHasCredits ?? self?.hasCredits;
-    const to = otherCandidates.filter((candidate) => eligible(candidate.name, candidate.creditBalance, candidate.hasCredits, candidate.home))
-      .sort((a, b) => (b.creditBalance! - a.creditBalance!) || (a.name < b.name ? -1 : a.name > b.name ? 1 : 0))[0];
-    if (eligible(input.current.name, currentBalance, currentHas, self?.home ?? input.current.home)) {
-      return { reason: 'credit-pace', candidateCount, accountThresholds };
-    }
-    if (to) {
-      return { reason: 'credit-pace', candidateCount, accountThresholds, to };
-    }
-  }
   const currentUsageUnknown = input.currentReached === undefined && input.currentUsedPercent == null;
   if (input.currentReached !== true && !currentUsageUnknown && accountThresholds[0]?.status !== 'threshold-reached') {
     return { reason: 'not-reached', candidateCount, accountThresholds };
@@ -232,23 +223,51 @@ export function decideCodexRotation(input: RotationInput): RotationDecision {
   const to = usable[0];
   if (!to) {
     if (input.resetCreditAvailability === 'available') return { reason: 'reset-credit-available', candidateCount, accountThresholds };
+    const resetCreditAccount = otherCandidates
+      .filter((candidate) => candidate.home.trim() && candidate.resetCreditAvailability === 'available')
+      .sort((a, b) => a.name < b.name ? -1 : a.name > b.name ? 1 : 0)[0]?.name;
+    if (resetCreditAccount) return { reason: 'reset-credit-available', candidateCount, accountThresholds, resetCreditAccount };
+    if (input.creditPace?.active) {
+      const self = input.candidates.find((candidate) => candidate.name === input.current.name);
+      const eligible = (name: string, balance: number | undefined, hasCredits: boolean | undefined, home: string | undefined): boolean =>
+        !!home?.trim() && typeof balance === 'number' && Number.isFinite(balance) && balance > 0
+        && hasCredits !== false && accountThresholds.some((row) => row.name === name
+          && (row.status === 'reached' || row.status === 'threshold-reached'));
+      const currentBalance = input.currentCreditBalance ?? self?.creditBalance;
+      const currentHas = input.currentHasCredits ?? self?.hasCredits;
+      const richest = otherCandidates.filter((candidate) => eligible(candidate.name, candidate.creditBalance, candidate.hasCredits, candidate.home))
+        .sort((a, b) => (b.creditBalance! - a.creditBalance!) || (a.name < b.name ? -1 : a.name > b.name ? 1 : 0))[0];
+      if (eligible(input.current.name, currentBalance, currentHas, self?.home ?? input.current.home)) {
+        return { reason: 'credit-pace', candidateCount, accountThresholds };
+      }
+      if (richest) return { reason: 'credit-pace', candidateCount, accountThresholds, to: richest };
+    }
     // 대표 크레딧 허가: 구독 잔량이 남은 계정이 없으면 크레딧으로 계속 — 한도가 찬 요청은 서버가 선불 크레딧으로 넘긴다.
     // 🩸 09-28 실측: default 크레딧만 시간당 ~5,200 씩 줄고 team·third(합 ~5.5만)는 0 — «지금 계정에 머문다»만으로는
     //   한 계정 크레딧이 바닥나면 남은 크레딧을 두고 폴백(grok)으로 갔다. ⇒ 크레딧이 «더 많이» 남은 계정으로 옮긴다.
     //   흔들림 방지: 지금 계정 크레딧이 없거나(보유 false · 잔액 ≤0) 다른 계정이 20% 넘게 많을 때만.
     if (input.creditsAllowed === true) {
+      // SUBSCRIPTION-EXHAUST-REROUTE — 예비분이 있으면 «예비분 초과»만 쓸 크레딧이다(없으면 종전 > 0).
+      const reserve = typeof input.creditReserve === 'number' && Number.isFinite(input.creditReserve) && input.creditReserve >= 0
+        ? input.creditReserve : undefined;
+      const floor = reserve ?? 0;
       const richest = otherCandidates
-        .filter((c) => c.home.length > 0 && c.hasCredits !== false && typeof c.creditBalance === 'number' && c.creditBalance > 0)
+        .filter((c) => c.home.length > 0 && c.hasCredits !== false && typeof c.creditBalance === 'number' && c.creditBalance > floor)
         .sort((a, b) => (b.creditBalance! - a.creditBalance!) || (a.name < b.name ? -1 : a.name > b.name ? 1 : 0))[0];
       // 지금 계정 신호를 귀속할 수 없을 때(기본 계정 `source=default`)는 후보 목록의 같은 이름 줄을 쓴다 —
       //   후보는 같은 홈 해석으로 신호를 읽었다(09-28 운영: default 가 «사용=? · 찼나=모름»이라 잔액을 못 봐 머물렀다).
       const self = input.candidates.find((c) => c.name === input.current.name);
       const cur = input.currentCreditBalance ?? self?.creditBalance;
       const curHas = input.currentHasCredits ?? self?.hasCredits;
-      const currentDry = curHas === false || (typeof cur === 'number' && cur <= 0);
+      const currentDry = curHas === false || (typeof cur === 'number' && cur <= floor);
       if (richest && (currentDry || (typeof cur === 'number' && richest.creditBalance! > cur * 1.2))) {
         return { reason: 'rotated', candidateCount, accountThresholds, to: richest };
       }
+      // 🩸 10-11: 크레딧이 0 이 돼도 여기 머물러 codex 로 계속 쐈다. 잔액이 «알려져 있고» 예비분 이하이며
+      //   예비분을 넘는 다른 계정도 없으면 «갈 곳 없음» — 폴백 체인이 다음 칸을 정한다. 모르면 종전대로 머문다.
+      if (reserve !== undefined && typeof cur === 'number' && Number.isFinite(cur) && cur <= reserve) {
+        return { reason: 'no-candidate', candidateCount, accountThresholds, creditReserveHit: { balance: cur, reserve } };
+      }
       return { reason: 'credits-allowed', candidateCount, accountThresholds };
     }
     return { reason: 'no-candidate', candidateCount, accountThresholds };
@@ -257,6 +276,21 @@ export function decideCodexRotation(input: RotationInput): RotationDecision {
   return { reason: 'rotated', candidateCount, accountThresholds, to };
 }
 
+/** SUBSCRIPTION-EXHAUST-REROUTE — 크레딧 예비분 기본(`llm.codexCreditReserve` 가 없을 때 · 근거는 codex-account-store 주석).
+ *  여기 두는 이유: Pod 계획(pod-account-broker)이 store 를 끌어오지 않고 같은 값을 쓴다. */
+export const CODEX_CREDIT_RESERVE_DEFAULT = 2000;
+
+/** CODEX-CREDITS-STEP — 크레딧 잔액이 «확인된» 후보(잔액 > 예비분 · 보유 ≠ false · 홈을 안다)를 잔액 많은 순으로.
+ *  잔액을 모르면 넣지 않는다(돈 · fail-closed). 회전 수집기와 Pod 계획이 «같은 자»를 쓴다. */
+export function creditCandidatesByBalance(candidates: readonly RotationCandidate[], reserve = 0): RotationCandidate[] {
+  // SUBSCRIPTION-EXHAUST-REROUTE — 잔액이 예비분(`llm.codexCreditReserve`) «초과»인 계정만(0 = 종전 > 0).
+  const floor = Number.isFinite(reserve) && reserve >= 0 ? reserve : 0;
+  return candidates
+    .filter((c) => c.home.length > 0 && c.hasCredits !== false
+      && typeof c.creditBalance === 'number' && Number.isFinite(c.creditBalance) && c.creditBalance > floor)
+    .sort((a, b) => (b.creditBalance! - a.creditBalance!) || (a.name < b.name ? -1 : a.name > b.name ? 1 : 0));
+}
+
 /**
  * ⛔⭐⭐⭐⭐⭐ **회전한 계정을 «자식 env»로 내려보낼 덧칠** (2026-08-07 · 크레딧 유출 차단).
  *
@@ -287,6 +321,7 @@ export function observeRotation(decision: RotationDecision, from: string): void
     from,
     to: decision.to?.name,
     reason: decision.reason,
+    ...(decision.resetCreditAccount ? { resetCreditAccount: decision.resetCreditAccount } : {}),
     candidateCount: decision.candidateCount ?? 'unknown',
     ...(decision.reason === 'disabled' && decision.disabledProvenance
       ? { disabledProvenance: decision.disabledProvenance }