@aexol/spectral 0.9.20 → 0.9.24

package/dist/memory/tool-output-compressor.js

@@ -0,0 +1,569 @@
+/**
+ * Tool Output Compressor — RTK-inspired pre-processing that intercepts
+ * tool results and compresses raw output before it enters the LLM context.
+ *
+ * This is complementary to the conversation-level compaction pipeline:
+ * - Compressor: compresses raw tool output (pre-context)
+ * - Compaction: summarizes + prunes conversation history (post-context)
+ * - Unified compaction: narrative summary + observation extraction (at compaction boundary)
+ *
+ * Strategies (mirroring RTK's four-pronged approach):
+ *
+ * 1. SMART FILTERING — strip noise from structured outputs
+ *    - Code: remove comments, collapse whitespace, skip blank lines
+ *    - Git: strip progress meters, hints, verbose enumerations
+ *    - Shell: remove ANSI escape codes, carriage returns
+ *
+ * 2. GROUPING — aggregate similar items
+ *    - ls/find: group files by directory
+ *    - grep/rg: group matches by file, collapse repeated patterns
+ *    - Lint errors: group by rule + file
+ *
+ * 3. TRUNCATION — keep relevant context, cut redundancy
+ *    - Read: keep N lines with line-number markers
+ *    - Bash: keep first + last N lines of long output
+ *    - Test runners: keep only failures + summary
+ *
+ * 4. DEDUPLICATION — collapse repeated lines with counts
+ *    - Log output: deduplicate repeated lines
+ *    - Docker/build output: collapse progress lines
+ */
+import { debugLog } from "./debug-log.js";
+export const DEFAULT_COMPRESSOR_CONFIG = {
+    enabled: true,
+    maxResultChars: 8000,
+    maxReadLines: 500,
+    maxLsLines: 100,
+    maxSearchLines: 200,
+    stripAnsi: true,
+    stripComments: true,
+    testFailuresOnly: true,
+    compactGit: true,
+};
+// ============================================================================
+// ANSI Stripping
+// ============================================================================
+const ANSI_RE = /\x1b\[[0-9;]*[a-zA-Z]/g;
+const CARRIAGE_RETURN_RE = /\r/g;
+function stripAnsi(input) {
+    return input.replace(ANSI_RE, "").replace(CARRIAGE_RETURN_RE, "");
+}
+const COMMENT_PATTERNS = {
+    ts: { line: "//", blockStart: "/*", blockEnd: "*/" },
+    tsx: { line: "//", blockStart: "/*", blockEnd: "*/" },
+    js: { line: "//", blockStart: "/*", blockEnd: "*/" },
+    jsx: { line: "//", blockStart: "/*", blockEnd: "*/" },
+    mjs: { line: "//", blockStart: "/*", blockEnd: "*/" },
+    cjs: { line: "//", blockStart: "/*", blockEnd: "*/" },
+    py: { line: "#", blockStart: '"""', blockEnd: '"""' },
+    pyw: { line: "#", blockStart: '"""', blockEnd: '"""' },
+    rs: { line: "//", blockStart: "/*", blockEnd: "*/" },
+    go: { line: "//", blockStart: "/*", blockEnd: "*/" },
+    java: { line: "//", blockStart: "/*", blockEnd: "*/" },
+    rb: { line: "#", blockStart: "=begin", blockEnd: "=end" },
+    sh: { line: "#", blockStart: null, blockEnd: null },
+    bash: { line: "#", blockStart: null, blockEnd: null },
+    zsh: { line: "#", blockStart: null, blockEnd: null },
+    c: { line: "//", blockStart: "/*", blockEnd: "*/" },
+    h: { line: "//", blockStart: "/*", blockEnd: "*/" },
+    cpp: { line: "//", blockStart: "/*", blockEnd: "*/" },
+    hpp: { line: "//", blockStart: "/*", blockEnd: "*/" },
+};
+/** Data formats that must never have comment stripping applied */
+const DATA_EXTENSIONS = new Set([
+    "json", "jsonc", "json5", "yaml", "yml", "toml", "xml", "csv",
+    "tsv", "graphql", "gql", "sql", "md", "markdown", "txt",
+    "env", "lock", "css", "scss", "less", "html", "htm",
+]);
+function getExtension(filePath) {
+    const dot = filePath.lastIndexOf(".");
+    if (dot < 0)
+        return "";
+    return filePath.slice(dot + 1).toLowerCase();
+}
+function stripComments(content, ext) {
+    if (!ext || DATA_EXTENSIONS.has(ext))
+        return content;
+    const patterns = COMMENT_PATTERNS[ext];
+    if (!patterns)
+        return content;
+    const lines = content.split("\n");
+    const result = [];
+    let inBlockComment = false;
+    for (const line of lines) {
+        const trimmed = line.trim();
+        // Handle block comments
+        if (patterns.blockStart && patterns.blockEnd) {
+            if (!inBlockComment && trimmed.includes(patterns.blockStart)) {
+                inBlockComment = true;
+            }
+            if (inBlockComment) {
+                if (trimmed.includes(patterns.blockEnd)) {
+                    inBlockComment = false;
+                }
+                continue;
+            }
+        }
+        // Skip line comments
+        if (patterns.line && trimmed.startsWith(patterns.line)) {
+            continue;
+        }
+        // Skip blank lines
+        if (!trimmed)
+            continue;
+        // Remove trailing whitespace
+        result.push(line.replace(/\s+$/, ""));
+    }
+    return result.join("\n");
+}
+// ============================================================================
+// Smart Truncation
+// ============================================================================
+function smartTruncate(text, maxChars) {
+    if (text.length <= maxChars)
+        return text;
+    const half = Math.floor(maxChars / 2);
+    const head = text.slice(0, half);
+    const tail = text.slice(text.length - half);
+    const omitted = text.length - head.length - tail.length;
+    return `${head}\n\n[... ${omitted} characters truncated ...]\n\n${tail}`;
+}
+function smartTruncateLines(text, maxLines) {
+    const lines = text.split("\n");
+    if (lines.length <= maxLines)
+        return text;
+    const keepFirst = Math.floor(maxLines / 3);
+    const keepLast = Math.floor(maxLines / 3);
+    const middle = maxLines - keepFirst - keepLast - 1;
+    const head = lines.slice(0, keepFirst);
+    const tail = lines.slice(lines.length - keepLast);
+    const omitted = lines.length - keepFirst - keepLast;
+    return [
+        ...head,
+        `[... ${omitted} lines omitted ...]`,
+        ...tail,
+    ].join("\n");
+}
+function deduplicateRepeatedLines(text) {
+    const lines = text.split("\n");
+    const stats = { totalLines: 0, uniqueLines: 0, collapsedRuns: 0 };
+    if (lines.length === 0)
+        return { result: text, stats };
+    const result = [];
+    let runCount = 0;
+    let lastLine = "";
+    for (const line of lines) {
+        stats.totalLines++;
+        if (line === lastLine) {
+            runCount++;
+        }
+        else {
+            if (runCount > 2) {
+                // Collapse: replace the repeated run with a count marker
+                result.pop(); // Remove the last duplicate
+                result.push(`${lastLine}  [repeated ${runCount - 1} more times]`);
+                stats.collapsedRuns++;
+            }
+            result.push(line);
+            stats.uniqueLines++;
+            runCount = 1;
+            lastLine = line;
+        }
+    }
+    // Handle trailing run
+    if (runCount > 2) {
+        result.pop();
+        result.push(`${lastLine}  [repeated ${runCount - 1} more times]`);
+        stats.collapsedRuns++;
+    }
+    return {
+        result: result.join("\n"),
+        stats,
+    };
+}
+// ============================================================================
+// Read Compressor
+// ============================================================================
+function compressReadOutput(event, config) {
+    let content = event.content
+        .filter((c) => c.type === "text")
+        .map((c) => c.text)
+        .join("\n");
+    if (!content)
+        return "";
+    // Strip ANSI
+    if (config.stripAnsi) {
+        content = stripAnsi(content);
+    }
+    // Strip comments for code files
+    if (config.stripComments) {
+        const filePath = event.input?.path ?? "";
+        const ext = getExtension(filePath);
+        if (ext && !DATA_EXTENSIONS.has(ext)) {
+            content = stripComments(content, ext);
+        }
+    }
+    // Truncate long reads
+    const lines = content.split("\n");
+    if (lines.length > config.maxReadLines) {
+        content = smartTruncateLines(content, config.maxReadLines);
+    }
+    // Truncate by char count
+    if (content.length > config.maxResultChars) {
+        content = smartTruncate(content, config.maxResultChars);
+    }
+    return content;
+}
+// ============================================================================
+// Bash Compressor
+// ============================================================================
+/** Commands whose output should be filtered to failures only */
+const TEST_COMMANDS = [
+    "jest", "vitest", "pytest", "go test", "cargo test",
+    "rspec", "rake test", "playwright test", "npx playwright",
+    "npm test", "npm run test", "yarn test", "pnpm test",
+    "bun test",
+];
+/** Commands where git-like compacting should apply */
+const GIT_COMMANDS = [
+    "git status", "git diff", "git log", "git show",
+    "git push", "git pull", "git fetch", "git add",
+    "git commit", "git branch", "git stash",
+];
+/** Patterns to strip from git output */
+const GIT_NOISE_PATTERNS = [
+    /^Enumerating objects:/,
+    /^Counting objects:/,
+    /^Compressing objects:/,
+    /^Writing objects:/,
+    /^Delta compression using/,
+    /^Total \d+/,
+    /^\(use "git/,
+    /^\(create\/copy files/,
+];
+function detectCommandType(command) {
+    const base = command.split(/\s+/).slice(0, 3).join(" ").toLowerCase();
+    for (const testCmd of TEST_COMMANDS) {
+        if (base.startsWith(testCmd))
+            return "test";
+    }
+    for (const gitCmd of GIT_COMMANDS) {
+        if (base.startsWith(gitCmd))
+            return "git";
+    }
+    if (/\b(build|compile|tsc|esbuild|webpack|vite build|next build)\b/.test(base)) {
+        return "build";
+    }
+    return "other";
+}
+function filterGitOutput(content) {
+    const lines = content.split("\n");
+    const filtered = [];
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        // Skip noise lines
+        if (GIT_NOISE_PATTERNS.some((p) => p.test(trimmed)))
+            continue;
+        filtered.push(line);
+    }
+    if (filtered.length === 0)
+        return "ok";
+    return filtered.join("\n");
+}
+function filterTestOutput(content) {
+    const lines = content.split("\n");
+    const result = [];
+    let failureSection = false;
+    let summarySection = false;
+    for (const line of lines) {
+        // Start of failure section
+        if (/^FAIL|^\s*●|^\s*\d+\)|^\s*FAILED|^AssertionError|^Error:/i.test(line)) {
+            failureSection = true;
+        }
+        // Start of summary section
+        if (/^(Test Suites|Tests|Snapshots|Time|Ran all):/i.test(line)) {
+            summarySection = true;
+            failureSection = false;
+        }
+        // Keep lines in failure or summary sections
+        if (failureSection || summarySection) {
+            result.push(line);
+        }
+    }
+    // If no failures found, just return a summary
+    if (result.length === 0) {
+        const summaryLines = lines.filter((l) => /^(Tests|Test Suites|Snapshots|Time|Ran):/i.test(l.trim()));
+        if (summaryLines.length > 0) {
+            return summaryLines.join("\n");
+        }
+        return "All tests passed.";
+    }
+    return result.join("\n");
+}
+function compressBashOutput(event, config) {
+    let content = event.content
+        .filter((c) => c.type === "text")
+        .map((c) => c.text)
+        .join("\n");
+    if (!content)
+        return "";
+    // Strip ANSI
+    if (config.stripAnsi) {
+        content = stripAnsi(content);
+    }
+    // Detect command type and apply specialized filters
+    const command = event.input?.command ?? "";
+    const cmdType = detectCommandType(command);
+    switch (cmdType) {
+        case "git":
+            if (config.compactGit) {
+                content = filterGitOutput(content);
+            }
+            break;
+        case "test":
+            if (config.testFailuresOnly) {
+                content = filterTestOutput(content);
+            }
+            break;
+        case "build":
+            // For build output, deduplicate repeated progress lines
+            {
+                const deduped = deduplicateRepeatedLines(content);
+                content = deduped.result;
+            }
+            break;
+    }
+    // Deduplicate repeated lines for all outputs
+    {
+        const deduped = deduplicateRepeatedLines(content);
+        if (deduped.stats.collapsedRuns > 0) {
+            content = deduped.result;
+        }
+    }
+    // Truncate by char count
+    if (content.length > config.maxResultChars) {
+        content = smartTruncate(content, config.maxResultChars);
+    }
+    return content;
+}
+// ============================================================================
+// Ls Compressor
+// ============================================================================
+function compressLsOutput(event, config) {
+    let content = event.content
+        .filter((c) => c.type === "text")
+        .map((c) => c.text)
+        .join("\n");
+    if (!content)
+        return "";
+    if (config.stripAnsi) {
+        content = stripAnsi(content);
+    }
+    const lines = content.split("\n");
+    if (lines.length > config.maxLsLines) {
+        // Group by directory when listing many files
+        const groups = new Map();
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (!trimmed)
+                continue;
+            const slashIdx = trimmed.lastIndexOf("/");
+            const dir = slashIdx >= 0 ? trimmed.slice(0, slashIdx) : ".";
+            groups.set(dir, (groups.get(dir) ?? 0) + 1);
+        }
+        const grouped = [];
+        for (const [dir, count] of [...groups.entries()].sort(([a], [b]) => a.localeCompare(b))) {
+            grouped.push(`${dir}/  (${count} files)`);
+        }
+        return grouped.join("\n");
+    }
+    return content;
+}
+// ============================================================================
+// Grep Compressor
+// ============================================================================
+function compressGrepOutput(event, config) {
+    let content = event.content
+        .filter((c) => c.type === "text")
+        .map((c) => c.text)
+        .join("\n");
+    if (!content)
+        return "";
+    if (config.stripAnsi) {
+        content = stripAnsi(content);
+    }
+    // Group matches by file
+    const lines = content.split("\n");
+    const byFile = new Map();
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        // Standard grep format: "file:line:text"
+        const colonIdx = trimmed.indexOf(":");
+        if (colonIdx > 0) {
+            const file = trimmed.slice(0, colonIdx);
+            byFile.set(file, (byFile.get(file) ?? 0) + 1);
+        }
+    }
+    if (byFile.size > 1 && lines.length > config.maxSearchLines) {
+        // Group by file with count, show first few matches per file
+        const grouped = [];
+        for (const [file, count] of [...byFile.entries()].sort(([a], [b]) => a.localeCompare(b))) {
+            const fileMatches = lines.filter((l) => l.startsWith(file));
+            const preview = fileMatches.slice(0, 3).join("\n  ");
+            grouped.push(`${file} (${count} matches):\n  ${preview}${count > 3 ? `\n  ... +${count - 3} more` : ""}`);
+        }
+        return grouped.join("\n\n");
+    }
+    return content;
+}
+// ============================================================================
+// Find Compressor
+// ============================================================================
+function compressFindOutput(event, config) {
+    let content = event.content
+        .filter((c) => c.type === "text")
+        .map((c) => c.text)
+        .join("\n");
+    if (!content)
+        return "";
+    if (config.stripAnsi) {
+        content = stripAnsi(content);
+    }
+    // Group by directory
+    const lines = content.split("\n").filter((l) => l.trim());
+    if (lines.length > config.maxSearchLines) {
+        const groups = new Map();
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (!trimmed)
+                continue;
+            const slashIdx = trimmed.lastIndexOf("/");
+            const dir = slashIdx >= 0 ? trimmed.slice(0, slashIdx) : ".";
+            if (!groups.has(dir))
+                groups.set(dir, []);
+            groups.get(dir).push(slashIdx >= 0 ? trimmed.slice(slashIdx + 1) : trimmed);
+        }
+        const grouped = [];
+        for (const [dir, files] of [...groups.entries()].sort(([a], [b]) => a.localeCompare(b))) {
+            if (files.length === 1) {
+                grouped.push(`${dir}/${files[0]}`);
+            }
+            else if (files.length <= 5) {
+                grouped.push(`${dir}/  (${files.length} files: ${files.join(", ")})`);
+            }
+            else {
+                grouped.push(`${dir}/  (${files.length} files: ${files.slice(0, 3).join(", ")}... +${files.length - 3} more)`);
+            }
+        }
+        return grouped.join("\n");
+    }
+    return content;
+}
+export function registerToolOutputCompressor(ext, runtime) {
+    const config = { ...DEFAULT_COMPRESSOR_CONFIG };
+    ext.on("tool_result", (_event, _ctx) => {
+        if (!config.enabled)
+            return;
+        // Only apply compression for known tool types
+        if (_event.toolName === "read") {
+            const event = _event;
+            const original = event.content
+                .filter((c) => c.type === "text")
+                .map((c) => c.text)
+                .join("\n");
+            const compressed = compressReadOutput(event, config);
+            if (compressed && compressed !== original) {
+                debugLog("compressor.read", {
+                    originalLen: original.length,
+                    compressedLen: compressed.length,
+                    savings: ((1 - compressed.length / Math.max(1, original.length)) * 100).toFixed(1) + "%",
+                });
+                return {
+                    content: [...event.content.filter((c) => c.type !== "text"), { type: "text", text: compressed }],
+                };
+            }
+            return;
+        }
+        if (_event.toolName === "bash") {
+            const event = _event;
+            const original = event.content
+                .filter((c) => c.type === "text")
+                .map((c) => c.text)
+                .join("\n");
+            const compressed = compressBashOutput(event, config);
+            if (compressed && compressed !== original) {
+                const command = event.input?.command ?? "";
+                debugLog("compressor.bash", {
+                    command: command.slice(0, 80),
+                    originalLen: original.length,
+                    compressedLen: compressed.length,
+                    savings: ((1 - compressed.length / Math.max(1, original.length)) * 100).toFixed(1) + "%",
+                });
+                return {
+                    content: [...event.content.filter((c) => c.type !== "text"), { type: "text", text: compressed }],
+                };
+            }
+            return;
+        }
+        if (_event.toolName === "ls") {
+            const event = _event;
+            const original = event.content
+                .filter((c) => c.type === "text")
+                .map((c) => c.text)
+                .join("\n");
+            const compressed = compressLsOutput(event, config);
+            if (compressed && compressed !== original) {
+                debugLog("compressor.ls", {
+                    originalLen: original.length,
+                    compressedLen: compressed.length,
+                });
+                return {
+                    content: [...event.content.filter((c) => c.type !== "text"), { type: "text", text: compressed }],
+                };
+            }
+            return;
+        }
+        if (_event.toolName === "grep") {
+            const event = _event;
+            const original = event.content
+                .filter((c) => c.type === "text")
+                .map((c) => c.text)
+                .join("\n");
+            const compressed = compressGrepOutput(event, config);
+            if (compressed && compressed !== original) {
+                debugLog("compressor.grep", {
+                    originalLen: original.length,
+                    compressedLen: compressed.length,
+                });
+                return {
+                    content: [...event.content.filter((c) => c.type !== "text"), { type: "text", text: compressed }],
+                };
+            }
+            return;
+        }
+        if (_event.toolName === "find") {
+            const event = _event;
+            const original = event.content
+                .filter((c) => c.type === "text")
+                .map((c) => c.text)
+                .join("\n");
+            const compressed = compressFindOutput(event, config);
+            if (compressed && compressed !== original) {
+                debugLog("compressor.find", {
+                    originalLen: original.length,
+                    compressedLen: compressed.length,
+                });
+                return {
+                    content: [...event.content.filter((c) => c.type !== "text"), { type: "text", text: compressed }],
+                };
+            }
+            return;
+        }
+        // Unknown tool types: do nothing
+        return;
+    });
+}

