@anthara/pi-claude 0.0.0-stage → 0.1.0

package/dist/kernel/prompt-catalog/slash-menu.js

@@ -0,0 +1,13 @@
+const COMMAND_BEING_TYPED = /^\/(?<typed>\S+)$/;
+export function commandNameTypedAtLineStart(line, cursorCol, options) {
+    if (options.force === true) {
+        return undefined;
+    }
+    return COMMAND_BEING_TYPED.exec(line.slice(0, cursorCol).trimStart())?.groups?.typed;
+}
+export function menuItemOf({ qualifiedName, argumentHint, description }) {
+    const command = qualifiedName;
+    const text = [argumentHint, description].filter((part) => part !== undefined && part !== '').join(' — ');
+    return text === '' ? { value: command, label: command } : { value: command, label: command, description: text };
+}
+//# sourceMappingURL=slash-menu.js.map

package/dist/kernel/prompt-catalog/slash-menu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slash-menu.js","sourceRoot":"","sources":["../../../src/kernel/prompt-catalog/slash-menu.ts"],"names":[],"mappings":"AAKA,MAAM,mBAAmB,GAAG,mBAAmB,CAAC;AAEhD,MAAM,UAAU,2BAA2B,CAAC,IAAY,EAAE,SAAiB,EAAE,OAA0B;IACrG,IAAI,OAAO,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;QAC3B,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,SAAS,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC;AACvF,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAa;IAChF,MAAM,OAAO,GAAG,aAAa,CAAC;IAC9B,MAAM,IAAI,GAAG,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACzG,OAAO,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;AAClH,CAAC"}

package/dist/kernel/prompt-expansion/arguments.d.ts

@@ -0,0 +1,6 @@
+import type { InvocationArguments } from './invocation-arguments.js';
+export interface SubstitutedArguments {
+    readonly text: string;
+    readonly consumed: boolean;
+}
+export declare function substituteArguments(body: string, args: InvocationArguments, named: readonly string[]): SubstitutedArguments;

package/dist/kernel/prompt-expansion/arguments.js

@@ -0,0 +1,40 @@
+const ESCAPED_BACKSLASH_TEXT = '\\\\';
+const NO_ARGUMENT = '';
+// the alternation order is load-bearing: escapes first, so `\$1` never expands, and `$ARGUMENTS[0]` before bare `$ARGUMENTS`
+function placeholderPattern(named) {
+    const names = named.length > 0 ? named.join('|') : '(?!)';
+    return new RegExp([
+        String.raw `(?<escapedBackslash>\\{2}(?=\$))`,
+        String.raw `(?<escapedDollar>\\\$(?=\d|ARGUMENTS\b|(?:${names})\b))`,
+        String.raw `\$ARGUMENTS\[(?<indexed>\d+)\]`,
+        String.raw `(?<all>\$ARGUMENTS\b)`,
+        String.raw `\$(?<shorthand>\d+)`,
+        String.raw `\$(?<named>${names})\b`,
+    ].join('|'), 'g');
+}
+export function substituteArguments(body, args, named) {
+    let consumed = false;
+    const text = body.replaceAll(placeholderPattern(named), (token, ...captures) => {
+        const resolution = resolve(captures.at(-1), token, args, named);
+        consumed ||= resolution.consumed;
+        return resolution.text;
+    });
+    return { text, consumed };
+}
+function resolve(groups, token, args, named) {
+    const kind = Object.keys(RESOLVERS).find((candidate) => groups[candidate] !== undefined) ?? 'all';
+    return RESOLVERS[kind](groups[kind] ?? '', token, args, named);
+}
+const untouched = (text) => ({ text, consumed: false });
+function positional(argument, token) {
+    return argument === undefined ? untouched(token) : { text: argument, consumed: true };
+}
+const RESOLVERS = {
+    escapedBackslash: () => untouched(ESCAPED_BACKSLASH_TEXT),
+    escapedDollar: () => untouched('$'),
+    indexed: (index, token, args) => positional(args.parts[Number(index)], token),
+    shorthand: (index, token, args) => positional(args.parts[Number(index)], token),
+    named: (name, _token, args, named) => ({ text: args.parts[named.indexOf(name)] ?? NO_ARGUMENT, consumed: true }),
+    all: (_captured, _token, args) => ({ text: args.raw, consumed: true }),
+};
+//# sourceMappingURL=arguments.js.map

package/dist/kernel/prompt-expansion/arguments.js.map

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

package/dist/kernel/prompt-expansion/benign-exit-one.d.ts

@@ -0,0 +1 @@
+export declare function isBenignExitOne(command: string): boolean;

