@wingsbutterfly/dsh-rtk 0.1.0

package/lib/index.js

@@ -0,0 +1,405 @@
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { Config, normalizeConfig } from './config.js';
+import { READ_COMPACTION_BANNER_PREFIX, compactToolResult } from './compact/index.js';
+import { parseBashResult, renderBashResult } from './compact/dsh-result.js';
+import { createMetricsTracker } from './metrics.js';
+import { createRtkCommand } from './command.js';
+import { resolveRtkExecutable, runExecutable } from './rtk-executable.js';
+import { applyRtkHistoryScope, resolveRtkRewrite } from './rtk-rewrite.js';
+import { isStatusStale, shouldRequireRtkAvailability, shouldSkipRewrite } from './runtime-guard.js';
+/** Cordis plugin name used by loader diagnostics. */
+export const name = 'rtk';
+/**
+ * The tool runtime is a hard dependency: both halves of this plugin are
+ * `tools/*` listeners, and without the registry there is nothing to rewrite or
+ * compact.
+ *
+ * `settings` is declared too, and not because the plugin cannot run without it
+ * — it can, entirely from the composition's `config:` block. It is declared
+ * because the provider registers *asynchronously*: it reads the settings
+ * document first, so a plain `ctx.get('settings')` during `apply` can find
+ * nothing and the namespace silently never registers. Observed exactly that in
+ * production (`/rtk` reported "settings service unavailable" while a sibling
+ * `ctx.get('spillStore')` succeeded). Declaring it makes Cordis park this
+ * plugin until the provider appears, then activate it.
+ *
+ * `commands` and `systemPrompt` stay optional `ctx.get` lookups: they are
+ * registered early enough to be present, and a composition without them should
+ * still get the optimization.
+ */
+export const inject = ['tools', 'settings'];
+export { Config };
+/** Tools whose `command` argument can be rewritten. */
+const REWRITABLE_TOOLS = new Set(['bash', 'pwsh']);
+/** Path of the rtk history database this plugin scopes rewritten commands to. */
+function rtkHistoryDbPath() {
+    return join(tmpdir(), 'dsh-rtk', 'history.db');
+}
+function asRecord(value) {
+    return typeof value === 'object' && value !== null ? value : undefined;
+}
+/**
+ * Appended once per session when rtk cannot be found.
+ *
+ * A missing binary is the only failure that silently costs the user the whole
+ * feature, so it is worth one short line — but only one, and only for a
+ * session that has not been told yet.
+ */
+const MISSING_RTK_NOTICE = '[rtk] rtk not found; rewriting is off — /rtk verify shows install options';
+/** The guidance injected while lossy read compaction is active. */
+const SOURCE_FILTER_TROUBLESHOOTING_NOTE = 'RTK note: if a file edit repeatedly fails because the old text does not match, read compaction may have altered the copy you are editing against. Ask the user to turn off `readCompaction` in the rtk settings, re-read the file, apply the edit, then turn it back on.';
+/** Whether lossy `read` compaction is enabled together with its safeguards. */
+function needsSourceFilterNote(config) {
+    const compaction = config.outputCompaction;
+    return (config.enabled &&
+        compaction.enabled &&
+        compaction.readCompaction.enabled &&
+        compaction.sourceCodeFilteringEnabled &&
+        compaction.sourceCodeFiltering !== 'none' &&
+        (compaction.smartTruncate.enabled || compaction.truncate.enabled));
+}
+/**
+ * Register RTK command rewriting and tool-output compaction.
+ *
+ * Both halves hang off the tool pipeline rather than wrapping a tool:
+ *
+ * - **Rewriting** rides `tools/execute`. The harness deliberately keeps
+ *   `tools/pre-execute` from mutating arguments (they are logged and presented
+ *   before dispatch), so the around-dispatch stage is the only seam where the
+ *   command that actually runs can differ from the one that was recorded. The
+ *   replacement is scoped to the call: the original arguments are restored as
+ *   soon as dispatch returns, so later pipeline stages and the session log see
+ *   what the model asked for.
+ * - **Compaction** rides `tools/post-execute`, which is the stage that may
+ *   replace result content.
+ *
+ * @param ctx - the agent-scoped context this row was mounted into.
+ * @param rawConfig - the row's `config:` block, already schema-validated.
+ */
+export function apply(ctx, rawConfig) {
+    /**
+     * Whether the harness bounds oversized results itself.
+     *
+     * `dsh-spill-policy` writes a full output to disk and keeps a head/tail
+     * preview inline, so it truncates *recoverably*. This plugin's own hard
+     * truncation is lossy, and it runs first: at 12 000 characters it fires far
+     * below spill's threshold (50 000 by default), so spill never sees a large
+     * result at all and the reader loses the spill file that would have let them
+     * read the rest. When spill is mounted this plugin steps aside; when it is
+     * not, the truncation stays as the only bound on a runaway command.
+     */
+    const spillHandlesLargeOutput = ctx.get('spillStore') !== undefined;
+    /**
+     * Apply the spill coordination to a freshly resolved configuration.
+     *
+     * Gated on an explicit switch rather than on "did the row set truncate?":
+     * the loader hands this function a schema-resolved config where every field
+     * already carries its default, so an absent key is indistinguishable from an
+     * explicit one. `deferToHarnessSpill: false` is how a row keeps its own
+     * bound regardless.
+     */
+    function coordinate(next) {
+        if (spillHandlesLargeOutput && next.outputCompaction.deferToHarnessSpill) {
+            next.outputCompaction.truncate.enabled = false;
+        }
+        return next;
+    }
+    let config = coordinate(normalizeConfig(rawConfig));
+    let runtimeStatus = { rtkAvailable: false };
+    const metrics = createMetricsTracker();
+    /** Rewrite decisions awaiting their result, keyed by call id, for `suggest` mode. */
+    const pendingSuggestions = new Map();
+    /** Call ids whose result should carry the one-time "rtk is missing" notice. */
+    const missingRtkCalls = new Set();
+    /** Sessions already told that rtk is absent, so the notice is emitted once each. */
+    const notifiedAgents = new Set();
+    // The settings namespace is process-global, so only the first instance of
+    // this plugin can own it. A host-plane row and a preset row both mounted, or
+    // two presets mounting the same row, would otherwise fail the second mount
+    // outright — a configuration convenience must never be the reason a whole
+    // preset refuses to activate. The loser follows the winner through the
+    // settings event instead.
+    const settings = ctx.get('settings');
+    let ownedScope;
+    // Surfaced by `/rtk show`. A silently swallowed registration failure hides
+    // the only runtime-editable configuration path this plugin has, and the
+    // failure mode (settings edits simply do nothing) is invisible otherwise.
+    let settingsNote;
+    if (settings === undefined) {
+        settingsNote = 'settings service unavailable — configuration comes from the composition only';
+    }
+    else {
+        try {
+            const scope = settings.register('dsh-rtk', Config, { base: rawConfig });
+            ownedScope = scope;
+            config = coordinate(normalizeConfig(scope.get()));
+            scope.watch((next) => {
+                config = coordinate(normalizeConfig(next));
+                applySourceFilterNote();
+            });
+            settingsNote = 'the `dsh-rtk` namespace in the harness settings document';
+        }
+        catch (error) {
+            settingsNote = `settings namespace unavailable (${error instanceof Error ? error.message : String(error)}) — configuration comes from the composition only`;
+            const existing = settings.get('dsh-rtk');
+            if (existing !== undefined)
+                config = coordinate(normalizeConfig(existing));
+            ctx.on('settings/updated', (ns, next) => {
+                if (ns !== 'dsh-rtk')
+                    return;
+                config = coordinate(normalizeConfig(next));
+                applySourceFilterNote();
+            });
+        }
+    }
+    let disposeNote;
+    const systemPrompt = ctx.get('systemPrompt');
+    function applySourceFilterNote() {
+        if (systemPrompt === undefined)
+            return;
+        if (needsSourceFilterNote(config)) {
+            if (disposeNote !== undefined)
+                return;
+            disposeNote = systemPrompt.section({ name: 'rtk:read-compaction', order: 1010, text: SOURCE_FILTER_TROUBLESHOOTING_NOTE });
+            return;
+        }
+        disposeNote?.();
+        disposeNote = undefined;
+    }
+    applySourceFilterNote();
+    ctx.effect(() => () => {
+        disposeNote?.();
+        disposeNote = undefined;
+    }, 'dsh-rtk.prompt-note');
+    async function refreshRuntimeStatus() {
+        const resolution = await resolveRtkExecutable({ configured: config.rtkExecutable });
+        const probe = await runExecutable(resolution.command, ['--version'], { timeoutMs: 5000 });
+        const base = {
+            rtkExecutableCommand: resolution.command,
+            ...(resolution.resolvedPath === undefined ? {} : { rtkExecutablePath: resolution.resolvedPath }),
+            rtkExecutableResolver: resolution.resolver,
+            ...(resolution.warning === undefined ? {} : { rtkExecutableResolutionWarning: resolution.warning }),
+            lastCheckedAt: Date.now(),
+        };
+        runtimeStatus =
+            probe.code === 0
+                ? { rtkAvailable: true, ...base }
+                : {
+                    rtkAvailable: false,
+                    ...base,
+                    lastError: (probe.stderr || probe.stdout).replace(/\s+/g, ' ').trim() || `exit ${probe.code}`,
+                };
+        return runtimeStatus;
+    }
+    async function ensureRuntimeStatusFresh() {
+        if (!shouldRequireRtkAvailability(config))
+            return;
+        if (!isStatusStale(runtimeStatus, Date.now()))
+            return;
+        try {
+            await refreshRuntimeStatus();
+        }
+        catch (error) {
+            runtimeStatus = {
+                rtkAvailable: false,
+                lastCheckedAt: Date.now(),
+                lastError: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+    // ── command rewriting ────────────────────────────────────────────────────
+    ctx.on('tools/execute', async (exec, next) => {
+        if (!config.enabled)
+            return next();
+        if (config.mode !== 'rewrite')
+            return next();
+        if (!REWRITABLE_TOOLS.has(exec.name))
+            return next();
+        const args = asRecord(exec.arguments);
+        if (args === undefined || typeof args.command !== 'string')
+            return next();
+        await ensureRuntimeStatusFresh();
+        if (shouldSkipRewrite(config, runtimeStatus)) {
+            // The guard is standing the rewrite down because rtk is unavailable. Flag
+            // this result so post-execute can say so once per session.
+            if (config.notifyWhenRtkMissing) {
+                if (missingRtkCalls.size > 256)
+                    missingRtkCalls.clear();
+                missingRtkCalls.add(exec.callId);
+            }
+            return next();
+        }
+        const decision = await resolveRtkRewrite(args.command, {
+            runner: runExecutable,
+            executable: runtimeStatus.rtkExecutableCommand ?? config.rtkExecutable,
+            timeoutMs: config.rewriteTimeoutMs,
+            signal: exec.signal,
+        });
+        if (!decision.changed)
+            return next();
+        // `pwsh` is a rewrite target too, and PowerShell has no `export`.
+        const shell = exec.name === 'pwsh' ? 'powershell' : 'posix';
+        const command = applyRtkHistoryScope(decision.rewrittenCommand, rtkHistoryDbPath(), process.env.RTK_DB_PATH, shell);
+        if (config.showRewriteNotifications) {
+            // A cancelled call can be finalized on the `final-result` path, which
+            // bypasses post-execute and would leave its entry behind. The map is
+            // bounded so a notification nobody reads cannot grow without limit.
+            if (pendingSuggestions.size > 256)
+                pendingSuggestions.clear();
+            pendingSuggestions.set(exec.callId, `[rtk] rewrote: ${decision.originalCommand} -> ${decision.rewrittenCommand}`);
+        }
+        // `arguments` is declared readonly, but the around-dispatch stage is the
+        // one place the registry re-reads it before invoking the body. Restoring it
+        // in `finally` keeps every later stage — post-execute, content
+        // finalization, and the observation in `tools/result` — looking at the call
+        // the model actually made.
+        const mutable = exec;
+        mutable.arguments = { ...args, command };
+        try {
+            return await next();
+        }
+        catch (error) {
+            pendingSuggestions.delete(exec.callId);
+            throw error;
+        }
+        finally {
+            mutable.arguments = args;
+        }
+    });
+    // ── suggest mode ─────────────────────────────────────────────────────────
+    ctx.on('tools/execute', async (exec, next) => {
+        if (!config.enabled || config.mode !== 'suggest')
+            return next();
+        if (!REWRITABLE_TOOLS.has(exec.name))
+            return next();
+        const args = asRecord(exec.arguments);
+        if (args === undefined || typeof args.command !== 'string')
+            return next();
+        await ensureRuntimeStatusFresh();
+        if (shouldSkipRewrite(config, runtimeStatus)) {
+            // The guard is standing the rewrite down because rtk is unavailable. Flag
+            // this result so post-execute can say so once per session.
+            if (config.notifyWhenRtkMissing) {
+                if (missingRtkCalls.size > 256)
+                    missingRtkCalls.clear();
+                missingRtkCalls.add(exec.callId);
+            }
+            return next();
+        }
+        const decision = await resolveRtkRewrite(args.command, {
+            runner: runExecutable,
+            executable: runtimeStatus.rtkExecutableCommand ?? config.rtkExecutable,
+            timeoutMs: config.rewriteTimeoutMs,
+            signal: exec.signal,
+        });
+        if (decision.changed) {
+            if (pendingSuggestions.size > 256)
+                pendingSuggestions.clear();
+            pendingSuggestions.set(exec.callId, `[rtk] suggestion: ${decision.rewrittenCommand}`);
+        }
+        try {
+            return await next();
+        }
+        catch (error) {
+            pendingSuggestions.delete(exec.callId);
+            throw error;
+        }
+    });
+    // ── output compaction ────────────────────────────────────────────────────
+    ctx.on('tools/post-execute', async (exec, result, next) => {
+        const decision = await next();
+        let notice = pendingSuggestions.get(exec.callId);
+        pendingSuggestions.delete(exec.callId);
+        if (missingRtkCalls.delete(exec.callId) && config.notifyWhenRtkMissing) {
+            const agentKey = exec.agent?.id;
+            if (agentKey !== undefined && !notifiedAgents.has(agentKey)) {
+                if (notifiedAgents.size > 256)
+                    notifiedAgents.clear();
+                notifiedAgents.add(agentKey);
+                notice = MISSING_RTK_NOTICE;
+            }
+        }
+        if (decision.kind !== 'accept')
+            return decision;
+        if (!config.enabled)
+            return decision;
+        const source = decision.content ?? result.content;
+        if (source.length === 0)
+            return decision;
+        let content = source;
+        try {
+            const outcome = compactToolResult({ toolName: exec.name, args: exec.arguments, content: source }, config);
+            if (outcome.changed && outcome.content !== undefined) {
+                content = outcome.content;
+                if (outcome.metadata !== undefined && config.outputCompaction.trackSavings) {
+                    metrics.track(source.map((block) => block.text ?? '').join('\n'), content.map((block) => block.text ?? '').join('\n'), exec.name, outcome.techniques);
+                }
+            }
+        }
+        catch {
+            // Compaction is an optimization; a bug in it must not break the tool call.
+            return notice === undefined ? decision : { kind: 'accept', content: appendNotice(source, notice) };
+        }
+        // A sibling listener may have attached contexts for the next request.
+        // Rebuilding the decision without them would drop them silently, and the
+        // shipped search tool does exactly that when a result was capped.
+        const contexts = decision.additionalContexts;
+        const rebuild = (blocks) => ({
+            kind: 'accept',
+            content: blocks,
+            ...(contexts === undefined ? {} : { additionalContexts: contexts }),
+        });
+        if (notice === undefined) {
+            return content === source ? decision : rebuild([...content]);
+        }
+        return rebuild(appendNotice(content, notice));
+    });
+    // ── the /rtk command ─────────────────────────────────────────────────────
+    const commands = ctx.get('commands');
+    if (commands !== undefined) {
+        const command = createRtkCommand({
+            getConfig: () => config,
+            resetConfig: async () => {
+                if (ownedScope === undefined)
+                    return;
+                await ownedScope.replace({});
+                config = coordinate(normalizeConfig(settings?.get('dsh-rtk')));
+            },
+            getRuntimeStatus: () => runtimeStatus,
+            refreshRuntimeStatus,
+            getMetrics: () => metrics.summary(),
+            clearMetrics: () => metrics.clear(),
+            configLocation: () => settingsNote,
+        });
+        ctx.effect(() => commands.register(command), 'dsh-rtk.command');
+    }
+}
+/**
+ * Insert a one-line notice into a result, ahead of any trailing status markers.
+ *
+ * The markers must stay last. The harness parses the final line for the exit
+ * status — the model is told to check `[exit code: N]` on every call, and the
+ * Web UI derives its exit-status pill from the same line. Appending a notice
+ * after them would break both silently, which is exactly what an earlier
+ * version of this function did.
+ */
+function appendNotice(content, notice) {
+    const blocks = [...content];
+    for (let index = blocks.length - 1; index >= 0; index -= 1) {
+        const block = blocks[index];
+        if (block === undefined || block.type !== 'text')
+            continue;
+        const parts = parseBashResult(block.text);
+        if (parts.empty || parts.markers.length === 0) {
+            blocks[index] = { type: 'text', text: `${block.text}\n${notice}` };
+            return blocks;
+        }
+        const stdout = parts.stdout.length > 0 ? `${parts.stdout}\n${notice}` : notice;
+        blocks[index] = { type: 'text', text: renderBashResult({ ...parts, stdout }) };
+        return blocks;
+    }
+    return [...blocks, { type: 'text', text: notice }];
+}
+export { READ_COMPACTION_BANNER_PREFIX };
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

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

package/lib/metrics.d.ts

@@ -0,0 +1,35 @@
+/** Per-tool savings accumulators for the current session. */
+export interface ToolSavings {
+    calls: number;
+    originalChars: number;
+    compactedChars: number;
+}
+/** One session's compaction savings. */
+export interface MetricsSummary {
+    calls: number;
+    originalChars: number;
+    compactedChars: number;
+    savedChars: number;
+    savedPercent: number;
+    byTool: Record<string, ToolSavings>;
+    /** How often each technique fired, across all calls. */
+    byTechnique: Record<string, number>;
+}
+/** Accumulates compaction savings; one instance per plugin application. */
+export interface MetricsTracker {
+    /** Record one compacted result. A no-op result must not be passed here. */
+    track(originalText: string, compactedText: string, tool: string, techniques: readonly string[]): void;
+    /** Current totals, recomputed on each call so callers cannot mutate them. */
+    summary(): MetricsSummary;
+    /** Drop all recorded savings. */
+    clear(): void;
+}
+/**
+ * Build the session metrics accumulator.
+ *
+ * Savings are approximate by construction — character counts stand in for
+ * tokens — but they are measured on exactly the strings that were swapped, so
+ * the ratio is honest even when the absolute number is not.
+ */
+export declare function createMetricsTracker(): MetricsTracker;
+//# sourceMappingURL=metrics.d.ts.map

package/lib/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../src/metrics.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,aAAa,EAAE,MAAM,CAAA;IACrB,cAAc,EAAE,MAAM,CAAA;CACvB;AAED,wCAAwC;AACxC,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,aAAa,EAAE,MAAM,CAAA;IACrB,cAAc,EAAE,MAAM,CAAA;IACtB,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,MAAM,CAAA;IACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;IACnC,wDAAwD;IACxD,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACpC;AAED,2EAA2E;AAC3E,MAAM,WAAW,cAAc;IAC7B,2EAA2E;IAC3E,KAAK,CAAC,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAA;IACrG,6EAA6E;IAC7E,OAAO,IAAI,cAAc,CAAA;IACzB,iCAAiC;IACjC,KAAK,IAAI,IAAI,CAAA;CACd;AAMD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,IAAI,cAAc,CA2CrD"}

package/lib/metrics.js

@@ -0,0 +1,51 @@
+function emptyTotals() {
+    return { calls: 0, originalChars: 0, compactedChars: 0 };
+}
+/**
+ * Build the session metrics accumulator.
+ *
+ * Savings are approximate by construction — character counts stand in for
+ * tokens — but they are measured on exactly the strings that were swapped, so
+ * the ratio is honest even when the absolute number is not.
+ */
+export function createMetricsTracker() {
+    let calls = 0;
+    let originalChars = 0;
+    let compactedChars = 0;
+    const byTool = new Map();
+    const byTechnique = new Map();
+    return {
+        track(originalText, compactedText, tool, techniques) {
+            calls += 1;
+            originalChars += originalText.length;
+            compactedChars += compactedText.length;
+            const totals = byTool.get(tool) ?? emptyTotals();
+            totals.calls += 1;
+            totals.originalChars += originalText.length;
+            totals.compactedChars += compactedText.length;
+            byTool.set(tool, totals);
+            for (const technique of techniques)
+                byTechnique.set(technique, (byTechnique.get(technique) ?? 0) + 1);
+        },
+        summary() {
+            const savedChars = Math.max(0, originalChars - compactedChars);
+            return {
+                calls,
+                originalChars,
+                compactedChars,
+                savedChars,
+                savedPercent: originalChars === 0 ? 0 : Math.round((savedChars / originalChars) * 1000) / 10,
+                byTool: Object.fromEntries(byTool),
+                byTechnique: Object.fromEntries(byTechnique),
+            };
+        },
+        clear() {
+            calls = 0;
+            originalChars = 0;
+            compactedChars = 0;
+            byTool.clear();
+            byTechnique.clear();
+        },
+    };
+}
+//# sourceMappingURL=metrics.js.map

package/lib/metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../src/metrics.ts"],"names":[],"mappings":"AA6BA,SAAS,WAAW;IAClB,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,CAAA;AAC1D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB;IAClC,IAAI,KAAK,GAAG,CAAC,CAAA;IACb,IAAI,aAAa,GAAG,CAAC,CAAA;IACrB,IAAI,cAAc,GAAG,CAAC,CAAA;IACtB,MAAM,MAAM,GAAG,IAAI,GAAG,EAAuB,CAAA;IAC7C,MAAM,WAAW,GAAG,IAAI,GAAG,EAAkB,CAAA;IAE7C,OAAO;QACL,KAAK,CAAC,YAAY,EAAE,aAAa,EAAE,IAAI,EAAE,UAAU;YACjD,KAAK,IAAI,CAAC,CAAA;YACV,aAAa,IAAI,YAAY,CAAC,MAAM,CAAA;YACpC,cAAc,IAAI,aAAa,CAAC,MAAM,CAAA;YAEtC,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,WAAW,EAAE,CAAA;YAChD,MAAM,CAAC,KAAK,IAAI,CAAC,CAAA;YACjB,MAAM,CAAC,aAAa,IAAI,YAAY,CAAC,MAAM,CAAA;YAC3C,MAAM,CAAC,cAAc,IAAI,aAAa,CAAC,MAAM,CAAA;YAC7C,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;YAExB,KAAK,MAAM,SAAS,IAAI,UAAU;gBAAE,WAAW,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;QACvG,CAAC;QAED,OAAO;YACL,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,aAAa,GAAG,cAAc,CAAC,CAAA;YAC9D,OAAO;gBACL,KAAK;gBACL,aAAa;gBACb,cAAc;gBACd,UAAU;gBACV,YAAY,EAAE,aAAa,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,UAAU,GAAG,aAAa,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE;gBAC5F,MAAM,EAAE,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC;gBAClC,WAAW,EAAE,MAAM,CAAC,WAAW,CAAC,WAAW,CAAC;aAC7C,CAAA;QACH,CAAC;QAED,KAAK;YACH,KAAK,GAAG,CAAC,CAAA;YACT,aAAa,GAAG,CAAC,CAAA;YACjB,cAAc,GAAG,CAAC,CAAA;YAClB,MAAM,CAAC,KAAK,EAAE,CAAA;YACd,WAAW,CAAC,KAAK,EAAE,CAAA;QACrB,CAAC;KACF,CAAA;AACH,CAAC"}

package/lib/rtk-executable.d.ts

@@ -0,0 +1,51 @@
+/** One settled `rtk` invocation. */
+export interface RtkRunResult {
+    code: number;
+    stdout: string;
+    stderr: string;
+}
+/** How an rtk executable path was discovered. */
+export type RtkResolverName = 'where' | 'which' | 'configured';
+/** The executable this plugin will use, and how sure it is. */
+export interface RtkExecutableResolution {
+    command: string;
+    resolvedPath?: string;
+    resolver: RtkResolverName;
+    warning?: string;
+}
+/** Everything the resolver needs; all fields have production defaults. */
+export interface ResolveRtkExecutableOptions {
+    /** Configured executable name or path. */
+    configured: string;
+    /** Command used to look the name up on PATH. */
+    resolverCommand?: string;
+    timeoutMs?: number;
+    platform?: NodeJS.Platform;
+}
+/** Resolver executable name for a platform. */
+export declare function resolverNameFor(platform: NodeJS.Platform): 'where' | 'which';
+/**
+ * Invoke one executable and settle with its output.
+ *
+ * A missing binary or a non-zero exit resolves rather than rejects: every
+ * caller here treats "rtk said no" as an ordinary outcome, and rejecting would
+ * make each call site wrap the same try/catch. Arguments are passed as an
+ * array, so no command string is ever handed to a shell.
+ */
+export declare function runExecutable(command: string, args: readonly string[], options?: {
+    timeoutMs?: number;
+    signal?: AbortSignal;
+}): Promise<RtkRunResult>;
+/** First non-empty line of resolver output, with surrounding quotes removed. */
+export declare function parseExecutablePath(stdout: string): string | undefined;
+/**
+ * Resolve the rtk executable, preferring the configured value.
+ *
+ * A configured value that is not a bare name is taken as an absolute path and
+ * used verbatim — the deployment said where rtk lives, so a PATH probe would
+ * only second-guess it. Bare names are looked up so `/rtk verify` can report a
+ * real path; a failed lookup is not fatal, because the name may still resolve
+ * when the command actually runs.
+ */
+export declare function resolveRtkExecutable(options: ResolveRtkExecutableOptions): Promise<RtkExecutableResolution>;
+//# sourceMappingURL=rtk-executable.d.ts.map

package/lib/rtk-executable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rtk-executable.d.ts","sourceRoot":"","sources":["../src/rtk-executable.ts"],"names":[],"mappings":"AAEA,oCAAoC;AACpC,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;CACf;AAED,iDAAiD;AACjD,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,OAAO,GAAG,YAAY,CAAA;AAE9D,+DAA+D;AAC/D,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAA;IACf,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,EAAE,eAAe,CAAA;IACzB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,0EAA0E;AAC1E,MAAM,WAAW,2BAA2B;IAC1C,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAA;IAClB,gDAAgD;IAChD,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAA;CAC3B;AAED,+CAA+C;AAC/C,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,GAAG,OAAO,GAAG,OAAO,CAE5E;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAO,GACzD,OAAO,CAAC,YAAY,CAAC,CAqBvB;AAED,gFAAgF;AAChF,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAWtE;AAED;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,2BAA2B,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAuBjH"}

package/lib/rtk-executable.js

@@ -0,0 +1,75 @@
+import { execFile } from 'node:child_process';
+/** Resolver executable name for a platform. */
+export function resolverNameFor(platform) {
+    return platform === 'win32' ? 'where' : 'which';
+}
+/**
+ * Invoke one executable and settle with its output.
+ *
+ * A missing binary or a non-zero exit resolves rather than rejects: every
+ * caller here treats "rtk said no" as an ordinary outcome, and rejecting would
+ * make each call site wrap the same try/catch. Arguments are passed as an
+ * array, so no command string is ever handed to a shell.
+ */
+export function runExecutable(command, args, options = {}) {
+    return new Promise((resolve) => {
+        execFile(command, [...args], {
+            timeout: options.timeoutMs ?? 3000,
+            maxBuffer: 4 * 1024 * 1024,
+            windowsHide: true,
+            ...(options.signal === undefined ? {} : { signal: options.signal }),
+        }, (error, stdout, stderr) => {
+            if (error === null) {
+                resolve({ code: 0, stdout, stderr });
+                return;
+            }
+            const code = typeof error.code === 'number' ? error.code : 1;
+            resolve({ code, stdout: stdout ?? '', stderr: stderr ?? '' });
+        });
+    });
+}
+/** First non-empty line of resolver output, with surrounding quotes removed. */
+export function parseExecutablePath(stdout) {
+    for (const line of stdout.split(/\r?\n/)) {
+        let candidate = line.trim();
+        if (candidate.length >= 2) {
+            const first = candidate[0];
+            const last = candidate[candidate.length - 1];
+            if ((first === '"' && last === '"') || (first === "'" && last === "'"))
+                candidate = candidate.slice(1, -1);
+        }
+        if (candidate)
+            return candidate;
+    }
+    return undefined;
+}
+/**
+ * Resolve the rtk executable, preferring the configured value.
+ *
+ * A configured value that is not a bare name is taken as an absolute path and
+ * used verbatim — the deployment said where rtk lives, so a PATH probe would
+ * only second-guess it. Bare names are looked up so `/rtk verify` can report a
+ * real path; a failed lookup is not fatal, because the name may still resolve
+ * when the command actually runs.
+ */
+export async function resolveRtkExecutable(options) {
+    const platform = options.platform ?? process.platform;
+    const configured = options.configured.trim() || 'rtk';
+    const looksLikePath = configured.includes('/') || configured.includes('\\');
+    if (looksLikePath) {
+        return { command: configured, resolvedPath: configured, resolver: 'configured' };
+    }
+    const resolver = options.resolverCommand ?? resolverNameFor(platform);
+    const result = await runExecutable(resolver, [configured], { timeoutMs: options.timeoutMs ?? 1000 });
+    const resolvedPath = parseExecutablePath(result.stdout);
+    if (result.code === 0 && resolvedPath !== undefined) {
+        return { command: resolvedPath, resolvedPath, resolver: resolver };
+    }
+    const detail = (result.stderr || result.stdout).replace(/\s+/g, ' ').trim();
+    return {
+        command: configured,
+        resolver: resolver,
+        warning: `could not resolve ${configured} via ${resolver}${detail ? `: ${detail}` : ''}`,
+    };
+}
+//# sourceMappingURL=rtk-executable.js.map