charness 0.0.0-stage → 3.1.0

package/dist/utils/claudeProfileUsageLines.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatClaudeProfileUsageLines = formatClaudeProfileUsageLines;
+/**
+ * The usage lines of one Claude account profile — what `/accounts` prints under a profile row and `/limits`
+ * prints at the top of its screen. ONE renderer for both, so the two screens can never word a window differently.
+ */
+const i18n_1 = require("../i18n");
+const claudeUsage_1 = require("./claudeUsage");
+/** The localised words of a relative reset («🔄 in 2h»). */
+function getRelativeResetWords() {
+    return { pattern: (0, i18n_1.t)('usage.resetIn'), day: (0, i18n_1.t)('usage.unitDay'), hour: (0, i18n_1.t)('usage.unitHour'), minute: (0, i18n_1.t)('usage.unitMinute') };
+}
+/**
+ * @description The profile's usage as display lines: the windows as `used% 🔄 reset` — 5h and weekly always (`—`
+ * for one the snapshot lacks), Fable only when the account HAS that window (a corporate seat has none: nothing
+ * is written about it) — `(stale)` when the last poll could not refresh, and the limit mark while it holds, the
+ * reset instant in `timezone`. The lines carry the locale's own indentation (they hang under a row); empty for a
+ * profile never polled and not limited.
+ */
+function formatClaudeProfileUsageLines(source, timezone, nowMs) {
+    const lines = [];
+    const usage = source?.usage;
+    if (usage && usage.buckets.length > 0) {
+        const words = getRelativeResetWords();
+        // An unknown 5h reset shows the weekly window's instead (with neither, the bare percent).
+        const weeklyReset = (0, claudeUsage_1.getClaudeUsageBucket)(usage, 'weekly_all')?.resetsAt ?? null;
+        const read = (kind) => (0, claudeUsage_1.formatClaudeUsageBucket)((0, claudeUsage_1.getClaudeUsageBucket)(usage, kind), nowMs, {
+            words,
+            fallbackResetsAt: kind === 'session' ? weeklyReset : null,
+        });
+        const stale = usage.isStale ? (0, i18n_1.t)('account.row.usageStale') : '';
+        const hasFable = (0, claudeUsage_1.getClaudeUsageBucket)(usage, 'weekly_scoped') !== null;
+        const fable = hasFable ? (0, i18n_1.t)('account.row.usageFable', { fable: read('weekly_scoped') }) : '';
+        lines.push((0, i18n_1.t)('account.row.usage', { session: read('session'), weekly: read('weekly_all'), fable }) + stale);
+    }
+    if (source?.limitedUntil && Date.parse(source.limitedUntil) > nowMs) {
+        lines.push((0, i18n_1.t)('account.row.limited', { until: (0, claudeUsage_1.formatClaudeUsageResetAt)(source.limitedUntil, timezone, nowMs) }));
+    }
+    return lines;
+}
+//# sourceMappingURL=claudeProfileUsageLines.js.map

package/dist/utils/claudeProfileUsageLines.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claudeProfileUsageLines.js","sourceRoot":"","sources":["../../src/utils/claudeProfileUsageLines.ts"],"names":[],"mappings":";;AAgCA,sEAoBC;AApDD;;;GAGG;AACH,kCAA4B;AAC5B,+CAOuB;AAQvB,4DAA4D;AAC5D,SAAS,qBAAqB;IAC5B,OAAO,EAAE,OAAO,EAAE,IAAA,QAAC,EAAC,eAAe,CAAC,EAAE,GAAG,EAAE,IAAA,QAAC,EAAC,eAAe,CAAC,EAAE,IAAI,EAAE,IAAA,QAAC,EAAC,gBAAgB,CAAC,EAAE,MAAM,EAAE,IAAA,QAAC,EAAC,kBAAkB,CAAC,EAAE,CAAC;AAC5H,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,6BAA6B,CAAC,MAA4C,EAAE,QAAgB,EAAE,KAAa;IACzH,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,KAAK,GAAG,MAAM,EAAE,KAAK,CAAC;IAC5B,IAAI,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtC,MAAM,KAAK,GAAG,qBAAqB,EAAE,CAAC;QACtC,0FAA0F;QAC1F,MAAM,WAAW,GAAG,IAAA,kCAAoB,EAAC,KAAK,EAAE,YAAY,CAAC,EAAE,QAAQ,IAAI,IAAI,CAAC;QAChF,MAAM,IAAI,GAAG,CAAC,IAA2B,EAAE,EAAE,CAAC,IAAA,qCAAuB,EAAC,IAAA,kCAAoB,EAAC,KAAK,EAAE,IAAI,CAAC,EAAE,KAAK,EAAE;YAC9G,KAAK;YACL,gBAAgB,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI;SAC1D,CAAC,CAAC;QACH,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAA,QAAC,EAAC,wBAAwB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/D,MAAM,QAAQ,GAAG,IAAA,kCAAoB,EAAC,KAAK,EAAE,eAAe,CAAC,KAAK,IAAI,CAAC;QACvE,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAA,QAAC,EAAC,wBAAwB,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5F,KAAK,CAAC,IAAI,CAAC,IAAA,QAAC,EAAC,mBAAmB,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC;IAC9G,CAAC;IACD,IAAI,MAAM,EAAE,YAAY,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,KAAK,EAAE,CAAC;QACpE,KAAK,CAAC,IAAI,CAAC,IAAA,QAAC,EAAC,qBAAqB,EAAE,EAAE,KAAK,EAAE,IAAA,sCAAwB,EAAC,MAAM,CAAC,YAAY,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;IAClH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/utils/claudeProfiles.d.ts