package/dist/kernel/prompt-expansion/benign-exit-one.js

@@ -0,0 +1,20 @@
+// Portions adapted from pi-code (MIT, github.com/ilovepixelart/pi-code), extensions/internal/command-spans.ts.
+import { splitSegments } from './shell-segments.js';
+const EXIT_ONE_IS_A_RESULT = new Set(['grep', 'rg', 'egrep', 'fgrep', 'find', 'diff', 'test', '[']);
+const GIT_SUBCOMMANDS_THAT_EXIT_ONE = new Set(['diff', 'grep']);
+const SHORT_CIRCUIT_OPERATORS = /&&|\|\|/;
+export function isBenignExitOne(command) {
+    const segments = splitSegments(command);
+    if (segments.length === 0) {
+        return false;
+    }
+    if (SHORT_CIRCUIT_OPERATORS.test(command)) {
+        return segments.every(isCarveOutSegment);
+    }
+    return isCarveOutSegment(segments.at(-1) ?? '');
+}
+function isCarveOutSegment(segment) {
+    const [program = '', subcommand = ''] = segment.trim().split(/\s+/);
+    return program === 'git' ? GIT_SUBCOMMANDS_THAT_EXIT_ONE.has(subcommand) : EXIT_ONE_IS_A_RESULT.has(program);
+}
+//# sourceMappingURL=benign-exit-one.js.map

package/dist/kernel/prompt-expansion/benign-exit-one.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"benign-exit-one.js","sourceRoot":"","sources":["../../../src/kernel/prompt-expansion/benign-exit-one.ts"],"names":[],"mappings":"AAAA,+GAA+G;AAC/G,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;AACpG,MAAM,6BAA6B,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAChE,MAAM,uBAAuB,GAAG,SAAS,CAAC;AAE1C,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,MAAM,QAAQ,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IACxC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,uBAAuB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1C,OAAO,QAAQ,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,iBAAiB,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;AAClD,CAAC;AAED,SAAS,iBAAiB,CAAC,OAAe;IACxC,MAAM,CAAC,OAAO,GAAG,EAAE,EAAE,UAAU,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACpE,OAAO,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,6BAA6B,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,oBAAoB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAC/G,CAAC"}

package/dist/kernel/prompt-expansion/dynamic-spans.d.ts

@@ -0,0 +1,10 @@
+export type DynamicSpanKind = 'inline-shell' | 'shell-block' | 'file';
+export interface DynamicSpan {
+    readonly kind: DynamicSpanKind;
+    readonly start: number;
+    readonly end: number;
+    readonly lead: string;
+    readonly payload: string;
+    readonly matched: string;
+}
+export declare function findDynamicSpans(body: string): readonly DynamicSpan[];

package/dist/kernel/prompt-expansion/dynamic-spans.js

