coolhand-cli 0.9.0 → 0.10.0

package/dist/commands/map-claude-projects.d.ts

@@ -0,0 +1,22 @@
+import type { MapClaudeProjectsOptions } from '../types.js';
+export interface MapClaudeProjectsDeps {
+    homedir?: () => string;
+}
+/**
+ * Find every directory named "claude" (see `isClaudeDirName`), searching recursively from
+ * `root`. A match is not itself searched further — its full contents are captured by
+ * `appendTree` instead, so a nested "claude" folder inside a match isn't double-reported as its
+ * own match. A *symlinked* "claude"/".claude" directory still counts as a match (dotfile
+ * managers like chezmoi/Stow/yadm commonly manage `~/.claude` this way) — only non-matching
+ * symlinked directories are skipped during further recursion, to avoid link loops and escaping
+ * `root`. Unreadable directories (permissions, etc.) are skipped rather than aborting the whole
+ * scan.
+ *
+ * Being recorded as a match here does not by itself mean its contents get walked — a matched
+ * symlink whose target resolves outside `root` is caller-checked (see `resolvesWithinRoot`,
+ * used in `run()`) and its contents are never enumerated, since nothing here constrains where a
+ * "claude"-named symlink's target actually lives.
+ */
+export declare function findClaudeDirs(root: string): Promise<string[]>;
+export declare function run(opts: MapClaudeProjectsOptions, deps?: MapClaudeProjectsDeps): Promise<number>;
+//# sourceMappingURL=map-claude-projects.d.ts.map

package/dist/commands/map-claude-projects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-claude-projects.d.ts","sourceRoot":"","sources":["../../src/commands/map-claude-projects.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAE5D,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,EAAE,MAAM,MAAM,CAAC;CACxB;AASD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAgDpE;AA4HD,wBAAsB,GAAG,CAAC,IAAI,EAAE,wBAAwB,EAAE,IAAI,GAAE,qBAA0B,GAAG,OAAO,CAAC,MAAM,CAAC,CA0G3G"}

package/dist/commands/map-claude-projects.js