@@ -0,0 +1,117 @@
+/**
+ * @description Claude ACCOUNT PROFILES — several Claude subscription logins kept side by side, one picked per
+ * topic (`/account`). A profile is a Claude Code config directory of its own under
+ * `DATA_DIR/claude-profiles/<name>/`, handed to the CLI through `CLAUDE_CONFIG_DIR`: the CLI keeps its
+ * login (`.credentials.json`, `.claude.json`) there, while the entries that must stay ONE across accounts —
+ * the transcripts (`projects/`), settings, skills, plugins and the user memory — are symlinks back into
+ * `~/.claude`, so a conversation started under one account resumes under another and every account sees
+ * the same hooks and skills.
+ *
+ * The profile `default` IS `~/.claude` itself: nothing is set for it and nothing is migrated. A process is
+ * never switched by swapping files under `~/.claude` (the CLI re-reads its credentials live and EVERY running
+ * session would change account at once); the variable is per process, set at spawn.
+ *
+ * Pure helpers (layout, name gate, resolution, parsers) — the registry and the selection live in
+ * `state.json` (`StateStore`), the spawn-side use in the adapters, the UI in
+ * `connectors/telegram/commands/claudeAccounts.ts`. Shaped for the later phases: a record carries room for a
+ * `limitedUntil` mark and a cached usage snapshot, and the resolver takes the known names so a selection that
+ * names a removed profile falls back instead of launching a dead directory.
+ */
+/** The profile that is `~/.claude` itself (no `CLAUDE_CONFIG_DIR`). */
+export declare const defaultClaudeProfileName = "default";
+/** Subdirectory of `DATA_DIR` that holds every profile's config directory. */
+export declare const claudeProfilesDirName = "claude-profiles";
+/**
+ * The entries a profile shares with `~/.claude` through symlinks. `projects/` is load-bearing: the bot reads
+ * transcripts from `~/.claude/projects` (`getClaudeProjectsRoot`) and `--resume` must find a conversation whatever
+ * account started it. The user memory (`CLAUDE.md`) is linked only when it exists (a dangling link would be a
+ * file the CLI tries to read on every start).
+ */
+export declare const claudeProfileSharedEntries: readonly ["projects", "settings.json", "skills", "plugins"];
+export declare const claudeProfileOptionalSharedEntries: readonly ["CLAUDE.md"];
+/** Profile names are safe slugs: they become a directory name and a button's `callback_data`. */
+export declare const claudeProfileNameMaxLength = 32;
+/** Longest `callback_data` prefix the account picker uses; with the name cap it stays far under Telegram's 64 bytes. */
+export declare const claudeAccountCallbackPrefix = "acct_";
+/**
+ * @description Whether `name` may name a NEW profile: a lowercase slug of at most {@link claudeProfileNameMaxLength}
+ * characters that is not the reserved `default`.
+ */
+export declare function checkIsValidClaudeProfileName(name: string): boolean;
+/** Lowercase + trim the operator's typed name before the gate (a `/account add MyWork` means `mywork`). */
+export declare function normaliseClaudeProfileName(raw: string): string;
+export declare function resolveClaudeProfilesRoot(dataDir: string): string;
+/**
+ * @description The config directory a profile hands the CLI, or `null` for `default` (nothing is set and the CLI
+ * uses `~/.claude`, or whatever `CLAUDE_CONFIG_DIR` the bot itself inherited).
+ */
+export declare function resolveClaudeProfileDir(dataDir: string, name: string): string | null;
+/** `~/.claude` — the directory the shared entries link back into. */
+export declare function resolveHomeClaudeDir(homeDir?: string): string;
+/**
+ * @description Create a profile's config directory: `0700`, with the shared entries symlinked into `~/.claude`.
+ * Idempotent — an existing directory keeps its login and only gains a missing link, so a re-run after a crash is
+ * safe. Refuses `default` and an invalid name (defence in depth: the command gate already rejected them).
+ * `~/.claude/projects` is created when absent so the link never dangles into the one entry the bot reads.
+ */
+export declare function createClaudeProfileLayout(input: {
+    dataDir: string;
+    name: string;
+    homeClaudeDir?: string;
+}): string;
+/**
+ * @description Remove a profile's directory — its login with it. `fs.rmSync` removes the symlinks AS LINKS, so
+ * the shared `~/.claude` entries behind them are never touched. Refuses `default`.
+ */
+export declare function removeClaudeProfileLayout(dataDir: string, name: string): void;
+/**
+ * @description Sign `~/.claude` (the `default` account) out by deleting ONLY its subscription login: the
+ * `claudeAiOauth` entry of `<homeClaudeDir>/.credentials.json`. The file's other entries (`mcpOAuth` tokens
+ * of MCP servers) stay; a file left with nothing else is deleted. `projects/`, settings, skills, plugins, the
+ * user memory and `~/.claude.json` are never touched. Returns whether a login was found and removed.
+ */
+export declare function signOutDefaultClaudeLogin(homeClaudeDir?: string): boolean;
+/** Whether a profile's directory exists on disk (the login may still be missing — see the auth status). */
+export declare function checkClaudeProfileDirExists(dataDir: string, name: string): boolean;
+/**
+ * @description Which profile a conversation uses: its own override when it names a known profile, else the
+ * instance default when THAT is known, else `default`. A selection that names a removed profile is not an
+ * error — the conversation silently runs on `default` (the removal already told the operator).
+ */
+export declare function resolveClaudeProfileName(input: {
+    globalDefault: string | undefined;
+    threadOverride: string | undefined;
+    knownNames: ReadonlySet<string>;
+}): string;
+/** What the account picker shows per profile, as the CLI reports it (`claude auth status --json`). */
+export interface ClaudeAuthStatus {
+    loggedIn: boolean;
+    email: string | null;
+    /** `pro` / `max` (personal), `team` / `enterprise` (corporate), or whatever newer CLIs add. */
+    subscriptionType: string | null;
+    orgName: string | null;
+}
+/**
+ * @description Parse the CLI's auth status. `null` for anything that is not the JSON object the CLI prints
+ * (the probe failed, an older CLI) — the caller treats it as "unknown", never as "logged out".
+ */
+export declare function parseClaudeAuthStatus(statusJson: string): ClaudeAuthStatus | null;
+/**
+ * @description The stdout a failed `execFile` carries, `''` for anything else. `claude auth status --json`
+ * exits NON-ZERO for a logged-out directory while printing its JSON (probed on 2.1.296), so the probe's
+ * rejection IS the answer — fed to {@link parseClaudeAuthStatus}, which yields `null` for an empty string.
+ */
+export declare function readProcessErrorStdout(error: unknown): string;
+export type ClaudeAccountKind = 'personal' | 'corporate' | 'unknown';
+/** Personal (`pro`, `max`) versus corporate (`team`, `enterprise`) subscription, from the CLI's `subscriptionType`. */
+export declare function getClaudeAccountKind(subscriptionType: string | null): ClaudeAccountKind;
+export declare const claudeConfigDirVariableName = "CLAUDE_CONFIG_DIR";
+/**
+ * @description Recover the `CLAUDE_CONFIG_DIR` a running process was started with from its command line —
+ * the json-stream wrapper script or a tmux pane's `#{pane_start_command}` — so an adopted process after a bot
+ * restart is compared against the profile its topic has NOW (a mismatch is corrected at the next idle point).
+ * The value is single-quoted by the bot's own quoting (`shellSingleQuote`), bare in older shapes; `null` when the
+ * command carries none (the default profile).
+ */
+export declare function parseClaudeConfigDirFromCommand(command: string): string | null;
+//# sourceMappingURL=claudeProfiles.d.ts.map