@@ -0,0 +1,96 @@
+const INLINE_SHELL = /(?<lead>^|\s)!`(?<payload>[^`]+)`/g;
+const FILE_REFERENCE = /(?<lead>^|\s)@(?<payload>\S+)/g;
+const EXECUTABLE_FENCE_LENGTH = 3;
+export function findDynamicSpans(body) {
+    const blocks = fenceBlocks(body);
+    const isLiteral = (index) => blocks.some(({ start, end }) => index >= start && index < end);
+    const spans = [
+        ...blocks.filter(({ executes }) => executes).map(shellBlockSpan),
+        ...matchesOf(INLINE_SHELL, 'inline-shell', body).filter(({ start }) => !isLiteral(start)),
+        ...matchesOf(FILE_REFERENCE, 'file', body).filter(({ start }) => !isLiteral(start)),
+    ];
+    spans.sort((a, b) => a.start - b.start);
+    return withoutOverlaps(spans);
+}
+function shellBlockSpan({ start, end, content }) {
+    return { kind: 'shell-block', start, end, lead: '', payload: content, matched: '```!' };
+}
+function matchesOf(pattern, kind, body) {
+    return [...body.matchAll(pattern)].map((match) => ({
+        kind,
+        start: match.index,
+        end: match.index + match[0].length,
+        lead: match.groups?.lead ?? '',
+        payload: match.groups?.payload ?? '',
+        matched: match[0],
+    }));
+}
+function withoutOverlaps(sorted) {
+    const kept = [];
+    for (const span of sorted) {
+        if (span.start >= (kept.at(-1)?.end ?? 0)) {
+            kept.push(span);
+        }
+    }
+    return kept;
+}
+function fenceBlocks(body) {
+    const scanner = new FenceScanner(body);
+    let offset = 0;
+    for (const line of body.split('\n')) {
+        scanner.scan(line, offset);
+        offset += line.length + 1;
+    }
+    return scanner.finish();
+}
+class FenceScanner {
+    #body;
+    #blocks = [];
+    #fence;
+    #open;
+    constructor(body) {
+        this.#body = body;
+    }
+    scan(line, offset) {
+        const next = stepFence(this.#fence, line.trimStart());
+        if (next !== undefined && this.#fence === undefined) {
+            this.#open = { start: offset, executes: opensExecutableBlock(line, next), contentStart: offset + line.length + 1 };
+        }
+        else if (next === undefined && this.#fence !== undefined) {
+            this.#close(offset, offset + line.length);
+        }
+        this.#fence = next;
+    }
+    finish() {
+        return this.#open === undefined ? this.#blocks : [...this.#blocks, { start: this.#open.start, end: this.#body.length, executes: false, content: '' }];
+    }
+    #close(lineStart, lineEnd) {
+        if (this.#open !== undefined) {
+            const content = this.#body.slice(Math.min(this.#open.contentStart, lineStart), lineStart).replace(/\n$/, '');
+            this.#blocks.push({ start: this.#open.start, end: lineEnd, executes: this.#open.executes, content });
+            this.#open = undefined;
+        }
+    }
+}
+const opensExecutableBlock = (line, fence) => line.startsWith('```') && fence.length === EXECUTABLE_FENCE_LENGTH && line.slice(EXECUTABLE_FENCE_LENGTH).trim() === '!';
+function stepFence(fence, trimmed) {
+    const marker = fenceMarker(trimmed);
+    if (fence === undefined) {
+        return marker === undefined ? undefined : { marker, length: runLength(trimmed, marker) };
+    }
+    return marker === fence.marker && runLength(trimmed, marker) >= fence.length ? undefined : fence;
+}
+function fenceMarker(lineStart) {
+    if (lineStart.startsWith('```')) {
+        return '`';
+    }
+    return lineStart.startsWith('~~~') ? '~' : undefined;
+}
+function runLength(lineStart, marker) {
+    let length = 0;
+    while (lineStart[length] === marker) {
+        length += 1;
+    }
+    return length;
+}
+//# sourceMappingURL=dynamic-spans.js.map

package/dist/kernel/prompt-expansion/dynamic-spans.js.map

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

package/dist/kernel/prompt-expansion/errors.d.ts

@@ -0,0 +1,7 @@
+import { AntharaError } from '../../errors/anthara-error.js';
+export declare class ShellSpanFailedError extends AntharaError {
+    constructor(pattern: string, stderr: string);
+}
+export declare class ShellSpanStoppedError extends AntharaError {
+    constructor(pattern: string);
+}

package/dist/kernel/prompt-expansion/errors.js