package/dist/relay/dispatcher.d.ts

@@ -48,7 +48,7 @@ import type { RelayClient } from "./client.js";
  * `id` is populated when the route had an `:id` placeholder.
  */
 interface RouteMatch {
-    route: "list_projects" | "create_project" | "update_project" | "delete_project" | "bind_studio" | "get_project_observations" | "list_project_sessions" | "create_session" | "get_session" | "update_session" | "delete_session" | "get_session_memory" | "get_session_memory_details" | "compact_session" | "remember_and_delete_session" | "fork_session" | "list_path_autocomplete" | "pick_directory" | "search_project_files" | "enqueue_prompt" | "get_prompt_queue" | "remove_prompt" | "clear_prompt_queue" | "list_mcp_status" | "get_settings" | "put_settings";
+    route: "list_projects" | "create_project" | "update_project" | "delete_project" | "bind_studio" | "get_project_observations" | "list_project_sessions" | "create_session" | "get_session" | "update_session" | "delete_session" | "get_session_memory" | "get_session_memory_details" | "compact_session" | "remember_and_delete_session" | "fork_session" | "list_path_autocomplete" | "pick_directory" | "search_project_files" | "enqueue_prompt" | "get_prompt_queue" | "remove_prompt" | "clear_prompt_queue" | "list_mcp_status" | "get_settings" | "put_settings" | "get_agent_settings" | "put_agent_settings" | "list_agents";
     id?: string;
     /** Parsed query params, if the path carried a `?...` suffix. */
     query?: URLSearchParams;
@@ -79,6 +79,8 @@ export interface RestRequestDeps {
     manager: SessionStreamManager;
     /** Working directory for this machine. Used by settings persistence. Defaults to homedir. */
     cwd?: string;
+    /** Agent config dir (`~/.spectral/agent` by default). Passed through to agent-settings persistence. */
+    agentDir?: string;
     /** Optional logger for unexpected errors. Defaults to console.error. */
     logger?: {
         error: (...args: unknown[]) => void;

package/dist/relay/dispatcher.d.ts.map

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

package/dist/relay/dispatcher.js

@@ -47,6 +47,7 @@ import { handleSearchProjectFiles } from "../server/handlers/files-search.js";
 import { handleBindStudioProject, handleCreateProject, handleDeleteProject, handleGetProjectObservations, handleListProjects, handleListSessionsByProject, handleUpdateProject, } from "../server/handlers/projects.js";
 import { handleCompactSession, handleCreateSession, handleDeleteSession, handleForkSession, handleRememberAndDeleteSession, handleGetSessionDetail, handleGetSessionMemoryDetails, handleGetSessionMemoryStatus, handleUpdateSession, } from "../server/handlers/sessions.js";
 import { handleClearPromptQueue, handleEnqueuePrompt, handleGetPromptQueue, handleRemovePrompt, } from "../server/handlers/queue.js";
+import { handleGetAgentSettings, handleListAgents, handlePutAgentSettings, } from "../server/handlers/agent-settings.js";
 import { handleGetSettings, handlePutSettings, } from "../server/handlers/settings.js";
 import { shutdownState } from "../server/shutdown.js";
 import { handleAutoResearch } from "./auto-research.js";
@@ -76,6 +77,20 @@ export function matchRoute(method, path) {
             return { route: "put_settings" };
         return null;
     }
+    // /api/agent-settings
+    if (cleanPath === "/api/agent-settings") {
+        if (method === "GET")
+            return { route: "get_agent_settings" };
+        if (method === "PUT")
+            return { route: "put_agent_settings" };
+        return null;
+    }
+    // /api/agents
+    if (cleanPath === "/api/agents") {
+        if (method === "GET")
+            return { route: "list_agents", query };
+        return null;
+    }
     // /api/paths/autocomplete
     if (cleanPath === "/api/paths/autocomplete") {
         if (method === "GET")
@@ -451,6 +466,14 @@ async function dispatchRoute(match, body, deps) {
             return handleGetSettings(deps.cwd ?? homedir());
         case "put_settings":
             return handlePutSettings(deps.cwd ?? homedir(), asObject(body));
+        case "get_agent_settings":
+            return handleGetAgentSettings(deps.cwd ?? homedir(), deps.agentDir);
+        case "put_agent_settings":
+            return handlePutAgentSettings(deps.cwd ?? homedir(), asObject(body), deps.agentDir);
+        case "list_agents": {
+            const agentCwd = match.query?.get("cwd") || deps.cwd || homedir();
+            return handleListAgents(agentCwd, deps.agentDir);
+        }
     }
 }
 /**

package/dist/sdk/coding-agent/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/sdk/coding-agent/config.ts"],"names":[],"mappings":"AAoBA,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AAEhE,UAAU,qBAAqB;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAkB,SAAQ,qBAAqB;IAC/D,KAAK,CAAC,EAAE,qBAAqB,EAAE,CAAC;CAChC;AAsBD,wBAAgB,mBAAmB,IAAI,aAAa,CAcnD;AAyKD,wBAAgB,oBAAoB,CACnC,WAAW,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,MAAM,EAAE,EACrB,iBAAiB,SAAc,GAC7B,iBAAiB,GAAG,SAAS,CAO/B;AAED,wBAAgB,mCAAmC,CAClD,WAAW,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,MAAM,EAAE,EACrB,iBAAiB,SAAc,GAC7B,MAAM,CAUR;AAED,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAOhE;AAMD;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAiBtC;AAED;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAKrC;AAED;;;;+BAI+B;AAC/B,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED,4BAA4B;AAC5B,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,iCAAiC;AACjC,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED,qCAAqC;AACrC,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,+BAA+B;AAC/B,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAoBD,eAAO,MAAM,YAAY,EAAE,MAA+B,CAAC;AAC3D,eAAO,MAAM,QAAQ,EAAE,MAAyC,CAAC;AACjE,eAAO,MAAM,SAAS,EAAE,MAAmD,CAAC;AAC5E,eAAO,MAAM,eAAe,EAAE,MAAqD,CAAC;AACpF,eAAO,MAAM,OAAO,EAAE,MAA+B,CAAC;AAGtD,eAAO,MAAM,aAAa,QAA+C,CAAC;AAC1E,eAAO,MAAM,eAAe,QAAuD,CAAC;AAEpF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAID,6CAA6C;AAC7C,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAGxD;AAMD,gEAAgE;AAChE,wBAAgB,WAAW,IAAI,MAAM,CAMpC;AAED,iDAAiD;AACjD,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED,8BAA8B;AAC9B,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,4BAA4B;AAC5B,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED,gCAAgC;AAChC,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,kCAAkC;AAClC,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED,sDAAsD;AACtD,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED,6CAA6C;AAC7C,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,qCAAqC;AACrC,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,iCAAiC;AACjC,wBAAgB,eAAe,IAAI,MAAM,CAExC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/sdk/coding-agent/config.ts"],"names":[],"mappings":"AAoBA,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AAEhE,UAAU,qBAAqB;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAkB,SAAQ,qBAAqB;IAC/D,KAAK,CAAC,EAAE,qBAAqB,EAAE,CAAC;CAChC;AAsBD,wBAAgB,mBAAmB,IAAI,aAAa,CAcnD;AAyKD,wBAAgB,oBAAoB,CACnC,WAAW,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,MAAM,EAAE,EACrB,iBAAiB,SAAc,GAC7B,iBAAiB,GAAG,SAAS,CAO/B;AAED,wBAAgB,mCAAmC,CAClD,WAAW,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,MAAM,EAAE,EACrB,iBAAiB,SAAc,GAC7B,MAAM,CAUR;AAED,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAOhE;AAMD;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAiBtC;AAED;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAKrC;AAED;;;;+BAI+B;AAC/B,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED,4BAA4B;AAC5B,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,iCAAiC;AACjC,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED,qCAAqC;AACrC,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,+BAA+B;AAC/B,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AA4BD,eAAO,MAAM,YAAY,EAAE,MAA+B,CAAC;AAC3D,eAAO,MAAM,QAAQ,EAAE,MAAyC,CAAC;AACjE,eAAO,MAAM,SAAS,EAAE,MAAmD,CAAC;AAC5E,eAAO,MAAM,eAAe,EAAE,MAAqD,CAAC;AACpF,eAAO,MAAM,OAAO,EAAE,MAA+B,CAAC;AAGtD,eAAO,MAAM,aAAa,QAA+C,CAAC;AAC1E,eAAO,MAAM,eAAe,QAAuD,CAAC;AAEpF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAID,6CAA6C;AAC7C,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAGxD;AAMD,gEAAgE;AAChE,wBAAgB,WAAW,IAAI,MAAM,CAMpC;AAED,iDAAiD;AACjD,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED,8BAA8B;AAC9B,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,4BAA4B;AAC5B,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED,gCAAgC;AAChC,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,kCAAkC;AAClC,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED,sDAAsD;AACtD,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED,6CAA6C;AAC7C,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,qCAAqC;AACrC,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,iCAAiC;AACjC,wBAAgB,eAAe,IAAI,MAAM,CAExC"}

package/dist/sdk/coding-agent/config.js

@@ -268,7 +268,16 @@ export function getExamplesPath() {
 export function getChangelogPath() {
     return resolve(join(getPackageDir(), "CHANGELOG.md"));
 }
-const pkg = JSON.parse(readFileSync(getPackageJsonPath(), "utf-8"));
+function readPackageJson() {
+    try {
+        return JSON.parse(readFileSync(getPackageJsonPath(), "utf-8"));
+    }
+    catch {
+        // Standalone Bun binaries do not carry the source package.json.
+        return {};
+    }
+}
+const pkg = readPackageJson();
 const spectralConfigName = pkg.spectralConfig?.name;
 export const PACKAGE_NAME = pkg.name || "index.ts";
 export const APP_NAME = spectralConfigName || "spectral";