@@ -0,0 +1,282 @@
+import { promises as fs } from 'fs';
+import * as os from 'os';
+import * as path from 'path';
+import { randomBytes } from 'crypto';
+import { CliError, ExitCode } from '../errors.js';
+import { logger, redact } from '../logger.js';
+import { uploadClientFile } from '../upload-client-file.js';
+/** Matches "claude"/"Claude" and also the dotfile convention "`.claude`"/"`.Claude`" (Claude
+ *  Code's own home directory) — a leading dot is stripped before comparison, everything else
+ *  must match exactly (not a substring match, so "claude-code" or "my-claude-notes" don't count). */
+function isClaudeDirName(name) {
+    return name.replace(/^\./, '').toLowerCase() === 'claude';
+}
+/**
+ * Find every directory named "claude" (see `isClaudeDirName`), searching recursively from
+ * `root`. A match is not itself searched further — its full contents are captured by
+ * `appendTree` instead, so a nested "claude" folder inside a match isn't double-reported as its
+ * own match. A *symlinked* "claude"/".claude" directory still counts as a match (dotfile
+ * managers like chezmoi/Stow/yadm commonly manage `~/.claude` this way) — only non-matching
+ * symlinked directories are skipped during further recursion, to avoid link loops and escaping
+ * `root`. Unreadable directories (permissions, etc.) are skipped rather than aborting the whole
+ * scan.
+ *
+ * Being recorded as a match here does not by itself mean its contents get walked — a matched
+ * symlink whose target resolves outside `root` is caller-checked (see `resolvesWithinRoot`,
+ * used in `run()`) and its contents are never enumerated, since nothing here constrains where a
+ * "claude"-named symlink's target actually lives.
+ */
+export async function findClaudeDirs(root) {
+    if (isClaudeDirName(path.basename(root))) {
+        // Unlike every match found via walk() below, root is handed to us directly rather than
+        // discovered via fs.readdir — nothing has confirmed it actually exists or is a directory
+        // yet. Without this check, a nonexistent or wrong-type --root (e.g. `--root ~/.claude` on a
+        // machine where that path doesn't exist — exactly the usage docs/commands.md recommends)
+        // would be reported as a real match, and the empty/failing walk downstream would silently
+        // produce and upload a near-empty "successful" report instead of a clear "not found" result.
+        const rootStat = await fs.stat(root).catch(() => null);
+        return rootStat?.isDirectory() ? [root] : [];
+    }
+    const matches = [];
+    async function walk(dir) {
+        let entries;
+        try {
+            entries = await fs.readdir(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            const fullPath = path.join(dir, entry.name);
+            if (isClaudeDirName(entry.name)) {
+                if (entry.isDirectory()) {
+                    matches.push(fullPath);
+                }
+                else if (entry.isSymbolicLink()) {
+                    // Resolve the target to confirm it's actually a directory before recording it as a
+                    // match (a symlink to a plain file literally named "claude" wouldn't be one). A
+                    // broken/looping symlink fails fs.stat and is simply not reported as a match.
+                    const targetStat = await fs.stat(fullPath).catch(() => null);
+                    if (targetStat?.isDirectory()) {
+                        matches.push(fullPath);
+                    }
+                }
+                continue; // matched (or matched-by-name-but-not-a-dir) — never searched further either way
+            }
+            if (entry.isSymbolicLink() || !entry.isDirectory()) {
+                continue; // non-matching symlink or non-directory — never followed
+            }
+            await walk(fullPath);
+        }
+    }
+    await walk(root);
+    return matches;
+}
+/**
+ * Wrap `text` in a markdown inline-code span that's safe even if `text` itself contains
+ * backticks (a literal backtick in a filename would otherwise prematurely close the span and
+ * mangle the rest of the report) — CommonMark's own rule: a code span delimited by N backticks
+ * can safely contain any run of fewer than N backticks, as long as it's not at the very edge.
+ *
+ * A literal newline (legal in a POSIX filename) is replaced with a visible placeholder rather
+ * than left as-is: CommonMark only collapses line endings *inside* a code span when the span
+ * stays within one block, which doesn't hold across an ATX heading's own line boundary (this
+ * function is also used to build `## <match>` headings) — an embedded `\n` would otherwise split
+ * the heading into two lines, one with an unclosed code span.
+ */
+function mdInlineCode(text) {
+    const singleLine = text.replace(/\r\n|\r|\n/g, '␤');
+    const runs = singleLine.match(/`+/g);
+    const longestRun = runs ? Math.max(...runs.map((r) => r.length)) : 0;
+    if (longestRun === 0) {
+        return `\`${singleLine}\``;
+    }
+    const fence = '`'.repeat(longestRun + 1);
+    return `${fence} ${singleLine} ${fence}`;
+}
+/**
+ * Resolve both `root` and `target` to their canonical (symlink-free) paths and report whether
+ * `target` actually lives under `root` — used to decide whether a *matched* symlinked directory
+ * (see `findClaudeDirs`) is safe to walk. A `claude`/`.claude` symlink is recorded as a match
+ * without regard for where it points, so without this check a planted symlink anywhere under the
+ * search root (a malicious repo clone, an extracted archive) could point at an arbitrary
+ * unrelated directory — `/`, `~/.ssh`, a mounted volume — and have its entire contents (every
+ * filename, size, and timestamp) enumerated into the uploaded report. If either path fails to
+ * resolve (e.g. a dangling symlink), this conservatively reports "does not resolve within root".
+ */
+async function resolvesWithinRoot(root, target) {
+    const [realRoot, realTarget] = await Promise.all([
+        fs.realpath(root).catch(() => null),
+        fs.realpath(target).catch(() => null),
+    ]);
+    if (realRoot === null || realTarget === null) {
+        return { within: false, realTarget };
+    }
+    const relative = path.relative(realRoot, realTarget);
+    const within = relative === '' || (!relative.startsWith('..') && !path.isAbsolute(relative));
+    return { within, realTarget };
+}
+/**
+ * Depth-first append of `dir`'s full contents (recursive, no exclusions) to `lines` as an
+ * indented markdown list, one entry per file/directory, each annotated with basic metadata
+ * (size, extension, created/modified times for files). Never reads file *contents* — only
+ * filesystem metadata — so nothing from inside these folders leaves the machine except names
+ * and stats.
+ */
+async function appendTree(lines, dir, depth) {
+    const indent = '  '.repeat(depth);
+    let entries;
+    try {
+        entries = await fs.readdir(dir, { withFileTypes: true });
+    }
+    catch (err) {
+        lines.push(`${indent}- ⚠️ (unreadable: ${err.message})`);
+        return;
+    }
+    entries.sort((a, b) => a.name.localeCompare(b.name));
+    for (const entry of entries) {
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isSymbolicLink()) {
+            // Resolve the target only to tell a file from a directory — a symlinked directory is
+            // never followed (avoids link loops and escaping dir), but a symlinked file is safe to
+            // list (using the target's metadata) since nothing recurses into it.
+            let targetStat;
+            try {
+                targetStat = await fs.stat(fullPath);
+            }
+            catch (err) {
+                lines.push(`${indent}- ${mdInlineCode(entry.name)} (broken symlink: ${err.message})`);
+                continue;
+            }
+            if (targetStat.isDirectory()) {
+                lines.push(`${indent}- 📁 ${mdInlineCode(`${entry.name}/`)} (symlink to a directory, not followed)`);
+                continue;
+            }
+            const ext = path.extname(entry.name) || '(none)';
+            const kb = (targetStat.size / 1024).toFixed(1);
+            lines.push(`${indent}- 📄 ${mdInlineCode(entry.name)} (symlink) — ${kb} KB, ${ext}, ` +
+                `created ${targetStat.birthtime.toISOString()}, modified ${targetStat.mtime.toISOString()}`);
+            continue;
+        }
+        let stat;
+        try {
+            stat = await fs.stat(fullPath);
+        }
+        catch (err) {
+            lines.push(`${indent}- ${mdInlineCode(entry.name)} (unreadable: ${err.message})`);
+            continue;
+        }
+        if (entry.isDirectory()) {
+            lines.push(`${indent}- 📁 ${mdInlineCode(`${entry.name}/`)} — modified ${stat.mtime.toISOString()}`);
+            await appendTree(lines, fullPath, depth + 1);
+            continue;
+        }
+        if (!entry.isFile()) {
+            // A special file — socket, FIFO, block/char device. Rare under a Claude config directory,
+            // but "no exclusions" means it still gets a line rather than vanishing without a trace.
+            lines.push(`${indent}- ${mdInlineCode(entry.name)} (special file, not a regular file or directory)`);
+            continue;
+        }
+        const ext = path.extname(entry.name) || '(none)';
+        const kb = (stat.size / 1024).toFixed(1);
+        lines.push(`${indent}- 📄 ${mdInlineCode(entry.name)} — ${kb} KB, ${ext}, ` +
+            `created ${stat.birthtime.toISOString()}, modified ${stat.mtime.toISOString()}`);
+    }
+}
+export async function run(opts, deps = {}) {
+    try {
+        const root = opts.root ?? (deps.homedir ?? os.homedir)();
+        const matches = await findClaudeDirs(root);
+        if (matches.length === 0) {
+            if (opts.json) {
+                logger.json({ ok: true, matches: 0, matchedPaths: [] });
+            }
+            else {
+                logger.info(`No folders named "claude" found under ${root}.`);
+            }
+            return ExitCode.OK;
+        }
+        const lines = [
+            '# Claude Folders Map',
+            '',
+            `Generated ${new Date().toISOString()} — ${matches.length} folder(s) matching "claude" found under ${mdInlineCode(root)}.`,
+            '',
+        ];
+        for (const match of matches) {
+            // mdInlineCode also replaces any stray newline byte in a directory name, not just
+            // backticks — a heading built from a raw, unescaped path could otherwise be split across
+            // lines (see mdInlineCode's own doc comment for why the newline handling lives there).
+            lines.push(`## ${mdInlineCode(match)}`, '');
+            const matchLstat = await fs.lstat(match).catch(() => null);
+            const escape = matchLstat?.isSymbolicLink() ? await resolvesWithinRoot(root, match) : null;
+            if (escape && !escape.within) {
+                lines.push(`- ⚠️ This is a symlink that resolves outside the search root` +
+                    (escape.realTarget ? ` (to ${mdInlineCode(escape.realTarget)})` : ' (target could not be resolved)') +
+                    ` — not followed, to avoid leaking an unrelated location's contents via a planted symlink.`);
+            }
+            else {
+                await appendTree(lines, match, 0);
+            }
+            lines.push('');
+        }
+        const markdown = `${lines.join('\n')}\n`;
+        if (opts.output) {
+            // Same sensitivity as the upload temp file below (real filenames from every matched
+            // folder) — 0o600, and written before the upload attempt so it's available for inspection
+            // even if the upload itself fails.
+            await fs.writeFile(opts.output, markdown, { encoding: 'utf8', mode: 0o600 });
+        }
+        const tmpPath = path.join(os.tmpdir(), `coolhand-claude-map-${randomBytes(6).toString('hex')}.md`);
+        // The report lists real filenames (and thus can be sensitive) from every matched folder —
+        // 0o600 keeps it unreadable by other local users for as long as it exists on disk, matching
+        // the mode used for other sensitive files elsewhere (src/config.ts, capture-state.ts).
+        await fs.writeFile(tmpPath, markdown, { encoding: 'utf8', mode: 0o600 });
+        try {
+            const result = await uploadClientFile({
+                filePath: tmpPath,
+                name: 'Claude Folders Map',
+                fileType: 'report',
+                description: `File tree map of ${matches.length} folder(s) named "claude" under ${root} (names and metadata only — no file contents).`,
+                metadata: { source: 'map-claude-projects', matchCount: matches.length, root },
+            }, { clientId: opts.clientId, dryRun: opts.dryRun });
+            const mb = (result.sizeBytes / (1024 * 1024)).toFixed(2);
+            if (opts.json) {
+                logger.json({
+                    ok: true,
+                    dryRun: result.status === 'dry-run',
+                    matches: matches.length,
+                    matchedPaths: matches,
+                    sizeBytes: result.sizeBytes,
+                    ...(opts.output && { outputPath: opts.output }),
+                    result: result.response,
+                });
+            }
+            else if (result.status === 'dry-run') {
+                logger.info(`Dry run: found ${matches.length} folder(s), map is ${mb}MB. Nothing sent.` +
+                    (opts.output ? ` Report written to ${opts.output}.` : ''));
+            }
+            else {
+                logger.info(`Uploaded a map of ${matches.length} folder(s) (${mb}MB) as client file ` +
+                    `"${result.response?.name}" (id: ${result.response?.id}).` +
+                    (opts.output ? ` Report also written to ${opts.output}.` : ''));
+            }
+            return ExitCode.OK;
+        }
+        finally {
+            await fs.rm(tmpPath, { force: true }).catch(() => undefined);
+        }
+    }
+    catch (err) {
+        if (err instanceof CliError) {
+            if (opts.json) {
+                logger.json({ ok: false, error: err.code, message: redact(err.message) });
+            }
+            else {
+                logger.info(`Error: ${redact(err.message)} [${err.code}]`);
+            }
+            return err.exitCode;
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=map-claude-projects.js.map

package/dist/commands/map-claude-projects.js.map

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

package/dist/commands/upload-client-file.d.ts

@@ -0,0 +1,3 @@
+import type { UploadClientFileOptions } from '../types.js';
+export declare function run(opts: UploadClientFileOptions): Promise<number>;
+//# sourceMappingURL=upload-client-file.d.ts.map

package/dist/commands/upload-client-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-client-file.d.ts","sourceRoot":"","sources":["../../src/commands/upload-client-file.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAE3D,wBAAsB,GAAG,CAAC,IAAI,EAAE,uBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC,CAyCxE"}

package/dist/commands/upload-client-file.js

@@ -0,0 +1,43 @@
+import { CliError, ExitCode } from '../errors.js';
+import { logger, redact } from '../logger.js';
+import { uploadClientFile } from '../upload-client-file.js';
+export async function run(opts) {
+    try {
+        const result = await uploadClientFile({
+            filePath: opts.filePath,
+            name: opts.name,
+            fileType: opts.fileType,
+            description: opts.description,
+        }, { clientId: opts.clientId, dryRun: opts.dryRun });
+        const mb = (result.sizeBytes / (1024 * 1024)).toFixed(2);
+        if (opts.json) {
+            logger.json({
+                ok: true,
+                dryRun: result.status === 'dry-run',
+                sizeBytes: result.sizeBytes,
+                result: result.response,
+            });
+        }
+        else if (result.status === 'dry-run') {
+            logger.info(`Dry run: would upload "${opts.filePath}" (${mb}MB). Nothing sent.`);
+        }
+        else {
+            logger.info(`Uploaded "${opts.filePath}" (${mb}MB) as client file "${result.response?.name}" ` +
+                `(id: ${result.response?.id}, status: ${result.response?.status}).`);
+        }
+        return ExitCode.OK;
+    }
+    catch (err) {
+        if (err instanceof CliError) {
+            if (opts.json) {
+                logger.json({ ok: false, error: err.code, message: redact(err.message) });
+            }
+            else {
+                logger.info(`Error: ${redact(err.message)} [${err.code}]`);
+            }
+            return err.exitCode;
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=upload-client-file.js.map

package/dist/commands/upload-client-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-client-file.js","sourceRoot":"","sources":["../../src/commands/upload-client-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAG5D,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,IAA6B;IACrD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,gBAAgB,CACnC;YACE,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,WAAW,EAAE,IAAI,CAAC,WAAW;SAC9B,EACD,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CACjD,CAAC;QAEF,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAEzD,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,MAAM,CAAC,IAAI,CAAC;gBACV,EAAE,EAAE,IAAI;gBACR,MAAM,EAAE,MAAM,CAAC,MAAM,KAAK,SAAS;gBACnC,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,MAAM,EAAE,MAAM,CAAC,QAAQ;aACxB,CAAC,CAAC;QACL,CAAC;aAAM,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACvC,MAAM,CAAC,IAAI,CAAC,0BAA0B,IAAI,CAAC,QAAQ,MAAM,EAAE,oBAAoB,CAAC,CAAC;QACnF,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,CACT,aAAa,IAAI,CAAC,QAAQ,MAAM,EAAE,uBAAuB,MAAM,CAAC,QAAQ,EAAE,IAAI,IAAI;gBAChF,QAAQ,MAAM,CAAC,QAAQ,EAAE,EAAE,aAAa,MAAM,CAAC,QAAQ,EAAE,MAAM,IAAI,CACtE,CAAC;QACJ,CAAC;QACD,OAAO,QAAQ,CAAC,EAAE,CAAC;IACrB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,QAAQ,EAAE,CAAC;YAC5B,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YAC5E,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,IAAI,CAAC,UAAU,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC;YAC7D,CAAC;YACD,OAAO,GAAG,CAAC,QAAQ,CAAC;QACtB,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/commands/wildcard.d.ts

@@ -1,11 +1,11 @@
 import { type ComplaintBoxOptions } from '../types.js';
 /**
- * Records an agent's free-form "I am blocked, this capability does not exist"
- * complaint as feedback (tagged creator_type: "agent"), then prints a terminal
- * de-loop message and exits 0 so the agent stops and moves on. The de-loop ALWAYS
- * fires — even when the feedback could not be recorded — because the missing
- * capability is real regardless of server state (and a logged-out agent in a
- * sandbox is exactly who this command is for). When recording fails it says so
+ * Records an agent's free-form "I am blocked — a capability doesn't exist, or this
+ * task would take too long" complaint as feedback (tagged creator_type: "agent"),
+ * then prints a terminal de-loop message and exits 0 so the agent stops and moves
+ * on. The de-loop ALWAYS fires — even when the feedback could not be recorded —
+ * because the blocker is real regardless of server state (and a logged-out agent in
+ * a sandbox is exactly who this command is for). When recording fails it says so
  * plainly and logs a warning, so the failure still surfaces without trapping the
  * agent in the retry loop the command exists to break.
  */

package/dist/commands/wildcard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wildcard.d.ts","sourceRoot":"","sources":["../../src/commands/wildcard.ts"],"names":[],"mappings":"AAMA,OAAO,EAAoB,KAAK,mBAAmB,EAAE,MAAM,aAAa,CAAC;AA6BzE;;;;;;;;;GASG;AACH,wBAAsB,GAAG,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAsIpE"}
+{"version":3,"file":"wildcard.d.ts","sourceRoot":"","sources":["../../src/commands/wildcard.ts"],"names":[],"mappings":"AAMA,OAAO,EAAoB,KAAK,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAgCzE;;;;;;;;;GASG;AACH,wBAAsB,GAAG,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAsIpE"}

package/dist/commands/wildcard.js

@@ -9,28 +9,31 @@ import { DEFAULT_BASE_URL } from '../types.js';
 // capability is real regardless of whether we could reach the Coolhand server, so
 // the de-loop is the agent's decision to make, not the server's.
 const STOP_GUIDANCE = 'Do not retry this action or attempt alternative ways to perform it; continue with the rest of your task.';
+// Shared opening clause: the blocker is either a capability that genuinely doesn't
+// exist, or a task that would take too long to complete in this environment.
+const BLOCKER_CLAUSE = 'This capability is not available, or the task would take too long to complete, in this environment.';
 // Printed when the blocker was successfully recorded server-side.
-const DELOOP_RECORDED = 'This capability is not available in this environment. Your feedback has been recorded. ' + STOP_GUIDANCE;
+const DELOOP_RECORDED = `${BLOCKER_CLAUSE} Your feedback has been recorded. ` + STOP_GUIDANCE;
 // Printed when the blocker could NOT be recorded (e.g. the server did not confirm).
 // We still de-loop the agent, but stay honest: we never claim a recording happened,
 // and a warning is logged separately so the failure surfaces.
-const DELOOP_UNRECORDED = 'This capability is not available in this environment. Your feedback could not be recorded ' +
+const DELOOP_UNRECORDED = `${BLOCKER_CLAUSE} Your feedback could not be recorded ` +
     '(the server did not confirm — run `coolhand login` to enable reporting). ' +
     STOP_GUIDANCE;
 // Printed when the blocker was saved locally because the API key is unavailable
 // (not logged in, no default client set, or private-only login). The data is not
 // lost: it uploads when credentials are available. The specific reason is already
 // in the logger.warn() call above, so this message stays generic.
-const DELOOP_SAVED = 'This capability is not available in this environment. Your feedback was saved locally ' +
+const DELOOP_SAVED = `${BLOCKER_CLAUSE} Your feedback was saved locally ` +
     'and will be uploaded once a Coolhand account with a public API key is configured. ' +
     STOP_GUIDANCE;
 /**
- * Records an agent's free-form "I am blocked, this capability does not exist"
- * complaint as feedback (tagged creator_type: "agent"), then prints a terminal
- * de-loop message and exits 0 so the agent stops and moves on. The de-loop ALWAYS
- * fires — even when the feedback could not be recorded — because the missing
- * capability is real regardless of server state (and a logged-out agent in a
- * sandbox is exactly who this command is for). When recording fails it says so
+ * Records an agent's free-form "I am blocked — a capability doesn't exist, or this
+ * task would take too long" complaint as feedback (tagged creator_type: "agent"),
+ * then prints a terminal de-loop message and exits 0 so the agent stops and moves
+ * on. The de-loop ALWAYS fires — even when the feedback could not be recorded —
+ * because the blocker is real regardless of server state (and a logged-out agent in
+ * a sandbox is exactly who this command is for). When recording fails it says so
  * plainly and logs a warning, so the failure still surfaces without trapping the
  * agent in the retry loop the command exists to break.
  */
@@ -131,14 +134,14 @@ export async function run(opts) {
         if (err instanceof CliError && err.code === 'CLIENT_NOT_FOUND') {
             // Bad --client-id value — not a server or auth failure; give actionable guidance.
             deloopFallback =
-                'This capability is not available in this environment. The specified client was not found ' +
+                `${BLOCKER_CLAUSE} The specified client was not found ` +
                     '(pass --client-id with a valid client ID, or run `coolhand clients` to list configured clients). ' +
                     STOP_GUIDANCE;
         }
         else if (err instanceof CliError && err.code === 'INVALID_ARGS') {
             // Client selection prompt timed out or received invalid input — not a server failure.
             deloopFallback =
-                'This capability is not available in this environment. Client selection was not completed ' +
+                `${BLOCKER_CLAUSE} Client selection was not completed ` +
                     '(prompt timed out or received invalid input — pass --client-id to select a client directly). ' +
                     STOP_GUIDANCE;
         }

package/dist/commands/wildcard.js.map

@@ -1 +1 @@
-{"version":3,"file":"wildcard.js","sourceRoot":"","sources":["../../src/commands/wildcard.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"wildcard.js","sourceRoot":"","sources":["../../src/commands/wildcard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAA8B,MAAM,eAAe,CAAC;AACrE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAA4B,MAAM,aAAa,CAAC;AAEzE,6EAA6E;AAC7E,kFAAkF;AAClF,iEAAiE;AACjE,MAAM,aAAa,GACjB,0GAA0G,CAAC;AAE7G,mFAAmF;AACnF,6EAA6E;AAC7E,MAAM,cAAc,GAAG,qGAAqG,CAAC;AAE7H,kEAAkE;AAClE,MAAM,eAAe,GAAG,GAAG,cAAc,oCAAoC,GAAG,aAAa,CAAC;AAE9F,oFAAoF;AACpF,oFAAoF;AACpF,8DAA8D;AAC9D,MAAM,iBAAiB,GACrB,GAAG,cAAc,uCAAuC;IACxD,2EAA2E;IAC3E,aAAa,CAAC;AAEhB,gFAAgF;AAChF,iFAAiF;AACjF,kFAAkF;AAClF,kEAAkE;AAClE,MAAM,YAAY,GAChB,GAAG,cAAc,mCAAmC;IACpD,oFAAoF;IACpF,aAAa,CAAC;AAEhB;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,IAAyB;IACjD,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,SAA6B,CAAC;IAClC,0FAA0F;IAC1F,8FAA8F;IAC9F,IAAI,cAAkC,CAAC;IAEvC,iFAAiF;IACjF,gEAAgE;IAChE,MAAM,QAAQ,GAA0B;QACtC,WAAW,EAAE,IAAI,CAAC,SAAS;QAC3B,iBAAiB,EAAE,IAAI,CAAC,SAAS;QACjC,YAAY,EAAE,OAAO;QACrB,SAAS,EAAE,GAAG,kBAAkB,WAAW;QAC3C,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5D,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACxE,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,UAAU,EAAE,CAAC;QAC/B,2FAA2F;QAC3F,yFAAyF;QACzF,IAAI,MAAM,CAAC;QACX,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,iDAAiD;YACjD,oFAAoF;YACpF,2EAA2E;YAC3E,gFAAgF;YAChF,8EAA8E;YAC9E,gFAAgF;YAChF,0EAA0E;YAC1E,IAAI,CAAC,CAAC,GAAG,YAAY,QAAQ,CAAC,IAAI,GAAG,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;gBAChE,MAAM,GAAG,CAAC;YACZ,CAAC;QACH,CAAC;QACD,2FAA2F;QAC3F,6FAA6F;QAC7F,0FAA0F;QAC1F,8FAA8F;QAC9F,6FAA6F;QAC7F,+FAA+F;QAC/F,MAAM,MAAM,GAAG,MAAM,EAAE,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;QAC/D,MAAM,OAAO,GAAG,MAAM,EAAE,QAAQ,IAAI,gBAAgB,CAAC;QAErD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,2EAA2E;YAC3E,0EAA0E;YAC1E,SAAS,GAAG,MAAM,iBAAiB,CAAC;gBAClC,OAAO,EAAE,gBAAgB;gBACzB,IAAI,EAAE,UAAU;gBAChB,OAAO,EAAE,QAAQ;gBACjB,uEAAuE;gBACvE,sEAAsE;gBACtE,GAAG,CAAC,MAAM,KAAK,SAAS;oBACtB,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,SAAS,EAAE;oBAChC,CAAC,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS;wBAC7B,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE;wBAC7B,CAAC,CAAC,EAAE,CAAC;gBACP,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aAClC,CAAC,CAAC;YACH,IAAI,MAAM,EAAE,CAAC;gBACX,kEAAkE;gBAClE,MAAM,CAAC,IAAI,CACT,qCAAqC,MAAM,CAAC,WAAW,KAAK;oBAC1D,qCAAqC,SAAS,IAAI;oBAClD,gEAAgE,CACnE,CAAC;YACJ,CAAC;iBAAM,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC/C,gFAAgF;gBAChF,MAAM,CAAC,IAAI,CACT,sFAAsF;oBACpF,qCAAqC,SAAS,IAAI;oBAClD,+EAA+E,CAClF,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,gCAAgC;gBAChC,MAAM,CAAC,IAAI,CACT,oDAAoD,SAAS,IAAI;oBAC/D,+CAA+C,CAClD,CAAC;YACJ,CAAC;QACH,CAAC;aAAM,CAAC;YACN,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YACjE,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;YACvD,QAAQ,GAAG,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,SAAS,CAAC;YACnD,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,MAAM,CAAC,IAAI,CAAC,0EAA0E,CAAC,CAAC;YAC1F,CAAC;QACH,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,2FAA2F;QAC3F,4FAA4F;QAC5F,wFAAwF;QACxF,2FAA2F;QAC3F,0FAA0F;QAC1F,4DAA4D;QAC5D,IAAI,GAAG,YAAY,QAAQ,IAAI,GAAG,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;YAC/D,kFAAkF;YAClF,cAAc;gBACZ,GAAG,cAAc,sCAAsC;oBACvD,mGAAmG;oBACnG,aAAa,CAAC;QAClB,CAAC;aAAM,IAAI,GAAG,YAAY,QAAQ,IAAI,GAAG,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;YAClE,sFAAsF;YACtF,cAAc;gBACZ,GAAG,cAAc,sCAAsC;oBACvD,+FAA+F;oBAC/F,aAAa,CAAC;QAClB,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,sCAAsC,MAAM,CAAE,GAAa,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACtF,CAAC;IAED,kFAAkF;IAClF,oFAAoF;IACpF,mFAAmF;IACnF,6DAA6D;IAC7D,IAAI,OAAe,CAAC;IACpB,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,GAAG,eAAe,CAAC;IAC5B,CAAC;SAAM,IAAI,SAAS,EAAE,CAAC;QACrB,OAAO,GAAG,YAAY,CAAC;IACzB,CAAC;SAAM,IAAI,cAAc,EAAE,CAAC;QAC1B,OAAO,GAAG,cAAc,CAAC;IAC3B,CAAC;SAAM,CAAC;QACN,OAAO,GAAG,iBAAiB,CAAC;IAC9B,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;QACvB,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,IAAI,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IACzE,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,QAAQ,CAAC,EAAE,CAAC;AACrB,CAAC"}

package/dist/config.d.ts

@@ -24,4 +24,15 @@ export declare function setDefault(clientId: string): Promise<ConfigFile>;
  * knows which account's data they are looking at.
  */
 export declare function resolveClient(cfg: ConfigFile, clientId?: string): Promise<ClientEntry>;
+/**
+ * `resolveClient`, but tolerant of "no clients configured at all" — returns `undefined` in that
+ * one case instead of throwing, so a `--dry-run` caller can still run fully unauthenticated. Any
+ * other resolution error (a bad --client-id, multiple clients with no default set, etc.)
+ * propagates exactly as `resolveClient` would throw it.
+ *
+ * Shared by every command whose `--dry-run` mode should work without any stored credentials
+ * (`analyze-claude-sessions`, `map-claude-projects`, `upload-client-file`, and anything built on
+ * `uploadClientFile`'s shared core).
+ */
+export declare function resolveClientForDryRun(cfg: ConfigFile, clientId?: string): Promise<ClientEntry | undefined>;
 //# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAM1D,wBAAgB,SAAS,IAAI,MAAM,CAMlC;AAED,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAMD,wBAAsB,UAAU,IAAI,OAAO,CAAC,UAAU,CAAC,CAyBtD;AAWD;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,MAAkB,GACvB,OAAO,CAAC,IAAI,CAAC,CAef;AAED,wBAAsB,UAAU,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAI/D;AAED,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAMlD;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAMrF;AAED,wBAAsB,YAAY,CAAC,KAAK,EAAE,WAAW,EAAE,WAAW,UAAO,GAAG,OAAO,CAAC,UAAU,CAAC,CAY9F;AAED,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAgB/E;AAED,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAQtE;AA2CD;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAyE5F"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAM1D,wBAAgB,SAAS,IAAI,MAAM,CAMlC;AAED,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAMD,wBAAsB,UAAU,IAAI,OAAO,CAAC,UAAU,CAAC,CAyBtD;AAWD;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,MAAkB,GACvB,OAAO,CAAC,IAAI,CAAC,CAef;AAED,wBAAsB,UAAU,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAI/D;AAED,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAMlD;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAMrF;AAED,wBAAsB,YAAY,CAAC,KAAK,EAAE,WAAW,EAAE,WAAW,UAAO,GAAG,OAAO,CAAC,UAAU,CAAC,CAY9F;AAED,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAgB/E;AAED,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAQtE;AA2CD;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAyE5F;AAED;;;;;;;;;GASG;AACH,wBAAsB,sBAAsB,CAAC,GAAG,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAajH"}

package/dist/config.js

@@ -4,7 +4,7 @@ import * as os from 'os';
 import * as path from 'path';
 import { randomBytes } from 'crypto';
 import { CliError } from './errors.js';
-import { logger } from './logger.js';
+import { logger, stripAnsiEscapes } from './logger.js';
 const CONFIG_FILENAME = 'config.json';
 const DIR_MODE = 0o700;
 const FILE_MODE = 0o600;
@@ -141,7 +141,7 @@ export async function setDefault(clientId) {
 const PROMPT_TIMEOUT_MS = 30000;
 async function promptClientSelection(clients) {
     return new Promise((resolve, reject) => {
-        const lines = clients.map((c, i) => `  ${i + 1}. ${c.client_name} (${c.client_id})`).join('\n');
+        const lines = clients.map((c, i) => `  ${i + 1}. ${stripAnsiEscapes(c.client_name)} (${c.client_id})`).join('\n');
         process.stderr.write(`Multiple clients configured — which one?\n${lines}\nEnter number: `);
         const rl = createInterface({ input: process.stdin, output: process.stderr });
         let settled = false;
@@ -200,7 +200,7 @@ export async function resolveClient(cfg, clientId) {
         if (!entry) {
             throw new CliError('CLIENT_NOT_FOUND', `No client "${clientId}" is configured.`);
         }
-        process.stderr.write(`Client: ${entry.client_name} (${entry.client_id})\n`);
+        process.stderr.write(`Client: ${stripAnsiEscapes(entry.client_name)} (${entry.client_id})\n`);
         return entry;
     }
     // 2. COOLHAND_CLIENT_ID env var
@@ -214,14 +214,14 @@ export async function resolveClient(cfg, clientId) {
         if (!entry) {
             throw new CliError('CLIENT_NOT_FOUND', `COOLHAND_CLIENT_ID="${envClientId}" does not match any configured client.`);
         }
-        process.stderr.write(`Client: ${entry.client_name} (${entry.client_id})\n`);
+        process.stderr.write(`Client: ${stripAnsiEscapes(entry.client_name)} (${entry.client_id})\n`);
         return entry;
     }
     // 3. Configured default
     if (cfg.default_client_id) {
         const entry = cfg.clients[cfg.default_client_id];
         if (entry) {
-            process.stderr.write(`Client: ${entry.client_name} (${entry.client_id})\n`);
+            process.stderr.write(`Client: ${stripAnsiEscapes(entry.client_name)} (${entry.client_id})\n`);
             return entry;
         }
         logger.warn(`Configured default client "${cfg.default_client_id}" no longer exists. Run \`coolhand clients use <id>\` to reset it.`);
@@ -234,7 +234,7 @@ export async function resolveClient(cfg, clientId) {
     // 5. Exactly one client — auto-pick without prompting
     if (clients.length === 1) {
         const entry = clients[0];
-        process.stderr.write(`Client: ${entry.client_name} (${entry.client_id})\n`);
+        process.stderr.write(`Client: ${stripAnsiEscapes(entry.client_name)} (${entry.client_id})\n`);
         return entry;
     }
     // 6. Multiple clients, no default — prompt interactively when both stdin and stderr are a
@@ -243,10 +243,33 @@ export async function resolveClient(cfg, clientId) {
     //    cannot type a selection, so the descriptive error path is cleaner.
     if (process.stdin.isTTY && process.stderr.isTTY) {
         const entry = await promptClientSelection(clients);
-        process.stderr.write(`Client: ${entry.client_name} (${entry.client_id})\n`);
+        process.stderr.write(`Client: ${stripAnsiEscapes(entry.client_name)} (${entry.client_id})\n`);
         return entry;
     }
-    const list = clients.map((c) => `  ${c.client_id}  ${c.client_name}`).join('\n');
+    const list = clients.map((c) => `  ${c.client_id}  ${stripAnsiEscapes(c.client_name)}`).join('\n');
     throw new CliError('NOT_CONFIGURED', `Multiple clients configured but no default is set.\n\nConfigured clients:\n${list}\n\nRun \`coolhand clients use <id>\` to set a default, or pass --client-id.`);
 }
+/**
+ * `resolveClient`, but tolerant of "no clients configured at all" — returns `undefined` in that
+ * one case instead of throwing, so a `--dry-run` caller can still run fully unauthenticated. Any
+ * other resolution error (a bad --client-id, multiple clients with no default set, etc.)
+ * propagates exactly as `resolveClient` would throw it.
+ *
+ * Shared by every command whose `--dry-run` mode should work without any stored credentials
+ * (`analyze-claude-sessions`, `map-claude-projects`, `upload-client-file`, and anything built on
+ * `uploadClientFile`'s shared core).
+ */
+export async function resolveClientForDryRun(cfg, clientId) {
+    try {
+        return await resolveClient(cfg, clientId);
+    }
+    catch (err) {
+        if (!(err instanceof CliError) ||
+            err.code !== 'NOT_CONFIGURED' ||
+            Object.keys(cfg.clients).length > 0) {
+            throw err;
+        }
+        return undefined;
+    }
+}
 //# sourceMappingURL=config.js.map