package/dist/utils/claudeProfiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claudeProfiles.d.ts","sourceRoot":"","sources":["../../src/utils/claudeProfiles.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAMH,uEAAuE;AACvE,eAAO,MAAM,wBAAwB,YAAY,CAAC;AAElD,8EAA8E;AAC9E,eAAO,MAAM,qBAAqB,oBAAoB,CAAC;AAEvD;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,6DAA8D,CAAC;AACtG,eAAO,MAAM,kCAAkC,wBAAyB,CAAC;AAEzE,iGAAiG;AACjG,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAG7C,wHAAwH;AACxH,eAAO,MAAM,2BAA2B,UAAU,CAAC;AAEnD;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnE;AAED,2GAA2G;AAC3G,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGpF;AAED,qEAAqE;AACrE,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,MAAqB,GAAG,MAAM,CAE3E;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CA6BlH;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAI7E;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,aAAa,GAAE,MAA+B,GAAG,OAAO,CAoBjG;AAED,2GAA2G;AAC3G,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAGlF;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAC9C,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACjC,GAAG,MAAM,CAMT;AAID,sGAAsG;AACtG,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,+FAA+F;IAC/F,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAiBjF;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAM7D;AAED,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,WAAW,GAAG,SAAS,CAAC;AAErE,uHAAuH;AACvH,wBAAgB,oBAAoB,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,GAAG,iBAAiB,CAMvF;AAID,eAAO,MAAM,2BAA2B,sBAAsB,CAAC;AAE/D;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM9E"}

