@aexol/spectral 0.7.0 → 0.7.3

package/dist/pi/coding-agent/core/prompt-templates.js

@@ -0,0 +1,237 @@
+import { existsSync, readdirSync, readFileSync, statSync } from "fs";
+import { basename, dirname, join, resolve, sep } from "path";
+import { CONFIG_DIR_NAME } from "../config.js";
+import { parseFrontmatter } from "../utils/frontmatter.js";
+import { resolvePath } from "../utils/paths.js";
+import { createSyntheticSourceInfo } from "./source-info.js";
+/**
+ * Parse command arguments respecting quoted strings (bash-style)
+ * Returns array of arguments
+ */
+export function parseCommandArgs(argsString) {
+    const args = [];
+    let current = "";
+    let inQuote = null;
+    for (let i = 0; i < argsString.length; i++) {
+        const char = argsString[i];
+        if (inQuote) {
+            if (char === inQuote) {
+                inQuote = null;
+            }
+            else {
+                current += char;
+            }
+        }
+        else if (char === '"' || char === "'") {
+            inQuote = char;
+        }
+        else if (/\s/.test(char)) {
+            if (current) {
+                args.push(current);
+                current = "";
+            }
+        }
+        else {
+            current += char;
+        }
+    }
+    if (current) {
+        args.push(current);
+    }
+    return args;
+}
+/**
+ * Substitute argument placeholders in template content
+ * Supports:
+ * - $1, $2, ... for positional args
+ * - $@ and $ARGUMENTS for all args
+ * - ${@:N} for args from Nth onwards (bash-style slicing)
+ * - ${@:N:L} for L args starting from Nth
+ *
+ * Note: Replacement happens on the template string only. Argument values
+ * containing patterns like $1, $@, or $ARGUMENTS are NOT recursively substituted.
+ */
+export function substituteArgs(content, args) {
+    let result = content;
+    // Replace $1, $2, etc. with positional args FIRST (before wildcards)
+    // This prevents wildcard replacement values containing $<digit> patterns from being re-substituted
+    result = result.replace(/\$(\d+)/g, (_, num) => {
+        const index = parseInt(num, 10) - 1;
+        return args[index] ?? "";
+    });
+    // Replace ${@:start} or ${@:start:length} with sliced args (bash-style)
+    // Process BEFORE simple $@ to avoid conflicts
+    result = result.replace(/\$\{@:(\d+)(?::(\d+))?\}/g, (_, startStr, lengthStr) => {
+        let start = parseInt(startStr, 10) - 1; // Convert to 0-indexed (user provides 1-indexed)
+        // Treat 0 as 1 (bash convention: args start at 1)
+        if (start < 0)
+            start = 0;
+        if (lengthStr) {
+            const length = parseInt(lengthStr, 10);
+            return args.slice(start, start + length).join(" ");
+        }
+        return args.slice(start).join(" ");
+    });
+    // Pre-compute all args joined (optimization)
+    const allArgs = args.join(" ");
+    // Replace $ARGUMENTS with all args joined (new syntax, aligns with Claude, Codex, OpenCode)
+    result = result.replace(/\$ARGUMENTS/g, allArgs);
+    // Replace $@ with all args joined (existing syntax)
+    result = result.replace(/\$@/g, allArgs);
+    return result;
+}
+function loadTemplateFromFile(filePath, sourceInfo) {
+    try {
+        const rawContent = readFileSync(filePath, "utf-8");
+        const { frontmatter, body } = parseFrontmatter(rawContent);
+        const name = basename(filePath).replace(/\.md$/, "");
+        // Get description from frontmatter or first non-empty line
+        let description = frontmatter.description || "";
+        if (!description) {
+            const firstLine = body.split("\n").find((line) => line.trim());
+            if (firstLine) {
+                // Truncate if too long
+                description = firstLine.slice(0, 60);
+                if (firstLine.length > 60)
+                    description += "...";
+            }
+        }
+        return {
+            name,
+            description,
+            ...(frontmatter["argument-hint"] && { argumentHint: frontmatter["argument-hint"] }),
+            content: body,
+            sourceInfo,
+            filePath,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Scan a directory for .md files (non-recursive) and load them as prompt templates.
+ */
+function loadTemplatesFromDir(dir, getSourceInfo) {
+    const templates = [];
+    if (!existsSync(dir)) {
+        return templates;
+    }
+    try {
+        const entries = readdirSync(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = join(dir, entry.name);
+            // For symlinks, check if they point to a file
+            let isFile = entry.isFile();
+            if (entry.isSymbolicLink()) {
+                try {
+                    const stats = statSync(fullPath);
+                    isFile = stats.isFile();
+                }
+                catch {
+                    // Broken symlink, skip it
+                    continue;
+                }
+            }
+            if (isFile && entry.name.endsWith(".md")) {
+                const template = loadTemplateFromFile(fullPath, getSourceInfo(fullPath));
+                if (template) {
+                    templates.push(template);
+                }
+            }
+        }
+    }
+    catch {
+        return templates;
+    }
+    return templates;
+}
+/**
+ * Load all prompt templates from:
+ * 1. Global: agentDir/prompts/
+ * 2. Project: cwd/{CONFIG_DIR_NAME}/prompts/
+ * 3. Explicit prompt paths
+ */
+export function loadPromptTemplates(options) {
+    const resolvedCwd = resolvePath(options.cwd);
+    const resolvedAgentDir = resolvePath(options.agentDir);
+    const promptPaths = options.promptPaths;
+    const includeDefaults = options.includeDefaults;
+    const templates = [];
+    const globalPromptsDir = join(resolvedAgentDir, "prompts");
+    const projectPromptsDir = resolve(resolvedCwd, CONFIG_DIR_NAME, "prompts");
+    const isUnderPath = (target, root) => {
+        const normalizedRoot = resolve(root);
+        if (target === normalizedRoot) {
+            return true;
+        }
+        const prefix = normalizedRoot.endsWith(sep) ? normalizedRoot : `${normalizedRoot}${sep}`;
+        return target.startsWith(prefix);
+    };
+    const getSourceInfo = (resolvedPath) => {
+        if (isUnderPath(resolvedPath, globalPromptsDir)) {
+            return createSyntheticSourceInfo(resolvedPath, {
+                source: "local",
+                scope: "user",
+                baseDir: globalPromptsDir,
+            });
+        }
+        if (isUnderPath(resolvedPath, projectPromptsDir)) {
+            return createSyntheticSourceInfo(resolvedPath, {
+                source: "local",
+                scope: "project",
+                baseDir: projectPromptsDir,
+            });
+        }
+        return createSyntheticSourceInfo(resolvedPath, {
+            source: "local",
+            baseDir: statSync(resolvedPath).isDirectory() ? resolvedPath : dirname(resolvedPath),
+        });
+    };
+    if (includeDefaults) {
+        templates.push(...loadTemplatesFromDir(globalPromptsDir, getSourceInfo));
+        templates.push(...loadTemplatesFromDir(projectPromptsDir, getSourceInfo));
+    }
+    // 3. Load explicit prompt paths
+    for (const rawPath of promptPaths) {
+        const resolvedPath = resolvePath(rawPath, resolvedCwd, { trim: true });
+        if (!existsSync(resolvedPath)) {
+            continue;
+        }
+        try {
+            const stats = statSync(resolvedPath);
+            if (stats.isDirectory()) {
+                templates.push(...loadTemplatesFromDir(resolvedPath, getSourceInfo));
+            }
+            else if (stats.isFile() && resolvedPath.endsWith(".md")) {
+                const template = loadTemplateFromFile(resolvedPath, getSourceInfo(resolvedPath));
+                if (template) {
+                    templates.push(template);
+                }
+            }
+        }
+        catch {
+            // Ignore read failures
+        }
+    }
+    return templates;
+}
+/**
+ * Expand a prompt template if it matches a template name.
+ * Returns the expanded content or the original text if not a template.
+ */
+export function expandPromptTemplate(text, templates) {
+    if (!text.startsWith("/"))
+        return text;
+    const match = text.match(/^\/([^\s]+)(?:\s+([\s\S]*))?$/);
+    if (!match)
+        return text;
+    const templateName = match[1];
+    const argsString = match[2] ?? "";
+    const template = templates.find((t) => t.name === templateName);
+    if (template) {
+        const args = parseCommandArgs(argsString);
+        return substituteArgs(template.content, args);
+    }
+    return text;
+}

package/dist/pi/coding-agent/core/provider-display-names.js

@@ -0,0 +1,32 @@
+export const BUILT_IN_PROVIDER_DISPLAY_NAMES = {
+    anthropic: "Anthropic",
+    "amazon-bedrock": "Amazon Bedrock",
+    "azure-openai-responses": "Azure OpenAI Responses",
+    cerebras: "Cerebras",
+    "cloudflare-ai-gateway": "Cloudflare AI Gateway",
+    "cloudflare-workers-ai": "Cloudflare Workers AI",
+    deepseek: "DeepSeek",
+    fireworks: "Fireworks",
+    google: "Google Gemini",
+    "google-vertex": "Google Vertex AI",
+    groq: "Groq",
+    huggingface: "Hugging Face",
+    "kimi-coding": "Kimi For Coding",
+    mistral: "Mistral",
+    minimax: "MiniMax",
+    "minimax-cn": "MiniMax (China)",
+    moonshotai: "Moonshot AI",
+    "moonshotai-cn": "Moonshot AI (China)",
+    opencode: "OpenCode Zen",
+    "opencode-go": "OpenCode Go",
+    openai: "OpenAI",
+    openrouter: "OpenRouter",
+    together: "Together AI",
+    "vercel-ai-gateway": "Vercel AI Gateway",
+    xai: "xAI",
+    zai: "ZAI",
+    xiaomi: "Xiaomi MiMo",
+    "xiaomi-token-plan-cn": "Xiaomi MiMo Token Plan (China)",
+    "xiaomi-token-plan-ams": "Xiaomi MiMo Token Plan (Amsterdam)",
+    "xiaomi-token-plan-sgp": "Xiaomi MiMo Token Plan (Singapore)",
+};

package/dist/pi/coding-agent/core/resolve-config-value.js

@@ -0,0 +1,125 @@
+/**
+ * Resolve configuration values that may be shell commands, environment variables, or literals.
+ * Used by auth-storage.ts and model-registry.ts.
+ */
+import { execSync, spawnSync } from "child_process";
+import { getShellConfig } from "../utils/shell.js";
+// Cache for shell command results (persists for process lifetime)
+const commandResultCache = new Map();
+/**
+ * Resolve a config value (API key, header value, etc.) to an actual value.
+ * - If starts with "!", executes the rest as a shell command and uses stdout (cached)
+ * - Otherwise checks environment variable first, then treats as literal (not cached)
+ */
+export function resolveConfigValue(config) {
+    if (config.startsWith("!")) {
+        return executeCommand(config);
+    }
+    const envValue = process.env[config];
+    return envValue || config;
+}
+function executeWithConfiguredShell(command) {
+    try {
+        const { shell, args } = getShellConfig();
+        const result = spawnSync(shell, [...args, command], {
+            encoding: "utf-8",
+            timeout: 10000,
+            stdio: ["ignore", "pipe", "ignore"],
+            shell: false,
+            windowsHide: true,
+        });
+        if (result.error) {
+            const error = result.error;
+            if (error.code === "ENOENT") {
+                return { executed: false, value: undefined };
+            }
+            return { executed: true, value: undefined };
+        }
+        if (result.status !== 0) {
+            return { executed: true, value: undefined };
+        }
+        const value = (result.stdout ?? "").trim();
+        return { executed: true, value: value || undefined };
+    }
+    catch {
+        return { executed: false, value: undefined };
+    }
+}
+function executeWithDefaultShell(command) {
+    try {
+        const output = execSync(command, {
+            encoding: "utf-8",
+            timeout: 10000,
+            stdio: ["ignore", "pipe", "ignore"],
+        });
+        return output.trim() || undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function executeCommandUncached(commandConfig) {
+    const command = commandConfig.slice(1);
+    return process.platform === "win32"
+        ? (() => {
+            const configuredResult = executeWithConfiguredShell(command);
+            return configuredResult.executed ? configuredResult.value : executeWithDefaultShell(command);
+        })()
+        : executeWithDefaultShell(command);
+}
+function executeCommand(commandConfig) {
+    if (commandResultCache.has(commandConfig)) {
+        return commandResultCache.get(commandConfig);
+    }
+    const result = executeCommandUncached(commandConfig);
+    commandResultCache.set(commandConfig, result);
+    return result;
+}
+/**
+ * Resolve all header values using the same resolution logic as API keys.
+ */
+export function resolveConfigValueUncached(config) {
+    if (config.startsWith("!")) {
+        return executeCommandUncached(config);
+    }
+    const envValue = process.env[config];
+    return envValue || config;
+}
+export function resolveConfigValueOrThrow(config, description) {
+    const resolvedValue = resolveConfigValueUncached(config);
+    if (resolvedValue !== undefined) {
+        return resolvedValue;
+    }
+    if (config.startsWith("!")) {
+        throw new Error(`Failed to resolve ${description} from shell command: ${config.slice(1)}`);
+    }
+    throw new Error(`Failed to resolve ${description}`);
+}
+/**
+ * Resolve all header values using the same resolution logic as API keys.
+ */
+export function resolveHeaders(headers) {
+    if (!headers)
+        return undefined;
+    const resolved = {};
+    for (const [key, value] of Object.entries(headers)) {
+        const resolvedValue = resolveConfigValue(value);
+        if (resolvedValue) {
+            resolved[key] = resolvedValue;
+        }
+    }
+    return Object.keys(resolved).length > 0 ? resolved : undefined;
+}
+export function resolveHeadersOrThrow(headers, description) {
+    if (!headers)
+        return undefined;
+    const resolved = {};
+    for (const [key, value] of Object.entries(headers)) {
+        resolved[key] = resolveConfigValueOrThrow(value, `${description} header "${key}"`);
+    }
+    return Object.keys(resolved).length > 0 ? resolved : undefined;
+}
+/** Clear the config value command cache. Exported for testing. */
+export function clearConfigValueCache() {
+    commandResultCache.clear();
+}