@@ -0,0 +1,12 @@
+import { AntharaError } from '../../errors/anthara-error.js';
+export class ShellSpanFailedError extends AntharaError {
+    constructor(pattern, stderr) {
+        super(`Shell command failed for pattern "${pattern}"\n[stderr]\n${stderr}`);
+    }
+}
+export class ShellSpanStoppedError extends AntharaError {
+    constructor(pattern) {
+        super(`Shell command was stopped for pattern "${pattern}": it ran past its time limit or printed too much output`);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/kernel/prompt-expansion/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/kernel/prompt-expansion/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAE7D,MAAM,OAAO,oBAAqB,SAAQ,YAAY;IACpD,YAAY,OAAe,EAAE,MAAc;QACzC,KAAK,CAAC,qCAAqC,OAAO,gBAAgB,MAAM,EAAE,CAAC,CAAC;IAC9E,CAAC;CACF;AAED,MAAM,OAAO,qBAAsB,SAAQ,YAAY;IACrD,YAAY,OAAe;QACzB,KAAK,CAAC,0CAA0C,OAAO,0DAA0D,CAAC,CAAC;IACrH,CAAC;CACF"}

package/dist/kernel/prompt-expansion/expand-invocable.d.ts

@@ -0,0 +1,5 @@
+import type { ExtensionAPI, ExtensionContext } from '@earendil-works/pi-coding-agent';
+import type { Invocable } from '../prompt-catalog/invocable.js';
+export type ExpansionApi = Pick<ExtensionAPI, 'exec'>;
+export type ExpansionContext = Pick<ExtensionContext, 'cwd' | 'hasUI' | 'isProjectTrusted' | 'sessionManager' | 'ui'>;
+export declare function expandInvocable(invocable: Invocable, args: string, pi: ExpansionApi, ctx: ExpansionContext): Promise<string>;

package/dist/kernel/prompt-expansion/expand-invocable.js

@@ -0,0 +1,26 @@
+import { homedir } from 'node:os';
+import { claudeConfigDir } from '../claude-home/config-dir.js';
+import { projectFolders } from '../claude-home/project-folders.js';
+import { sessionUserConfigResolver } from '../plugin-config/session-resolver.js';
+import { expandPrompt } from './expand-prompt.js';
+import { PiExecShellRunner } from './pi-exec-shell-runner.js';
+import { spanPolicyFor } from './span-policy.js';
+export async function expandInvocable(invocable, args, pi, ctx) {
+    return expandPrompt(promptSourceOf(invocable), { args }, await environmentFor(invocable, pi, ctx));
+}
+async function environmentFor(invocable, pi, ctx) {
+    const projectRoot = projectFolders(ctx.cwd, homedir()).at(-1) ?? ctx.cwd;
+    return {
+        projectRoot,
+        cwd: ctx.cwd,
+        sessionId: ctx.sessionManager.getSessionId(),
+        shell: new PiExecShellRunner((command, args, options) => pi.exec(command, args, options), projectRoot),
+        spanPolicy: await spanPolicyFor(invocable, ctx, claudeConfigDir(process.env, homedir())),
+        userConfig: sessionUserConfigResolver(),
+    };
+}
+function promptSourceOf({ body, argumentNames, dir, plugin }) {
+    const base = { body, argumentNames, skillDir: dir };
+    return plugin === undefined ? base : { ...base, plugin: { name: plugin.name, root: plugin.root, dataDir: plugin.dataDir } };
+}
+//# sourceMappingURL=expand-invocable.js.map

package/dist/kernel/prompt-expansion/expand-invocable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expand-invocable.js","sourceRoot":"","sources":["../../../src/kernel/prompt-expansion/expand-invocable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACnE,OAAO,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AAEjF,OAAO,EAAE,YAAY,EAAgD,MAAM,oBAAoB,CAAC;AAChG,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAKjD,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,SAAoB,EAAE,IAAY,EAAE,EAAgB,EAAE,GAAqB;IAC/G,OAAO,YAAY,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,MAAM,cAAc,CAAC,SAAS,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC;AACrG,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,SAAoB,EAAE,EAAgB,EAAE,GAAqB;IACzF,MAAM,WAAW,GAAG,cAAc,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC;IACzE,OAAO;QACL,WAAW;QACX,GAAG,EAAE,GAAG,CAAC,GAAG;QACZ,SAAS,EAAE,GAAG,CAAC,cAAc,CAAC,YAAY,EAAE;QAC5C,KAAK,EAAE,IAAI,iBAAiB,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC;QACtG,UAAU,EAAE,MAAM,aAAa,CAAC,SAAS,EAAE,GAAG,EAAE,eAAe,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;QACxF,UAAU,EAAE,yBAAyB,EAAE;KACxC,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,EAAa;IACrE,MAAM,IAAI,GAAG,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;IACpD,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;AAC9H,CAAC"}

package/dist/kernel/prompt-expansion/expand-prompt.d.ts

@@ -0,0 +1,25 @@
+import type { UserConfigResolver } from '../plugin-config/user-config-resolver.js';
+import type { ShellRunner } from './shell-runner.js';
+import { type SpanPolicy } from './shell-spans.js';
+export interface PromptSource {
+    readonly body: string;
+    readonly argumentNames: readonly string[];
+    readonly skillDir: string;
+    readonly plugin?: {
+        readonly name: string;
+        readonly root: string;
+        readonly dataDir: string;
+    };
+}
+export interface PromptInvocation {
+    readonly args: string;
+}
+export interface ExpansionEnvironment {
+    readonly projectRoot: string;
+    readonly cwd: string;
+    readonly sessionId: string;
+    readonly shell: ShellRunner;
+    readonly spanPolicy: SpanPolicy;
+    readonly userConfig: UserConfigResolver;
+}
+export declare function expandPrompt(source: PromptSource, invocation: PromptInvocation, env: ExpansionEnvironment): Promise<string>;

package/dist/kernel/prompt-expansion/expand-prompt.js

@@ -0,0 +1,37 @@
+import { findDynamicSpans } from './dynamic-spans.js';
+import { expandSpans } from './expand-spans.js';
+import { inlineFileReference } from './file-references.js';
+import { parseInvocationArguments } from './invocation-arguments.js';
+import { PromptSubstitution } from './prompt-substitution.js';
+import { runShellSpan } from './shell-spans.js';
+// Arguments and variables fill the template, never what a span prints, and a span is located before they do, so text a
+// caller passes in can never become a command.
+export async function expandPrompt(source, invocation, env) {
+    const args = parseInvocationArguments(invocation.args);
+    const substitution = new PromptSubstitution(args, source.argumentNames, variablesFor(source, env), userConfigFiller(source, env));
+    const expanded = await expandSpans(source.body, findDynamicSpans(source.body), {
+        template: (text) => substitution.apply(text),
+        templateCommand: (text) => substitution.applyToCommand(text),
+        resolve: (span) => resolveSpan(span, env),
+    });
+    return substitution.argumentsRead || args.raw === '' ? expanded : `${expanded}\n\nARGUMENTS: ${args.raw}`;
+}
+function variablesFor({ skillDir, plugin }, env) {
+    return {
+        CLAUDE_SKILL_DIR: skillDir,
+        CLAUDE_PLUGIN_ROOT: plugin?.root,
+        CLAUDE_PLUGIN_DATA: plugin?.dataDir,
+        CLAUDE_PROJECT_DIR: env.projectRoot,
+        CLAUDE_SESSION_ID: env.sessionId,
+    };
+}
+function userConfigFiller({ plugin }, { userConfig }) {
+    return plugin === undefined ? (text) => text : (text) => userConfig.substitute(text, plugin, 'body');
+}
+function resolveSpan(span, env) {
+    if (span.kind === 'file') {
+        return Promise.resolve(inlineFileReference(span, env.projectRoot));
+    }
+    return runShellSpan(span, { shell: env.shell, cwd: env.cwd, policy: env.spanPolicy });
+}
+//# sourceMappingURL=expand-prompt.js.map

package/dist/kernel/prompt-expansion/expand-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expand-prompt.js","sourceRoot":"","sources":["../../../src/kernel/prompt-expansion/expand-prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAoB,MAAM,oBAAoB,CAAC;AAExE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D,OAAO,EAAE,YAAY,EAAmB,MAAM,kBAAkB,CAAC;AAuBjE,uHAAuH;AACvH,+CAA+C;AAC/C,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAAoB,EAAE,UAA4B,EAAE,GAAyB;IAC9G,MAAM,IAAI,GAAG,wBAAwB,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACvD,MAAM,YAAY,GAAG,IAAI,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,aAAa,EAAE,YAAY,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,gBAAgB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;IAClI,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,MAAM,CAAC,IAAI,EAAE,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE;QAC7E,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC;QAC5C,eAAe,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,cAAc,CAAC,IAAI,CAAC;QAC5D,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,GAAG,CAAC;KAC1C,CAAC,CAAC;IACH,OAAO,YAAY,CAAC,aAAa,IAAI,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,kBAAkB,IAAI,CAAC,GAAG,EAAE,CAAC;AAC5G,CAAC;AAED,SAAS,YAAY,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAgB,EAAE,GAAyB;IACjF,OAAO;QACL,gBAAgB,EAAE,QAAQ;QAC1B,kBAAkB,EAAE,MAAM,EAAE,IAAI;QAChC,kBAAkB,EAAE,MAAM,EAAE,OAAO;QACnC,kBAAkB,EAAE,GAAG,CAAC,WAAW;QACnC,iBAAiB,EAAE,GAAG,CAAC,SAAS;KACjC,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,EAAE,MAAM,EAAgB,EAAE,EAAE,UAAU,EAAwB;IACtF,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AACvG,CAAC;AAED,SAAS,WAAW,CAAC,IAAiB,EAAE,GAAyB;IAC/D,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QACzB,OAAO,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC,IAAI,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,YAAY,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC;AACxF,CAAC"}

package/dist/kernel/prompt-expansion/expand-spans.d.ts

@@ -0,0 +1,7 @@
+import type { DynamicSpan } from './dynamic-spans.js';
+export interface SpanExpansion {
+    readonly template: (text: string) => string;
+    readonly templateCommand: (text: string) => string;
+    readonly resolve: (span: DynamicSpan) => Promise<string>;
+}
+export declare function expandSpans(body: string, spans: readonly DynamicSpan[], expansion: SpanExpansion): Promise<string>;

package/dist/kernel/prompt-expansion/expand-spans.js

@@ -0,0 +1,11 @@
+export async function expandSpans(body, spans, expansion) {
+    let expanded = '';
+    let cursor = 0;
+    for (const span of spans) {
+        const resolved = await expansion.resolve({ ...span, payload: expansion.templateCommand(span.payload) });
+        expanded += expansion.template(body.slice(cursor, span.start)) + resolved;
+        cursor = span.end;
+    }
+    return expanded + expansion.template(body.slice(cursor));
+}
+//# sourceMappingURL=expand-spans.js.map

package/dist/kernel/prompt-expansion/expand-spans.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expand-spans.js","sourceRoot":"","sources":["../../../src/kernel/prompt-expansion/expand-spans.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAY,EAAE,KAA6B,EAAE,SAAwB;IACrG,IAAI,QAAQ,GAAG,EAAE,CAAC;IAClB,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACxG,QAAQ,IAAI,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,QAAQ,CAAC;QAC1E,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC;IACpB,CAAC;IACD,OAAO,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/dist/kernel/prompt-expansion/file-references.d.ts

@@ -0,0 +1,2 @@
+import type { DynamicSpan } from './dynamic-spans.js';
+export declare function inlineFileReference(span: DynamicSpan, projectRoot: string): string;

package/dist/kernel/prompt-expansion/file-references.js

@@ -0,0 +1,19 @@
+// Portions adapted from pi-code (MIT, github.com/ilovepixelart/pi-code), extensions/internal/command-spans.ts.
+import { readFileSync, realpathSync, statSync } from 'node:fs';
+import { resolve, sep } from 'node:path';
+export function inlineFileReference(span, projectRoot) {
+    const content = readInsideProject(projectRoot, span.payload);
+    return content === undefined ? span.matched : `${span.lead}\n<file path="${span.payload}">\n${content.trimEnd()}\n</file>\n`;
+}
+function readInsideProject(projectRoot, reference) {
+    try {
+        const root = realpathSync(projectRoot);
+        const real = realpathSync(resolve(root, reference));
+        const isInside = real === root || real.startsWith(root + sep);
+        return isInside && statSync(real).isFile() ? readFileSync(real, 'utf8') : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=file-references.js.map

package/dist/kernel/prompt-expansion/file-references.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-references.js","sourceRoot":"","sources":["../../../src/kernel/prompt-expansion/file-references.ts"],"names":[],"mappings":"AAAA,+GAA+G;AAC/G,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAGzC,MAAM,UAAU,mBAAmB,CAAC,IAAiB,EAAE,WAAmB;IACxE,MAAM,OAAO,GAAG,iBAAiB,CAAC,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAC7D,OAAO,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,iBAAiB,IAAI,CAAC,OAAO,OAAO,OAAO,CAAC,OAAO,EAAE,aAAa,CAAC;AAC/H,CAAC;AAED,SAAS,iBAAiB,CAAC,WAAmB,EAAE,SAAiB;IAC/D,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC;QACvC,MAAM,IAAI,GAAG,YAAY,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;QACpD,MAAM,QAAQ,GAAG,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC;QAC9D,OAAO,QAAQ,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACtF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/kernel/prompt-expansion/invocation-arguments.d.ts

@@ -0,0 +1,5 @@
+export interface InvocationArguments {
+    readonly raw: string;
+    readonly parts: readonly string[];
+}
+export declare function parseInvocationArguments(text: string): InvocationArguments;

package/dist/kernel/prompt-expansion/invocation-arguments.js

@@ -0,0 +1,7 @@
+const ARGUMENT_TOKEN = /"[^"]*"|'[^']*'|\S+/g;
+const SURROUNDING_QUOTES = /^(["'])(.*)\1$/;
+export function parseInvocationArguments(text) {
+    const parts = [...text.matchAll(ARGUMENT_TOKEN)].map(([token]) => token.replace(SURROUNDING_QUOTES, '$2'));
+    return { raw: text.trim(), parts };
+}
+//# sourceMappingURL=invocation-arguments.js.map

package/dist/kernel/prompt-expansion/invocation-arguments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invocation-arguments.js","sourceRoot":"","sources":["../../../src/kernel/prompt-expansion/invocation-arguments.ts"],"names":[],"mappings":"AAKA,MAAM,cAAc,GAAG,sBAAsB,CAAC;AAC9C,MAAM,kBAAkB,GAAG,gBAAgB,CAAC;AAE5C,MAAM,UAAU,wBAAwB,CAAC,IAAY;IACnD,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,kBAAkB,EAAE,IAAI,CAAC,CAAC,CAAC;IAC3G,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC;AACrC,CAAC"}

package/dist/kernel/prompt-expansion/pi-exec-shell-runner.d.ts

@@ -0,0 +1,9 @@
+import type { ExtensionAPI } from '@earendil-works/pi-coding-agent';
+import type { ShellResult, ShellRunner } from './shell-runner.js';
+type PiExec = ExtensionAPI['exec'];
+export declare class PiExecShellRunner implements ShellRunner {
+    #private;
+    constructor(exec: PiExec, projectRoot: string);
+    run(command: string, cwd: string, timeoutMs: number): Promise<ShellResult>;
+}
+export {};

package/dist/kernel/prompt-expansion/pi-exec-shell-runner.js

@@ -0,0 +1,22 @@
+const MAX_OUTPUT_BYTES = 1024 * 1024;
+export class PiExecShellRunner {
+    #exec;
+    #projectRoot;
+    constructor(exec, projectRoot) {
+        this.#exec = exec;
+        this.#projectRoot = projectRoot;
+    }
+    async run(command, cwd, timeoutMs) {
+        const { stdout, stderr, code, killed } = await this.#exec('bash', ['-c', this.#script(command)], {
+            cwd,
+            timeout: timeoutMs,
+            maxBuffer: MAX_OUTPUT_BYTES,
+        });
+        return { stdout, stderr, code, killed };
+    }
+    #script(command) {
+        const quotedRoot = this.#projectRoot.replaceAll("'", String.raw `'\''`);
+        return `export CLAUDE_PROJECT_DIR='${quotedRoot}'\nexport CLAUDECODE=1\n{ :\n${command}\n} 2>&1`;
+    }
+}
+//# sourceMappingURL=pi-exec-shell-runner.js.map

package/dist/kernel/prompt-expansion/pi-exec-shell-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi-exec-shell-runner.js","sourceRoot":"","sources":["../../../src/kernel/prompt-expansion/pi-exec-shell-runner.ts"],"names":[],"mappings":"AAMA,MAAM,gBAAgB,GAAG,IAAI,GAAG,IAAI,CAAC;AAErC,MAAM,OAAO,iBAAiB;IACnB,KAAK,CAAS;IACd,YAAY,CAAS;IAE9B,YAAY,IAAY,EAAE,WAAmB;QAC3C,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,OAAe,EAAE,GAAW,EAAE,SAAiB;QACvD,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,EAAE;YAC/F,GAAG;YACH,OAAO,EAAE,SAAS;YAClB,SAAS,EAAE,gBAAgB;SAC5B,CAAC,CAAC;QACH,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC1C,CAAC;IAED,OAAO,CAAC,OAAe;QACrB,MAAM,UAAU,GAAG,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,CAAA,MAAM,CAAC,CAAC;QACvE,OAAO,8BAA8B,UAAU,gCAAgC,OAAO,UAAU,CAAC;IACnG,CAAC;CACF"}

package/dist/kernel/prompt-expansion/prompt-substitution.d.ts

@@ -0,0 +1,9 @@
+import type { InvocationArguments } from './invocation-arguments.js';
+import { type ClaudeVariables } from './variables.js';
+export declare class PromptSubstitution {
+    #private;
+    constructor(args: InvocationArguments, named: readonly string[], variables: ClaudeVariables, userConfig: (text: string) => string);
+    get argumentsRead(): boolean;
+    apply(text: string): string;
+    applyToCommand(text: string): string;
+}

package/dist/kernel/prompt-expansion/prompt-substitution.js

@@ -0,0 +1,27 @@
+import { substituteArguments } from './arguments.js';
+import { substituteVariables } from './variables.js';
+export class PromptSubstitution {
+    #args;
+    #named;
+    #variables;
+    #userConfig;
+    #argumentsRead = false;
+    constructor(args, named, variables, userConfig) {
+        this.#args = args;
+        this.#named = named;
+        this.#variables = variables;
+        this.#userConfig = userConfig;
+    }
+    get argumentsRead() {
+        return this.#argumentsRead;
+    }
+    apply(text) {
+        return this.#userConfig(this.applyToCommand(text));
+    }
+    applyToCommand(text) {
+        const { text: withArguments, consumed } = substituteArguments(text, this.#args, this.#named);
+        this.#argumentsRead ||= consumed;
+        return substituteVariables(withArguments, this.#variables);
+    }
+}
+//# sourceMappingURL=prompt-substitution.js.map

package/dist/kernel/prompt-expansion/prompt-substitution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-substitution.js","sourceRoot":"","sources":["../../../src/kernel/prompt-expansion/prompt-substitution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAErD,OAAO,EAAE,mBAAmB,EAAwB,MAAM,gBAAgB,CAAC;AAE3E,MAAM,OAAO,kBAAkB;IACpB,KAAK,CAAsB;IAC3B,MAAM,CAAoB;IAC1B,UAAU,CAAkB;IAC5B,WAAW,CAA2B;IAC/C,cAAc,GAAG,KAAK,CAAC;IAEvB,YAAY,IAAyB,EAAE,KAAwB,EAAE,SAA0B,EAAE,UAAoC;QAC/H,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC5B,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;IAChC,CAAC;IAED,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,IAAY;QAChB,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC;IACrD,CAAC;IAED,cAAc,CAAC,IAAY;QACzB,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,GAAG,mBAAmB,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC7F,IAAI,CAAC,cAAc,KAAK,QAAQ,CAAC;QACjC,OAAO,mBAAmB,CAAC,aAAa,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IAC7D,CAAC;CACF"}

package/dist/kernel/prompt-expansion/shell-runner.d.ts

@@ -0,0 +1,9 @@
+export interface ShellResult {
+    readonly stdout: string;
+    readonly stderr: string;
+    readonly code: number;
+    readonly killed: boolean;
+}
+export interface ShellRunner {
+    run(command: string, cwd: string, timeoutMs: number): Promise<ShellResult>;
+}

package/dist/kernel/prompt-expansion/shell-runner.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=shell-runner.js.map

package/dist/kernel/prompt-expansion/shell-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-runner.js","sourceRoot":"","sources":["../../../src/kernel/prompt-expansion/shell-runner.ts"],"names":[],"mappings":""}

package/dist/kernel/prompt-expansion/shell-segments.d.ts

@@ -0,0 +1 @@
+export declare function splitSegments(command: string): string[];

package/dist/kernel/prompt-expansion/shell-segments.js

@@ -0,0 +1,64 @@
+const PAIR_SEPARATORS = new Set(['&&', '||', '|&']);
+const SINGLE_SEPARATORS = new Set([';', '|', '&', '\n']);
+const BACKSLASH_PAIR = 2;
+export function splitSegments(command) {
+    const state = { segments: [], current: '', quote: undefined };
+    for (let index = 0; index < command.length;) {
+        index += splitStep(command, index, state);
+    }
+    if (state.quote !== undefined) {
+        return [];
+    }
+    return [...state.segments, state.current].map((segment) => segment.trim()).filter(Boolean);
+}
+function splitStep(command, index, state) {
+    if (state.quote !== undefined) {
+        return quotedStep(command, index, state, state.quote);
+    }
+    const opened = quoteOpensAt(command, index);
+    if (opened === undefined) {
+        return unquotedSegmentStep(command, index, state);
+    }
+    state.current += command.slice(index, index + opened.length);
+    state.quote = opened.quote;
+    return opened.length;
+}
+function unquotedSegmentStep(command, index, state) {
+    const separator = separatorLengthAt(command, index);
+    if (separator > 0) {
+        state.segments.push(state.current);
+        state.current = '';
+        return separator;
+    }
+    const taken = unquotedStep(command, index);
+    state.current += command.slice(index, index + taken);
+    return taken;
+}
+function quotedStep(command, index, state, quote) {
+    const step = stepInQuote(command, index, quote);
+    state.current += command.slice(index, index + step.taken);
+    state.quote = step.closes ? undefined : quote;
+    return step.taken;
+}
+function quoteOpensAt(command, index) {
+    const character = command[index];
+    if (character === "'" || character === '"') {
+        return { quote: character, length: 1 };
+    }
+    return character === '$' && command[index + 1] === "'" ? { quote: "$'", length: BACKSLASH_PAIR } : undefined;
+}
+function stepInQuote(text, index, quote) {
+    if (text[index] === '\\' && quote !== "'" && index + 1 < text.length) {
+        return { taken: BACKSLASH_PAIR, closes: false };
+    }
+    return { taken: 1, closes: text[index] === (quote === '"' ? '"' : "'") };
+}
+const unquotedStep = (text, index) => (text[index] === '\\' && index + 1 < text.length ? BACKSLASH_PAIR : 1);
+function separatorLengthAt(command, index) {
+    if (PAIR_SEPARATORS.has(command.slice(index, index + BACKSLASH_PAIR))) {
+        return BACKSLASH_PAIR;
+    }
+    return SINGLE_SEPARATORS.has(command[index] ?? '') && !isRedirectionAmpersand(command, index) ? 1 : 0;
+}
+const isRedirectionAmpersand = (command, index) => command[index] === '&' && (command[index - 1] === '>' || command[index + 1] === '>');
+//# sourceMappingURL=shell-segments.js.map

package/dist/kernel/prompt-expansion/shell-segments.js.map

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