package/dist/utils/claudeProfiles.js

@@ -0,0 +1,285 @@
+"use strict";
+/**
+ * @description Claude ACCOUNT PROFILES — several Claude subscription logins kept side by side, one picked per
+ * topic (`/account`). A profile is a Claude Code config directory of its own under
+ * `DATA_DIR/claude-profiles/<name>/`, handed to the CLI through `CLAUDE_CONFIG_DIR`: the CLI keeps its
+ * login (`.credentials.json`, `.claude.json`) there, while the entries that must stay ONE across accounts —
+ * the transcripts (`projects/`), settings, skills, plugins and the user memory — are symlinks back into
+ * `~/.claude`, so a conversation started under one account resumes under another and every account sees
+ * the same hooks and skills.
+ *
+ * The profile `default` IS `~/.claude` itself: nothing is set for it and nothing is migrated. A process is
+ * never switched by swapping files under `~/.claude` (the CLI re-reads its credentials live and EVERY running
+ * session would change account at once); the variable is per process, set at spawn.
+ *
+ * Pure helpers (layout, name gate, resolution, parsers) — the registry and the selection live in
+ * `state.json` (`StateStore`), the spawn-side use in the adapters, the UI in
+ * `connectors/telegram/commands/claudeAccounts.ts`. Shaped for the later phases: a record carries room for a
+ * `limitedUntil` mark and a cached usage snapshot, and the resolver takes the known names so a selection that
+ * names a removed profile falls back instead of launching a dead directory.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.claudeConfigDirVariableName = exports.claudeAccountCallbackPrefix = exports.claudeProfileNameMaxLength = exports.claudeProfileOptionalSharedEntries = exports.claudeProfileSharedEntries = exports.claudeProfilesDirName = exports.defaultClaudeProfileName = void 0;
+exports.checkIsValidClaudeProfileName = checkIsValidClaudeProfileName;
+exports.normaliseClaudeProfileName = normaliseClaudeProfileName;
+exports.resolveClaudeProfilesRoot = resolveClaudeProfilesRoot;
+exports.resolveClaudeProfileDir = resolveClaudeProfileDir;
+exports.resolveHomeClaudeDir = resolveHomeClaudeDir;
+exports.createClaudeProfileLayout = createClaudeProfileLayout;
+exports.removeClaudeProfileLayout = removeClaudeProfileLayout;
+exports.signOutDefaultClaudeLogin = signOutDefaultClaudeLogin;
+exports.checkClaudeProfileDirExists = checkClaudeProfileDirExists;
+exports.resolveClaudeProfileName = resolveClaudeProfileName;
+exports.parseClaudeAuthStatus = parseClaudeAuthStatus;
+exports.readProcessErrorStdout = readProcessErrorStdout;
+exports.getClaudeAccountKind = getClaudeAccountKind;
+exports.parseClaudeConfigDirFromCommand = parseClaudeConfigDirFromCommand;
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+/** The profile that is `~/.claude` itself (no `CLAUDE_CONFIG_DIR`). */
+exports.defaultClaudeProfileName = 'default';
+/** Subdirectory of `DATA_DIR` that holds every profile's config directory. */
+exports.claudeProfilesDirName = 'claude-profiles';
+/**
+ * The entries a profile shares with `~/.claude` through symlinks. `projects/` is load-bearing: the bot reads
+ * transcripts from `~/.claude/projects` (`getClaudeProjectsRoot`) and `--resume` must find a conversation whatever
+ * account started it. The user memory (`CLAUDE.md`) is linked only when it exists (a dangling link would be a
+ * file the CLI tries to read on every start).
+ */
+exports.claudeProfileSharedEntries = ['projects', 'settings.json', 'skills', 'plugins'];
+exports.claudeProfileOptionalSharedEntries = ['CLAUDE.md'];
+/** Profile names are safe slugs: they become a directory name and a button's `callback_data`. */
+exports.claudeProfileNameMaxLength = 32;
+const claudeProfileNameRe = /^[a-z0-9][a-z0-9_-]{0,31}$/;
+/** Longest `callback_data` prefix the account picker uses; with the name cap it stays far under Telegram's 64 bytes. */
+exports.claudeAccountCallbackPrefix = 'acct_';
+/**
+ * @description Whether `name` may name a NEW profile: a lowercase slug of at most {@link claudeProfileNameMaxLength}
+ * characters that is not the reserved `default`.
+ */
+function checkIsValidClaudeProfileName(name) {
+    return name !== exports.defaultClaudeProfileName && claudeProfileNameRe.test(name);
+}
+/** Lowercase + trim the operator's typed name before the gate (a `/account add MyWork` means `mywork`). */
+function normaliseClaudeProfileName(raw) {
+    return raw.trim().toLowerCase();
+}
+function resolveClaudeProfilesRoot(dataDir) {
+    return path.join(dataDir, exports.claudeProfilesDirName);
+}
+/**
+ * @description The config directory a profile hands the CLI, or `null` for `default` (nothing is set and the CLI
+ * uses `~/.claude`, or whatever `CLAUDE_CONFIG_DIR` the bot itself inherited).
+ */
+function resolveClaudeProfileDir(dataDir, name) {
+    if (name === exports.defaultClaudeProfileName)
+        return null;
+    return path.join(resolveClaudeProfilesRoot(dataDir), name);
+}
+/** `~/.claude` — the directory the shared entries link back into. */
+function resolveHomeClaudeDir(homeDir = os.homedir()) {
+    return path.join(homeDir, '.claude');
+}
+/**
+ * @description Create a profile's config directory: `0700`, with the shared entries symlinked into `~/.claude`.
+ * Idempotent — an existing directory keeps its login and only gains a missing link, so a re-run after a crash is
+ * safe. Refuses `default` and an invalid name (defence in depth: the command gate already rejected them).
+ * `~/.claude/projects` is created when absent so the link never dangles into the one entry the bot reads.
+ */
+function createClaudeProfileLayout(input) {
+    const { dataDir, name } = input;
+    if (!checkIsValidClaudeProfileName(name))
+        throw new Error(`invalid Claude profile name: ${JSON.stringify(name)}`);
+    const homeClaudeDir = input.homeClaudeDir ?? resolveHomeClaudeDir();
+    const dir = resolveClaudeProfileDir(dataDir, name);
+    if (dir === null)
+        throw new Error('the default profile has no directory of its own');
+    fs.mkdirSync(resolveClaudeProfilesRoot(dataDir), { recursive: true, mode: 0o700 });
+    fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
+    fs.chmodSync(dir, 0o700);
+    fs.mkdirSync(path.join(homeClaudeDir, 'projects'), { recursive: true });
+    const linked = [...exports.claudeProfileSharedEntries];
+    for (const entry of exports.claudeProfileOptionalSharedEntries) {
+        if (fs.existsSync(path.join(homeClaudeDir, entry)))
+            linked.push(entry);
+    }
+    for (const entry of linked) {
+        const linkPath = path.join(dir, entry);
+        const target = path.join(homeClaudeDir, entry);
+        try {
+            const existing = fs.lstatSync(linkPath);
+            // A real file or dir of the profile's own (the CLI wrote one before the link existed) is left alone.
+            if (!existing.isSymbolicLink())
+                continue;
+            if (fs.readlinkSync(linkPath) === target)
+                continue;
+            fs.unlinkSync(linkPath);
+        }
+        catch {
+            /* absent → create below */
+        }
+        fs.symlinkSync(target, linkPath);
+    }
+    return dir;
+}
+/**
+ * @description Remove a profile's directory — its login with it. `fs.rmSync` removes the symlinks AS LINKS, so
+ * the shared `~/.claude` entries behind them are never touched. Refuses `default`.
+ */
+function removeClaudeProfileLayout(dataDir, name) {
+    const dir = resolveClaudeProfileDir(dataDir, name);
+    if (dir === null || !checkIsValidClaudeProfileName(name))
+        throw new Error(`cannot remove the Claude profile ${JSON.stringify(name)}`);
+    fs.rmSync(dir, { recursive: true, force: true });
+}
+/**
+ * @description Sign `~/.claude` (the `default` account) out by deleting ONLY its subscription login: the
+ * `claudeAiOauth` entry of `<homeClaudeDir>/.credentials.json`. The file's other entries (`mcpOAuth` tokens
+ * of MCP servers) stay; a file left with nothing else is deleted. `projects/`, settings, skills, plugins, the
+ * user memory and `~/.claude.json` are never touched. Returns whether a login was found and removed.
+ */
+function signOutDefaultClaudeLogin(homeClaudeDir = resolveHomeClaudeDir()) {
+    const file = path.join(homeClaudeDir, '.credentials.json');
+    let parsed;
+    try {
+        parsed = JSON.parse(fs.readFileSync(file, 'utf8'));
+    }
+    catch {
+        return false;
+    }
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed) || !('claudeAiOauth' in parsed))
+        return false;
+    const rest = { ...parsed };
+    delete rest.claudeAiOauth;
+    if (Object.keys(rest).length === 0) {
+        fs.rmSync(file, { force: true });
+        return true;
+    }
+    const mode = fs.statSync(file).mode & 0o777;
+    const tmp = `${file}.${process.pid}.tmp`;
+    fs.writeFileSync(tmp, JSON.stringify(rest), { mode });
+    fs.renameSync(tmp, file);
+    return true;
+}
+/** Whether a profile's directory exists on disk (the login may still be missing — see the auth status). */
+function checkClaudeProfileDirExists(dataDir, name) {
+    const dir = resolveClaudeProfileDir(dataDir, name);
+    return dir === null ? true : fs.existsSync(dir);
+}
+/**
+ * @description Which profile a conversation uses: its own override when it names a known profile, else the
+ * instance default when THAT is known, else `default`. A selection that names a removed profile is not an
+ * error — the conversation silently runs on `default` (the removal already told the operator).
+ */
+function resolveClaudeProfileName(input) {
+    const checkIsKnown = (name) => name !== undefined && (name === exports.defaultClaudeProfileName || input.knownNames.has(name));
+    if (checkIsKnown(input.threadOverride))
+        return input.threadOverride;
+    if (checkIsKnown(input.globalDefault))
+        return input.globalDefault;
+    return exports.defaultClaudeProfileName;
+}
+/**
+ * @description Parse the CLI's auth status. `null` for anything that is not the JSON object the CLI prints
+ * (the probe failed, an older CLI) — the caller treats it as "unknown", never as "logged out".
+ */
+function parseClaudeAuthStatus(statusJson) {
+    let parsed;
+    try {
+        parsed = JSON.parse(statusJson);
+    }
+    catch {
+        return null;
+    }
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed))
+        return null;
+    const record = parsed;
+    if (typeof record.loggedIn !== 'boolean')
+        return null;
+    const readString = (value) => (typeof value === 'string' && value.trim() !== '' ? value : null);
+    return {
+        loggedIn: record.loggedIn,
+        email: readString(record.email),
+        subscriptionType: readString(record.subscriptionType),
+        orgName: readString(record.orgName),
+    };
+}
+/**
+ * @description The stdout a failed `execFile` carries, `''` for anything else. `claude auth status --json`
+ * exits NON-ZERO for a logged-out directory while printing its JSON (probed on 2.1.296), so the probe's
+ * rejection IS the answer — fed to {@link parseClaudeAuthStatus}, which yields `null` for an empty string.
+ */
+function readProcessErrorStdout(error) {
+    if (!error || typeof error !== 'object')
+        return '';
+    const stdout = error.stdout;
+    if (typeof stdout === 'string')
+        return stdout;
+    if (Buffer.isBuffer(stdout))
+        return stdout.toString('utf8');
+    return '';
+}
+/** Personal (`pro`, `max`) versus corporate (`team`, `enterprise`) subscription, from the CLI's `subscriptionType`. */
+function getClaudeAccountKind(subscriptionType) {
+    if (subscriptionType === null)
+        return 'unknown';
+    const normalised = subscriptionType.toLowerCase();
+    if (normalised === 'pro' || normalised === 'max')
+        return 'personal';
+    if (normalised === 'team' || normalised === 'enterprise')
+        return 'corporate';
+    return 'unknown';
+}
+// ── the spawn-side variable ──
+exports.claudeConfigDirVariableName = 'CLAUDE_CONFIG_DIR';
+/**
+ * @description Recover the `CLAUDE_CONFIG_DIR` a running process was started with from its command line —
+ * the json-stream wrapper script or a tmux pane's `#{pane_start_command}` — so an adopted process after a bot
+ * restart is compared against the profile its topic has NOW (a mismatch is corrected at the next idle point).
+ * The value is single-quoted by the bot's own quoting (`shellSingleQuote`), bare in older shapes; `null` when the
+ * command carries none (the default profile).
+ */
+function parseClaudeConfigDirFromCommand(command) {
+    // `shellSingleQuote` wraps the WHOLE assignment (`'CLAUDE_CONFIG_DIR=/dir'`), an embedded quote becoming `'\''`.
+    const match = command.match(/(?:^|\s)(?:'CLAUDE_CONFIG_DIR=((?:[^']|'\\'')*)'|"CLAUDE_CONFIG_DIR=([^"]*)"|CLAUDE_CONFIG_DIR=(\S+))/);
+    if (!match)
+        return null;
+    if (match[1] !== undefined)
+        return match[1].replace(/'\\''/g, "'");
+    return match[2] ?? match[3] ?? null;
+}
+//# sourceMappingURL=claudeProfiles.js.map

package/dist/utils/claudeProfiles.js.map

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

package/dist/utils/claudeRelayRouting.d.ts

@@ -0,0 +1,86 @@
+/**
+ * @description PURE decision layer that routes the {@link ClaudeChunkSegment}s
+ * of one classified Claude scrape chunk through a thread's display-verbosity
+ * prefs (S4 `/tool_results`). Given the ordered, tagged segments and the
+ * resolved prefs it decides — per segment — whether the lines are RELAYED as
+ * permanent output, TRUNCATED, or FOLDED into the rolling status frame, and
+ * returns the reassembled permanent text plus the latest folded activity line.
+ *
+ * Kept pure (no tmux / emit) so the segment×pref matrix is unit-testable
+ * without the live relay — same shape as `toolResultRender.ts` /
+ * `subagentRender.ts`. The Claude adapter's `pollOutput` calls this, then feeds
+ * `keptText` through `stripTuiElementsWithContext` exactly as the pre-S4 path
+ * did (the stripper stays the chrome/fence backstop).
+ *
+ * Scope: the TOOL, THINKING and PANEL-PREVIEW segments branch on a pref.
+ *  - `thinkingBlock` follows the `/thinking` pref (S5): full keeps it verbatim;
+ *    short collapses to one `💭 thought for {N}s` when a duration is parseable
+ *    from the block, else folds the live `☁️ thinking …` into status; minimal
+ *    always folds the live status, nothing permanent.
+ *  - `subagentPanelPreview` is ALWAYS folded to status (the overview-2 flood;
+ *    S6 formalises, doing it here is part of killing the flood).
+ *  - `prose` is ALWAYS kept (the agent's answer is never swallowed).
+ *  - `chrome` is ALWAYS dropped (as the pre-S4 stripper did).
+ */
+import { type ClaudeChunkSegment } from './claudeChunkClassifier';
+import type { DisplayVerbosityMode } from '../types';
+/** Result of {@link routeClaudeChunkSegments}. */
+export interface ClaudeRelayRouting {
+    /** The lines to relay as PERMANENT output (reassembled, NL-joined). May be
+     * empty when every routable segment folded to status. */
+    keptText: string;
+    /** The LATEST folded activity (a `minimal` tool header, a panel preview, or a
+     * folded `☁️ thinking …` status) to show in the rolling status frame, or null
+     * when nothing folded. */
+    activityLine: string | null;
+}
+/**
+ * @description Extract a compact tool label from a tool-header line for the
+ * folded `minimal` activity line. Returns the tool NAME (`Bash`, `Read`, …)
+ * when recognised, else the trimmed first line as a last resort (never empty).
+ */
+export declare function getToolActivityLabel(headerText: string): string;
+/**
+ * @description Route one classified chunk's segments through the tool-results
+ * mode (S4). Walks the segments IN ORDER so `keptText` preserves the pane's
+ * line order; `activityLine` carries only the LAST folded activity (the status
+ * frame shows one line). Pure — the caller threads cross-poll fence context and
+ * does the strip/emit.
+ *
+ * Per tag:
+ *  - `prose`                → keep verbatim (always).
+ *  - `thinkingBlock`        → full: keep verbatim; short: collapse to one
+ *                             `💭 thought for {N}s` when a duration is parseable,
+ *                             else fold the live `☁️ thinking …`; minimal: always
+ *                             fold the live status, nothing permanent.
+ *  - `toolHeader`/`toolBody`→ full: keep; short: keep header, truncate body;
+ *                             minimal: drop, fold a `🔧 <tool> …` activity from
+ *                             the latest header (built by the caller via i18n).
+ *  - `subagentPanelPreview` → always fold (drop, contribute an activity).
+ *  - `chrome`               → drop.
+ *
+ * @param segments classified segments, original order.
+ * @param toolResultsMode the thread's `/tool_results` pref.
+ * @param thinkingMode the thread's `/thinking` pref (S5).
+ * @param buildToolActivity caller-supplied builder turning a tool label into a
+ *   user-facing activity line (keeps i18n in `bot.ts`/`i18n.ts`, not here).
+ * @param buildPanelActivity caller-supplied builder for a folded panel preview.
+ * @param buildThinkingActivity caller-supplied builder for the folded live
+ *   `☁️ thinking …` status line (short with no duration / minimal).
+ * @param buildThoughtCollapsed caller-supplied builder turning a parsed duration
+ *   into the permanent `💭 thought for {N}s` line (short with a duration).
+ * @param truncationFooter the i18n "… (truncated, /tool_results full)" line
+ *   appended to a `short`-mode body that was actually capped — parity with the
+ *   OpenCode short path so a Claude user also learns `full` reveals the rest.
+ */
+export declare function routeClaudeChunkSegments(segments: ClaudeChunkSegment[], toolResultsMode: DisplayVerbosityMode, thinkingMode: DisplayVerbosityMode, buildToolActivity: (toolLabel: string) => string, buildPanelActivity: () => string, buildThinkingActivity: () => string, buildThoughtCollapsed: (seconds: number) => string, truncationFooter: string): ClaudeRelayRouting;
+/**
+ * @description Whether a classified chunk can skip the segment-walk and run the
+ * pre-S4 direct strip→emit path BYTE-IDENTICALLY: all-`full` tool + thinking
+ * prefs AND no sub-agent panel-preview segment (the one thing the old path did
+ * NOT fold). The regression anchor — when true the relay output is provably the
+ * same as before S4. (Re-exported as a named helper so the live fast-path and
+ * its test assert the SAME predicate.)
+ */
+export declare function checkIsClaudeRelayFastPath(segments: ClaudeChunkSegment[], toolResultsMode: DisplayVerbosityMode, thinkingMode: DisplayVerbosityMode): boolean;
+//# sourceMappingURL=claudeRelayRouting.d.ts.map

package/dist/utils/claudeRelayRouting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claudeRelayRouting.d.ts","sourceRoot":"","sources":["../../src/utils/claudeRelayRouting.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAkB,KAAK,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAGlF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAOrD,kDAAkD;AAClD,MAAM,WAAW,kBAAkB;IACjC;6DACyD;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB;;8BAE0B;IAC1B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAK/D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,kBAAkB,EAAE,EAC9B,eAAe,EAAE,oBAAoB,EACrC,YAAY,EAAE,oBAAoB,EAClC,iBAAiB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,EAChD,kBAAkB,EAAE,MAAM,MAAM,EAChC,qBAAqB,EAAE,MAAM,MAAM,EACnC,qBAAqB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,EAClD,gBAAgB,EAAE,MAAM,GACvB,kBAAkB,CAkEpB;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,kBAAkB,EAAE,EAC9B,eAAe,EAAE,oBAAoB,EACrC,YAAY,EAAE,oBAAoB,GACjC,OAAO,CAGT"}